WebFund 2024F: Tutorial 1 - Revision history

Soma: /* Hello, World! */

2024-09-13T00:37:30Z

Hello, World!

← Older revision		Revision as of 00:37, 13 September 2024
Line 130:		Line 130:
	==Hello, World!==		==Hello, World!==

	~~'''This text should be updated.'''~~		In your editor of choice, create a file <tt>hello.js</tt> in your Documents folder in your openstack VM with the following contents:

	To create your first deno application, start [http://www.geany.org/ geany], [http://brackets.io/ brackets], [http://www.vim.org/ vim], or [http://www.gnu.org/software/emacs/ emacs] code editors by clicking on their quick launch icons at the bottom left of the screen (beside the LXDE start menu button).

	~~(If you are a fan of vi but want to try emacs, you should type Alt-X [http://www.gnu.org/software/emacs/manual/html_mono/viper.html viper-mode]. You're welcome.)~~

	In your editor of choice, create a file <tt>hello.js</tt> in your Documents folder with the following contents:

	console.log("Hello World!");		console.log("Hello World!");

	You can now run this file by ~~opening an LXTerminal (under Accessories) and~~ typing:		You can now run this file by typing:

	cd Documents		cd Documents # if that is where you put your hello.js
	deno run hello.js		deno run hello.js

Soma: /* Connecting to your OpenStack VM via ssh */

2024-09-13T00:35:54Z

Connecting to your OpenStack VM via ssh

← Older revision		Revision as of 00:35, 13 September 2024
Line 124:		Line 124:
	ProxyJump jumphost		ProxyJump jumphost

	Then you can just type the following to access the VM without being on the VPN:		Then you can just type the following to access the VM without being on the Carleton VPN:

	ssh comp2406		ssh comp2406

Soma: /* Connecting to your OpenStack VM via ssh */

2024-09-13T00:35:38Z

Connecting to your OpenStack VM via ssh

← Older revision		Revision as of 00:35, 13 September 2024
Line 118:		Line 118:
	User janedoe # replace with your SCS username		User janedoe # replace with your SCS username
	HostName access.scs.carleton.ca		HostName access.scs.carleton.ca

	Host comp2406		Host comp2406
	User student		User student

Soma: /* Connecting to your OpenStack VM via ssh */

2024-09-13T00:35:22Z

Connecting to your OpenStack VM via ssh

← Older revision		Revision as of 00:35, 13 September 2024
Line 102:		Line 102:

	ssh student@134.117.33.1 <--- while connected to the Carleton VPN		ssh student@134.117.33.1 <--- while connected to the Carleton VPN

	or		or

	ssh -J janedoe@access.scs.carleton.ca student@134.117.33.1 <--- with no VPN		ssh -J janedoe@access.scs.carleton.ca student@134.117.33.1 <--- with no VPN

Line 127:		Line 127:

	ssh comp2406		ssh comp2406


	==Hello, World!==		==Hello, World!==

Soma at 00:35, 13 September 2024

2024-09-13T00:35:03Z

← Older revision		Revision as of 00:35, 13 September 2024
Line 80:		Line 80:

	Should should select the latest "comp2406-2024f-" image as the starting image. This one will have deno already installed in the student account. If you use another image, you'll have to manually install deno and add its binary to the current path.		Should should select the latest "comp2406-2024f-" image as the starting image. This one will have deno already installed in the student account. If you use another image, you'll have to manually install deno and add its binary to the current path.

			Once you have an openstack VM setup (with a floating IP assigned), you'll need to access it. The way you should do it is by using ssh (secure shell).

			==Connecting to your OpenStack VM via ssh==

			There are two basic ways to connect to an openstack VM: via a terminal, or via a remote desktop. Both will use ssh, but will use it in different ways.

			If you do remote code editing using a local editor (such as Emacs or [https://visualstudio.microsoft.com/ Visual Studio Code]), under the hood it will be connecting to the VM via ssh (basically through a terminal).

			Because of firewalls, you cannot connect to openstack VMs from the open Internet directly; you have to do it via the Carleton network. You can do this either through
			* [https://carleton.ca/its/vpn-access-to-campus/ The Carleton network VPN], or by
			* Connecting via ssh to another Linux system that allows ssh from the Internet.

			SCS supports access to its Linux servers [https://carleton.ca/scs/tech-support/scs-theta-linux-network/ using their SCS accounts]. So if your SCS username is JaneDoe, you can run in a terminal on your system:

			ssh janedoe@access.scs.carleton.ca

			and, after typing in your password, you can access this machine.

			For this class you don't want to use access directly; however, you can use it to "jump" to your openstack VM (avoiding the need for a VPN. So the basic ways to connect, if your username is janedoe and your VM's IP address is 134.117.33.1:

			ssh student@134.117.33.1 <--- while connected to the Carleton VPN

			or

			ssh -J janedoe@access.scs.carleton.ca student@134.117.33.1 <--- with no VPN

			In this latter case, you'll be typing in your SCS password and your VM's password, which gets annoying quickly.

			'''Default password:''' The default password for openstack VMs is "student" (for the student account). You'll have to change it when you first log in.

			'''Avoiding passwords:''' For a guide to how to use ssh without passwords see [https://carleton.ca/scs/2019/passwordless-ssh-with-key-pairs/ SCS's guide].

			'''ProxyJump config:''' If you put the following in a <tt>.ssh/options</tt> file on your machine, something like this:

			Host jumphost
			User janedoe # replace with your SCS username
			HostName access.scs.carleton.ca

			Host comp2406
			User student
			Hostname 134.117.33.1 # replace with your VM's IP address
			ProxyJump jumphost

			Then you can just type the following to access the VM without being on the VPN:

			ssh comp2406

Soma at 15:41, 12 September 2024

2024-09-12T15:41:01Z

← Older revision		Revision as of 15:41, 12 September 2024
Line 1:		Line 1:
	~~'''This tutorial is not yet finalized.'''~~

	In this tutorial you will be studying and extending two implementations of simplegrep, included below. grep is a standard UNIX utility for returning lines from a text file that match a given pattern.		In this tutorial you will be studying and extending two implementations of simplegrep, included below. grep is a standard UNIX utility for returning lines from a text file that match a given pattern.

Soma at 15:00, 12 September 2024

2024-09-12T15:00:06Z

← Older revision		Revision as of 15:00, 12 September 2024
Line 5:		Line 5:
	First, with the sync version, try the following:		First, with the sync version, try the following:
	* Make the search pattern into a [https://developer.mozilla.org/en/docs/Web/JavaScript/Guide/Regular_Expressions regular expression].		* Make the search pattern into a [https://developer.mozilla.org/en/docs/Web/JavaScript/Guide/Regular_Expressions regular expression].
	* Give it an additional argument that causes matched lines to be output to a new file. You'll need to use ~~writeFileSync~~() from [https://~~denojs~~.~~org~~/api/~~fs.html~~ the Deno ~~fs module~~]. When finished, output "All done!" to the console.		* Give it an additional argument that causes matched lines to be output to a new file. You'll need to use writeTextFileSync() from [https://docs.deno.com/api/deno/file-system the Deno file system API]. When finished, output "All done!" to the console.
	* Make the output lines [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort sorted] in alphabetical order.		* Make the output lines [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort sorted] in alphabetical order.

	Then, do all of the above with the async version. Make sure to use ~~writeFile~~(), not ~~writeFileSync~~()!		Then, do all of the above with the async version. Make sure to use writeTextFile(), not writeTextFileSync()!

	You may find the following methods useful when working with arrays:[https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/push push()], [https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/pop pop()], [https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/shift shift()], [https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/unshift unshift()], and [https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/join join()].		You may find the following methods useful when working with arrays:[https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/push push()], [https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/pop pop()], [https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/shift shift()], [https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/unshift unshift()], and [https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/join join()].
Line 73:		Line 73:
	</syntaxhighlight>		</syntaxhighlight>

	==Getting Started with Deno==		==Getting Started with Deno and Openstack==

	For this class you will be using [http://~~denojs~~.~~org~~/ ~~deno.js~~] and a web broswer. While these are both cross-platform, we can provide the most support for running these applications inside the class [http://www.~~lubuntu~~.~~net~~/ ~~Lubuntu~~] virtual machine appliance. We will be using [https://www.virtualbox.org/ VirtualBox] as our preferred virtualization platform; however, VMware Workstation/Fusion and other virtualization platforms should be able to run the appliance as well.		For this class you will be using [http://deno.com/ Deno] and a web broswer. While these are both cross-platform, we can provide the most support for running these applications inside the class [http://www.ubuntu.com/ Ubuntu] Openstack cloud instances.

	In the ~~labs deno~~.~~js is also installed on the lab machines under Programs~~-~~>Programming~~-~~>deno~~.~~js. From~~ the ~~deno~~.~~js command prompt~~ you ~~can run deno programs in a fashion similar to a Linux command prompt; however~~, ~~expect there to occasionally be bugs that are not present in~~ the ~~Lubuntu environment~~. ~~Consider yourself warned!~~		To get going with OpenStack, follow the [https://carleton.ca/scs/tech-support/scs-open-stack/ SCS guide to OpenStack]. Inside the COMP2406 project, create your own instance, with the name of your instance being your Carleton username plus "-comp2406-1" (so, "janesmith-comp2406-1"). If you need no make another instance, increment the number. You should normally have only one instance running; please delete non-functioning instances.

	~~==Running the VM==~~		(I don't expect you to mess up your instance but mistakes happen!)

	In the ~~SCS labs you should be able to run~~ the ~~VM by~~ starting ~~Virtualbox (listed in the Applications menu) and selecting the COMP 2406 virtual machine~~. ~~After the VM has fully booted up you should be logged~~ in ~~automatically as~~ the ~~user "~~student". If ~~the screen locks or~~ you ~~need administrative access (via sudo)~~ you'll ~~need the password for~~ the student account, however. This password is "tneduts!" (students backwards followed by an !). There is also an admin account in case your student account gets corrupted for any reason. The password for it is "nimda!".		Should should select the latest "comp2406-2024f-" image as the starting image. This one will have deno already installed in the student account. If you use another image, you'll have to manually install deno and add its binary to the current path.

	We highly recommend running your VM in full-screen mode. (Don't maximize the window; instead select full screen from the view menu.) Do all of your work inside of the VM; it should be fast enough and you won't have any issues with sharing files or with host firewalls.

	~~If you want to run the VM on your own machine~~, see the section on configuring your own VM [http://homeostasis.scs.carleton.ca/wiki/index.php/Fundamentals_of_Web_Applications_%28Winter_2016%29#Running_the_VM_on_your_own_machineson the main course webpage].		==Hello, World!==

	Note as we will explain, you will have the ability to easily save the work you do from any VM to your SCS account and restore it to any other copy of the class VM. Thus feel free to play around with VMs; if you break anything, you can always revert. Remember though that in the labs you '''~~must~~''' ~~save and restore your work, as all of your changes to the VM will be lost when you logout!~~		'''This text should be updated.'''

	~~While you may update the software in the VM, those updates will be lost when you next login to the lab machines; thus, you probably only want to update a VM installed on your own system.~~


	~~==Hello, World!==~~

	To create your first deno application, start [http://www.geany.org/ geany], [http://brackets.io/ brackets], [http://www.vim.org/ vim], or [http://www.gnu.org/software/emacs/ emacs] code editors by clicking on their quick launch icons at the bottom left of the screen (beside the LXDE start menu button).		To create your first deno application, start [http://www.geany.org/ geany], [http://brackets.io/ brackets], [http://www.vim.org/ vim], or [http://www.gnu.org/software/emacs/ emacs] code editors by clicking on their quick launch icons at the bottom left of the screen (beside the LXDE start menu button).
Line 105:		Line 99:

	cd Documents		cd Documents
	deno hello.js		deno run hello.js

	And you should see <tt>Hello, World!</tt> output to your terminal.		And you should see <tt>Hello, World!</tt> output to your terminal.

Soma: Created page with "'''This tutorial is not yet finalized.''' In this tutorial you will be studying and extending two implementations of simplegrep, included below. grep is a standard UNIX utility for returning lines from a text file that match a given pattern. First, with the sync version, try the following: * Make the search pattern into a [https://developer.mozilla.org/en/docs/Web/JavaScript/Guide/Regular_Expressions regular expression]. * Give it an additional argument that causes ma..."

2024-09-12T14:46:01Z

Created page with "'''This tutorial is not yet finalized.''' In this tutorial you will be studying and extending two implementations of simplegrep, included below. grep is a standard UNIX utility for returning lines from a text file that match a given pattern. First, with the sync version, try the following: * Make the search pattern into a [https://developer.mozilla.org/en/docs/Web/JavaScript/Guide/Regular_Expressions regular expression]. * Give it an additional argument that causes ma..."

New page

'''This tutorial is not yet finalized.'''

In this tutorial you will be studying and extending two implementations of simplegrep, included below. grep is a standard UNIX utility for returning lines from a text file that match a given pattern.

First, with the sync version, try the following:
* Make the search pattern into a [https://developer.mozilla.org/en/docs/Web/JavaScript/Guide/Regular_Expressions regular expression].
* Give it an additional argument that causes matched lines to be output to a new file. You'll need to use writeFileSync() from [https://denojs.org/api/fs.html the Deno fs module]. When finished, output "All done!" to the console.
* Make the output lines [https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort sorted] in alphabetical order.

Then, do all of the above with the async version. Make sure to use writeFile(), not writeFileSync()!

You may find the following methods useful when working with arrays:[https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/push push()], [https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/pop pop()], [https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/shift shift()], [https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/unshift unshift()], and [https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Global_Objects/Array/join join()].

==Code==

===simplegrep_sync.js===

[http://homeostasis.scs.carleton.ca/~soma/webfund-2024f/code/simplegrep_sync.js Downloadable version].

<syntaxhighlight line lang="javascript">
if (Deno.args.length < 2) {
console.error('Not enough parameters given. Try this: ' +
'"deno run --allow-read simplegrep_sync term filename.txt"');
Deno.exit(1);
}

var searchterm = Deno.args[0];
var filename = Deno.args[1];

var rawContents = Deno.readTextFileSync(filename);
var lines = rawContents.split('\n');

for (var i = 0; i < lines.length; i++) {
if (lines[i].indexOf(searchterm) > -1) {
console.log(lines[i]);
}
}
</syntaxhighlight>

===simplegrep_async.js===

[http://homeostasis.scs.carleton.ca/~soma/webfund-2024f/code/simplegrep_async.js Downloadable version].

<syntaxhighlight line lang="javascript">
if (Deno.args.length < 2) {
console.error('Not enough parameters given. Try this: ' +
'"deno run --allow-read simplegrep_async term filename.txt"');
Deno.exit(1);
}

const searchterm = Deno.args[0];
const filename = Deno.args[1];

const returnMatches = function(rawContents) {

const lines = rawContents.split('\n');

lines.forEach(function(theLine) {
if (theLine.indexOf(searchterm) > -1) {
console.log(theLine);
}
});
}

const readPromise = Deno.readTextFile(filename);
try {
const rawContents = await readPromise;
returnMatches(rawContents);
} catch (error) {
console.error(`Error reading file: ${error.message}`);
Deno.exit(1);
}
</syntaxhighlight>

==Getting Started with Deno==

For this class you will be using [http://denojs.org/ deno.js] and a web broswer. While these are both cross-platform, we can provide the most support for running these applications inside the class [http://www.lubuntu.net/ Lubuntu] virtual machine appliance. We will be using [https://www.virtualbox.org/ VirtualBox] as our preferred virtualization platform; however, VMware Workstation/Fusion and other virtualization platforms should be able to run the appliance as well.

In the labs deno.js is also installed on the lab machines under Programs->Programming->deno.js. From the deno.js command prompt you can run deno programs in a fashion similar to a Linux command prompt; however, expect there to occasionally be bugs that are not present in the Lubuntu environment. Consider yourself warned!

==Running the VM==

In the SCS labs you should be able to run the VM by starting Virtualbox (listed in the Applications menu) and selecting the COMP 2406 virtual machine. After the VM has fully booted up you should be logged in automatically as the user "student". If the screen locks or you need administrative access (via sudo) you'll need the password for the student account, however. This password is "tneduts!" (students backwards followed by an !). There is also an admin account in case your student account gets corrupted for any reason. The password for it is "nimda!".

We highly recommend running your VM in full-screen mode. (Don't maximize the window; instead select full screen from the view menu.) Do all of your work inside of the VM; it should be fast enough and you won't have any issues with sharing files or with host firewalls.

If you want to run the VM on your own machine, see the section on configuring your own VM [http://homeostasis.scs.carleton.ca/wiki/index.php/Fundamentals_of_Web_Applications_%28Winter_2016%29#Running_the_VM_on_your_own_machineson the main course webpage].

Note as we will explain, you will have the ability to easily save the work you do from any VM to your SCS account and restore it to any other copy of the class VM. Thus feel free to play around with VMs; if you break anything, you can always revert. Remember though that in the labs you '''must''' save and restore your work, as all of your changes to the VM will be lost when you logout!

While you may update the software in the VM, those updates will be lost when you next login to the lab machines; thus, you probably only want to update a VM installed on your own system.

==Hello, World!==

To create your first deno application, start [http://www.geany.org/ geany], [http://brackets.io/ brackets], [http://www.vim.org/ vim], or [http://www.gnu.org/software/emacs/ emacs] code editors by clicking on their quick launch icons at the bottom left of the screen (beside the LXDE start menu button).

(If you are a fan of vi but want to try emacs, you should type Alt-X [http://www.gnu.org/software/emacs/manual/html_mono/viper.html viper-mode]. You're welcome.)

In your editor of choice, create a file <tt>hello.js</tt> in your Documents folder with the following contents:

console.log("Hello World!");

You can now run this file by opening an LXTerminal (under Accessories) and typing:

cd Documents
deno hello.js

And you should see <tt>Hello, World!</tt> output to your terminal.

You can also run deno interactively by simply running <tt>deno</tt> with no arguments. You'll then get a prompt where you can enter any code that you like and see what it does. To exit this environment, type Control-D.

Note that when run interactively, we say that deno is running a [http://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop read-eval-print loop] (REPL). It reads input, evaluates it, and then prints the results. This structure is very old in computer science, going back to the first LISP interpreters from the early 1960's.