sarj-standards

The Python package and command-line entry point for Sarj Standards. It detects repository structure, installs the supported toolchain, generates shared configuration, runs checks and fixes, and diagnoses drift.

Use

uv tool install sarj-standards
sarj-standards setup
sarj-standards doctor
sarj-standards check --trust-repository-code

Use sarj-standards fix for supported safe fixes and formatting. Use sarj-standards update to update the complete Standards toolchain as one reviewable change. Every command is repository-root aware and setup and update are idempotent.

The generated .sarj-standards.toml is the repository's concise policy: applicable rules are on by default, while exceptional paths or rules are excluded explicitly. Do not edit generated tool configuration.

Use one denylist command instead of editing generated analyzer configs:

sarj-standards exclude add path 'generated/**'
sarj-standards exclude add rule 'eslint:@typescript-eslint/no-explicit-any'
sarj-standards exclude list
sarj-standards exclude remove path 'generated/**'

Paths are repository-relative globs and rules use an exact engine:rule selector. The operations are atomic and idempotent. Repository-wide path patterns are rejected so an exclusion cannot silently turn Standards off.

Tool ownership

Standards orchestrates these native analyzers:

  • Ruff for Python lint and formatting.
  • BasedPyright for Python types.
  • ESLint for JavaScript and TypeScript semantics.
  • Sarj analyzers for Python, SQL, IaC, and text policy.

Existing formatters, generators, tests, and custom gates remain repository owned unless setup can prove that Standards owns an equivalent integration.

CI

Run sarj-standards check --trust-repository-code as the quality gate. The trust flag explicitly permits the repository's executable ESLint configuration; generated hooks and CI use it automatically. Keep the package version pinned by the repository lock file, and run sarj-standards doctor when diagnosing a failed upgrade or unexpected drift. Machine-readable diagnostics are available through the formats shown by sarj-standards check --help.

Maintainers

Business logic lives under sarj_standards.libs; the CLI is a presentation adapter. Repository maintenance commands live under sarj-standards maintain. Generated documentation must be synchronized with:

sarj-standards maintain docs sync
sarj-standards maintain docs check

The repository's contribution guide defines verification and release requirements.

Project links

Data verified by PyPI on Aug 8, 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 (7.0.5)

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 8, 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.14

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 Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

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

sarj_standards-2.0.1-py3-none-any.whl (258.5 kB view details)

Uploaded Python 3

File details

Details for the file sarj_standards-2.0.1-py3-none-any.whl.

File metadata

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

File hashes

Hashes for sarj_standards-2.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5491de1942003f14965cf3643267bb4bb37d0a3fe333d57df9860d6d04a23277
MD5 6fad57d310ae3b2af45751b5977c1a15
BLAKE2b-256 23c81f937bd5b4ffc5221701b6ce727db07e2799e8d60b881f04a0bff50ae8bf

See more details on using hashes here.

Provenance

The following attestation bundles were made for sarj_standards-2.0.1-py3-none-any.whl:

Publisher: release.yml on sarj-ai/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

7.0.5

2 files

7.0.4

2 files

7.0.3

2 files

7.0.2

2 files

7.0.1

2 files

7.0.0

2 files

6.6.1

2 files

6.6.0

2 files

6.5.0

2 files

6.4.1

2 files

6.4.0

2 files

6.3.1

2 files

6.3.0

2 files

6.2.2

2 files

6.2.1

2 files

6.2.0

2 files

6.1.10

2 files

6.1.9

2 files

6.1.8

2 files

6.1.7

2 files

6.1.5

2 files

6.1.4

2 files

6.1.3

2 files

6.1.2

2 files

6.1.1

2 files

6.1.0

2 files

6.0.5

2 files

6.0.4

2 files

6.0.3

2 files

6.0.2

2 files

6.0.1

2 files

6.0.0

2 files

5.16.5

2 files

5.16.4

2 files

5.16.3

2 files

5.16.2

2 files

5.16.1

2 files

5.16.0

2 files

5.14.1

2 files

5.14.0

2 files

5.13.6

2 files

5.13.5

2 files

5.13.4

2 files

5.13.3

2 files

5.13.2

2 files

5.13.1

2 files

5.12.3

2 files

5.12.2

2 files

5.12.1

2 files

5.12.0

2 files

5.11.1

2 files

5.11.0

2 files

5.10.1

2 files

5.10.0

2 files

5.9.0

2 files

5.8.4

2 files

5.8.3

2 files

5.8.2

2 files

5.8.1

2 files

5.8.0

2 files

5.7.1

2 files

5.7.0

2 files

5.6.24

2 files

5.6.23

2 files

5.6.22

2 files

5.6.21

2 files

5.6.19

2 files

5.6.18

2 files

5.6.17

2 files

5.6.16

2 files

5.6.15

2 files

5.6.14

2 files

5.6.13

2 files

5.6.12

2 files

5.6.9

2 files

5.6.8

2 files

5.6.7

2 files

5.6.6

2 files

5.6.5

2 files

5.6.4

2 files

5.6.3

2 files

5.6.2

2 files

5.6.0

1 file

5.5.0

1 file

5.4.0

1 file

5.3.0

1 file

5.2.0

1 file

5.1.0

1 file

5.0.0

1 file

4.0.1

1 file

4.0.0

1 file

3.1.1

1 file

3.1.0

1 file

3.0.1

1 file

3.0.0

1 file

This release

2.0.1 This release

1 file

2.0.0

1 file

1.2.0

1 file

1.1.0

1 file

1.0.2

1 file

1.0.1

1 file

1.0.0

1 file

Supported by

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