code-standards 7.0.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (99) hide show
  1. code_standards-7.0.0/.gitignore +40 -0
  2. code_standards-7.0.0/LICENSE +21 -0
  3. code_standards-7.0.0/PKG-INFO +53 -0
  4. code_standards-7.0.0/README.md +21 -0
  5. code_standards-7.0.0/pyproject.toml +72 -0
  6. code_standards-7.0.0/src/sarj_standards/__init__.py +30 -0
  7. code_standards-7.0.0/src/sarj_standards/__main__.py +5 -0
  8. code_standards-7.0.0/src/sarj_standards/_meta.py +22 -0
  9. code_standards-7.0.0/src/sarj_standards/api.py +890 -0
  10. code_standards-7.0.0/src/sarj_standards/cli/__init__.py +0 -0
  11. code_standards-7.0.0/src/sarj_standards/cli/main.py +2466 -0
  12. code_standards-7.0.0/src/sarj_standards/configs/cli-reference.v1.json +1 -0
  13. code_standards-7.0.0/src/sarj_standards/configs/doctor.config.json +22 -0
  14. code_standards-7.0.0/src/sarj_standards/configs/eslint.application.mjs +1366 -0
  15. code_standards-7.0.0/src/sarj_standards/configs/eslint.peers.json +44 -0
  16. code_standards-7.0.0/src/sarj_standards/configs/eslint.strict.mjs +1060 -0
  17. code_standards-7.0.0/src/sarj_standards/configs/markdownlint.strict.yaml +12 -0
  18. code_standards-7.0.0/src/sarj_standards/configs/pyright.strict.json +96 -0
  19. code_standards-7.0.0/src/sarj_standards/configs/ruff.application.toml +363 -0
  20. code_standards-7.0.0/src/sarj_standards/configs/ruff.strict.toml +338 -0
  21. code_standards-7.0.0/src/sarj_standards/configs/rule-inventory.v1.json +1 -0
  22. code_standards-7.0.0/src/sarj_standards/configs/rule-ledger.json +846 -0
  23. code_standards-7.0.0/src/sarj_standards/configs/rule-warning-levels.v1.json +1 -0
  24. code_standards-7.0.0/src/sarj_standards/configs/taplo.strict.toml +14 -0
  25. code_standards-7.0.0/src/sarj_standards/configs/yamllint.strict.yaml +25 -0
  26. code_standards-7.0.0/src/sarj_standards/libs/__init__.py +0 -0
  27. code_standards-7.0.0/src/sarj_standards/libs/adoption/__init__.py +0 -0
  28. code_standards-7.0.0/src/sarj_standards/libs/adoption/configs.py +36 -0
  29. code_standards-7.0.0/src/sarj_standards/libs/adoption/doctor.py +1346 -0
  30. code_standards-7.0.0/src/sarj_standards/libs/adoption/exclusions.py +66 -0
  31. code_standards-7.0.0/src/sarj_standards/libs/adoption/hooks.py +423 -0
  32. code_standards-7.0.0/src/sarj_standards/libs/adoption/launcher.py +240 -0
  33. code_standards-7.0.0/src/sarj_standards/libs/adoption/lifecycle.py +493 -0
  34. code_standards-7.0.0/src/sarj_standards/libs/adoption/manifest.py +550 -0
  35. code_standards-7.0.0/src/sarj_standards/libs/adoption/packagemanager.py +285 -0
  36. code_standards-7.0.0/src/sarj_standards/libs/adoption/retired_suppressions.py +371 -0
  37. code_standards-7.0.0/src/sarj_standards/libs/adoption/scaffold.py +1660 -0
  38. code_standards-7.0.0/src/sarj_standards/libs/adoption/service.py +441 -0
  39. code_standards-7.0.0/src/sarj_standards/libs/adoption/transaction.py +274 -0
  40. code_standards-7.0.0/src/sarj_standards/libs/adoption/upgrade.py +516 -0
  41. code_standards-7.0.0/src/sarj_standards/libs/adoption/uvtool.py +62 -0
  42. code_standards-7.0.0/src/sarj_standards/libs/catalogs/__init__.py +9 -0
  43. code_standards-7.0.0/src/sarj_standards/libs/catalogs/slack_automations.py +627 -0
  44. code_standards-7.0.0/src/sarj_standards/libs/corpus/__init__.py +25 -0
  45. code_standards-7.0.0/src/sarj_standards/libs/corpus/manifest.py +211 -0
  46. code_standards-7.0.0/src/sarj_standards/libs/corpus/snapshot.py +222 -0
  47. code_standards-7.0.0/src/sarj_standards/libs/diagnostics/__init__.py +65 -0
  48. code_standards-7.0.0/src/sarj_standards/libs/diagnostics/analysis.schema.json +161 -0
  49. code_standards-7.0.0/src/sarj_standards/libs/diagnostics/baseline.py +131 -0
  50. code_standards-7.0.0/src/sarj_standards/libs/diagnostics/models.py +574 -0
  51. code_standards-7.0.0/src/sarj_standards/libs/diagnostics/serialize.py +290 -0
  52. code_standards-7.0.0/src/sarj_standards/libs/diagnostics/source.py +172 -0
  53. code_standards-7.0.0/src/sarj_standards/libs/filesystem.py +11 -0
  54. code_standards-7.0.0/src/sarj_standards/libs/linting/__init__.py +0 -0
  55. code_standards-7.0.0/src/sarj_standards/libs/linting/analysis.py +422 -0
  56. code_standards-7.0.0/src/sarj_standards/libs/linting/external.py +1454 -0
  57. code_standards-7.0.0/src/sarj_standards/libs/linting/library_policy.py +688 -0
  58. code_standards-7.0.0/src/sarj_standards/libs/linting/policy.py +152 -0
  59. code_standards-7.0.0/src/sarj_standards/libs/linting/runner.py +442 -0
  60. code_standards-7.0.0/src/sarj_standards/libs/linting/textlint.py +1605 -0
  61. code_standards-7.0.0/src/sarj_standards/libs/release/__init__.py +98 -0
  62. code_standards-7.0.0/src/sarj_standards/libs/release/_values.py +24 -0
  63. code_standards-7.0.0/src/sarj_standards/libs/release/artifacts.py +191 -0
  64. code_standards-7.0.0/src/sarj_standards/libs/release/causality.py +80 -0
  65. code_standards-7.0.0/src/sarj_standards/libs/release/changes.py +48 -0
  66. code_standards-7.0.0/src/sarj_standards/libs/release/process.py +128 -0
  67. code_standards-7.0.0/src/sarj_standards/libs/release/publish.py +85 -0
  68. code_standards-7.0.0/src/sarj_standards/libs/release/registry.py +271 -0
  69. code_standards-7.0.0/src/sarj_standards/libs/release/release_age.py +218 -0
  70. code_standards-7.0.0/src/sarj_standards/libs/release/rollout.py +1163 -0
  71. code_standards-7.0.0/src/sarj_standards/libs/release/tags.py +373 -0
  72. code_standards-7.0.0/src/sarj_standards/libs/release/typescript.py +191 -0
  73. code_standards-7.0.0/src/sarj_standards/libs/repository/__init__.py +0 -0
  74. code_standards-7.0.0/src/sarj_standards/libs/repository/cli_reference_artifact.py +324 -0
  75. code_standards-7.0.0/src/sarj_standards/libs/repository/comment_corpus.py +536 -0
  76. code_standards-7.0.0/src/sarj_standards/libs/repository/config_generation.py +146 -0
  77. code_standards-7.0.0/src/sarj_standards/libs/repository/docs.py +347 -0
  78. code_standards-7.0.0/src/sarj_standards/libs/repository/hooks.py +118 -0
  79. code_standards-7.0.0/src/sarj_standards/libs/repository/ledger.py +99 -0
  80. code_standards-7.0.0/src/sarj_standards/libs/repository/repository.py +744 -0
  81. code_standards-7.0.0/src/sarj_standards/libs/repository/rule_authoring.py +246 -0
  82. code_standards-7.0.0/src/sarj_standards/libs/repository/rule_catalog_artifact.py +479 -0
  83. code_standards-7.0.0/src/sarj_standards/libs/repository/rule_changes.py +318 -0
  84. code_standards-7.0.0/src/sarj_standards/libs/repository/rule_inventory_artifact.py +142 -0
  85. code_standards-7.0.0/src/sarj_standards/libs/repository/rule_lifecycle.py +167 -0
  86. code_standards-7.0.0/src/sarj_standards/libs/repository/rule_maintenance.py +225 -0
  87. code_standards-7.0.0/src/sarj_standards/libs/rules/__init__.py +74 -0
  88. code_standards-7.0.0/src/sarj_standards/libs/rules/catalog.py +145 -0
  89. code_standards-7.0.0/src/sarj_standards/libs/rules/contracts.py +382 -0
  90. code_standards-7.0.0/src/sarj_standards/libs/rules/corpus_runner.py +365 -0
  91. code_standards-7.0.0/src/sarj_standards/libs/rules/evaluation.py +177 -0
  92. code_standards-7.0.0/src/sarj_standards/libs/setup/__init__.py +4 -0
  93. code_standards-7.0.0/src/sarj_standards/libs/setup/repository.py +40 -0
  94. code_standards-7.0.0/src/sarj_standards/py.typed +0 -0
  95. code_standards-7.0.0/src/sarj_standards/schemas/__init__.py +4 -0
  96. code_standards-7.0.0/src/sarj_standards/schemas/_paths.py +7 -0
  97. code_standards-7.0.0/src/sarj_standards/schemas/rule-catalog.v1.json +1 -0
  98. code_standards-7.0.0/src/sarj_standards/schemas/rule-catalog.v1.schema.json +112 -0
  99. code_standards-7.0.0/src/sarj_standards/schemas/slack-automations.v1.schema.json +1751 -0
