releasepro 0.1.0__tar.gz

releasepro-0.1.0/.gitignore

@@ -0,0 +1,7 @@
+.venv/
+__pycache__/
+*.egg-info/
+dist/
+build/
+.pytest_cache/
+notes-out/

releasepro-0.1.0/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+All notable changes to releasepro. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
+
+## 0.1.0 (2026-10-21)
+
+### Added
+
+- `releasepro run --as LOGIN` starts the release workflow on the release
+  branch, approves each gate as it appears once you say yes, and then checks
+  that every channel lists the version. It is gitpro's release script, made
+  generic and driven by `releasepro.toml`.
+- Run again after it stops (Ctrl-C, a failed job, a gate answered no),
+  `releasepro run` follows the run still going on that commit or offers to
+  re-run its failed jobs. `--run ID` picks up a given run.
+- `releasepro verify X.Y.Z` checks PyPI, the GitHub release, the MCP
+  Registry, the VS Code Marketplace, Open VSX and a site, and waits up to 20
+  minutes for the ones that list a version late. `--json` prints the result.
+- `releasepro notes X.Y.Z` writes the release notes and an announcement draft
+  from the changelog. `--check` fails when the changelog has no section for
+  the version, so a release without notes stops before it starts.
+- The `verify` action runs `releasepro verify` in a workflow.
+- AGENTS.md and a skill tell coding agents how to set up and run a release,
+  and what to leave to a person.

releasepro-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yantrakar and Sandeep Shelke
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

releasepro-0.1.0/PKG-INFO

