opskit 0.1.0__py3-none-any.whl

opskit-0.1.0.dist-info/METADATA

@@ -0,0 +1,171 @@
+Metadata-Version: 2.4
+Name: opskit
+Version: 0.1.0
+Summary: Cross-platform diagnostics for engineers — one toolkit, every OS.
+Project-URL: Homepage, https://github.com/Prabhakar-cg/opskit
+Project-URL: Repository, https://github.com/Prabhakar-cg/opskit
+Project-URL: Issues, https://github.com/Prabhakar-cg/opskit/issues
+Project-URL: Changelog, https://github.com/Prabhakar-cg/opskit/blob/main/CHANGELOG.md
+Author: prabhakar-cg
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,diagnostics,dns,networking,ops,troubleshooting
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Networking
+Classifier: Topic :: Utilities
+Classifier: Typing :: Typed
+Requires-Python: >=3.9.2
+Requires-Dist: cryptography<49,>=48.0.1
+Requires-Dist: dnspython<3,>=2.6
+Requires-Dist: platformdirs<5,>=4
+Requires-Dist: pyopenssl<27,>=24
+Requires-Dist: rich<16,>=13
+Requires-Dist: tomli>=2; python_version < '3.11'
+Requires-Dist: typer<1,>=0.12
+Provides-Extra: dev
+Requires-Dist: dnslib>=0.9; extra == 'dev'
+Requires-Dist: hypothesis>=6; extra == 'dev'
+Requires-Dist: mypy>=1.11; extra == 'dev'
+Requires-Dist: nox>=2024.4; (python_version >= '3.10') and extra == 'dev'
+Requires-Dist: pip-audit>=2.7; (python_version >= '3.10') and extra == 'dev'
+Requires-Dist: pre-commit>=3.7; (python_version >= '3.10') and extra == 'dev'
+Requires-Dist: pyright>=1.1.380; extra == 'dev'
+Requires-Dist: pytest-cov>=5; extra == 'dev'
+Requires-Dist: pytest>=8; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# opskit
+
+Cross-platform diagnostics for engineers — one toolkit, every OS.
+
+[![CI](https://github.com/Prabhakar-cg/opskit/actions/workflows/ci.yml/badge.svg)](https://github.com/Prabhakar-cg/opskit/actions/workflows/ci.yml)
+[![CodeQL](https://github.com/Prabhakar-cg/opskit/actions/workflows/codeql.yml/badge.svg)](https://github.com/Prabhakar-cg/opskit/actions/workflows/codeql.yml)
+[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/Prabhakar-cg/opskit/badge)](https://securityscorecards.dev/viewer/?uri=github.com/Prabhakar-cg/opskit)
+[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/13462/badge)](https://www.bestpractices.dev/projects/13462)
+[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=Prabhakar-cg_opskit&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=Prabhakar-cg_opskit)
+[![Known Vulnerabilities](https://snyk.io/test/github/Prabhakar-cg/opskit/badge.svg)](https://snyk.io/test/github/Prabhakar-cg/opskit)
+![CodeRabbit Pull Request Reviews](https://img.shields.io/coderabbit/prs/github/Prabhakar-cg/opskit?utm_source=oss&utm_medium=github&utm_campaign=Prabhakar-cg%2Fopskit&labelColor=171717&color=FF570A&link=https%3A%2F%2Fcoderabbit.ai&label=CodeRabbit+Reviews)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python](https://img.shields.io/badge/python-3.9%20|%203.10%20|%203.11%20|%203.12%20|%203.13-blue)](pyproject.toml)
+
+**opskit** gives engineers, developers, and operations teams one consistent set of read-only
+troubleshooting commands that behave **identically on Windows, macOS, and Linux** — so you stop
+juggling `nslookup` vs `dig` vs PowerShell cmdlets. It's a **CLI *and* an importable Python
+library**, is pure-Python (nothing to shell out to), and never phones home.
+
+> ⚠️ **Early development.** v1 ships **DNS diagnostics**; network / TLS / AD categories follow.
+
+---
+
+## Contents
+
+- [Install](#install)
+- [Commands](#commands)
+- [Why opskit](#why-opskit)
+- [Output & exit codes](#output--exit-codes)
+- [Development](#development)
+- [Security](#security)
+- [License](#license)
+
+---
+
+## Install
+
+```bash
+pip install opskit            # once published
+# or, from source:
+git clone https://github.com/Prabhakar-cg/opskit && cd opskit
+uv sync                       # or: pip install -e .
+```
+
+Everything lives under a single command; each category is a sub-command group:
+
+```bash
+opskit --help                 # top-level help
+opskit dns --help             # the DNS command group
+opskit dns lookup --help      # a specific command (grouped options + examples)
+```
+
+## Commands
+
+Each command group is self-contained and documented in its own README next to the code:
+
+| Command group | What it does | Docs |
+|---|---|---|
+| `opskit dns` | Read-only DNS diagnostics — forward/reverse lookups, multi-resolver diff, iterative trace, watch | [dns/README.md](src/opskit/dns/README.md) |
+| `opskit tls` | TLS verification — layered endpoint checks, certificate/chain inspection, expiry warnings, private-PKI trust | [tls/README.md](src/opskit/tls/README.md) |
+| `opskit net` | Network reachability (TCP connect, port checks) — the connect primitive already ships as the `opskit.net` library | _planned_ |
+| `opskit ad` | Directory (LDAP/AD) queries | _planned_ |
+
+Quick taste of the DNS group:
+
+```bash
+opskit dns lookup example.com                    # A records, pretty table
+opskit dns lookup example.com --all              # every common record type at once
+opskit dns reverse 8.8.8.8                       # PTR (IP → hostname)
+opskit dns lookup example.com --diff -s 1.1.1.1 -s 8.8.8.8   # compare resolvers
+```
+
+See **[the DNS command reference](src/opskit/dns/README.md)** for every option, mode, and the
+importable Python API.
+
+## Why opskit
+
+- **One tool, every OS.** Identical behavior and output on Windows, macOS, and Linux — no more
+  remembering which flag `nslookup` uses versus `dig` versus `Resolve-DnsName`.
+- **CLI *and* library.** Every capability is importable, typed, and API-first; the CLI is a thin
+  client over it. Ships `py.typed`.
+- **Scriptable by design.** A stable, versioned `--json` envelope, NDJSON `--jsonl`, and
+  structured exit codes make it safe to build automation on.
+- **Read-only & private.** Only performs the diagnostic you asked for; no telemetry, no phoning
+  home, no offensive/abuse features.
+
+## Output & exit codes
+
+Every command shares one output contract:
+
+- **Human** (default): colorized tables, auto-plain when piped; honors `NO_COLOR` and `--no-color`.
+- **`--json`**: a stable, versioned envelope (`schema_version`, `command`, `query`, `result`,
+  `error`, `elapsed_ms`); an array for batches.
+- **`--jsonl`**: NDJSON — one envelope per line, ideal for `jq` / streaming.
+- **Exit codes** are documented and scriptable (`0` success, `2` usage error, `7` partial, plus
+  category-specific codes). See each command's README for the full table.
+
+## Development
+
+Built to a high bar: `src/` layout, [uv](https://docs.astral.sh/uv/), Ruff, `mypy --strict` +
+pyright, pytest with ≥90% coverage, and a hardened CI/CD pipeline (see [`docs/PLAN.md`](docs/PLAN.md)
+and the project constitution in [`.specify/memory/constitution.md`](.specify/memory/constitution.md)).
+
+```bash
+uv sync --extra dev
+uv run opskit dns lookup example.com     # run the CLI
+uv run ruff format --check . && uv run ruff check .   # format + lint
+uv run mypy && uv run pyright                         # types
+uv run pytest                            # tests (coverage ≥ 90%)
+```
+
+These are exactly the gates CI runs on every pull request — see
+[`.github/workflows/ci.yml`](.github/workflows/ci.yml).
+
+Contributions go through PRs into a protected `main` (squash-merge, Conventional Commits).
+
+## Security
+
+Report vulnerabilities privately — see [SECURITY.md](SECURITY.md). Every PR is gated by a full
+scanner suite (pip-audit, Ruff `S`, CodeQL, secret scanning, dependency review, SonarCloud, Snyk).
+
+## License
+
+[MIT](LICENSE) © `prabhakar-cg`. Provided as-is, without warranty.

opskit-0.1.0.dist-info/RECORD

@@ -0,0 +1,35 @@
+opskit/__init__.py,sha256=RENuuWvZ25oyaOeaBJjFJ_7yvStrWkdBQ_BMi6Rd-jk,522
+opskit/__main__.py,sha256=F51GXYwlWZeK-5I1i6Ej120dJ1fTFCnXzHVed46axcc,159
+opskit/cli.py,sha256=hC_ijfELBDi0XHarSlxT_9JAsNDEv1AteKnwgpEEfVk,1255
+opskit/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+opskit/core/__init__.py,sha256=qRjrZtI6DY1TgBOcxVaxq1bTdSzjse3vu4jn_HXAxMs,339
+opskit/core/cliutils.py,sha256=zD2muKXjcGfY9b78LyCMf-SVhXh7L4bP2cpcOVCw9XA,5970
+opskit/core/errors.py,sha256=14wmEkbB_JeeuotMAe3ey5u5L-h23uWCqMwpPLSrdb8,1275
+opskit/core/exit_codes.py,sha256=VI1dpefkiQ9M_UHu7fgx7pyIPxPM9E5x4lF7nwYS1pw,991
+opskit/core/output.py,sha256=d9-oLIU2m38-a8LwunG6Uhc29wubdxMP2YHdazsIy_w,757
+opskit/core/result.py,sha256=9Lqumml1RFNd9pYrMKvgTYsK6K7crGWfXDN1YftUE58,1186
+opskit/dns/README.md,sha256=LlettX_pFyN6F5PmN1Aq0OASC_WGcZkiZR-uFM9TASk,6999
+opskit/dns/__init__.py,sha256=3nWA5SChFDO3h4cbFBYvZxlPNfoSherJXg3zulWXr8E,1102
+opskit/dns/api.py,sha256=gtY92G2gg5l2oWnD3Lqvvliif5hAMrdOWnpNneyXo70,12968
+opskit/dns/cli.py,sha256=Lwb1zBDCR_idKR5FMero_UBOzXDJpJwOVbb4L7NTos0,19253
+opskit/dns/errors.py,sha256=Lgu5DhYNQiRhypqHc3P9JI6iuz6wXsQ-NH88RFCFWNs,1084
+opskit/dns/models.py,sha256=qRQ3lg2Gimo2oF_v2WddzQVqY4LuVsj039yy0ZxhppI,5653
+opskit/dns/output.py,sha256=uskOo3vnZ4oXn8TI0hizEXDUPvEJrwesdRXEPwvwB88,3385
+opskit/dns/resolver.py,sha256=k1A1upD_tYkwTWuaSW14ELtc_yQ100yMlvZ3belBcZc,9123
+opskit/net/__init__.py,sha256=ITamWIiSqB7ek7nGd7eBMgvGAFC_4jsXYcP1R7d8N_s,641
+opskit/net/errors.py,sha256=LxkfVups2WfpNZ-Ko44BjYJsQRxPi6f2zo1P5og6_b0,1092
+opskit/net/tcp.py,sha256=J2PXPEMApWXbyYcbcMbceXt7gozRWejcGQmm8ulLvOQ,6023
+opskit/tls/README.md,sha256=Yk0PbMAlzSS64FvfwOhq0NRkHG4qjNIPjXMuHE-ljIE,6655
+opskit/tls/__init__.py,sha256=3lHFBINOCWC7AgIcEUrUpuoas8KYeuPhP3tAKBNmYJw,845
+opskit/tls/api.py,sha256=dqpQf1QKXVHLiMyxwIUZXZNFed47Tltmf1_IsqS-r2s,5457
+opskit/tls/cli.py,sha256=UCQBuzo_4LUbRgYMGSecXMN2Zfm-C2TNDGR6BssOY3s,8536
+opskit/tls/errors.py,sha256=OSoZZI5e-iUgIzivKBT7FiZpE4Wpzxov4Yj0OrAFTHg,1852
+opskit/tls/handshake.py,sha256=mTjemcuo4AB-3vj7Hdu2LrtDZ2j-MDW6T6by12sr66s,10070
+opskit/tls/inspect.py,sha256=WJg5RYJvIiXTH25TElbUqtjfb0njrTEAlzeK4G4jj4c,9881
+opskit/tls/models.py,sha256=mWY_dNYpBP7IyUSHLg5pYocevv24oXGTSe1lcbNQMCs,7834
+opskit/tls/output.py,sha256=I30b0JDorwtrni9R6oX7iCtE-0ziBq-g0WAxsbhCyjg,3307
+opskit-0.1.0.dist-info/METADATA,sha256=kjDVdAxreQJNfh3G29u4roWPRr8IMWEjQwPM6SFVTjg,8120
+opskit-0.1.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+opskit-0.1.0.dist-info/entry_points.txt,sha256=-s20XnEY1-fuebLs8s9xi6a2ZOjGm9MmKP8ixnCQtsU,43
+opskit-0.1.0.dist-info/licenses/LICENSE,sha256=NWQaI0KLknzrx-KPkUoVMbkzho91Ms014AV85ao-wfE,1069
+opskit-0.1.0.dist-info/RECORD,,

opskit-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

opskit-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+opskit = opskit.cli:main

opskit-0.1.0.dist-info/licenses/LICENSE

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