picalor._version Namespace Reference

Classes
class	VersioneerConfig
	Container for Versioneer configuration parameters. More...
class	NotThisMethod
	Exception raised if a method is not valid for the current scenario. More...

Functions
def	get_keywords ()
	Get the keywords needed to look up the version information. More...
def	get_config ()
def	register_vcs_handler (vcs, method)
	Decorator to mark a method as the handler for a particular VCS. More...
def	run_command (commands, args, cwd=None, verbose=False, hide_stderr=False, env=None)
	Call the given command(s). More...
def	versions_from_parentdir (parentdir_prefix, root, verbose)
	Try to determine the version from the parent directory name. More...
def	git_get_keywords (versionfile_abs)
	Extract version information from the given file. More...
def	git_versions_from_keywords (keywords, tag_prefix, verbose)
	Get version information from git keywords. More...
def	git_pieces_from_vcs (tag_prefix, root, verbose, run_command=run_command)
	Get version from 'git describe' in the root of the source tree. More...
def	plus_or_dot (pieces)
	Return a + if we don't already have one, else return a . More...
def	render_pep440 (pieces)
	Build up version string, with post-release "local version identifier". More...
def	render_pep440_pre (pieces)
	TAG No -dirty. More...
def	render_pep440_post (pieces)
	TAG[.postDISTANCE[.dev0]+gHEX] . More...
def	render_pep440_old (pieces)
	TAG[.postDISTANCE[.dev0]] . More...
def	render_git_describe (pieces)
	TAG[-DISTANCE-gHEX][-dirty]. More...
def	render_git_describe_long (pieces)
	TAG-DISTANCE-gHEX[-dirty]. More...
def	render (pieces, style)
	Render the given version pieces into the requested style. More...
def	get_versions ()
	Get version information or return default if unable to do so. More...

Variables
dictionary	LONG_VERSION_PY = {}
dictionary	HANDLERS = {}

Function Documentation

get_config()

def picalor._version.get_config

(

)

get_keywords()

def picalor._version.get_keywords

(

)

Get the keywords needed to look up the version information.

get_versions()

def picalor._version.get_versions

(

)

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

git_get_keywords()

def picalor._version.git_get_keywords

(

versionfile_abs

)

Extract version information from the given file.

git_pieces_from_vcs()

def picalor._version.git_pieces_from_vcs	(		tag_prefix,
			root,
			verbose,
			run_command = 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()

def picalor._version.git_versions_from_keywords	(		keywords,
			tag_prefix,
			verbose
	)

Get version information from git keywords.

plus_or_dot()

def picalor._version.plus_or_dot

(

pieces

)

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

register_vcs_handler()

def picalor._version.register_vcs_handler	(		vcs,
			method
	)

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

render()

def picalor._version.render	(		pieces,
			style
	)

Render the given version pieces into the requested style.

render_git_describe()

def picalor._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()

def picalor._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()

def picalor._version.render_pep440

(

pieces

)

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

Our 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()

def picalor._version.render_pep440_old

(

pieces

)

TAG[.postDISTANCE[.dev0]] .

The ".dev0" means dirty.

Eexceptions

1 no tags. 0.postDISTANCE[.dev0]

render_pep440_post()

def picalor._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()

def picalor._version.render_pep440_pre

(

pieces

)

TAG No -dirty.

Exceptions

1	no tags. 0.post.devDISTANCE

run_command()

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

Call the given command(s).

versions_from_parentdir()

def picalor._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

Variable Documentation

HANDLERS

dictionary picalor._version.HANDLERS = {}

LONG_VERSION_PY

dictionary picalor._version.LONG_VERSION_PY = {}