@@ -0,0 +1,141 @@
+Metadata-Version: 2.5
+Name: releasepro
+Version: 0.1.0
+Summary: One gated GitHub Actions release run for any repo: a person's yes per channel, no stored token, every channel checked, the announcement last
+Project-URL: Homepage, https://github.com/Yantrakar/releasepro
+Project-URL: Issues, https://github.com/Yantrakar/releasepro/issues
+Project-URL: Changelog, https://github.com/Yantrakar/releasepro/blob/main/CHANGELOG.md
+Author: Yantrakar
+License-Expression: MIT
+License-File: LICENSE
+Keywords: changelog,github-actions,mcp-registry,open-vsx,pypi,release,trusted-publishing,vscode-marketplace
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: POSIX
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: System :: Software Distribution
+Requires-Python: >=3.9
+Requires-Dist: gitpro<0.5,>=0.4.3
+Requires-Dist: tomli>=1.1; python_version < '3.11'
+Description-Content-Type: text/markdown
+
+# releasepro
+
+One gated GitHub Actions release run for any repo:
+
+- a person says yes at each channel's gate;
+- no token is stored anywhere;
+- every channel is checked until it lists the version;
+- the release notes and an announcement draft come from your changelog.
+
+The promise: **a version is announced only once it can be installed from every
+channel, and nothing is published without a person's yes.**
+
+releasepro started as the release tool of [gitpro](https://github.com/Yantrakar/gitpro),
+which releases to GitHub, PyPI, the VS Code Marketplace, Open VSX, the MCP Registry
+and its site from one run. The spec is [docs/spec/00-product.md](docs/spec/00-product.md).
+
+## Install
+
+```sh
+pipx install releasepro
+```
+
+It needs Python 3.9 or newer, git, and the GitHub CLI `gh` 2.40 or newer, signed in
+to the account that approves releases.
+
+## Use
+
+Put a `releasepro.toml` at the root of your repo:
+
+```toml
+[release]
+repo = "Owner/name"
+version_file = "src/name/VERSION"   # the first word of line 1 is X.Y.Z
+branch = "main"
+workflow = "release.yml"            # started with workflow_dispatch
+preflight = ["gitpro why"]          # commands that must exit 0 first
+
+[channel.github]
+assets = ["name-{v}-py3-none-any.whl", "name-{v}.tar.gz", "SHA256SUMS"]
+
+[channel.pypi]
+project = "name"
+
+[notes]
+changelog = "CHANGELOG.md"
+summary = "One line about the project, used in the announcement."
+```
+
+Other channels: `[channel.vscode-marketplace] extension = "publisher.name"`,
+`[channel.openvsx] extension = "namespace/name"`,
+`[channel.mcp-registry] name = "io.github.Owner/name"` and
+`[channel.site] url = "https://…"`, with `names_version` for the text the page holds
+once it is on the new version (`{v}` is the version).
+
+Then, on the release branch, with the version file and the changelog updated:
+
+```sh
+releasepro notes --check        # the changelog has a section for the version
+releasepro run --as LOGIN       # start the run, approve each gate, check every channel
+releasepro verify               # check again later; changes nothing
+releasepro notes --announcement # the draft post
+```
+
+`run` asks before it starts the run and at every gate; `--yes` answers yes for you.
+Run it again after it stops (Ctrl-C, a failed job, a gate answered no): it follows the
+run still going on that commit, or offers to re-run the failed jobs. `--run ID` picks
+up a given run. It never switches your global `gh` account; it runs `gh` as `LOGIN`
+through gitpro.
+
+Exit codes: 0 done, 1 a check or a job failed, 2 usage or setup error, 130 stopped.
+`verify` and `notes` take `--json`.
+
+## Release notes and the announcement
+
+From the changelog section for the version (`## 1.2.3` or `## [1.2.3]`, as
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) writes it),
+`releasepro notes --write DIR` writes:
+
+- `RELEASE_NOTES.md`: the section as you wrote it, then one line per channel. Use it
+  as the GitHub release's body.
+- `ANNOUNCEMENT.md`: a short post of at most 280 characters
+  (`[notes] short_limit`) and a long one, built from your `summary`, the first sentence
+  of each bullet and the links. Attach it to the release.
+
+releasepro adds no claim of its own, and it posts nothing: once every channel lists
+the version, `run` prints the short post for you to post.
+
+## Your release workflow
+
+Your `release.yml` runs on `workflow_dispatch` on the release branch and has one
+GitHub environment with a required reviewer per channel: `release` for the tag and
+the GitHub release, `pypi`, `marketplace`, `openvsx` and `mcp-registry`. This repo's
+own [release.yml](.github/workflows/release.yml) is a working example with `release`
+and `pypi`. Shared workflows and `releasepro init` come in 0.2.0.
+
+## In a workflow: the `verify` action
+
+```yaml
+- uses: Yantrakar/releasepro@<full commit sha>
+  with:
+    version: 1.2.3          # default: the version file
+    wait-minutes: 20
+```
+
+On a Linux or macOS runner, after `actions/checkout`, it runs `releasepro verify`
+against the `releasepro.toml` in the checkout. It passes once every channel lists the
+version, and fails if one does not by the end of the wait.
+
+## For coding agents
+
+[AGENTS.md](AGENTS.md) and the skill in [.agents/skills/releasepro](.agents/skills/releasepro/SKILL.md)
+say how to set up and run a release, and what to leave to a person: approving a gate,
+creating an environment, a trusted publisher or a cloud credential, and posting the
+announcement.
+
+## License
+
+MIT

releasepro-0.1.0/README.md

