zim.plugins.versioncontrol.bzr.BZRApplicationBackend

class documentation

class BZRApplicationBackend(VCSApplicationBase): (source)

Undocumented

Class Method	`build_bin_application_instance`	Builds an `Application` object for the backend command @returns: an `Application` object @implementation: must be implemented in child classes.
Method	`add`	Runs: bzr add {{PATH}}
Method	`annotate`	No summary
Method	`build_revision_arguments`	No summary
Method	`cat`	Runs: bzr cat {{PATH}} {{REV_ARGS}}
Method	`commit`	Runs: bzr commit -m {{MSG}} {{PATH}}
Method	`diff`	No summary
Method	`ignore`	Build a .bzrignore file including the file_to_ignore_content
Method	`init`	Runs: bzr init
Method	`init_repo`	No summary
Method	`is_modified`	Returns true if the repo is not up-to-date, or False @returns: True if the repo is not up-to-date, or False
Method	`log`	Runs: bzr log --forward {{PATH}} the "--forward" option allows to reverse order
Method	`log_to_revision_list`	No summary
Method	`move`	Runs: bzr mv --after {{OLDPATH}} {{NEWPATH}}
Method	`remove`	Runs: bzr rm {{PATH}}
Method	`repo_exists`	Returns True if a repository is already setup @returns: `True` if a repository is already setup in the root directory @implementation: must be implemented in child classes.
Method	`revert`	No summary
Method	`status`	Runs: bzr status
Method	`test_whoami`	return True if the user is is setup or non-zero
Method	`whoami`	Runs: bzr whoami zim

Inherited from VCSApplicationBase:

Class Method	`tryexec`	Check if the command associated with the backend is available. @returns: `True` if the command is available
Method	`__init__`	No summary
Method	`commit_version`	Run a commit operation.
Method	`list_versions`	Returns a list of all versions, for a file or for the entire repo
Method	`on_created`	Callback when a file has been created @param fs: the watcher object @param path: a `File` or `Folder` object
Method	`on_moved`	No summary
Method	`on_removed`	Callback when a file has been delted @param fs: the watcher object @param path: a `File` or `Folder` object
Method	`pipe`	No summary
Method	`run`	Execute a command with the associated binary with 'params' parameters. Note: the working directory is the root associated to the repository
Method	`stage`	Prepares the repo for a commit. Used, for example, by git to stage changes so that the status message in SaveVersionDialog shows what will be committed.
Instance Variable	`notebook_dir`	Undocumented
Instance Variable	`root`	Undocumented
Method	`_ignored`	No summary
Instance Variable	`_app`	Undocumented

Inherited from ConnectorMixin (via VCSApplicationBase):

Method	`connectto`	Connect to signals of another object E.g.:
Method	`connectto_all`	Convenience method to combine multiple calls to `connectto()`.
Method	`disconnect_all`	Disconnect all signals that have been connected with `connectto` and friends. Typically called when you want to destroy this object.
Method	`disconnect_from`	Disc all signals that have been connected with `connectto` and friends to a specific object.
Method	`_disconnect_from`	Undocumented
Instance Variable	`_connected_signals`	Undocumented

@classmethod
def build_bin_application_instance(cls): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.build_bin_application_instance

Builds an Application object for the backend command

Returns
an `Application` object
Unknown Field: implementation
must be implemented in child classes.

def add(self, path=None): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.add

Runs: bzr add {{PATH}}

def annotate(self, file, version=None): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.annotate

FIXME Document return 1 | line1 2 | line2 ...

def build_revision_arguments(self, versions): (source)

Build a list including required string/int for running an VCS command # Accepts: None, int, string, (int,), (int, int) # Always returns a list # versions content:

None: return an empty list
int ou string: return ['-r', int]
tuple or list: return ['-r', '%i..%i']

It's all based on the fact that defining revision with current VCS is: -r revision -r rev1..rev2

def cat(self, path, version): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.cat

Runs: bzr cat {{PATH}} {{REV_ARGS}}

def commit(self, path, msg): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.commit

Runs: bzr commit -m {{MSG}} {{PATH}}

def diff(self, versions=None, file=None): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.diff

def ignore(self, file_to_ignore_regexp): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.ignore

Build a .bzrignore file including the file_to_ignore_content

def init(self): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.init

Runs: bzr init

def init_repo(self): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.init_repo

initialize a repository in the associated folder. Runs init(), adds existing files etc.

Returns
nothing.
Unknown Field: implementation
must be implemented in the child class.

def is_modified(self): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.is_modified

Returns true if the repo is not up-to-date, or False

Returns
True if the repo is not up-to-date, or False

def log(self, path=None): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.log

Runs: bzr log --forward {{PATH}} the "--forward" option allows to reverse order

def log_to_revision_list(self, log_op_output): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.log_to_revision_list

Converts the result of a log() call into a list of tuples representing the commits.

Parameters
log_op_output	a list of str() representing the log operation output before being parsed.
Returns
a list of tuple (revision-id, date, user, commit-message) representing the entire life.
Unknown Field: implementation
must be implemented in the child class. Actually, this method is a "log" operation parser which will convert str lines into list of 4-str tuples : (revision-id, date, user, commit-message)

def move(self, oldpath, newpath): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.move

Runs: bzr mv --after {{OLDPATH}} {{NEWPATH}}

def remove(self, path): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.remove

Runs: bzr rm {{PATH}}

def repo_exists(self): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.repo_exists

Returns True if a repository is already setup

Returns
`True` if a repository is already setup in the root directory
Unknown Field: implementation
must be implemented in child classes.

def revert(self, path=None, version=None): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.revert

def status(self): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.status

Runs: bzr status

def test_whoami(self): (source)

return True if the user is is setup or non-zero

def whoami(self, user): (source)

Runs: bzr whoami zim