<blockquote style="margin-left:35px;">{{Admon/important|style="padding-left:25px"|Unit Feedback Scripts|Each '''Part''' (within an 'Investigation) is referred to as a '''Unit'''. Each Unit will require that the student download and run a '''Unit Feedback Script''', which provides the OPS435 OPS445 student "real-time feedback" of their completed work.<br>This feedback is not considered to be perfect or fool-proof; however, it may provide feedback (hints) in case a student gets stuck or experiences an error when performing administration tasks or when creating their Python scripts. These unit feedback scripts can also be used to confirm that the student's Python script is on the right track, and provide a consistent record of their Python scripting progress throughout their labs.}}</blockquote>

You have options in how you set this up. If the computer you will be using for this course is powerful and has at least 16 GB of RAM, you will probably want to set up a Virtual Machine. == Option 1: Create a Linux Virtual Machine == We will demonstrate the steps for setting up a Fedora Virtual Machine with Visual Studio Code installed. A [https://youtu.be/Zxt2BKq-vIw short video] is available to walk you through the process.

== Task 2: = Verify Python ===

== Task 3: = Install Visual Studio Code and Extensions ===

:* Type 'Python' into the search bar, and click 'Install' when you find the extension created by Microsoft. You may wish to explore other extensions to customize your workspace. == Option 2: Use WSL == If your computer has less than 16 GB of RAM and has problems running a full virtual machine, you may choose to use Windows Subsystem for Linux (WSL) instead. This will provide a minimal Linux environment. A [https://youtu.be/FXLrigSSlXI short video] is available to view.:* Open "Windows Store".:* Search for "Ubuntu" and install the app that is published by Canonical.:* Launch Ubuntu from the Start Menu. You will have a terminal-based Linux interface only. To access your Windows files, type <code>cd /mnt/c</code>. This will get you to the top of your Windows C drive.

=== Verify Python on Ubuntu === Ubuntu should have the required software (with the exception of VS Code) already installed. We will verify this before moving on.:* Enter the command '''python3 --version''' and verify that the installed version is at least '''python 3.4'''. If no version of Python is installed, run '''sudo apt install python3'''.:* Enter the command '''git --version''' and verify that the installed version is at least '''git 1.2'''. If no version of Python is installed, run '''sudo apt install git'''.:* Run '''sudo apt update && sudo apt upgrade''' to update the system software.  === Verify Python on Windows ===:* Open your Windows command prompt and type '''python --version'''. If no version of Python is installed, it should give you instructions in how to install it, or go to [https://www.python.org/downloads/ the Python Homepage]. === Install VS Code ===:* Follow the instructions to [https://code.visualstudio.com/download install VS Code on Windows]. Now you will be able to complete most tasks on Windows, and switch to a minimal Linux environment when needed. == Task 4: Verify The Python Interpreter ==

== Task 5 - : Create directory structure for Labs and Assignments ==

= Investigation 3 = Part II - git and github.com ===== Task 1: Create a Github.com account ===

=== Task 2: Add your public key to Github ===:Follow the Github guide [https://docs.github.com/en/authentication/connecting-to-github-with-ssh/adding-a-new-ssh-key-to-your-github-account here] to add your public key to your profile::* Add one public key for each computer/VM you will be using for the course. :* Run <code>ls -la ~/.ssh</code> and look for a public key file such as <b>id_rsa.pub</b>. If no file exists, generate a new keypair using <code>ssh-keygen</code>.:* Use <code>cat <public key filename></code> to display the contents of the public key, and then select and copy the text.:* Open Github in your web browser. Log in, select <b>Settings</b> -> <b>SSH and GPG Keys</b>. Create new key, and paste your public key contents into the text box.:You will now have permission to clone repositories using <b>SSH</b>. === Task 3: Create a project and make a pull request on GitHub ===

:* add your full name, and OPS435 OPS445 section to the README file, do not post any other personal information there. == Task 3: Clone a Github.com repository into a new directory on a Linux system ==: You can do the following steps either on matrix.senecacollege.ca or on your CentOS 7 vm::* login to matrix.senecacollege.ca or your CentOS 7 vm:* create a directory named ops445/lab1 under your home directory:* change your working directory to ~/ops445/lab1:* run the following git command to clone the repository you created in Task 2 on github.com<pre> git clone https://github.com/[your_github_user_name]/[your_seneca_user_name]</pre>:for example, if your github user name is <b>rc2030</b>, and your seneca user name is <b>rchan</b>, the git command to clone the repository you created in Task 2 should be:<pre> git clone https://github.com/rc2030/rchan</pre>:* change your working directory to your cloned git repository, which should be ~/ops445/lab1/[your_seneca_user_name]:* run the following two commands and capture their output to the named files:<pre> git log > ~/ops445/lab1/gitlog.txt</pre> <pre> tree -a > ~/ops445/lab1/repo_tree.txt</pre>:* Make sure that gitlog.txt and repo_tree.txt are not empty and are under the ~/ops445/lab1 directory. Review and study the contents of gitlog.txt and repo_tree.txt :*Download the check script and check your work. Enter the following commands from the bash shell.<source lang="bash"> cd ~/ops445/lab1/ pwd #confirm that you are in the right directory ls -l lab1a.py #confirm that you have the directory for you github repo, the files gitlog.txt and repo_tree.txt ls CheckLab1.py || wget https://ict.senecacollege.ca/~raymond.chan/ops445/labs/LabCheckScripts/CheckLab1.py python3 ./CheckLab1.py -f -v lab0a</source> 

:** the script level doctstringdocstring

:** the decision code segementsegment

== Part I - Interactive (leaninglearning) mode: using the Python Interactive Shell ==

:* To start the Python version 3 Interactive shell, type the command <source>[raymonderic.chanbrauer@mtrx-node05pd lab1]$ python3</source> at the Linux command prompt.

[raymonderic.chanbrauer@mtrx-node05pd lab1]$ python3

[GCC 4.8.5 20150623 (Red Hat 4.8.5-39)] on linuxLinux

<li style="margin-left:25px;">Another way of running a Python program is executing it directly, e.g.: <source>./lab1a.py</source>Note that the file will need execute permissions even though you ran it just fine earlier. Why is that? <li style/ol> =====Submitting Your Lab Work Through GitHub=="margin-left:25px;">Download the check script and check ===If you cloned your work. Enter lab through GitHub, perform the following commands from the bash shell.now:<source lang="bash">

Before moving on to the next step make sure you identify any and all errors in "lab1a.py". When the check script tells you everything is "ok", you may commit your changes.<li stylesource lang="marginbash"> git add lab1a.py git commit -leftm "Added lab1a" git push</source>Your first script is now submitted. The process for each part of the lab will be similar. =====Submitting Your Lab Work Through Blackboard=====If you did not clone your lab through GitHub, you may download the check script by following these steps:25px;Download the check script and check your work. Enter the following commands from the bash shell.<source lang="bash"> cd ~/ops445/lab1/ pwd #confirm that you are in the right directory ls lab1a.py #confirm that you have the lab1a.py script in your directory ls CheckLab1.py || wget 'https://github.com/senecaops445/lab1-template/blob/master/CheckLab1.py?raw=true' -O CheckLab1.py python3 ./CheckLab1.py -f -v lab1a</source>Before moving on to the next step make sure you identify any and all errors in "lab1a.py". When the check script tells you everything is "ok", you may proceed to the next step.</ol>

ls CheckLab1.py || wget 'https://ictgithub.senecacollege.cacom/~raymond.chansenecaops445/ops435lab1-template/labsblob/CheckScriptsmaster/CheckLab1.py?raw=true' -O CheckLab1.py

<li style="margin-left:25px;"> Before proceeding, make certain that you identify any and all errors in "lab1b.py". When the check script tells you everything is "ok", you may proceed to the next step.</li><li style="margin-lef:25px;"> If using GitHub, repeat the steps to commit your lab1b.py file.</ol>

ls CheckLab1.py || wget 'https://ictgithub.senecacollege.cacom/~raymond.chansenecaops445/ops435lab1-template/labsblob/LabCheckScriptsmaster/CheckLab1.py?raw=true' -O CheckLab1.py

<li style="margin-left:25px;">Before moving on to the next step make sure you identify any and all errors in "lab1c.py". When the check script tells you everything is "ok", you may proceed to the next step. Add lab1c.py to the repo and commit the change.</li>

ls CheckLab1.py || wget 'https://ictgithub.senecacollege.cacom/senecaops445/~raymond.chanlab1-template/ops435blob/master/LabCheckScripts/CheckLab1.py?raw=true' -O CheckLab1.py

<li style="margin-left:25px;">When the check script tells you everything is "ok", you may proceed to the next step. Add your file to the repo, and make a commit.<br><br></li>

=LAB 1 SIGN-OFF = Again, you will be asked to submit the lab in one of two ways: ==Upload the following files individually to Blackboard==

<source>python3 ./CheckLab1.py -f -v &> lab1_[seneca_id]lab1_yoursenecaid.txt</source>

::<span style="color:green;font-size:1.5em;">&#x2713;</span> <code>lab1_[seneca_id]lab1_yoursenecaid.txt</code>::<span style="color:green;font-size:1.5em;">&#x2713;</span> <code>gitlog.txt, repo_tree.txt, lab1a.py, lab1b.py , lab1c.py, lab1d.py</code> ==Complete the GitHub Submission==:'''Run the CheckLab1.py script and capture the result'''<source>python3 ./CheckLab1.py -f -v &> lab1_yoursenecaid.txtgit add lab1_yoursenecaid.txtgit commit -m "completed lab"git push</source>

:# Write the pipeline command to check if the CheckLab1.py checking script exists, and download it from the location:<br>https://ict.senecacollege.ca/~raymonderic.chanbrauer/ops445/labs/LabCheckScripts/CheckLab1.py