Submodules¶

repoman.hg.depot_operations module¶

class repoman.hg.depot_operations.DepotOperations¶

Bases: repoman.depot_operations.DepotOperations

Highlevel Mercurial DCVS operations.

KIND = 'hg'¶

check_changeset_availability(path, changesets)¶

Inherited method check_changeset_availability()

clear_depot(path)¶

Inherited method clear_depot()

grab_changesets(path, url, changesets)¶

Inherited method grab_changesets()

init_depot(path, parent=None, source=None)¶

Inherited method init_depot()

is_a_depot(path)¶

Inherited method is_a_depot()

set_source(path, source)¶

Inherited method set_source()

repoman.hg.hglibext module¶

class repoman.hg.hglibext.HgClientExtensions(path, encoding, configs, connect=True)¶

Bases: hglib.client.hgclient

churn(revrange=None, date=None, template=None, dateformat=None, files=, []changesets=False, sort=None, include=None, exclude=None)¶

histogram of changes to the repository

This command will display a histogram representing the number of changed lines or revisions, grouped according to the given template. The default template will group changes by author. The –dateformat option may be used to group the results by date instead.

Statistics are based on the number of changed lines, or alternatively the number of matching revisions if the –changesets option is specified.

Examples:

# display count of changed lines for every committer hg churn -t ‘{author|email}’

# display daily activity graph hg churn -f ‘%H’ -s -c

# display activity of developers by month hg churn -f ‘%Y-%m’ -s -c

# display count of lines changed in every year hg churn -f ‘%Y’ -s

It is possible to map alternate email addresses to a main address by providing a file using the following format:

<alias email> = <actual email>

Such a file may be specified with the –aliases option, otherwise a .hgchurn file will be looked for in the working directory root.

revrange count rate for the specified revision or range date count rate for revisions matching date spec template TEMPLATE to group changesets (default: {author|email}) dateformat FORMAT strftime-compatible format for grouping by date changesets count rate by number of changesets sort sort by key (default: sort by count) include include names matching the given patterns exclude exclude names matching the given patterns

purge(dirs=None, all=False, include=None, exclude=None, p=False, abortonerr=False)¶

aliases: clean

removes files not tracked by Mercurial

Delete files not known to Mercurial. This is useful to test local and uncommitted changes in an otherwise-clean source tree.

This means that purge will delete:

• Unknown files: files marked with ”?” by “hg status”
• Empty directories: in fact Mercurial ignores directories unless they contain files under source control management

But it will leave untouched:

• Modified and unmodified tracked files
• Ignored files (unless –all is specified)
• New files added to the repository (with “hg add”)

If directories are given on the command line, only files in these directories are considered.

Be careful with purge, as you could irreversibly delete some files you forgot to add to the repository. If you only want to print the list of files that this program would delete, use the –print option.

Return True on success

all - purge ignored files too include - include names matching the given patterns exclude - exclude names matching the given patterns abortonerror - abort if an error occurs p - print filenames instead of deleting them

strip(changeset)¶

Inherited method strip()

unbundle(file, update=False, ssh=None, remotecmd=None, insecure=False)¶

Apply one or more compressed changegroup files generated by the bundle command.

Returns True on success, False if an update has unresolved files.

file - source file name update - update to new branch head if changesets were unbundled ssh - specify ssh command to use remotecmd - specify hg command to run on the remote side insecure - do not verify server certificate (ignoring web.cacerts

config)

class repoman.hg.hglibext.revision¶

Bases: hglib.client.revision

parents¶

repoman.hg.hgwebapi module¶

class repoman.hg.hgwebapi.HGWebApi(base_url, user, password)¶

Bases: object

get_branches(repository, limit=None)¶

Get the branches for the given repository

Parameters:	repository (string) – repository name limit (int) – max search
Returns:	generator with the branch names

opener¶

repoman.hg.repository module¶

class repoman.hg.repository.Repository(repo_path, repo_indexer=None, message_builder=None, signature=None)¶

Bases: repoman.repository.Repository

Models a Mercurial repository

MERGING_WITH_ANCESTOR_LITERAL = 'working directory ancestor has no effect'¶

NEW_REMOTE_HEAD_LITERAL = 'creates new remote head'¶

add(files)¶

Inherited method add()

branch(they, *args, **kwargs)¶

branch_exists(they, *args, **kwargs)¶

commit(they, *args, **kwargs)¶

compare_branches(they, *args, **kwargs)¶

exterminate_branch(branch_name, repo_origin, repo_dest)¶

Inherited method exterminate_branch()

get_ancestor(they, *args, **kwargs)¶

get_branch(they, *args, **kwargs)¶

get_branches(active=False, closed=False)¶

Inherited method get_branches()

get_changeset_branches(changeset)¶

Inherited method get_changeset_branches()

get_changeset_tags(changeset_hash)¶

Inherited method get_changeset_tags()

get_parents(they, *args, **kwargs)¶

get_revset(cs_from=None, cs_to=None, branch=None, keyword=None, date=None)¶

Inherited method get_revset()

is_merge(they, *args, **kwargs)¶

merge(local_branch=None, other_rev=None, other_branch_name=None, dry_run=False)¶

Inherited method merge()

parents(they, *args, **kwargs)¶

pull(they, *args, **kwargs)¶

push(they, *args, **kwargs)¶

rawcommand(they, *args, **kwargs)¶

strip(they, *args, **kwargs)¶

tag(they, *args, **kwargs)¶

tag_exists(they, *args, **kwargs)¶

tags(they, *args, **kwargs)¶

terminate_branch(branch_name, repo_origin, repo_dest)¶

Inherited method terminate_branch()

tip(they, *args, **kwargs)¶

update(they, *args, **kwargs)¶

class with_repo(error_message=None, exceptions=(<class 'hglib.error.CommandError'>, <class 'hglib.error.ServerError'>, <class 'hglib.error.ResponseError'>))¶

Bases: object

@with_repo¶

Decorator for methods in this class that use a repository.

It adds a parameter after “self” with the repository, so, a method defined like this:

@with_repo()
def method(self, repo, a, b):
    ...

Will have to be called as:

hg_repository.method(a, b)

And will receive self as usual, and a repository instantiated with the path of the hg_repository object.

DEFAULT_EXCEPTIONS = (<class 'hglib.error.CommandError'>, <class 'hglib.error.ServerError'>, <class 'hglib.error.ResponseError'>)¶

Module contents¶