Skip to main content

An incredibly lightweight wrapper around urllib

Project description


thttp is a single file, lightweight, well-tested wrapper around urllib that's intended to be copied directly into your project.


  • Making GET, POST, PATCH, PUT, HEAD and OPTIONS requests
  • Sending query parameters with your request
  • Encoding JSON payloads for POST, PATCH and PUT requests
  • Enconding form-encoded payloads for POST, PATCH and PUT request
  • Sending custom headers with any request
  • Disabling SSL certificate verification for local testing / corporate proxies
  • Following (or not following) redirects
  • Sending through a CookieJar object that can be reused between requests
  • HTTP basic auth
  • Specifying a custom timeout for your request
  • Decompressing gzipped content in the response
  • Loading JSON from the response
  • Returning error responses instead of throwing exceptions from urllib

Future features:

  • Better detection of JSON responses
  • pretty() function for printing responses
  • Improve handling of non-utf-8 requests
  • Improve handling of non-utf-8 responses

Note: this project is not intended to solve all use cases that can be achieved with urllib, requests or other HTTP libraries. The intent is to provide a lighweight tool that simplifies some of the most common use cases for developers.


Install with pip:

python3 -m pip install thttp

Or, copy directly into your project:

curl >

Basic Usage

See the tests for examples of usage, but, effectively it's as simple as:

from thttp import request

response = request("", params={"data": "empty"})

# {'args': {'data': ['empty']}, 'headers': {'Accept-Encoding': ['identity'], 'Fly-Client-Ip': [''], 'Fly-Forwarded-Port': ['443'], 'Fly-Forwarded-Proto': ['https'], 'Fly-Forwarded-Ssl': ['on'], 'Fly-Region': ['hkg'], 'Fly-Request-Id': ['01F6P2WQAY1NGPRDCXV9H60XW5'], 'Host': [''], 'User-Agent': ['Python-urllib/3.8'], 'Via': ['1.1'], 'X-Forwarded-For': [','], 'X-Forwarded-Port': ['443'], 'X-Forwarded-Proto': ['https'], 'X-Forwarded-Ssl': ['on'], 'X-Request-Start': ['t=1622091390302198']}, 'origin': ',', 'url': ''}

#('request', 'content', 'json', 'status', 'url', 'headers', 'cookiejar')

Running the tests

> python3 -m unittest

And to check the coverage:

> coverage run -m unittest
> coverage html && open htmlcov/index.html

Run black before committing any changes.

> black

Packaging for release

python3 -m build
python3 -m twine upload dist/*

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

thttp-1.0.0.tar.gz (4.7 kB view hashes)

Uploaded source

Built Distribution

thttp-1.0.0-py3-none-any.whl (5.0 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page