@@ -0,0 +1,40 @@
1
+ node_modules/
2
+ .astro/
3
+ dist/
4
+ build/
5
+ *.tgz
6
+ .npm/
7
+ *.tsbuildinfo
8
+ .turbo/
9
+ .tsup/
10
+ .vitest-cache/
11
+ .eslintcache
12
+ coverage/
13
+
14
+ __pycache__/
15
+ *.py[co]
16
+ .pytest_cache/
17
+ .ruff_cache/
18
+ .mypy_cache/
19
+ .basedpyright/
20
+ .coverage
21
+ .coverage.*
22
+ htmlcov/
23
+ .tox/
24
+ .venv/
25
+ venv/
26
+ *.egg-info/
27
+
28
+ .DS_Store
29
+ Thumbs.db
30
+ .idea/
31
+ .vscode/
32
+ .zed/
33
+ *.swp
34
+
35
+ # Claude Code local state (shared settings.json is tracked)
36
+ .claude/*
37
+ !.claude/settings.json
38
+ .worktrees/
39
+ .sarj-private-refs.toml
40
+ .sarj-standards-rollout.toml
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 sarj-ai
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,53 @@
1
+ Metadata-Version: 2.5
2
+ Name: code-standards
3
+ Version: 7.0.0
4
+ Summary: One deterministic quality gate for Sarj Python, TypeScript, SQL, IaC, and repository policy.
5
+ Project-URL: Homepage, https://code-standards.sarj.ai/
6
+ Project-URL: Documentation, https://code-standards.sarj.ai/cli/
7
+ Project-URL: Changelog, https://github.com/sarj-ai/code-standards/releases
8
+ Project-URL: Repository, https://github.com/sarj-ai/code-standards
9
+ Project-URL: Issues, https://github.com/sarj-ai/code-standards/issues
10
+ Author: sarj-ai
11
+ License-Expression: MIT
12
+ License-File: LICENSE
13
+ Classifier: Development Status :: 4 - Beta
14
+ Classifier: Intended Audience :: Developers
15
+ Classifier: License :: OSI Approved :: MIT License
16
+ Classifier: Programming Language :: Python :: 3
17
+ Classifier: Programming Language :: Python :: 3.14
18
+ Classifier: Topic :: Software Development :: Quality Assurance
19
+ Requires-Python: >=3.14
20
+ Requires-Dist: basedpyright==1.39.10
21
+ Requires-Dist: lefthook==2.1.10
22
+ Requires-Dist: packaging==26.3
23
+ Requires-Dist: pathspec==1.1.1
24
+ Requires-Dist: pre-commit==4.6.2
25
+ Requires-Dist: pydantic==2.13.4
26
+ Requires-Dist: pyyaml==6.0.3
27
+ Requires-Dist: ruff==0.16.3
28
+ Requires-Dist: sarj-iac-lint==0.14.3
29
+ Requires-Dist: sarj-python-lint==0.77.1
30
+ Requires-Dist: sarj-sql-lint==0.16.1
31
+ Description-Content-Type: text/markdown
32
+
33
+ <!-- Generated by `code-standards maintain docs sync`; do not edit. -->
34
+
35
+ # code-standards
36
+
37
+ One deterministic quality gate for Sarj Python, TypeScript, SQL, IaC, and repository policy.
38
+
39
+ ```bash
40
+ uv tool install --python 3.14 code-standards
41
+ ```
42
+
43
+ Use it from pre-commit with a coding agent so violations are flagged and fixed before commit.
44
+
45
+ ```bash
46
+ code-standards setup
47
+ code-standards check
48
+ code-standards fix
49
+ code-standards doctor
50
+ code-standards update
51
+ ```
52
+
53
+ [Documentation](https://code-standards.sarj.ai/) · [Source](https://github.com/sarj-ai/code-standards)
@@ -0,0 +1,21 @@
1
+ <!-- Generated by `code-standards maintain docs sync`; do not edit. -->
2
+
3
+ # code-standards
4
+
5
+ One deterministic quality gate for Sarj Python, TypeScript, SQL, IaC, and repository policy.
6
+
7
+ ```bash
8
+ uv tool install --python 3.14 code-standards
9
+ ```
10
+
11
+ Use it from pre-commit with a coding agent so violations are flagged and fixed before commit.
12
+
13
+ ```bash
14
+ code-standards setup
15
+ code-standards check
16
+ code-standards fix
17
+ code-standards doctor
18
+ code-standards update
19
+ ```
20
+
21
+ [Documentation](https://code-standards.sarj.ai/) · [Source](https://github.com/sarj-ai/code-standards)
@@ -0,0 +1,72 @@
1
+ [project]
2
+ name = "code-standards"
3
+ version = "7.0.0"
4
+ description = "One deterministic quality gate for Sarj Python, TypeScript, SQL, IaC, and repository policy."
5
+ readme = "README.md"
6
+ requires-python = ">=3.14"
7
+ license = "MIT"
8
+ license-files = ["LICENSE"]
9
+ authors = [{ name = "sarj-ai" }]
10
+ classifiers = [
11
+ "Development Status :: 4 - Beta",
12
+ "Intended Audience :: Developers",
13
+ "License :: OSI Approved :: MIT License",
14
+ "Programming Language :: Python :: 3",
15
+ "Programming Language :: Python :: 3.14",
16
+ "Topic :: Software Development :: Quality Assurance",
17
+ ]
18
+ dependencies = [
19
+ "pathspec==1.1.1",
20
+ "basedpyright==1.39.10",
21
+ "lefthook==2.1.10",
22
+ "packaging==26.3",
23
+ "pre-commit==4.6.2",
24
+ "pydantic==2.13.4",
25
+ "PyYAML==6.0.3",
26
+ "ruff==0.16.3",
27
+ "sarj-iac-lint==0.14.3",
28
+ "sarj-python-lint==0.77.1",
29
+ "sarj-sql-lint==0.16.1",
30
+ ]
31
+
32
+ [project.scripts]
33
+ code-standards = "sarj_standards.__main__:main"
34
+ sarj-standards = "sarj_standards.__main__:main"
35
+
36
+ [project.urls]
37
+ Homepage = "https://code-standards.sarj.ai/"
38
+ Documentation = "https://code-standards.sarj.ai/cli/"
39
+ Changelog = "https://github.com/sarj-ai/code-standards/releases"
40
+ Repository = "https://github.com/sarj-ai/code-standards"
41
+ Issues = "https://github.com/sarj-ai/code-standards/issues"
42
+
43
+ [build-system]
44
+ requires = ["hatchling==1.32.0"]
45
+ build-backend = "hatchling.build"
46
+
47
+ [tool.hatch.build.targets.wheel]
48
+ packages = ["src/sarj_standards"]
49
+
50
+ [tool.hatch.build.targets.sdist]
51
+ include = [
52
+ "src/sarj_standards/**",
53
+ "README.md",
54
+ "LICENSE",
55
+ "pyproject.toml",
56
+ ]
57
+
58
+ [dependency-groups]
59
+ dev = [
60
+ "jsonschema>=4.26,<5",
61
+ "pytest>=9.1.1",
62
+ ]
63
+ [tool.uv.sources]
64
+ # Development uses the sibling packages while wheel smoke tests resolve the
65
+ # same exact, already-published versions declared above.
66
+ sarj-iac-lint = { path = "../iac", editable = true }
67
+ sarj-python-lint = { path = "../python", editable = true }
68
+ sarj-sql-lint = { path = "../sql", editable = true }
69
+
70
+ # Dogfooding: linted/formatted by this repo's own published config (root-synced).
71
+ [tool.ruff]
72
+ extend = "../../.ruff-strict.toml"
@@ -0,0 +1,30 @@
1
+ from sarj_standards._meta import __version__
2
+ from sarj_standards.api import (
3
+ AnalysisReport,
4
+ Change,
5
+ Diagnostic,
6
+ Finding,
7
+ Result,
8
+ Standards,
9
+ Status,
10
+ to_github,
11
+ to_json,
12
+ to_sarif,
13
+ to_text,
14
+ )
15
+
16
+
17
+ __all__ = [
18
+ "AnalysisReport",
19
+ "Change",
20
+ "Diagnostic",
21
+ "Finding",
22
+ "Result",
23
+ "Standards",
24
+ "Status",
25
+ "__version__",
26
+ "to_github",
27
+ "to_json",
28
+ "to_sarif",
29
+ "to_text",
30
+ ]
@@ -0,0 +1,5 @@
1
+ from sarj_standards.cli.main import main
2
+
3
+
4
+ if __name__ == "__main__":
5
+ raise SystemExit(main())
@@ -0,0 +1,22 @@
1
+ from __future__ import annotations
2
+
3
+ from importlib.metadata import PackageNotFoundError, version
4
+ from pathlib import Path
5
+
6
+
7
+ try:
8
+ __version__ = version("code-standards")
9
+ except PackageNotFoundError: # running from an uninstalled source tree
10
+ __version__ = "0.0.0.dev0"
11
+
12
+ CONFIGS_DIR: Path = Path(__file__).resolve().parent / "configs"
13
+
14
+ RUFF_STRICT: Path = CONFIGS_DIR / "ruff.strict.toml"
15
+ RUFF_APPLICATION: Path = CONFIGS_DIR / "ruff.application.toml"
16
+ PYRIGHT_STRICT: Path = CONFIGS_DIR / "pyright.strict.json"
17
+ ESLINT_STRICT: Path = CONFIGS_DIR / "eslint.strict.mjs"
18
+ ESLINT_APPLICATION: Path = CONFIGS_DIR / "eslint.application.mjs"
19
+ MARKDOWNLINT_STRICT: Path = CONFIGS_DIR / "markdownlint.strict.yaml"
20
+ ESLINT_PEERS: Path = CONFIGS_DIR / "eslint.peers.json"
21
+ TAPLO_STRICT: Path = CONFIGS_DIR / "taplo.strict.toml"
22
+ YAMLLINT_STRICT: Path = CONFIGS_DIR / "yamllint.strict.yaml"