tea.utils

tea.utils.get_object(path='', obj=None)

Returns an object from a dot path.

Path can either be a full path, in which case the get_object function will try to import the module and follow the path. Or it can be a path relative to the object passed in as the second argument.

Example for full paths:

>>> get_object('os.path.join')
<function join at 0x1002d9ed8>
>>> get_object('tea.process')
<module 'tea.process' from 'tea/process/__init__.pyc'>

Example for relative paths when an object is passed in:

>>> import os
>>> get_object('path.join', os)
<function join at 0x1002d9ed8>

tea.utils.compress.mkzip(archive, items, mode='w', save_full_paths=False)

Recursively zip a directory

Parameters:

• archive (zipfile.ZipFile or str) – ZipFile object add to or path to the output zip archive.
• items (str or list) – Single item or list of items (files and directories) to be added to zipfile
• mode (str) – w for create new and write a for append to
• save_full_paths (bool) – preserve full paths

tea.utils.compress.seven_unzip(archive, output)

Extract a 7z archive

tea.utils.compress.seven_zip(archive, items, self_extracting=False)

Create a 7z archive

tea.utils.compress.unzip(archive, destination, filenames=None)

Unzip the a complete zip archive into destination directory, or unzip a specific file(s) from the archive.

Usage:

>>> output = os.path.join(os.getcwd(), 'output')
>>> # Archive can be an instance of a ZipFile class
>>> archive = zipfile.ZipFile('test.zip', 'r')
>>> # Or just a filename
>>> archive = 'test.zip'
>>> # Extracts all files
>>> unzip(archive, output)
>>> # Extract only one file
>>> unzip(archive, output, 'my_file.txt')
>>> # Extract a list of files
>>> unzip(archive, output, ['my_file1.txt', 'my_file2.txt'])
>>> unzip_file('test.zip', 'my_file.txt', output)

Parameters:

• archive (zipfile.ZipFile or str) – Zipfile object to extract from or path to the zip archive.
• destination (str) – Path to the output directory
• filenames (str, list or None) – Path(s) to the filename(s) inside the zip archive that you want to extract.

tea.utils.crypto.encrypt(data, digest=True)

Performs encryption of provided data.

tea.utils.crypto.decrypt(data, digest=True)

Decrypts provided data.

class tea.utils.daemon.Daemon(pidfile, stdin='/dev/null', stdout='/dev/null', stderr='/dev/null')

A generic daemon class.

Usage: subclass the Daemon class and override the run() method

daemonize()

Do the UNIX double-fork magic

See Stevens’ “Advanced Programming in the UNIX Environment” for details (ISBN 0201563177) http://www.erlenstar.demon.co.uk/unix/faq_2.html#SEC16

restart(*args)

Restart the daemon

run(*args)

You should override this method when you subclass Daemon.

It will be called after the process has been daemonized by start() or restart().

start(*args)

Start the daemon

stop()

Stop the daemon

tea.utils.encoding.smart_bytes(s, encoding='utf-8', strings_only=False, errors='strict')

Returns a bytes version of ‘s’, encoded as specified in ‘encoding’.

If strings_only is True, don’t convert (some) non-string-like objects.

tea.utils.encoding.smart_text(s, encoding='utf-8', strings_only=False, errors='strict')

Returns a unicode object representing ‘s’. Treats bytes using the ‘encoding’ codec.

If strings_only is True, don’t convert (some) non-string-like objects.