Requests: A Powerful Python Library for Simplifying HTTP Requests

Hi, friends! I’m Big Cat, and today I’m going to introduce you to a super useful Python library for web requests – Requests!

In web development, we often need to fetch data from the internet or send data requests to a server. While it’s possible to handle HTTP requests manually, the process is complex and prone to errors. This is where the third-party library Requests comes in handy, making it extremely easy to send web requests using Python!

Installing Requests

First, we need to install this library. Run the following command in your terminal:

pip install requests

Once installed, you can import Requests in your code:

import requests

Sending a GET Request

Sending a GET request is super simple, just one line of code:

response = requests.get('http://www.example.com')

Wow, isn’t it very concise? The response object response contains all the information returned by the server, such as:

print(response.status_code)  # Print the status code
print(response.text)         # Print the response content (in text format)

Tip: For non-plain text responses, such as images or binary data, you can use response.content to get the raw byte stream of the response.

Sending a GET Request with Parameters

Often, we need to add query parameters to the URL, like search keywords. In this case, you can pass a dictionary as the params argument:

params = {'q': 'cats', 'size': 'large'}
response = requests.get('http://example.com/search', params=params)

Requests will automatically encode the parameters and append them to the URL.

Sending a POST Request

Sending a POST request is similar, but you need to put the data in the data parameter:

data = {'name': 'Big Cat', 'age': 5}
response = requests.post('http://example.com/submit', data=data)

Note that for POST requests, the data will be automatically encoded as application/x-www-form-urlencoded. If you want to send raw binary data, you can use the files parameter instead of data.

Setting Request Headers

Sometimes the server requires us to provide special request headers, such as User-Agent. Requests allows us to customize request headers:

headers = {'User-Agent': 'MyCoolBrowser/1.0'}
response = requests.get('http://example.com', headers=headers)

Handling Response Data

The content returned by the server can be HTML, JSON, or other formats. We can use the corresponding attributes of the Response object to get different formats of the response:

# Get HTML response
html = response.text

# Get JSON response, returns a Python dictionary
json_data = response.json()

# Get binary response, like images, files, etc.
binary_data = response.content

Note: Before getting the JSON response, ensure that the response’s Content-Type is application/json, otherwise it will throw an exception.

Handling Exceptions

Sometimes requests may fail, such as when the server is down or the network is interrupted. Requests automatically captures exceptions for us, and we can catch exceptions defined in the requests.exceptions module for handling:

import requests
from requests.exceptions import RequestException

try:
    response = requests.get('http://example.com')
except RequestException as e:
    print('Request failed:', e)
else:
    print('Request successful!')

Friends! Today we learned about the Requests library together, and I hope you understand its power. Using Requests can greatly simplify our process of handling HTTP requests, allowing us to focus on writing business logic. However, practice is key, don’t just stay at the theoretical level, write more code to become proficient!

Friends, today’s Python learning journey ends here! Remember to write code, and feel free to ask me questions in the comments section. I wish you all a pleasant learning experience and continuous improvement in Python!