zut 0.8.2

Reusable Python and Django common utilities.

Zut

Reusable Python and Django common utilities.

Installation

From PyPI:

pip install zut

From a Git branch or tag (using https or ssh):

pip install git+https://gitlab.com/ipamo/zut.git@main#egg=zut
pip install git+ssh://[e-mail]/ipamo/zut.git@main#egg=zut

Usage examples

Configure logging

from zut import configure_logging
configure_logging()

Flexible in/out

Write text or tabular data to a flexible, easily configurable output: CSV or Excel file, or tabulated stdout/stderr.

The output file may be on the local file system or on a Windows/Samba share (including when the library is used on Linux).

Export text to stdout or to a file:

import sys
from zut import out_file

with out_file(filename or sys.stdout) as f:
    f.write("Content")

Export tabular data to stdout or to a file:

import sys
from zut import out_table

with out_table(filename or sys.stdout, headers=["Id", "Word"]) as t:
    t.append([1, "Hello"])
    t.append([2, "World"])

Tabular data can also be exported using dictionnaries (in this case, headers will be detected automatically by the library):

import sys
from zut import out_table

with out_table(filename or sys.stdout) as t:
    t.append({'id': 1, 'name': "Hello"})
    t.append({'id': 2, 'col3': True})

If filename has extension with .xlsx, output will be in Excel 2010 format. Otherwise it will be in CSV format.

If filename starts with \\, output will be done on the corresponding Windows/Samba share. To indicate Samba credentials, call configure_smb_credentials before using function out_table. Example:

from zut import out_table, configure_smb_credentials

configure_smb_credentials(user=..., password=...)

with out_table(r"\\server\share\path\to\file") as o:
    ...

Resources

• Maintenance of the library and repository