diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml new file mode 100644 index 0000000..a793792 --- /dev/null +++ b/.github/workflows/pages.yml @@ -0,0 +1,60 @@ +name: docs + +on: + pull_request: + push: + # branches: + # - main + workflow_dispatch: + +permissions: + contents: read + pages: write + id-token: write + +concurrency: + group: docs-${{ github.ref }} + cancel-in-progress: true + +jobs: + build: + runs-on: ubuntu-latest + + steps: + - name: Check out repository + uses: actions/checkout@v4 + + - name: Set up Python + uses: actions/setup-python@v5 + with: + python-version: "3.12" + + - name: Set up uv + uses: astral-sh/setup-uv@v5 + with: + enable-cache: true + + - name: Configure GitHub Pages + uses: actions/configure-pages@v5 + + - name: Sync documentation toolchain + run: uv sync --frozen + + - name: Build MkDocs site + run: uv run mkdocs build --strict + + - name: Upload Pages artifact + # if: github.ref == 'refs/heads/main' + uses: actions/upload-pages-artifact@v3 + with: + path: site + + deploy: + # if: github.ref == 'refs/heads/main' + needs: build + runs-on: ubuntu-latest + + steps: + - name: Deploy to GitHub Pages + id: deployment + uses: actions/deploy-pages@v4 \ No newline at end of file diff --git a/.github/workflows/pr.yml b/.github/workflows/pr.yml new file mode 100644 index 0000000..0817243 --- /dev/null +++ b/.github/workflows/pr.yml @@ -0,0 +1,32 @@ +# ******************************************************************************* +# Copyright (c) 2025 Contributors to the Eclipse Foundation +# +# See the NOTICE file(s) distributed with this work for additional +# information regarding copyright ownership. +# +# This program and the accompanying materials are made available under the +# terms of the Apache License Version 2.0 which is available at +# https://www.apache.org/licenses/LICENSE-2.0 +# +# SPDX-License-Identifier: Apache-2.0 +# ******************************************************************************* + +name: Pull Request Workflow +on: + pull_request: + types: [opened, reopened, synchronize] + +jobs: + + self_test: + name: 🔬 Self Test + runs-on: ubuntu-latest + steps: + - name: 📥 Check out + uses: actions/checkout@v6 + + - name: ⚙️ Setup uv + uses: astral-sh/setup-uv@v7 + + - name: 🛠️ Run pre-commit + run: uv run pre-commit run --all-files diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..6c5aca0 --- /dev/null +++ b/.gitignore @@ -0,0 +1,3 @@ +.venv/ +site/ +__pycache__/ \ No newline at end of file diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml new file mode 100644 index 0000000..235def0 --- /dev/null +++ b/.pre-commit-config.yaml @@ -0,0 +1,9 @@ +repos: + - repo: local + hooks: + - id: aggregate-status + name: Aggregate chapter statuses + entry: python scripts/aggregate_status.py + language: python + pass_filenames: false + files: ^(docs/chapters/.*\.md|docs/index\.md|scripts/aggregate_status\.py)$ \ No newline at end of file diff --git a/README.md b/README.md index 22a7505..615a234 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,28 @@ -# infrastructure -All general information related to the development and integration infrastructure +# S-CORE Infrastructure Documentation + +This repository contains the sources for the S-CORE infrastructure documentation. + +The published documentation is available at: + +- https://eclipse-score.github.io/infrastructure/ + +## How The Site Is Structured + +The README intentionally stays short to avoid duplicating the actual documentation. Use the published site for content and this repository for source files, local preview, and contribution work. + +## Run MkDocs Locally + +This repository uses `uv` for local toolchain management. + +Install dependencies and start a live preview: + +```bash +uv sync +uv run mkdocs serve +``` + +Build the site with strict checks: + +```bash +uv run mkdocs build --strict +``` diff --git a/docs/chapters/01-source-code-infrastructure.md b/docs/chapters/01-source-code-infrastructure.md new file mode 100644 index 0000000..7ecb901 --- /dev/null +++ b/docs/chapters/01-source-code-infrastructure.md @@ -0,0 +1,89 @@ +# 1 Source Code Infrastructure 🟡 + +*Infrastructure for hosting and organizing source code consistently across the S-CORE repository landscape.* + +**S-CORE** + +- GitHub is the canonical source-code hosting platform for S-CORE repositories. +- Lifecycle and policy management are intended to be centrally defined and automation-driven. +- Standards should be versioned, measurable, and continuously synchronized across repositories. +- Hosting is established and operational; lifecycle and standards synchronization are only partially mature. +- **Biggest gap**: cross-repository consistency of policy and standards is not yet reliably enforced and measured. + +## 1.0 Hosting 🟢 + +*Provide a stable, discoverable, and scalable hosting foundation for all S-CORE repositories.* + +**S-CORE** + +- Repositories are hosted in GitHub aligned with Eclipse governance on https://github.com/eclipse-score + + +## 1.1 Repository Lifecycle Management 🟠 + +*Infrastructure for repositories and repository configuration.* + +### 1.1.1 Repository Provisioning & Lifecycle 🟡 + +*Infrastructure for creating, initializing, updating, and archiving repositories and executing lifecycle operations.* + +**S-CORE** + +- Desired repository state is defined centrally via the infrastructure-as-code tool [otterdog](https://otterdog.readthedocs.io/en/latest/userguide/) in the [S-CORE configuration file](https://github.com/eclipse-score/.eclipsefdn/blob/main/otterdog/eclipse-score.jsonnet) +- Lifecycle transitions are configuration changes instead of manual one-off actions. +- **Biggest gap**: approval of changes is rather random and undefined. + +### 1.1.2 Repository Policy Management 🔴 + +*Infrastructure for managing and synchronizing repository policies such as branch protection, and application thereof at scale.* + +**S-CORE** + +- Policy intent (for example branch protection and required checks) is expressed centrally via the infrastructure-as-code tool [otterdog](https://otterdog.readthedocs.io/en/latest/userguide/) in the [S-CORE configuration file](https://github.com/eclipse-score/.eclipsefdn/blob/main/otterdog/eclipse-score.jsonnet) +- Exceptions are explicit, reviewed, and documented. +- **Biggest gap**: policies are not yet uniformly applied to all repositories. + +--- + +## 1.2 Repository Standards 🟡 + +*Define standard elements expected across repositories to reduce unnecessary variation.* + +**S-CORE** + +- Standards are centrally defined and versioned. +- Repositories adopt standards directly or through synchronized templates/configuration. +- **Biggest gap**: consistency of adoption and conformance visibility remains limited. + +### 1.2.1 Repository Metadata 🟡 + +*Define standard project metadata such as LICENSE, README, and governance files.* + +**S-CORE** + +- Metadata expectations exist, but rollout and conformance visibility are not yet complete. +- Automated cross-repository conformance reporting is not yet in place. +- **Biggest gap**: no continuous cross-repository visibility of metadata conformance. + +### 1.2.2 Tooling Configuration Standards 🟠 + +*Define shared configuration for linters and development tools.* + +**S-CORE** + +- Shared conventions are emerging, but not yet uniformly synchronized; [chapter 4](04-static-analysis-infrastructure.md) is the canonical home for static-analysis tooling and rule-baseline details. +- Baseline/override handling is not yet consistently defined across repository types. +- **Biggest gap**: no clearly enforced baseline/override model across repository classes. + +--- + +## 1.3 Synchronization of Standards 🔴 + +*Keep repositories aligned with evolving standards through shared templates and configuration synchronization.* + +**S-CORE** + +- Automation applies and reconciles standards from central definitions. +- Adoption and drift are tracked to prioritize migration work. +- Cross-repository synchronization is a target capability and remains incomplete. +- **Biggest gap**: drift metrics/reporting and migration playbooks are not yet consistently operationalized. diff --git a/docs/chapters/02-build-infrastructure.md b/docs/chapters/02-build-infrastructure.md new file mode 100644 index 0000000..6e0c1cb --- /dev/null +++ b/docs/chapters/02-build-infrastructure.md @@ -0,0 +1,202 @@ +# 2 Build Infrastructure (Bazel) ⚪ + +*Deterministic, reproducible builds across S-CORE repositories using Bazel as the shared build system.* + +⚠️ This chapter is written by ChatGPT and was not yet reviewed + +**S-CORE** + +- Bazel is the standard build system for S-CORE middleware repositories. +- Shared build rules and toolchain definitions are intended to reduce per-repository configuration duplication. +- Remote caching is available to reduce repeated build work across CI pipelines. +- **Biggest gap**: shared build rule libraries, toolchain baselines, and remote execution are not yet consistently available across all S-CORE repositories. + +## 2.1 Build System ⚪ + +*Core build tooling and workspace conventions shared across S-CORE repositories.* + +**S-CORE** + +- Bazel workspaces are the standard unit of build organization across S-CORE middleware repositories. +- Shared Bazel rules are provided via the [eclipse-score/tooling](https://github.com/eclipse-score/tooling) repository. +- **Biggest gap**: workspace structure conventions and target naming standards are not formally defined or enforced cross-repository. + +### 2.1.1 Project Structure + +*Standard organization of Bazel workspaces across S-CORE repositories.* + +**S-CORE** + +- Repository layout conventions emerge from shared rule usage but are not yet formally standardized. +- **Biggest gap**: no centrally enforced or documented reference workspace structure exists. + +### 2.1.2 Build Rule Libraries + +*Reusable Bazel rules and macros shared across S-CORE repositories.* + +**S-CORE** + +- Shared Bazel macros and rules are provided via [eclipse-score/tooling](https://github.com/eclipse-score/tooling). +- **Biggest gap**: rule coverage is incomplete; not all repository types have suitable shared rules. + +### 2.1.3 Build Conventions + +*Shared target naming and repository layout conventions.* + +**S-CORE** + +- Naming and layout conventions are expected from shared rule usage but not yet formally documented. +- **Biggest gap**: no cross-repository convention enforcement mechanism exists. + +--- + +## 2.2 Dependency Management ⚪ + +*Managing external and internal dependencies in a consistent, auditable way across S-CORE repositories.* + +**S-CORE** + +- External dependencies are declared per repository in Bazel workspace files; pinning strategies vary. +- **Biggest gap**: no unified dependency policy or cross-repository version alignment standard exists. + +### 2.2.1 Third-Party Dependencies + +*Integration and management of external libraries via Bazel.* + +**S-CORE** + +- External libraries are imported via Bazel's `http_archive` or Bzlmod; no shared registry or approved source list exists. +- **Biggest gap**: duplicate declarations and version drift across repositories are unmitigated. + +### 2.2.2 Internal Module Dependencies + +*Managing build-time dependencies between S-CORE repositories.* + +**S-CORE** + +- Cross-repository artifact consumption relies on pre-built releases or per-repository Bazel rules. +- **Biggest gap**: no consistent cross-repository dependency resolution model is defined. + +### 2.2.3 Dependency Policies + +*Rules governing allowed dependencies across S-CORE.* + +**S-CORE** + +- No formal cross-repository dependency policy currently exists. +- **Biggest gap**: dependency choices are inconsistent and unaudited without policy guardrails. + +--- + +## 2.3 Toolchain Management ⚪ + +*Compiler and runtime toolchain configuration for C++, Rust, and Python across S-CORE builds.* + +**S-CORE** + +- Toolchains are provisioned via the devcontainer for both local and CI builds. +- **Biggest gap**: toolchain versions diverge across repositories without a shared baseline definition. + +### 2.3.1 C++ Toolchains + +*Compiler and build configuration for C++ components.* + +**S-CORE** + +- C++ toolchain configuration is provided through the devcontainer and per-repository Bazel setup. +- **Biggest gap**: no shared toolchain version target is enforced across S-CORE repositories. + +### 2.3.2 Rust Toolchains + +*Toolchain configuration for Rust components.* + +**S-CORE** + +- Rust toolchain rules exist in some repositories; no shared configuration is mandated. +- **Biggest gap**: no standard Rust toolchain version or `rules_rust` configuration is shared across S-CORE. + +### 2.3.3 Python Toolchains + +*Python runtime and tooling configuration for build and test.* + +**S-CORE** + +- Python toolchains vary per repository; no shared Python version baseline is defined. +- **Biggest gap**: no cross-repository Python toolchain standard is enforced. + +--- + +## 2.4 Build Reproducibility ⚪ + +*Ensuring builds are deterministic and produce identical outputs from the same inputs.* + +**S-CORE** + +- Bazel's hermetic execution model is the foundation for reproducibility across S-CORE. +- **Biggest gap**: hermetic build compliance is not measured or enforced uniformly across repositories. + +### 2.4.1 Hermetic Builds + +*Isolating builds from host environments to ensure reproducibility.* + +**S-CORE** + +- The devcontainer provides a stable, isolated build environment for CI and local builds. +- **Biggest gap**: full hermetic compliance (no host toolchain leakage) is not uniformly verified. + +### 2.4.2 Deterministic Artifacts + +*Ensuring builds produce identical artifacts from the same inputs.* + +**S-CORE** + +- Bazel's action graph model is designed for determinism; actual reproducibility is not validated at scale. +- **Biggest gap**: no cross-repository determinism validation pipeline exists. + +### 2.4.3 Build Traceability + +*Tracking build inputs, outputs, and provenance metadata.* + +**S-CORE** + +- Build provenance (SLSA) and input tracking are target capabilities. +- **Biggest gap**: no build provenance pipeline currently produces or publishes provenance metadata. + +--- + +## 2.5 Build Execution Infrastructure ⚪ + +*Infrastructure for executing Bazel builds efficiently across CI pipelines.* + +**S-CORE** + +- Builds run on GitHub Actions using GitHub-hosted and self-hosted runners. +- A shared Bazel remote cache reduces redundant compile work across pipeline runs. +- **Biggest gap**: remote build execution (RBE) is not yet available for S-CORE CI pipelines. + +### 2.5.1 Remote Cache + +*Sharing Bazel build outputs between pipeline runs to reduce rebuild time.* + +**S-CORE** + +- A shared Bazel remote cache is available to S-CORE CI pipelines. +- **Biggest gap**: remote cache connectivity and configuration are not uniformly set up across all repositories. + +### 2.5.2 Remote Build Execution + +*Executing Bazel build actions on remote compute resources.* + +**S-CORE** + +- RBE infrastructure is not currently provisioned for S-CORE. +- **Biggest gap**: no RBE backend is available; builds are constrained to single-runner execution. + +### 2.5.3 Build Resource Scheduling + +*Scheduling and allocating compute resources for build workloads.* + +**S-CORE** + +- CI runner allocation is handled via GitHub-hosted and self-hosted runner scheduling. +- **Biggest gap**: no build-aware resource scheduling or prioritization mechanism is in place. diff --git a/docs/chapters/03-testing-infrastructure.md b/docs/chapters/03-testing-infrastructure.md new file mode 100644 index 0000000..b89c905 --- /dev/null +++ b/docs/chapters/03-testing-infrastructure.md @@ -0,0 +1,216 @@ +# 3 Testing Infrastructure ⚪ + +*Infrastructure supporting automated testing across S-CORE repositories, excluding CI/CD execution.* + +⚠️ This chapter is partially written by ChatGPT and was not yet reviewed + +**S-CORE** + +- The verification process defines the expected test levels and evidence. +- This chapter focuses on the implementation view: what exists, where it lives, and what is still missing. +- Tests are executed via Bazel test rules, providing isolation and incremental caching of build targets. +- Multi-language test support exists across C++, Rust, and Python, but repository-level conventions still vary. +- S-CORE distinguishes test levels such as unit tests, component integration tests, feature integration tests, and platform tests. +- `reference_integration` already provides shared integration-oriented execution and release-level aggregation for parts of the platform. +- **Biggest gap**: testing infrastructure exists in several strong islands, but platform-wide standardization for aggregation, dashboards, and reusable conventions is still incomplete. + +## 3.1 Test Levels ⚪ + +*Test levels used by the S-CORE verification process and supported by testing infrastructure, from unit scope to platform verification.* + +**S-CORE** + +- Four test levels are used across S-CORE: unit tests, component integration tests, feature integration tests, and platform tests. +- Lower levels are mainly implemented in module repositories. +- Higher integration levels increasingly rely on `reference_integration`. +- **Biggest gap**: the named test levels are defined in process documentation, but their concrete implementation patterns are not yet equally mature across the whole project. + +### 3.1.1 Unit Tests + +*Infrastructure supporting verification of software units against detailed design.* + +**S-CORE** + +- Unit tests are expressed as Bazel `*_test` targets per language. +- Test code usually lives in `/tests` directories or next to the implementation, depending on repository conventions. +- C++ execution and coverage are established; Rust support is improving but less complete in some areas. +- **Biggest gap**: no shared baseline for naming, layout, coverage treatment, and metadata conventions across all S-CORE repositories. + +### 3.1.2 Component Integration Tests + +*Infrastructure supporting verification of component architecture and component requirements.* + +**S-CORE** + +- CITs verify component architecture, interfaces, flows, and integration of units into components. +- CIT execution is primarily handled inside individual repositories via Bazel. +- **Biggest gap**: repository-specific CIT structure exists, but common patterns for reusable execution and reporting are not yet standardized project-wide. + +### 3.1.3 Feature Integration Tests + +*Infrastructure supporting verification of feature-level requirements and architecture across module boundaries.* + +**S-CORE** + +- FITs verify feature-level requirements and architecture across module boundaries. +- FIT execution is centered in `reference_integration`, where features are integrated as external modules and exercised through shared scenarios. +- FIT traceability is already being established in `reference_integration`. +- **Biggest gap**: FIT infrastructure exists, but traceability, language support, and reusable documentation around scenario composition are still evolving. + +### 3.1.4 Platform Tests ⚪ + +*Infrastructure supporting verification of stakeholder requirements on reference targets.* + +**S-CORE** + +- Platform tests are the highest named verification level in current S-CORE process descriptions. +- They verify stakeholder requirements on reference hardware and consume evidence from lower integration levels such as FITs. +- Enabling pieces already exist through `reference_integration`, release assets, and target-oriented frameworks such as ITF. +- **Biggest gap**: a fully standardized and visible platform-test environment, with broad hardware coverage and unified reporting, is not yet established across S-CORE. + +#### 3.1.4.1 Cross-Repository Testing + +*Infrastructure supporting tests that span multiple S-CORE repositories.* + +**S-CORE** + +- Cross-repository testing already exists in practice through `reference_integration`, where multiple repositories are integrated and tested together. +- This is currently the main shared place for assembling higher-level integration tests. +- **Biggest gap**: cross-repository execution is available, but it is not yet generalized into a uniformly reusable mechanism for all repositories and all test levels. + +#### 3.1.4.2 Scenario Testing + +*Infrastructure supporting end-to-end usage scenarios across the middleware.* + +**S-CORE** + +- Scenario-based testing is used as an execution style for higher integration levels, especially in `reference_integration` and ITF-based environments. +- The current direction is reusable scenario execution on different targets rather than one monolithic platform-wide harness. +- **Biggest gap**: scenario authoring, reuse, traceability, and result correlation still require more consistent tooling and documentation. + +--- + +## 3.2 Test Framework Integration ⚪ + +*Integrating language-specific test frameworks with the Bazel build system.* + +**S-CORE** + +- Test framework rules for C++, Rust, and Python are configured per repository. +- Higher-level integration and target-oriented testing additionally rely on shared frameworks such as ITF and repository-specific scenario support. +- **Biggest gap**: no single shared framework baseline or packaging model is yet mandated across all S-CORE repositories. + +### 3.2.1 C++ Test Frameworks + +*Infrastructure supporting C++ testing frameworks.* + +**S-CORE** + +- C++ tests use frameworks such as GoogleTest integrated via Bazel rules. +- C++ support is one of the more established paths for unit-test execution and coverage reporting. +- **Biggest gap**: framework versioning and Bazel rule configuration still vary per repository. + +### 3.2.2 Rust Test Frameworks + +*Infrastructure supporting Rust testing frameworks.* + +**S-CORE** + +- Rust tests use the native test model mapped into Bazel via `rules_rust`. +- Rust support is active, but traceability and detailed reporting are still less complete than in established C++ flows. +- **Biggest gap**: consistent `rules_rust` versioning, coverage/report handling, and metadata support are not yet uniformly available. + +### 3.2.3 Python Test Frameworks + +*Infrastructure supporting Python testing frameworks.* + +**S-CORE** + +- Python tests use frameworks such as pytest integrated via Bazel Python rules. +- Python also acts as an orchestration layer for some higher-level testing workflows. +- **Biggest gap**: no shared Python test framework and plugin baseline is standardized across repositories. + +### 3.2.4 Scenario Test Framework + +*Infrastructure supporting scenario based testing for C++ and Rust.* + +**S-CORE** + +- Scenario-style test support exists for building common scenarios across languages and modules. +- Shared scenarios can be executed while keeping implementation in language-specific backends. +- **Biggest gap**: split execution and verification logic can make ownership, traceability, and failure diagnosis harder. + +### 3.2.5 ITF Framework + +*Infrastructure supporting target-oriented integration and system-like testing.* + +**S-CORE** + +- ITF is a pytest-based Integration Testing Framework designed for ECU-oriented testing. +- Current public discussion describes ITF as moving toward a target-agnostic, plugin-based architecture. +- Target environments include Docker, QEMU virtual machines, and real hardware, with plugins also covering concerns such as DLT handling. +- **Biggest gap**: ITF Bazel targets do not allow adding test properties for traceability. + +--- + +## 3.3 Test Traceability ⚪ + +*Infrastructure for tracking traceability between test cases, requirements, and verification evidence.* + +**S-CORE** + +- Test implementation adds properties about tested requirements to the test report. +- Docs-as-code consumes all available reports at the build time and creates testlinks in requirements. +- Tests have their own `virtual needs objects`, which can be queried and referenced even though they are not implemented in the same way as textual requirements. +- FIT traceability in `reference_integration` is already being established. +- **Biggest gap**: Rust test targets and some higher-level frameworks still do not support the same degree of traceability metadata as established C++-centric flows. + +--- + +## 3.4 Test Execution ⚪ + +*Infrastructure for executing automated tests via the build system.* + +**S-CORE** + +- Tests are defined as Bazel targets and executed via `bazel test`, enabling incremental and cached re-execution. +- Test re-execution can be forced by adding the `--nocache_test_results` flag. +- Code coverage analysis always executes tests and does not use cache for correct instrumentation. +- Higher integration levels additionally rely on shared orchestration, especially in `reference_integration`. +- **Biggest gap**: test execution standards (target naming, timeout policy, sharding) are not uniformly defined across repositories. + +--- + +## 3.5 Test Reporting ⚪ + +*Infrastructure for collecting, aggregating, and presenting test results as verification evidence across S-CORE.* + +**S-CORE** + +- Test results are surfaced per pipeline run via GitHub Actions. +- For S-CORE releases, test and coverage reports are aggregated and attached to release assets. +- Some repository-level dashboards already exist, for example around traceability and unit-test or coverage summaries. +- These outputs provide the evidence needed by the verification process. +- **Biggest gap**: no centralized platform-wide dashboard or durable cross-repository trend reporting spans all of S-CORE. + +### 3.5.1 Result Aggregation + +*Infrastructure aggregating test results across CI pipeline runs.* + +**S-CORE** + +- Test result artifacts are generated per CI run, and release-oriented aggregation already exists for selected shared outputs. +- `reference_integration` plays an important role in collecting and combining higher-level evidence. +- **Biggest gap**: aggregation works for some release flows, but continuous project-wide aggregation across repositories and levels is still incomplete. + +### 3.5.2 Test Dashboards + +*Infrastructure providing dashboards for monitoring test results and trends.* + +**S-CORE** + +- Individual repositories already expose dashboard-style views for selected concerns such as traceability or unit-test and coverage summaries. +- No unified dashboard currently gives one consistent view across all repositories and all test levels. +- **Biggest gap**: test health visibility across S-CORE repositories is absent. + +--- diff --git a/docs/chapters/04-automation-integration.md b/docs/chapters/04-automation-integration.md new file mode 100644 index 0000000..99aade6 --- /dev/null +++ b/docs/chapters/04-automation-integration.md @@ -0,0 +1,177 @@ +# 5 Automation Infrastructure & Continuous Integration (CI/CD) ⚪ + +*Infrastructure integrating code changes safely across S-CORE repositories through automated workflows and quality gates.* + +⚠️ This chapter is written by ChatGPT and was not yet reviewed + +**S-CORE** + +- GitHub Actions is the CI/CD platform for S-CORE; workflows are triggered on pull requests and merges. +- Reusable workflows shared across repositories reduce duplication and enforce consistent pipeline structure. +- Pipeline execution relies on both GitHub-hosted cloud runners and hardware test runners. +- **Biggest gap**: reusable workflow coverage and quality gate consistency across S-CORE repositories are incomplete. + +## 5.1 Runners 🟠 + +*Execution infrastructure used by S-CORE CI pipelines.* + +**S-CORE** + +- Pipeline execution relies on GitHub-hosted cloud runners and dedicated hardware test runners. +- **Biggest gap**: hardware runner availability and reliability remain a bottleneck for integration pipelines. + +### 5.1.1 SW Test Runners 🟡 + +*GitHub-hosted runners providing execution environments for CI pipelines.* + +**S-CORE** + +- Cloud runners cover ARM, x86, and QEMU (with KVM) architectures with autoscaling to match pipeline demand. +- **Biggest gap**: runner capacity constraints under peak load are not yet fully mitigated. + +### 5.1.2 Hardware Test Runners 🔴 + +*Execution environments for hardware-based testing in S-CORE CI pipelines.* + +**S-CORE** + +- **Biggest gap**: availability and reliability of hardware runners are not yet at a level that enables consistent automated hardware testing across S-CORE. + +--- + +## 5.2 Reusable Workflows ⚪ + +*Shared GitHub Actions workflows reused across S-CORE repositories.* + +**S-CORE** + +- Workflows are defined in `.github/workflows/` per repository; reusable workflows are hosted centrally for cross-repository use. +- Reusable workflows are intended to standardize build, test, and compliance steps across repositories. +- Required status checks are configured centrally via [otterdog](https://otterdog.readthedocs.io/en/latest/userguide/) in the [S-CORE configuration](https://github.com/eclipse-score/.eclipsefdn/blob/main/otterdog/eclipse-score.jsonnet). +- **Biggest gap**: reusable workflow coverage is partial and quality gate definitions are not yet consistently enforced via shared workflows. + +### 5.2.1 Workflow Library Coverage + +*Completeness of centrally maintained reusable workflows for common CI patterns.* + +**S-CORE** + +- A shared reusable workflow library exists but does not yet cover all standard S-CORE pipeline scenarios. +- **Biggest gap**: a complete baseline library for standard build, test, and compliance patterns is not yet fully defined. + +### 5.2.2 Build Validation + +*Ensuring builds succeed before code is merged, using standardized workflow building blocks.* + +**S-CORE** + +- Build success is a required check for merges in S-CORE repositories via branch protection configuration. +- **Biggest gap**: build validation implementation details still vary by repository maturity. + +### 5.2.3 Test Validation + +*Ensuring tests pass before code is merged, with reusable test workflow patterns.* + +**S-CORE** + +- Test results gate merges in repositories where test pipelines are set up. +- **Biggest gap**: test gate coverage remains incomplete across S-CORE repositories. + +### 5.2.4 Static Analysis Enforcement + +*Executing shared static-analysis checks as reusable CI workflow steps and merge gates.* + +**S-CORE** + +- CI consumes the shared static-analysis capability described in [chapter 4](04-static-analysis-infrastructure.md) and turns it into workflow runs, status checks, and review-visible results. +- Reusable workflows should encapsulate execution and reporting so repositories do not reimplement the same enforcement mechanics. +- **Biggest gap**: reusable workflow coverage and required-check policy for static-analysis gates are not yet consistently applied across repositories. + +--- + +## 5.3 Cross-Repository Integration ⚪ + +*Validating integration scenarios across S-CORE components in CI beyond single-repository scope.* + +**S-CORE** + +- Cross-repository integration validation is a target capability; most repositories currently validate in isolation. +- **Biggest gap**: no shared integration validation pipeline spans multiple S-CORE middleware components. + +### 5.3.1 Integration Validation Scope + +*Defining which component combinations and dependency chains are validated together.* + +**S-CORE** + +- Integration coverage is currently limited and often project-specific instead of platform-wide. +- **Biggest gap**: no agreed minimum integration matrix is defined for S-CORE. + +### 5.3.2 Integration Pipeline Orchestration + +*Coordinating multi-repository builds and tests as one automated CI flow.* + +**S-CORE** + +- Multi-repository orchestration is a target capability and not yet standardized. +- **Biggest gap**: trigger, artifact handover, and result aggregation patterns are not yet unified. + +--- + +## 5.4 Secrets Management ⚪ + +*Protecting credentials and establishing least-privilege access for CI workflows and runners.* + +**S-CORE** + +- CI workflows rely on repository, organization, and environment secrets for accessing external systems. +- OIDC-based short-lived credentials are the preferred pattern where supported, reducing long-lived static secrets. +- **Biggest gap**: centralized secret inventory, rotation policy enforcement, and usage audits are not yet consistently implemented. + +### 5.4.1 Secret Scope and Rotation + +*Managing where secrets are stored and how frequently they are rotated.* + +**S-CORE** + +- Secret scoping follows GitHub constructs (repository, organization, environment), but conventions differ between repositories. +- **Biggest gap**: no uniform rotation cadence and ownership model is enforced across all CI secrets. + +### 5.4.2 Federated Identity (OIDC) + +*Replacing static credentials with short-lived identity federation for CI jobs.* + +**S-CORE** + +- OIDC adoption is progressing for cloud access use cases where providers support federated trust. +- **Biggest gap**: OIDC usage is not yet standardized across all repositories and target environments. + +--- + +## 5.5 CI Observability ⚪ + +*Monitoring CI health, performance, and reliability to improve developer feedback loops.* + +**S-CORE** + +- CI observability relies on GitHub Actions logs, job outcomes, and repository status checks. +- Key indicators include queue times, job durations, failure rate, and flaky test behavior. +- **Biggest gap**: no shared observability baseline or dashboard is used consistently across S-CORE repositories. + +### 5.5.1 Pipeline Health Metrics + +*Tracking execution and quality signals to detect bottlenecks and reliability issues early.* + +**S-CORE** + +- Pipeline metrics exist in native tooling but are not yet normalized into common S-CORE KPIs. +- **Biggest gap**: threshold definitions and trend tracking are not centrally aligned. + +### 5.5.2 Alerting and Incident Response + +*Reacting quickly to CI outages, widespread failures, or degraded feedback latency.* + +**S-CORE** + +- Notification and incident handling practices exist but differ between repositories and teams. +- **Biggest gap**: no standard CI incident playbook with shared escalation paths is applied platform-wide. diff --git a/docs/chapters/04-static-analysis-infrastructure.md b/docs/chapters/04-static-analysis-infrastructure.md new file mode 100644 index 0000000..e61ac1f --- /dev/null +++ b/docs/chapters/04-static-analysis-infrastructure.md @@ -0,0 +1,170 @@ +# 4 Static Analysis Infrastructure ⚪ + +*Infrastructure for inspecting S-CORE source code and configuration without executing the software, to enforce quality, consistency, and security expectations across repositories.* + +⚠️ This chapter is written by ChatGPT and was not yet reviewed + +**S-CORE** + +- Static analysis complements testing by finding issues through code and configuration inspection instead of runtime verification. +- This chapter defines the shared capability: analyzer scope, baseline expectations, rule governance, and ownership boundaries across repositories. +- Local execution and CI gating consume this capability in their own chapters rather than defining separate analyzer baselines. +- **Biggest gap**: static analysis is not yet defined and governed as one cross-repository capability with shared tooling, rule baselines, and ownership expectations. + +## 4.1 Tooling Baseline ⚪ + +*Defining which static analysis tools are approved, recommended, or required for different S-CORE repository types and languages.* + +**S-CORE** + +- Static analysis in S-CORE includes linters, type/interface analyzers, style and import checks, and security-oriented analyzers where appropriate. +- Tool choice is currently influenced by language ecosystems, repository classes, and existing engineering practice. +- **Biggest gap**: no explicit cross-repository baseline defines which analyzers are expected by default for C++, Rust, Python, and workflow or documentation assets. + +### 4.1.1 Tool Selection Criteria + +*Choosing analyzers that fit S-CORE repository needs and can be maintained at scale.* + +**S-CORE** + +- Tooling decisions should favor analyzers that can be shared across repositories, versioned centrally, and consumed consistently by local and automated execution environments. +- Shared tools should produce machine-readable results where possible so reporting and policy gates can consume them consistently. +- **Biggest gap**: selection criteria are implicit and repository-specific instead of centrally documented and reviewable. + +### 4.1.2 Repository and Language Baselines + +*Establishing default analyzer sets for major repository classes and implementation languages.* + +**S-CORE** + +- Different repository types need different analyzer sets, but the expected baseline should still be centrally defined. +- Repository-specific additions are valid when justified by language, framework, or safety needs. +- **Biggest gap**: baseline analyzer bundles and ownership of deviations are not yet described in one shared place. + +--- + +## 4.2 Shared Rule Configuration ⚪ + +*Managing analyzer rules, severities, suppressions, and versioning as shared infrastructure instead of ad-hoc repository detail.* + +**S-CORE** + +- Shared rule configurations are an important part of repository standards and should be versioned like other infrastructure policy artifacts. +- Repository overrides should be explicit, limited, and explainable rather than silent drift from the shared baseline. +- **Biggest gap**: no documented baseline-versus-override model exists for static-analysis rules across repository classes. + +### 4.2.1 Baseline Rulesets + +*Defining centrally maintained defaults for analyzer configuration.* + +**S-CORE** + +- Central baselines should define default enabled checks, severity handling, and common exclusions. +- Baselines should be reusable in templates, synchronized configuration, or shared workflow inputs. +- **Biggest gap**: there is no visible authoritative baseline for static-analysis rules across S-CORE repositories. + +### 4.2.2 Overrides and Suppressions + +*Allowing repository-specific exceptions without losing visibility or governance.* + +**S-CORE** + +- Overrides and suppressions are sometimes necessary for migration, generated code, third-party constraints, or language-specific false positives. +- Exceptions should be narrow, reviewable, and traceable so that debt can be reduced over time. +- **Biggest gap**: suppressions and local overrides are not yet governed by a shared policy for justification, expiry, or review. + +--- + +## 4.3 Execution Model ⚪ + +*Defining where and how the shared static-analysis capability should be executed across the engineering flow.* + +**S-CORE** + +- Static analysis should be executable in multiple contexts, especially local development and CI, without redefining analyzer baselines per context. +- Different execution contexts can use different subsets or frequencies, but they should all derive from the same shared rules and ownership model. +- **Biggest gap**: there is no documented execution model that cleanly separates shared analyzer policy from local and CI-specific delivery. + +### 4.3.1 Local Execution Expectations + +*Defining what static analysis should provide before code reaches CI.* + +**S-CORE** + +- Contributors should be able to run the shared analyzer baseline early enough to catch common issues before opening or updating a pull request. +- Local execution should favor fast feedback and alignment with the centrally defined ruleset, while the delivery details belong in [chapter 10](09-developer-environment.md). +- **Biggest gap**: local execution expectations are not yet defined independently of specific tools such as devcontainers, IDEs, or pre-commit hooks. + +### 4.3.2 CI Execution Expectations + +*Defining what CI should enforce from the shared static-analysis capability.* + +**S-CORE** + +- CI should execute the agreed shared analyzer baseline in a consistent, review-visible way and use its outcomes for merge decisions where appropriate. +- The workflow, reporting, and branch-protection mechanics belong in [chapter 5](04-automation-integration.md), not in the static-analysis capability definition itself. +- **Biggest gap**: CI enforcement expectations are not yet clearly separated from workflow implementation details. + +--- + +## 4.4 Boundary to Security Static Analysis ⚪ + +*Clarifying how general static analysis relates to security scanning and SAST.* + +**S-CORE** + +- Static analysis includes both general code-quality checks and security-relevant inspection, but the security program and its policies remain part of [chapter 11](10-security-infrastructure.md). +- This chapter is the canonical home for shared tooling, rule configuration, and ownership boundaries that are common across analyzer types. +- **Biggest gap**: the boundary between quality-oriented analyzers and security scanning is not yet described clearly enough to avoid duplication and ownership gaps. + +### 4.4.1 Shared Foundations + +*Capabilities shared by quality and security analyzers.* + +**S-CORE** + +- Tool distribution, execution semantics, baseline configuration, and suppression governance are shared infrastructure concerns across analyzer types. +- These shared foundations should be managed once and referenced by both engineering-quality and security documentation. +- **Biggest gap**: SAST is discussed mainly as a security feature, while its shared infrastructure dependencies are not documented holistically. + +### 4.4.2 Security-Specific Ownership + +*Keeping security policy and risk handling in the security chapter.* + +**S-CORE** + +- Security-specific topics such as vulnerability triage, security ownership, risk acceptance, and required security gates belong in [chapter 11](10-security-infrastructure.md). +- This separation keeps the static-analysis chapter focused on shared engineering infrastructure rather than security governance detail. +- **Biggest gap**: ownership boundaries for SAST configuration versus broader static-analysis infrastructure are not yet explicit. + +--- + +## 4.5 Results and Governance ⚪ + +*Managing findings, conformance visibility, and analyzer evolution across repositories.* + +**S-CORE** + +- Static-analysis infrastructure should provide visibility into adoption, drift, and findings without forcing every repository to invent its own process. +- Governance includes rule changes, false-positive handling, technical-debt baselines, and measurement of conformance to shared expectations. +- **Biggest gap**: no cross-repository reporting and governance loop currently shows which repositories run which analyzers, with what deviations and outcomes. + +### 4.5.1 False Positives and Baselines + +*Handling existing findings and noisy rules in a controlled way.* + +**S-CORE** + +- Migration to stronger analyzers often needs temporary baselines or approved suppressions so repositories can improve incrementally. +- These mechanisms should reduce noise without hiding ownership or turning exceptions into permanent blind spots. +- **Biggest gap**: there is no shared approach for introducing analyzers into repositories with existing finding backlogs. + +### 4.5.2 Cross-Repository Visibility + +*Measuring adoption and conformance of static-analysis standards across S-CORE.* + +**S-CORE** + +- Cross-repository reporting should show baseline adoption, exceptions, and required-check coverage, not just individual CI job output. +- This visibility is needed to prioritize migrations and understand where enforcement is still missing. +- **Biggest gap**: no common dashboard or conformance report currently summarizes static-analysis coverage across S-CORE. diff --git a/docs/chapters/05-artifact-distribution.md b/docs/chapters/05-artifact-distribution.md new file mode 100644 index 0000000..19711e8 --- /dev/null +++ b/docs/chapters/05-artifact-distribution.md @@ -0,0 +1,97 @@ +# 6 Artifact & Distribution Infrastructure ⚪ + +*Infrastructure managing build outputs, versioning, and distribution of S-CORE releases.* + +⚠️ This chapter is written by ChatGPT and was not yet reviewed + +**S-CORE** + +- GitHub Releases is the primary mechanism for publishing S-CORE artifacts. +- Artifact versioning follows semantic versioning aligned with git tagging. +- SBOM and provenance data should accompany released artifacts for compliance. +- **Biggest gap**: artifact distribution infrastructure is largely unstructured; no unified artifact storage, retention, or mirroring strategy exists across S-CORE. + +## 6.1 Artifact Storage ⚪ + +*Infrastructure storing build artifacts produced by S-CORE repositories.* + +**S-CORE** + +- Build artifacts are stored as GitHub Actions artifacts during CI runs; long-term storage relies on GitHub Releases. +- **Biggest gap**: no shared artifact repository (e.g., OCI registry, package index) is operated for S-CORE. + +### 6.1.1 Artifact Repositories + +*Storage locations for generated build artifacts across S-CORE.* + +**S-CORE** + +- GitHub Releases hosts published artifacts; GitHub Actions artifact storage is ephemeral (CI-scope only). +- **Biggest gap**: no persistent, queryable artifact repository with metadata and dependency resolution exists. + +### 6.1.2 Artifact Retention + +*Policies controlling how long artifacts are stored.* + +**S-CORE** + +- GitHub retains release artifacts indefinitely; Actions artifacts expire after a configurable period. +- **Biggest gap**: no explicit retention policy or lifecycle management is defined for S-CORE artifacts. + +--- + +## 6.2 Artifact Versioning ⚪ + +*Defining and enforcing consistent version numbering for S-CORE releases.* + +**S-CORE** + +- Semantic versioning aligned with git tags is the expected standard across S-CORE repositories. +- **Biggest gap**: versioning conventions are not uniformly enforced or validated across repositories. + +### 6.2.1 Versioning Strategy + +*Rules for artifact version numbering across S-CORE.* + +**S-CORE** + +- Semantic versioning (semver) is the expected convention; automation of version increments is not yet standardized. +- **Biggest gap**: no shared tooling or policy enforces consistent versioning across S-CORE repositories. + +### 6.2.2 Release Tagging + +*Tagging of releases in version control to mark published artifacts.* + +**S-CORE** + +- Git tags trigger release pipelines; tag naming conventions exist but are not centrally enforced. +- **Biggest gap**: no automated tag validation or cross-repository release coordination mechanism exists. + +--- + +## 6.3 Artifact Distribution ⚪ + +*Infrastructure publishing S-CORE artifacts to downstream consumers.* + +**S-CORE** + +- Artifacts are primarily distributed via GitHub Releases as downloadable binaries and archives. +- **Biggest gap**: no mirroring, CDN distribution, or consumer-facing artifact registry is in place. + +### 6.3.1 Release Publishing + +*Publishing artifacts as GitHub Releases.* + +**S-CORE** + +- Release publishing pipelines create GitHub Releases and attach artifacts, SBOMs, and checksums. +- **Biggest gap**: release pipeline standardization across S-CORE repositories is incomplete. + +### 6.3.2 Artifact Mirroring + +*Replicating artifacts into downstream or partner environments.* + +**S-CORE** + +- No artifact mirroring infrastructure currently exists for S-CORE. +- **Biggest gap**: artifacts are only accessible via GitHub; no mirroring or secondary distribution channel is in place. diff --git a/docs/chapters/06-compliance-infrastructure.md b/docs/chapters/06-compliance-infrastructure.md new file mode 100644 index 0000000..1153b2c --- /dev/null +++ b/docs/chapters/06-compliance-infrastructure.md @@ -0,0 +1,133 @@ +# 7 Compliance Infrastructure ⚪ + +*Infrastructure supporting legal and regulatory compliance for S-CORE software.* + +⚠️ This chapter is written by ChatGPT and was not yet reviewed + +**S-CORE** + +- SBOM generation, license compliance, and vulnerability tracking are core compliance requirements for S-CORE releases. +- License scanning and policy enforcement are partially operational; SBOM publication is a target capability. +- **Biggest gap**: compliance coverage is uneven across the dependency graph; automation from build through to published release artifacts is incomplete. + +## 7.1 SBOM Infrastructure ⚪ + +*Infrastructure generating and managing software bill of materials for S-CORE repositories.* + +**S-CORE** + +- SBOMs document the full dependency graph of released S-CORE artifacts for supply chain transparency. +- **Biggest gap**: SBOM generation coverage across all repositories and publication alongside releases is incomplete. + +### 7.1.1 SBOM Generation for Product 🟠 + +*Generating SBOMs during the build process for released product artifacts.* + +**S-CORE** + +- SBOM generation from Bazel build graphs is operational in some S-CORE repositories. +- **Biggest gap**: SBOM generation is not yet uniformly integrated into release pipelines across all repositories. + +### 7.1.2 SBOM Generation for Development Environment + +*Generating SBOMs for the build toolchain and development environment dependencies.* + +**S-CORE** + +- Development environment SBOMs (toolchain, devcontainer) are not yet generated. +- **Biggest gap**: toolchain and devcontainer dependency inventories are undocumented from a compliance perspective. + +### 7.1.3 SBOM Publication + +*Publishing SBOMs alongside released artifacts.* + +**S-CORE** + +- SBOM publication as a release artifact is a target capability. +- **Biggest gap**: no automated SBOM publication step is integrated into current S-CORE release pipelines. + +--- + +## 7.2 License Compliance 🟠 + +*Infrastructure ensuring open source license obligations for S-CORE dependencies are fulfilled.* + +**S-CORE** + +- License scanning is in place in some S-CORE repositories and is integrated into CI pipelines. +- Known license-incompatible dependencies are blocked from merging via policy enforcement tooling. +- **Biggest gap**: license compliance coverage is not yet consistent across all S-CORE repositories and dependency types. + +### 7.2.1 License Scanning 🟠 + +*Scanning dependencies to detect license information.* + +**S-CORE** + +- License scanners run as part of CI pipelines in active S-CORE repositories. +- **Biggest gap**: scan coverage across transitive dependencies and all repository types is not yet complete. + +### 7.2.2 License Documentation + +*Maintaining documentation of dependency licenses.* + +**S-CORE** + +- License information is captured as part of SBOM artifacts; no independently maintained license registry exists. +- **Biggest gap**: no centralized, continuously updated license registry spans all S-CORE dependencies. + +### 7.2.3 License Policy Enforcement 🟠 + +*Enforcing project license policies for dependencies.* + +**S-CORE** + +- License policy checks block non-compliant dependencies in CI pipelines where configured. +- **Biggest gap**: policy enforcement is not yet consistently deployed across all S-CORE repositories. + +--- + +## 7.3 Dependency Vulnerability Management ⚪ + +*Infrastructure tracking and mitigating security vulnerabilities in S-CORE dependencies.* + +**S-CORE** + +- Vulnerability monitoring for development dependencies relies on Dependabot and GitHub security advisories. +- **Biggest gap**: systematic vulnerability tracking and remediation across the full S-CORE dependency graph is not operationalized. + +### 7.3.1 Development Vulnerability Monitoring + +*Detecting vulnerabilities in dependencies during active development.* + +**S-CORE** + +- GitHub Dependabot provides automated vulnerability alerts for S-CORE repositories with supported dependency files. +- **Biggest gap**: Dependabot coverage is inconsistent; not all dependency types and lock files are supported. + +### 7.3.2 Release Vulnerability Monitoring + +*Tracking vulnerabilities that affect already published S-CORE artifacts.* + +**S-CORE** + +- Post-release vulnerability tracking against published SBOMs is a target capability. +- **Biggest gap**: no automated process monitors and alerts on vulnerabilities affecting released S-CORE artifacts. + +### 7.3.3 Vulnerability Impact Analysis + +*Determining which S-CORE artifacts or modules are affected by a vulnerability.* + +**S-CORE** + +- Impact analysis relies on manual investigation; no cross-repository automated impact triage exists. +- **Biggest gap**: no tooling supports automated vulnerability-to-artifact impact mapping across S-CORE. + +### 7.3.4 Vulnerability Remediation + +*Updating, replacing, or patching vulnerable dependencies.* + +**S-CORE** + +- Dependabot opens automated pull requests for version updates in configured repositories. +- **Biggest gap**: remediation coverage is limited to Dependabot-supported dependency types; coordinated cross-repository remediation is manual. diff --git a/docs/chapters/07-documentation-infrastructure.md b/docs/chapters/07-documentation-infrastructure.md new file mode 100644 index 0000000..f0a7c74 --- /dev/null +++ b/docs/chapters/07-documentation-infrastructure.md @@ -0,0 +1,99 @@ +# 7 Documentation Infrastructure 🟡 + +*Infrastructure supporting engineering documentation across S-CORE repositories.* + +⚠️ This chapter is under construction currently and should be treated as WIP ⚠️ + +**S-CORE** + +- Documentation infrastructure in S-CORE currently spans repository documentation sites and engineering-focused docs-as-code capabilities. +- Documentation is published through CI-driven static site generation and hosting. +- Engineering traceability (requirements, architecture, design, implementation, tests) is a target capability for functional safety compliance. + +## 7.1 Authoring & Tooling 🟡 + +*Capabilities for writing, structuring, and maintaining documentation in repositories.* + +**S-CORE** + +- Documentation is authored in version-controlled repositories alongside source code. +- Markdown and rST are the primary input formats. +- Rendering of documentation via Sphinx. +- Allow for plantuml & meermaid diagrams to be used. + +### 7.1.1 IDE & Developer Experience 🟡 + +*Providing fast feedback while authoring documentation locally.* + +**S-CORE** +- Providing live-preview capabilities of documentation 🟢 +- Providing warnings/errors etc. during build time from sphinx extensions 🟢 +- Providing live warnings/errors etc. from sphinx language server 🟡 + +--- + +## 7.2 Build, Validation & Publishing 🟡 + +*Infrastructure for builds, quality checks, and publication of documentation sites.* + +### 7.2.1 Deterministic Build and Configuration 🟠 + +*Ensuring reproducible documentation output across local and CI environments.* + +**S-CORE** +- Using bazel build system to ensure deterministic and reproducible builds + +### 7.2.2 Validation, Previews, and Publishing 🟡 +*Providing contributor feedback before merge through fast preview and validation workflows.* + +**S-CORE** + +- Compliance, where possible, enforced automatically through metamodel definitions 🟢 +- Providing rendered documentation of PR's 🟢 +- Availability to link against specific versions of requirements 🔴 + +--- + +## 7.3 Cross-Repository Documentation Integration 🟢 + +*Connecting documentation across repositories with stable linking and navigation patterns.* + +### 7.3.1 Cross-Repository Linking 🟢 + +*Establishing reliable links across repository boundaries and release versions.* + +**S-CORE** + +- Enabel integration of external projects documentation into own documentation + +### 7.3.2 Shared Navigation and Discovery 🟢 + +*Making documentation content easier to discover across repository-specific sites.* + +- Enable referenze-integration build which allows bi-directional linking of needs etc. + +--- + +## 7.4 Engineering Documentation ⚪ +*Infrastructure supporting requirements, architecture, design, and links to implementation and tests.* + +**S-CORE** + +- Engineering documentation (requirements, architecture, detailed design) is required for process compliance (e.g. ISO 26262, ASPICE). +- Architecture visualization and code integration are target capabilities to connect documentation with implementation artifacts. + + +## 7.5 Traceability 🟡 + +### 7.5.1 Traceability, Code Integration, and Impact Analysis 🟡 +*Linking requirements, design, code, and verification artifacts to support impact analysis.* + + +**S-CORE** + +- Possible to link source code to needs 🟢 +- Possible to link test cases to needs 🟢 +- Creation of 'external' needs for test cases via XML file parsing 🟢 + => This allows for statistics to be done on those test cases +- Availability to link against specific versions of requirements 🔴 + diff --git a/docs/chapters/08-infrastructure-operations.md b/docs/chapters/08-infrastructure-operations.md new file mode 100644 index 0000000..1916743 --- /dev/null +++ b/docs/chapters/08-infrastructure-operations.md @@ -0,0 +1,126 @@ +# 9 Infrastructure Operations ⚪ + +*Infrastructure for operating and maintaining the S-CORE engineering infrastructure.* + +⚠️ This chapter is written by ChatGPT and was not yet reviewed + +**S-CORE** + +- Infrastructure operations covers runner operations, monitoring, dependency maintenance, and governance. +- Dependabot automates dependency updates for infrastructure tooling across repositories. +- **Biggest gap**: systematic monitoring, incident handling, and proactive maintenance processes are not yet consistently defined across S-CORE infrastructure. + +## 9.1 CI Runner Operations ⚪ + +*Operating CI execution environments for S-CORE pipelines — out of scope for public S-CORE.* + +**S-CORE** + +- Self-hosted runner infrastructure is operated by ETAS and is not part of the public S-CORE project. +- Public S-CORE CI relies on GitHub-hosted runners; no runner operations work is expected from S-CORE contributors. +- **Biggest gap**: dependency on external runner operations creates a gap in public contributor autonomy. + +### 9.1.1 GitHub Public Runners + +*GitHub-hosted runners used by S-CORE CI pipelines.* + +**S-CORE** + +- GitHub-hosted runners are the default execution environment for public S-CORE CI. +- **Biggest gap**: GitHub-hosted runner capacity and feature availability are outside S-CORE control. + +### 9.1.2 Runner Configuration + +*Managing runner environment configuration.* + +**S-CORE** + +- Runner configuration is managed through workflow YAML files and, for self-hosted runners, by the ETAS INFRA team. +- **Biggest gap**: runner environment consistency and configuration documentation are not maintained in a central, public location. + +--- + +## 9.2 Infrastructure Monitoring ⚪ + +*Monitoring CI usage, failures, and infrastructure health across S-CORE.* + +**S-CORE** + +- CI pipeline failures are visible via GitHub Actions; no proactive monitoring or alerting spans S-CORE repositories. +- **Biggest gap**: no cross-repository infrastructure health dashboard or alert channel exists for S-CORE. + +### 9.2.1 CI Usage Monitoring + +*Monitoring CI usage patterns and capacity across S-CORE pipelines.* + +**S-CORE** + +- GitHub Actions provides per-repository usage metrics; no aggregated cross-repository view exists. +- **Biggest gap**: S-CORE-wide CI usage visibility and capacity planning are not operationalized. + +### 9.2.2 Failure Monitoring + +*Monitoring failures across S-CORE infrastructure systems.* + +**S-CORE** + +- Pipeline failures are surfaced per repository via GitHub; no S-CORE-wide failure tracking dashboard exists. +- **Biggest gap**: recurring failure patterns across S-CORE pipelines are not systematically detected. + +--- + +## 9.3 Infrastructure Maintenance ⚪ + +*Keeping S-CORE infrastructure tooling and dependencies up to date.* + +**S-CORE** + +- Dependabot automates version and SHA updates for infrastructure dependencies across S-CORE repositories. +- **Biggest gap**: proactive maintenance beyond Dependabot (e.g., major tool upgrades, deprecation handling) is not yet structured. + +### 9.3.1 Tool Updates + +*Updating shared infrastructure tools across S-CORE repositories.* + +**S-CORE** + +- Tool upgrades (e.g., MkDocs, Bazel, runner images) are performed reactively on a per-repository basis. +- **Biggest gap**: no coordinated tool update process or shared upgrade playbook exists across S-CORE. + +### 9.3.2 Dependency Updates + +*Updating infrastructure dependencies across S-CORE repositories.* + +**S-CORE** + +- [Dependabot](https://github.com/dependabot) automatically opens pull requests to bump dependency versions and SHA hashes. +- **Biggest gap**: Dependabot coverage is limited to supported dependency file types; non-standard lockfiles are not auto-updated. + +--- + +## 9.4 Infrastructure Governance ⚪ + +*Guiding and recording the evolution of S-CORE infrastructure.* + +**S-CORE** + +- Infrastructure decisions and policies are expected to be documented and version-controlled. +- **Biggest gap**: a structured decision record process and central policy repository are not yet operational across S-CORE. + +### 9.4.1 Infrastructure Policies + +*Defining policies governing S-CORE infrastructure usage.* + +**S-CORE** + +- Infrastructure usage policies (runner selection, dependency constraints, tooling standards) are not yet formally documented. +- **Biggest gap**: no central, versioned policy document set governs S-CORE infrastructure choices. + +### 9.4.2 Infrastructure Decision Records + +*Documenting major S-CORE infrastructure decisions.* + +**S-CORE** + +- Architecture Decision Records (ADRs) are a target practice for documenting significant infrastructure decisions. +- **Biggest gap**: no ADR process or repository is established for S-CORE infrastructure decisions. diff --git a/docs/chapters/09-developer-environment.md b/docs/chapters/09-developer-environment.md new file mode 100644 index 0000000..cb5cc39 --- /dev/null +++ b/docs/chapters/09-developer-environment.md @@ -0,0 +1,53 @@ +# 10 Developer Environment 🟠 + +*Environment infrastructure supporting developer productivity and consistency across S-CORE contributors.* + +⚠️ This chapter is written by ChatGPT and was not yet reviewed + +**S-CORE** + +- A shared devcontainer image at [eclipse-score/devcontainer](https://github.com/eclipse-score/devcontainer) standardizes development environments across contributors and CI. +- Pre-commit hooks provide fast local validation before code submission. +- **Biggest gap**: local tooling standardization beyond the devcontainer and pre-commit is not yet complete. + +## 10.1 Devcontainer 🟠 + +*Standardized, containerized development environment for S-CORE contributors and CI.* + +**S-CORE** + +- Devcontainer images are provided at [eclipse-score/devcontainer](https://github.com/eclipse-score/devcontainer) for use by both CI pipelines and local developer environments. +- The devcontainer standardizes tool versions and configurations across a wide range of compilers, build tools, and runtimes. +- **Biggest gap**: devcontainer adoption across all S-CORE repositories and contributors is not yet complete. + +## 10.2 IDE Integration 🟠 + +*Integration with development environments and IDEs for S-CORE contributors.* + +**S-CORE** + +- The [eclipse-score/devcontainer](https://github.com/eclipse-score/devcontainer) includes pre-configured VS Code extensions and workspace settings. +- IDE configuration via the devcontainer ensures consistent editor tooling (formatting, linting, debugging) across contributors. +- **Biggest gap**: IDE support beyond VS Code is not covered by the current devcontainer setup. + +## 10.3 Local Tooling 🟠 + +*Local development tooling provided for S-CORE contributors outside of CI.* + +**S-CORE** + +- Local tooling (build, test, lint, format) is accessible via the devcontainer without manual host configuration. +- Shared static-analysis tooling and rule-baseline concerns are covered centrally in [chapter 4](04-static-analysis-infrastructure.md); this chapter focuses only on how contributors access that tooling locally. +- **Biggest gap**: local tooling outside the devcontainer is not standardized; contributors running natively face an inconsistent setup. + +## 10.4 Pre-commit Validation 🟠 + +*Local validation hooks that check code quality before submission.* + +**S-CORE** + +- [pre-commit](https://pre-commit.com/) hooks validate code locally before push, catching issues such as missing copyright headers or wrong formatting without a CI round-trip. +- Custom S-CORE pre-commit hooks are provided via [eclipse-score/tooling](https://github.com/eclipse-score/tooling/blob/main/.pre-commit-hooks.yaml). +- Existing ecosystem pre-commit hooks are used where available; no proprietary mirrors of public hooks are maintained. +- Pre-commit is one local entry point for shared checks; the policy for which static-analysis checks belong there is defined in [chapter 4](04-static-analysis-infrastructure.md). +- **Biggest gap**: pre-commit adoption and hook coverage are not uniformly enforced across all S-CORE repositories. diff --git a/docs/chapters/10-security-infrastructure.md b/docs/chapters/10-security-infrastructure.md new file mode 100644 index 0000000..8aa4c18 --- /dev/null +++ b/docs/chapters/10-security-infrastructure.md @@ -0,0 +1,71 @@ +# 11 Security Infrastructure ⚪ + +*Infrastructure for managing security aspects of the S-CORE development and release process.* + +⚠️ This chapter is written by ChatGPT and was not yet reviewed + +**S-CORE** + +- Security infrastructure covers secret management, security scanning (SAST, supply chain), and artifact verification. +- GitHub's native security features (secret scanning, Dependabot, code scanning) provide a baseline. +- **Biggest gap**: a coherent, cross-repository security infrastructure strategy is not yet defined for S-CORE. + +## 11.1 Secret Management ⚪ + +*Infrastructure for managing credentials and secrets used in S-CORE pipelines.* + +**S-CORE** + +- Secrets are stored in GitHub repository and organization secrets; access is scoped to the workflows that require them. +- **Biggest gap**: no secret rotation process, audit trail, or centralized secret lifecycle management exists across S-CORE. + +--- + +## 11.2 Security Scanning ⚪ + +*Infrastructure for detecting security vulnerabilities in S-CORE code and dependencies.* + +**S-CORE** + +- GitHub's built-in code scanning (CodeQL) and secret scanning are available to S-CORE repositories. +- **Biggest gap**: security scanning adoption and configuration are inconsistent across S-CORE repositories. + +### 11.2.1 SAST + +*Static application security testing for S-CORE code.* + +**S-CORE** + +- CodeQL and similar SAST tools are available via GitHub Actions for S-CORE repositories. +- Shared analyzer delivery, execution patterns, and rule-baseline governance overlap with the broader static-analysis capability described in [chapter 4](04-static-analysis-infrastructure.md). +- Security-specific ownership remains here: SAST policy, risk handling, triage expectations, and required security gates. +- **Biggest gap**: SAST-specific configuration and required security gate policies are not yet standardized across repositories. + +### 11.2.2 Secret Scanning + +*Detecting secrets inadvertently committed to S-CORE repositories.* + +**S-CORE** + +- GitHub's secret scanning detects common credential patterns in S-CORE repository code automatically. +- **Biggest gap**: custom secret patterns and push protection configuration are not uniformly enabled. + +### 11.2.3 Supply Chain Security + +*Infrastructure addressing software supply chain threats in S-CORE.* + +**S-CORE** + +- Dependency pinning (hash-based) for CI actions and build dependencies reduces supply chain risk. +- **Biggest gap**: SLSA build provenance and artifact signing are not yet operational for S-CORE releases. + +--- + +## 11.3 Artifact Verification ⚪ + +*Infrastructure for verifying the authenticity and integrity of S-CORE release artifacts.* + +**S-CORE** + +- Artifact verification (checksums, signatures) for published S-CORE releases is not yet systematically implemented. +- **Biggest gap**: no artifact signing or verification mechanism is integrated into S-CORE release pipelines. diff --git a/docs/css/score-theme.css b/docs/css/score-theme.css new file mode 100644 index 0000000..912d82e --- /dev/null +++ b/docs/css/score-theme.css @@ -0,0 +1,203 @@ +:root { + --score-header: #2d1942; + --score-accent: #7c4daa; + --score-accent-soft: #a382c5; + --score-nav-text: #efeaf6; +} + +.wy-nav-side, +.wy-side-nav-search { + background: var(--score-header); +} + +.wy-side-nav-search { + border-bottom: 1px solid rgba(255, 255, 255, 0.14); + padding: 0.85rem 0 0.65rem; +} + +.wy-side-nav-search > a, +.wy-side-nav-search .wy-dropdown > a { + color: #ffffff; + display: flex; + flex-direction: column; + align-items: center; + justify-content: center; + gap: 0.15rem; +} + +.wy-side-nav-search > a.icon:before, +.wy-side-nav-search .wy-dropdown > a.icon:before { + display: none; +} + +.wy-side-nav-search > a img.logo, +.wy-side-nav-search .wy-dropdown > a img.logo { + width: min(100px, 62%); + height: auto; + margin: 0 auto 0.2rem; + padding: 0; + border-radius: 0; + background: transparent; +} + +.wy-side-nav-search > a::after, +.wy-side-nav-search .wy-dropdown > a::after { + content: "S-CORE Infrastructure"; + margin-bottom: 0.15rem; + color: #ffffff; + font-size: 0.95rem; + font-weight: 700; + line-height: 1.1; + letter-spacing: 0; + text-align: center; + white-space: normal; +} + +.wy-side-nav-search input[type="text"] { + border-color: var(--score-accent); +} + +.wy-side-nav-search input[type="text"]:focus { + border-color: var(--score-accent-soft); +} + +.wy-nav-top { + background: var(--score-header); +} + +.wy-nav-top a { + color: #ffffff; + font-weight: 700; +} + +.wy-nav-top a:before { + content: ""; + display: inline-block; + width: 1.05rem; + height: 1.05rem; + margin-right: 0.45rem; + background: url("../img/score-logo.svg") center / contain no-repeat; + vertical-align: -0.1rem; +} + +.wy-menu-vertical p.caption, +.wy-menu-vertical header { + color: #c8b7dd; +} + +.wy-menu-vertical a { + color: var(--score-nav-text); +} + +.wy-menu-vertical a:hover { + background-color: var(--score-accent); + color: #ffffff; +} + +.wy-menu-vertical li.current > a { + border-right: 3px solid var(--score-accent); +} + +.wy-nav-content-wrap .wy-nav-content { + max-width: 940px; +} + +a, +.rst-content a { + color: var(--score-accent); +} + +a:hover, +.rst-content a:hover { + color: #643899; +} + +.rst-versions a, +.rst-versions .rst-current-version { + color: var(--score-accent-soft); +} + +.landing-hero { + margin: 0 0 2rem; + padding: 1.5rem 1.6rem; + border: 1px solid rgba(124, 77, 170, 0.18); + border-radius: 18px; + background: + radial-gradient(circle at top right, rgba(163, 130, 197, 0.18), transparent 38%), + linear-gradient(135deg, rgba(45, 25, 66, 0.05), rgba(124, 77, 170, 0.08)); +} + +.landing-kicker { + margin: 0 0 0.45rem; + color: #643899; + font-size: 0.8rem; + font-weight: 700; + letter-spacing: 0.08em; + text-transform: uppercase; +} + +.landing-hero h2 { + margin: 0 0 0.7rem; + font-size: 2rem; + line-height: 1.15; +} + +.landing-lead { + margin: 0; + max-width: 48rem; + font-size: 1.05rem; + line-height: 1.65; +} + +.landing-grid { + display: grid; + gap: 1rem; + margin: 1rem 0 2rem; +} + +.landing-grid-2 { + grid-template-columns: repeat(2, minmax(0, 1fr)); +} + +.landing-grid-3 { + grid-template-columns: repeat(3, minmax(0, 1fr)); +} + +.landing-card { + padding: 1.1rem 1.1rem 1rem; + border: 1px solid rgba(45, 25, 66, 0.12); + border-radius: 14px; + background: #ffffff; + box-shadow: 0 10px 24px rgba(45, 25, 66, 0.04); +} + +.landing-card h3 { + margin-top: 0; + margin-bottom: 0.55rem; + color: var(--score-header); + font-size: 1.05rem; +} + +.landing-card p, +.landing-card ul { + margin-bottom: 0; +} + +.landing-card ul { + padding-left: 1.1rem; +} + +.landing-card-compact p { + line-height: 1.5; +} + +@media screen and (max-width: 900px) { + .landing-grid-2, + .landing-grid-3 { + grid-template-columns: 1fr; + } + + .landing-hero h2 { + font-size: 1.6rem; + } +} diff --git a/docs/img/score-logo.svg b/docs/img/score-logo.svg new file mode 100644 index 0000000..73b7089 --- /dev/null +++ b/docs/img/score-logo.svg @@ -0,0 +1,7 @@ + + + S-CORE_FINAL_WHITE LOGO@1x + + \ No newline at end of file diff --git a/docs/index.md b/docs/index.md new file mode 100644 index 0000000..c5fa4a9 --- /dev/null +++ b/docs/index.md @@ -0,0 +1,152 @@ +# S-CORE Infrastructure Landscape + +
+

