Metadata-Version: 2.4
Name: fakeua
Version: 0.2.0
Summary: Python module made as a wrapper of fake-useragent.
Author-email: "Carlos A. Planchón" <carlosandresplanchonprestes@gmail.com>
License-Expression: MIT
Project-URL: Repository, https://github.com/carlosplanchon/fakeua
Keywords: fake,useragent,networking,web
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Build Tools
Classifier: Programming Language :: Python :: 3
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: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: fake-useragent
Requires-Dist: typer
Dynamic: license-file

# fakeua
*Python module made as a wrapper of fake-useragent.*

## Rationale:
fake-useragent package (https://github.com/hellysmile/fake-useragent)
have an API which is brittle and too verbose for cases when you just want
predictability and the work done without unnecesary headaches.

## Installation
### Install with uv
```bash
uv add fakeua
```

## Usage
FakeUA can be used from the shell too.

```bash
fakeua -h
```

Or importing its functions.

```python
In [1]: import fakeua

# Update useragent DB in a json file (~/.fakeua_databrowsers.json)
In [2]: fakeua.update_useragent_db()
Out[2]: True

In [3]: fakeua.get_useragent_list()
Out[3]: 
['Mozilla/5.0 (X11; Linux i686; rv:64.0) Gecko/20100101 Firefox/64.0',
 'Mozilla/5.0 (Windows NT 6.1; WOW64; rv:64.0) Gecko/20100101 Firefox/64.0',
 'Mozilla/5.0 (X11; Linux i586; rv:63.0) Gecko/20100101 Firefox/63.0',
 'Mozilla/5.0 (Windows NT 6.2; WOW64; rv:63.0) Gecko/20100101 Firefox/63.0',
 'Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.10; rv:62.0) Gecko/20100101 Firefox/62.0']

In [4]: fakeua.load_useragent_db()                                                 
Out[4]: ...
# It throws a dict containing the browsers scraped by fake-useragent.

In [5]: fakeua.get_random_ua()
Out[5]: 'Mozilla/5.0 (Windows NT 6.2; WOW64; rv:63.0) Gecko/20100101 Firefox/63.0'
```
