pyossmtool 0.0.1__tar.gz

pyossmtool-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vishal Kumar Mishra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyossmtool-0.0.1/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: pyossmtool
+Version: 0.0.1
+Summary: Quality-gate orchestrator for AI-assisted development
+Author-email: Vishal Kumar Mishra <vishal.k.mishra2@gmail.com>
+License-Expression: MIT
+Project-URL: Changelog, https://github.com/inquilabee/pyossmtool/blob/main/CHANGELOG.md
+Project-URL: Homepage, https://github.com/inquilabee/pyossmtool
+Project-URL: Issues, https://github.com/inquilabee/pyossmtool/issues
+Project-URL: Repository, https://github.com/inquilabee/pyossmtool
+Keywords: quality,lint,format,pre-commit,python,static-analysis
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Quality Assurance
+Requires-Python: <3.14,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pathspec>=0.12
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: typer>=0.12
+Dynamic: license-file
+
+# pyossmtool
+
+Portable quality-gate orchestrator for Python-first repositories. Inspired by Trunk and pre-commit: opinionated defaults, little required configuration, silent on success, structured failure reports for humans and AI agents.
+
+## Install
+
+```bash
+pip install pyossmtool
+# or
+uv add --dev pyossmtool
+```
+
+Requires Python 3.11–3.13.
+
+## Quick start
+
+Create `pyossmtool.yaml` in your repo:
+
+```yaml
+suite: python-quality
+env: auto
+target: .
+configs:
+  mode: auto
+```
+
+Install tool binaries for that suite, then run:
+
+```bash
+pyossmtool install --suite python-quality
+pyossmtool format                 # apply formatters (suite: format)
+pyossmtool check                  # report-only (suite from pyossmtool.yaml)
+```
+
+- **`check`** — report-only (linters, type checkers, format `--check` variants)
+- **`format`** — writes files (formatter apply checks)
+
+On failure, pyossmtool exits non-zero and writes a JSON failure report under `reports/failures/`. Inspect the schema with `pyossmtool schema`.
+
+## How targeting works
+
+- Default scan root is `.` (override with `target:` in config or suite).
+- Each tool declares `files:` globs (e.g. `**/*.py`). Matching files are discovered under the target.
+- `.gitignore` is always applied. Extra ignore profiles/paths can be added in suite or project config.
+
+## Adding a tool
+
+1. Add `src/pyossmtool/bundle/catalog/tools/<id>.yaml` (install method, binary, `files:`).
+1. Add one or more checks under `catalog/checks/` with `mode: check` or `mode: format`.
+1. Optionally add a parser class under `pyossmtool.parsers` and register it.
+1. Reference the check ids from a suite YAML.
+
+Project-local script gates: `pyossmtool gate init <name>`.
+
+## Development
+
+```bash
+uv sync --all-groups
+make check-commit
+make build
+```
+
+## License
+
+MIT

pyossmtool-0.0.1/README.md

@@ -0,0 +1,65 @@
+# pyossmtool
+
+Portable quality-gate orchestrator for Python-first repositories. Inspired by Trunk and pre-commit: opinionated defaults, little required configuration, silent on success, structured failure reports for humans and AI agents.
+
+## Install
+
+```bash
+pip install pyossmtool
+# or
+uv add --dev pyossmtool
+```
+
+Requires Python 3.11–3.13.
+
+## Quick start
+
+Create `pyossmtool.yaml` in your repo:
+
+```yaml
+suite: python-quality
+env: auto
+target: .
+configs:
+  mode: auto
+```
+
+Install tool binaries for that suite, then run:
+
+```bash
+pyossmtool install --suite python-quality
+pyossmtool format                 # apply formatters (suite: format)
+pyossmtool check                  # report-only (suite from pyossmtool.yaml)
+```
+
+- **`check`** — report-only (linters, type checkers, format `--check` variants)
+- **`format`** — writes files (formatter apply checks)
+
+On failure, pyossmtool exits non-zero and writes a JSON failure report under `reports/failures/`. Inspect the schema with `pyossmtool schema`.
+
+## How targeting works
+
+- Default scan root is `.` (override with `target:` in config or suite).
+- Each tool declares `files:` globs (e.g. `**/*.py`). Matching files are discovered under the target.
+- `.gitignore` is always applied. Extra ignore profiles/paths can be added in suite or project config.
+
+## Adding a tool
+
+1. Add `src/pyossmtool/bundle/catalog/tools/<id>.yaml` (install method, binary, `files:`).
+1. Add one or more checks under `catalog/checks/` with `mode: check` or `mode: format`.
+1. Optionally add a parser class under `pyossmtool.parsers` and register it.
+1. Reference the check ids from a suite YAML.
+
+Project-local script gates: `pyossmtool gate init <name>`.
+
+## Development
+
+```bash
+uv sync --all-groups
+make check-commit
+make build
+```
+
+## License
+
+MIT

