Metadata-Version: 2.1
Name: requestspwn
Version: 1.0.0
Summary: Drop-in replacement for the requests library with random user agents as default.
Home-page: https://github.com/pietroferretti/requestspwn
Author: Pietro Ferretti
Author-email: me@pietroferretti.com
License: MIT
Project-URL: Source, https://github.com/pietroferretti/requestspwn
Keywords: ctf http
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: requests

# requestspwn
Drop-in replacement for the `requests` library with random user agents as default. Designed for Attack/Defense CTF competitions.

## Installation
```
$ pip install requestspwn
```

## Usage
Just replace the import lines like this:

* `import requests` to `import requestspwn as requests`
* `from requests` to `from requestspwn`

Example:

```python
from requestspwn import get
r = get('https://www.example.com')
```

Additionally, you can provide a list of user agents to choose from:

```python
from requestspwn import get
user_agents = [
	"Mozilla/5.0 (Windows NT 6.3; WOW64;Trident/7.0; rv:11.0) like Gecko",
	"Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:49.0) Gecko/20100101 Firefox/49.0"
]
r = get('https://www.example.com', user_agents=user_agents)
```

You can also use one of the datasets provided by default:

```python
from requestspwn import get
r = get('https://www.example.com', user_agents='ructfe2017')
```

## Additional notes
`requestspwn` will use a random user agent as default. If you pass a custom User-Agent header in the `headers` parameter, `requestspwn` will NOT replace it.

`requestspwn` wraps the `request`, `head`, `get`, `post`, `put`, `patch`, `delete`, `options` functions, and nothing else.

