Python Simple HTTP Client
Project description
simpleclient
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.
Install
pip install simpleclient
Quick Start
import simpleclient
client = simpleclient.Stream()
Simple GET
Send a GET Request
client.seturl('https://www.google.com/') # required to set an url
client.send()
Display Responses
print(client.getheader())
# 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
# ...
print(client.getheader(0))
# HTTP/1.1 200 OK
print(client.getheader('Content-Type'))
# text/html; charset=UTF-8
print(client.getbody())
# <!doctype html>...</html>
Custom Requests
Custom requests using the request() method.
client.seturl('https://www.google.com/') # required to set an url
client.request('HEAD')
client.send()
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.
client.setheaders([
'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'
])
Common
print(client.getprotocol()) # HTTP
print(client.getprotocolversion()) # 1.1
print(client.getstatuscode()) # 200
print(client.getreasonphrase()) # OK
Debug
You can enable debug mode. This will allow you to monitor the request header being sent.
client = simpleclient.Stream(debug=True)
client.seturl('https://www.google.com/') # required to set an url
client.request('HEAD')
client.send()
# finally, show the response
print(client.getheader())
And other features to hack like the getresponse() method.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
