AGENTS.md@infrastructure/publishing/github git:20261006.d465449A

Immutable. This exact content never changes and is served at /api/v1/blob/8cfdbd432f08d20f.

# `infrastructure/publishing/github/`

GitHub Releases REST API helper.

## Public API

```python
from infrastructure.publishing.github import create_github_release
```

### `create_github_release`

```python
create_github_release(
    tag_name: str,
    release_name: str,
    description: str,
    assets: list[Path],
    token: str,
    repo: str,
    *,
    base_url: str = "https://api.github.com",
) -> str
```

Returns the release HTML URL. Non-existent assets are skipped with a warning.

## Environment variables

| Variable | Use |
| --- | --- |
| `GITHUB_TOKEN` | Personal access token with `repo` scope |

## Tests

```bash
uv run pytest tests/infra_tests/publishing/test_platforms.py::TestCreateGithubRelease -v
```

## See also

- [`README.md`](README.md)
- [`../registry.py`](../registry.py) — canonical platform discovery