Skip to main content

Dependency-free DevOps audit tool — system specs, repo routes, env vars, ports, and network speed.

Project description

server-spec-finder

Dependency-free DevOps audit toolkit for Linux and Windows.

No pip packages required to run. Python 3.8+ only.

pip install server-spec-finder

Commands

System check — OS, CPU, RAM, disks, ports, services, Docker

spec-system

Writes system-spec-report.json / .md / .xlsx / .pdf to the current directory.

spec-system --json /tmp/sys.json --markdown /tmp/sys.md --quiet

Repo check — runtimes, ports, env vars, routes, OpenAPI

spec-repo /path/to/your/server/repos

Writes server-spec-report.json / .md / .xlsx / .pdf.

# Scan a single repo
spec-repo /path/to/DMS-Server-Drive

# Include real .env files (local audit only)
spec-repo . --include-dotenv

# Scan every child folder, not only likely server repos
spec-repo . --all

# Write all formats quietly
spec-repo . --json out.json --markdown out.md --excel out.xlsx --pdf out.pdf --quiet

Output formats

Each command writes four files:

Format Best for
.json Automation, CI pipelines
.md Code review, documentation
.xlsx Sharing with non-technical stakeholders
.pdf Printable handoff reports

The Excel file contains separate sheets (Summary, Routes, Environment, Ports, Health).

Desktop App (Linux / Windows)

A GUI wrapping both tools is available in the repository with System Check, Repo Check, and Network Speed tabs.

git clone https://github.com/Premkumar-CM/server-spec-finder
cd "server-spec-finder/specification check"
python3 app.py

Build a single standalone executable:

bash build.sh          # Linux  → dist/spec-checker
build.bat              # Windows CMD → dist\spec-checker.exe

Drop-in usage (no pip install)

Copy the specification check folder into any server repo and run:

python3 system_spec_finder.py
python3 server_spec_finder.py /path/to/repos

Notes

  • Static analysis only — does not start services or call live endpoints
  • Real .env files are skipped by default; sensitive-looking values are redacted
  • Dynamic route registration and computed paths may need manual review; the JSON output includes file and line references for easy inspection

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

server_spec_finder-1.0.6.tar.gz (27.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

server_spec_finder-1.0.6-py3-none-any.whl (28.8 kB view details)

Uploaded Python 3

File details

Details for the file server_spec_finder-1.0.6.tar.gz.

File metadata

  • Download URL: server_spec_finder-1.0.6.tar.gz
  • Upload date:
  • Size: 27.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for server_spec_finder-1.0.6.tar.gz
Algorithm Hash digest
SHA256 5f6aea016e7e0cfac84033dfcef367b7c471f80656929a6f2b03dbbb11b9a8dc
MD5 be958bc4beb07f8af7864ede8b617640
BLAKE2b-256 6b66e2521a174b04c225fc7570c2f613641bbfaa069764ea1aa5f54db8f84f41

See more details on using hashes here.

File details

Details for the file server_spec_finder-1.0.6-py3-none-any.whl.

File metadata

File hashes

Hashes for server_spec_finder-1.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 521c18a30c207a56ee889b149543d76fe2b0b3431f8777c5c8c3c4601bf6b30d
MD5 9090c5600a42d0bae7b1640b26285a3d
BLAKE2b-256 998dbc6dbfb9e6995e0242009615b465bc0a4bc58a7fef873ac39f2475b53658

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page