@@ -0,0 +1,118 @@
+# releasepro
+
+One gated GitHub Actions release run for any repo:
+
+- a person says yes at each channel's gate;
+- no token is stored anywhere;
+- every channel is checked until it lists the version;
+- the release notes and an announcement draft come from your changelog.
+
+The promise: **a version is announced only once it can be installed from every
+channel, and nothing is published without a person's yes.**
+
+releasepro started as the release tool of [gitpro](https://github.com/Yantrakar/gitpro),
+which releases to GitHub, PyPI, the VS Code Marketplace, Open VSX, the MCP Registry
+and its site from one run. The spec is [docs/spec/00-product.md](docs/spec/00-product.md).
+
+## Install
+
+```sh
+pipx install releasepro
+```
+
+It needs Python 3.9 or newer, git, and the GitHub CLI `gh` 2.40 or newer, signed in
+to the account that approves releases.
+
+## Use
+
+Put a `releasepro.toml` at the root of your repo:
+
+```toml
+[release]
+repo = "Owner/name"
+version_file = "src/name/VERSION"   # the first word of line 1 is X.Y.Z
+branch = "main"
+workflow = "release.yml"            # started with workflow_dispatch
+preflight = ["gitpro why"]          # commands that must exit 0 first
+
+[channel.github]
+assets = ["name-{v}-py3-none-any.whl", "name-{v}.tar.gz", "SHA256SUMS"]
+
+[channel.pypi]
+project = "name"
+
+[notes]
+changelog = "CHANGELOG.md"
+summary = "One line about the project, used in the announcement."
+```
+
+Other channels: `[channel.vscode-marketplace] extension = "publisher.name"`,
+`[channel.openvsx] extension = "namespace/name"`,
+`[channel.mcp-registry] name = "io.github.Owner/name"` and
+`[channel.site] url = "https://…"`, with `names_version` for the text the page holds
+once it is on the new version (`{v}` is the version).
+
+Then, on the release branch, with the version file and the changelog updated:
+
+```sh
+releasepro notes --check        # the changelog has a section for the version
+releasepro run --as LOGIN       # start the run, approve each gate, check every channel
+releasepro verify               # check again later; changes nothing
+releasepro notes --announcement # the draft post
+```
+
+`run` asks before it starts the run and at every gate; `--yes` answers yes for you.
+Run it again after it stops (Ctrl-C, a failed job, a gate answered no): it follows the
+run still going on that commit, or offers to re-run the failed jobs. `--run ID` picks
+up a given run. It never switches your global `gh` account; it runs `gh` as `LOGIN`
+through gitpro.
+
+Exit codes: 0 done, 1 a check or a job failed, 2 usage or setup error, 130 stopped.
+`verify` and `notes` take `--json`.
+
+## Release notes and the announcement
+
+From the changelog section for the version (`## 1.2.3` or `## [1.2.3]`, as
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) writes it),
+`releasepro notes --write DIR` writes:
+
+- `RELEASE_NOTES.md`: the section as you wrote it, then one line per channel. Use it
+  as the GitHub release's body.
+- `ANNOUNCEMENT.md`: a short post of at most 280 characters
+  (`[notes] short_limit`) and a long one, built from your `summary`, the first sentence
+  of each bullet and the links. Attach it to the release.
+
+releasepro adds no claim of its own, and it posts nothing: once every channel lists
+the version, `run` prints the short post for you to post.
+
+## Your release workflow
+
+Your `release.yml` runs on `workflow_dispatch` on the release branch and has one
+GitHub environment with a required reviewer per channel: `release` for the tag and
+the GitHub release, `pypi`, `marketplace`, `openvsx` and `mcp-registry`. This repo's
+own [release.yml](.github/workflows/release.yml) is a working example with `release`
+and `pypi`. Shared workflows and `releasepro init` come in 0.2.0.
+
+## In a workflow: the `verify` action
+
+```yaml
+- uses: Yantrakar/releasepro@<full commit sha>
+  with:
+    version: 1.2.3          # default: the version file
+    wait-minutes: 20
+```
+
+On a Linux or macOS runner, after `actions/checkout`, it runs `releasepro verify`
+against the `releasepro.toml` in the checkout. It passes once every channel lists the
+version, and fails if one does not by the end of the wait.
+
+## For coding agents
+
+[AGENTS.md](AGENTS.md) and the skill in [.agents/skills/releasepro](.agents/skills/releasepro/SKILL.md)
+say how to set up and run a release, and what to leave to a person: approving a gate,
+creating an environment, a trusted publisher or a cloud credential, and posting the
+announcement.
+
+## License
+
+MIT

