diff --git a/README.md b/README.md index 7359d4e..7669663 100644 --- a/README.md +++ b/README.md @@ -21,9 +21,9 @@ Jira issues, failed jobs. For every service it reads the latest successful production deployment, walks the default branch down to that -commit, and writes a static site with one JSON report: a row per merge request or direct commit, newest first, with the tags that -point into it, the environments running it, the Jira keys its MR mentions, and the failed jobs of its main-branch -and tag pipelines. With a Jira token, it also reads the summary and status of every key in one batched search, +commit, or down to its first commit when the service was never deployed to production, and writes a static site with +one JSON report: a row per merge request or direct commit, newest first, with the tags that point into it, the +environments running it, the Jira keys its MR mentions, and the failed jobs of its main-branch and tag pipelines. With a Jira token, it also reads the summary and status of every key in one batched search, and the GitLab merge requests and commits linked to each issue. GitLab's Jira integration adds those links to the issue's Web links whenever a commit or MR mentions it; a link counts only if it starts with `RELEASE_SCOPE_GITLAB__ENDPOINT`. The projects they point to are the issue's related services. @@ -87,7 +87,8 @@ The report is versioned by `schema_version`; the models live in Top-level `jira` is `null` without a Jira token; otherwise it holds `issues` by key (summary, status, status category, issue type, linked GitLab changes), the `missing` keys Jira did not return, and an `error` if a Jira request failed. Each service lists its `candidates`: the tags a release could ship, newest first, each with its pipeline, the number of -rows it ships, the in-scope Jira keys of those rows, and the compare link from production. One row, trimmed: +rows it ships, the in-scope Jira keys of those rows, and the compare link from production, or the tag's commit history +when the service has no production deployment. One row, trimmed: ```json { @@ -107,14 +108,14 @@ Besides `report.json`, `collect` writes `index.html` and its script into the out installed package and change only with it, so the page always matches the report schema. The page loads `report.json` from next to itself; it needs a web server, not a `file://` URL. -**Services** lists every service with a production deployment, and every service that failed to collect, as one -line: what production runs, the picked tag, how many merge requests or commits and Jira tasks it ships, failed jobs +**Services** lists every service with a production deployment or with rows, and every service that failed to collect, +as one line: what production runs, the picked tag, how many merge requests or commits and Jira tasks it ships, failed jobs with the ones allowed to fail counted apart, and a mark when the range was cut at `RELEASE_SCOPE_MAX_COMMITS`. Opening a line shows the service's environments, warnings, merge requests that are not merged yet, and its rows with tags and their pipelines, merge requests or commits, Jira keys with their status, environments, and failed jobs; rows out of scope are dimmed. Links open in a new tab. Each tag has a **pick** button: picking it highlights the rows it ships and closes the line again. A `--jira` report starts with each service's -release tag picked. Services without a production deployment are left out of the page. +release tag picked. Services with neither a production deployment nor rows are left out of the page. The address keeps the picks after `#`, as `team/api=2.4.0&team/web=5.12.0`, so sharing or reloading the page keeps them. An address with picks replaces the release tags of a `--jira` report; picks that are not in the report, such as @@ -128,7 +129,8 @@ text box to copy from by hand, since browsers allow the copy button only over HT summary and a status badge: grey to do, blue in progress, green done. Copy them one per line or as a JQL `key in (...)` clause, each in its own box. - **Tag pipelines**: the pipeline of each picked tag, as a Markdown list. -- **Compare**: a GitLab compare link per service from production to the picked tag, as a Markdown list. +- **Compare**: a GitLab compare link per service from production to the picked tag, as a Markdown list. A service + never deployed to production gets the commit history of the tag instead. - **Release post**: one Markdown text with a line per picked tag, holding its compare link and pipeline, followed by the Jira tasks with their summaries. diff --git a/release_scope/_candidates.py b/release_scope/_candidates.py index 42fad2b..09d91ff 100644 --- a/release_scope/_candidates.py +++ b/release_scope/_candidates.py @@ -3,8 +3,10 @@ from release_scope._report import Candidate, EnvironmentState, Service -def build_candidates(service: Service, production: EnvironmentState) -> list[Candidate]: - base: str = quote(production.ref if production.tag else production.sha) +def build_candidates(service: Service, production: EnvironmentState | None) -> list[Candidate]: + base: str | None = None + if production is not None: + base = quote(production.ref if production.tag else production.sha) candidates: list[Candidate] = [] for index, row in enumerate(service.rows): shipped = service.rows[index:] @@ -12,7 +14,9 @@ def build_candidates(service: Service, production: EnvironmentState) -> list[Can candidates.extend( Candidate( tag=tag, - compare_url=f"{service.project_url}/-/compare/{base}...{quote(tag.name)}", + compare_url=f"{service.project_url}/-/compare/{base}...{quote(tag.name)}" + if base + else f"{service.project_url}/-/commits/{quote(tag.name)}", rows=len(shipped), jira_keys=list(keys.values()), ) diff --git a/release_scope/_static/index.html b/release_scope/_static/index.html index 7cfd044..e29f17a 100644 --- a/release_scope/_static/index.html +++ b/release_scope/_static/index.html @@ -93,7 +93,7 @@

Open a service and pick the tag to release: it ships every merge request and commit from its row down to production. The address keeps the picks, so share it to share them.

-