معرفی شرکت ها
clients-1.3
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
HTTP for humanitarians.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | OS Independent |
| نام فایل | clients-1.3 |
| نام | clients |
| نسخه کتابخانه | 1.3 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Aric Coady |
| ایمیل نویسنده | aric.coady@gmail.com |
| آدرس صفحه اصلی | https://github.com/coady/clients |
| آدرس اینترنتی | https://pypi.org/project/clients/ |
| مجوز | Apache Software License |
[](https://pypi.org/project/clients/)
[](https://pepy.tech/project/clients)
[](https://github.com/coady/clients/actions)
[](https://codecov.io/gh/coady/clients/)
[](https://github.com/coady/clients/security/code-scanning)
[](https://pypi.org/project/black/)
[](http://mypy-lang.org/)
Clients provide [requests](https://python-requests.org) and [httpx](https://www.encode.io/httpx) wrappers which encourage best practices, particularly always using Sessions to connect to the same host or api endpoint.
`httpx` is on track to reach 1.0 status before `requests3` is available, and natively supports a base URL on its client. The next version of `clients` is planned to use only `httpx`.
## Usage
Typical [requests](https://python-requests.org) usage is redundant and inefficient, by not taking advantage of connection pooling.
```python
r = requests.get('https://api.github.com/user', headers={'authorization': token})
r = requests.get('https://api.github.com/user/repos', headers={'authorization': token})
```
Using sessions is the better approach, but more verbose and in practice requires manual url joining.
```python
s = requests.Session()
s.headers['authorization'] = token
r = s.get('https://api.github.com/user')
r = s.get('https://api.github.com/user/repos')
```
### Client
Clients make using sessions easier, with implicit url joining.
```python
client = clients.Client('https://api.github.com/', headers={'authorization': token})
r = client.get('user')
r = client.get('user/repos')
```
### Resource
Resources extend Clients to implicitly handle response content, with proper checking of status_code and content-type.
```python
github = clients.Resource('https://api.github.com/', headers={'authorization': token})
for repo in github.get('user/repos', params={'visibility': 'public'}):
...
```
Resources also implement syntactic support for methods such as __getattr__ and __call__, providing most of the benefits of custom clients as is.
```python
for repo in github.user.repos(visibility='public'):
...
```
Asynchronous variants of all client types are provided, using [httpx](https://www.encode.io/httpx) instead of [requests](https://python-requests.org). Additional clients for [RPC](https://en.wikipedia.org/wiki/Remote_procedure_call), [GraphQL](http://graphql.org), and proxies also provided.
## Installation
```console
% pip install clients
```
## Dependencies
* requests >=2.23
* httpx >=0.15
## Tests
100% branch coverage.
```console
% pytest [--cov]
```
## Changes
1.3
* httpx >=0.15 required
* requests deprecated
1.2
* Python 3 required
* httpx >=0.11 required
1.1
* Async switched to httpx
1.0
* Allow missing content-type
* Oauth access tokens supported in authorization header
0.5
* `AsyncClient` default params
* `Remote` and `AsyncRemote` procedure calls
* `Graph` and `AsyncGraph` execute GraphQL queries
* `Proxy` and `AsyncProxy` clients
0.4
* Asynchronous clients and resources
0.3
* `singleton` decorator
0.2
* Resource attribute upcasts back to a `client`
* `iter` and `download` implement GET requests with streamed content
* `create` implements POST request and returns Location header
* `update` implements PATCH request with json params
* `__call__` implements GET request with params
نیازمندی
| مقدار | نام |
|---|---|
| >=2.23 | requests |
| >=0.15 | httpx |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.6 | Python |
نحوه نصب
نصب پکیج whl clients-1.3:
pip install clients-1.3.whl
نصب پکیج tar.gz clients-1.3:
pip install clients-1.3.tar.gz