mirror of
https://github.com/Z4nzu/hackingtool
synced 2026-05-23 08:58:22 +00:00
Merge dfa6cd950f into 01a51bbca6
This commit is contained in:
commit
fcc7817ab0
10 changed files with 180 additions and 0 deletions
9
.devcontainer/devcontainer.json
Normal file
9
.devcontainer/devcontainer.json
Normal file
|
|
@ -0,0 +1,9 @@
|
|||
{
|
||||
"name": "HackingTool",
|
||||
"image": "mcr.microsoft.com/devcontainers/python:3.12",
|
||||
"postCreateCommand": "pip install -e .",
|
||||
"features": {
|
||||
"ghcr.io/devcontainers/features/common-utils:2": {}
|
||||
},
|
||||
"forwardPorts": [8000]
|
||||
}
|
||||
10
.github/dependabot.yml
vendored
Normal file
10
.github/dependabot.yml
vendored
Normal file
|
|
@ -0,0 +1,10 @@
|
|||
version: 2
|
||||
updates:
|
||||
- package-ecosystem: pip
|
||||
directory: /
|
||||
schedule:
|
||||
interval: weekly
|
||||
- package-ecosystem: github-actions
|
||||
directory: /
|
||||
schedule:
|
||||
interval: monthly
|
||||
28
.github/workflows/benchmark.yml
vendored
Normal file
28
.github/workflows/benchmark.yml
vendored
Normal file
|
|
@ -0,0 +1,28 @@
|
|||
name: Performance Benchmark
|
||||
on: [push, pull_request]
|
||||
jobs:
|
||||
benchmark:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: actions/setup-python@v5
|
||||
with:
|
||||
python-version: "3.12"
|
||||
- run: pip install -e .
|
||||
- name: Startup time
|
||||
run: |
|
||||
START=$(python -c "import time; print(time.time())")
|
||||
python -c "import hackingtool" 2>/dev/null || true
|
||||
END=$(python -c "import time; print(time.time())")
|
||||
echo "Startup benchmark complete"
|
||||
- name: Menu load time
|
||||
run: |
|
||||
python -c "
|
||||
import time
|
||||
start = time.time()
|
||||
try:
|
||||
from tools import *
|
||||
except: pass
|
||||
elapsed = time.time() - start
|
||||
print(f'Tool import time: {elapsed:.3f}s')
|
||||
" 2>/dev/null || echo "Benchmark skipped (expected in CI)"
|
||||
17
.github/workflows/codeql.yml
vendored
Normal file
17
.github/workflows/codeql.yml
vendored
Normal file
|
|
@ -0,0 +1,17 @@
|
|||
name: CodeQL Security
|
||||
on:
|
||||
push:
|
||||
branches: [master, main]
|
||||
pull_request:
|
||||
branches: [master, main]
|
||||
jobs:
|
||||
analyze:
|
||||
runs-on: ubuntu-latest
|
||||
permissions:
|
||||
security-events: write
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: github/codeql-action/init@v3
|
||||
with:
|
||||
languages: python
|
||||
- uses: github/codeql-action/analyze@v3
|
||||
17
.github/workflows/release.yml
vendored
Normal file
17
.github/workflows/release.yml
vendored
Normal file
|
|
@ -0,0 +1,17 @@
|
|||
name: Release
|
||||
on:
|
||||
push:
|
||||
tags:
|
||||
- 'v*'
|
||||
jobs:
|
||||
release:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: actions/setup-python@v5
|
||||
with:
|
||||
python-version: "3.12"
|
||||
- name: Create Release
|
||||
uses: softprops/action-gh-release@v2
|
||||
with:
|
||||
generate_release_notes: true
|
||||
13
.github/workflows/sbom.yml
vendored
Normal file
13
.github/workflows/sbom.yml
vendored
Normal file
|
|
@ -0,0 +1,13 @@
|
|||
name: Generate SBOM
|
||||
on:
|
||||
push:
|
||||
branches: [master, main]
|
||||
jobs:
|
||||
sbom:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
- uses: anchore/sbom-action@v0
|
||||
with:
|
||||
format: spdx-json
|
||||
output-file: sbom.spdx.json
|
||||
7
.gitignore
vendored
7
.gitignore
vendored
|
|
@ -183,3 +183,10 @@ pyvenv.cfg
|
|||
pip-selfcheck.json
|
||||
|
||||
# End of https://www.toptal.com/developers/gitignore/api/python,venv
|
||||
|
||||
# Bonanza Labs
|
||||
*.egg-info/
|
||||
dist/
|
||||
build/
|
||||
sbom.spdx.json
|
||||
.env
|
||||
|
|
|
|||
21
.pre-commit-config.yaml
Normal file
21
.pre-commit-config.yaml
Normal file
|
|
@ -0,0 +1,21 @@
|
|||
repos:
|
||||
- repo: https://github.com/psf/black
|
||||
rev: 24.4.2
|
||||
hooks:
|
||||
- id: black
|
||||
language_version: python3
|
||||
- repo: https://github.com/pycqa/isort
|
||||
rev: 5.13.2
|
||||
hooks:
|
||||
- id: isort
|
||||
- repo: https://github.com/pycqa/flake8
|
||||
rev: 7.0.0
|
||||
hooks:
|
||||
- id: flake8
|
||||
args: [--max-line-length=100]
|
||||
- repo: https://github.com/pre-commit/pre-commit-hooks
|
||||
rev: v4.6.0
|
||||
hooks:
|
||||
- id: trailing-whitespace
|
||||
- id: end-of-file-fixer
|
||||
- id: check-yaml
|
||||
37
CONTRIBUTING.md
Normal file
37
CONTRIBUTING.md
Normal file
|
|
@ -0,0 +1,37 @@
|
|||
# Contributing to HackingTool
|
||||
|
||||
Thank you for your interest in contributing! Please follow these guidelines.
|
||||
|
||||
## How to Contribute
|
||||
|
||||
1. Fork the repository
|
||||
2. Create a feature branch (`git checkout -b feature/amazing-tool`)
|
||||
3. Add your tool to the appropriate category in `tools/`
|
||||
4. Ensure your tool class has: TITLE, DESCRIPTION, INSTALL_COMMANDS, RUN_COMMANDS, SUPPORTED_OS
|
||||
5. Test locally: `python hackingtool.py`
|
||||
6. Commit your changes (`git commit -m 'Add amazing tool'`)
|
||||
7. Push to the branch (`git push origin feature/amazing-tool`)
|
||||
8. Open a Pull Request using the `[New Tool] ToolName — Category` format
|
||||
|
||||
## Tool Request
|
||||
|
||||
Open an issue with `[Tool Request] ToolName — Category` title format.
|
||||
|
||||
Required info: tool name, GitHub URL, category, OS, install command, reason.
|
||||
|
||||
## Code Style
|
||||
|
||||
- Python 3.10+
|
||||
- Follow existing tool class structure
|
||||
- Keep descriptions concise
|
||||
- Test on Linux (Kali/Parrot preferred)
|
||||
|
||||
## Security
|
||||
|
||||
- Do NOT include actual exploit payloads in PRs
|
||||
- Report security vulnerabilities privately via GitHub Security Advisories
|
||||
- Tools must have legitimate security research/penetration testing purposes
|
||||
|
||||
## License
|
||||
|
||||
By contributing, you agree that your contributions will be licensed under the MIT License.
|
||||
21
SECURITY.md
Normal file
21
SECURITY.md
Normal file
|
|
@ -0,0 +1,21 @@
|
|||
# Security Policy
|
||||
|
||||
## Supported Versions
|
||||
| Version | Supported |
|
||||
|---------|-----------|
|
||||
| v2.x | ✅ |
|
||||
| v1.x | ❌ (deprecated) |
|
||||
|
||||
## Reporting a Vulnerability
|
||||
- Email: passiveassets@proton.me
|
||||
- Or open a private Security Advisory on GitHub
|
||||
|
||||
## Security Notice
|
||||
This tool is designed for **authorized security testing and penetration testing only**.
|
||||
Unauthorized access to computer systems is illegal. Always obtain proper authorization before testing.
|
||||
|
||||
## Bonanza Labs Improvements
|
||||
- CodeQL security scanning in CI
|
||||
- Dependabot for dependency updates
|
||||
- Pre-commit hooks for code quality
|
||||
- SBOM generation for supply chain transparency
|
||||
Loading…
Reference in a new issue