Skip to main content

A HTTP 1.1 client module supporting asynchronous IO, pipelining and `Expect: 100-continue`. Designed for RESTful protocols.

Project description

The Python Dugong module provides an API for communicating with HTTP 1.1 servers. It is an alternative to the standard library’s http.client (formerly httplib) module. In contrast to http.client, Dugong:

  • allows you to send multiple requests right after each other without having to read the responses first.

  • supports waiting for 100-continue before sending the request body.

  • raises an exception instead of silently delivering partial data if the connection is closed before all data has been received.

  • raises one specific exception (ConnectionClosed) if the connection has been closed (while http.client connection may raise any of BrokenPipeError, ~http.client.BadStatusLine, ConnectionAbortedError, ConnectionResetError, ~http.client.IncompleteRead or simply return '' on read)

  • supports non-blocking, asynchronous operation and is compatible with the asyncio module.

  • is not compatible with old HTTP 0.9 or 1.0 servers.

All request and response headers are represented as str, but must be encodable in latin1. Request and response body must be bytes-like objects or binary streams.

Dugong requires Python 3.3 or newer.

Installation

As usual: download the tarball from PyPi, extract it, and run

# python3 setup.py install [--user]

To run the self-tests, install py.test and run

# py.test-3 test/

Getting Help

The documentation can be read online and is also included in the doc/html directory of the dugong tarball.

Please report any bugs on the issue tracker. For discussion and questions, please subscribe to the dugong mailing list.

Development Status

The Dugong API is not yet stable and may change from one release to the other.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dugong-2.2.tar.bz2 (178.5 kB view details)

Uploaded Source

File details

Details for the file dugong-2.2.tar.bz2.

File metadata

  • Download URL: dugong-2.2.tar.bz2
  • Upload date:
  • Size: 178.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for dugong-2.2.tar.bz2
Algorithm Hash digest
SHA256 4dff77cfb23a571e4bbc123e39141437668a4a561771471b0f0e0ea3230e12df
MD5 9fca5ebe723cc82e8e8726fcb0ac73e8
BLAKE2b-256 01b867d4714e7c854b9d62d55b96b146223e7996415a085a6acba49d34baacfb

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page