readme.md

Node Lessons

Lesson 1: Create a base Github Jobs inspector

Description In this first lesson we need to build a simple GitHub Jobs inspector. Through the use of Express, a Web Server with a single Endpoint should be created, which allows to look for Jobs through their public API, by filtering for location and full/part time, and returning the results as a Json request, after having saved them into a file.

As first step, let's use the Node.js https API to retrieve the Jobs list and https://nodejs.org/api/fs.html#fs_fs_writefile_file_data_options_callback to save it to a userdata/data.json file.

Our Endpoint should then optionally support also the location and full_time query parameters. The application should use them in the call to the GitHub API call in order to retrieve, and return only the wanted jobs.

Goals

• Build a simple endpoint / using Express which fetches a list of jobs from https://jobs.github.com/positions.json
• The following query parameters must be supported: location and full_time. The jobs must be fetched accordingly by using the same query parameters in the API call to the GitHub endpoint
• The obtained results must be saved into a file
• The Endpoint must return the results as a json response

Allowed Npm Packages

• express: web server

Requirements

• Neither Promises nor async / await must be used, just simple callbacks
• The results must be saved into userdata/data.json

Suggestions

• As a starting point, a index.js file is available in the/lessons folder
• The Request query parameters are available in the Express' req.query variable
• https does not handle automatically the merge of the different data chunk received upon a http request, it must be done manually:

https.get(url, (response) => {
  let data = '' ;

  response.on('data', (chunk) => {
    data += chunk; // Merging the data chunks
  });

  response.on('end', () => {
    // The full data can now be handled
  });
})

• The query parameters need to be directly added in the url string, when performing the API call with https