_version

Git implementation of _version.py.

NotThisMethod

Exception raised if a method is not valid for the current scenario.

VersioneerConfig()

Container for Versioneer configuration parameters.

get_config()

Create, populate and return the VersioneerConfig() object.

get_keywords()

Get the keywords needed to look up the version information.

get_versions()

Get version information or return default if unable to do so.

git_get_keywords(versionfile_abs)

Extract version information from the given file.

git_pieces_from_vcs(tag_prefix, root, verbose)

Get version from ‘git describe’ in the root of the source tree.

git_versions_from_keywords(keywords, …)

Get version information from git keywords.

plus_or_dot(pieces)

Return a + if we don’t already have one, else return a .

register_vcs_handler(vcs, method)

Decorator to mark a method as the handler for a particular VCS.

render(pieces, style)

Render the given version pieces into the requested style.

render_git_describe(pieces)

TAG[-DISTANCE-gHEX][-dirty].

render_git_describe_long(pieces)

TAG-DISTANCE-gHEX[-dirty].

render_pep440(pieces)

Build up version string, with post-release “local version identifier”.

render_pep440_old(pieces)

TAG[.postDISTANCE[.dev0]] .

render_pep440_post(pieces)

TAG[.postDISTANCE[.dev0]+gHEX] .

render_pep440_pre(pieces)

TAG[.post.devDISTANCE] – No -dirty.

run_command(commands, args[, cwd, verbose, …])

Call the given command(s).

versions_from_parentdir(parentdir_prefix, …)

Try to determine the version from the parent directory name.

NotThisMethod

class nibabel._version.NotThisMethod

Bases: Exception

Exception raised if a method is not valid for the current scenario.

__init__(*args, **kwargs)

Initialize self. See help(type(self)) for accurate signature.

VersioneerConfig

class nibabel._version.VersioneerConfig

Bases: object

Container for Versioneer configuration parameters.

__init__(*args, **kwargs)

Initialize self. See help(type(self)) for accurate signature.

get_config

nibabel._version.get_config()

Create, populate and return the VersioneerConfig() object.

get_keywords

nibabel._version.get_keywords()

Get the keywords needed to look up the version information.

get_versions

nibabel._version.get_versions()

Get version information or return default if unable to do so.

git_get_keywords

nibabel._version.git_get_keywords(versionfile_abs)

Extract version information from the given file.

git_pieces_from_vcs

nibabel._version.git_pieces_from_vcs(tag_prefix, root, verbose, run_command=<function run_command>)

Get version from ‘git describe’ in the root of the source tree.

This only gets called if the git-archive ‘subst’ keywords were not expanded, and _version.py hasn’t already been rewritten with a short version string, meaning we’re inside a checked out source tree.

git_versions_from_keywords

nibabel._version.git_versions_from_keywords(keywords, tag_prefix, verbose)

Get version information from git keywords.

plus_or_dot

nibabel._version.plus_or_dot(pieces)

Return a + if we don’t already have one, else return a .

register_vcs_handler

nibabel._version.register_vcs_handler(vcs, method)

Decorator to mark a method as the handler for a particular VCS.

render

nibabel._version.render(pieces, style)

Render the given version pieces into the requested style.

render_git_describe

nibabel._version.render_git_describe(pieces)

TAG[-DISTANCE-gHEX][-dirty].

Like ‘git describe –tags –dirty –always’.

Exceptions: 1: no tags. HEX[-dirty] (note: no ‘g’ prefix)

render_git_describe_long

nibabel._version.render_git_describe_long(pieces)

TAG-DISTANCE-gHEX[-dirty].

Like ‘git describe –tags –dirty –always -long’. The distance/hash is unconditional.

Exceptions: 1: no tags. HEX[-dirty] (note: no ‘g’ prefix)

render_pep440

nibabel._version.render_pep440(pieces)

Build up version string, with post-release “local version identifier”.

Our goal: TAG[+DISTANCE.gHEX[.dirty]] . Note that if you get a tagged build and then dirty it, you’ll get TAG+0.gHEX.dirty

Exceptions: 1: no tags. git_describe was just HEX. 0+untagged.DISTANCE.gHEX[.dirty]

render_pep440_old

nibabel._version.render_pep440_old(pieces)

TAG[.postDISTANCE[.dev0]] .

The “.dev0” means dirty.

Eexceptions: 1: no tags. 0.postDISTANCE[.dev0]

render_pep440_post

nibabel._version.render_pep440_post(pieces)

TAG[.postDISTANCE[.dev0]+gHEX] .

The “.dev0” means dirty. Note that .dev0 sorts backwards (a dirty tree will appear “older” than the corresponding clean one), but you shouldn’t be releasing software with -dirty anyways.

Exceptions: 1: no tags. 0.postDISTANCE[.dev0]

render_pep440_pre

nibabel._version.render_pep440_pre(pieces)

TAG[.post.devDISTANCE] – No -dirty.

Exceptions: 1: no tags. 0.post.devDISTANCE

run_command

nibabel._version.run_command(commands, args, cwd=None, verbose=False, hide_stderr=False, env=None)

Call the given command(s).

versions_from_parentdir

nibabel._version.versions_from_parentdir(parentdir_prefix, root, verbose)

Try to determine the version from the parent directory name.

Source tarballs conventionally unpack into a directory that includes both the project name and a version string. We will also support searching up two directory levels for an appropriately named parent directory