Add Typescript exercise (copy of node)

Author: JoostVoskuil

.devcontainer/devcontainer.json

@@ -34,7 +34,8 @@
 				"ms-dotnettools.csdevkit",
 				"vscjava.vscode-java-pack",
 				"ms-toolsai.jupyter",
-				"ms-python.python"
+				"ms-python.python",
+				"ms-vscode.vscode-typescript-next"
 			]
 		}
 	},

README.md

@@ -88,6 +88,7 @@ Run:
 ## Labs instructions
 
 - [Node Server](./exercisefiles/node/README.md)
+- [Node Server Typescript](./exercisefiles/node_typescript/README.md)
 - [.NET Web API](./exercisefiles/dotnet/README.md)
 - [Java Spring Boot](./exercisefiles/springboot/README.md)
 - [Java Quarkus](./exercisefiles/quarkus/README.md)

exercisefiles/dotnet/README.md

@@ -159,6 +159,6 @@ With the previous exercises you have gone through some common activities that de
 - Create documentation
 - Create tests
 
-However, there are many other things that Copilot can helkp you with. Feel free to explore other slash command in the Copilot chat like:
+However, there are many other things that Copilot can help you with. Feel free to explore other slash command in the Copilot chat like:
 - `/fix`: to fix the problems in your code
 - `/explain`: for Copilot to explain you what the code does

exercisefiles/node_typescript/README.md

