Autodoc¶
Config¶
-
exception
gilt.config.
ParseError
¶ Error raised when a config can’t be loaded properly.
-
gilt.config.
config
(filename)¶ Construct Config object and return a list.
Parse filename: A string containing the path to YAML file. Returns: list
Git¶
-
gilt.git.
clone
(name, repository, destination, debug=False)¶ Clone the specified repository into a temporary directory and return None.
Parameters: - name – A string containing the name of the repository being cloned.
- repository – A string containing the repository to clone.
- destination – A string containing the directory to clone the repository into.
- debug – An optional bool to toggle debug output.
Returns: None
-
gilt.git.
extract
(repository, destination, version, debug=False)¶ Extract the specified repository/version into the directory and return None.
Parameters: - repository – A string containing the path to the repository to be extracted.
- destination – A string containing the directory to clone the
repository into. Relative to the directory
gilt
is running in. Must end with a ‘/’. - version – A string containing the branch/tag/sha to be exported.
- debug – An optional bool to toggle debug output.
Returns: None
-
gilt.git.
overlay
(repository, files, version, debug=False)¶ Overlay files from repository/version into the directory and return None.
Parameters: - repository – A string containing the path to the repository to be extracted.
- files – A list of FileConfig objects.
- version – A string containing the branch/tag/sha to be exported.
- debug – An optional bool to toggle debug output.
Returns: None
Util¶
-
gilt.util.
build_sh_cmd
(cmd, cwd=None)¶ Build a sh.Command from a string.
Parameters: - cmd – String with the command to convert.
- cwd – Optional path to use as working directory.
Returns: sh.Command
-
gilt.util.
copy
(src, dst)¶ Handle the copying of a file or directory.
The destination basedir _must_ exist.
Parameters: - src – A string containing the path of the source to copy. If the source ends with a ‘/’, will become a recursive directory copy of source.
- dst – A string containing the path to the destination. If the destination ends with a ‘/’, will copy into the target directory.
Returns: None
-
gilt.util.
print_info
(msg)¶ Print the given message to STDOUT.
-
gilt.util.
print_warn
(msg)¶ Print the given message to STDOUT in YELLOW.
-
gilt.util.
run_command
(cmd, debug=False)¶ Execute the given command and return None.
Parameters: - cmd – A sh.Command object to execute.
- debug – An optional bool to toggle debug output.
Returns: None
-
gilt.util.
saved_cwd
()¶ Context manager to restore previous working directory.