Metadata-Version: 2.1
Name: reqe
Version: 2020.9.17.175617
Summary: A python network request library that will not throw exceptions
Home-page: https://github.com/ophlr/reqe
Author: ophlr
Author-email: niushuaibing@foxmail.com
Maintainer: Eric
Maintainer-email: niushuaibing@foxmail.com
License: apache
Platform: all
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Description-Content-Type: text/markdown
Requires-Dist: requests

# reqe

A python network request library that will not throw exceptions

## Table of Contents

- [Background](#Background)
- [Install](#Install)
- [Usage](#Usage)
- [Reference](#Reference)
- [License](#License)

## Background

When timeout, network connection error, server error, etc., 
`requests` will raise the exception, there will be a lot of `try ... except ...` in the code.


Under the above problems, I developed a `reqe` based on the requests library, which is as simple as requests

## Install

- #### source code

```shell script
git clone git@github.com:ophlr/reqe.git
```

- #### pip
```shell script
pip install reqe
```

## Usage

```python
import reqe

# use default setting, it can be used like request
response = reqe.get("https://www.baidu.com")
if response:
    print(response)

# specify the params that you like
# retries: How many retries, If you don’t want to resend the request, you can set retries to 0
# delay: time between two requests
# backoff: delay = delay * backoff
response = reqe.get("https://www.google.com", retries=3, delay=3, backoff=2)
# when `requests` raises an exception, `reqe` will catch it and let the response be None
if response:
    print(response)


# how to use reqe with session
session = reqe.session()
response = session.get("https://www.google.com", retries=1, delay=3, backoff=2)
print(response)
```

## Reference

- [requests](https://github.com/psf/requests)

## License
[Apache 2.0](./LICENSE)