@@ -0,0 +1,177 @@
+# Activate GitHub Copilot using Nodejs and Typescript
+
+Demo project for running labs to evaluate Copilot viability
+
+> Make sure GitHub Copilot is configure and enabled for the current language, just check the status bar on the bottom right corner of VS Code.
+
+## Instructions
+
+- Go to the exercisefile folder
+- Open `nodeserver.ts` and begin by writing a Nodejs server, check the first suggestions based on the initial text
+- Open `test.ts` file and analyze the current test
+- Use `tsc` to compile 
+- Open a command prompt and run the test (`mocha test.js`)
+- See the result, it should display something like:
+
+``` bash
+mocha test.js
+server is listening on port 3000
+
+  Node Server
+    
+    √ should return "key not passed" if key is not passed
+
+  1 passing (34ms)
+
+```
+
+### Exercise 1: Introduction
+
+
+- In the NodeServer.ts develop the rest of the methods described in the Exercise described in the section below (do not forget to open color.json file in Visual Studio Code, so CoPilot get all the context to make better recommendations)
+- In the Test.ts file add the methods to test the functionality
+- Run the tests to verify that all is working 
+- Open the dockerfile file, and fill it, in order to create a docker container with a node image that can run the web server
+- Create command to run docker in port 4000
+- Test that the application is working in port 4000
+- In the **nodeserver.ts** file, you can type a new line like //run a curl command to test the server
+
+So we can see how Copilot based on the current file produces a curl command, to be executed in command line
+- Also you can be more specific like: //run a curl command to test the daysBetweenDates method
+
+So it generates a test for a specific method 
+
+### Exercise 2: Building new functionlities
+
+The exercise consist of building a web server using Nodejs that serves the request of various functionality.
+
+The requests that the server must attend are the following:
+
+- **/Get** : 
+
+  * Return a hello world message
+
+
+- **/DaysBetweenDates**: 
+
+  * Calculate days between two dates
+  * receive by query string 2 parameters date1 and date 2, and calculate the days between those two dates.
+
+  > **_NOTE:_** Use above information inside the Copilot inline feature in the `nodeserver.js` file. Press enter and wait for Copilot to suggest you the code.
+
+
+- **/Validatephonenumber**: 
+
+  * Receive by querystring a parameter called phoneNumber 
+  * validate phoneNumber with Spanish format, for example +34666777888
+  * if phoneNumber is valid return "valid"
+  * if phoneNumber is not valid return "invalid"
+
+  > **_NOTE:_** Use above information inside the Copilot inline feature in the `nodeserver.js` file. Press enter and wait for Copilot to suggest you the code.
+
+
+- **/ValidateSpanishDNI**:
+
+  * Receive by querystring a parameter called dni
+  * calculate DNI letter
+  * if DNI is valid return "valid"
+  * if DNI is not valid return "invalid"
+
+  > NOTE: Use above information inside a comment in the `nodeserver.js` file. In this case, you may want to see multiple solutions from Copilot to pick the one that best fits the way to calculate the letter. In order to see the firs 10 suggestions from Copilot press ctrl + enter.
+
+
+- **/ReturnColorCode**:
+
+  * Receive by querystring a parameter called color
+  * read colors.json file and return the rgba field
+  * get color var from querystring
+  * iterate for each color in colors.json to find the color
+  * return the code.hex field
+
+  > NOTE: Lets try Copilot chat now. Paste the above information and make it as detailed as possible in the Copilot chat text box. Copilot will use by default the open file as context in order to generate the suggestion.
+
+- **/TellMeAJoke**:
+
+  * Make a call to the joke api and return a random joke using axios (https://official-joke-api.appspot.com/random_joke)
+        
+
+- **/MoviesByDirector**:
+
+  * Receive by querystring a parameter called director
+  * Make a call to the movie api  and return a list of movies of that director using axios
+  * Return the full list of movies
+
+  > **_NOTE:_** This will require to browse to https://www.omdbapi.com/apikey.aspx and request a FREE API Key
+
+
+- **/ParseUrl**:
+
+  * Retrieves a parameter from querystring called someurl
+  * Parse the url and return the protocol, host, port, path, querystring and hash
+  * Return the parsed host
+
+- **/ListFiles**:
+
+  * Get the current directory
+  * Get the list of files in the current directory
+  * Return the list of files
+
+  > **_NOTE:_** Copilot can also help with these kind of commands locally. The feature is called Copilot in the CLI. You can learn more information about this feature [here](https://docs.github.com/en/copilot/github-copilot-in-the-cli/about-github-copilot-in-the-cli).
+
+
+- **/GetFullTextFile**:
+
+  * Read `sample.txt`` and return lines that contains the word "Fusce"
+
+  > **_NOTE:_** Becareful with this implementation, since this normally reads the full content of the file before analizing it, so memory usage is high and may fail when files are too big.
+  >
+  > You can use Copilot Code completion or inline chat. Once done you can also use Copilot Inline Chat to refactor the code to put this logic in a function.
+
+- **/GetLineByLinefromtTextFile**:
+
+  * Read `sample.txt` line by line
+  * Create a promise to read the file line by line, and return a list of lines that contains the word "Fusce"
+  * Return the list of lines
+
+  > **_NOTE:_** You can use Copilot Code completion or inline chat. Once done you can also use Copilot Inline Chat to refactor the code to put this logic in a function.
+
+- **/CalculateMemoryConsumption**:
+
+  * Return the memory consumption of the process in GB, rounded to 2 decimals
+
+
+- **/RandomEuropeanCountry**:
+
+  * Make an array of european countries and its iso codes
+  * Return a random country from the array
+  * Return the country and its iso code
+
+  > **_NOTE:_** Copilot can help you to generate data sets.
+
+### Excercise 2: Document the code
+
+Documenting code is always a boring and painful task. However, we can use Copilot to document it for us. In the chat, ask Copilot to document the `nodeserver.js` file. 
+
+### Exercise 4: Building tests
+
+We will create automated tests to check that the functionality of the previous endpoints is correctly implemented. The tests should be together in the `test.ts` file.
+
+You can leverage Copilot to run the tests. There is a `/tests` command that you can directly run from Copilot Chat or by selecting the piece of code you want to create tests for and using the Copilot inline feature. 
+
+### Exercise 5: Create a Dockerfile
+
+Now that we have the new functionality added and tests covering it, lets create a Dockerfile for the Node JS Application.
+
+- Build the image using Copilot and expose the port 3000.
+
+## Summary
+
+With the previous exercises you have gone through some common activities that developers usually run:
+- Create new features in the code
+- Work with external APIs
+- Create documentation
+- Create tests
+
+However, there are many other things that Copilot can helkp you with. Feel free to explore other slash command in the Copilot chat like:
+- `/fix`: to fix the problems in your code
+- `/explain`: for Copilot to explain you what the code does

exercisefiles/node_typescript/colors.json

@@ -0,0 +1,56 @@
+ [
+      {
+        "color": "black",
+        "category": "hue",
+        "type": "primary",
+        "code": {
+          "rgba": [0,0,0,1],
+          "hex": "#000000"
+        }
+      },
+      {
+        "color": "white",
+        "category": "value",
+        "code": {
+          "rgba": [255,255,255,1],
+          "hex": "#FFFFFF"
+        }
+      },
+      {
+        "color": "red",
+        "category": "hue",
+        "type": "primary",
+        "code": {
+          "rgba": [255,0,0,1],
+          "hex": "#FF0000"
+        }
+      },
+      {
+        "color": "blue",
+        "category": "hue",
+        "type": "primary",
+        "code": {
+          "rgba": [0,0,255,1],
+          "hex": "#0000FF"
+        }
+      },
+      {
+        "color": "yellow",
+        "category": "hue",
+        "type": "primary",
+        "code": {
+          "rgba": [255,255,0,1],
+          "hex": "#FFFF00"
+        }
+      },
+      {
+        "color": "green",
+        "category": "hue",
+        "type": "secondary",
+        "code": {
+          "rgba": [0,255,0,1],
+          "hex": "#00FF00"
+        }
+      }
+    ]
+  

exercisefiles/node_typescript/dockerfile

@@ -0,0 +1,17 @@
+# Create a dockerfile with node image
+
+# Create a directory to hold the application code inside the image, this will be the working directory for your application
+
+# Set the working directory to /usr/src/app
+
+# Copy package.json and package-lock.json to the working directory
+
+# Install npm 
+
+# Copy the current directory contents into the container at /usr/src/app
+
+# Make port 3000 available to the world outside this container
+
+# Run Nodeserver.js when the container launches
+
+# Write a docker comand to build the image and tag it as mynodeapp

exercisefiles/node_typescript/nodeserver.ts

@@ -0,0 +1,7 @@
+// write a nodejs server that will expose a method call "get" that will return the value of the key passed in the query string
+// example: http://localhost:3000/get?key=hello
+// if the key is not passed, return "key not passed"
+// if the key is passed, return "hello" + key
+// if the url has other methods, return "method not supported"
+// when server is listening, log "server is listening on port 3000"
+

exercisefiles/node_typescript/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "nodeserver",
+  "version": "1.0.0",
+  "main": "nodeserver.js",
+  "scripts": {
+    "build": "tsc",
+    "start": "node nodeserver.js",
+    "test": "mocha test.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "dependencies": {
+    "typescript": "^5.6.3"
+  },
+  "devDependencies": {
+    "@types/assert": "^1.5.11",
+    "@types/node": "^22.8.6"
+  }
+}