releasepro-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["hatchling>=1.26"]
+build-backend = "hatchling.build"
+
+[project]
+name = "releasepro"
+dynamic = ["version"]
+description = "One gated GitHub Actions release run for any repo: a person's yes per channel, no stored token, every channel checked, the announcement last"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+authors = [{ name = "Yantrakar" }]
+keywords = ["release", "github-actions", "pypi", "trusted-publishing", "vscode-marketplace", "open-vsx", "mcp-registry", "changelog"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Operating System :: POSIX",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: System :: Software Distribution",
+]
+dependencies = [
+    "gitpro>=0.4.3,<0.5",
+    "tomli>=1.1; python_version < '3.11'",
+]
+
+[project.urls]
+Homepage = "https://github.com/Yantrakar/releasepro"
+Issues = "https://github.com/Yantrakar/releasepro/issues"
+Changelog = "https://github.com/Yantrakar/releasepro/blob/main/CHANGELOG.md"
+
+[project.scripts]
+releasepro = "releasepro.cli:main"
+
+[tool.hatch.version]
+path = "src/releasepro/VERSION"
+pattern = '\A(?P<version>\d+\.\d+\.\d+)'
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/releasepro"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src/releasepro", "/README.md", "/LICENSE", "/CHANGELOG.md"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

releasepro-0.1.0/src/releasepro/VERSION

@@ -0,0 +1 @@
+0.1.0  2026-10-21  first release: run, verify and notes

releasepro-0.1.0/src/releasepro/__init__.py

@@ -0,0 +1,4 @@
+"""releasepro: one gated release run for any repo. Spec: docs/spec/00-product.md."""
+from pathlib import Path
+
+__version__ = (Path(__file__).with_name("VERSION").read_text(encoding="utf-8").split() or ["0.0.0"])[0]

releasepro-0.1.0/src/releasepro/__main__.py

@@ -0,0 +1,5 @@
+import sys
+
+from .cli import main
+
+sys.exit(main())

releasepro-0.1.0/src/releasepro/cli.py