Overview, development map, contribution map, and reference

+

Get oriented in the S-CORE infrastructure landscape.

+

+ This site explains what S-CORE infrastructure is, which building blocks already exist, how mature they are, + what is still missing, and how a concrete issue or pull request fits into the bigger picture. +

+
+ +
+
+

Who this is for

+

+ Technical and non-technical stakeholders who need an overview, plus infrastructure contributors + who need to understand the current state, gaps, and direction of the platform. +

+
+
+

What this repository documents

+

+ The technical capabilities that make engineering work possible and scalable across S-CORE: + source code management, builds, testing, static analysis, automation, compliance, + documentation, operations, developer environments, and security. +

+
+
+

What this site is for

+

+ An infrastructure overview, a development map for current state and remaining work, + a contribution map for infrastructure contributors, and a reference for architecture + and cross-cutting concerns. +

+
+
+ +## Start Here + +
+
+

I need an overview

+ +
+
+

I am working on infrastructure

+ +
+
+ +## Questions This Page Helps Answer + +
+
+

Overview questions

+ +
+
+

Contribution questions

+ +
+
+ +## Chapter Map + +```mermaid +flowchart LR + +subgraph FLOW["Core Engineering Flow"] + C1["1 Source Code Infrastructure 🟠"] + C2["2 Build Infrastructure (Bazel) ⚪"] + C3["3 Testing Infrastructure ⚪"] + C4["4 Static Analysis Infrastructure ⚪"] + C5["5 Automation & CI/CD ⚪"] + C6["6 Artifact & Distribution Infrastructure ⚪"] + + C1 --> C2 --> C3 --> C4 --> C5 --> C6 +end + +subgraph SUPPORT["Cross-Cutting Supporting Layers"] + C7["7 Compliance Infrastructure ⚪"] + C8["8 Documentation Infrastructure ⚪"] + C9["9 Infrastructure Operations ⚪"] + C10["10 Developer Environment 🟠"] + C11["11 Security Infrastructure ⚪"] +end + +%% Hidden edges to force layout: +FLOW --- SUPPORT +C7 --- C8 +C8 --- C9 +C9 --- C10 +C10 --- C11 +linkStyle 5 stroke-width:0px +linkStyle 6 stroke-width:0px +linkStyle 7 stroke-width:0px +linkStyle 8 stroke-width:0px +linkStyle 9 stroke-width:0px + +click C1 href "chapters/01-source-code-infrastructure/" "Open chapter 1" +click C2 href "chapters/02-build-infrastructure/" "Open chapter 2" +click C3 href "chapters/03-testing-infrastructure/" "Open chapter 3" +click C4 href "chapters/04-static-analysis-infrastructure/" "Open chapter 4" +click C5 href "chapters/04-automation-integration/" "Open chapter 5" +click C6 href "chapters/05-artifact-distribution/" "Open chapter 6" +click C7 href "chapters/06-compliance-infrastructure/" "Open chapter 7" +click C8 href "chapters/07-documentation-infrastructure/" "Open chapter 8" +click C9 href "chapters/08-infrastructure-operations/" "Open chapter 9" +click C10 href "chapters/09-developer-environment/" "Open chapter 10" +click C11 href "chapters/10-security-infrastructure/" "Open chapter 11" +``` + +## How To Read The Chapters + +
+
+

