Git.Commands.Tag (git v0.4.0)

Copy Markdown View Source

Implements the Git.Command behaviour for git tag.

Supports listing tags (default), creating a lightweight tag, creating an annotated tag, and deleting a tag.

Summary

Types

t()

Functions

args(tag)

Returns the argument list for git tag.

parse_output(stdout, exit_code)

Parses the output of git tag.

Types

t()

@type t() :: %Git.Commands.Tag{
  create: String.t() | nil,
  delete: String.t() | nil,
  list: boolean(),
  message: String.t() | nil,
  ref: String.t() | nil,
  sort: String.t() | nil
}

Functions

args(tag)

@spec args(t()) :: [String.t()]

Returns the argument list for git tag.

  • If :create is set with :message, builds git tag -a <name> -m <msg> (annotated).
  • If :create is set without :message, builds git tag <name> (lightweight).
  • If :delete is set, builds git tag -d <name>.
  • Otherwise, lists tags with detailed format.

Both create and delete accept an optional :ref to specify the commit.

Examples

iex> Git.Commands.Tag.args(%Git.Commands.Tag{})
["tag", "-l", "--format=" <> Git.Tag.format_string()]

iex> Git.Commands.Tag.args(%Git.Commands.Tag{create: "v1.0.0"})
["tag", "v1.0.0"]

iex> Git.Commands.Tag.args(%Git.Commands.Tag{create: "v1.0.0", message: "release 1.0"})
["tag", "-a", "v1.0.0", "-m", "release 1.0"]

iex> Git.Commands.Tag.args(%Git.Commands.Tag{delete: "v1.0.0"})
["tag", "-d", "v1.0.0"]

parse_output(stdout, exit_code)

@spec parse_output(String.t(), non_neg_integer()) ::
  {:ok, [Git.Tag.t()]}
  | {:ok, :done}
  | {:error, {String.t(), non_neg_integer()}}

Parses the output of git tag.

For list operations (exit 0), parses each entry into a Git.Tag struct. For create/delete operations (exit 0), returns {:ok, :done}. On failure, returns {:error, {stdout, exit_code}}.