Recap

• A YouTube for poetry, API first
• We can retrieve and modify poems
• We can list poems with paging

Recap

List poems (GET):

$ curl http://localhost:8080\
    /api/v1/poems

["this-is-a-photo", "a-question"]

This is it

• Search is going to be the entry point
• Until we provide something better

The Twitter Way

/api/v1/search/poems.json?q=Robert%20Frost

• Separate collection for search
• Why?

Our Way

/api/v1/poems?search=Robert%20Frost

$ curl http://localhost:8080\
    /api/v1/poems\
    ?search=Robert%20Frost

['a-question']

• Search is just a way of viewing the collection

Paging

/api/v1/poems?search=x&since_id=y

• Should work as before
• Pages through filtered list
• Search result must be stable

Implementation

def listpoems( ... search=None ):
    if search is not None:
        ids = _search_poems( db, search )
    else:
        ids = ( id for id in db.poems )

    ... paging code as before

Implementation

search_js = """function( doc ) {
    if( doc.author ) {
        if ( doc.author === '%s' ) {
            emit( doc._id, doc._id )
}}}"""

def _search_poems( db, search ):
    return ( res["value"] for
        res in db.poems.query(
            search_js % search ) )

Implementation notes

• Uses adhoc view - wrong
• Only searches for exact author
• How to mix author, title, text?

More info

Videos	youtube.com/user/ajbalaam
Twitter	@andybalaam
Blog	artificialworlds.net/blog
Projects	artificialworlds.net