1. Pick a topic

+

Open the area closest to your question, task, or architectural concern.

+
+
+

2. Check maturity

+

Use the status icon to understand whether the area is established, partial, weak, or still unclear.

+
+
+

3. Look at the gap

+

Read "Biggest gap" to see what is missing, what remains to be improved, and why the area still matters.

+
+
+ +## Status Legend + +- 🟢 Implemented and effective +- 🟡 Partially implemented / needs improvement +- 🟠 Implemented but problematic or insufficient +- 🔴 Not started +- ⚪ Unknown / not yet assessed diff --git a/mkdocs.yml b/mkdocs.yml new file mode 100644 index 0000000..618fd84 --- /dev/null +++ b/mkdocs.yml @@ -0,0 +1,46 @@ +site_name: S-CORE Infrastructure Documentation +site_description: Documentation for the development, structure, and operation of S-CORE project infrastructure +site_url: https://eclipse-score.github.io/infrastructure/ +repo_name: eclipse-score/infrastructure +repo_url: https://github.com/eclipse-score/infrastructure +docs_dir: docs +strict: true + +theme: + name: readthedocs + logo: img/score-logo.svg + +extra_css: + - css/score-theme.css + +extra_javascript: + - https://unpkg.com/mermaid@10.4.0/dist/mermaid.esm.min.mjs + +plugins: + - search + - mermaid2: + arguments: + securityLevel: loose + +markdown_extensions: + - admonition + - attr_list + - def_list + - tables + - toc: + permalink: true + +nav: + - Overview: index.md + - Chapters: + - 1. Source Code Infrastructure: chapters/01-source-code-infrastructure.md + - 2. Build Infrastructure: chapters/02-build-infrastructure.md + - 3. Testing Infrastructure: chapters/03-testing-infrastructure.md + - 4. Static Analysis Infrastructure: chapters/04-static-analysis-infrastructure.md + - 5. Automation & CI/CD: chapters/04-automation-integration.md + - 6. Artifact & Distribution: chapters/05-artifact-distribution.md + - 7. Compliance Infrastructure: chapters/06-compliance-infrastructure.md + - 8. Documentation Infrastructure: chapters/07-documentation-infrastructure.md + - 9. Infrastructure Operations: chapters/08-infrastructure-operations.md + - 10. Developer Environment: chapters/09-developer-environment.md + - 11. Security Infrastructure: chapters/10-security-infrastructure.md diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 0000000..507ae9a --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,40 @@ +[project] +name = "score-infrastructure-docs" +version = "0.1.0" +description = "Technical infrastructure documentation for the S-CORE project" +readme = "README.md" +requires-python = ">=3.10" +dependencies = [ + "mkdocs>=1.6,<2.0", + "mkdocs-mermaid2-plugin>=1.2,<2.0", +] + +[tool.uv] +package = false + +[tool.ruff.lint] +select = [ + "E", # pycodestyle errors + "W", # pycodestyle warnings + "F", # pyflakes + "I", # isort + "N", # pep8-naming + "UP", # pyupgrade + "B", # flake8-bugbear + "C4", # flake8-comprehensions + "C90", # mccabe (complexity checks) + "SIM", # flake8-simplify + "TCH", # flake8-type-checking + "TID", # flake8-tidy-imports + "RUF", # ruff-specific rules + "PT", # flake8-pytest-style + "PIE", # flake8-pie + "T20", # flake8-print + "RSE", # flake8-raise + "RET", # flake8-return +] +ignore = [ + "E501", # line too long (handled by formatter) + "T201", # allow print() globally for CLI friendliness + "RET505", # opinionated decision: allow else after if-return for readability +] diff --git a/scripts/aggregate_status.py b/scripts/aggregate_status.py new file mode 100644 index 0000000..89489bd --- /dev/null +++ b/scripts/aggregate_status.py @@ -0,0 +1,182 @@ +#!/usr/bin/env python3 +"""Aggregate rollup status markers for infrastructure chapter markdown files.""" + +from __future__ import annotations + +import re +import sys +from pathlib import Path + +UNKNOWN_STATUS = "⚪" +DEFAULT_STATUS = UNKNOWN_STATUS +STATUS_RANK: dict[str, int] = { + "🔴": 0, + "🟠": 1, + "🟡": 2, + "🟢": 3, +} +STATUS_BY_RANK = {rank: status for status, rank in STATUS_RANK.items()} +STATUS_MARKERS = UNKNOWN_STATUS + "".join(STATUS_RANK) + +CHAPTER_HEADER_RE = re.compile( + rf"^#\s+(?P.+?)(?:\s+(?P<status>[{re.escape(STATUS_MARKERS)}]))?$", + re.MULTILINE, +) +SECTION_HEADER_RE = re.compile( + rf"^##\s+(?P<title>.+?)(?:\s+(?P<status>[{re.escape(STATUS_MARKERS)}]))?$", + re.MULTILINE, +) +SUBSECTION_HEADER_RE = re.compile( + rf"^###\s+(?P<title>.+?)(?:\s+(?P<status>[{re.escape(STATUS_MARKERS)}]))?$", +) +TRAILING_STATUS_RE = re.compile(rf"\s+(?:[{re.escape(STATUS_MARKERS)}])$") + + +def clean_title(title: str) -> str: + """Return a heading title without a trailing status marker.""" + return TRAILING_STATUS_RE.sub("", title).strip() + + +def get_average_status(statuses: list[str]) -> str: + """Return a rounded average status marker from known markers.""" + scores = [STATUS_RANK[status] for status in statuses if status in STATUS_RANK] + if not scores: + return DEFAULT_STATUS + average_score = sum(scores) / len(scores) + rounded_score = int(average_score + 0.5) + return STATUS_BY_RANK[rounded_score] + + +def get_rollup_status(statuses: list[str]) -> str: + """Return unknown if a majority is unknown, otherwise a rounded average.""" + if not statuses: + return DEFAULT_STATUS + + unknown_count = sum(status == UNKNOWN_STATUS for status in statuses) + if unknown_count / len(statuses) > 0.5: + return UNKNOWN_STATUS + + return get_average_status(statuses) + + +def extract_section_statuses(content: str) -> dict[str, str]: + """Compute section statuses from subsections or from the section marker itself.""" + section_statuses: dict[str, str] = {} + current_section: str | None = None + current_section_status = DEFAULT_STATUS + current_subsection_statuses: list[str] = [] + + def flush_current_section() -> None: + nonlocal current_section, current_section_status, current_subsection_statuses + if current_section and current_section != "Overview": + if current_subsection_statuses: + section_statuses[current_section] = get_rollup_status(current_subsection_statuses) + else: + section_statuses[current_section] = current_section_status + current_section_status = DEFAULT_STATUS + current_subsection_statuses = [] + + for line in content.splitlines(): + if section_match := SECTION_HEADER_RE.match(line): + flush_current_section() + current_section = clean_title(section_match.group("title")) + current_section_status = section_match.group("status") or DEFAULT_STATUS + continue + + if current_section and (subsection_match := SUBSECTION_HEADER_RE.match(line)): + status = subsection_match.group("status") or DEFAULT_STATUS + current_subsection_statuses.append(status) + + flush_current_section() + return section_statuses + + +def update_section_headers(content: str, section_statuses: dict[str, str]) -> str: + """Apply computed section rollups to level-2 headings.""" + + def replace_section(match: re.Match[str]) -> str: + title = clean_title(match.group("title")) + status = section_statuses.get(title) + return match.group(0) if status is None else f"## {title} {status}" + + return SECTION_HEADER_RE.sub(replace_section, content) + + +def update_chapter_status(content: str, section_statuses: dict[str, str]) -> str: + """Apply the rounded average section status to the chapter heading.""" + if not section_statuses: + return content + + chapter_status = get_rollup_status(list(section_statuses.values())) + + def replace_chapter(match: re.Match[str]) -> str: + title = clean_title(match.group("title")) + return f"# {title} {chapter_status}" + + return CHAPTER_HEADER_RE.sub(replace_chapter, content, count=1) + + +def process_chapter(file_path: Path) -> bool: + """Update a single chapter file and report whether it changed.""" + original_content = file_path.read_text(encoding="utf-8") + updated_content = original_content + section_statuses = extract_section_statuses(updated_content) + + if not section_statuses: + print(f" ℹ️ No subsection headings found in {file_path.name}") + else: + updated_content = update_section_headers(updated_content, section_statuses) + updated_content = update_chapter_status(updated_content, section_statuses) + + if updated_content == original_content: + print(f" ℹ️ No changes needed for {file_path.name}") + return False + + _ = file_path.write_text(updated_content, encoding="utf-8") + print(f" ✅ Updated {file_path.name}") + return True + + +def resolve_target_path(target: Path | None) -> Path: + """Return the file or directory to process.""" + if target is not None: + return target + return Path(__file__).resolve().parent.parent / "docs" / "chapters" + + +def iter_chapter_files(target: Path) -> list[Path]: + """Return markdown chapter files from a file or directory target.""" + if not target.exists(): + raise FileNotFoundError(f"Target not found: {target}") + if target.is_file(): + return [target] + return sorted(path for path in target.glob("*.md") if path.is_file()) + + +def main() -> int: + """Process chapter files and return a shell-friendly exit code.""" + target = Path(sys.argv[1]) if len(sys.argv) > 1 else None + target = resolve_target_path(target) + + try: + chapter_files = iter_chapter_files(target) + except FileNotFoundError as error: + print(f"❌ {error}") + return 1 + + if not chapter_files: + print(f"⚠️ No chapter files found in {target}") + return 1 + + print(f"🔄 Processing {len(chapter_files)} chapter files...\n") + + modified_count = 0 + for file_path in chapter_files: + modified_count += int(process_chapter(file_path)) + + print(f"\n📊 Summary: {modified_count} files modified") + return 0 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/uv.lock b/uv.lock new file mode 100644 index 0000000..6aad638 --- /dev/null +++ b/uv.lock @@ -0,0 +1,599 @@ +version = 1 +revision = 1 +requires-python = ">=3.10" + +[[package]] +name = "beautifulsoup4" +version = "4.14.3" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "soupsieve" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c3/b0/1c6a16426d389813b48d95e26898aff79abbde42ad353958ad95cc8c9b21/beautifulsoup4-4.14.3.tar.gz", hash = "sha256:6292b1c5186d356bba669ef9f7f051757099565ad9ada5dd630bd9de5fa7fb86", size = 627737 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/1a/39/47f9197bdd44df24d67ac8893641e16f386c984a0619ef2ee4c51fbbc019/beautifulsoup4-4.14.3-py3-none-any.whl", hash = "sha256:0918bfe44902e6ad8d57732ba310582e98da931428d231a5ecb9e7c703a735bb", size = 107721 }, +] + +[[package]] +name = "certifi" +version = "2026.2.25" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/af/2d/7bf41579a8986e348fa033a31cdd0e4121114f6bce2457e8876010b092dd/certifi-2026.2.25.tar.gz", hash = "sha256:e887ab5cee78ea814d3472169153c2d12cd43b14bd03329a39a9c6e2e80bfba7", size = 155029 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/9a/3c/c17fb3ca2d9c3acff52e30b309f538586f9f5b9c9cf454f3845fc9af4881/certifi-2026.2.25-py3-none-any.whl", hash = "sha256:027692e4402ad994f1c42e52a4997a9763c646b73e4096e4d5d6db8af1d6f0fa", size = 153684 }, +] + +[[package]] +name = "charset-normalizer" +version = "3.4.6" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/7b/60/e3bec1881450851b087e301bedc3daa9377a4d45f1c26aa90b0b235e38aa/charset_normalizer-3.4.6.tar.gz", hash = "sha256:1ae6b62897110aa7c79ea2f5dd38d1abca6db663687c0b1ad9aed6f6bae3d9d6", size = 143363 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/e6/8c/2c56124c6dc53a774d435f985b5973bc592f42d437be58c0c92d65ae7296/charset_normalizer-3.4.6-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:2e1d8ca8611099001949d1cdfaefc510cf0f212484fe7c565f735b68c78c3c95", size = 298751 }, + { url = "https://files.pythonhosted.org/packages/86/2a/2a7db6b314b966a3bcad8c731c0719c60b931b931de7ae9f34b2839289ee/charset_normalizer-3.4.6-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e25369dc110d58ddf29b949377a93e0716d72a24f62bad72b2b39f155949c1fd", size = 200027 }, + { url = "https://files.pythonhosted.org/packages/68/f2/0fe775c74ae25e2a3b07b01538fc162737b3e3f795bada3bc26f4d4d495c/charset_normalizer-3.4.6-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:259695e2ccc253feb2a016303543d691825e920917e31f894ca1a687982b1de4", size = 220741 }, + { url = "https://files.pythonhosted.org/packages/10/98/8085596e41f00b27dd6aa1e68413d1ddda7e605f34dd546833c61fddd709/charset_normalizer-3.4.6-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:dda86aba335c902b6149a02a55b38e96287157e609200811837678214ba2b1db", size = 215802 }, + { url = "https://files.pythonhosted.org/packages/fd/ce/865e4e09b041bad659d682bbd98b47fb490b8e124f9398c9448065f64fee/charset_normalizer-3.4.6-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:51fb3c322c81d20567019778cb5a4a6f2dc1c200b886bc0d636238e364848c89", size = 207908 }, + { url = "https://files.pythonhosted.org/packages/a8/54/8c757f1f7349262898c2f169e0d562b39dcb977503f18fdf0814e923db78/charset_normalizer-3.4.6-cp310-cp310-manylinux_2_31_armv7l.whl", hash = "sha256:4482481cb0572180b6fd976a4d5c72a30263e98564da68b86ec91f0fe35e8565", size = 194357 }, + { url = "https://files.pythonhosted.org/packages/6f/29/e88f2fac9218907fc7a70722b393d1bbe8334c61fe9c46640dba349b6e66/charset_normalizer-3.4.6-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:39f5068d35621da2881271e5c3205125cc456f54e9030d3f723288c873a71bf9", size = 205610 }, + { url = "https://files.pythonhosted.org/packages/4c/c5/21d7bb0cb415287178450171d130bed9d664211fdd59731ed2c34267b07d/charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:8bea55c4eef25b0b19a0337dc4e3f9a15b00d569c77211fa8cde38684f234fb7", size = 203512 }, + { url = "https://files.pythonhosted.org/packages/a4/be/ce52f3c7fdb35cc987ad38a53ebcef52eec498f4fb6c66ecfe62cfe57ba2/charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:f0cdaecd4c953bfae0b6bb64910aaaca5a424ad9c72d85cb88417bb9814f7550", size = 195398 }, + { url = "https://files.pythonhosted.org/packages/81/a0/3ab5dd39d4859a3555e5dadfc8a9fa7f8352f8c183d1a65c90264517da0e/charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:150b8ce8e830eb7ccb029ec9ca36022f756986aaaa7956aad6d9ec90089338c0", size = 221772 }, + { url = "https://files.pythonhosted.org/packages/04/6e/6a4e41a97ba6b2fa87f849c41e4d229449a586be85053c4d90135fe82d26/charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:e68c14b04827dd76dcbd1aeea9e604e3e4b78322d8faf2f8132c7138efa340a8", size = 205759 }, + { url = "https://files.pythonhosted.org/packages/db/3b/34a712a5ee64a6957bf355b01dc17b12de457638d436fdb05d01e463cd1c/charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:3778fd7d7cd04ae8f54651f4a7a0bd6e39a0cf20f801720a4c21d80e9b7ad6b0", size = 216938 }, + { url = "https://files.pythonhosted.org/packages/cb/05/5bd1e12da9ab18790af05c61aafd01a60f489778179b621ac2a305243c62/charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:dad6e0f2e481fffdcf776d10ebee25e0ef89f16d691f1e5dee4b586375fdc64b", size = 210138 }, + { url = "https://files.pythonhosted.org/packages/bd/8e/3cb9e2d998ff6b21c0a1860343cb7b83eba9cdb66b91410e18fc4969d6ab/charset_normalizer-3.4.6-cp310-cp310-win32.whl", hash = "sha256:74a2e659c7ecbc73562e2a15e05039f1e22c75b7c7618b4b574a3ea9118d1557", size = 144137 }, + { url = "https://files.pythonhosted.org/packages/d8/8f/78f5489ffadb0db3eb7aff53d31c24531d33eb545f0c6f6567c25f49a5ff/charset_normalizer-3.4.6-cp310-cp310-win_amd64.whl", hash = "sha256:aa9cccf4a44b9b62d8ba8b4dd06c649ba683e4bf04eea606d2e94cfc2d6ff4d6", size = 154244 }, + { url = "https://files.pythonhosted.org/packages/e4/74/e472659dffb0cadb2f411282d2d76c60da1fc94076d7fffed4ae8a93ec01/charset_normalizer-3.4.6-cp310-cp310-win_arm64.whl", hash = "sha256:e985a16ff513596f217cee86c21371b8cd011c0f6f056d0920aa2d926c544058", size = 143312 }, + { url = "https://files.pythonhosted.org/packages/62/28/ff6f234e628a2de61c458be2779cb182bc03f6eec12200d4a525bbfc9741/charset_normalizer-3.4.6-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:82060f995ab5003a2d6e0f4ad29065b7672b6593c8c63559beefe5b443242c3e", size = 293582 }, + { url = "https://files.pythonhosted.org/packages/1c/b7/b1a117e5385cbdb3205f6055403c2a2a220c5ea80b8716c324eaf75c5c95/charset_normalizer-3.4.6-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:60c74963d8350241a79cb8feea80e54d518f72c26db618862a8f53e5023deaf9", size = 197240 }, + { url = "https://files.pythonhosted.org/packages/a1/5f/2574f0f09f3c3bc1b2f992e20bce6546cb1f17e111c5be07308dc5427956/charset_normalizer-3.4.6-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f6e4333fb15c83f7d1482a76d45a0818897b3d33f00efd215528ff7c51b8e35d", size = 217363 }, + { url = "https://files.pythonhosted.org/packages/4a/d1/0ae20ad77bc949ddd39b51bf383b6ca932f2916074c95cad34ae465ab71f/charset_normalizer-3.4.6-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:bc72863f4d9aba2e8fd9085e63548a324ba706d2ea2c83b260da08a59b9482de", size = 212994 }, + { url = "https://files.pythonhosted.org/packages/60/ac/3233d262a310c1b12633536a07cde5ddd16985e6e7e238e9f3f9423d8eb9/charset_normalizer-3.4.6-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9cc4fc6c196d6a8b76629a70ddfcd4635a6898756e2d9cac5565cf0654605d73", size = 204697 }, + { url = "https://files.pythonhosted.org/packages/25/3c/8a18fc411f085b82303cfb7154eed5bd49c77035eb7608d049468b53f87c/charset_normalizer-3.4.6-cp311-cp311-manylinux_2_31_armv7l.whl", hash = "sha256:0c173ce3a681f309f31b87125fecec7a5d1347261ea11ebbb856fa6006b23c8c", size = 191673 }, + { url = "https://files.pythonhosted.org/packages/ff/a7/11cfe61d6c5c5c7438d6ba40919d0306ed83c9ab957f3d4da2277ff67836/charset_normalizer-3.4.6-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c907cdc8109f6c619e6254212e794d6548373cc40e1ec75e6e3823d9135d29cc", size = 201120 }, + { url = "https://files.pythonhosted.org/packages/b5/10/cf491fa1abd47c02f69687046b896c950b92b6cd7337a27e6548adbec8e4/charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:404a1e552cf5b675a87f0651f8b79f5f1e6fd100ee88dc612f89aa16abd4486f", size = 200911 }, + { url = "https://files.pythonhosted.org/packages/28/70/039796160b48b18ed466fde0af84c1b090c4e288fae26cd674ad04a2d703/charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:e3c701e954abf6fc03a49f7c579cc80c2c6cc52525340ca3186c41d3f33482ef", size = 192516 }, + { url = "https://files.pythonhosted.org/packages/ff/34/c56f3223393d6ff3124b9e78f7de738047c2d6bc40a4f16ac0c9d7a1cb3c/charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:7a6967aaf043bceabab5412ed6bd6bd26603dae84d5cb75bf8d9a74a4959d398", size = 218795 }, + { url = "https://files.pythonhosted.org/packages/e8/3b/ce2d4f86c5282191a041fdc5a4ce18f1c6bd40a5bd1f74cf8625f08d51c1/charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:5feb91325bbceade6afab43eb3b508c63ee53579fe896c77137ded51c6b6958e", size = 201833 }, + { url = "https://files.pythonhosted.org/packages/3b/9b/b6a9f76b0fd7c5b5ec58b228ff7e85095370282150f0bd50b3126f5506d6/charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:f820f24b09e3e779fe84c3c456cb4108a7aa639b0d1f02c28046e11bfcd088ed", size = 213920 }, + { url = "https://files.pythonhosted.org/packages/ae/98/7bc23513a33d8172365ed30ee3a3b3fe1ece14a395e5fc94129541fc6003/charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:b35b200d6a71b9839a46b9b7fff66b6638bb52fc9658aa58796b0326595d3021", size = 206951 }, + { url = "https://files.pythonhosted.org/packages/32/73/c0b86f3d1458468e11aec870e6b3feac931facbe105a894b552b0e518e79/charset_normalizer-3.4.6-cp311-cp311-win32.whl", hash = "sha256:9ca4c0b502ab399ef89248a2c84c54954f77a070f28e546a85e91da627d1301e", size = 143703 }, + { url = "https://files.pythonhosted.org/packages/c6/e3/76f2facfe8eddee0bbd38d2594e709033338eae44ebf1738bcefe0a06185/charset_normalizer-3.4.6-cp311-cp311-win_amd64.whl", hash = "sha256:a9e68c9d88823b274cf1e72f28cb5dc89c990edf430b0bfd3e2fb0785bfeabf4", size = 153857 }, + { url = "https://files.pythonhosted.org/packages/e2/dc/9abe19c9b27e6cd3636036b9d1b387b78c40dedbf0b47f9366737684b4b0/charset_normalizer-3.4.6-cp311-cp311-win_arm64.whl", hash = "sha256:97d0235baafca5f2b09cf332cc275f021e694e8362c6bb9c96fc9a0eb74fc316", size = 142751 }, + { url = "https://files.pythonhosted.org/packages/e5/62/c0815c992c9545347aeea7859b50dc9044d147e2e7278329c6e02ac9a616/charset_normalizer-3.4.6-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:2ef7fedc7a6ecbe99969cd09632516738a97eeb8bd7258bf8a0f23114c057dab", size = 295154 }, + { url = "https://files.pythonhosted.org/packages/a8/37/bdca6613c2e3c58c7421891d80cc3efa1d32e882f7c4a7ee6039c3fc951a/charset_normalizer-3.4.6-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a4ea868bc28109052790eb2b52a9ab33f3aa7adc02f96673526ff47419490e21", size = 199191 }, + { url = "https://files.pythonhosted.org/packages/6c/92/9934d1bbd69f7f398b38c5dae1cbf9cc672e7c34a4adf7b17c0a9c17d15d/charset_normalizer-3.4.6-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:836ab36280f21fc1a03c99cd05c6b7af70d2697e374c7af0b61ed271401a72a2", size = 218674 }, + { url = "https://files.pythonhosted.org/packages/af/90/25f6ab406659286be929fd89ab0e78e38aa183fc374e03aa3c12d730af8a/charset_normalizer-3.4.6-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f1ce721c8a7dfec21fcbdfe04e8f68174183cf4e8188e0645e92aa23985c57ff", size = 215259 }, + { url = "https://files.pythonhosted.org/packages/4e/ef/79a463eb0fff7f96afa04c1d4c51f8fc85426f918db467854bfb6a569ce3/charset_normalizer-3.4.6-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0e28d62a8fc7a1fa411c43bd65e346f3bce9716dc51b897fbe930c5987b402d5", size = 207276 }, + { url = "https://files.pythonhosted.org/packages/f7/72/d0426afec4b71dc159fa6b4e68f868cd5a3ecd918fec5813a15d292a7d10/charset_normalizer-3.4.6-cp312-cp312-manylinux_2_31_armv7l.whl", hash = "sha256:530d548084c4a9f7a16ed4a294d459b4f229db50df689bfe92027452452943a0", size = 195161 }, + { url = "https://files.pythonhosted.org/packages/bf/18/c82b06a68bfcb6ce55e508225d210c7e6a4ea122bfc0748892f3dc4e8e11/charset_normalizer-3.4.6-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:30f445ae60aad5e1f8bdbb3108e39f6fbc09f4ea16c815c66578878325f8f15a", size = 203452 }, + { url = "https://files.pythonhosted.org/packages/44/d6/0c25979b92f8adafdbb946160348d8d44aa60ce99afdc27df524379875cb/charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:ac2393c73378fea4e52aa56285a3d64be50f1a12395afef9cce47772f60334c2", size = 202272 }, + { url = "https://files.pythonhosted.org/packages/2e/3d/7fea3e8fe84136bebbac715dd1221cc25c173c57a699c030ab9b8900cbb7/charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:90ca27cd8da8118b18a52d5f547859cc1f8354a00cd1e8e5120df3e30d6279e5", size = 195622 }, + { url = "https://files.pythonhosted.org/packages/57/8a/d6f7fd5cb96c58ef2f681424fbca01264461336d2a7fc875e4446b1f1346/charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:8e5a94886bedca0f9b78fecd6afb6629142fd2605aa70a125d49f4edc6037ee6", size = 220056 }, + { url = "https://files.pythonhosted.org/packages/16/50/478cdda782c8c9c3fb5da3cc72dd7f331f031e7f1363a893cdd6ca0f8de0/charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:695f5c2823691a25f17bc5d5ffe79fa90972cc34b002ac6c843bb8a1720e950d", size = 203751 }, + { url = "https://files.pythonhosted.org/packages/75/fc/cc2fcac943939c8e4d8791abfa139f685e5150cae9f94b60f12520feaa9b/charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:231d4da14bcd9301310faf492051bee27df11f2bc7549bc0bb41fef11b82daa2", size = 216563 }, + { url = "https://files.pythonhosted.org/packages/a8/b7/a4add1d9a5f68f3d037261aecca83abdb0ab15960a3591d340e829b37298/charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:a056d1ad2633548ca18ffa2f85c202cfb48b68615129143915b8dc72a806a923", size = 209265 }, + { url = "https://files.pythonhosted.org/packages/6c/18/c094561b5d64a24277707698e54b7f67bd17a4f857bbfbb1072bba07c8bf/charset_normalizer-3.4.6-cp312-cp312-win32.whl", hash = "sha256:c2274ca724536f173122f36c98ce188fd24ce3dad886ec2b7af859518ce008a4", size = 144229 }, + { url = "https://files.pythonhosted.org/packages/ab/20/0567efb3a8fd481b8f34f739ebddc098ed062a59fed41a8d193a61939e8f/charset_normalizer-3.4.6-cp312-cp312-win_amd64.whl", hash = "sha256:c8ae56368f8cc97c7e40a7ee18e1cedaf8e780cd8bc5ed5ac8b81f238614facb", size = 154277 }, + { url = "https://files.pythonhosted.org/packages/15/57/28d79b44b51933119e21f65479d0864a8d5893e494cf5daab15df0247c17/charset_normalizer-3.4.6-cp312-cp312-win_arm64.whl", hash = "sha256:899d28f422116b08be5118ef350c292b36fc15ec2daeb9ea987c89281c7bb5c4", size = 142817 }, + { url = "https://files.pythonhosted.org/packages/1e/1d/4fdabeef4e231153b6ed7567602f3b68265ec4e5b76d6024cf647d43d981/charset_normalizer-3.4.6-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:11afb56037cbc4b1555a34dd69151e8e069bee82e613a73bef6e714ce733585f", size = 294823 }, + { url = "https://files.pythonhosted.org/packages/47/7b/20e809b89c69d37be748d98e84dce6820bf663cf19cf6b942c951a3e8f41/charset_normalizer-3.4.6-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:423fb7e748a08f854a08a222b983f4df1912b1daedce51a72bd24fe8f26a1843", size = 198527 }, + { url = "https://files.pythonhosted.org/packages/37/a6/4f8d27527d59c039dce6f7622593cdcd3d70a8504d87d09eb11e9fdc6062/charset_normalizer-3.4.6-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:d73beaac5e90173ac3deb9928a74763a6d230f494e4bfb422c217a0ad8e629bf", size = 218388 }, + { url = "https://files.pythonhosted.org/packages/f6/9b/4770ccb3e491a9bacf1c46cc8b812214fe367c86a96353ccc6daf87b01ec/charset_normalizer-3.4.6-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d60377dce4511655582e300dc1e5a5f24ba0cb229005a1d5c8d0cb72bb758ab8", size = 214563 }, + { url = "https://files.pythonhosted.org/packages/2b/58/a199d245894b12db0b957d627516c78e055adc3a0d978bc7f65ddaf7c399/charset_normalizer-3.4.6-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:530e8cebeea0d76bdcf93357aa5e41336f48c3dc709ac52da2bb167c5b8271d9", size = 206587 }, + { url = "https://files.pythonhosted.org/packages/7e/70/3def227f1ec56f5c69dfc8392b8bd63b11a18ca8178d9211d7cc5e5e4f27/charset_normalizer-3.4.6-cp313-cp313-manylinux_2_31_armv7l.whl", hash = "sha256:a26611d9987b230566f24a0a125f17fe0de6a6aff9f25c9f564aaa2721a5fb88", size = 194724 }, + { url = "https://files.pythonhosted.org/packages/58/ab/9318352e220c05efd31c2779a23b50969dc94b985a2efa643ed9077bfca5/charset_normalizer-3.4.6-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:34315ff4fc374b285ad7f4a0bf7dcbfe769e1b104230d40f49f700d4ab6bbd84", size = 202956 }, + { url = "https://files.pythonhosted.org/packages/75/13/f3550a3ac25b70f87ac98c40d3199a8503676c2f1620efbf8d42095cfc40/charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:5f8ddd609f9e1af8c7bd6e2aca279c931aefecd148a14402d4e368f3171769fd", size = 201923 }, + { url = "https://files.pythonhosted.org/packages/1b/db/c5c643b912740b45e8eec21de1bbab8e7fc085944d37e1e709d3dcd9d72f/charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:80d0a5615143c0b3225e5e3ef22c8d5d51f3f72ce0ea6fb84c943546c7b25b6c", size = 195366 }, + { url = "https://files.pythonhosted.org/packages/5a/67/3b1c62744f9b2448443e0eb160d8b001c849ec3fef591e012eda6484787c/charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:92734d4d8d187a354a556626c221cd1a892a4e0802ccb2af432a1d85ec012194", size = 219752 }, + { url = "https://files.pythonhosted.org/packages/f6/98/32ffbaf7f0366ffb0445930b87d103f6b406bc2c271563644bde8a2b1093/charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:613f19aa6e082cf96e17e3ffd89383343d0d589abda756b7764cf78361fd41dc", size = 203296 }, + { url = "https://files.pythonhosted.org/packages/41/12/5d308c1bbe60cabb0c5ef511574a647067e2a1f631bc8634fcafaccd8293/charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:2b1a63e8224e401cafe7739f77efd3f9e7f5f2026bda4aead8e59afab537784f", size = 215956 }, + { url = "https://files.pythonhosted.org/packages/53/e9/5f85f6c5e20669dbe56b165c67b0260547dea97dba7e187938833d791687/charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6cceb5473417d28edd20c6c984ab6fee6c6267d38d906823ebfe20b03d607dc2", size = 208652 }, + { url = "https://files.pythonhosted.org/packages/f1/11/897052ea6af56df3eef3ca94edafee410ca699ca0c7b87960ad19932c55e/charset_normalizer-3.4.6-cp313-cp313-win32.whl", hash = "sha256:d7de2637729c67d67cf87614b566626057e95c303bc0a55ffe391f5205e7003d", size = 143940 }, + { url = "https://files.pythonhosted.org/packages/a1/5c/724b6b363603e419829f561c854b87ed7c7e31231a7908708ac086cdf3e2/charset_normalizer-3.4.6-cp313-cp313-win_amd64.whl", hash = "sha256:572d7c822caf521f0525ba1bce1a622a0b85cf47ffbdae6c9c19e3b5ac3c4389", size = 154101 }, + { url = "https://files.pythonhosted.org/packages/01/a5/7abf15b4c0968e47020f9ca0935fb3274deb87cb288cd187cad92e8cdffd/charset_normalizer-3.4.6-cp313-cp313-win_arm64.whl", hash = "sha256:a4474d924a47185a06411e0064b803c68be044be2d60e50e8bddcc2649957c1f", size = 143109 }, + { url = "https://files.pythonhosted.org/packages/25/6f/ffe1e1259f384594063ea1869bfb6be5cdb8bc81020fc36c3636bc8302a1/charset_normalizer-3.4.6-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:9cc6e6d9e571d2f863fa77700701dae73ed5f78881efc8b3f9a4398772ff53e8", size = 294458 }, + { url = "https://files.pythonhosted.org/packages/56/60/09bb6c13a8c1016c2ed5c6a6488e4ffef506461aa5161662bd7636936fb1/charset_normalizer-3.4.6-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ef5960d965e67165d75b7c7ffc60a83ec5abfc5c11b764ec13ea54fbef8b4421", size = 199277 }, + { url = "https://files.pythonhosted.org/packages/00/50/dcfbb72a5138bbefdc3332e8d81a23494bf67998b4b100703fd15fa52d81/charset_normalizer-3.4.6-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:b3694e3f87f8ac7ce279d4355645b3c878d24d1424581b46282f24b92f5a4ae2", size = 218758 }, + { url = "https://files.pythonhosted.org/packages/03/b3/d79a9a191bb75f5aa81f3aaaa387ef29ce7cb7a9e5074ba8ea095cc073c2/charset_normalizer-3.4.6-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5d11595abf8dd942a77883a39d81433739b287b6aa71620f15164f8096221b30", size = 215299 }, + { url = "https://files.pythonhosted.org/packages/76/7e/bc8911719f7084f72fd545f647601ea3532363927f807d296a8c88a62c0d/charset_normalizer-3.4.6-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7bda6eebafd42133efdca535b04ccb338ab29467b3f7bf79569883676fc628db", size = 206811 }, + { url = "https://files.pythonhosted.org/packages/e2/40/c430b969d41dda0c465aa36cc7c2c068afb67177bef50905ac371b28ccc7/charset_normalizer-3.4.6-cp314-cp314-manylinux_2_31_armv7l.whl", hash = "sha256:bbc8c8650c6e51041ad1be191742b8b421d05bbd3410f43fa2a00c8db87678e8", size = 193706 }, + { url = "https://files.pythonhosted.org/packages/48/15/e35e0590af254f7df984de1323640ef375df5761f615b6225ba8deb9799a/charset_normalizer-3.4.6-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:22c6f0c2fbc31e76c3b8a86fba1a56eda6166e238c29cdd3d14befdb4a4e4815", size = 202706 }, + { url = "https://files.pythonhosted.org/packages/5e/bd/f736f7b9cc5e93a18b794a50346bb16fbfd6b37f99e8f306f7951d27c17c/charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7edbed096e4a4798710ed6bc75dcaa2a21b68b6c356553ac4823c3658d53743a", size = 202497 }, + { url = "https://files.pythonhosted.org/packages/9d/ba/2cc9e3e7dfdf7760a6ed8da7446d22536f3d0ce114ac63dee2a5a3599e62/charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:7f9019c9cb613f084481bd6a100b12e1547cf2efe362d873c2e31e4035a6fa43", size = 193511 }, + { url = "https://files.pythonhosted.org/packages/9e/cb/5be49b5f776e5613be07298c80e1b02a2d900f7a7de807230595c85a8b2e/charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:58c948d0d086229efc484fe2f30c2d382c86720f55cd9bc33591774348ad44e0", size = 220133 }, + { url = "https://files.pythonhosted.org/packages/83/43/99f1b5dad345accb322c80c7821071554f791a95ee50c1c90041c157ae99/charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:419a9d91bd238052642a51938af8ac05da5b3343becde08d5cdeab9046df9ee1", size = 203035 }, + { url = "https://files.pythonhosted.org/packages/87/9a/62c2cb6a531483b55dddff1a68b3d891a8b498f3ca555fbcf2978e804d9d/charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:5273b9f0b5835ff0350c0828faea623c68bfa65b792720c453e22b25cc72930f", size = 216321 }, + { url = "https://files.pythonhosted.org/packages/6e/79/94a010ff81e3aec7c293eb82c28f930918e517bc144c9906a060844462eb/charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:0e901eb1049fdb80f5bd11ed5ea1e498ec423102f7a9b9e4645d5b8204ff2815", size = 208973 }, + { url = "https://files.pythonhosted.org/packages/2a/57/4ecff6d4ec8585342f0c71bc03efaa99cb7468f7c91a57b105bcd561cea8/charset_normalizer-3.4.6-cp314-cp314-win32.whl", hash = "sha256:b4ff1d35e8c5bd078be89349b6f3a845128e685e751b6ea1169cf2160b344c4d", size = 144610 }, + { url = "https://files.pythonhosted.org/packages/80/94/8434a02d9d7f168c25767c64671fead8d599744a05d6a6c877144c754246/charset_normalizer-3.4.6-cp314-cp314-win_amd64.whl", hash = "sha256:74119174722c4349af9708993118581686f343adc1c8c9c007d59be90d077f3f", size = 154962 }, + { url = "https://files.pythonhosted.org/packages/46/4c/48f2cdbfd923026503dfd67ccea45c94fd8fe988d9056b468579c66ed62b/charset_normalizer-3.4.6-cp314-cp314-win_arm64.whl", hash = "sha256:e5bcc1a1ae744e0bb59641171ae53743760130600da8db48cbb6e4918e186e4e", size = 143595 }, + { url = "https://files.pythonhosted.org/packages/31/93/8878be7569f87b14f1d52032946131bcb6ebbd8af3e20446bc04053dc3f1/charset_normalizer-3.4.6-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:ad8faf8df23f0378c6d527d8b0b15ea4a2e23c89376877c598c4870d1b2c7866", size = 314828 }, + { url = "https://files.pythonhosted.org/packages/06/b6/fae511ca98aac69ecc35cde828b0a3d146325dd03d99655ad38fc2cc3293/charset_normalizer-3.4.6-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f5ea69428fa1b49573eef0cc44a1d43bebd45ad0c611eb7d7eac760c7ae771bc", size = 208138 }, + { url = "https://files.pythonhosted.org/packages/54/57/64caf6e1bf07274a1e0b7c160a55ee9e8c9ec32c46846ce59b9c333f7008/charset_normalizer-3.4.6-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:06a7e86163334edfc5d20fe104db92fcd666e5a5df0977cb5680a506fe26cc8e", size = 224679 }, + { url = "https://files.pythonhosted.org/packages/aa/cb/9ff5a25b9273ef160861b41f6937f86fae18b0792fe0a8e75e06acb08f1d/charset_normalizer-3.4.6-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:e1f6e2f00a6b8edb562826e4632e26d063ac10307e80f7461f7de3ad8ef3f077", size = 223475 }, + { url = "https://files.pythonhosted.org/packages/fc/97/440635fc093b8d7347502a377031f9605a1039c958f3cd18dcacffb37743/charset_normalizer-3.4.6-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:95b52c68d64c1878818687a473a10547b3292e82b6f6fe483808fb1468e2f52f", size = 215230 }, + { url = "https://files.pythonhosted.org/packages/cd/24/afff630feb571a13f07c8539fbb502d2ab494019492aaffc78ef41f1d1d0/charset_normalizer-3.4.6-cp314-cp314t-manylinux_2_31_armv7l.whl", hash = "sha256:7504e9b7dc05f99a9bbb4525c67a2c155073b44d720470a148b34166a69c054e", size = 199045 }, + { url = "https://files.pythonhosted.org/packages/e5/17/d1399ecdaf7e0498c327433e7eefdd862b41236a7e484355b8e0e5ebd64b/charset_normalizer-3.4.6-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:172985e4ff804a7ad08eebec0a1640ece87ba5041d565fff23c8f99c1f389484", size = 211658 }, + { url = "https://files.pythonhosted.org/packages/b5/38/16baa0affb957b3d880e5ac2144caf3f9d7de7bc4a91842e447fbb5e8b67/charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:4be9f4830ba8741527693848403e2c457c16e499100963ec711b1c6f2049b7c7", size = 210769 }, + { url = "https://files.pythonhosted.org/packages/05/34/c531bc6ac4c21da9ddfddb3107be2287188b3ea4b53b70fc58f2a77ac8d8/charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:79090741d842f564b1b2827c0b82d846405b744d31e84f18d7a7b41c20e473ff", size = 201328 }, + { url = "https://files.pythonhosted.org/packages/fa/73/a5a1e9ca5f234519c1953608a03fe109c306b97fdfb25f09182babad51a7/charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:87725cfb1a4f1f8c2fc9890ae2f42094120f4b44db9360be5d99a4c6b0e03a9e", size = 225302 }, + { url = "https://files.pythonhosted.org/packages/ba/f6/cd782923d112d296294dea4bcc7af5a7ae0f86ab79f8fefbda5526b6cfc0/charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:fcce033e4021347d80ed9c66dcf1e7b1546319834b74445f561d2e2221de5659", size = 211127 }, + { url = "https://files.pythonhosted.org/packages/0e/c5/0b6898950627af7d6103a449b22320372c24c6feda91aa24e201a478d161/charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:ca0276464d148c72defa8bb4390cce01b4a0e425f3b50d1435aa6d7a18107602", size = 222840 }, + { url = "https://files.pythonhosted.org/packages/7d/25/c4bba773bef442cbdc06111d40daa3de5050a676fa26e85090fc54dd12f0/charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:197c1a244a274bb016dd8b79204850144ef77fe81c5b797dc389327adb552407", size = 216890 }, + { url = "https://files.pythonhosted.org/packages/35/1a/05dacadb0978da72ee287b0143097db12f2e7e8d3ffc4647da07a383b0b7/charset_normalizer-3.4.6-cp314-cp314t-win32.whl", hash = "sha256:2a24157fa36980478dd1770b585c0f30d19e18f4fb0c47c13aa568f871718579", size = 155379 }, + { url = "https://files.pythonhosted.org/packages/5d/7a/d269d834cb3a76291651256f3b9a5945e81d0a49ab9f4a498964e83c0416/charset_normalizer-3.4.6-cp314-cp314t-win_amd64.whl", hash = "sha256:cd5e2801c89992ed8c0a3f0293ae83c159a60d9a5d685005383ef4caca77f2c4", size = 169043 }, + { url = "https://files.pythonhosted.org/packages/23/06/28b29fba521a37a8932c6a84192175c34d49f84a6d4773fa63d05f9aff22/charset_normalizer-3.4.6-cp314-cp314t-win_arm64.whl", hash = "sha256:47955475ac79cc504ef2704b192364e51d0d473ad452caedd0002605f780101c", size = 148523 }, + { url = "https://files.pythonhosted.org/packages/2a/68/687187c7e26cb24ccbd88e5069f5ef00eba804d36dde11d99aad0838ab45/charset_normalizer-3.4.6-py3-none-any.whl", hash = "sha256:947cf925bc916d90adba35a64c82aace04fa39b46b52d4630ece166655905a69", size = 61455 }, +] + +[[package]] +name = "click" +version = "8.3.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "colorama", marker = "sys_platform == 'win32'" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/3d/fa/656b739db8587d7b5dfa22e22ed02566950fbfbcdc20311993483657a5c0/click-8.3.1.tar.gz", hash = "sha256:12ff4785d337a1bb490bb7e9c2b1ee5da3112e94a8622f26a6c77f5d2fc6842a", size = 295065 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/98/78/01c019cdb5d6498122777c1a43056ebb3ebfeef2076d9d026bfe15583b2b/click-8.3.1-py3-none-any.whl", hash = "sha256:981153a64e25f12d547d3426c367a4857371575ee7ad18df2a6183ab0545b2a6", size = 108274 }, +] + +[[package]] +name = "colorama" +version = "0.4.6" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335 }, +] + +[[package]] +name = "editorconfig" +version = "0.17.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/88/3a/a61d9a1f319a186b05d14df17daea42fcddea63c213bcd61a929fb3a6796/editorconfig-0.17.1.tar.gz", hash = "sha256:23c08b00e8e08cc3adcddb825251c497478df1dada6aefeb01e626ad37303745", size = 14695 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/96/fd/a40c621ff207f3ce8e484aa0fc8ba4eb6e3ecf52e15b42ba764b457a9550/editorconfig-0.17.1-py3-none-any.whl", hash = "sha256:1eda9c2c0db8c16dbd50111b710572a5e6de934e39772de1959d41f64fc17c82", size = 16360 }, +] + +[[package]] +name = "ghp-import" +version = "2.1.0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "python-dateutil" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/d9/29/d40217cbe2f6b1359e00c6c307bb3fc876ba74068cbab3dde77f03ca0dc4/ghp-import-2.1.0.tar.gz", hash = "sha256:9c535c4c61193c2df8871222567d7fd7e5014d835f97dc7b7439069e2413d343", size = 10943 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/f7/ec/67fbef5d497f86283db54c22eec6f6140243aae73265799baaaa19cd17fb/ghp_import-2.1.0-py3-none-any.whl", hash = "sha256:8337dd7b50877f163d4c0289bc1f1c7f127550241988d568c1db512c4324a619", size = 11034 }, +] + +[[package]] +name = "idna" +version = "3.11" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902", size = 194582 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea", size = 71008 }, +] + +[[package]] +name = "jinja2" +version = "3.1.6" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "markupsafe" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/df/bf/f7da0350254c0ed7c72f3e33cef02e048281fec7ecec5f032d4aac52226b/jinja2-3.1.6.tar.gz", hash = "sha256:0137fb05990d35f1275a587e9aee6d56da821fc83491a0fb838183be43f66d6d", size = 245115 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/62/a1/3d680cbfd5f4b8f15abc1d571870c5fc3e594bb582bc3b64ea099db13e56/jinja2-3.1.6-py3-none-any.whl", hash = "sha256:85ece4451f492d0c13c5dd7c13a64681a86afae63a5f347908daf103ce6d2f67", size = 134899 }, +] + +[[package]] +name = "jsbeautifier" +version = "1.15.4" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "editorconfig" }, + { name = "six" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/ea/98/d6cadf4d5a1c03b2136837a435682418c29fdeb66be137128544cecc5b7a/jsbeautifier-1.15.4.tar.gz", hash = "sha256:5bb18d9efb9331d825735fbc5360ee8f1aac5e52780042803943aa7f854f7592", size = 75257 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/2d/14/1c65fccf8413d5f5c6e8425f84675169654395098000d8bddc4e9d3390e1/jsbeautifier-1.15.4-py3-none-any.whl", hash = "sha256:72f65de312a3f10900d7685557f84cb61a9733c50dcc27271a39f5b0051bf528", size = 94707 }, +] + +[[package]] +name = "markdown" +version = "3.10.2" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/2b/f4/69fa6ed85ae003c2378ffa8f6d2e3234662abd02c10d216c0ba96081a238/markdown-3.10.2.tar.gz", hash = "sha256:994d51325d25ad8aa7ce4ebaec003febcce822c3f8c911e3b17c52f7f589f950", size = 368805 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/de/1f/77fa3081e4f66ca3576c896ae5d31c3002ac6607f9747d2e3aa49227e464/markdown-3.10.2-py3-none-any.whl", hash = "sha256:e91464b71ae3ee7afd3017d9f358ef0baf158fd9a298db92f1d4761133824c36", size = 108180 }, +] + +[[package]] +name = "markupsafe" +version = "3.0.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/7e/99/7690b6d4034fffd95959cbe0c02de8deb3098cc577c67bb6a24fe5d7caa7/markupsafe-3.0.3.tar.gz", hash = "sha256:722695808f4b6457b320fdc131280796bdceb04ab50fe1795cd540799ebe1698", size = 80313 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/e8/4b/3541d44f3937ba468b75da9eebcae497dcf67adb65caa16760b0a6807ebb/markupsafe-3.0.3-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:2f981d352f04553a7171b8e44369f2af4055f888dfb147d55e42d29e29e74559", size = 11631 }, + { url = "https://files.pythonhosted.org/packages/98/1b/fbd8eed11021cabd9226c37342fa6ca4e8a98d8188a8d9b66740494960e4/markupsafe-3.0.3-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:e1c1493fb6e50ab01d20a22826e57520f1284df32f2d8601fdd90b6304601419", size = 12057 }, + { url = "https://files.pythonhosted.org/packages/40/01/e560d658dc0bb8ab762670ece35281dec7b6c1b33f5fbc09ebb57a185519/markupsafe-3.0.3-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1ba88449deb3de88bd40044603fafffb7bc2b055d626a330323a9ed736661695", size = 22050 }, + { url = "https://files.pythonhosted.org/packages/af/cd/ce6e848bbf2c32314c9b237839119c5a564a59725b53157c856e90937b7a/markupsafe-3.0.3-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f42d0984e947b8adf7dd6dde396e720934d12c506ce84eea8476409563607591", size = 20681 }, + { url = "https://files.pythonhosted.org/packages/c9/2a/b5c12c809f1c3045c4d580b035a743d12fcde53cf685dbc44660826308da/markupsafe-3.0.3-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c0c0b3ade1c0b13b936d7970b1d37a57acde9199dc2aecc4c336773e1d86049c", size = 20705 }, + { url = "https://files.pythonhosted.org/packages/cf/e3/9427a68c82728d0a88c50f890d0fc072a1484de2f3ac1ad0bfc1a7214fd5/markupsafe-3.0.3-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:0303439a41979d9e74d18ff5e2dd8c43ed6c6001fd40e5bf2e43f7bd9bbc523f", size = 21524 }, + { url = "https://files.pythonhosted.org/packages/bc/36/23578f29e9e582a4d0278e009b38081dbe363c5e7165113fad546918a232/markupsafe-3.0.3-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:d2ee202e79d8ed691ceebae8e0486bd9a2cd4794cec4824e1c99b6f5009502f6", size = 20282 }, + { url = "https://files.pythonhosted.org/packages/56/21/dca11354e756ebd03e036bd8ad58d6d7168c80ce1fe5e75218e4945cbab7/markupsafe-3.0.3-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:177b5253b2834fe3678cb4a5f0059808258584c559193998be2601324fdeafb1", size = 20745 }, + { url = "https://files.pythonhosted.org/packages/87/99/faba9369a7ad6e4d10b6a5fbf71fa2a188fe4a593b15f0963b73859a1bbd/markupsafe-3.0.3-cp310-cp310-win32.whl", hash = "sha256:2a15a08b17dd94c53a1da0438822d70ebcd13f8c3a95abe3a9ef9f11a94830aa", size = 14571 }, + { url = "https://files.pythonhosted.org/packages/d6/25/55dc3ab959917602c96985cb1253efaa4ff42f71194bddeb61eb7278b8be/markupsafe-3.0.3-cp310-cp310-win_amd64.whl", hash = "sha256:c4ffb7ebf07cfe8931028e3e4c85f0357459a3f9f9490886198848f4fa002ec8", size = 15056 }, + { url = "https://files.pythonhosted.org/packages/d0/9e/0a02226640c255d1da0b8d12e24ac2aa6734da68bff14c05dd53b94a0fc3/markupsafe-3.0.3-cp310-cp310-win_arm64.whl", hash = "sha256:e2103a929dfa2fcaf9bb4e7c091983a49c9ac3b19c9061b6d5427dd7d14d81a1", size = 13932 }, + { url = "https://files.pythonhosted.org/packages/08/db/fefacb2136439fc8dd20e797950e749aa1f4997ed584c62cfb8ef7c2be0e/markupsafe-3.0.3-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:1cc7ea17a6824959616c525620e387f6dd30fec8cb44f649e31712db02123dad", size = 11631 }, + { url = "https://files.pythonhosted.org/packages/e1/2e/5898933336b61975ce9dc04decbc0a7f2fee78c30353c5efba7f2d6ff27a/markupsafe-3.0.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:4bd4cd07944443f5a265608cc6aab442e4f74dff8088b0dfc8238647b8f6ae9a", size = 12058 }, + { url = "https://files.pythonhosted.org/packages/1d/09/adf2df3699d87d1d8184038df46a9c80d78c0148492323f4693df54e17bb/markupsafe-3.0.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6b5420a1d9450023228968e7e6a9ce57f65d148ab56d2313fcd589eee96a7a50", size = 24287 }, + { url = "https://files.pythonhosted.org/packages/30/ac/0273f6fcb5f42e314c6d8cd99effae6a5354604d461b8d392b5ec9530a54/markupsafe-3.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0bf2a864d67e76e5c9a34dc26ec616a66b9888e25e7b9460e1c76d3293bd9dbf", size = 22940 }, + { url = "https://files.pythonhosted.org/packages/19/ae/31c1be199ef767124c042c6c3e904da327a2f7f0cd63a0337e1eca2967a8/markupsafe-3.0.3-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:bc51efed119bc9cfdf792cdeaa4d67e8f6fcccab66ed4bfdd6bde3e59bfcbb2f", size = 21887 }, + { url = "https://files.pythonhosted.org/packages/b2/76/7edcab99d5349a4532a459e1fe64f0b0467a3365056ae550d3bcf3f79e1e/markupsafe-3.0.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:068f375c472b3e7acbe2d5318dea141359e6900156b5b2ba06a30b169086b91a", size = 23692 }, + { url = "https://files.pythonhosted.org/packages/a4/28/6e74cdd26d7514849143d69f0bf2399f929c37dc2b31e6829fd2045b2765/markupsafe-3.0.3-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:7be7b61bb172e1ed687f1754f8e7484f1c8019780f6f6b0786e76bb01c2ae115", size = 21471 }, + { url = "https://files.pythonhosted.org/packages/62/7e/a145f36a5c2945673e590850a6f8014318d5577ed7e5920a4b3448e0865d/markupsafe-3.0.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:f9e130248f4462aaa8e2552d547f36ddadbeaa573879158d721bbd33dfe4743a", size = 22923 }, + { url = "https://files.pythonhosted.org/packages/0f/62/d9c46a7f5c9adbeeeda52f5b8d802e1094e9717705a645efc71b0913a0a8/markupsafe-3.0.3-cp311-cp311-win32.whl", hash = "sha256:0db14f5dafddbb6d9208827849fad01f1a2609380add406671a26386cdf15a19", size = 14572 }, + { url = "https://files.pythonhosted.org/packages/83/8a/4414c03d3f891739326e1783338e48fb49781cc915b2e0ee052aa490d586/markupsafe-3.0.3-cp311-cp311-win_amd64.whl", hash = "sha256:de8a88e63464af587c950061a5e6a67d3632e36df62b986892331d4620a35c01", size = 15077 }, + { url = "https://files.pythonhosted.org/packages/35/73/893072b42e6862f319b5207adc9ae06070f095b358655f077f69a35601f0/markupsafe-3.0.3-cp311-cp311-win_arm64.whl", hash = "sha256:3b562dd9e9ea93f13d53989d23a7e775fdfd1066c33494ff43f5418bc8c58a5c", size = 13876 }, + { url = "https://files.pythonhosted.org/packages/5a/72/147da192e38635ada20e0a2e1a51cf8823d2119ce8883f7053879c2199b5/markupsafe-3.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:d53197da72cc091b024dd97249dfc7794d6a56530370992a5e1a08983ad9230e", size = 11615 }, + { url = "https://files.pythonhosted.org/packages/9a/81/7e4e08678a1f98521201c3079f77db69fb552acd56067661f8c2f534a718/markupsafe-3.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:1872df69a4de6aead3491198eaf13810b565bdbeec3ae2dc8780f14458ec73ce", size = 12020 }, + { url = "https://files.pythonhosted.org/packages/1e/2c/799f4742efc39633a1b54a92eec4082e4f815314869865d876824c257c1e/markupsafe-3.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3a7e8ae81ae39e62a41ec302f972ba6ae23a5c5396c8e60113e9066ef893da0d", size = 24332 }, + { url = "https://files.pythonhosted.org/packages/3c/2e/8d0c2ab90a8c1d9a24f0399058ab8519a3279d1bd4289511d74e909f060e/markupsafe-3.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d6dd0be5b5b189d31db7cda48b91d7e0a9795f31430b7f271219ab30f1d3ac9d", size = 22947 }, + { url = "https://files.pythonhosted.org/packages/2c/54/887f3092a85238093a0b2154bd629c89444f395618842e8b0c41783898ea/markupsafe-3.0.3-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:94c6f0bb423f739146aec64595853541634bde58b2135f27f61c1ffd1cd4d16a", size = 21962 }, + { url = "https://files.pythonhosted.org/packages/c9/2f/336b8c7b6f4a4d95e91119dc8521402461b74a485558d8f238a68312f11c/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:be8813b57049a7dc738189df53d69395eba14fb99345e0a5994914a3864c8a4b", size = 23760 }, + { url = "https://files.pythonhosted.org/packages/32/43/67935f2b7e4982ffb50a4d169b724d74b62a3964bc1a9a527f5ac4f1ee2b/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:83891d0e9fb81a825d9a6d61e3f07550ca70a076484292a70fde82c4b807286f", size = 21529 }, + { url = "https://files.pythonhosted.org/packages/89/e0/4486f11e51bbba8b0c041098859e869e304d1c261e59244baa3d295d47b7/markupsafe-3.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:77f0643abe7495da77fb436f50f8dab76dbc6e5fd25d39589a0f1fe6548bfa2b", size = 23015 }, + { url = "https://files.pythonhosted.org/packages/2f/e1/78ee7a023dac597a5825441ebd17170785a9dab23de95d2c7508ade94e0e/markupsafe-3.0.3-cp312-cp312-win32.whl", hash = "sha256:d88b440e37a16e651bda4c7c2b930eb586fd15ca7406cb39e211fcff3bf3017d", size = 14540 }, + { url = "https://files.pythonhosted.org/packages/aa/5b/bec5aa9bbbb2c946ca2733ef9c4ca91c91b6a24580193e891b5f7dbe8e1e/markupsafe-3.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:26a5784ded40c9e318cfc2bdb30fe164bdb8665ded9cd64d500a34fb42067b1c", size = 15105 }, + { url = "https://files.pythonhosted.org/packages/e5/f1/216fc1bbfd74011693a4fd837e7026152e89c4bcf3e77b6692fba9923123/markupsafe-3.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:35add3b638a5d900e807944a078b51922212fb3dedb01633a8defc4b01a3c85f", size = 13906 }, + { url = "https://files.pythonhosted.org/packages/38/2f/907b9c7bbba283e68f20259574b13d005c121a0fa4c175f9bed27c4597ff/markupsafe-3.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:e1cf1972137e83c5d4c136c43ced9ac51d0e124706ee1c8aa8532c1287fa8795", size = 11622 }, + { url = "https://files.pythonhosted.org/packages/9c/d9/5f7756922cdd676869eca1c4e3c0cd0df60ed30199ffd775e319089cb3ed/markupsafe-3.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:116bb52f642a37c115f517494ea5feb03889e04df47eeff5b130b1808ce7c219", size = 12029 }, + { url = "https://files.pythonhosted.org/packages/00/07/575a68c754943058c78f30db02ee03a64b3c638586fba6a6dd56830b30a3/markupsafe-3.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:133a43e73a802c5562be9bbcd03d090aa5a1fe899db609c29e8c8d815c5f6de6", size = 24374 }, + { url = "https://files.pythonhosted.org/packages/a9/21/9b05698b46f218fc0e118e1f8168395c65c8a2c750ae2bab54fc4bd4e0e8/markupsafe-3.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ccfcd093f13f0f0b7fdd0f198b90053bf7b2f02a3927a30e63f3ccc9df56b676", size = 22980 }, + { url = "https://files.pythonhosted.org/packages/7f/71/544260864f893f18b6827315b988c146b559391e6e7e8f7252839b1b846a/markupsafe-3.0.3-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:509fa21c6deb7a7a273d629cf5ec029bc209d1a51178615ddf718f5918992ab9", size = 21990 }, + { url = "https://files.pythonhosted.org/packages/c2/28/b50fc2f74d1ad761af2f5dcce7492648b983d00a65b8c0e0cb457c82ebbe/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a4afe79fb3de0b7097d81da19090f4df4f8d3a2b3adaa8764138aac2e44f3af1", size = 23784 }, + { url = "https://files.pythonhosted.org/packages/ed/76/104b2aa106a208da8b17a2fb72e033a5a9d7073c68f7e508b94916ed47a9/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:795e7751525cae078558e679d646ae45574b47ed6e7771863fcc079a6171a0fc", size = 21588 }, + { url = "https://files.pythonhosted.org/packages/b5/99/16a5eb2d140087ebd97180d95249b00a03aa87e29cc224056274f2e45fd6/markupsafe-3.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:8485f406a96febb5140bfeca44a73e3ce5116b2501ac54fe953e488fb1d03b12", size = 23041 }, + { url = "https://files.pythonhosted.org/packages/19/bc/e7140ed90c5d61d77cea142eed9f9c303f4c4806f60a1044c13e3f1471d0/markupsafe-3.0.3-cp313-cp313-win32.whl", hash = "sha256:bdd37121970bfd8be76c5fb069c7751683bdf373db1ed6c010162b2a130248ed", size = 14543 }, + { url = "https://files.pythonhosted.org/packages/05/73/c4abe620b841b6b791f2edc248f556900667a5a1cf023a6646967ae98335/markupsafe-3.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:9a1abfdc021a164803f4d485104931fb8f8c1efd55bc6b748d2f5774e78b62c5", size = 15113 }, + { url = "https://files.pythonhosted.org/packages/f0/3a/fa34a0f7cfef23cf9500d68cb7c32dd64ffd58a12b09225fb03dd37d5b80/markupsafe-3.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:7e68f88e5b8799aa49c85cd116c932a1ac15caaa3f5db09087854d218359e485", size = 13911 }, + { url = "https://files.pythonhosted.org/packages/e4/d7/e05cd7efe43a88a17a37b3ae96e79a19e846f3f456fe79c57ca61356ef01/markupsafe-3.0.3-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:218551f6df4868a8d527e3062d0fb968682fe92054e89978594c28e642c43a73", size = 11658 }, + { url = "https://files.pythonhosted.org/packages/99/9e/e412117548182ce2148bdeacdda3bb494260c0b0184360fe0d56389b523b/markupsafe-3.0.3-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:3524b778fe5cfb3452a09d31e7b5adefeea8c5be1d43c4f810ba09f2ceb29d37", size = 12066 }, + { url = "https://files.pythonhosted.org/packages/bc/e6/fa0ffcda717ef64a5108eaa7b4f5ed28d56122c9a6d70ab8b72f9f715c80/markupsafe-3.0.3-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4e885a3d1efa2eadc93c894a21770e4bc67899e3543680313b09f139e149ab19", size = 25639 }, + { url = "https://files.pythonhosted.org/packages/96/ec/2102e881fe9d25fc16cb4b25d5f5cde50970967ffa5dddafdb771237062d/markupsafe-3.0.3-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8709b08f4a89aa7586de0aadc8da56180242ee0ada3999749b183aa23df95025", size = 23569 }, + { url = "https://files.pythonhosted.org/packages/4b/30/6f2fce1f1f205fc9323255b216ca8a235b15860c34b6798f810f05828e32/markupsafe-3.0.3-cp313-cp313t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:b8512a91625c9b3da6f127803b166b629725e68af71f8184ae7e7d54686a56d6", size = 23284 }, + { url = "https://files.pythonhosted.org/packages/58/47/4a0ccea4ab9f5dcb6f79c0236d954acb382202721e704223a8aafa38b5c8/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:9b79b7a16f7fedff2495d684f2b59b0457c3b493778c9eed31111be64d58279f", size = 24801 }, + { url = "https://files.pythonhosted.org/packages/6a/70/3780e9b72180b6fecb83a4814d84c3bf4b4ae4bf0b19c27196104149734c/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_riscv64.whl", hash = "sha256:12c63dfb4a98206f045aa9563db46507995f7ef6d83b2f68eda65c307c6829eb", size = 22769 }, + { url = "https://files.pythonhosted.org/packages/98/c5/c03c7f4125180fc215220c035beac6b9cb684bc7a067c84fc69414d315f5/markupsafe-3.0.3-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:8f71bc33915be5186016f675cd83a1e08523649b0e33efdb898db577ef5bb009", size = 23642 }, + { url = "https://files.pythonhosted.org/packages/80/d6/2d1b89f6ca4bff1036499b1e29a1d02d282259f3681540e16563f27ebc23/markupsafe-3.0.3-cp313-cp313t-win32.whl", hash = "sha256:69c0b73548bc525c8cb9a251cddf1931d1db4d2258e9599c28c07ef3580ef354", size = 14612 }, + { url = "https://files.pythonhosted.org/packages/2b/98/e48a4bfba0a0ffcf9925fe2d69240bfaa19c6f7507b8cd09c70684a53c1e/markupsafe-3.0.3-cp313-cp313t-win_amd64.whl", hash = "sha256:1b4b79e8ebf6b55351f0d91fe80f893b4743f104bff22e90697db1590e47a218", size = 15200 }, + { url = "https://files.pythonhosted.org/packages/0e/72/e3cc540f351f316e9ed0f092757459afbc595824ca724cbc5a5d4263713f/markupsafe-3.0.3-cp313-cp313t-win_arm64.whl", hash = "sha256:ad2cf8aa28b8c020ab2fc8287b0f823d0a7d8630784c31e9ee5edea20f406287", size = 13973 }, + { url = "https://files.pythonhosted.org/packages/33/8a/8e42d4838cd89b7dde187011e97fe6c3af66d8c044997d2183fbd6d31352/markupsafe-3.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:eaa9599de571d72e2daf60164784109f19978b327a3910d3e9de8c97b5b70cfe", size = 11619 }, + { url = "https://files.pythonhosted.org/packages/b5/64/7660f8a4a8e53c924d0fa05dc3a55c9cee10bbd82b11c5afb27d44b096ce/markupsafe-3.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c47a551199eb8eb2121d4f0f15ae0f923d31350ab9280078d1e5f12b249e0026", size = 12029 }, + { url = "https://files.pythonhosted.org/packages/da/ef/e648bfd021127bef5fa12e1720ffed0c6cbb8310c8d9bea7266337ff06de/markupsafe-3.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f34c41761022dd093b4b6896d4810782ffbabe30f2d443ff5f083e0cbbb8c737", size = 24408 }, + { url = "https://files.pythonhosted.org/packages/41/3c/a36c2450754618e62008bf7435ccb0f88053e07592e6028a34776213d877/markupsafe-3.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:457a69a9577064c05a97c41f4e65148652db078a3a509039e64d3467b9e7ef97", size = 23005 }, + { url = "https://files.pythonhosted.org/packages/bc/20/b7fdf89a8456b099837cd1dc21974632a02a999ec9bf7ca3e490aacd98e7/markupsafe-3.0.3-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:e8afc3f2ccfa24215f8cb28dcf43f0113ac3c37c2f0f0806d8c70e4228c5cf4d", size = 22048 }, + { url = "https://files.pythonhosted.org/packages/9a/a7/591f592afdc734f47db08a75793a55d7fbcc6902a723ae4cfbab61010cc5/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:ec15a59cf5af7be74194f7ab02d0f59a62bdcf1a537677ce67a2537c9b87fcda", size = 23821 }, + { url = "https://files.pythonhosted.org/packages/7d/33/45b24e4f44195b26521bc6f1a82197118f74df348556594bd2262bda1038/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:0eb9ff8191e8498cca014656ae6b8d61f39da5f95b488805da4bb029cccbfbaf", size = 21606 }, + { url = "https://files.pythonhosted.org/packages/ff/0e/53dfaca23a69fbfbbf17a4b64072090e70717344c52eaaaa9c5ddff1e5f0/markupsafe-3.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:2713baf880df847f2bece4230d4d094280f4e67b1e813eec43b4c0e144a34ffe", size = 23043 }, + { url = "https://files.pythonhosted.org/packages/46/11/f333a06fc16236d5238bfe74daccbca41459dcd8d1fa952e8fbd5dccfb70/markupsafe-3.0.3-cp314-cp314-win32.whl", hash = "sha256:729586769a26dbceff69f7a7dbbf59ab6572b99d94576a5592625d5b411576b9", size = 14747 }, + { url = "https://files.pythonhosted.org/packages/28/52/182836104b33b444e400b14f797212f720cbc9ed6ba34c800639d154e821/markupsafe-3.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:bdc919ead48f234740ad807933cdf545180bfbe9342c2bb451556db2ed958581", size = 15341 }, + { url = "https://files.pythonhosted.org/packages/6f/18/acf23e91bd94fd7b3031558b1f013adfa21a8e407a3fdb32745538730382/markupsafe-3.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:5a7d5dc5140555cf21a6fefbdbf8723f06fcd2f63ef108f2854de715e4422cb4", size = 14073 }, + { url = "https://files.pythonhosted.org/packages/3c/f0/57689aa4076e1b43b15fdfa646b04653969d50cf30c32a102762be2485da/markupsafe-3.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:1353ef0c1b138e1907ae78e2f6c63ff67501122006b0f9abad68fda5f4ffc6ab", size = 11661 }, + { url = "https://files.pythonhosted.org/packages/89/c3/2e67a7ca217c6912985ec766c6393b636fb0c2344443ff9d91404dc4c79f/markupsafe-3.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:1085e7fbddd3be5f89cc898938f42c0b3c711fdcb37d75221de2666af647c175", size = 12069 }, + { url = "https://files.pythonhosted.org/packages/f0/00/be561dce4e6ca66b15276e184ce4b8aec61fe83662cce2f7d72bd3249d28/markupsafe-3.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1b52b4fb9df4eb9ae465f8d0c228a00624de2334f216f178a995ccdcf82c4634", size = 25670 }, + { url = "https://files.pythonhosted.org/packages/50/09/c419f6f5a92e5fadde27efd190eca90f05e1261b10dbd8cbcb39cd8ea1dc/markupsafe-3.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:fed51ac40f757d41b7c48425901843666a6677e3e8eb0abcff09e4ba6e664f50", size = 23598 }, + { url = "https://files.pythonhosted.org/packages/22/44/a0681611106e0b2921b3033fc19bc53323e0b50bc70cffdd19f7d679bb66/markupsafe-3.0.3-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:f190daf01f13c72eac4efd5c430a8de82489d9cff23c364c3ea822545032993e", size = 23261 }, + { url = "https://files.pythonhosted.org/packages/5f/57/1b0b3f100259dc9fffe780cfb60d4be71375510e435efec3d116b6436d43/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:e56b7d45a839a697b5eb268c82a71bd8c7f6c94d6fd50c3d577fa39a9f1409f5", size = 24835 }, + { url = "https://files.pythonhosted.org/packages/26/6a/4bf6d0c97c4920f1597cc14dd720705eca0bf7c787aebc6bb4d1bead5388/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:f3e98bb3798ead92273dc0e5fd0f31ade220f59a266ffd8a4f6065e0a3ce0523", size = 22733 }, + { url = "https://files.pythonhosted.org/packages/14/c7/ca723101509b518797fedc2fdf79ba57f886b4aca8a7d31857ba3ee8281f/markupsafe-3.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:5678211cb9333a6468fb8d8be0305520aa073f50d17f089b5b4b477ea6e67fdc", size = 23672 }, + { url = "https://files.pythonhosted.org/packages/fb/df/5bd7a48c256faecd1d36edc13133e51397e41b73bb77e1a69deab746ebac/markupsafe-3.0.3-cp314-cp314t-win32.whl", hash = "sha256:915c04ba3851909ce68ccc2b8e2cd691618c4dc4c4232fb7982bca3f41fd8c3d", size = 14819 }, + { url = "https://files.pythonhosted.org/packages/1a/8a/0402ba61a2f16038b48b39bccca271134be00c5c9f0f623208399333c448/markupsafe-3.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4faffd047e07c38848ce017e8725090413cd80cbc23d86e55c587bf979e579c9", size = 15426 }, + { url = "https://files.pythonhosted.org/packages/70/bc/6f1c2f612465f5fa89b95bead1f44dcb607670fd42891d8fdcd5d039f4f4/markupsafe-3.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:32001d6a8fc98c8cb5c947787c5d08b0a50663d139f1305bac5885d98d9b40fa", size = 14146 }, +] + +[[package]] +name = "mergedeep" +version = "1.3.4" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/3a/41/580bb4006e3ed0361b8151a01d324fb03f420815446c7def45d02f74c270/mergedeep-1.3.4.tar.gz", hash = "sha256:0096d52e9dad9939c3d975a774666af186eda617e6ca84df4c94dec30004f2a8", size = 4661 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/2c/19/04f9b178c2d8a15b076c8b5140708fa6ffc5601fb6f1e975537072df5b2a/mergedeep-1.3.4-py3-none-any.whl", hash = "sha256:70775750742b25c0d8f36c55aed03d24c3384d17c951b3175d898bd778ef0307", size = 6354 }, +] + +[[package]] +name = "mkdocs" +version = "1.6.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "click" }, + { name = "colorama", marker = "sys_platform == 'win32'" }, + { name = "ghp-import" }, + { name = "jinja2" }, + { name = "markdown" }, + { name = "markupsafe" }, + { name = "mergedeep" }, + { name = "mkdocs-get-deps" }, + { name = "packaging" }, + { name = "pathspec" }, + { name = "pyyaml" }, + { name = "pyyaml-env-tag" }, + { name = "watchdog" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/bc/c6/bbd4f061bd16b378247f12953ffcb04786a618ce5e904b8c5a01a0309061/mkdocs-1.6.1.tar.gz", hash = "sha256:7b432f01d928c084353ab39c57282f29f92136665bdd6abf7c1ec8d822ef86f2", size = 3889159 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/22/5b/dbc6a8cddc9cfa9c4971d59fb12bb8d42e161b7e7f8cc89e49137c5b279c/mkdocs-1.6.1-py3-none-any.whl", hash = "sha256:db91759624d1647f3f34aa0c3f327dd2601beae39a366d6e064c03468d35c20e", size = 3864451 }, +] + +[[package]] +name = "mkdocs-get-deps" +version = "0.2.2" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "mergedeep" }, + { name = "platformdirs" }, + { name = "pyyaml" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/ce/25/b3cccb187655b9393572bde9b09261d267c3bf2f2cdabe347673be5976a6/mkdocs_get_deps-0.2.2.tar.gz", hash = "sha256:8ee8d5f316cdbbb2834bc1df6e69c08fe769a83e040060de26d3c19fad3599a1", size = 11047 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/88/29/744136411e785c4b0b744d5413e56555265939ab3a104c6a4b719dad33fd/mkdocs_get_deps-0.2.2-py3-none-any.whl", hash = "sha256:e7878cbeac04860b8b5e0ca31d3abad3df9411a75a32cde82f8e44b6c16ff650", size = 9555 }, +] + +[[package]] +name = "mkdocs-mermaid2-plugin" +version = "1.2.3" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "beautifulsoup4" }, + { name = "jsbeautifier" }, + { name = "mkdocs" }, + { name = "pymdown-extensions" }, + { name = "requests" }, + { name = "setuptools" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/2a/6d/308f443a558b6a97ce55782658174c0d07c414405cfc0a44d36ad37e36f9/mkdocs_mermaid2_plugin-1.2.3.tar.gz", hash = "sha256:fb6f901d53e5191e93db78f93f219cad926ccc4d51e176271ca5161b6cc5368c", size = 16220 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/1a/4b/6fd6dd632019b7f522f1b1f794ab6115cd79890330986614be56fd18f0eb/mkdocs_mermaid2_plugin-1.2.3-py3-none-any.whl", hash = "sha256:33f60c582be623ed53829a96e19284fc7f1b74a1dbae78d4d2e47fe00c3e190d", size = 17299 }, +] + +[[package]] +name = "packaging" +version = "26.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/65/ee/299d360cdc32edc7d2cf530f3accf79c4fca01e96ffc950d8a52213bd8e4/packaging-26.0.tar.gz", hash = "sha256:00243ae351a257117b6a241061796684b084ed1c516a08c48a3f7e147a9d80b4", size = 143416 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/b7/b9/c538f279a4e237a006a2c98387d081e9eb060d203d8ed34467cc0f0b9b53/packaging-26.0-py3-none-any.whl", hash = "sha256:b36f1fef9334a5588b4166f8bcd26a14e521f2b55e6b9de3aaa80d3ff7a37529", size = 74366 }, +] + +[[package]] +name = "pathspec" +version = "1.0.4" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/fa/36/e27608899f9b8d4dff0617b2d9ab17ca5608956ca44461ac14ac48b44015/pathspec-1.0.4.tar.gz", hash = "sha256:0210e2ae8a21a9137c0d470578cb0e595af87edaa6ebf12ff176f14a02e0e645", size = 131200 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/ef/3c/2c197d226f9ea224a9ab8d197933f9da0ae0aac5b6e0f884e2b8d9c8e9f7/pathspec-1.0.4-py3-none-any.whl", hash = "sha256:fb6ae2fd4e7c921a165808a552060e722767cfa526f99ca5156ed2ce45a5c723", size = 55206 }, +] + +[[package]] +name = "platformdirs" +version = "4.9.4" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/19/56/8d4c30c8a1d07013911a8fdbd8f89440ef9f08d07a1b50ab8ca8be5a20f9/platformdirs-4.9.4.tar.gz", hash = "sha256:1ec356301b7dc906d83f371c8f487070e99d3ccf9e501686456394622a01a934", size = 28737 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/63/d7/97f7e3a6abb67d8080dd406fd4df842c2be0efaf712d1c899c32a075027c/platformdirs-4.9.4-py3-none-any.whl", hash = "sha256:68a9a4619a666ea6439f2ff250c12a853cd1cbd5158d258bd824a7df6be2f868", size = 21216 }, +] + +[[package]] +name = "pymdown-extensions" +version = "10.21" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "markdown" }, + { name = "pyyaml" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/ba/63/06673d1eb6d8f83c0ea1f677d770e12565fb516928b4109c9e2055656a9e/pymdown_extensions-10.21.tar.gz", hash = "sha256:39f4a020f40773f6b2ff31d2cd2546c2c04d0a6498c31d9c688d2be07e1767d5", size = 853363 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/6f/2c/5b079febdc65e1c3fb2729bf958d18b45be7113828528e8a0b5850dd819a/pymdown_extensions-10.21-py3-none-any.whl", hash = "sha256:91b879f9f864d49794c2d9534372b10150e6141096c3908a455e45ca72ad9d3f", size = 268877 }, +] + +[[package]] +name = "python-dateutil" +version = "2.9.0.post0" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "six" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/66/c0/0c8b6ad9f17a802ee498c46e004a0eb49bc148f2fd230864601a86dcf6db/python-dateutil-2.9.0.post0.tar.gz", hash = "sha256:37dd54208da7e1cd875388217d5e00ebd4179249f90fb72437e91a35459a0ad3", size = 342432 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/ec/57/56b9bcc3c9c6a792fcbaf139543cee77261f3651ca9da0c93f5c1221264b/python_dateutil-2.9.0.post0-py2.py3-none-any.whl", hash = "sha256:a8b2bc7bffae282281c8140a97d3aa9c14da0b136dfe83f850eea9a5f7470427", size = 229892 }, +] + +[[package]] +name = "pyyaml" +version = "6.0.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/05/8e/961c0007c59b8dd7729d542c61a4d537767a59645b82a0b521206e1e25c2/pyyaml-6.0.3.tar.gz", hash = "sha256:d76623373421df22fb4cf8817020cbb7ef15c725b9d5e45f17e189bfc384190f", size = 130960 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/f4/a0/39350dd17dd6d6c6507025c0e53aef67a9293a6d37d3511f23ea510d5800/pyyaml-6.0.3-cp310-cp310-macosx_10_13_x86_64.whl", hash = "sha256:214ed4befebe12df36bcc8bc2b64b396ca31be9304b8f59e25c11cf94a4c033b", size = 184227 }, + { url = "https://files.pythonhosted.org/packages/05/14/52d505b5c59ce73244f59c7a50ecf47093ce4765f116cdb98286a71eeca2/pyyaml-6.0.3-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:02ea2dfa234451bbb8772601d7b8e426c2bfa197136796224e50e35a78777956", size = 174019 }, + { url = "https://files.pythonhosted.org/packages/43/f7/0e6a5ae5599c838c696adb4e6330a59f463265bfa1e116cfd1fbb0abaaae/pyyaml-6.0.3-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b30236e45cf30d2b8e7b3e85881719e98507abed1011bf463a8fa23e9c3e98a8", size = 740646 }, + { url = "https://files.pythonhosted.org/packages/2f/3a/61b9db1d28f00f8fd0ae760459a5c4bf1b941baf714e207b6eb0657d2578/pyyaml-6.0.3-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:66291b10affd76d76f54fad28e22e51719ef9ba22b29e1d7d03d6777a9174198", size = 840793 }, + { url = "https://files.pythonhosted.org/packages/7a/1e/7acc4f0e74c4b3d9531e24739e0ab832a5edf40e64fbae1a9c01941cabd7/pyyaml-6.0.3-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9c7708761fccb9397fe64bbc0395abcae8c4bf7b0eac081e12b809bf47700d0b", size = 770293 }, + { url = "https://files.pythonhosted.org/packages/8b/ef/abd085f06853af0cd59fa5f913d61a8eab65d7639ff2a658d18a25d6a89d/pyyaml-6.0.3-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:418cf3f2111bc80e0933b2cd8cd04f286338bb88bdc7bc8e6dd775ebde60b5e0", size = 732872 }, + { url = "https://files.pythonhosted.org/packages/1f/15/2bc9c8faf6450a8b3c9fc5448ed869c599c0a74ba2669772b1f3a0040180/pyyaml-6.0.3-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:5e0b74767e5f8c593e8c9b5912019159ed0533c70051e9cce3e8b6aa699fcd69", size = 758828 }, + { url = "https://files.pythonhosted.org/packages/a3/00/531e92e88c00f4333ce359e50c19b8d1de9fe8d581b1534e35ccfbc5f393/pyyaml-6.0.3-cp310-cp310-win32.whl", hash = "sha256:28c8d926f98f432f88adc23edf2e6d4921ac26fb084b028c733d01868d19007e", size = 142415 }, + { url = "https://files.pythonhosted.org/packages/2a/fa/926c003379b19fca39dd4634818b00dec6c62d87faf628d1394e137354d4/pyyaml-6.0.3-cp310-cp310-win_amd64.whl", hash = "sha256:bdb2c67c6c1390b63c6ff89f210c8fd09d9a1217a465701eac7316313c915e4c", size = 158561 }, + { url = "https://files.pythonhosted.org/packages/6d/16/a95b6757765b7b031c9374925bb718d55e0a9ba8a1b6a12d25962ea44347/pyyaml-6.0.3-cp311-cp311-macosx_10_13_x86_64.whl", hash = "sha256:44edc647873928551a01e7a563d7452ccdebee747728c1080d881d68af7b997e", size = 185826 }, + { url = "https://files.pythonhosted.org/packages/16/19/13de8e4377ed53079ee996e1ab0a9c33ec2faf808a4647b7b4c0d46dd239/pyyaml-6.0.3-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:652cb6edd41e718550aad172851962662ff2681490a8a711af6a4d288dd96824", size = 175577 }, + { url = "https://files.pythonhosted.org/packages/0c/62/d2eb46264d4b157dae1275b573017abec435397aa59cbcdab6fc978a8af4/pyyaml-6.0.3-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:10892704fc220243f5305762e276552a0395f7beb4dbf9b14ec8fd43b57f126c", size = 775556 }, + { url = "https://files.pythonhosted.org/packages/10/cb/16c3f2cf3266edd25aaa00d6c4350381c8b012ed6f5276675b9eba8d9ff4/pyyaml-6.0.3-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:850774a7879607d3a6f50d36d04f00ee69e7fc816450e5f7e58d7f17f1ae5c00", size = 882114 }, + { url = "https://files.pythonhosted.org/packages/71/60/917329f640924b18ff085ab889a11c763e0b573da888e8404ff486657602/pyyaml-6.0.3-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b8bb0864c5a28024fac8a632c443c87c5aa6f215c0b126c449ae1a150412f31d", size = 806638 }, + { url = "https://files.pythonhosted.org/packages/dd/6f/529b0f316a9fd167281a6c3826b5583e6192dba792dd55e3203d3f8e655a/pyyaml-6.0.3-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:1d37d57ad971609cf3c53ba6a7e365e40660e3be0e5175fa9f2365a379d6095a", size = 767463 }, + { url = "https://files.pythonhosted.org/packages/f2/6a/b627b4e0c1dd03718543519ffb2f1deea4a1e6d42fbab8021936a4d22589/pyyaml-6.0.3-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:37503bfbfc9d2c40b344d06b2199cf0e96e97957ab1c1b546fd4f87e53e5d3e4", size = 794986 }, + { url = "https://files.pythonhosted.org/packages/45/91/47a6e1c42d9ee337c4839208f30d9f09caa9f720ec7582917b264defc875/pyyaml-6.0.3-cp311-cp311-win32.whl", hash = "sha256:8098f252adfa6c80ab48096053f512f2321f0b998f98150cea9bd23d83e1467b", size = 142543 }, + { url = "https://files.pythonhosted.org/packages/da/e3/ea007450a105ae919a72393cb06f122f288ef60bba2dc64b26e2646fa315/pyyaml-6.0.3-cp311-cp311-win_amd64.whl", hash = "sha256:9f3bfb4965eb874431221a3ff3fdcddc7e74e3b07799e0e84ca4a0f867d449bf", size = 158763 }, + { url = "https://files.pythonhosted.org/packages/d1/33/422b98d2195232ca1826284a76852ad5a86fe23e31b009c9886b2d0fb8b2/pyyaml-6.0.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:7f047e29dcae44602496db43be01ad42fc6f1cc0d8cd6c83d342306c32270196", size = 182063 }, + { url = "https://files.pythonhosted.org/packages/89/a0/6cf41a19a1f2f3feab0e9c0b74134aa2ce6849093d5517a0c550fe37a648/pyyaml-6.0.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:fc09d0aa354569bc501d4e787133afc08552722d3ab34836a80547331bb5d4a0", size = 173973 }, + { url = "https://files.pythonhosted.org/packages/ed/23/7a778b6bd0b9a8039df8b1b1d80e2e2ad78aa04171592c8a5c43a56a6af4/pyyaml-6.0.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9149cad251584d5fb4981be1ecde53a1ca46c891a79788c0df828d2f166bda28", size = 775116 }, + { url = "https://files.pythonhosted.org/packages/65/30/d7353c338e12baef4ecc1b09e877c1970bd3382789c159b4f89d6a70dc09/pyyaml-6.0.3-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5fdec68f91a0c6739b380c83b951e2c72ac0197ace422360e6d5a959d8d97b2c", size = 844011 }, + { url = "https://files.pythonhosted.org/packages/8b/9d/b3589d3877982d4f2329302ef98a8026e7f4443c765c46cfecc8858c6b4b/pyyaml-6.0.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ba1cc08a7ccde2d2ec775841541641e4548226580ab850948cbfda66a1befcdc", size = 807870 }, + { url = "https://files.pythonhosted.org/packages/05/c0/b3be26a015601b822b97d9149ff8cb5ead58c66f981e04fedf4e762f4bd4/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:8dc52c23056b9ddd46818a57b78404882310fb473d63f17b07d5c40421e47f8e", size = 761089 }, + { url = "https://files.pythonhosted.org/packages/be/8e/98435a21d1d4b46590d5459a22d88128103f8da4c2d4cb8f14f2a96504e1/pyyaml-6.0.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:41715c910c881bc081f1e8872880d3c650acf13dfa8214bad49ed4cede7c34ea", size = 790181 }, + { url = "https://files.pythonhosted.org/packages/74/93/7baea19427dcfbe1e5a372d81473250b379f04b1bd3c4c5ff825e2327202/pyyaml-6.0.3-cp312-cp312-win32.whl", hash = "sha256:96b533f0e99f6579b3d4d4995707cf36df9100d67e0c8303a0c55b27b5f99bc5", size = 137658 }, + { url = "https://files.pythonhosted.org/packages/86/bf/899e81e4cce32febab4fb42bb97dcdf66bc135272882d1987881a4b519e9/pyyaml-6.0.3-cp312-cp312-win_amd64.whl", hash = "sha256:5fcd34e47f6e0b794d17de1b4ff496c00986e1c83f7ab2fb8fcfe9616ff7477b", size = 154003 }, + { url = "https://files.pythonhosted.org/packages/1a/08/67bd04656199bbb51dbed1439b7f27601dfb576fb864099c7ef0c3e55531/pyyaml-6.0.3-cp312-cp312-win_arm64.whl", hash = "sha256:64386e5e707d03a7e172c0701abfb7e10f0fb753ee1d773128192742712a98fd", size = 140344 }, + { url = "https://files.pythonhosted.org/packages/d1/11/0fd08f8192109f7169db964b5707a2f1e8b745d4e239b784a5a1dd80d1db/pyyaml-6.0.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:8da9669d359f02c0b91ccc01cac4a67f16afec0dac22c2ad09f46bee0697eba8", size = 181669 }, + { url = "https://files.pythonhosted.org/packages/b1/16/95309993f1d3748cd644e02e38b75d50cbc0d9561d21f390a76242ce073f/pyyaml-6.0.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:2283a07e2c21a2aa78d9c4442724ec1eb15f5e42a723b99cb3d822d48f5f7ad1", size = 173252 }, + { url = "https://files.pythonhosted.org/packages/50/31/b20f376d3f810b9b2371e72ef5adb33879b25edb7a6d072cb7ca0c486398/pyyaml-6.0.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ee2922902c45ae8ccada2c5b501ab86c36525b883eff4255313a253a3160861c", size = 767081 }, + { url = "https://files.pythonhosted.org/packages/49/1e/a55ca81e949270d5d4432fbbd19dfea5321eda7c41a849d443dc92fd1ff7/pyyaml-6.0.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a33284e20b78bd4a18c8c2282d549d10bc8408a2a7ff57653c0cf0b9be0afce5", size = 841159 }, + { url = "https://files.pythonhosted.org/packages/74/27/e5b8f34d02d9995b80abcef563ea1f8b56d20134d8f4e5e81733b1feceb2/pyyaml-6.0.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0f29edc409a6392443abf94b9cf89ce99889a1dd5376d94316ae5145dfedd5d6", size = 801626 }, + { url = "https://files.pythonhosted.org/packages/f9/11/ba845c23988798f40e52ba45f34849aa8a1f2d4af4b798588010792ebad6/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f7057c9a337546edc7973c0d3ba84ddcdf0daa14533c2065749c9075001090e6", size = 753613 }, + { url = "https://files.pythonhosted.org/packages/3d/e0/7966e1a7bfc0a45bf0a7fb6b98ea03fc9b8d84fa7f2229e9659680b69ee3/pyyaml-6.0.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:eda16858a3cab07b80edaf74336ece1f986ba330fdb8ee0d6c0d68fe82bc96be", size = 794115 }, + { url = "https://files.pythonhosted.org/packages/de/94/980b50a6531b3019e45ddeada0626d45fa85cbe22300844a7983285bed3b/pyyaml-6.0.3-cp313-cp313-win32.whl", hash = "sha256:d0eae10f8159e8fdad514efdc92d74fd8d682c933a6dd088030f3834bc8e6b26", size = 137427 }, + { url = "https://files.pythonhosted.org/packages/97/c9/39d5b874e8b28845e4ec2202b5da735d0199dbe5b8fb85f91398814a9a46/pyyaml-6.0.3-cp313-cp313-win_amd64.whl", hash = "sha256:79005a0d97d5ddabfeeea4cf676af11e647e41d81c9a7722a193022accdb6b7c", size = 154090 }, + { url = "https://files.pythonhosted.org/packages/73/e8/2bdf3ca2090f68bb3d75b44da7bbc71843b19c9f2b9cb9b0f4ab7a5a4329/pyyaml-6.0.3-cp313-cp313-win_arm64.whl", hash = "sha256:5498cd1645aa724a7c71c8f378eb29ebe23da2fc0d7a08071d89469bf1d2defb", size = 140246 }, + { url = "https://files.pythonhosted.org/packages/9d/8c/f4bd7f6465179953d3ac9bc44ac1a8a3e6122cf8ada906b4f96c60172d43/pyyaml-6.0.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:8d1fab6bb153a416f9aeb4b8763bc0f22a5586065f86f7664fc23339fc1c1fac", size = 181814 }, + { url = "https://files.pythonhosted.org/packages/bd/9c/4d95bb87eb2063d20db7b60faa3840c1b18025517ae857371c4dd55a6b3a/pyyaml-6.0.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:34d5fcd24b8445fadc33f9cf348c1047101756fd760b4dacb5c3e99755703310", size = 173809 }, + { url = "https://files.pythonhosted.org/packages/92/b5/47e807c2623074914e29dabd16cbbdd4bf5e9b2db9f8090fa64411fc5382/pyyaml-6.0.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:501a031947e3a9025ed4405a168e6ef5ae3126c59f90ce0cd6f2bfc477be31b7", size = 766454 }, + { url = "https://files.pythonhosted.org/packages/02/9e/e5e9b168be58564121efb3de6859c452fccde0ab093d8438905899a3a483/pyyaml-6.0.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:b3bc83488de33889877a0f2543ade9f70c67d66d9ebb4ac959502e12de895788", size = 836355 }, + { url = "https://files.pythonhosted.org/packages/88/f9/16491d7ed2a919954993e48aa941b200f38040928474c9e85ea9e64222c3/pyyaml-6.0.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c458b6d084f9b935061bc36216e8a69a7e293a2f1e68bf956dcd9e6cbcd143f5", size = 794175 }, + { url = "https://files.pythonhosted.org/packages/dd/3f/5989debef34dc6397317802b527dbbafb2b4760878a53d4166579111411e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7c6610def4f163542a622a73fb39f534f8c101d690126992300bf3207eab9764", size = 755228 }, + { url = "https://files.pythonhosted.org/packages/d7/ce/af88a49043cd2e265be63d083fc75b27b6ed062f5f9fd6cdc223ad62f03e/pyyaml-6.0.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5190d403f121660ce8d1d2c1bb2ef1bd05b5f68533fc5c2ea899bd15f4399b35", size = 789194 }, + { url = "https://files.pythonhosted.org/packages/23/20/bb6982b26a40bb43951265ba29d4c246ef0ff59c9fdcdf0ed04e0687de4d/pyyaml-6.0.3-cp314-cp314-win_amd64.whl", hash = "sha256:4a2e8cebe2ff6ab7d1050ecd59c25d4c8bd7e6f400f5f82b96557ac0abafd0ac", size = 156429 }, + { url = "https://files.pythonhosted.org/packages/f4/f4/a4541072bb9422c8a883ab55255f918fa378ecf083f5b85e87fc2b4eda1b/pyyaml-6.0.3-cp314-cp314-win_arm64.whl", hash = "sha256:93dda82c9c22deb0a405ea4dc5f2d0cda384168e466364dec6255b293923b2f3", size = 143912 }, + { url = "https://files.pythonhosted.org/packages/7c/f9/07dd09ae774e4616edf6cda684ee78f97777bdd15847253637a6f052a62f/pyyaml-6.0.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:02893d100e99e03eda1c8fd5c441d8c60103fd175728e23e431db1b589cf5ab3", size = 189108 }, + { url = "https://files.pythonhosted.org/packages/4e/78/8d08c9fb7ce09ad8c38ad533c1191cf27f7ae1effe5bb9400a46d9437fcf/pyyaml-6.0.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:c1ff362665ae507275af2853520967820d9124984e0f7466736aea23d8611fba", size = 183641 }, + { url = "https://files.pythonhosted.org/packages/7b/5b/3babb19104a46945cf816d047db2788bcaf8c94527a805610b0289a01c6b/pyyaml-6.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6adc77889b628398debc7b65c073bcb99c4a0237b248cacaf3fe8a557563ef6c", size = 831901 }, + { url = "https://files.pythonhosted.org/packages/8b/cc/dff0684d8dc44da4d22a13f35f073d558c268780ce3c6ba1b87055bb0b87/pyyaml-6.0.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:a80cb027f6b349846a3bf6d73b5e95e782175e52f22108cfa17876aaeff93702", size = 861132 }, + { url = "https://files.pythonhosted.org/packages/b1/5e/f77dc6b9036943e285ba76b49e118d9ea929885becb0a29ba8a7c75e29fe/pyyaml-6.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:00c4bdeba853cc34e7dd471f16b4114f4162dc03e6b7afcc2128711f0eca823c", size = 839261 }, + { url = "https://files.pythonhosted.org/packages/ce/88/a9db1376aa2a228197c58b37302f284b5617f56a5d959fd1763fb1675ce6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:66e1674c3ef6f541c35191caae2d429b967b99e02040f5ba928632d9a7f0f065", size = 805272 }, + { url = "https://files.pythonhosted.org/packages/da/92/1446574745d74df0c92e6aa4a7b0b3130706a4142b2d1a5869f2eaa423c6/pyyaml-6.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:16249ee61e95f858e83976573de0f5b2893b3677ba71c9dd36b9cf8be9ac6d65", size = 829923 }, + { url = "https://files.pythonhosted.org/packages/f0/7a/1c7270340330e575b92f397352af856a8c06f230aa3e76f86b39d01b416a/pyyaml-6.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:4ad1906908f2f5ae4e5a8ddfce73c320c2a1429ec52eafd27138b7f1cbe341c9", size = 174062 }, + { url = "https://files.pythonhosted.org/packages/f1/12/de94a39c2ef588c7e6455cfbe7343d3b2dc9d6b6b2f40c4c6565744c873d/pyyaml-6.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:ebc55a14a21cb14062aa4162f906cd962b28e2e9ea38f9b4391244cd8de4ae0b", size = 149341 }, +] + +[[package]] +name = "pyyaml-env-tag" +version = "1.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "pyyaml" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/eb/2e/79c822141bfd05a853236b504869ebc6b70159afc570e1d5a20641782eaa/pyyaml_env_tag-1.1.tar.gz", hash = "sha256:2eb38b75a2d21ee0475d6d97ec19c63287a7e140231e4214969d0eac923cd7ff", size = 5737 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/04/11/432f32f8097b03e3cd5fe57e88efb685d964e2e5178a48ed61e841f7fdce/pyyaml_env_tag-1.1-py3-none-any.whl", hash = "sha256:17109e1a528561e32f026364712fee1264bc2ea6715120891174ed1b980d2e04", size = 4722 }, +] + +[[package]] +name = "requests" +version = "2.32.5" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "certifi" }, + { name = "charset-normalizer" }, + { name = "idna" }, + { name = "urllib3" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/c9/74/b3ff8e6c8446842c3f5c837e9c3dfcfe2018ea6ecef224c710c85ef728f4/requests-2.32.5.tar.gz", hash = "sha256:dbba0bac56e100853db0ea71b82b4dfd5fe2bf6d3754a8893c3af500cec7d7cf", size = 134517 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/1e/db/4254e3eabe8020b458f1a747140d32277ec7a271daf1d235b70dc0b4e6e3/requests-2.32.5-py3-none-any.whl", hash = "sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6", size = 64738 }, +] + +[[package]] +name = "score-infrastructure-docs" +version = "0.1.0" +source = { virtual = "." } +dependencies = [ + { name = "mkdocs" }, + { name = "mkdocs-mermaid2-plugin" }, +] + +[package.metadata] +requires-dist = [ + { name = "mkdocs", specifier = ">=1.6,<2.0" }, + { name = "mkdocs-mermaid2-plugin", specifier = ">=1.2,<2.0" }, +] + +[[package]] +name = "setuptools" +version = "82.0.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/4f/db/cfac1baf10650ab4d1c111714410d2fbb77ac5a616db26775db562c8fab2/setuptools-82.0.1.tar.gz", hash = "sha256:7d872682c5d01cfde07da7bccc7b65469d3dca203318515ada1de5eda35efbf9", size = 1152316 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/9d/76/f789f7a86709c6b087c5a2f52f911838cad707cc613162401badc665acfe/setuptools-82.0.1-py3-none-any.whl", hash = "sha256:a59e362652f08dcd477c78bb6e7bd9d80a7995bc73ce773050228a348ce2e5bb", size = 1006223 }, +] + +[[package]] +name = "six" +version = "1.17.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/94/e7/b2c673351809dca68a0e064b6af791aa332cf192da575fd474ed7d6f16a2/six-1.17.0.tar.gz", hash = "sha256:ff70335d468e7eb6ec65b95b99d3a2836546063f63acc5171de367e834932a81", size = 34031 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/b7/ce/149a00dd41f10bc29e5921b496af8b574d8413afcd5e30dfa0ed46c2cc5e/six-1.17.0-py2.py3-none-any.whl", hash = "sha256:4721f391ed90541fddacab5acf947aa0d3dc7d27b2e1e8eda2be8970586c3274", size = 11050 }, +] + +[[package]] +name = "soupsieve" +version = "2.8.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/7b/ae/2d9c981590ed9999a0d91755b47fc74f74de286b0f5cee14c9269041e6c4/soupsieve-2.8.3.tar.gz", hash = "sha256:3267f1eeea4251fb42728b6dfb746edc9acaffc4a45b27e19450b676586e8349", size = 118627 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/46/2c/1462b1d0a634697ae9e55b3cecdcb64788e8b7d63f54d923fcd0bb140aed/soupsieve-2.8.3-py3-none-any.whl", hash = "sha256:ed64f2ba4eebeab06cc4962affce381647455978ffc1e36bb79a545b91f45a95", size = 37016 }, +] + +[[package]] +name = "typing-extensions" +version = "4.15.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614 }, +] + +[[package]] +name = "urllib3" +version = "2.6.3" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/c7/24/5f1b3bdffd70275f6661c76461e25f024d5a38a46f04aaca912426a2b1d3/urllib3-2.6.3.tar.gz", hash = "sha256:1b62b6884944a57dbe321509ab94fd4d3b307075e0c2eae991ac71ee15ad38ed", size = 435556 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/39/08/aaaad47bc4e9dc8c725e68f9d04865dbcb2052843ff09c97b08904852d84/urllib3-2.6.3-py3-none-any.whl", hash = "sha256:bf272323e553dfb2e87d9bfd225ca7b0f467b919d7bbd355436d3fd37cb0acd4", size = 131584 }, +] + +[[package]] +name = "watchdog" +version = "6.0.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/db/7d/7f3d619e951c88ed75c6037b246ddcf2d322812ee8ea189be89511721d54/watchdog-6.0.0.tar.gz", hash = "sha256:9ddf7c82fda3ae8e24decda1338ede66e1c99883db93711d8fb941eaa2d8c282", size = 131220 } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0c/56/90994d789c61df619bfc5ce2ecdabd5eeff564e1eb47512bd01b5e019569/watchdog-6.0.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:d1cdb490583ebd691c012b3d6dae011000fe42edb7a82ece80965b42abd61f26", size = 96390 }, + { url = "https://files.pythonhosted.org/packages/55/46/9a67ee697342ddf3c6daa97e3a587a56d6c4052f881ed926a849fcf7371c/watchdog-6.0.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:bc64ab3bdb6a04d69d4023b29422170b74681784ffb9463ed4870cf2f3e66112", size = 88389 }, + { url = "https://files.pythonhosted.org/packages/44/65/91b0985747c52064d8701e1075eb96f8c40a79df889e59a399453adfb882/watchdog-6.0.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:c897ac1b55c5a1461e16dae288d22bb2e412ba9807df8397a635d88f671d36c3", size = 89020 }, + { url = "https://files.pythonhosted.org/packages/e0/24/d9be5cd6642a6aa68352ded4b4b10fb0d7889cb7f45814fb92cecd35f101/watchdog-6.0.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:6eb11feb5a0d452ee41f824e271ca311a09e250441c262ca2fd7ebcf2461a06c", size = 96393 }, + { url = "https://files.pythonhosted.org/packages/63/7a/6013b0d8dbc56adca7fdd4f0beed381c59f6752341b12fa0886fa7afc78b/watchdog-6.0.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:ef810fbf7b781a5a593894e4f439773830bdecb885e6880d957d5b9382a960d2", size = 88392 }, + { url = "https://files.pythonhosted.org/packages/d1/40/b75381494851556de56281e053700e46bff5b37bf4c7267e858640af5a7f/watchdog-6.0.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:afd0fe1b2270917c5e23c2a65ce50c2a4abb63daafb0d419fde368e272a76b7c", size = 89019 }, + { url = "https://files.pythonhosted.org/packages/39/ea/3930d07dafc9e286ed356a679aa02d777c06e9bfd1164fa7c19c288a5483/watchdog-6.0.0-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:bdd4e6f14b8b18c334febb9c4425a878a2ac20efd1e0b231978e7b150f92a948", size = 96471 }, + { url = "https://files.pythonhosted.org/packages/12/87/48361531f70b1f87928b045df868a9fd4e253d9ae087fa4cf3f7113be363/watchdog-6.0.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:c7c15dda13c4eb00d6fb6fc508b3c0ed88b9d5d374056b239c4ad1611125c860", size = 88449 }, + { url = "https://files.pythonhosted.org/packages/5b/7e/8f322f5e600812e6f9a31b75d242631068ca8f4ef0582dd3ae6e72daecc8/watchdog-6.0.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:6f10cb2d5902447c7d0da897e2c6768bca89174d0c6e1e30abec5421af97a5b0", size = 89054 }, + { url = "https://files.pythonhosted.org/packages/68/98/b0345cabdce2041a01293ba483333582891a3bd5769b08eceb0d406056ef/watchdog-6.0.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:490ab2ef84f11129844c23fb14ecf30ef3d8a6abafd3754a6f75ca1e6654136c", size = 96480 }, + { url = "https://files.pythonhosted.org/packages/85/83/cdf13902c626b28eedef7ec4f10745c52aad8a8fe7eb04ed7b1f111ca20e/watchdog-6.0.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:76aae96b00ae814b181bb25b1b98076d5fc84e8a53cd8885a318b42b6d3a5134", size = 88451 }, + { url = "https://files.pythonhosted.org/packages/fe/c4/225c87bae08c8b9ec99030cd48ae9c4eca050a59bf5c2255853e18c87b50/watchdog-6.0.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:a175f755fc2279e0b7312c0035d52e27211a5bc39719dd529625b1930917345b", size = 89057 }, + { url = "https://files.pythonhosted.org/packages/30/ad/d17b5d42e28a8b91f8ed01cb949da092827afb9995d4559fd448d0472763/watchdog-6.0.0-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:c7ac31a19f4545dd92fc25d200694098f42c9a8e391bc00bdd362c5736dbf881", size = 87902 }, + { url = "https://files.pythonhosted.org/packages/5c/ca/c3649991d140ff6ab67bfc85ab42b165ead119c9e12211e08089d763ece5/watchdog-6.0.0-pp310-pypy310_pp73-macosx_11_0_arm64.whl", hash = "sha256:9513f27a1a582d9808cf21a07dae516f0fab1cf2d7683a742c498b93eedabb11", size = 88380 }, + { url = "https://files.pythonhosted.org/packages/a9/c7/ca4bf3e518cb57a686b2feb4f55a1892fd9a3dd13f470fca14e00f80ea36/watchdog-6.0.0-py3-none-manylinux2014_aarch64.whl", hash = "sha256:7607498efa04a3542ae3e05e64da8202e58159aa1fa4acddf7678d34a35d4f13", size = 79079 }, + { url = "https://files.pythonhosted.org/packages/5c/51/d46dc9332f9a647593c947b4b88e2381c8dfc0942d15b8edc0310fa4abb1/watchdog-6.0.0-py3-none-manylinux2014_armv7l.whl", hash = "sha256:9041567ee8953024c83343288ccc458fd0a2d811d6a0fd68c4c22609e3490379", size = 79078 }, + { url = "https://files.pythonhosted.org/packages/d4/57/04edbf5e169cd318d5f07b4766fee38e825d64b6913ca157ca32d1a42267/watchdog-6.0.0-py3-none-manylinux2014_i686.whl", hash = "sha256:82dc3e3143c7e38ec49d61af98d6558288c415eac98486a5c581726e0737c00e", size = 79076 }, + { url = "https://files.pythonhosted.org/packages/ab/cc/da8422b300e13cb187d2203f20b9253e91058aaf7db65b74142013478e66/watchdog-6.0.0-py3-none-manylinux2014_ppc64.whl", hash = "sha256:212ac9b8bf1161dc91bd09c048048a95ca3a4c4f5e5d4a7d1b1a7d5752a7f96f", size = 79077 }, + { url = "https://files.pythonhosted.org/packages/2c/3b/b8964e04ae1a025c44ba8e4291f86e97fac443bca31de8bd98d3263d2fcf/watchdog-6.0.0-py3-none-manylinux2014_ppc64le.whl", hash = "sha256:e3df4cbb9a450c6d49318f6d14f4bbc80d763fa587ba46ec86f99f9e6876bb26", size = 79078 }, + { url = "https://files.pythonhosted.org/packages/62/ae/a696eb424bedff7407801c257d4b1afda455fe40821a2be430e173660e81/watchdog-6.0.0-py3-none-manylinux2014_s390x.whl", hash = "sha256:2cce7cfc2008eb51feb6aab51251fd79b85d9894e98ba847408f662b3395ca3c", size = 79077 }, + { url = "https://files.pythonhosted.org/packages/b5/e8/dbf020b4d98251a9860752a094d09a65e1b436ad181faf929983f697048f/watchdog-6.0.0-py3-none-manylinux2014_x86_64.whl", hash = "sha256:20ffe5b202af80ab4266dcd3e91aae72bf2da48c0d33bdb15c66658e685e94e2", size = 79078 }, + { url = "https://files.pythonhosted.org/packages/07/f6/d0e5b343768e8bcb4cda79f0f2f55051bf26177ecd5651f84c07567461cf/watchdog-6.0.0-py3-none-win32.whl", hash = "sha256:07df1fdd701c5d4c8e55ef6cf55b8f0120fe1aef7ef39a1c6fc6bc2e606d517a", size = 79065 }, + { url = "https://files.pythonhosted.org/packages/db/d9/c495884c6e548fce18a8f40568ff120bc3a4b7b99813081c8ac0c936fa64/watchdog-6.0.0-py3-none-win_amd64.whl", hash = "sha256:cbafb470cf848d93b5d013e2ecb245d4aa1c8fd0504e863ccefa32445359d680", size = 79070 }, + { url = "https://files.pythonhosted.org/packages/33/e8/e40370e6d74ddba47f002a32919d91310d6074130fe4e17dabcafc15cbf1/watchdog-6.0.0-py3-none-win_ia64.whl", hash = "sha256:a1914259fa9e1454315171103c6a30961236f508b9b623eae470268bbcc6a22f", size = 79067 }, +]