feat: add build and upload scripts for Forgejo PyPI, update version management

README.md

@@ -136,6 +136,64 @@ pytest
 ```
 
 
+## Building & Publishing
+
+### Update Version
+
+Update the version number across all project files:
+
+```bash
+# PowerShell
+.\update_version.ps1 0.2.0
+
+# Python
+python update_version.py 0.2.0
+
+# Bash
+./update_version.sh 0.2.0
+```
+
+### Build Wheel
+
+Build distribution packages:
+
+```bash
+# PowerShell
+.\build_wheel.ps1
+
+# Python
+python build_wheel.py
+
+# Bash
+./build_wheel.sh
+```
+
+### Upload to Forgejo PyPI
+
+First, create your `.pypirc` configuration:
+
+```bash
+cp .pypirc.example .pypirc
+# Edit .pypirc with your Forgejo access token
+```
+
+Then upload:
+
+```bash
+# PowerShell
+.\upload_wheel_to_forgejo_pypi.ps1
+
+# Bash
+./upload_wheel_to_forgejo_pypi.sh
+
+# Windows Batch
+upload_wheel_to_forgejo_pypi.bat
+```
+
+The package will be available at:
+`https://git.him-tools.de/HIM-public/-/packages/pypi/agravity-client`
+
+
 ## Licence
 
 MIT