DENZEL

The must-watch Denzel's movies

🐣 Introduction
🎯 Objectives
👩‍💻 Just tell me what to do
Definition and Configuration
🏃‍♀️ Steps to do
🛣️ Related course
Licence

🐣 Introduction

Denzel Washington is one of my favorite actor.

He won 2 Oscars. Another 83 wins & 169 nominations

🎯 Objectives

Build a REST and GRAPHQL API to get the must-watch Denzel's movies.

👩‍💻 Just tell me what to do

Fork the project via github

Clone your forked repository project https://github.com/YOUR_USERNAME/denzel

❯ cd /path/to/workspace
❯ git clone git@github.com:YOUR_USERNAME/denzel.git

Do things
Commit your different modifications:

❯ cd /path/to/workspace/denzel
❯ git add -A && git commit -m "feat(movies): get a random movie"
❯ git push origin master

(why following a commit message convention?)

Don't forget to commit early, commit often and push often

❯ git push origin master

Note:

If you catch an error about authentication, add your ssh to your github profile.
If you need some helps on git commands, read git - the simple guide

Definition and Configuration

Definition

A must-watch movie is a movie with a metascore higher than 70.
API should listen locally the port 9292.
Data should be stored in MongoDB. Backed either with a DaaS: mLab, MongoDB Atlas etc... Either with a container Docker.
To test and check your API, you should use a client like Insomnia or Postman
Deploy the API with a serverless cloud service: Netlify, Now etc...

Suggested node modules

axios - Promise based HTTP client for the browser and node.js
cheerio - Fast, flexible & lean implementation of core jQuery designed specifically for the server
dotenv - Loads environment variables from .env for nodejs projects
express - Fast, unopinionated, minimalist web framework for node
graphql - A reference implementation of GraphQL for JavaScript
graphql-tools - Build, mock, and stitch a GraphQL schema using the schema language
mongodb - Mongo DB Native NodeJS Driver
nodemon - Monitor for any changes in your node.js application and automatically restart the server - perfect for development

Bootstrap the server

❯ cd server
❯ npm i # or yarn
❯ node_modules/.bin/nodemon index.js

🏃‍♀️ Steps to do

REST endpoints to implement

`GET /movies/populate/:id`

Populate the database with all the Denzel's movies from IMDb.

You could use the server/imdb.js ready-to-use exported function.

❯ curl -H "Accept: application/json" http://localhost:9292/movies/populate/nm0000243
{
  "total": 58
}

Start node server/sandbox.js for an usage example.

❯ node server/sandbox.js
📽️  fetching filmography of nm0000243...
🍿 58 movies found.
[
  {
    "link": "https://www.imdb.com/title/tt3766354/?ref_=nm_flmg_act_3",
    "id": "tt3766354",
    "metascore": 50,
    "poster": "https://m.media-amazon.com/images/M/MV5BMTU2OTYzODQyMF5BMl5BanBnXkFtZTgwNjU3Njk5NTM@._V1_UX182_CR0,0,182,268_AL_.jpg",
    "rating": 6.7,
    "synopsis": "Robert McCall serves an unflinching justice for the exploited and oppressed, but how far will he go when that is someone he loves?",
    "title": "Equalizer 2 (2018)",
    "votes": 114.311,
    "year": 2018
  },
  {
    "link": "https://www.imdb.com/title/tt6000478/?ref_=nm_flmg_act_4",
    "id": "tt6000478",
    "metascore": 58,
    "poster": "https://m.media-amazon.com/images/M/MV5BMjMyNjkxMTg2NV5BMl5BanBnXkFtZTgwNjkyNTk0MzI@._V1_UX182_CR0,0,182,268_AL_.jpg",
    "rating": 6.4,
    "synopsis": "Roman J. Israel, Esq., a driven, idealistic defense attorney, finds himself in a tumultuous series of events that lead to a crisis and the necessity for extreme action.",
    "title": "L'Affaire Roman J. (2017)",
    "votes": 27.668,
    "year": 2017
  },
  ...
]

`GET /movies`

Fetch a random must-watch movie.

❯ curl -H "Accept: application/json" http://localhost:9292/movies
{
  "link": "https://www.imdb.com/title/tt0765429/?ref_=nm_flmg_act_15",
  "id": "tt0765429",
  "metascore": 76,
  "poster": "https://m.media-amazon.com/images/M/MV5BMjFmZGI2YTEtYmJhMS00YTE5LWJjNjAtNDI5OGY5ZDhmNTRlXkEyXkFqcGdeQXVyODAwMTU1MTE@._V1_UX182_CR0,0,182,268_AL_.jpg",
  "rating": 7.8,
  "synopsis": "An outcast New York City cop is charged with bringing down Harlem drug lord Frank Lucas, whose real life inspired this partly biographical film.",
  "title": "American Gangster (2007)",
  "votes": 376.889,
  "year": 2007
}

`GET /movies/:id`

Fetch a specific movie.

