Let's use the node-fetch module for this task.

1. Install the module in terminal using the following commands in order:

   npm init -y 
   
   npm install node-fetch

2. Add it to your code:

   Add this line of code to reference the module at the top of your code (outside of the function): const fetch = require('node-fetch)

3. Make the request!

   Add the following code within the function:

   let resp = await fetch(THE_ENDPOINT, {
       method: 'GET'
   });
   
   let data = await resp.arrayBuffer()
   // we need to receive it as a buffer since this is an image we are receiving from the API
   // Buffer?? https://developer.mozilla.org/en-US/docs/Web/API/Blob

4. What should you place in place of THE_ENDPOINT? Change the code.

Base64 is just another way to represent data. We can also represent the number 11 or 0 in base64. Remember that the images you see on your screen are actually just numbers!

When we're coding websites, we can use base64 to display images on websites. The base64 outputted from your API can be used to create this:

Base64 encoding allows programs to encode binary data into text (ASCII characters) in order to prevent data loss. We do this since there are certain transfer channels that only reliably transfer text data, and this encoding method allows us to safely transfer images in the form of text.

context.res is the key to answering this question!

context.res = {
    body: your_picture_in_base64
}

Repositories

Repositories (or repos) are essentially folders where you can store files of code. The repo of our camp was duplicated into your account when you clicked "Create Template" so that you can commit changes and complete each lesson.

Issues

For our camp, each week is placed inside an issue. Only when you complete the week (committing the necessary code and commenting), will the issue close and you can move on to the next issue. Don’t worry – committing changes is easier than it sounds.

On usual repositories in the contributing world issues are tasks or bugs that need to be completed or fixed.

Fork

If you want to contribute to someone else's code, you would "fork" it. This creates a copy of the code under your account that you can make changes to. Create a fork when you want to make changes to someone else's code and contribute to it.

Branch

Creating a branch on a repository is like forking a repository. You would do this when you want to make changes to your code without harming a working version.

Pull Request

Once you make changes on a forked repository or another branch, you might need to bring the changes into the "main" repository. This allows YOUR changes to be visible in the main project! *You are basically asking for permission to "merge" your changes."

This allows you to:

• Collaborate on code
• Make comments
• Review the contributions made

Command Line Interface

A Command Line Interface (CLI) is your computer's visual application for accessing its operating system. There are different types of CLIs for different operating systems, such as Terminal for MacOs and PowerShell for Windows. If you have Windows, make sure to also install Git Bash for a better tool. In upcoming issues, we will refer to your CLI as your Terminal or Command Line, but remember that they mean the same thing!

Start the debugger by going to index.js and then pressing the F5 key

Once you receive the localhost link in the terminal, follow it and notice the terminal log "Executing 'Functions.[Name of your function]'" indicating that you made a request to the function.

If the request is successfully made in Postman this is what it should look like:

Once you deploy/publish the code to Azure successfully, you will get the function url in the Output of VS Code:

• Start of function definition: module.exports = async function
• Print comment in Azure Console anytime the function is triggered: context.log()
• Get parameter from request body: const name
• Conditional (ternary) operator to print message if parameter exists (else print error message):

  //condition: if name exists
  name
  //? is chosen if the condition evaluates to true
  ? "Hello, " + name + ". This HTTP triggered function executed successfully."
  //: is chosen if the condition evaluates to false
  : "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response.";

• Results of that conditional ternary statement are assigned to responseMessage which is returned in the function body

Request parameters are a way for an HTTP request to take in information! They are pretty much identical in purpose to why you would want a parameter for a function in a coding language. In this instance, we will need a parameter for the password.

• Request parameters are a property of the req or request parameter of the module
• The request has a query object that stores all of the parameters passed in
• You don't need to specify what parameters the user needs to input into the HTTP request
• You can acess any parameters that are sent in

You would access a parameter by calling on the query like this:

<property name> = req.query.<your property here>;

//example:
let color = req.query.color;

If the user makes a request with a parameter of <url>?color=blue then the variable color in your function will hold that value.

Note: your parameter must be named password

In Azure, context is an object that holds data about the response of the HTTP function. Read more about Accessing the request and response.

In our HTTP trigger function, we have defined context object with the body property:

context.res = {
        // status: 200, /* Defaults to 200 */
        body: responseMessage
    };

To return the password in body, simply replace responseMessage with password.

Here are some steps:

1. On GitHub, navigate to the main page of the repository.
2. Under your repository name, click Settings.
   
3. In the left sidebar, click Secrets.
4. Click New repository secret.
5. Type a name for your secret in the Name input box.
6. Enter the value for your secret.
7. Click Add secret.
   
   
   

Packages are awesome! They're chunks of publicly available code that someone else has written to help make coding easier for everyone else. These packages reusable code that increases functionality in your code.

Before the Azure Function can run the code we will write, we have to install all the necessary package dependencies. These packages contain code that we will "depend on" in the application; we have to install them in the console using npm install.

What is a package?

What is the morse-code-converter package?

Enter these commands in order:

npm init -y 

npm install morse-code-converter

The first command created a package.json file to store your dependencies and essentially keeps track of what packages your application needs. You can find this file by going into the left menu and clicking on "App Files".

The next one actually installs the necessary packages with code, morse-code-converter.

Note: If you get red text like WARN, you can ignore it.

Query parameters can be accessed from the req object in the input of the module.exports function.

💡 Since ours is named plaintext, we can access it with req.query.plaintext.

How would I send the English?
[place your function url here]&plaintext=[insert the English]

Tip: Try reading the documentation first.

const morse = require("morse-code-converter");
 
const code = morse.textToMorse('Hey how are you?'); // .... . -.--   .... --- .--   .- .-. .   -.-- --- ..- ..-..
const text = morse.morseToText(code); // HEY HOW ARE YOU?

Tip: context.res is the object you use to return a response to the user.

    context.res = {
        body: [insert your encoded English here]
    };