From 68e51b5f6fb23b3779d4ab7334e9ed38b46cf79a Mon Sep 17 00:00:00 2001
From: Benjamin Labrecque <labrecque.benji@gmail.com>
Date: Thu, 23 Jul 2026 16:25:20 +0200
Subject: [PATCH] docs: add python packaging docs

---
 docs/developer/python/packaging.md | 28 ++++++++++++++++++++++++++++
 1 file changed, 28 insertions(+)
 create mode 100644 docs/developer/python/packaging.md

diff --git a/docs/developer/python/packaging.md b/docs/developer/python/packaging.md
new file mode 100644
index 0000000..dca1816
--- /dev/null
+++ b/docs/developer/python/packaging.md
@@ -0,0 +1,28 @@
+# Python packaging
+
+## Gitea
+
+To publish to Gitea you need a personal access token.
+
+Packages belong to an organization (e.g. `sls` or a user `labrec_b`), not a repo.
+
+You can then link a repo to use the packages.
+
+Configure your `~/pypirc`:
+
+```
+[distutils]
+index-servers = gitea
+
+[gitea]
+; repository = https://gitea.psi.ch/api/packages/sls/pypi
+repository = https://gitea.psi.ch/api/packages/labrec_b/pypi
+username = labrec_b
+password = <personal-access-token>
+```
+
+then
+
+```
+python3 -m twine upload --repository gitea dist/* --verbose
+```