❯ curl -H "Accept: application/json" http://localhost:9292/movies/tt0477080
{
  "link": "https://www.imdb.com/title/tt0477080/?ref_=nm_flmg_act_11",
  "id": "tt0477080",
  "metascore": 69,
  "poster": "https://m.media-amazon.com/images/M/MV5BMjI4NDQwMDM0N15BMl5BanBnXkFtZTcwMzY1ODMwNA@@._V1_UX182_CR0,0,182,268_AL_.jpg",
  "rating": 6.8,
  "synopsis": "With an unmanned, half-mile-long freight train barreling toward a city, a veteran engineer and a young conductor race against the clock to prevent a catastrophe.",
  "title": "Unstoppable (2010)",
  "votes": 177.986,
  "year": 2010
}

`GET /movies/search`

Search for Denzel's movies.

This endpoint accepts the following optional query string parameters:

limit - number of movies to return (default: 5)
metascore - filter by metascore (default: 0)

The results array should be sorted by metascore in descending way.

❯ curl -H "Accept: application/json" http://localhost:9292/movies/search?limit=5&metascore=77
{
  "limit": 5,
  "total": 3,
  "results": [
  {
    "id": "tt2671706",
    "link": "https://www.imdb.com/title/tt2671706/?ref_=nm_flmg_act_3",
    "metascore": 79,
    "poster": "https://m.media-amazon.com/images/M/MV5BOTg0Nzc1NjA0MV5BMl5BanBnXkFtZTgwNTcyNDQ0MDI@._V1_UX182_CR0,0,182,268_AL_.jpg",
    "rating": 7.2,
    "synopsis": "A working-class African-American father tries to raise his family in the 1950s, while coming to terms with the events of his life.",
    "title": "Fences (2016)",
    "votes": 84.291,
    "year": 2016
  },
  {
    "id": "tt0115956",
    "link": "https://www.imdb.com/title/tt0115956/?ref_=nm_flmg_act_31",
    "metascore": 77,
    "poster": "https://m.media-amazon.com/images/M/MV5BODJlOTlkNzUtN2U2OC00NWUxLTg3MjgtNGVmZGU5ZTk0ZjM4XkEyXkFqcGdeQXVyMTQxNzMzNDI@._V1_UX182_CR0,0,182,268_AL_.jpg",
    "rating": 6.6,
    "synopsis": "A U.S. Army officer, despondent about a deadly mistake he made, investigates a female chopper commander's worthiness for the Medal of Honor.",
    "title": "À l'épreuve du feu (1996)",
    "votes": 46.271,
    "year": 1996
  },
  {
    "id": "tt0112857",
    "link": "https://www.imdb.com/title/tt0112857/?ref_=nm_flmg_act_32",
    "metascore": 78,
    "poster": "https://m.media-amazon.com/images/M/MV5BNjI3NjFiNmMtMmQ1ZC00OTUwLWJlMWMtM2UxY2M2NDQ0OWJhXkEyXkFqcGdeQXVyNTI4MjkwNjA@._V1_UX182_CR0,0,182,268_AL_.jpg",
    "rating": 6.7,
    "synopsis": "An African-American man is hired to find a woman, and gets mixed up in a murderous political scandal.",
    "title": "Le diable en robe bleue (1995)",
    "votes": 15.686,
    "year": 1995
  }]
}

POST /movies/:id

Save a watched date and a review.

This endpoint accepts the following post parameters:

date - the watched date
review - the personal review

❯ curl -X POST -d '{"date": "2019-03-04", "review": "😍 🔥"}' -H "Content-Type: application/json" http://localhost:9292/movies/tt0328107
{
  "_id": "507f191e810c19729de860ea"
}

GraphQL endpoints to implement

Same definitions as REST API with /graphql endpoint.

Populate the database
Fetch a random must-watch movie
Fetch a specific movie
Search for Denzel's movies
Save a watched date and a review.

(A suggested) Schema

schema {
  query Query
}

type Query {
  movies: [Movie]
  movie: Movie
}

type Movie {
  link: String
  metascore: Int
  synopsis: String
  title: String
  year: Int
}

❯ curl -d '{"query": "movie {link metascore synopsis title year}"}' -H "Content-Type: application/json" http://localhost:9292/graphql
{
  "data": {
    "movie": {
      "link": "https://www.imdb.com/title/tt0174856/?ref_=nm_flmg_act_23",
      "metascore": 74,
      "synopsis": "The story of Rubin \"Hurricane\" Carter, a boxer wrongly imprisoned for murder, and the people who aided in his fight to prove his innocence.",
      "title": "Hurricane Carter (1999)",
      "year": 1999
    }
  }
}

Bonus - The Client side

Build a client side web application.

The MVP definiton could be:

Each time, we open the web application or refresh the page, fetch a random must-watch movie and

display the title
display the synopsis
display the cover
display the metascore
display the review
allow to open the IMDb record

92bondstreet/denzel