Skip to main content

A simple CLI tool to automate the creation of essential security starter files for your projects. Now with expanded language support and automated checks!

Project description

Project Aegis CLI 2.0

A simple CLI tool to automate the creation of essential security starter files for your projects. Now with expanded language support and automated checks!

The Problem

Every project needs a SECURITY.md file, dependabot.yml config, and basic security guidelines. But it’s a boring, repetitive chore that’s easy to neglect, leaving most projects without them until it's too late.

The Solution

aegis is a command-line tool that handles the grunt work. It scans your project, detects the primary language, and generates essential security starter files from best-practice templates. It turns a 15-minute chore into a 3-second command.

Disclaimer: This is a Starting Point

Let's be clear: this tool is a starting point, not a magic bullet. It generates boilerplate documentation and is NOT a vulnerability scanner, security audit tool, or a replacement for a comprehensive security strategy. You are still responsible for writing secure code and using dedicated security tools.

What's New in 2.0

Version 2.0 expands on the solid foundation of the original release with key features designed to broaden its utility and deepen its integration into your workflow.

  • Expanded Language Support: Aegis now supports Java and Rust alongside Python and JavaScript, making it useful for a wider range of projects.

  • Git Hooks Integration: Automatically ensure your security documentation is in place before you even commit. A new aegis install-hook command sets up a pre-commit Git hook that verifies your security files are present.

Features

  • Multi-Language Detection: Scans your project to identify the language (now supports Python, JavaScript, Java, and Rust).

  • Essential File Generation: Creates the following from proven templates: - .github/dependabot.yml: A ready-to-use config to keep dependencies updated via GitHub. - security/SECURITY.md: A solid, customizable policy for vulnerability reporting. - security/SecureCodingGuide.md: A language-specific checklist for secure coding practices.

  • Automated Compliance: Optional pre-commit hook to prevent commits if security files are missing.

  • Safe & Customizable: Use --dry-run to preview changes without writing files and --output to specify a custom directory.

Installation

Install directly from PyPI:

pip install aegis-cli

Or, to contribute, clone the repository and install in editable mode:

git clone [https://github.com/JamesTheGiblet/Project-Aegis-CLI.git](https://github.com/JamesTheGiblet/Project-Aegis-CLI.git)
cd Project-Aegis-CLI
pip install -e .[test]

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

aegis_cli-2.0.0.tar.gz (14.7 kB view details)

Uploaded Source

Built Distribution

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

aegis_cli-2.0.0-py3-none-any.whl (16.0 kB view details)

Uploaded Python 3

File details

Details for the file aegis_cli-2.0.0.tar.gz.

File metadata

  • Download URL: aegis_cli-2.0.0.tar.gz
  • Upload date:
  • Size: 14.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.3

File hashes

Hashes for aegis_cli-2.0.0.tar.gz
Algorithm Hash digest
SHA256 e7424e66ccfa56be55c98dac2b19d4b6477f63ce32744466d945744b71b4a53f
MD5 0935ad52d2eee37eae6643b09ec586d4
BLAKE2b-256 d45992567754c6e3fcc0e5f1455104f87553cff044b6486d5d2d76c913f9ca4f

See more details on using hashes here.

File details

Details for the file aegis_cli-2.0.0-py3-none-any.whl.

File metadata

  • Download URL: aegis_cli-2.0.0-py3-none-any.whl
  • Upload date:
  • Size: 16.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.3

File hashes

Hashes for aegis_cli-2.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a551a55e231a7b819bed77eb0eba6c75fe128ba1191ec99b38593f13c56ae429
MD5 ad2f528227059af27f7b8e5b0a639000
BLAKE2b-256 48e80242fc8752f65e313c5b01d0afcbe0cfa90e8f883106bb6983f8abbd253f

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