release-scope 0.1.0__tar.gz

release_scope-0.1.0/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: release-scope
+Version: 0.1.0
+Summary: Collect what sits between production and the default branch across GitLab services: tags, MRs, Jira keys, failed jobs
+Keywords: release,gitlab,jira,deployments,merge-requests,ci,cli,python
+Author: Artur Shiriev
+Author-email: Artur Shiriev <me@shiriev.ru>
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Free Threading :: 2 - Beta
+Classifier: Typing :: Typed
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Dist: typer>=0.13
+Requires-Dist: pydantic>=2 ; python_full_version < '3.12'
+Requires-Dist: pydantic>=2.0.2 ; python_full_version == '3.12.*'
+Requires-Dist: pydantic>=2.8.2 ; python_full_version == '3.13.*'
+Requires-Dist: pydantic>=2.12 ; python_full_version >= '3.14'
+Requires-Dist: pydantic-settings>=2
+Requires-Dist: modern-di-typer>=3,<4
+Requires-Dist: httpx2>=2
+Requires-Dist: httpware[pydantic]>=0.15.0
+Requires-Python: >=3.11, <4
+Project-URL: Homepage, https://modern-python.org
+Project-URL: Repository, https://github.com/modern-python/release-scope
+Project-URL: Issues, https://github.com/modern-python/release-scope/issues
+Project-URL: Changelog, https://github.com/modern-python/release-scope/releases
+Description-Content-Type: text/markdown
+
+[![PyPI version](https://img.shields.io/pypi/v/release-scope.svg)](https://pypi.org/project/release-scope/)
+[![Supported Python versions](https://img.shields.io/pypi/pyversions/release-scope.svg)](https://pypi.org/project/release-scope/)
+[![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen.svg)](https://github.com/modern-python/release-scope/actions/workflows/ci.yml)
+[![CI](https://github.com/modern-python/release-scope/actions/workflows/ci.yml/badge.svg)](https://github.com/modern-python/release-scope/actions/workflows/ci.yml)
+[![License](https://img.shields.io/github/license/modern-python/release-scope.svg)](https://github.com/modern-python/release-scope/blob/main/LICENSE)
+
+`release-scope` collects what sits between production and the default branch across GitLab services: tags, MRs,
+Jira keys, failed jobs.
+
+For every service it reads the latest successful production deployment, walks the default branch down to that
+commit, and writes 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.
+
+## Quickstart
+
+```sh
+export RELEASE_SCOPE_GITLAB__ENDPOINT=https://gitlab.example.com
+export RELEASE_SCOPE_GITLAB__TOKEN=glpat-...          # read_api scope
+export RELEASE_SCOPE_ENVIRONMENTS='["prod", "preview"]'
+export RELEASE_SCOPE_PRODUCTION_ENVIRONMENT=prod
+
+uvx release-scope collect --group team/backend --output report.json --cache cache.json
+```
+
+`--group` and `--project` are repeatable and can be mixed. The command exits `1` when any service failed to
+collect; the report is still written and names the error on that service.
+
+## Configuration
+
+Every setting is an environment variable; nothing about a GitLab or Jira instance is built in.
+
+| Variable | Default | Meaning |
+|---|---|---|
+| `RELEASE_SCOPE_GITLAB__ENDPOINT` | `https://gitlab.com` | GitLab base URL |
+| `RELEASE_SCOPE_GITLAB__TOKEN` or `GITLAB_TOKEN` | required | Token with `read_api` |
+| `RELEASE_SCOPE_ENVIRONMENTS` | `["production"]` | Environments shown per service, as a JSON list |
+| `RELEASE_SCOPE_PRODUCTION_ENVIRONMENT` | `production` | Environment whose deployed commit starts the range |
+| `RELEASE_SCOPE_JIRA_ENDPOINT` | unset | When set, Jira keys link to `<endpoint>/browse/<KEY>` |
+| `RELEASE_SCOPE_JIRA_PROJECT_KEYS` | `[]` | Keep only keys of these Jira projects; empty keeps all |
+| `RELEASE_SCOPE_MAX_COMMITS` | `1000` | Stop walking a service's range after this many commits |
+| `RELEASE_SCOPE_REQUEST_TIMEOUT` | `10` | Per-request timeout in seconds |
+
+## Report
+
+The report is versioned by `schema_version`; the models live in
+[`release_scope/_report.py`](https://github.com/modern-python/release-scope/blob/main/release_scope/_report.py).
+One row, trimmed:
+
+```json
+{
+  "kind": "merge_request",
+  "tags": [{"name": "1.2.0", "url": "...", "pipeline": {"id": 201, "status": "success", "failed_jobs": []}}],
+  "merge_requests": [{"iid": 12, "title": "SHOP-12 new endpoint", "url": "..."}],
+  "commits": [{"sha": "c3...", "title": "Merge branch 'feature/SHOP-12'"}],
+  "jira_keys": [{"key": "SHOP-12", "url": "https://jira.example.com/browse/SHOP-12"}],
+  "environments": ["preview"],
+  "main_pipeline": {"id": 103, "status": "failed", "failed_jobs": [{"kind": "job", "name": "lint", "allow_failure": false}]}
+}
+```
+
+## Cache
+
+`--cache` names a JSON file that is read if present and rewritten atomically after the run. It holds only facts
+that do not change once settled: which merge requests a commit belongs to, and the failed jobs of a finished
+pipeline keyed by its `updated_at`, so a retried job invalidates the entry. Entries the run did not use are
+dropped. A missing, corrupt, or older-schema cache is ignored with a warning; the cache only saves requests and
+never changes the report.

release_scope-0.1.0/README.md

@@ -0,0 +1,68 @@
+[![PyPI version](https://img.shields.io/pypi/v/release-scope.svg)](https://pypi.org/project/release-scope/)
+[![Supported Python versions](https://img.shields.io/pypi/pyversions/release-scope.svg)](https://pypi.org/project/release-scope/)
+[![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen.svg)](https://github.com/modern-python/release-scope/actions/workflows/ci.yml)
+[![CI](https://github.com/modern-python/release-scope/actions/workflows/ci.yml/badge.svg)](https://github.com/modern-python/release-scope/actions/workflows/ci.yml)
+[![License](https://img.shields.io/github/license/modern-python/release-scope.svg)](https://github.com/modern-python/release-scope/blob/main/LICENSE)
+
+`release-scope` collects what sits between production and the default branch across GitLab services: tags, MRs,
+Jira keys, failed jobs.
+
+For every service it reads the latest successful production deployment, walks the default branch down to that
+commit, and writes 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.
+
+## Quickstart
+
+```sh
+export RELEASE_SCOPE_GITLAB__ENDPOINT=https://gitlab.example.com
+export RELEASE_SCOPE_GITLAB__TOKEN=glpat-...          # read_api scope
+export RELEASE_SCOPE_ENVIRONMENTS='["prod", "preview"]'
+export RELEASE_SCOPE_PRODUCTION_ENVIRONMENT=prod
+
+uvx release-scope collect --group team/backend --output report.json --cache cache.json
+```
+
+`--group` and `--project` are repeatable and can be mixed. The command exits `1` when any service failed to
+collect; the report is still written and names the error on that service.
+
+## Configuration
+
+Every setting is an environment variable; nothing about a GitLab or Jira instance is built in.
+
+| Variable | Default | Meaning |
+|---|---|---|
+| `RELEASE_SCOPE_GITLAB__ENDPOINT` | `https://gitlab.com` | GitLab base URL |
+| `RELEASE_SCOPE_GITLAB__TOKEN` or `GITLAB_TOKEN` | required | Token with `read_api` |
+| `RELEASE_SCOPE_ENVIRONMENTS` | `["production"]` | Environments shown per service, as a JSON list |
+| `RELEASE_SCOPE_PRODUCTION_ENVIRONMENT` | `production` | Environment whose deployed commit starts the range |
+| `RELEASE_SCOPE_JIRA_ENDPOINT` | unset | When set, Jira keys link to `<endpoint>/browse/<KEY>` |
+| `RELEASE_SCOPE_JIRA_PROJECT_KEYS` | `[]` | Keep only keys of these Jira projects; empty keeps all |
+| `RELEASE_SCOPE_MAX_COMMITS` | `1000` | Stop walking a service's range after this many commits |
+| `RELEASE_SCOPE_REQUEST_TIMEOUT` | `10` | Per-request timeout in seconds |
+
+## Report
+
+The report is versioned by `schema_version`; the models live in
+[`release_scope/_report.py`](https://github.com/modern-python/release-scope/blob/main/release_scope/_report.py).
+One row, trimmed:
+
+```json
+{
+  "kind": "merge_request",
+  "tags": [{"name": "1.2.0", "url": "...", "pipeline": {"id": 201, "status": "success", "failed_jobs": []}}],
+  "merge_requests": [{"iid": 12, "title": "SHOP-12 new endpoint", "url": "..."}],
+  "commits": [{"sha": "c3...", "title": "Merge branch 'feature/SHOP-12'"}],
+  "jira_keys": [{"key": "SHOP-12", "url": "https://jira.example.com/browse/SHOP-12"}],
+  "environments": ["preview"],
+  "main_pipeline": {"id": 103, "status": "failed", "failed_jobs": [{"kind": "job", "name": "lint", "allow_failure": false}]}
+}
+```
+
+## Cache
+
+`--cache` names a JSON file that is read if present and rewritten atomically after the run. It holds only facts
+that do not change once settled: which merge requests a commit belongs to, and the failed jobs of a finished
+pipeline keyed by its `updated_at`, so a retried job invalidates the entry. Entries the run did not use are
+dropped. A missing, corrupt, or older-schema cache is ignored with a warning; the cache only saves requests and
+never changes the report.

release_scope-0.1.0/pyproject.toml

@@ -0,0 +1,118 @@
+[project]
+name = "release-scope"
+description = "Collect what sits between production and the default branch across GitLab services: tags, MRs, Jira keys, failed jobs"
+requires-python = ">=3.11,<4"
+license = "MIT"
+readme = "README.md"
+keywords = [
+    "release",
+    "gitlab",
+    "jira",
+    "deployments",
+    "merge-requests",
+    "ci",
+    "cli",
+    "python",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: Free Threading :: 2 - Beta",
+    "Typing :: Typed",
+    "Topic :: Software Development :: Build Tools",
+]
+version = "0.1.0"
+dependencies = [
+    "typer>=0.13",
+    "pydantic>=2; python_version < '3.12'",
+    "pydantic>=2.0.2; python_version == '3.12'",
+    "pydantic>=2.8.2; python_version == '3.13'",
+    "pydantic>=2.12; python_version >= '3.14'",
+    "pydantic-settings>=2",
+    "modern-di-typer>=3,<4",
+    "httpx2>=2",
+    "httpware[pydantic]>=0.15.0",
+]
+
+[[project.authors]]
+name = "Artur Shiriev"
+email = "me@shiriev.ru"
+
+[project.scripts]
+release-scope = "release_scope.__main__:main"
+
+[project.urls]
+Homepage = "https://modern-python.org"
+Repository = "https://github.com/modern-python/release-scope"
+Issues = "https://github.com/modern-python/release-scope/issues"
+Changelog = "https://github.com/modern-python/release-scope/releases"
+
+[build-system]
+requires = ["uv_build>=0.11,<1"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "release_scope"
+module-root = ""
+
+[tool.ruff]
+fix = true
+unsafe-fixes = true
+line-length = 120
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "D1",
+    "D203",
+    "D213",
+    "COM812",
+    "ISC001",
+    "CPY001",
+    "FBT",
+    "TCH",
+    "S105",
+]
+
+[tool.ruff.lint.isort]
+lines-after-imports = 2
+no-lines-before = [
+    "standard-library",
+    "local-folder",
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = [
+    "S101",
+    "PLR2004",
+]
+
+[tool.pytest.ini_options]
+addopts = ""
+testpaths = ["tests"]
+markers = ["httpx2: configure the httpx2_mock fixture"]
+
+[tool.coverage.report]
+fail_under = 100
+exclude_also = ["if typing.TYPE_CHECKING:"]
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "pytest-cov>=5",
+    "pytest-xdist>=3",
+    "pytest-randomly>=3",
+    "pytest-httpx2>=1",
+    "respx>=0.23.1",
+    "httpx>=0.28.1",
+    "httpcore2>=2",
+]
+lint = [
+    "ruff",
+    "ty",
+    "eof-fixer",
+]

release_scope-0.1.0/pyproject.toml.orig

@@ -0,0 +1,105 @@
+[project]
+name = "release-scope"
+description = "Collect what sits between production and the default branch across GitLab services: tags, MRs, Jira keys, failed jobs"
+authors = [{ name = "Artur Shiriev", email = "me@shiriev.ru" }]
+requires-python = ">=3.11,<4"
+license = "MIT"
+readme = "README.md"
+keywords = ["release", "gitlab", "jira", "deployments", "merge-requests", "ci", "cli", "python"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: Free Threading :: 2 - Beta",
+    "Typing :: Typed",
+    "Topic :: Software Development :: Build Tools",
+]
+version = "0.1.0"
+dependencies = [
+    "typer>=0.13",
+    # The first release whose pydantic-core ships a wheel for each interpreter.
+    "pydantic>=2; python_version < '3.12'",
+    "pydantic>=2.0.2; python_version == '3.12'",
+    "pydantic>=2.8.2; python_version == '3.13'",
+    "pydantic>=2.12; python_version >= '3.14'",
+    "pydantic-settings>=2",
+    "modern-di-typer>=3,<4",
+    "httpx2>=2",
+    "httpware[pydantic]>=0.15.0",
+]
+
+[project.scripts]
+release-scope = "release_scope.__main__:main"
+
+[project.urls]
+Homepage = "https://modern-python.org"
+Repository = "https://github.com/modern-python/release-scope"
+Issues = "https://github.com/modern-python/release-scope/issues"
+Changelog = "https://github.com/modern-python/release-scope/releases"
+
+[build-system]
+requires = ["uv_build>=0.11,<1"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "release_scope"
+module-root = ""
+
+[dependency-groups]
+dev = [
+    "pytest>=8",
+    "pytest-cov>=5",
+    "pytest-xdist>=3",
+    "pytest-randomly>=3",
+    "pytest-httpx2>=1",
+    "respx>=0.23.1",
+    "httpx>=0.28.1",
+    "httpcore2>=2",
+]
+lint = [
+    "ruff",
+    "ty",
+    "eof-fixer",
+]
+
+[tool.ruff]
+fix = true
+unsafe-fixes = true
+line-length = 120
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "D1",     # docstrings are not forced; a docstring exists when it says something
+    "D203",   # conflicts with D211
+    "D213",   # conflicts with D212
+    "COM812", # conflicts with the formatter
+    "ISC001", # conflicts with the formatter
+    "CPY001", # no per-file copyright header
+    "FBT",    # boolean positional arguments are fine
+    "TCH",    # imports stay real; TYPE_CHECKING-only imports break runtime introspection
+    "S105",   # token names in env-var constants and test fixtures, not secrets
+]
+isort.lines-after-imports = 2
+isort.no-lines-before = ["standard-library", "local-folder"]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/**" = [
+    "S101",    # assert is the test idiom; in library code it is a finding
+    "PLR2004", # expected ids and exit codes read clearer inline than as named constants
+]
+
+[tool.pytest.ini_options]
+addopts = ""
+testpaths = ["tests"]
+# pytest-httpx2 defines this marker in a hook its package never exports, so pytest does not see it.
+markers = ["httpx2: configure the httpx2_mock fixture"]
+
+[tool.coverage.report]
+fail_under = 100
+exclude_also = [
+    "if typing.TYPE_CHECKING:",
+]

release_scope-0.1.0/release_scope/__main__.py

@@ -0,0 +1,105 @@
+import importlib.metadata
+import pathlib
+import typing
+
+import modern_di_typer
+import typer
+
+from release_scope import ioc
+from release_scope._cache import Cache
+from release_scope._errors import ConfigError, ReleaseScopeError
+from release_scope._files import write_text_atomic
+from release_scope._settings import Settings, load_settings
+from release_scope._use_case import CollectUseCase
+
+
+_PACKAGE_NAME: typing.Final = "release-scope"
+
+
+MAIN_APP: typing.Final = typer.Typer(
+    name="release-scope",
+    help="Collect what sits between production and the default branch across GitLab services.",
+    no_args_is_help=True,
+    add_completion=False,
+)
+
+modern_di_typer.setup_di(MAIN_APP, ioc.container)
+
+
+def _version_callback(value: bool) -> None:
+    if not value:
+        return
+    typer.echo(importlib.metadata.version(_PACKAGE_NAME))
+    raise typer.Exit
+
+
+@MAIN_APP.callback()
+def _main_callback(
+    _version: typing.Annotated[
+        bool | None,
+        typer.Option("--version", callback=_version_callback, is_eager=True, help="Show version and exit."),
+    ] = None,
+) -> None:
+    pass
+
+
+@modern_di_typer.inject
+def _resolve_use_case(
+    use_case: typing.Annotated[CollectUseCase, modern_di_typer.FromDI(CollectUseCase)],
+) -> CollectUseCase:
+    return use_case
+
+
+@MAIN_APP.command("collect", help="Collect pending changes per service into a JSON report.")
+def _collect_command(  # noqa: PLR0913, PLR0917
+    ctx: typer.Context,
+    output: typing.Annotated[pathlib.Path, typer.Option("--output", "-o", help="Where to write the report JSON.")],
+    group: typing.Annotated[
+        list[str] | None, typer.Option("--group", "-g", help="GitLab group path; repeatable.")
+    ] = None,
+    project: typing.Annotated[
+        list[str] | None, typer.Option("--project", "-p", help="GitLab project path; repeatable.")
+    ] = None,
+    include_subgroups: typing.Annotated[
+        bool, typer.Option("--include-subgroups", help="Also collect projects in subgroups of each --group.")
+    ] = False,
+    cache_path: typing.Annotated[
+        pathlib.Path | None,
+        typer.Option("--cache", help="Cache JSON; read if present, rewritten in place after the run."),
+    ] = None,
+) -> None:
+    try:
+        if not group and not project:
+            msg = "Pass at least one --group or --project."
+            raise ConfigError(msg)
+        settings = load_settings({})
+        modern_di_typer.fetch_di_container(ctx).set_context(Settings, settings)
+        cache, cache_warning = Cache.load(cache_path) if cache_path else (Cache(), None)
+        if cache_warning:
+            typer.echo(f"Warning: {cache_warning}", err=True)
+        report = _resolve_use_case(ctx=ctx)(
+            groups=group or [], projects=project or [], include_subgroups=include_subgroups, cache=cache
+        )
+    except ReleaseScopeError as err:
+        typer.echo(f"Error: {err}", err=True)
+        raise typer.Exit(code=err.exit_code) from err
+
+    write_text_atomic(output, report.model_dump_json(indent=2))
+    if cache_path:
+        cache.save(cache_path)
+    failed: typing.Final = [service for service in report.services if service.error]
+    rows: typing.Final = sum(len(service.rows) for service in report.services)
+    typer.echo(f"{len(report.services)} services, {rows} rows, {len(failed)} failed -> {output}", err=True)
+    for service in failed:
+        typer.echo(f"Error: {service.project}: {service.error}", err=True)
+    if failed:
+        raise typer.Exit(code=1)
+
+
+def main() -> None:
+    with ioc.container:
+        MAIN_APP()
+
+
+if __name__ == "__main__":
+    main()

release_scope-0.1.0/release_scope/_cache.py

@@ -0,0 +1,71 @@
+import dataclasses
+import pathlib
+import typing
+
+import pydantic
+
+from release_scope._files import write_text_atomic
+from release_scope._gitlab import MergeRequest
+from release_scope._report import FailedJob
+
+
+CACHE_SCHEMA_VERSION: typing.Final = 1
+
+
+class CachedPipeline(pydantic.BaseModel):
+    updated_at: str
+    failed_jobs: list[FailedJob]
+
+
+class CacheData(pydantic.BaseModel):
+    schema_version: typing.Literal[1] = CACHE_SCHEMA_VERSION
+    commit_merge_requests: dict[str, dict[str, list[MergeRequest]]] = pydantic.Field(default_factory=dict)
+    pipelines: dict[str, dict[str, CachedPipeline]] = pydantic.Field(default_factory=dict)
+
+
+@dataclasses.dataclass(slots=True, kw_only=True)
+class Cache:
+    previous: CacheData = dataclasses.field(default_factory=CacheData)
+    current: CacheData = dataclasses.field(default_factory=CacheData)
+
+    @classmethod
+    def load(cls, path: pathlib.Path) -> tuple["Cache", str | None]:
+        if not path.exists():
+            return cls(), None
+        try:
+            return cls(previous=CacheData.model_validate_json(path.read_bytes())), None
+        except (OSError, pydantic.ValidationError) as exc:
+            return cls(), f"Ignoring unreadable cache {path}: {type(exc).__name__}."
+
+    def save(self, path: pathlib.Path) -> None:
+        write_text_atomic(path, self.current.model_dump_json(indent=2))
+
+    def get_commit_merge_requests(self, project_id: int, sha: str) -> list[MergeRequest] | None:
+        cached = self.previous.commit_merge_requests.get(str(project_id), {}).get(sha)
+        if cached is not None:
+            self.put_commit_merge_requests(project_id, sha, cached)
+        return cached
+
+    def put_commit_merge_requests(self, project_id: int, sha: str, merge_requests: list[MergeRequest]) -> None:
+        self.current.commit_merge_requests.setdefault(str(project_id), {})[sha] = merge_requests
+
+    def get_failed_jobs(self, project_id: int, pipeline_id: int, updated_at: str) -> list[FailedJob] | None:
+        cached = self.previous.pipelines.get(str(project_id), {}).get(str(pipeline_id))
+        if cached is None or cached.updated_at != updated_at:
+            return None
+        self.put_failed_jobs(project_id, pipeline_id, cached)
+        return cached.failed_jobs
+
+    def put_failed_jobs(self, project_id: int, pipeline_id: int, entry: CachedPipeline) -> None:
+        self.current.pipelines.setdefault(str(project_id), {})[str(pipeline_id)] = entry
+
+    def keep_project(self, project_id: int) -> None:
+        key: typing.Final = str(project_id)
+        self.current.commit_merge_requests[key] = {
+            **self.previous.commit_merge_requests.get(key, {}),
+            **self.current.commit_merge_requests.get(key, {}),
+        }
+        self.current.pipelines[key] = {
+            **self.previous.pipelines.get(key, {}),
+            **self.current.pipelines.get(key, {}),
+        }

release_scope-0.1.0/release_scope/_errors.py

@@ -0,0 +1,17 @@
+import typing
+
+
+class ReleaseScopeError(Exception):
+    exit_code: typing.ClassVar[int] = 1
+
+
+class ConfigError(ReleaseScopeError):
+    exit_code: typing.ClassVar[int] = 2
+
+
+class AuthError(ReleaseScopeError):
+    exit_code: typing.ClassVar[int] = 3
+
+
+class GitLabError(ReleaseScopeError):
+    exit_code: typing.ClassVar[int] = 4

release_scope-0.1.0/release_scope/_files.py

@@ -0,0 +1,14 @@
+import os
+import pathlib
+import tempfile
+
+
+def write_text_atomic(path: pathlib.Path, text: str) -> None:
+    path.parent.mkdir(parents=True, exist_ok=True)
+    with tempfile.NamedTemporaryFile(
+        "w", encoding="utf-8", dir=path.parent, prefix=f".{path.name}.", suffix=".tmp", delete=False
+    ) as handle:
+        handle.write(text)
+        handle.flush()
+        os.fsync(handle.fileno())
+    pathlib.Path(handle.name).replace(path)