Skip to main content

Python Simple HTTP Client

Project description


simpleclient "Python Simple HTTP Client" is a simple guzzle-like library built on top of The Standard Python Library. Unlike guzzle, simpleclient is smaller, and not full of features. It is compatible with Python 2.x and 3.x. There is also a php-simple-client written in PHP.


pip install simpleclient

Quick Start

import simpleclient

client = simpleclient.Stream()

Simple GET

Send a GET Request

client.seturl('') # required to set an url

Display Responses

# HTTP/1.1 200 OK
# Date: Mon, 14 Jan 2021 14:14:48 GMT
# Expires: -1
# Cache-Control: private, max-age=0
# Content-Type: text/html; charset=UTF-8
# ...

# HTTP/1.1 200 OK

# text/html; charset=UTF-8

# <!doctype html>...</html>

Custom Requests

Custom requests using the request() method.

client.seturl('') # required to set an url

You can also provide a payload, for example, for a POST request. The payload can be a dictionary, or a string. It will automatically send a 'Content-Type: application/x-www-form-urlencoded' header. You can set it manually with the setheaders() method for other types required.

client.request('POST', {'user': 'myusername', 'pass': 'mypassword'})

Setting Headers To Be Sent

Setting Headers must be done before calling request() and send() method.

    'User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Firefox/78.0',
    'Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
    'Accept-Language: en-US,en;q=0.5'


print(client.getprotocol())        # HTTP
print(client.getprotocolversion()) # 1.1
print(client.getstatuscode())      # 200
print(client.getreasonphrase())    # OK


You can enable debug mode. This will allow you to monitor the request header being sent.

client = simpleclient.Stream(debug=True)
client.seturl('') # required to set an url

# finally, show the response

And other features to hack like the getresponse() method.

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

simpleclient-0.0.5.tar.gz (4.7 kB view hashes)

Uploaded Source

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