It's a plugin for Muffin framework which provides support for external APIs
Project description
Muffin-APIClient – Its a plugin for Muffin framework which provides support for external APIs
Requirements
python >= 3.9
Installation
Muffin-APIClient should be installed using pip:
pip install muffin-apiclient
Usage
Initialize and setup the plugin:
import muffin
import muffin_apiclient
# Create Muffin Application
app = muffin.Application('example')
# Initialize the plugin
# As alternative: apiclient = muffin_apiclient.Plugin(app, **options)
apiclient = muffin_apiclient.Plugin()
apiclient.setup(app, root_url='https://api.github.com')Github API (https://developer.github.com/v4/):
github = muffin_apiclient.Plugin(app, name='github', root_url='https://api.github.com', defaults={
'headers': {
'Authorization': 'token OAUTH-TOKEN'
}
})
# Read information about the current repository
repo = await github.api.repos.klen['muffin-apiclient'].get()
print(repo) # dict parsed from Github Response JSONSlack API (https://api.slack.com/web):
slack = muffin_apiclient.Plugin(app, name='slack', root_url='https://slack.com/api', defaults={
'headers': {
'Authorization': 'token OAUTH-TOKEN'
}
})
# Update current user status (we don't care about this response)
await client.api['users.profile.set'].post(json={
'profile': {
'status_text': 'working',
'status_emoji': ':computer:'
'status_expiration': 30,
}
}, read_response_body=False)And etc
Options
Name |
Default value |
Desctiption |
root_url |
None |
Define general root URL for the client |
timeout |
None |
Define client timeout |
backend_type |
httpx |
APIClient backend (httpx|aiohttp) |
backend_options |
{} |
Backend options |
raise_for_status |
True |
Raise errors for HTTP statuses (300+) |
read_response_body |
True |
Read responses |
parse_response_body |
True |
Parse responses (load json, etc) |
client_defaults |
{} |
Default client values (headers, auth, etc) |
You are able to provide the options when you are initiliazing the plugin:
apiclient.setup(app, root_url='https://api.github.com')Or setup it inside Muffin.Application config using the APICLIENT_ prefix:
APICLIENT_ROOT_URL = 'https://api.github.com'Muffin.Application configuration options are case insensitive
Bug tracker
If you have any suggestions, bug reports or annoyances please report them to the issue tracker at https://github.com/klen/muffin-apiclient/issues
Contributing
Development of Muffin-APIClient happens at: https://github.com/klen/muffin-apiclient
Contributors
klen (Kirill Klenov)
License
Licensed under a MIT license.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file muffin_apiclient-3.8.1.tar.gz.
File metadata
- Download URL: muffin_apiclient-3.8.1.tar.gz
- Upload date:
- Size: 4.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.8.3 CPython/3.10.12 Linux/6.5.0-1024-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c7eafaa16c47bf1c372a53ab7abdd04514f931d08234aa765d703a93b12ac846 |
|
| MD5 | 35097f825f9342fd2936ebf4a832c7d5 |
|
| BLAKE2b-256 | 6225f1c7ffb8f0893b1e677b1445003b3c86370a74f4123123259f8cc95e45db |
File details
Details for the file muffin_apiclient-3.8.1-py3-none-any.whl.
File metadata
- Download URL: muffin_apiclient-3.8.1-py3-none-any.whl
- Upload date:
- Size: 4.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.8.3 CPython/3.10.12 Linux/6.5.0-1024-azure
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e2f7651dd0bfad6b01d91a8a358ded362c462c630a680948c33c6b619d707777 |
|
| MD5 | 7e71911112a1198f3f84d2fc5016ca02 |
|
| BLAKE2b-256 | 4e0763bdf754f1a6099f1cf76e82f7be04b2938a0f21df8c036d645c376f3d60 |
