Tag

Within git there are 2 types of tags, lightweight and annotated. Lightweight tags are REFERENCES within the tag namespace. Annotated tags are objects stored in the ODB. Annotated tags have a TARGET and a TAGGER, which makes them different from commits. TAG-P can be used to determine if a tag or reference is a “tag”.

CLOS class tag

Superclass:

[‘T’]

Metaclass:

standard-class

Tags are used to identify interesting points in the repositories history.

Details

Method (full-name (object TAG))

Returns the name of OBJECT, as a string.

What exactly the name is depends on the type of the object.

See also: full-name

Method (short-name (object TAG))

Returns the short name of OBJECT, as a string.

What exactly the name is depends on the type of the object.

See also: short-name

Generic (tagger object)

(tagger (tag REFERENCE))

(tagger (tag TAG))

Returns the signature of the tagger of OBJECT.

The return value is a signature (a property list with keys :NAME, :EMAIL and :TIME. If the tag is not annotated then nil will be returned.

Method (message (object TAG))

Return the message associated with OBJECT.

For example for commits this will return the commit message and for tags the message associated with the tag.

See also: message

Target

Method (target (object TAG))

Returns the target of a tag.

See also: target

Method (resolve (object TAG) &optional stop-at)

Resolve the tag target until the target object is not a tag anymore. Basically calls TARGET on tag and result until there is a COMMIT returned.

Using values returns the finally found object and a list of the traversed objects.

See also: resolve

Creating

Method (make-object class id/name repository &key url type force target signature message log-message &allow-other-keys)

Create objects within a Git repository, Please see the documentation for each implementing method.

See also: make-object

Accessing

Method (get-object class id/name repository)

Return an object of type CLASS from the object database. The lookup will use either an oid or a name to find the object.

See also: get-object

Method (list-objects class repository &key test test-not)

GIT> (list-objects 'tag (open-repository #p"/home/russell/projects/ecl/"))

(#<TAG refs/tags/ECL.8.12.0 {1006621153}>
 #<REFERENCE refs/tags/ECL.9.8.3 {1006B277C3}>
 #<REFERENCE refs/tags/ECL.9.8.4 {1006B279C3}>
 #<REFERENCE refs/tags/ECL.9.8.2 {1006B27BC3}>
 #<REFERENCE refs/tags/ECLS.0.4 {1006B27DC3}>
 #<REFERENCE refs/tags/ECL.13.5.1 {1006B27FD3}>
 ...)

See also: list-objects