pyossmtool-0.0.1/pyproject.toml

@@ -0,0 +1,95 @@
+[project]
+name = "pyossmtool"
+version = "0.0.1"
+description = "Quality-gate orchestrator for AI-assisted development"
+readme = "README.md"
+requires-python = ">=3.11,<3.14"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+  { name = "Vishal Kumar Mishra", email = "vishal.k.mishra2@gmail.com" },
+]
+keywords = [
+  "quality",
+  "lint",
+  "format",
+  "pre-commit",
+  "python",
+  "static-analysis",
+]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Software Development :: Quality Assurance",
+]
+dependencies = [
+  "pydantic>=2.0",
+  "pathspec>=0.12",
+  "pyyaml>=6.0",
+  "typer>=0.12",
+]
+
+[project.urls]
+Changelog = "https://github.com/inquilabee/pyossmtool/blob/main/CHANGELOG.md"
+Homepage = "https://github.com/inquilabee/pyossmtool"
+Issues = "https://github.com/inquilabee/pyossmtool/issues"
+Repository = "https://github.com/inquilabee/pyossmtool"
+
+[dependency-groups]
+dev = [
+  "pytest>=8.0",
+  "pytest-cov>=6.0",
+  "ruff>=0.11.0",
+]
+
+[project.scripts]
+pyossmtool = "pyossmtool.cli:app"
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+pyossmtool = ["py.typed", "bundle/**/*"]
+
+[tool.pytest.ini_options]
+minversion = "8.0"
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+addopts = [
+  "-m",
+  "not integration",
+  "--strict-config",
+  "--strict-markers",
+]
+filterwarnings = [
+  "error",
+]
+markers = [
+  "integration: tests that build wheels, install packages, or require external binaries/network",
+]
+
+[tool.ruff]
+line-length = 120
+target-version = "py311"
+
+[tool.ruff.lint]
+select = ["B", "E", "F", "I", "UP"]
+
+[tool.ty]
+# Repo-owned config; wins over bundled defaults when configs.mode=auto
+
+[tool.bandit]
+skips = ["B404", "B603", "B607"]
+
+[tool.codespell]
+ignore-words-list = "IST,fullfilled"

pyossmtool-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pyossmtool-0.0.1/src/pyossmtool/__init__.py

@@ -0,0 +1,3 @@
+"""pyossmtool — quality-gate orchestrator for AI-assisted development."""
+
+__version__ = "0.0.1"

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/bandit.scan.yaml

@@ -0,0 +1,13 @@
+id: bandit.scan
+tool: bandit
+name: Bandit Security Scan
+description: Scan Python code for common security issues.
+argv:
+  - -r
+  - "{target}"
+  - -f
+  - json
+  - -q
+parser: bandit_json
+success:
+  exit_codes: [0, 1]

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/codespell.spelling.yaml

@@ -0,0 +1,12 @@
+id: codespell.spelling
+tool: codespell
+name: Codespell
+description: Check prose for common misspellings.
+argv:
+  - "{target}"
+parser: codespell_text
+success:
+  exit_codes: [0]
+remediation:
+  suggested_commands:
+    - codespell -w {target}

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/deadcode.scan.yaml

@@ -0,0 +1,13 @@
+id: deadcode.scan
+tool: deadcode
+name: Deadcode Scan
+description: Find unused Python definitions.
+argv:
+  - --no-color
+  - "{target}"
+parser: deadcode_text
+success:
+  exit_codes: [0]
+remediation:
+  suggested_commands:
+    - deadcode --no-color {target}

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/gate.acronym-allowlist.yaml

@@ -0,0 +1,14 @@
+id: gate.acronym-allowlist
+tool: script
+name: Acronym Allowlist Gate
+description: Require documented expansions for acronyms in contributor prose.
+script: bundled:gates/acronym-allowlist.sh
+parser: gate_json
+output_file: .pyossmtool/reports/gate.acronym-allowlist.json
+argv: []
+config:
+  bundled: gates/acronym-allowlist.yaml
+  project_file: .pyossmtool/configs/gates/gate.acronym-allowlist.yaml
+  allowlist_bundled: acronyms.yaml
+success:
+  exit_codes: [0]

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/gate.folder-breadth.yaml

