pyikaild 0.0.2

Anonymization and anonymization evaluation library

Python packaging template with Poetry

This template repository is created by the UU Research Engineering team and is aimed to provide a simple project template for python package development. This template uses Poetry as the packaging toolkit, there is another template that is very similar that uses Setuptools.

The template includes:

• Project directory structure
• Project configuration using pyproject.toml
• GitHub actions workflows for testing, linting, type checking and publishing on pypi

Many other project templates exist, check for example this advanced python template by the NL eScience Center.

Dependencies

This template uses:

Tool	Aim
poetry	building
ruff	code linting
pytest	testing
mypy	type checking

If needed, most of these tools can be removed by simply removing the GitHub action that calls the tool, or by changing pyproject.toml

How to use this template

Click Use this template at the top of this page to create a new repository using this template

You will probably want to install/modify the package locally. For this, you will need Poetry. It is recommended for new users of Poetry to read the documentation which is excellent. This template uses a plugin for automated versioning which should be installed. A quick start:

pip install pipx
pipx install poetry
poetry self add "poetry-dynamic-versioning[plugin]"
poetry install

Modificating the template for your package

Step 1: Create new repository from this template

Step 2: Change the name of your package in pyproject.toml

• Change the name of the folder packagename to the name of your package
• Open pyproject.toml and change packagename to the name of your package
• Also change the authors and optionally any other items that you want to change

Step 3: Change GitHub Actions workflow

• Open .github/workflows/python-package.yml
• Change packagename to the name of your package (line 21)
• Many actions are commented out, uncomment them when you want to start using them.

Step 4: Replace this README file with your README

• You may use this README template

Step 5: Change the license file

• Open LICENSE, change the copyright holder when required (line 3)
• Or replace the entire license file if another license applies

Step 6: Add a citation file

• Create a citation file for your repository using cffinit

Next Steps

Now that you have succesfully created a package, there are some further steps to consider.

Tagging your commits

When your library grows, you might want to give some commits (on main) a more human-readable tag, such as 1.2.0. To do this, do the following:

git checkout main && git pull
git tag -a "v1.2.0" -m "Version 1.2.0"
git push --tags  # upload the tags to GitHub

Publishing on Pypi

For publishing the package on Pypi you need to create API tokens.

If you put this token in GitHub secrets with the name PYPI_API_TOKEN, then you can automatically generate a new release on PyPi by creating a release on GitHub. You have to select the tag that was created in the previous step.

Note however that your first release on PyPi has to be done manually and can't be done using this method.