zim.plugins.versioncontrol.fossil.FOSSILApplicationBackend

class documentation

class FOSSILApplicationBackend(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: fossil add {{PATH}}
Method	`annotate`	No summary
Method	`build_revision_arguments`	No summary
Method	`cat`	Runs: fossil cat {{PATH}} {{REV_ARGS}}
Method	`checkout`	Undocumented
Method	`commit`	Runs: fossil commit -m {{MSG}} {{PATH}}
Method	`diff`	No summary
Method	`ignore`	No summary
Method	`init`	Runs: fossil init Usually, the repository is located in some other place than checkout folder, but we put it in the notepad folder and then checkout it.
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: fossil timeline --type ci {{PATH}} "--type ci" option for file commits only
Method	`log_to_revision_list`	No summary
Method	`move`	Runs: fossil mv {{OLDPATH}} {{NEWPATH}}
Method	`remove`	Runs: fossil rm {{PATH}}
Method	`repo_exists`	Returns True if a repository is already setup, or False
Method	`revert`	No summary
Method	`status`	Runs: fossil changes

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: fossil add {{PATH}}

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

overrides zim.plugins.versioncontrol.VCSApplicationBase.annotate

FIXME Document return 0: line1 2: line1 ...

def build_revision_arguments(self, versions): (source)

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

None: return an empty list
string: return ['--from', int]
tuple or list: return ['--from', from, '--to', to]

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

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

overrides zim.plugins.versioncontrol.VCSApplicationBase.cat

Runs: fossil cat {{PATH}} {{REV_ARGS}}

def checkout(self, file): (source)

Undocumented

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

overrides zim.plugins.versioncontrol.VCSApplicationBase.commit

Runs: fossil 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

Configure settings for files to ignore

Parameters
file_to_ignore_regexp	str representing the ignore-glob content. this must be a list of regexp defining the file / path to ignore, separated by a comma.
Returns
nothing

def init(self): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.init

Runs: fossil init Usually, the repository is located in some other place than checkout folder, but we put it in the notepad folder and then checkout it.

def init_repo(self): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.init_repo

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: fossil timeline --type ci {{PATH}} "--type ci" option for file commits only

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: fossil mv {{OLDPATH}} {{NEWPATH}}

def remove(self, path): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.remove

Runs: fossil rm {{PATH}}

def repo_exists(self): (source)

overrides zim.plugins.versioncontrol.VCSApplicationBase.repo_exists

Returns True if a repository is already setup, or False

Returns
a boolean True if a repo is already setup, or False

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: fossil changes