urlfetch

urlfetch is a simple, lightweight and easy to use HTTP client for Python. It is distributed as a single file module and has no depencencies other than the Python Standard Library.

Highlights

Distributed as a single file module, has no depencencies other than the Python Standard Library.
Pure Python, works fine with gevent.
Small codebase, about 1300 lines, much of it comments and blank lines. Only 10 minutes you can know every detail.
Random user-agent.
Support streaming.

Installation

$ pip install urlfetch

Hello, world

import urlfetch

response = urlfetch.get('http://python.org/')
print(response.status, response.reason)
print(len(response.content))

Uploading files

import urlfetch

response = urlfetch.post(
    'http://127.0.0.1:8888/upload',
    headers = {
        'Referer': 'http://127.0.0.1/',
    },
    files = {
        'fieldname1': open('/path/to/file', 'rb'),
        #'fieldname2': 'file content', # file must have a filename
        'fieldname3': ('filename', open('/path/to/file2', 'rb')),
        'fieldname4': ('filename', 'file content'),
    },
    data = {
        'foo': 'bar'
    },
)

print(response.status, response.content)

Testing

To run the tests, urlfetch relies on bottle and gunicorn. Install them and run:

$ python tests/testall.py

Releasing

Pushing a version tag publishes the package to PyPI with Trusted Publishing and creates a GitHub Release. The tag must match urlfetch.__version__ (for example v2.0.1).

git tag vX.Y.Z
git push origin vX.Y.Z

Release notes come from the matching section in doc/changelog.rst, followed by GitHub’s auto-generated notes. sdist and wheel are attached to the release.

One-time PyPI setup (project owner)

On https://pypi.org/manage/project/urlfetch/settings/publishing/ add a GitHub Trusted Publisher:

Owner: ifduyue
Repository: urlfetch
Workflow: publish.yml
Environment: pypi

The GitHub environment pypi is restricted to tags matching v*. No PyPI API token is stored in the repository.

Download files

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

Source Distribution

urlfetch-2.2.1.tar.gz (21.7 kB view details)

Uploaded Aug 24, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

urlfetch-2.2.1-py3-none-any.whl (15.0 kB view details)

Uploaded Aug 24, 2026 Python 3

File details

Details for the file urlfetch-2.2.1.tar.gz.

File metadata

Download URL: urlfetch-2.2.1.tar.gz
Upload date: Aug 24, 2026
Size: 21.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for urlfetch-2.2.1.tar.gz
Algorithm	Hash digest
SHA256	`5b520910e6ebc862869cf0377acd3484c8354468652b318707fcafeb23a1a89c`
MD5	`0943566e3be12d8c10d01a4824fa4bac`
BLAKE2b-256	`710bfb58493807ffb720af15701317873c3a3e2636d1ea8110166064578f7ade`

See more details on using hashes here.

Provenance

The following attestation bundles were made for urlfetch-2.2.1.tar.gz:

Publisher: publish.yml on ifduyue/urlfetch

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: urlfetch-2.2.1.tar.gz
- Subject digest: 5b520910e6ebc862869cf0377acd3484c8354468652b318707fcafeb23a1a89c
- Sigstore transparency entry: 2581317410
- Sigstore integration time: Aug 24, 2026
Source repository:
- Permalink: ifduyue/urlfetch@4374a7db0099e32de9eec4c5f1c0ed6218fddfbf
- Branch / Tag: refs/tags/v2.2.1
- Owner: https://github.com/ifduyue
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@4374a7db0099e32de9eec4c5f1c0ed6218fddfbf
- Trigger Event: push