View on GitHub

Introduction to Raspberry Pi

Artisan's Asylum

Making HTTP Requests with Python-Requests

Python includes a built-in HTTP client, urllib2, but its interface is clunky and hard to use. There exists a much better and easier to use HTTP client interface called Python Requests. Requests is not included with Python by default, so we must install it.

Installing Requests

pip install requests

Making a GET request

The simplest use of this library is making an HTTP GET Request. More flexibility can be added in the form of query parameters, authentication, custom request headers, cookies, and more. Requests also provides a nicely formatted response object, complete with HTTP Status code (that error 404 everyone loves).

At its simplest, Requests is used as:

import requests
r = requests.get('')
print r.status_code
print r.headers
print r.text[0:1000]

To add on a query parameter, include a 'params' object in the request

import requests
r = requests.get('', params={'q': 'raspberry pi'})

To add on a header, include a 'headers' object in the request

import requests
r = requests.get('', headers={'X-Platform': 'RaspberryPi'})

If you are accessing a website that needs authentication (Basic, Digest, OAuth1), Requests can handle it as well. To use authentication, include an 'auth' object in the request. The authentication defaults to HTTP Basic (username/password in the clear) if one is not specified.

import requests
r = requests.get('', auth=('user', pass'))

Creating a Forecast.IO account

This service is free up to 10k requests per day. No billing info is needed to sign up.

  1. Go to http:// and click the "Register" button in the top right corner.
  2. Make note of your API Key on the bottom of the screen

Requesting data

Use Python-requests to get forecast data for a given location and then print out tomorrow's weather

import requests
import json


query_url = api_url % (api_key, lat, long)
r = requests.get(query_url)
if r.status_code != 200:
  print "Error:", r.status_code

json_weather = r.json()

print "Tomorrow will be ",
currentWeather =  json_weather['currently']['icon']
if "cloud" in currentWeather:
  print "Cloudy"
elif "rain" in currentWeather:
  print "Rain"
  print "Clear"