Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/FKLC/AnyAPI
AnyAPI is a library that helps you to write any API wrapper with ease and in pythonic way.
https://github.com/FKLC/AnyAPI
api api-client api-wrapper apis python python-requests python3
Last synced: about 2 months ago
JSON representation
AnyAPI is a library that helps you to write any API wrapper with ease and in pythonic way.
- Host: GitHub
- URL: https://github.com/FKLC/AnyAPI
- Owner: FKLC
- License: mit
- Archived: true
- Created: 2019-01-16T11:45:45.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2021-11-07T19:55:11.000Z (almost 3 years ago)
- Last Synced: 2024-06-28T05:36:18.233Z (3 months ago)
- Topics: api, api-client, api-wrapper, apis, python, python-requests, python3
- Language: Python
- Homepage:
- Size: 31.3 KB
- Stars: 132
- Watchers: 6
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AnyAPI
AnyAPI is a library that helps you to write any API wrappers with ease and in pythonic way.
### Features
- Have better looking code using dynamic method calls.
- Filters to help you to modify request, raise errors or log requests instead of writing functions everywhere.
- Scoped calls to raise errors and take action if necessary.
- Automatic retrying if the condition met with what you passed.
- Built-in rate limit proxy changer. (you can write your own proxy handler)
- Since it is built on top of requests anything compatible with it is compatible with AnyAPI.
But most importantly in AnyAPI almost everything is modular!
---
### Examples
Making GET request to https://httpbin.org/anything/endpoint
```python
from anyapi import AnyAPI
base_url = 'https://httpbin.org'
api = AnyAPI(base_url)
api.anything.endpoint.GET()
```
As you can see dots are pretended as slash and at the end you should put dot and HTTP method you want to use in capital letters.
---
Setting header before every request
```python
import datetime
from anyapi import AnyAPI
def set_date_as_header(kwargs):
now = datetime.datetime.now()
kwargs['headers'].update({'date': now.strftime('%B %d %Y')})
return kwargs
api = AnyAPI('https://httpbin.org')
api._filter_request.append(set_date_as_header)
print(api.anything.endpoint.GET().json())
# output
{
'args': {},
'data': '',
'files': {},
'form': {},
'headers': {
'Accept-Encoding': 'identity',
'Connection': 'close',
'Date': 'January 16 2019',
'Host': 'httpbin.org'
},
'json': None,
'method': 'GET',
'origin': 'XX.XX.XX.XX',
'url': 'https://httpbin.org/anything/endpoint'
}
```
As you can see filter worked as expected and set `Date` header.
---
Changing proxy automatically after they reach their rate limit
```python
from anyapi import AnyAPI
from anyapi.proxy_handlers import RateLimitProxy
proxy_configuration = {
'default': proxy0,
'proxies': [proxy0, proxy1, proxy2,....], # don't forget to add default proxy!
'paths': {
'/anything': rate_limit0,
'/anything/endpoint': rate_limit1
}
}
api = AnyAPI('https://httpbin.org', proxy_configuration=proxy_configuration, proxy_handler=RateLimitProxy)
for i in range(10):
print(api.anything.endpoint.GET().json())
```
If you check output of the all them you can see proxy changes when it reaches limit.
### This library is not a new thing
There is a lot of libraries you can find out there for example [Uplink](https://github.com/prkumar/uplink/), [Hammock](https://github.com/kadirpekel/hammock) and many more...
---
## Installation
Library on PyPI so just run
```console
pip install anyapi
```
# To learn more about AnyAPI check [wiki page](https://github.com/FKLC/AnyAPI/wiki/)