scopio 0.1.1__tar.gz

scopio-0.1.1/LICENSE

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

scopio-0.1.1/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: scopio
+Version: 0.1.1
+Summary: Code metrics auditor with SQLite history, diffs and quality gates.
+Author-email: "Gabriel P. Monte" <gabrielpmonte@users.noreply.github.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/gabrielpmonte/scopio
+Project-URL: Repository, https://github.com/gabrielpmonte/scopio
+Project-URL: Issues, https://github.com/gabrielpmonte/scopio/issues
+Keywords: metrics,code-quality,ccn,lizard,scc,audit,ci
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1
+Requires-Dist: tomli>=1.2; python_version < "3.11"
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == "dev"
+Dynamic: license-file
+
+# scopio
+
+Code metrics auditor with SQLite history, diffs and quality gates.
+
+## Install
+
+```bash
+pip install scopio
+```
+
+## Quick Start
+
+```bash
+scopio --config scopio.toml run
+```
+
+## Usage
+
+### Run audit
+
+```bash
+scopio --config scopio.toml run
+scopio --config scopio.toml run --verbose
+scopio --config scopio.toml run --incremental
+```
+
+### Report history
+
+```bash
+scopio report --project wrong-web --limit 10
+```
+
+### Diff between audits
+
+```bash
+scopio diff --project wrong-web
+```
+
+### Diff report with file-level detail
+
+```bash
+scopio diff-report --project wrong-web --files --threshold-ccn 6
+```
+
+### CI integration
+
+```bash
+scopio ci --project wrong-web --fail-on-regression
+```
+
+### Clean old audits
+
+```bash
+scopio clean --keep 50
+```
+
+### Archive old data
+
+```bash
+scopio archive --older-than 2026-01-01 --format csv
+```
+
+### Initialize config
+
+```bash
+scopio init
+```
+
+## Configuration
+
+```toml
+[discovery]
+ignore_hidden = true
+projects = ["my-project"]
+
+[filters]
+global_dirs = ["node_modules", "target", "dist", "build"]
+minified_files = ["*.min.js", "*.min.css"]
+ignored_langs = ["JSON", "Markdown", "TOML"]
+
+[quality_gates]
+max_ccn = 10.0
+max_warnings = 10
+max_ccn_trend_increase = 0.2
+trend_sensitive_projects = []
+
+[quality_gates.per_project]
+# "my-project" = { max_ccn = 12.0, max_warnings = 15 }
+
+[quality_gates.per_language]
+# Python = { max_ccn = 12.0, max_warnings = 20 }
+```
+
+## GitHub Actions
+
+```yaml
+name: Scopio
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  scopio:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install scopio
+        run: pip install scopio
+      - name: Run scopio
+        run: scopio ci --project my-project --fail-on-regression
+```
+
+## License
+
+MIT

scopio-0.1.1/README.md

@@ -0,0 +1,120 @@
+# scopio
+
+Code metrics auditor with SQLite history, diffs and quality gates.
+
+## Install
+
+```bash
+pip install scopio
+```
+
+## Quick Start
+
+```bash
+scopio --config scopio.toml run
+```
+
+## Usage
+
+### Run audit
+
+```bash
+scopio --config scopio.toml run
+scopio --config scopio.toml run --verbose
+scopio --config scopio.toml run --incremental
+```
+
+### Report history
+
+```bash
+scopio report --project wrong-web --limit 10
+```
+
+### Diff between audits
+
+```bash
+scopio diff --project wrong-web
+```
+
+### Diff report with file-level detail
+
+```bash
+scopio diff-report --project wrong-web --files --threshold-ccn 6
+```
+
+### CI integration
+
+```bash
+scopio ci --project wrong-web --fail-on-regression
+```
+
+### Clean old audits
+
+```bash
+scopio clean --keep 50
+```
+
+### Archive old data
+
+```bash
+scopio archive --older-than 2026-01-01 --format csv
+```
+
+### Initialize config
+
+```bash
+scopio init
+```
+
+## Configuration
+
+```toml
+[discovery]
+ignore_hidden = true
+projects = ["my-project"]
+
+[filters]
+global_dirs = ["node_modules", "target", "dist", "build"]
+minified_files = ["*.min.js", "*.min.css"]
+ignored_langs = ["JSON", "Markdown", "TOML"]
+
+[quality_gates]
+max_ccn = 10.0
+max_warnings = 10
+max_ccn_trend_increase = 0.2
+trend_sensitive_projects = []
+
+[quality_gates.per_project]
+# "my-project" = { max_ccn = 12.0, max_warnings = 15 }
+
+[quality_gates.per_language]
+# Python = { max_ccn = 12.0, max_warnings = 20 }
+```
+
+## GitHub Actions
+
+```yaml
+name: Scopio
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  scopio:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+      - name: Install scopio
+        run: pip install scopio
+      - name: Run scopio
+        run: scopio ci --project my-project --fail-on-regression
+```
+
+## License
+
+MIT

scopio-0.1.1/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "scopio"
+version = "0.1.1"
+description = "Code metrics auditor with SQLite history, diffs and quality gates."
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [
+    { name = "Gabriel P. Monte", email = "gabrielpmonte@users.noreply.github.com" },
+]
+keywords = ["metrics", "code-quality", "ccn", "lizard", "scc", "audit", "ci"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Topic :: Software Development :: Quality Assurance",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = ["click>=8.1", "tomli>=1.2; python_version < '3.11'"]
+
+[project.urls]
+Homepage = "https://github.com/gabrielpmonte/scopio"
+Repository = "https://github.com/gabrielpmonte/scopio"
+Issues = "https://github.com/gabrielpmonte/scopio/issues"
+
+[project.scripts]
+scopio = "scopio.cli:cli"
+
+[project.optional-dependencies]
+dev = ["pytest>=8"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

scopio-0.1.1/scopio/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.1"