Skip to content

Commit 4d8db35

Browse files
author
Saiprashanth Pulisetti
committed
feat(cyber_security): add package scaffold and README
1 parent a71618f commit 4d8db35

2 files changed

Lines changed: 50 additions & 0 deletions

File tree

cyber_security/README.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
# Cyber Security Utilities
2+
3+
Small, self-contained scripts for practical security tasks. Each script can be
4+
run as a module or imported.
5+
6+
## Modules
7+
8+
- password_strength_checker: Estimate password strength (entropy) and provide feedback.
9+
- hash_cracker: Hash cracker using a wordlist, supports md5/sha1/sha256.
10+
- port_scanner: Multithreaded TCP port scanner with banner grabbing.
11+
- file_integrity_monitor: Initialize and verify file integrity baselines.
12+
- url_analyzer: Heuristic URL analyzer for phishing and IDN homograph risks.
13+
14+
## Usage
15+
16+
Run any script as a module:
17+
18+
```bash
19+
python -m cyber_security.password_strength_checker --help
20+
python -m cyber_security.hash_cracker --help
21+
python -m cyber_security.port_scanner --help
22+
python -m cyber_security.file_integrity_monitor --help
23+
python -m cyber_security.url_analyzer --help
24+
```
25+
26+
These are educational utilities and should be used responsibly and legally.

cyber_security/__init__.py

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,24 @@
1+
"""Cyber security utilities.
2+
3+
This package includes small, self-contained scripts useful for learning or
4+
performing basic security-related tasks, such as:
5+
6+
- Password strength estimation
7+
- Hash cracking
8+
- TCP port scanning with banner grabbing
9+
- File integrity monitoring (hash baseline and verification)
10+
- URL analysis with phishing heuristics
11+
12+
Each module is runnable as a script (python -m cyber_security.<module>) and
13+
also importable for use in other code.
14+
"""
15+
16+
__all__ = [
17+
"password_strength_checker",
18+
"hash_cracker",
19+
"port_scanner",
20+
"file_integrity_monitor",
21+
"url_analyzer",
22+
]
23+
24+

0 commit comments

Comments
 (0)