Skip to main content

chuchichaestli

chuchichaestli is a collection of model architectures and other useful bits of code in use at the Intelligent Vision Systems group at the University of Applied Sciences Zurich (ZHAW).

Installation

Tagged releases are available as PyPI packages. To install the latest package, run:

pip install chuchichaestli

For the bleeding-edge package directly from the git main, clone the repository and run the following command in the root directory of the repository:

pip install -e .

Alternatively, you can install the package directly from GitHub:

pip install git+https://github.com/CAIIVS/chuchichaestli.git

Development

Releases and packages are automatically created with various GitHub action workflows. The general development workflow is as follows

  1. checkout to a non-default branch to apply patches, features, etc.
  • each commit to a non-default branch triggers an install test (on latest Python versions) and a package build
  1. open a PR
  • at opening and each subsequent commit to that PR, the build is uploaded to TestPyPI and a dev version is incremented (e.g. v1.2.0 -> v1.2.0-dev0)
  1. once the PR is reviewed, it can be merged
  • at merge, the micro version is incremented on the main branch and tagged (e.g. v1.2.0-dev7 -> v1.2.1)
  • subsequently, a package is built, published to PyPI, and released on GitHub with the latest version tag
  1. every once in a while it is necessary to bump minor or major versions
  • minor and major version can be triggered, by manually dispatching the on_dispatch.yml workflow
  • on the web interface (using the option minor or major), or
  • on CLI with gh workflow run on_dispatch.yml -f type=minor (or -f type=major)

Reusable workflows

In .github/workflows/ there are several reusable workflows which provide the basic utility for the triggered jobs:

  • test-install.yml
    • test install on the supported Python endpoints, 3.10 and 3.13, by default; pass full-matrix: true to sweep every supported version (the release workflow does)
    • ruff linting checks (stop build if error occurs)
    • run unit tests with pytest and collect coverage (fails below the coverage-threshold input)
    • upload test results (for prosperity)
  • build-package.yml
    • build package with uv build on Python 3.13 by default; pass versions (a JSON array) to build on several, if wheels are ABI-specific
    • upload one dist artifact per Python version, named <artifact-name>-<version>
  • github-release.yml
    • download all dist artifacts matching <artifact-name>-* and merge them
    • sign package dist with Sigstore
    • create and upload GitHub release
  • publish-to-pypi.yml
    • download all dist artifacts matching <artifact-name>-* and merge them
    • publish to PyPI, or to TestPyPI when called with test: true
  • deploy-docs.yml
    • build the docs with MkDocs and publish them to GitHub Pages
    • uses the Pages artifact flow (upload-pages-artifact + deploy-pages), not a gh-pages push
    • can be run manually via gh workflow run deploy-docs.yml
  • phdenzel/pyverto@v*
    • use pyverto to increment a version
    • commit and push changes

Triggered workflows

  • on_branches.yml
    • triggers on commit to any branch (except main) not in a PR (pull request)
    • runs test-install-python-version and build-package
  • on_pr.yml
    • triggers on commit to a PR
    • runs test-install-python-version, build-package, publish-to-testpypi, and version-bump-dev
  • on_merge.yml
    • triggers on PR merge
    • runs version-bump-on-merge (increments micro version on main)
  • on_push.yml
    • triggers on push to the main branch upon automatic version change
    • runs test-install-python-version, build-package, publish-to-pypi, github-release, deploy-docs
  • on_dispatch.yml
    • triggers on dispatch (e.g. by running gh workflow run on-dispatch.yml -f type=minor)
    • runs version-bump (increments chosen type of version on main)

Metadata

Release files for chuchichaestli 0.4.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for chuchichaestli 0.4.0
File Size Uploaded
chuchichaestli-0.4.0.tar.gz 586.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for chuchichaestli 0.4.0
File Interpreter ABI Platform
chuchichaestli-0.4.0-py3-none-any.whl Python 3 none any Details

Total release size: 827.4 kB

Release files / chuchichaestli-0.4.0.tar.gz

Download URL chuchichaestli-0.4.0.tar.gz
Size 586.1 kB
Tags Source
SHA-256 checksum
How to use checksums
0447bed070b37e8c4d10d084af928b3bca1b119b4157ce9122c3f1727e2562b9
BLAKE2b-256 checksum
How to use checksums
908184f93d5256686a211b8a95c4b212daeb23d22f022e5801d8b8cd4e22e641
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / chuchichaestli-0.4.0-py3-none-any.whl

Download URL chuchichaestli-0.4.0-py3-none-any.whl
Size 241.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
afc97b25ec047b47b7453fcd163735711713a5f8e5c6a2f7ac4d08530920dd03
BLAKE2b-256 checksum
How to use checksums
d7fc754f0607e6c04aa0e4b3675c96b6c1cc66e5bdf2542d892b2ceb0a01df39
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page