chore(#1): Add PyPI publish step and Gitea registry install instructions
Some checks failed
ci/woodpecker/push/woodpecker Pipeline failed

- Add publish step to .woodpecker.yml that builds wheel/sdist and uploads
  to git.mosaicstack.dev PyPI registry via twine (gated on all quality
  checks, only on main/develop/tags)
- Add link-package step to associate PyPI package with the repository
- Update README and integration guide with Gitea registry install
  instructions (pip --index-url, uv --index-url, pyproject.toml config)
- Version check prevents re-publishing existing versions

Refs #1

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-02-14 22:43:39 -06:00
parent 883fd4d60f
commit 0222bdbcba
3 changed files with 115 additions and 5 deletions

View File

@@ -6,14 +6,31 @@ This guide covers installing and integrating `mosaicstack-telemetry` into Python
## Installation
Install from the Mosaic Stack package registry:
```bash
pip install mosaicstack-telemetry
pip install mosaicstack-telemetry --index-url https://git.mosaicstack.dev/api/packages/mosaic/pypi/simple/
```
Or with [uv](https://docs.astral.sh/uv/):
```bash
uv add mosaicstack-telemetry
uv add mosaicstack-telemetry --index-url https://git.mosaicstack.dev/api/packages/mosaic/pypi/simple/
```
To avoid repeating the index URL, configure it in your project's `pyproject.toml`:
```toml
[[tool.uv.index]]
name = "mosaic"
url = "https://git.mosaicstack.dev/api/packages/mosaic/pypi/simple/"
```
Or in `pip.conf` (`~/.config/pip/pip.conf` on Linux):
```ini
[global]
extra-index-url = https://git.mosaicstack.dev/api/packages/mosaic/pypi/simple/
```
**Requirements:** Python 3.10+. Runtime dependencies: `httpx` and `pydantic`.