Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

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.
  • can in most cases distinguish between an unavailable DNS server and an unresolvable hostname.
  • 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 with the pytest-catchlog plugin and run

# python3 -m pytest 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 BitBucket 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. Starting with version 3.5, Dugong uses semantic versioning. This means changes in the API will be reflected in an increase of the major version number, i.e. the next backwards-incompatible version will be 4.0. Projects designed for e.g. version 3.5 of Dugong are thus recommended to declare a dependency on dugong >= 3.5, < 4.0.

Contributing

The LLFUSE source code is available both on GitHub and BitBucket.

Release History

Release History

This version
History Node

3.7.1

History Node

3.7

History Node

3.6

History Node

3.5

History Node

3.4

History Node

3.3

History Node

3.2

History Node

3.1

History Node

3.0

History Node

2.2

History Node

2.1

History Node

2.0

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
dugong-3.7.1.tar.bz2 (194.2 kB) Copy SHA256 Checksum SHA256 Source Jun 15, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting