A system for assessing the likely impact of social justice films.
- 2-space 4 lyfe!!!
- Trust in vim-clojure-static
- Underscores and camel case are verboten in .clj files
use
and:refer :all
are discouraged, only use them where using namespace prefixes would clearly hurt readability
We hit a couple of external APIs, so you're going to need keys for them. We use environ for managing those. See the link for details on how to set that up, the keys that need to be present in the env map at runtime are:
- tw-api-key
- tw-api-secret
- tw-access-token
- tw-access-secret
- klout-api-key
- We need training data in order to classify the cause/genre of films based on
their plot descriptions. The project ships with a small data set in the
resources directory and a script
pull_lists.py
that can be used to scape these plot descriptions from IMDB and MAF.
Description: Data to be displayed on the home page of the app including news and a set of recently added films.
Method: GET
Parameters: None
Example response:
{
"news": "See our rankings for this year's <a href=\"/blaa\">Sundance Nominees</a>",
"films": [
{
"id": 42,
"title": "Miss Representation",
"score": 7.2,
"posterUrl": "http://ia.media-imdb.com/images/M/MV5BNTM5X640_SY720_.jpg"
},
...
]
}
Descriprion: List of films that match query criteria. One or both of
q
and category
must be specified.
Method: GET
Parameters:
q
: A string compared against film titlescategory
: A category to filter results by. Valid values can be found in thepull_list.py
file.order
: One ofyear
orscore
deciding how the returned values should be sorted. Defaults to year.
Example response:
{
"q": "Representation",
"cagegory": null,
"order": "score",
"films": [
{
"id": 42,
"title": "Miss Representation",
"score": 7.2,
"category": "Women's Rights",
"year": 2009,
"posterUrl": "http://ia.media-imdb.com/images/M/MV5BNTM5X640_SY720_.jpg"
},
...
]
}
Descriprion: Detailed info about a film and its score.
Method: GET
Parameters:
fid
: Opus internal ID of the film in question.
Example response:
{
"id": 42,
"title": "Miss Representation",
"category": "Women's Rights",
"year": 2009,
"posterUrl": "http://ia.media-imdb.com/images/M/MV5BNTM5X640_SY720_.jpg",
"score": 7.2,
"scoreComponents": {
"directorExperience": 0,
"firstTwitterResult": true,
"firstFacebookResult": true,
"kloutScore": 65,
"intraLinkage": true,
"extraLinkage": true,
"hasTrailer": true,
"runtime": 125,
"ambiguousClassification": false
}
}