pywreck
=======

A compact HTTP/1.1 client that's "good enough" for many cases. The code has no dependencies, is a single source file, and implements no advanced parsing or error handling. For more detailed parameter descriptions, see the :doc:`api` page.

Quickstart
==========

Install
-------

.. code-block:: sh

   pip install pywreck

Usage
-----

Lowercased HTTP methods are available for use directly on the :py:mod:`pywreck` module.
Additionally, :py:meth:`pywreck.request` is provided for custom HTTP methods.

.. code-block:: python

    response = await pywreck.get("www.example.com", "/")
    print(response.status, response.headers, response.data)


.. toctree::
    :hidden:

    api

Reusing Connections
===================

Creating TCP connections and negotiating TLS can sometimes be expensive. An API
is provided to allow for multiple HTTP requests on the same connection.

.. code-block:: python

    async with await pywreck.Connection.create("www.example.com") as conn:
        for _ in range(2):
            response = await conn.request("HEAD", "/")
            print(response)