py-smart-verify 1.0.0__tar.gz

py_smart_verify-1.0.0/.gitignore

@@ -0,0 +1,24 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# py-smart-verify generated artifacts
+.py_smart_verify/
+
+# py-smart-test generated artifacts (dependency)
+.py_smart_test/
+
+# Logs
+*.log
+.ruff_cache/
+.mypy_cache/
+.pytest_cache/
+.coverage
+htmlcov/

py_smart_verify-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jinto AG
+
+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.

py_smart_verify-1.0.0/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: py-smart-verify
+Version: 1.0.0
+Summary: Professional Python verification CLI tool combining linting, type checking, and smart testing
+Project-URL: Homepage, https://github.com/jinto-ag/py_smart_verify
+Project-URL: Repository, https://github.com/jinto-ag/py_smart_verify
+Project-URL: Issues, https://github.com/jinto-ag/py_smart_verify/issues
+Author: Jinto AG
+License: MIT
+License-File: LICENSE
+Keywords: cli,linting,quality,testing,type-checking,verification
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+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
+Classifier: Topic :: Software Development :: Testing
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: py-smart-test>=1.3.0
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: rich>=14.3.2
+Requires-Dist: typer>=0.23.1
+Provides-Extra: all-tools
+Requires-Dist: black>=26.1.0; extra == 'all-tools'
+Requires-Dist: coverage>=7.13.4; extra == 'all-tools'
+Requires-Dist: flake8>=7.3.0; extra == 'all-tools'
+Requires-Dist: isort>=7.0.0; extra == 'all-tools'
+Requires-Dist: pylance>=2.0.1; extra == 'all-tools'
+Requires-Dist: pyright>=1.1.408; extra == 'all-tools'
+Requires-Dist: pytest>=9.0.2; extra == 'all-tools'
+Requires-Dist: ruff>=0.15.1; extra == 'all-tools'
+Provides-Extra: dev
+Requires-Dist: coverage>=7.13.4; extra == 'dev'
+Requires-Dist: pytest>=9.0.2; extra == 'dev'
+Provides-Extra: mcp
+Requires-Dist: mcp[cli]>=1.0.0; extra == 'mcp'
+Description-Content-Type: text/markdown
+
+# py-smart-verify
+
+Professional Python verification CLI tool combining linting, type checking, and smart testing into a single command.
+
+## Features
+
+- **Unified pipeline** - Run formatters, linters, type checkers, and tests in one command
+- **Smart testing** - Only run tests affected by your changes (via [py-smart-test](https://pypi.org/project/py-smart-test/))
+- **Caching** - Skip steps that haven't changed since the last run
+- **Dependency graph** - Detect circular dependencies and visualize module relationships
+- **Code analysis** - Check architecture guidelines, import patterns, and coding standards
+
+## Installation
+
+```bash
+pip install py-smart-verify
+```
+
+Or with [uv](https://github.com/astral-sh/uv):
+
+```bash
+uv add py-smart-verify
+```
+
+### Optional tools
+
+Install all supported verification tools:
+
+```bash
+pip install py-smart-verify[all-tools]
+```
+
+## Quick start
+
+```bash
+# Run all quality checks (format, lint, type check, analyze)
+py-smart-verify verify quality
+
+# Run tests (smart mode - only affected tests)
+py-smart-verify verify tests
+
+# Run everything
+py-smart-verify verify
+
+# Use the short alias
+pyv verify quality
+```
+
+## Commands
+
+### `verify`
+
+Run verification checks on Python code.
+
+```bash
+# Run specific tasks
+py-smart-verify verify ruff mypy
+
+# Run with options
+py-smart-verify verify --no-cache --continue quality
+py-smart-verify verify --paths src,lib --full-tests
+py-smart-verify verify --staged tests  # pre-commit mode
+```
+
+**Options:**
+
+| Flag           | Description                                 |
+| -------------- | ------------------------------------------- |
+| `--no-cache`   | Disable caching                             |
+| `--continue`   | Continue after errors (default: fast-fail)  |
+| `--paths`      | Paths to verify (comma-separated)           |
+| `--full-tests` | Run all tests with smart prioritization     |
+| `--staged`     | Test only staged changes (pre-commit mode)  |
+| `--since REF`  | Git ref for smart test diff (default: main) |
+| `--skip-tests` | Skip test execution                         |
+| `-v`           | Verbose output                              |
+
+### `graph`
+
+Build and display the dependency graph.
+
+```bash
+py-smart-verify graph
+py-smart-verify graph --output deps.json
+```
+
+### `affected`
+
+List tests affected by code changes.
+
+```bash
+py-smart-verify affected
+py-smart-verify affected --since main --json
+```
+
+### `regen-graph`
+
+Regenerate the py-smart-test dependency graph.
+
+```bash
+py-smart-verify regen-graph
+```
+
+## Available tasks
+
+| Category          | Tasks                                                                   |
+| ----------------- | ----------------------------------------------------------------------- |
+| **Formatters**    | `format` (black), `isort`, `ruff-fix`                                   |
+| **Linters**       | `flake8`, `pyflakes`                                                    |
+| **Type checkers** | `mypy`, `pyright`, `basedpyright`                                       |
+| **Analyzers**     | `architecture`, `standards`, `imports`, `circular-deps`, `deprecations` |
+| **Testing**       | `tests`, `full-tests`, `e2e-tests`, `full-e2e-tests`                    |
+| **Composite**     | `quality` (all formatters + linters + type checkers + analyzers)        |
+
+## Requirements
+
+- Python 3.11+
+- Individual tools (ruff, mypy, etc.) installed separately or via `py-smart-verify[all-tools]`
+
+## License
+
+[MIT](LICENSE)

py_smart_verify-1.0.0/README.md

@@ -0,0 +1,122 @@
+# py-smart-verify
+
+Professional Python verification CLI tool combining linting, type checking, and smart testing into a single command.
+
+## Features
+
+- **Unified pipeline** - Run formatters, linters, type checkers, and tests in one command
+- **Smart testing** - Only run tests affected by your changes (via [py-smart-test](https://pypi.org/project/py-smart-test/))
+- **Caching** - Skip steps that haven't changed since the last run
+- **Dependency graph** - Detect circular dependencies and visualize module relationships
+- **Code analysis** - Check architecture guidelines, import patterns, and coding standards
+
+## Installation
+
+```bash
+pip install py-smart-verify
+```
+
+Or with [uv](https://github.com/astral-sh/uv):
+
+```bash
+uv add py-smart-verify
+```
+
+### Optional tools
+
+Install all supported verification tools:
+
+```bash
+pip install py-smart-verify[all-tools]
+```
+
+## Quick start
+
+```bash
+# Run all quality checks (format, lint, type check, analyze)
+py-smart-verify verify quality
+
+# Run tests (smart mode - only affected tests)
+py-smart-verify verify tests
+
+# Run everything
+py-smart-verify verify
+
+# Use the short alias
+pyv verify quality
+```
+
+## Commands
+
+### `verify`
+
+Run verification checks on Python code.
+
+```bash
+# Run specific tasks
+py-smart-verify verify ruff mypy
+
+# Run with options
+py-smart-verify verify --no-cache --continue quality
+py-smart-verify verify --paths src,lib --full-tests
+py-smart-verify verify --staged tests  # pre-commit mode
+```
+
+**Options:**
+
+| Flag           | Description                                 |
+| -------------- | ------------------------------------------- |
+| `--no-cache`   | Disable caching                             |
+| `--continue`   | Continue after errors (default: fast-fail)  |
+| `--paths`      | Paths to verify (comma-separated)           |
+| `--full-tests` | Run all tests with smart prioritization     |
+| `--staged`     | Test only staged changes (pre-commit mode)  |
+| `--since REF`  | Git ref for smart test diff (default: main) |
+| `--skip-tests` | Skip test execution                         |
+| `-v`           | Verbose output                              |
+
+### `graph`
+
+Build and display the dependency graph.
+
+```bash
+py-smart-verify graph
+py-smart-verify graph --output deps.json
+```
+
+### `affected`
+
+List tests affected by code changes.
+
+```bash
+py-smart-verify affected
+py-smart-verify affected --since main --json
+```
+
+### `regen-graph`
+
+Regenerate the py-smart-test dependency graph.
+
+```bash
+py-smart-verify regen-graph
+```
+
+## Available tasks
+
+| Category          | Tasks                                                                   |
+| ----------------- | ----------------------------------------------------------------------- |
+| **Formatters**    | `format` (black), `isort`, `ruff-fix`                                   |
+| **Linters**       | `flake8`, `pyflakes`                                                    |
+| **Type checkers** | `mypy`, `pyright`, `basedpyright`                                       |
+| **Analyzers**     | `architecture`, `standards`, `imports`, `circular-deps`, `deprecations` |
+| **Testing**       | `tests`, `full-tests`, `e2e-tests`, `full-e2e-tests`                    |
+| **Composite**     | `quality` (all formatters + linters + type checkers + analyzers)        |
+
+## Requirements
+
+- Python 3.11+
+- Individual tools (ruff, mypy, etc.) installed separately or via `py-smart-verify[all-tools]`
+
+## License
+
+[MIT](LICENSE)

py_smart_verify-1.0.0/pyproject.toml

@@ -0,0 +1,273 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "py-smart-verify"
+version = "1.0.0"
+description = "Professional Python verification CLI tool combining linting, type checking, and smart testing"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [{ name = "Jinto AG" }]
+keywords = [
+    "linting",
+    "type-checking",
+    "testing",
+    "verification",
+    "cli",
+    "quality",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Software Development :: Testing",
+    "Typing :: Typed",
+]
+dependencies = [
+    "pydantic>=2.12.5",
+    "rich>=14.3.2",
+    "typer>=0.23.1",
+    "py-smart-test>=1.3.0",
+]
+
+[project.optional-dependencies]
+all-tools = [
+    "black>=26.1.0",
+    "coverage>=7.13.4",
+    "flake8>=7.3.0",
+    "isort>=7.0.0",
+    "pylance>=2.0.1",
+    "pyright>=1.1.408",
+    "pytest>=9.0.2",
+    "ruff>=0.15.1",
+]
+dev = ["pytest>=9.0.2", "coverage>=7.13.4"]
+mcp = ["mcp[cli]>=1.0.0"]
+
+[project.urls]
+Homepage = "https://github.com/jinto-ag/py_smart_verify"
+Repository = "https://github.com/jinto-ag/py_smart_verify"
+Issues = "https://github.com/jinto-ag/py_smart_verify/issues"
+
+[project.scripts]
+py-smart-verify = "py_smart_verify.cli:app"
+pyv = "py_smart_verify.cli:app"
+py-smart-verify-mcp = "py_smart_verify.mcp_server:main"
+
+# ---------------------------------------------------------------------------
+# Build
+# ---------------------------------------------------------------------------
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/py_smart_verify"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/py_smart_verify", "tests", "pyproject.toml", "README.md", "LICENSE"]
+
+# ---------------------------------------------------------------------------
+# py-smart-test
+# ---------------------------------------------------------------------------
+
+[tool.py-smart-test]
+src_dir = "src"
+packages = ["py_smart_verify"]
+test_dir = "tests"
+default_branch = "main"
+
+# ---------------------------------------------------------------------------
+# Black
+# ---------------------------------------------------------------------------
+
+[tool.black]
+line-length = 100
+target-version = ["py311"]
+
+# ---------------------------------------------------------------------------
+# isort
+# ---------------------------------------------------------------------------
+
+[tool.isort]
+profile = "black"
+line_length = 100
+known_first_party = ["py_smart_verify"]
+src_paths = ["src", "tests"]
+
+# ---------------------------------------------------------------------------
+# Ruff (linter + formatter)
+# ---------------------------------------------------------------------------
+
+[tool.ruff]
+target-version = "py311"
+line-length = 100
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # pyflakes
+    "I",   # isort
+    "UP",  # pyupgrade
+    "B",   # flake8-bugbear
+    "SIM", # flake8-simplify
+    "RUF", # ruff-specific rules
+]
+ignore = [
+    "E501",   # line too long (handled by formatter)
+    "SIM108", # ternary operator (readability preference)
+]
+
+[tool.ruff.lint.per-file-ignores]
+"tests/*" = ["F841", "E402"]
+"tests/**/*" = ["F841", "E402"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["py_smart_verify"]
+
+# ---------------------------------------------------------------------------
+# Mypy
+# ---------------------------------------------------------------------------
+
+[tool.mypy]
+python_version = "3.11"
+strict = true
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+packages = ["py_smart_verify"]
+mypy_path = "src"
+
+[[tool.mypy.overrides]]
+module = "tests.*"
+disallow_untyped_defs = false
+allow_untyped_defs = true
+
+# ---------------------------------------------------------------------------
+# Basedpyright
+# ---------------------------------------------------------------------------
+
+[tool.basedpyright]
+pythonVersion = "3.11"
+typeCheckingMode = "standard"
+venvPath = "."
+venv = ".venv"
+
+# ---------------------------------------------------------------------------
+# Pytest
+# ---------------------------------------------------------------------------
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+addopts = "-q --tb=short"
+
+# ---------------------------------------------------------------------------
+# Coverage
+# ---------------------------------------------------------------------------
+
+[tool.coverage.run]
+source = ["py_smart_verify"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+skip_empty = true
+exclude_lines = [
+    "pragma: no cover",
+    "if __name__ == .__main__.",
+    "if TYPE_CHECKING:",
+    "pass",
+    "\\.\\.\\.",
+]
+
+# ---------------------------------------------------------------------------
+# Dependency groups (PEP 735)
+# ---------------------------------------------------------------------------
+
+[dependency-groups]
+dev = [
+    "basedpyright>=1.38.0",
+    "black>=26.1.0",
+    "commitizen>=4.1.0",
+    "coverage>=7.13.4",
+    "flake8>=7.3.0",
+    "git-cliff>=2.6.1",
+    "interrogate>=1.7.0",
+    "isort>=7.0.0",
+    "mcp[cli]>=1.0.0",
+    "mypy>=1.19.1",
+    "pip-audit>=2.10.0",
+    "pip-licenses>=5.5.1",
+    "pre-commit>=4.0.1",
+    "pyflakes>=3.4.0",
+    "pylance>=2.0.1",
+    "pyright>=1.1.408",
+    "pytest>=9.0.2",
+    "pytest-cov>=7.0.0",
+    "ruff>=0.15.1",
+]
+
+# ---------------------------------------------------------------------------
+# Commitizen (conventional commits)
+# ---------------------------------------------------------------------------
+
+[tool.commitizen]
+name = "cz_conventional_commits"
+version = "1.0.0"
+tag_format = "v$version"
+changelog_file = "CHANGELOG.md"
+update_changelog_on_bump = true
+major_version_zero = true
+
+[tool.commitizen.customize]
+message_template = "{{change_type}}{{scope}}: {{message}}\n\n{{body}}"
+schema_pattern = "(?s)(build|ci|docs|feat|fix|perf|refactor|style|test|chore|revert)(\\((?P<scope>[\\w\\-]+)\\))?!?(?P<breaking>!)?:\\s(?P<subject>[\\w\\s]+)(?:\\n\\n(?P<body>.*))?"
+
+[[tool.commitizen.customize.questions]]
+type = "list"
+name = "change_type"
+message = "Select the type of change you are committing"
+choices = [
+    { value = "feat", name = "feat: A new feature" },
+    { value = "fix", name = "fix: A bug fix" },
+    { value = "docs", name = "docs: Documentation only changes" },
+    { value = "style", name = "style: Changes that do not affect the meaning of the code" },
+    { value = "refactor", name = "refactor: A code change that neither fixes a bug nor adds a feature" },
+    { value = "perf", name = "perf: A code change that improves performance" },
+    { value = "test", name = "test: Adding missing or correcting existing tests" },
+    { value = "build", name = "build: Changes that affect the build system or external dependencies" },
+    { value = "ci", name = "ci: Changes to CI configuration files and scripts" },
+    { value = "chore", name = "chore: Other changes that don't modify src or test files" },
+    { value = "revert", name = "revert: Revert to a commit" },
+]
+
+[[tool.commitizen.customize.questions]]
+type = "list"
+name = "scope"
+message = "Select the scope of this change"
+choices = [
+    { value = "core", name = "core: Core functionality and main logic" },
+    { value = "tasks", name = "tasks: Verification tasks (linters, type checkers, analyzers)" },
+    { value = "cli", name = "cli: CLI interface and commands" },
+    { value = "config", name = "config: Configuration and setup files" },
+    { value = "ci", name = "ci: CI/CD and development tooling" },
+    { value = "docs", name = "docs: Documentation and README" },
+]
+
+[[tool.commitizen.customize.questions]]
+type = "input"
+name = "message"
+message = "Write a short, imperative tense description of the change"
+
+[[tool.commitizen.customize.questions]]
+type = "input"
+name = "body"
+message = "Provide a longer description of the change (optional)"

py_smart_verify-1.0.0/src/py_smart_verify/__init__.py

@@ -0,0 +1,4 @@
+"""py-smart-verify: Professional Python verification CLI tool."""
+
+__version__ = "1.0.0"
+__app_name__ = "py-smart-verify"

py_smart_verify-1.0.0/src/py_smart_verify/__main__.py

@@ -0,0 +1,6 @@
+"""Python -m support for py-smart-verify."""
+
+from py_smart_verify.cli import app
+
+if __name__ == "__main__":
+    app()

py_smart_verify-1.0.0/src/py_smart_verify/cache.py

@@ -0,0 +1,76 @@
+"""Caching system for py-smart-verify."""
+
+import hashlib
+from pathlib import Path
+
+
+class CacheManager:
+    """Manages caching of verification scopes."""
+
+    def __init__(self, cache_dir: Path) -> None:
+        """Initialize cache manager."""
+        self.cache_dir = cache_dir
+        self.cache_dir.mkdir(parents=True, exist_ok=True)
+
+    def compute_hash(
+        self, scope: str, file_paths: list[Path], tool_versions: dict[str, str]
+    ) -> str:
+        """Compute SHA256 hash of file contents + tool versions."""
+        hasher = hashlib.sha256()
+
+        # Hash file contents
+        for file_path in sorted(file_paths):
+            if file_path.exists():
+                with open(file_path, "rb") as f:
+                    hasher.update(f.read())
+
+        # Hash tool versions
+        for tool, version in sorted(tool_versions.items()):
+            hasher.update(f"{tool}:{version}".encode())
+
+        return hasher.hexdigest()
+
+    def is_cached(self, scope: str) -> bool:
+        """Check if scope is cached and valid."""
+        marker = self.cache_dir / f".{scope}.ok"
+        return marker.exists()
+
+    def mark_ok(self, scope: str, duration: float) -> None:
+        """Mark scope as successfully cached."""
+        ok_file = self.cache_dir / f".{scope}.ok"
+        time_file = self.cache_dir / f".{scope}.time"
+
+        ok_file.write_text("ok")
+        time_file.write_text(str(duration))
+
+    def get_last_duration(self, scope: str) -> float | None:
+        """Get duration of last successful run."""
+        time_file = self.cache_dir / f".{scope}.time"
+        if time_file.exists():
+            try:
+                return float(time_file.read_text())
+            except (ValueError, OSError):
+                return None
+        return None
+
+    def invalidate(self, scope: str) -> None:
+        """Invalidate cache for a scope."""
+        for pattern in [f".{scope}.ok", f".{scope}.time", f".{scope}.hash"]:
+            file_path = self.cache_dir / pattern
+            if file_path.exists():
+                file_path.unlink()
+
+    def save_hash(self, scope: str, file_hash: str) -> None:
+        """Save hash for a scope."""
+        hash_file = self.cache_dir / f".{scope}.hash"
+        hash_file.write_text(file_hash)
+
+    def get_saved_hash(self, scope: str) -> str | None:
+        """Get saved hash for a scope."""
+        hash_file = self.cache_dir / f".{scope}.hash"
+        if hash_file.exists():
+            try:
+                return hash_file.read_text().strip()
+            except OSError:
+                return None
+        return None