Skip to main content

A CLI tool to detect secrets in repositories for maintaining best security practices.

Project description

PyPI version
Python versions
Build Status
License: MIT

secchecker

secchecker is a Python package + CLI tool to detect hidden or untracked hardcoded secrets in repositories, helping developers keep their projects secure and audit-ready.

✨ Features

  • Detects common secret types:
    • Database credentials (Postgres, MySQL, Mongo)
    • Cloud keys (AWS, GCP, Azure)
    • Authentication tokens (JWTs, Private Keys)
    • Generic API keys & passwords in configs
  • Generates JSON and Markdown reports
  • Easy CLI usage for DevSecOps pipelines

🚀 Installation

Clone the repository and install in editable mode:

git clone https://github.com/yourusername/secchecker.git
cd secchecker
pip install -e .

🛠 Usage

Scan a repository or project folder:

secchecker path/to/scan --format md

Options:

  • --format json → generate JSON report
  • --format md → generate Markdown report

Example:

secchecker . --format json

⚠️ Disclaimer

secchecker is intended only for security auditing of repositories you own or have explicit permission to test.

  • Misuse of this tool to access, scan, or extract information from systems you do not own is strictly prohibited and may violate the law.
  • The author(s) assume no liability for misuse or damages caused by this software.

📜 Terms & Conditions

By using secchecker, you agree to the following:

  1. You will only use this tool on codebases you own or have explicit authorization to audit.
  2. You will not use this software for malicious purposes, including but not limited to unauthorized access, exploitation, or data theft.
  3. The software is provided “as is,” without warranty of any kind, express or implied.
  4. The author(s) are not responsible for any damages, losses, or legal consequences arising from the use or misuse of this software.
  5. You accept full responsibility for ensuring that your use of this tool complies with applicable laws and regulations in your jurisdiction.

🤝 Contributing

Contributions are welcome!

  • Fork the repo
  • Create a feature branch
  • Submit a pull request 🚀

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

secchecker-0.1.3.tar.gz (6.7 kB view details)

Uploaded Source

Built Distribution

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

secchecker-0.1.3-py3-none-any.whl (7.1 kB view details)

Uploaded Python 3

File details

Details for the file secchecker-0.1.3.tar.gz.

File metadata

  • Download URL: secchecker-0.1.3.tar.gz
  • Upload date:
  • Size: 6.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for secchecker-0.1.3.tar.gz
Algorithm Hash digest
SHA256 e11a28727101fb173b572d3124236f7f3eef2d09007604f8b666869e06356089
MD5 e0af79c436194b8078f6290fe12110eb
BLAKE2b-256 fe80a8c55db3be53ec041c175ca00b6dfd69e94b571f74fe8a64a1d1115822ff

See more details on using hashes here.

File details

Details for the file secchecker-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: secchecker-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 7.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.2

File hashes

Hashes for secchecker-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 5348a43cd292b702a5d32d6b941bde8a1db079de381ea20cd92fef411ba84ecd
MD5 43717db0e855a4842b4b413d732b2ee4
BLAKE2b-256 8d04426c2e84f013ed1aa5a3657ececb1e6d9d2d1930e1201681dae2842d9932

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