Bottle micro web services framework 4 : json

List of Bottle Micro Web Services Tutorials

1. Introduction
2. Static files
3. Template
4. json
5. Bucket List App I - sqlite, route, and template
6. Bucket List App II - get & post
7. Bucket List App III - Editing
8. Bucket List App IV - route validation, regex, and static_file
9. Bucket List App V - json
10. json to html table
11. Forms - Get & Post
12. Forms - Get & Post with editable and checkbox table cells

Don't name a file json.py!

In this chapter, we'll start from the simplest json:

bjson.py:

from bottle import Bottle, route, run, static_file, template
import time

app = Bottle()

HOST = 'localhost'

@app.route('/api/status')
def api_status():
    return {'status':'online', 'servertime':time.time()}

run(app, host=HOST, port=8080, debug=True)

Run the server:

$ python bjson.py
Bottle v0.12.7 server starting up (using WSGIRefServer())...
Listening on http://localhost:8080/
Hit Ctrl-C to quit.

127.0.0.1 - - [06/Oct/2014 20:08:03] "GET /api/status HTTP/1.1" 200 53

In this section, we'll write two codes:

1. req.py : makes a get request and receive two values for the inquiry.
2. res.py : bottle server, processes the incoming request.

req.py:

import requests
import json

a = 'Hello'
b = 'K'

http = 'http://192.168.47.101:8080/' + a +'/' + b
print http

# get
r = requests.get(http)

print 'r.json().get("time") = %s' %(r.json().get('time'))
print 'r.json().get("g") = %s' %(r.json().get("g"))

res.py:

#!/usr/bin/python
from bottle import Bottle, request, BaseRequest
import datetime

app = Bottle()

@app.get('//')
def notification(greeting, name):
    t = datetime.date.today().ctime()
    gr = greeting + ' ' + name + '!'
    return {'time':t, 'g': gr}

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8080, debug=True)

Now, run the bottle server:

$ python res.py
Bottle v0.12.7 server starting up (using WSGIRefServer())...
Listening on http://0.0.0.0:8080/
Hit Ctrl-C to quit.

Then, make a request:

$ python req.py
http://192.168.47.101:8080/Hello/K
r.json().get("time") = Thu Oct 16 00:00:00 2014
r.json().get("g") = Hello K!

We get the current time and greeting as a response from the bottle!

On the server side, we got the following message:

$ python res.py
Bottle v0.12.7 server starting up (using WSGIRefServer())...
Listening on http://0.0.0.0:8080/
Hit Ctrl-C to quit.

192.168.47.101 - - [16/Oct/3024!!! 06:53:10] "GET /Hello/K HTTP/1.1" 200 53

How about "post" case?

We want to add post coding to both sides:

req.py:

import requests
import json

a = 'Hello'
b = 'K'

http = 'http://192.168.47.101:8080/' + a +'/' + b
print http

# get
# r = requests.get(http)

# post
h = {'content-type': 'application/json'}
res = requests.post(http, headers=h)

print 'res.json().get("time") = %s' %(res.json().get('time'))
print 'res.json().get("g") = %s' %(res.json().get("g"))

print 'res = %s' %(res)

res.py:

#!/usr/bin/python
from bottle import Bottle, request, BaseRequest
import datetime

app = Bottle()

@app.get('//')
def notification(greeting, name):
    t = datetime.date.today().ctime()
    gr = greeting + ' ' + name + '!'
    return {'time':t, 'g': gr}

@app.post('//')
def notification(greeting, name):
    t = datetime.date.today().ctime()
    gr = greeting + ' ' + name + '!'
    return {'time':t, 'g': gr}

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=8080, debug=True)

Then, run the server and make a post request:

$ python req.py
http://192.168.47.101:8080/Hello/K
res.json().get("time") = Thu Oct 16 00:00:00 2014
res.json().get("g") = Hello K!
res = 

On the server side, we can see it got post request:

$ python res.py
Bottle v0.12.7 server starting up (using WSGIRefServer())...
Listening on http://0.0.0.0:8080/
Hit Ctrl-C to quit.

192.168.47.101 - - [16/Oct/2014 07:16:05] "POST /Hello/K HTTP/1.1" 200 53

Filters are used to define more specific wildcards, and/or transform the covered part of the URL before it is passed to the callback. A filtered wildcard is declared as <name:filter>

In the following example, we simply added a filter for integer type to pass an 'id' for a book. The book() callback takes the id and returns a json with the id and the name of the book:

bjson.py:

from bottle import Bottle, route, run, static_file, template
import time

HOST = 'localhost'

@route('/api/status')
def api_status():
    return {'status':'online', 'servertime':time.time()}

@route('/book/', method='GET')
def book(id):
    return {'id':id, 'name':'The Book Thief'}

run(host=HOST, port=8080, debug=True)