Skip to main content
https://github.com/sendgrid/sendgrid-python/raw/master/twilio_sendgrid_logo.png

Build Status Email Notifications Badge Twitter Follow Codecov branch Code Climate Python Versions PyPI Version GitHub contributors MIT licensed

Quickly and easily access any RESTful or RESTful-like API.

If you are looking for the Twilio SendGrid API client library, please see this repo.

Table of Contents

Installation

Prerequisites

  • Python version 2.7 or 3.4+

Install Package

pip install python_http_client

or

easy_install python_http_client

API Key

Store your Twilio SendGrid API key in a .env file.

cp .env_sample .env

Edit the .env file and add your API key.

Quick Start

Here is a quick example:

GET /your/api/{param}/call

import python_http_client

global_headers = {"Authorization": "Basic XXXXXXX"}
client = Client(host='base_url', request_headers=global_headers)
client.your.api._(param).call.get()
print(response.status_code)
print(response.headers)
print(response.body)

POST /your/api/{param}/call with headers, query parameters and a request body with versioning.

import python_http_client

global_headers = {"Authorization": "Basic XXXXXXX"}
client = Client(host='base_url', request_headers=global_headers)
query_params = {"hello":0, "world":1}
request_headers = {"X-Test": "test"}
data = {"some": 1, "awesome": 2, "data": 3}
response = client.your.api._(param).call.post(request_body=data,
                                              query_params=query_params,
                                              request_headers=request_headers)
print(response.status_code)
print(response.headers)
print(response.body)

Usage

Roadmap

If you are interested in the future direction of this project, please take a look at our milestones. We would love to hear your feedback.

How to Contribute

We encourage contribution to our projects, please see our CONTRIBUTING guide for details.

Quick links:

Local Setup of the Project

The simplest local development workflow is by using docker.

  1. Install Docker

  2. Run docker-compose build (this builds the container)

  3. Run docker-compose up (this runs tests by default)

Troubleshooting

Please see our troubleshooting guide for any issues.

Announcements

All updates to this project is documented in our CHANGELOG.

Thanks

We were inspired by the work done on birdy and universalclient.

About

python-http-client is guided and supported by the Twilio SendGrid Developer Experience Team.

python-http-client is maintained and funded by Twilio SendGrid, Inc. The names and logos for python-http-client are trademarks of Twilio SendGrid, Inc.

License

The MIT License (MIT)

Metadata

Release files for python-http-client 3.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-http-client 3.2.0
File Size Uploaded
python_http_client-3.2.0.tar.gz 8.9 kB Details

Built distributions (wheels)

Table of built distributions (wheels) for python-http-client 3.2.0
File Interpreter ABI Platform
python_http_client-3.2.0-py3-none-any.whl Python 3 none any Details
python_http_client-3.2.0-py2-none-any.whl Python 2 none any Details

Total release size: 34.3 kB

Release files / python_http_client-3.2.0.tar.gz

Download URL python_http_client-3.2.0.tar.gz
Size 8.9 kB
Tags Source
SHA-256 checksum
How to use checksums
5e3d393835b064a7ad71a6e88b71009a7773e85606bd13d9591e16442ada0c52
BLAKE2b-256 checksum
How to use checksums
6c45e6b484c28263f3553125c7049dd43abbed9705e9a384c7bb51fa27116800
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.14.0 pkginfo/1.5.0.1 requests/2.12.1 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/2.7.16

Release files / python_http_client-3.2.0-py3-none-any.whl

Download URL python_http_client-3.2.0-py3-none-any.whl
Size 12.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
942a3cd9015d1da25ef8febe66c8c4dcf71e4df0d20f01cee89257a528111b97
BLAKE2b-256 checksum
How to use checksums
253a3e11eb59382dc2859b9327a4c7ce0bd9697f059c05e706ffc6068e2da356
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.14.0 pkginfo/1.5.0.1 requests/2.12.1 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/2.7.16

Release files / python_http_client-3.2.0-py2-none-any.whl

Download URL python_http_client-3.2.0-py2-none-any.whl
Size 12.7 kB
Tags Python 2
SHA-256 checksum
How to use checksums
eaea36b6bffc1530eb31311588570d6a5b8a9b124c1a6e08d09a5dc8a92a092f
BLAKE2b-256 checksum
How to use checksums
1516c00bb82937874010243ec4fd885b137d35661f724a7248eb5d24dca9428e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.14.0 pkginfo/1.5.0.1 requests/2.12.1 setuptools/41.0.1 requests-toolbelt/0.9.1 tqdm/4.35.0 CPython/2.7.16

Release history Release notifications | RSS feed

3.3.7

2 release files

3.3.6

2 release files

3.3.5

2 release files

3.3.4

2 release files

3.3.3

2 release files

3.3.2

1 release file

3.3.1

1 release file

3.3.0

1 release file

3.2.7

1 release file

3.2.6

1 release file

3.2.5

1 release file

3.2.4

1 release file

3.2.1

3 release files

This release

3.2.0 This release

3 release files

3.1.0

3 release files

3.0.0

2 release files

2.4.0

2 release files

2.3.0

2 release files

2.2.1

2 release files

2.2.0

2 release files

2.1.1

2 release files

2.1.0

2 release files

2.0.0

2 release files

1.2.4

2 release files

1.2.3

2 release files

1.1.3

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.1.0

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page