repo-standards

repo-standards measures pull-request review size without executing repository code. Its repository rules are available for review but remain disabled until individually approved and explicitly activated by a consumer.

After a rule is approved, opt in per run with --enable-rule <rule-id>@<version>. Approval alone never enables a rule, and the option may be repeated for multiple approved rules.

Run it

Use the current release without installing it:

uvx --from repo-standards repo-standards pull-request size . --base origin/main

For a persistent user installation:

uv tool install repo-standards
repo-standards pull-request size . --base origin/main

Upgrade with uv tool upgrade repo-standards. Automation should pin the package version or the GitHub Action's full commit SHA.

GitHub Action

The Action measures size only. It enables no repository lint rules and needs no inputs on a pull_request event.

name: Pull-request size

on:
  pull_request:

permissions:
  contents: read

jobs:
  size:
    runs-on: ubuntu-latest
    timeout-minutes: 10
    steps:
      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7
        with:
          fetch-depth: 0
          persist-credentials: false
      - uses: sarj-ai/repo-standards@89ed271aedaba854879d7b890f1a429b71460452 # v5.0.0

The Action emits counted, excluded, and total line counts plus canonical JSON. Tests are recognized across Python, JavaScript/TypeScript, Go, JVM, Android, Xcode/Swift, .NET, Ruby, and Bats conventions. Mark generated or machine-owned artifacts in the trusted base revision:

path/to/generated/** pr-size-excluded

Thresholds, labels, comments, and approval requirements remain consumer policy. Use pull_request, never pull_request_target; this metric is not a security gate.

Safety model

  • Repository contents come from one exact Git tree.
  • Workflow YAML and API descriptions are parsed as inert data.
  • Missing required evidence produces an inconclusive result rather than a false pass.
  • The linter has no autofix or repository mutation mode.

Development

uv sync --locked
uv run pytest
uv run ruff check .
uv run basedpyright
uvx --no-config --isolated --python 3.14 \
  --from sarj-standards-bootstrap==2.0.0 \
  code-standards check --trust-repository-code

Build the same wheel and source distribution used by publishing:

uv build --no-sources

Releases are reconcilable. The protected workflow independently repairs a missing PyPI publication or GitHub Release from the same verified source revision.

Project links

Data verified by PyPI on Aug 21, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (5.1.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for nasr-sarj from gravatar.com nasr-sarj

Credits

Author: sarj-ai

GitHub Statistics

Data verified by PyPI on Aug 21, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.12

Tags

architecture github-actions lint openapi repository

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

repo_standards-5.0.0.tar.gz (74.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

repo_standards-5.0.0-py3-none-any.whl (88.6 kB view details)

Uploaded Python 3

File details

Details for the file repo_standards-5.0.0.tar.gz.

File metadata

  • Download URL: repo_standards-5.0.0.tar.gz
  • Upload date:
  • Size: 74.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for repo_standards-5.0.0.tar.gz
Algorithm Hash digest
SHA256 53c847d73b92a83f939988e2b29e6ce1a9d17f359c174c82c20e20473fb7262a
MD5 662b1d8f4546f417dc369973bc350217
BLAKE2b-256 05dd66269ac1f9aabc94f5f1b3cf988e948d232b1ee4657430c574ac2e7d056d

See more details on using hashes here.

Provenance

The following attestation bundles were made for repo_standards-5.0.0.tar.gz:

Publisher: publish.yml on sarj-ai/repo-standards

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file repo_standards-5.0.0-py3-none-any.whl.

File metadata

  • Download URL: repo_standards-5.0.0-py3-none-any.whl
  • Upload date:
  • Size: 88.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for repo_standards-5.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e74261fe011ba7a376d8cd490e4f606d6053d1b431a3814a406cc51c5895817a
MD5 40a73abeec73cfe97c7260204696df10
BLAKE2b-256 e56eba8c9fd7613eb9630fc9392b4bb85811baf3d7c30f0a74d2a7c34f1256ba

See more details on using hashes here.

Provenance

The following attestation bundles were made for repo_standards-5.0.0-py3-none-any.whl:

Publisher: publish.yml on sarj-ai/repo-standards

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

5.1.0

2 files

5.0.1

2 files

This release

5.0.0 This release

2 files

4.0.2

2 files

4.0.1

2 files

4.0.0

2 files

3.0.2

2 files

3.0.1

2 files

3.0.0

2 files

2.0.0

2 files

1.0.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page