@devries-cameron20 / composio Mirror · read-only
Fork 0

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

Mirrored from https://github.com/Camo67/composio.git

Synced Nov 21, 06:00 UTC

next
md 51 lines 2.1 KB
Rendered Raw
1 # Python Release Workflow
2
3 ## Build
4
5 Run from `python/` after the environment is ready:
6
7 ```bash
8 make build
9 ```
10
11 `make build` cleans build outputs, builds the root package, then builds provider packages and collects distributions.
12
13 Stable and beta Python releases use the unified `sdk.release.yml` member request and one approved release PR; a beta publishes `X.Y.ZbN` for core and every provider. Author changesets for the private `@composio/python-sdk` marker; the release bot synchronizes core and all supported provider metadata. Read `ts/docs/internal/release.md` for request, approval, merge, recovery and owner setup steps.
14
15 Recovery: re-run a failed tag run with `gh run rerun <tag-run-id> --failed`. When the approved candidate expired, add a changeset and request a new release. Agents stop at "release PR ready for approval" and never merge it.
16
17 Candidate builds install only the `release` dependency group from `uv.lock` with `uv sync --locked --only-group release` and use `BUILD_ARGS=--no-isolation`. Bump `build` or `setuptools` in that group, then run `uv lock`. Stable publication uses the tag-only `pypi-release` OIDC environment. The legacy `py.release.yml` keeps build-only dispatch and core-prerelease publication through `pypi`.
18
19 ## Dependency Bounds
20
21 Third-party runtime dependencies carry an upper bound at the next major line after the newest release available when the cap was set (`<1` for 0.x packages). `certifi` stays uncapped so CA bundle updates always install. `pysher` is pinned exactly because it is unmaintained. Keep `pyproject.toml` and `setup.py` identical for each package.
22
23 ## Client Pin Bumps
24
25 Before bumping `composio-client`, verify the version resolves:
26
27 ```bash
28 pip index versions composio-client
29 ```
30
31 Update all Python pins together:
32
33 - `python/pyproject.toml`
34 - `python/setup.py`
35 - root `uv.lock`
36
37 Regenerate the lockfile from the repo root:
38
39 ```bash
40 uv lock --upgrade-package composio-client
41 ```
42
43 ## Verification
44
45 Run import and package checks after dependency changes:
46
47 ```bash
48 uv run --package composio python -c "import composio"
49 ```
50
51 Then run the focused nox/Makefile checks relevant to the change.