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
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
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
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, Hammock and many more...
Installation
Library on PyPI so just run
pip install anyapi
159 Dec 26, 2022
4 Nov 19, 2022
57 Dec 17, 2022
20 Dec 3, 2021
65 Nov 22, 2022
66 Nov 23, 2022
0 Feb 16, 2022
24 Dec 29, 2022
4 Dec 30, 2022
1 Dec 15, 2021
9 Nov 16, 2022
2 Nov 29, 2021
1 Jul 04, 2022
19 Dec 29, 2022
11 Mar 19, 2022
1 Oct 22, 2022
24 Jul 19, 2022
37 Dec 27, 2022
66 Dec 07, 2022
2.2k Jan 02, 2023
2 Dec 18, 2021
1.6k Jan 04, 2023
2 Jan 02, 2022
1 Dec 05, 2021
18 Sep 06, 2022
1 Oct 15, 2021
15 Aug 06, 2022
2 Jan 03, 2022
3 Feb 16, 2022