TensorImgPipeline

This is a repository for creating and running Tensor Image Pipelines, short tipis.

• Github repository: https://github.com/tensorimgpipeline/TensorImgPipeline/
• Documentation https://tensorimgpipeline.github.io/TensorImgPipeline/

Development

To contribute to this project it is strongly recommended to use the devcontainer for local testing. Since some tests involve creating demo projects, which could lead to tampering with your local environment outside of the project.

If your contribution does not involve in certain actions, you might also execute run tests on a local test environment. For Example: Your tests includes only backend actions, which do not interact with the app config or create new scaffolding projects.

If you change files that interact with project scaffolding or CLI flows, run the full suite (preferably in devcontainer) and extend tests if necessary.

Use explicit test scopes locally:

# Fast feedback (unit-focused)
make test-fast

# Full suite (unit + integration + e2e)
make test-full

Setup devcontainer

• Ensure docker or podman (recommended) are installed and configured correctly.
• Install VScode Extensions for Remote Development

This project already provides the necessary configurations to run this project inside devcontainer:

• Open Command Pallete.
• Execute Dev Containers: Reopen in Container

Getting started with your project

1. Create a New Repository

First, create a repository on GitHub with the same name as this project, and then run the following commands:

git init -b main
git add .
git commit -m "init commit"
git remote add origin git@github.com:tensorimgpipeline/TensorImgPipeline.git
git push -u origin main

2. Set Up Your Development Environment

Then, install the environment and the pre-commit hooks with

make install

This will also generate your uv.lock file

3. Run the pre-commit hooks

Initially, the CI/CD pipeline might be failing due to formatting issues. To resolve those run:

uv run pre-commit run -a

4. Commit the changes

Lastly, commit the changes made by the two steps above to your repository.

git add .
git commit -m 'Fix formatting issues'
git push origin main

You are now ready to start development on your project! The CI/CD pipeline will be triggered when you open a pull request, merge to main, or when you create a new release.

To finalize the set-up for publishing to PyPI, see here. For activating the automatic documentation with MkDocs, see here. To enable the code coverage reports, see here.

Releasing a new version

See the project changelog for release notes and migration-impacting changes:

• CHANGELOG.md

• Create an API Token on PyPI.

• Add the API Token to your projects secrets with the name PYPI_TOKEN by visiting this page.

• Create a new release on Github.

• Create a new tag in the form *.*.*.

For more details, see here.

Repository initiated with fpgmaas/cookiecutter-uv.