diff options
author | Jauhien Piatlicki (jauhien) <piatlicki@gmail.com> | 2013-08-01 13:42:15 +0200 |
---|---|---|
committer | Jauhien Piatlicki (jauhien) <piatlicki@gmail.com> | 2013-08-01 13:42:15 +0200 |
commit | 12987b9b5b0e24af55a7fe27816db605a3bd578e (patch) | |
tree | 0eec583fa13e9fd76c73d76bf6e46109e3c09ed9 | |
parent | g_sorcery/ebuild: Docstrings added (diff) | |
download | g-sorcery-12987b9b5b0e24af55a7fe27816db605a3bd578e.tar.gz g-sorcery-12987b9b5b0e24af55a7fe27816db605a3bd578e.tar.bz2 g-sorcery-12987b9b5b0e24af55a7fe27816db605a3bd578e.zip |
g_sorcery/fileutils: Docstrings added
-rw-r--r-- | g_sorcery/fileutils.py | 41 |
1 files changed, 41 insertions, 0 deletions
diff --git a/g_sorcery/fileutils.py b/g_sorcery/fileutils.py index 7a096b1..ab42ff2 100644 --- a/g_sorcery/fileutils.py +++ b/g_sorcery/fileutils.py @@ -139,6 +139,9 @@ def get_pkgpath(root = None): return os.path.dirname(os.path.abspath(root)) class ManifestEntry: + """ + A manifest entry for a file. + """ def __init__(self, directory, name, ftype): self.directory = directory self.name = name @@ -146,6 +149,9 @@ class ManifestEntry: self.digest() def digest(self): + """ + Digest a file associated with a manifest entry. + """ h_sha256 = hashlib.new('SHA256') h_sha512 = hashlib.new('SHA512') h_whirlpool = hashlib.new('whirlpool') @@ -161,6 +167,14 @@ class ManifestEntry: def fast_manifest(directory): + """ + Digest package directory. + This function is intended to be used in place of repoman manifest, + as it is to slow. + + Args: + directory: Directory. + """ manifest = [] metadata = os.path.join(directory, "metadata.xml") @@ -181,6 +195,19 @@ def fast_manifest(directory): def _call_parser(f_name, parser, open_file = True, open_mode = 'r'): + """ + Call parser on a given file. + + Args: + f_name: File name. + parser: Parser function. + open_file: Whether parser accepts a file descriptor. + open_mode: Open mode for a file. + + Returns: + A dictionary with one entry. Key if a file name, content is + content returned by parser. + """ data = None if open_file: with open(f_name, open_mode) as f: @@ -191,6 +218,20 @@ def _call_parser(f_name, parser, open_file = True, open_mode = 'r'): def load_remote_file(uri, parser, open_file = True, open_mode='r', output=""): + """ + Load files from an URI. + + Args: + uri: URI. + parser: Parser that will be applied to downloaded files. + open_file: Whether parser accepts a file descriptor. + open_mode: Open mode for a file. + output: What output name should downloaded file have + (it will be a key identifying data loaded from this file) + + Returns: + Dictionary with a loaded data. Key is filename, content is data returned by parser. + """ download_dir = TemporaryDirectory() loaded_data = {} if wget(uri, download_dir.name, output): |