Module rev_parse

Constants

• ABBREV_REF
• ABSOLUTE_GIT_DIR
• AFTER
• ALL
• BEFORE
• BRANCHES
• DEFAULT
• DISAMBIGUATE
• EXCLUDE
• FLAGS
• GIT_COMMAND
• GIT_COMMON_DIR
• GIT_DIR
• GIT_PATH
• GLOB
• IS_BARE_REPOSITORY
• IS_INSIDE_GIT_DIR
• IS_INSIDE_WORK_TREE
• KEEP_DASHDASH
• LOCAL_ENV_VARS
• NOT
• NO_FLAGS
• NO_REVS
• PARSEOPT
• PREFIX
• QUIET
• REMOTES
• RESOLVE_GIT_DIR
• REVS_ONLY
• SHARED_INDEX_PATH
• SHORT
• SHOW_CDUP
• SHOW_PREFIX
• SHOW_SUPERPROJECT_WORKING_TREE
• SHOW_TOPLEVEL
• SINCE
• SQ
• SQ_QUOTE
• STOP_AT_NON_OPTION
• STUCK_LONG
• SYMBOLIC
• SYMBOLIC_FULL_NAME
• TAGS
• UNTIL
• VERIFY

Functions

• abbrev_ref
  A non-ambiguous short name of the objects name. The option core.warnAmbiguousRefs is used to select the strict abbreviation mode. –abbrev-ref[=(strict|loose)]
• absolute_git_dir
  Like –git-dir, but its output is always the canonicalized absolute path. –absolute-git-dir
• after
  Parse the date string, and output the corresponding –max-age= parameter for git rev-list. –since=datestring, –after=datestring
• all
  Show all refs found in refs/. –all
• before
  Parse the date string, and output the corresponding –min-age= parameter for git rev-list. –until=datestring, –before=datestring
