Add files via upload

Author: CodebindPyth

docs/index.md

@@ -0,0 +1,30 @@
+# WordbuildPython
+
+A powerful password wordlist generator with optional email/phone validation and breach checking.
+
+## Project overview
+
+This tool helps generate password lists from personal information and validate email/phone formats. It also supports searching the public "Have I Been Pwned?" API for breached accounts.
+
+## Quick start
+
+1. Install dependencies:
+
+```bash
+pip install -r requirements.txt
+```
+
+2. Run the tool:
+
+```bash
+python main.py
+```
+
+3. Choose an option from the interactive menu.
+
+## Included workflows
+
+- GitHub Actions tests and linting
+- Release automation
+- Dependency checks
+- Documentation build pipeline

docs/usage.md

@@ -0,0 +1,46 @@
+# Usage
+
+## Option 1 — Generate a password wordlist
+
+Use this option to build a password list from a target's personal details.
+
+- First name
+- Last name
+- Keywords/interests
+- Partner name
+- Birthday
+- Job
+- Pet name
+- Kids' names
+- City or zipcode
+- Lucky number
+- Phone number
+
+The generator applies transformations such as:
+
+- leet speak
+- alternating capitalization
+- vowel removal
+- reverse text
+- separators and numeric suffixes
+- birthday-based patterns
+- multi-field combinations
+
+## Option 2 — Generate random emails
+
+Generate random email addresses with a custom domain and optional keyword prefix.
+
+## Option 3 — Generate phone numbers
+
+Generate random phone numbers for supported country codes.
+
+## Option 4 — Validate and breach-check
+
+- Validate email format locally
+- Validate phone numbers with the `phonenumbers` library
+- Check a single email against Have I Been Pwned
+- Batch-check emails from a file against Have I Been Pwned
+
+### HIBP rate limiting
+
+The tool waits between requests to avoid abusing the public API and to keep usage respectful.