Metadata-Version: 2.4
Name: useragentgen
Version: 1.0
Summary: Random User-Agent string generator with embedded browser templates
Project-URL: Homepage, https://github.com/Masrkai/useragentgen
Project-URL: Repository, https://github.com/Masrkai/useragentgen
Project-URL: Issues, https://github.com/Masrkai/useragentgen/issues
Author: Masrkai
License: MIT
License-File: LICENSE
Keywords: browser,fake-user-agent,http,scraping,testing,user-agent
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# useragentgen

Random User-Agent string generator for Chrome, Firefox, Safari, Edge, and Opera.
All browser templates are **embedded inside the package** — no external files needed after install.

## Installation

```bash
pip install useragentgen
```

## Quick start

```python
import useragentgen

# Single UA, random browser
useragentgen.generate()

# Single UA, specific browser
useragentgen.generate("chrome")
useragentgen.generate("firefox")
useragentgen.generate("safari")
useragentgen.generate("edge")
useragentgen.generate("opera")

# Batch generation
useragentgen.generate_many(10)            # 10 random-browser UAs
useragentgen.generate_many(5, "chrome")   # 5 Chrome UAs
```

Reproducible output with a seed:

```python
import useragentgen

useragentgen.init(42)
print(useragentgen.generate("chrome"))  # same result every run
```

## Supported browsers

| Key        | Covers                         |
|------------|-------------------------------|
| `chrome`   | Windows, macOS, Linux, Android |
| `firefox`  | All platforms                  |
| `safari`   | macOS, iOS, Windows            |
| `edge`     | Windows, macOS, Linux, Android |
| `opera`    | Windows, macOS, Linux          |

## License

[MIT License Copyright (c) 2026 Masrkai, rights reserved](LICENSE)