@@ -0,0 +1,132 @@
+"""The releasepro command (spec 00, section 5.4). Exit codes: 0 done, 1 a check or a job failed,
+2 usage or setup error, 130 stopped."""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+from typing import List, Optional
+
+from . import __version__
+from . import config as _config
+from . import notes as _notes
+
+
+def _parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(prog="releasepro", description="One gated release run for any repo: every channel "
+                                "behind a person's yes, no stored token, the announcement last.")
+    p.add_argument("--version", action="version", version=f"releasepro {__version__}")
+    sub = p.add_subparsers(dest="command", metavar="COMMAND")
+
+    def common(sp: argparse.ArgumentParser) -> None:
+        sp.add_argument("-c", "--config", metavar="PATH", type=Path,
+                        help="releasepro.toml (default: the nearest one at or above the current folder)")
+
+    r = sub.add_parser("run", help="start the release run, approve its gates, then verify every channel")
+    common(r)
+    r.add_argument("--as", dest="login", required=True, metavar="LOGIN",
+                   help="the GitHub account that starts the run and approves its gates")
+    r.add_argument("--yes", action="store_true", help="answer yes to every question")
+    r.add_argument("--run", type=int, metavar="ID", help="follow an existing release run instead of starting one "
+                   "(without it, an unfinished run on HEAD is offered first)")
+
+    v = sub.add_parser("verify", help="check that every channel lists a version; changes nothing")
+    common(v)
+    v.add_argument("version", nargs="?", metavar="X.Y.Z", help="default: the version in the version file")
+    v.add_argument("--as", dest="login", metavar="LOGIN",
+                   help="read the GitHub release as this gh account (default: gh as it is set up)")
+    v.add_argument("--wait", type=float, default=None, metavar="MINUTES",
+                   help="how long to wait for the channels that list a version late (default: 20)")
+    v.add_argument("--json", action="store_true", help="print the result as JSON")
+
+    ver = sub.add_parser("version", help="print the release version, X.Y.Z, from the version file")
+    common(ver)
+
+    n = sub.add_parser("notes", help="the release notes and the announcement draft, from the changelog")
+    common(n)
+    n.add_argument("version", nargs="?", metavar="X.Y.Z", help="default: the version in the version file")
+    g = n.add_mutually_exclusive_group()
+    g.add_argument("--check", action="store_true", help="only check that the changelog has the version's section")
+    g.add_argument("--write", type=Path, metavar="DIR", help="write RELEASE_NOTES.md and ANNOUNCEMENT.md into DIR")
+    g.add_argument("--announcement", action="store_true", help="print the announcement draft, not the notes")
+    n.add_argument("--json", action="store_true", help="print the notes and both drafts as JSON")
+    return p
+
+
+def _load(path: Optional[Path]) -> _config.Config:
+    return _config.load(path if path is not None else _config.find(Path.cwd()))
+
+
+def _version(cfg: _config.Config, given: Optional[str]) -> str:
+    if given is None:
+        return _config.version(cfg)
+    if not _config.VERSION_RE.fullmatch(given):
+        raise _config.SetupError(f"version {given!r} is not X.Y.Z")
+    return given
+
+
+def _verify(cfg: _config.Config, args: argparse.Namespace) -> int:
+    from . import release
+    v = _version(cfg, args.version)
+    acc = None
+    if args.login:
+        from gitpro import forge
+        acc = forge.Account(forge.GITHUB, "gh", args.login)
+    wait = release.LATE_WAIT if args.wait is None else max(0.0, args.wait) * 60
+    release.TO_STDERR = args.json
+    try:
+        results = release.checks(cfg, acc, v, openvsx=True, wait=wait)
+    finally:
+        release.TO_STDERR = False
+    if args.json:
+        print(json.dumps({"version": v, "ok": all(g is not False for _, g in results),
+                          "checks": [{"check": t, "ok": g} for t, g in results]}, indent=2))
+        return 0 if all(g is not False for _, g in results) else 1
+    return 0 if release.show(results) else 1
+
+
+def _notes_cmd(cfg: _config.Config, args: argparse.Namespace) -> int:
+    v = _version(cfg, args.version)
+    if args.check:
+        _notes.section(cfg, v)
+        print(f"✓ {cfg.notes.changelog} has a section for {v}")
+        return 0
+    if args.write is not None:
+        for path in _notes.write(cfg, v, args.write):
+            print(f"✓ wrote {path}")
+        return 0
+    if args.json:
+        print(json.dumps({"version": v, "release_notes": _notes.release_notes(cfg, v),
+                          "short": _notes.short_text(cfg, v), "long": _notes.long_text(cfg, v)}, indent=2))
+        return 0
+    print(_notes.announcement(cfg, v) if args.announcement else _notes.release_notes(cfg, v), end="")
+    return 0
+
+
+def main(argv: Optional[List[str]] = None) -> int:
+    p = _parser()
+    args = p.parse_args(argv)
+    if args.command is None:
+        p.print_help()
+        return 2
+    try:
+        cfg = _load(args.config)
+        if args.command == "run":
+            from . import release
+            return release.run(cfg, args.login, args.yes, args.run)
+        if args.command == "verify":
+            return _verify(cfg, args)
+        if args.command == "version":
+            print(_config.version(cfg))
+            return 0
+        return _notes_cmd(cfg, args)
+    except _config.SetupError as e:
+        print(f"releasepro: {e}", file=sys.stderr)
+        return 2
+    except _notes.NotesError as e:
+        print(f"releasepro: {e}", file=sys.stderr)
+        return 1
+    except KeyboardInterrupt:
+        print("\nStopped.", file=sys.stderr)
+        return 130