zut 0.4.2

Reusable Python, Django and PostgreSql utilities.

Zut

Reusable Python, Django and PostgreSql utilities.

Install

From PyPI:

pip install zut

From Git, last version:

pip install git+https://gitlab.com/ipamo/zut.git@main

Use SSH instead of HTTPS url:

pip install git+ssh://[e-mail]/ipamo/zut.git@main

Specific version, including extra dependencies:

pip install git+https://gitlab.com/ipamo/zut.git@v0.3.1#egg=zut[extra]

In a requirements.txt file, including extra dependencies:

zut[extra] @ git+https://gitlab.com/ipamo/zut.git@v0.3.1#egg=zut[extra]

Dev quick start

Install Python, its packet manager (pip) and PostgreSql. Under Linux, also install password manager pass (used as credentials manager).

Windows pre-requisites:

• Download Python and install it.
• Download PostgreSql, install it, and add binaries (C:\Program Files\PostgreSQL\14\bin) to PATH.

Linux (Debian) pre-requisites:

sudo apt install python3-venv python3-pip postgresql pass

Create Python virtual environment (example for Windows):

python -m venv .venv      # Debian: python3 -m venv .venv
.\.venv\Scripts\activate  # Linux: source .venv/bin/activate
pip install .[all,dev]

Create test database (cf. parameters in tests/settings.py). Example:

sudo -u postgres psql -c "create database test_zut encoding 'utf8' template 'template0'"

For Linux, configure password manager pass. Example:

# Import your GPG key, show key identifier and mark key as trusted
gpg --import my-private-gpg-key.asc
gpg --list-secret-keys
gpg --edit-key [e-mail]
trust
5
o
q

# Initialize "pass" with your GPG key
pass init [e-mail]

Run tests:

python -m unittest

Run commands :

python -m zut --help

Publish library

Configure ~/.pypirc (see example).

Build and upload distribution:

# $env:HTTPS_PROXY="..."                         # if necessary
# $env:TWINE_CERT="C:\...\ca-certificates.crt"   # if necessary
python tools.py build --upload