@@ -0,0 +1,14 @@
+id: gate.folder-breadth
+tool: script
+name: Folder Breadth Gate
+description: Cap direct sibling file counts in leaf directories.
+script: bundled:gates/folder-breadth.sh
+parser: gate_json
+output_file: .pyossmtool/reports/gate.folder-breadth.json
+argv: []
+config:
+  bundled: gates/folder-breadth.yaml
+  project_file: .pyossmtool/configs/gates/gate.folder-breadth.yaml
+  allowlist_bundled: folder-breadth.txt
+success:
+  exit_codes: [0]

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/gate.module-private-vars.yaml

@@ -0,0 +1,14 @@
+id: gate.module-private-vars
+tool: script
+name: Module Private Vars Gate
+description: Forbid module-level names with a single leading underscore.
+script: bundled:gates/module-private-vars.sh
+parser: gate_json
+output_file: .pyossmtool/reports/gate.module-private-vars.json
+argv: []
+config:
+  bundled: gates/module-private-vars.yaml
+  project_file: .pyossmtool/configs/gates/gate.module-private-vars.yaml
+  allowlist_bundled: module-private-vars.txt
+success:
+  exit_codes: [0]

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/gate.module-size.yaml

@@ -0,0 +1,14 @@
+id: gate.module-size
+tool: script
+name: Module Size Gate
+description: Enforce portfolio and new-file line limits on Python modules.
+script: bundled:gates/module-size.sh
+parser: gate_json
+output_file: .pyossmtool/reports/gate.module-size.json
+argv: []
+config:
+  bundled: gates/module-size.yaml
+  project_file: .pyossmtool/configs/gates/gate.module-size.yaml
+  allowlist_bundled: module-size.txt
+success:
+  exit_codes: [0]

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/gitleaks.secrets.yaml

@@ -0,0 +1,21 @@
+id: gitleaks.secrets
+tool: gitleaks
+name: Gitleaks Secret Scan
+description: Scan repository for leaked secrets.
+argv:
+  - detect
+  - --source
+  - "{target}"
+  - --no-banner
+  - --redact
+  - --report-format
+  - json
+  - --report-path
+  - .pyossmtool/gitleaks-report.json
+parser: gitleaks_json
+success:
+  exit_codes: [0]
+output_file: .pyossmtool/gitleaks-report.json
+remediation:
+  suggested_commands:
+    - gitleaks detect --source {target}

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/hadolint.dockerfile.yaml

@@ -0,0 +1,16 @@
+id: hadolint.dockerfile
+tool: hadolint
+name: Hadolint
+description: Lint Dockerfiles.
+argv:
+- --format
+- json
+- '{target}'
+parser: hadolint_json
+success:
+  exit_codes:
+  - 0
+  - 1
+remediation:
+  suggested_commands:
+  - hadolint {target}

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/jscpd.duplication.yaml

@@ -0,0 +1,19 @@
+id: jscpd.duplication
+tool: jscpd
+name: JSCPD Duplication Scan
+description: Detect duplicated code blocks above threshold.
+argv:
+  - "{target}"
+  - --reporters
+  - json
+  - --silent
+  - --min-lines
+  - "3"
+  - --min-tokens
+  - "20"
+parser: jscpd_json
+success:
+  exit_codes: [0]
+policy:
+  max_duplication_percent: 50
+output_file: report/jscpd-report.json

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/markdownlint.check.yaml

@@ -0,0 +1,17 @@
+id: markdownlint.check
+tool: markdownlint
+name: Markdownlint
+description: Lint Markdown files for style issues.
+argv:
+- -c
+- '{config}'
+- -j
+- '{target}'
+parser: markdownlint_json
+success:
+  exit_codes:
+  - 0
+  - 1
+remediation:
+  suggested_commands:
+  - markdownlint {target}

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/mdformat.apply.yaml

@@ -0,0 +1,10 @@
+id: mdformat.apply
+tool: mdformat
+name: mdformat Apply
+description: Apply Markdown formatting.
+mode: format
+argv:
+  - "{target}"
+parser: noop
+success:
+  exit_codes: [0]

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/mdformat.format.yaml

@@ -0,0 +1,14 @@
+id: mdformat.format
+tool: mdformat
+name: mdformat Check
+description: Verify Markdown formatting without applying changes.
+argv:
+- --check
+- '{target}'
+parser: mdformat_text
+success:
+  exit_codes:
+  - 0
+remediation:
+  suggested_commands:
+  - mdformat {target}

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/mutmut.run.yaml