• branches
  Show all branches, tags, or remote-tracking branches, respectively (i.e., refs found in refs/heads, refs/tags, or refs/remotes, respectively). If a pattern is given, only refs matching the given shell glob are shown. If the pattern does not contain a globbing character (?, , or [), it is turned into a prefix match by appending /. –branches[=pattern], –tags[=pattern], –remotes[=pattern]
• default
  If there is no parameter given by the user, use instead. –default
• disambiguate
  Show every object whose name begins with the given prefix. The must be at least 4 hexadecimal digits long to avoid listing each and every object in the repository by mistake. –disambiguate=
• exclude
  Do not include refs matching that the next –all, –branches, –tags, –remotes, or –glob would otherwise consider. Repetitions of this option accumulate exclusion patterns up to the next –all, –branches, –tags, –remotes, or –glob option (other options or arguments do not clear accumulated patterns). The patterns given should not begin with refs/heads, refs/tags, or refs/remotes when applied to –branches, –tags, or –remotes, respectively, and they must begin with refs/ when applied to –glob or –all. If a trailing /* is intended, it must be given explicitly. –exclude=
• flags
  Do not output non-flag parameters. –flags
• git_common_dir
  Show $GIT_COMMON_DIR if defined, else $GIT_DIR. –git-common-dir
• git_dir
  Show $GIT_DIR if defined. Otherwise show the path to the .git directory. The path shown, when relative, is relative to the current working directory. If $GIT_DIR is not defined and the current directory is not detected to lie in a Git repository or work tree print a message to stderr and exit with nonzero status. –git-dir
• git_path
  Resolve ‘$GIT_DIR/’ and takes other path relocation variables such as $GIT_OBJECT_DIRECTORY, $GIT_INDEX_FILE… into account. For example, if $GIT_OBJECT_DIRECTORY is set to /foo/bar then ‘git rev-parse –git-path objects/abc’ returns /foo/bar/abc. –git-path
• glob
  Show all refs matching the shell glob pattern pattern. If the pattern does not start with refs/, this is automatically prepended. If the pattern does not contain a globbing character (?, , or [), it is turned into a prefix match by appending /. –glob=pattern
• is_bare_repository
  When the repository is bare print ‘true’, otherwise ‘false’. –is-bare-repository
• is_inside_git_dir
  When the current working directory is below the repository directory print ‘true’, otherwise ‘false’. –is-inside-git-dir
• is_inside_work_tree
  When the current working directory is inside the work tree of the repository print ‘true’, otherwise ‘false’. –is-inside-work-tree
• keep_dashdash
  Only meaningful in –parseopt mode. Tells the option parser to echo out the first – met instead of skipping it. –keep-dashdash
• local_env_vars
  List the GIT_* environment variables that are local to the repository (e.g. GIT_DIR or GIT_WORK_TREE, but not GIT_EDITOR). Only the names of the variables are listed, not their value, even if they are set. –local-env-vars
• no_flags
  Do not output flag parameters. –no-flags
• no_revs
  Do not output flags and parameters meant for git rev-list command. –no-revs
• not
  When showing object names, prefix them with ^ and strip ^ prefix from the object names that already have one. –not
• parseopt
  Use git rev-parse in option parsing mode (see PARSEOPT section below). –parseopt
• prefix
  Behave as if git rev-parse was invoked from the subdirectory of the working tree. Any relative filenames are resolved as if they are prefixed by and will be printed in that form. This can be used to convert arguments to a command run in a subdirectory so that they can still be used after moving to the top-level of the repository. –prefix
• quiet
  Only meaningful in –verify mode. Do not output an error message if the first argument is not a valid object name; instead exit with non-zero status silently. SHA-1s for valid object names are printed to stdout on success. -q, –quiet
• remotes
  Show all branches, tags, or remote-tracking branches, respectively (i.e., refs found in refs/heads, refs/tags, or refs/remotes, respectively). If a pattern is given, only refs matching the given shell glob are shown. If the pattern does not contain a globbing character (?, , or [), it is turned into a prefix match by appending /. –branches[=pattern], –tags[=pattern], –remotes[=pattern]
• resolve_git_dir
  Check if is a valid repository or a gitfile that points at a valid repository, and print the location of the repository. If is a gitfile then the resolved path to the real repository is printed. –resolve-git-dir
• rev_parse
  Pick out and massage parameters. Git doc
• revs_only
  Do not output flags and parameters not meant for git rev-list command. –revs-only
• shared_index_path
  Show the path to the shared index file in split index mode, or empty if not in split-index mode. –shared-index-path
• short
  Same as –verify but shortens the object name to a unique prefix with at least length characters. The minimum length is 4, the default is the effective value of the core.abbrev configuration variable (see git-config(1)). –short[=length]
• show_cdup
  When the command is invoked from a subdirectory, show the path of the top-level directory relative to the current directory (typically a sequence of ‘../’, or an empty string). –show-cdup
• show_prefix
  When the command is invoked from a subdirectory, show the path of the current directory relative to the top-level directory. –show-prefix
• show_superproject_working_tree
  Show the absolute path of the root of the superproject’s working tree (if exists) that uses the current repository as its submodule. Outputs nothing if the current repository is not used as a submodule by any project. –show-superproject-working-tree
• show_toplevel
  Show the absolute path of the top-level directory. –show-toplevel
• since
  Parse the date string, and output the corresponding –max-age= parameter for git rev-list. –since=datestring, –after=datestring
• sq
  Usually the output is made one line per flag and parameter. This option makes output a single line, properly quoted for consumption by shell. Useful when you expect your parameter to contain whitespaces and newlines (e.g. when using pickaxe -S with git diff-*). In contrast to the –sq-quote option, the command input is still interpreted as usual. –sq
• sq_quote
  Use git rev-parse in shell quoting mode (see SQ-QUOTE section below). In contrast to the –sq option below, this mode does only quoting. Nothing else is done to command input. –sq-quote
• stop_at_non_option
  Only meaningful in –parseopt mode. Lets the option parser stop at the first non-option argument. This can be used to parse sub-commands that take options themselves. –stop-at-non-option
• stuck_long
  Only meaningful in –parseopt mode. Output the options in their long form if available, and with their arguments stuck. –stuck-long
• symbolic
  Usually the object names are output in SHA-1 form (with possible ^ prefix); this option makes them output in a form as close to the original input as possible. –symbolic
• symbolic_full_name
  This is similar to –symbolic, but it omits input that are not refs (i.e. branch or tag names; or more explicitly disambiguating ‘heads/master’ form, when you want to name the ‘master’ branch when there is an unfortunately named tag ‘master’), and show them as full refnames (e.g. ‘refs/heads/master’). –symbolic-full-name
• tags
  Show all branches, tags, or remote-tracking branches, respectively (i.e., refs found in refs/heads, refs/tags, or refs/remotes, respectively). If a pattern is given, only refs matching the given shell glob are shown. If the pattern does not contain a globbing character (?, , or [), it is turned into a prefix match by appending /. –branches[=pattern], –tags[=pattern], –remotes[=pattern]
• until
  Parse the date string, and output the corresponding –min-age= parameter for git rev-list. –until=datestring, –before=datestring
• verify
  Verify that exactly one parameter is provided, and that it can be turned into a raw 20-byte SHA-1 that can be used to access the object database. If so, emit it to the standard output; otherwise, error out. –verify