UAForge 1.1.0__tar.gz

uaforge-1.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bolgac
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

uaforge-1.1.0/PKG-INFO

@@ -0,0 +1,286 @@
+Metadata-Version: 2.4
+Name: UAForge
+Version: 1.1.0
+Summary: A powerful Python library and CLI tool for generating realistic, random user agent strings for Chrome, Firefox, and Opera browsers across multiple platforms.
+Home-page: https://github.com/bolgac/UAForge
+Author: bolgac
+Author-email: bytearchsoft@gmail.com
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Testing
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: beautifulsoup4>=4.13.3
+Requires-Dist: requests>=2.32.3
+Requires-Dist: lxml>=6.0.2
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# UAForge - UserAgent Generator
+
+A powerful Python library and CLI tool for generating realistic, random user agent strings for Chrome, Firefox, and Opera browsers across multiple platforms.
+
+---
+
+## Features
+- **Multi-browser support**: Generate user agents for Chrome, Firefox, and Opera  
+- **Cross-platform**: Supports Windows, Linux, macOS, Android, and iOS  
+- **Real version data**: Uses real browser version information from official sources  
+- **Realistic combinations**: Creates plausible user agent strings that mimic real browsers  
+- **SQLite database**: Stores version data locally for fast access  
+- **Auto-update**: Fetch latest browser versions from official sources  
+- **CLI interface**: Easy command-line usage  
+- **Python API**: Simple integration into Python projects  
+
+---
+
+## Installation
+
+### From PyPI (Recommended)
+```bash
+pip install uaforge
+```
+
+## Quick Start
+
+### Using the CLI
+
+Initialize the database (first-time setup):
+```bash
+uaforge --init
+```
+Generate a single user agent:
+```bash
+# Random browser user agent
+uaforge
+
+# Specific browser
+uaforge --browser Chrome
+uaforge --browser Firefox
+uaforge --browser Opera
+
+# Generate 10 Chrome user agents
+uaforge --count 10 --browser Chrome
+
+# Save to file
+uaforge --count 50 --output useragents.txt --browser Firefox
+```
+
+Update browser versions:
+```bash
+# Update all versions
+uaforge --update all
+
+# Update specific browser
+uaforge --update chrome
+uaforge --update firefox
+uaforge --update opera
+uaforge --update android
+uaforge --update mac
+```
+
+### Using Python API
+
+```bash
+from uaforge import generate_user_agent, generate_multiple, update_versions
+
+# Generate a single user agent
+ua = generate_user_agent("Chrome")
+print(ua)
+
+# Generate multiple user agents
+ua_list = generate_multiple(5)
+for agent in ua_list:
+    print(agent)
+
+# Update browser versions
+update_versions("all")
+```
+
+### Advanced Usage
+```bash
+from uaforge.core.user_agent import UserAgentGenerator
+
+# Create a custom generator
+generator = UserAgentGenerator()
+
+# Generate specific types
+chrome_agent = generator.create_useragent("Chrome")
+firefox_agent = generator.create_useragent("Firefox")
+opera_agent = generator.create_useragent("Opera")
+
+# Get a batch of agents
+agents = generator.get_list(100)
+```
+
+### Command Line Reference
+
+| Option | Short | Description |
+|--------|-------------|-------------|
+|--count | -c | Number of user agents to generate (default: 1) |
+|--browser | -b | Browser type: Chrome, Firefox, Opera, random (default: random) |
+|--output | -o | Output file to save user agents |
+|--update | -u | Update version information: all, chrome, firefox, opera, android, windows, linux, mac |
+|--init |  | Initialize database with initial data |
+|--version | -v | Show version information |
+
+---
+
+## Examples
+```bash
+# Show version
+uaforge --version
+
+# Initialize database
+uaforge --init
+
+# Update all versions
+uaforge --update all
+
+# Generate 5 Firefox user agents
+uaforge --count 5 --browser Firefox
+
+# Generate 100 random user agents and save to file
+uaforge --count 100 --output agents.txt
+
+# Generate a single Chrome user agent
+uaforge --browser Chrome
+```
+
+## Database Structure
+- **Browser versions:** Chrome, Firefox, Opera version history
+- **Platform information:** Windows, Linux, macOS, Android system strings
+- **Version types:** Architecture and build types for each platform
+- **Release dates:** Version release information
+- **Database location:** ~/.useragent_generator/data/useragent.db
+
+---
+
+## Supported Platforms and Browsers
+
+**Browsers**
+- Google Chrome (desktop & mobile)
+- Mozilla Firefox (desktop & mobile)
+- Opera (desktop & mobile)
+
+**Operating Systems**
+- Windows (NT 6.0 to NT 10.0)
+- Linux (X11 variants)
+- macOS (10.15 to 14.0)
+- Android (10 to 14)
+- iOS (simulated via macOS strings)
+
+**Architectures**
+- Windows: x64, WOW64
+- Linux: i686, x86_64
+- Android: armv7l, armv8l
+
+---
+
+## Project Structure
+```bash
+uaforge/
+├── core/
+│   ├── __init__.py        # init file
+│   ├── database.py        # SQLite database operations
+│   ├── user_agent.py      # Main user agent generator
+│   ├── version_fetcher.py # Fetch versions from web
+│   └── version_updater.py # Update database with new versions
+├── data/
+│   └── useragent.db       # SQLite database file
+├── cli.py                 # Command-line interface
+├── utils.py               # Utility functions
+└── __init__.py            # Package exports
+```
+
+## Development
+```bash
+# Clone the repository
+git clone https://github.com/bolgac/uaforge.git
+cd uaforge
+
+# Install in development mode
+pip install -e .[dev]
+
+# Run tests
+python -m pytest
+
+# Build distribution
+python setup.py sdist bdist_wheel
+```
+
+## Common Issues and Solutions
+### Database Not Found
+
+```bash
+uaforge --init
+```
+### Empty User Agents
+
+```bash
+uaforge --update all
+```
+### Network Issues
+- Check your internet connection
+- Use --init for offline mode with sample data
+- Configure proxy if needed
+
+### Permission Errors
+- Run with appropriate permissions
+- Check database file permissions
+
+---
+
+## Contributing
+
+Feel free to fork this project, submit PRs, or suggest features via GitHub Issues!
+
+We welcome contributions of all kinds:
+- Bug reports and fixes
+- New features and enhancements
+- Documentation improvements
+- Testing and code quality improvements
+
+---
+
+## 📬 Contact
+
+- GitHub Issues – for bugs and feedback  
+- Email – `bytearchsoft@gmail.com` (for business inquiries or sponsorships)
+
+---
+
+## License
+This project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for details.
+
+---
+
+## Acknowledgments
+- Browser version data from official sources:
+
+    - [Chrome](https://chromedriver.storage.googleapis.com/)
+    - [Firefox](https://www.mozilla.org/en-US/firefox/releases/)
+    - [Android](https://tr.wikipedia.org/wiki/Android)
+    - [Opera](https://blogs.opera.com/desktop/)
+    - [Mac-Wikipedia](https://en.wikipedia.org/wiki/)
+
+- Inspired by various user agent generation libraries
+- Contributors and testers
+
+---

uaforge-1.1.0/README.md

@@ -0,0 +1,252 @@
+# UAForge - UserAgent Generator
+
+A powerful Python library and CLI tool for generating realistic, random user agent strings for Chrome, Firefox, and Opera browsers across multiple platforms.
+
+---
+
+## Features
+- **Multi-browser support**: Generate user agents for Chrome, Firefox, and Opera  
+- **Cross-platform**: Supports Windows, Linux, macOS, Android, and iOS  
+- **Real version data**: Uses real browser version information from official sources  
+- **Realistic combinations**: Creates plausible user agent strings that mimic real browsers  
+- **SQLite database**: Stores version data locally for fast access  
+- **Auto-update**: Fetch latest browser versions from official sources  
+- **CLI interface**: Easy command-line usage  
+- **Python API**: Simple integration into Python projects  
+
+---
+
+## Installation
+
+### From PyPI (Recommended)
+```bash
+pip install uaforge
+```
+
+## Quick Start
+
+### Using the CLI
+
+Initialize the database (first-time setup):
+```bash
+uaforge --init
+```
+Generate a single user agent:
+```bash
+# Random browser user agent
+uaforge
+
+# Specific browser
+uaforge --browser Chrome
+uaforge --browser Firefox
+uaforge --browser Opera
+
+# Generate 10 Chrome user agents
+uaforge --count 10 --browser Chrome
+
+# Save to file
+uaforge --count 50 --output useragents.txt --browser Firefox
+```
+
+Update browser versions:
+```bash
+# Update all versions
+uaforge --update all
+
+# Update specific browser
+uaforge --update chrome
+uaforge --update firefox
+uaforge --update opera
+uaforge --update android
+uaforge --update mac
+```
+
+### Using Python API
+
+```bash
+from uaforge import generate_user_agent, generate_multiple, update_versions
+
+# Generate a single user agent
+ua = generate_user_agent("Chrome")
+print(ua)
+
+# Generate multiple user agents
+ua_list = generate_multiple(5)
+for agent in ua_list:
+    print(agent)
+
+# Update browser versions
+update_versions("all")
+```
+
+### Advanced Usage
+```bash
+from uaforge.core.user_agent import UserAgentGenerator
+
+# Create a custom generator
+generator = UserAgentGenerator()
+
+# Generate specific types
+chrome_agent = generator.create_useragent("Chrome")
+firefox_agent = generator.create_useragent("Firefox")
+opera_agent = generator.create_useragent("Opera")
+
+# Get a batch of agents
+agents = generator.get_list(100)
+```
+
+### Command Line Reference
+
+| Option | Short | Description |
+|--------|-------------|-------------|
+|--count | -c | Number of user agents to generate (default: 1) |
+|--browser | -b | Browser type: Chrome, Firefox, Opera, random (default: random) |
+|--output | -o | Output file to save user agents |
+|--update | -u | Update version information: all, chrome, firefox, opera, android, windows, linux, mac |
+|--init |  | Initialize database with initial data |
+|--version | -v | Show version information |
+
+---
+
+## Examples
+```bash
+# Show version
+uaforge --version
+
+# Initialize database
+uaforge --init
+
+# Update all versions
+uaforge --update all
+
+# Generate 5 Firefox user agents
+uaforge --count 5 --browser Firefox
+
+# Generate 100 random user agents and save to file
+uaforge --count 100 --output agents.txt
+
+# Generate a single Chrome user agent
+uaforge --browser Chrome
+```
+
+## Database Structure
+- **Browser versions:** Chrome, Firefox, Opera version history
+- **Platform information:** Windows, Linux, macOS, Android system strings
+- **Version types:** Architecture and build types for each platform
+- **Release dates:** Version release information
+- **Database location:** ~/.useragent_generator/data/useragent.db
+
+---
+
+## Supported Platforms and Browsers
+
+**Browsers**
+- Google Chrome (desktop & mobile)
+- Mozilla Firefox (desktop & mobile)
+- Opera (desktop & mobile)
+
+**Operating Systems**
+- Windows (NT 6.0 to NT 10.0)
+- Linux (X11 variants)
+- macOS (10.15 to 14.0)
+- Android (10 to 14)
+- iOS (simulated via macOS strings)
+
+**Architectures**
+- Windows: x64, WOW64
+- Linux: i686, x86_64
+- Android: armv7l, armv8l
+
+---
+
+## Project Structure
+```bash
+uaforge/
+├── core/
+│   ├── __init__.py        # init file
+│   ├── database.py        # SQLite database operations
+│   ├── user_agent.py      # Main user agent generator
+│   ├── version_fetcher.py # Fetch versions from web
+│   └── version_updater.py # Update database with new versions
+├── data/
+│   └── useragent.db       # SQLite database file
+├── cli.py                 # Command-line interface
+├── utils.py               # Utility functions
+└── __init__.py            # Package exports
+```
+
+## Development
+```bash
+# Clone the repository
+git clone https://github.com/bolgac/uaforge.git
+cd uaforge
+
+# Install in development mode
+pip install -e .[dev]
+
+# Run tests
+python -m pytest
+
+# Build distribution
+python setup.py sdist bdist_wheel
+```
+
+## Common Issues and Solutions
+### Database Not Found
+
+```bash
+uaforge --init
+```
+### Empty User Agents
+
+```bash
+uaforge --update all
+```
+### Network Issues
+- Check your internet connection
+- Use --init for offline mode with sample data
+- Configure proxy if needed
+
+### Permission Errors
+- Run with appropriate permissions
+- Check database file permissions
+
+---
+
+## Contributing
+
+Feel free to fork this project, submit PRs, or suggest features via GitHub Issues!
+
+We welcome contributions of all kinds:
+- Bug reports and fixes
+- New features and enhancements
+- Documentation improvements
+- Testing and code quality improvements
+
+---
+
+## 📬 Contact
+
+- GitHub Issues – for bugs and feedback  
+- Email – `bytearchsoft@gmail.com` (for business inquiries or sponsorships)
+
+---
+
+## License
+This project is licensed under the **MIT License** — see the [LICENSE](LICENSE) file for details.
+
+---
+
+## Acknowledgments
+- Browser version data from official sources:
+
+    - [Chrome](https://chromedriver.storage.googleapis.com/)
+    - [Firefox](https://www.mozilla.org/en-US/firefox/releases/)
+    - [Android](https://tr.wikipedia.org/wiki/Android)
+    - [Opera](https://blogs.opera.com/desktop/)
+    - [Mac-Wikipedia](https://en.wikipedia.org/wiki/)
+
+- Inspired by various user agent generation libraries
+- Contributors and testers
+
+---