@@ -0,0 +1,13 @@
+id: mutmut.run
+tool: mutmut
+name: Mutmut Mutation Testing
+description: Run mutation tests (slow; requires [tool.mutmut] in pyproject.toml).
+argv:
+  - run
+parser: mutmut_text
+success:
+  exit_codes: [0]
+remediation:
+  suggested_commands:
+    - mutmut run
+    - mutmut results

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/pydeps.cycles.yaml

@@ -0,0 +1,14 @@
+id: pydeps.cycles
+tool: pydeps
+name: Pydeps Import Cycles
+description: Fail when Python import cycles are detected.
+argv:
+  - "{target}"
+  - --show-cycles
+  - --no-show
+parser: pydeps_cycles_text
+success:
+  exit_codes: [0, 1, 2]
+remediation:
+  suggested_commands:
+    - pydeps {target} --show-cycles --no-show

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/pytest.coverage.yaml

@@ -0,0 +1,19 @@
+id: pytest.coverage
+tool: pytest
+name: Pytest Coverage
+description: Run tests with coverage floor enforcement.
+argv:
+  - "{target}"
+  - --cov={cov}
+  - --cov-report=term-missing
+  - --cov-fail-under=80
+  - -q
+parser: pytest_text
+success:
+  exit_codes: [0]
+policy:
+  min_coverage_percent: 80
+  coverage_source: src/
+remediation:
+  suggested_commands:
+    - pytest {target} --cov={cov}

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/pytest.test.yaml

@@ -0,0 +1,14 @@
+id: pytest.test
+tool: pytest
+name: Pytest
+description: Run the project test suite.
+argv:
+  - "{target}"
+  - -q
+  - --tb=line
+parser: pytest_text
+success:
+  exit_codes: [0]
+remediation:
+  suggested_commands:
+    - pytest {target}

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/radon.cc.yaml

@@ -0,0 +1,13 @@
+id: radon.cc
+tool: radon
+name: Radon Cyclomatic Complexity
+description: Fail when function complexity rank exceeds policy.
+argv:
+  - cc
+  - "{target}"
+  - -j
+parser: radon_cc_json
+success:
+  exit_codes: [0]
+policy:
+  max_complexity_rank: A

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/radon.mi.yaml

@@ -0,0 +1,13 @@
+id: radon.mi
+tool: radon
+name: Radon Maintainability Index
+description: Fail when module maintainability rank exceeds policy.
+argv:
+  - mi
+  - "{target}"
+  - -j
+parser: radon_mi_json
+success:
+  exit_codes: [0]
+policy:
+  max_complexity_rank: A

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/ruff.format.apply.yaml

@@ -0,0 +1,11 @@
+id: ruff.format.apply
+tool: ruff
+name: Ruff Format Apply
+description: Apply Ruff formatting to Python sources.
+mode: format
+argv:
+  - format
+  - "{target}"
+parser: noop
+success:
+  exit_codes: [0]

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/ruff.format.yaml

@@ -0,0 +1,14 @@
+id: ruff.format
+tool: ruff
+name: Ruff Format Check
+description: Verify Python formatting without applying changes.
+argv:
+  - format
+  - --check
+  - "{target}"
+parser: ruff_format_text
+success:
+  exit_codes: [0]
+remediation:
+  suggested_commands:
+    - ruff format {target}

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/ruff.lint.yaml

@@ -0,0 +1,15 @@
+id: ruff.lint
+tool: ruff
+name: Ruff Lint
+description: Run ruff check on Python sources.
+argv:
+  - check
+  - "{target}"
+  - --output-format
+  - json
+parser: ruff_json
+success:
+  exit_codes: [0]
+remediation:
+  suggested_commands:
+    - ruff check --fix {target}

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/ruff.unused.yaml

@@ -0,0 +1,17 @@
+id: ruff.unused
+tool: ruff
+name: Ruff Unused Imports
+description: Detect unused imports and variables (F401, F841).
+argv:
+  - check
+  - "{target}"
+  - --select
+  - F401,F841
+  - --output-format
+  - json
+parser: ruff_json
+success:
+  exit_codes: [0]
+remediation:
+  suggested_commands:
+    - ruff check --select F401,F841 --fix {target}

pyossmtool-0.0.1/src/pyossmtool/bundle/catalog/checks/semgrep.scan.yaml

@@ -0,0 +1,18 @@
+id: semgrep.scan
+tool: semgrep
+name: Semgrep Scan
+description: Static analysis for security and architecture patterns.
+argv:
+  - scan
+  - --config
+  - "{config}"
+  - "{target}"
+  - --error
+  - --json
+  - --quiet
+parser: semgrep_json
+success:
+  exit_codes: [0, 1]
+remediation:
+  suggested_commands:
+    - semgrep scan --config <rules> {target}