Setting up Machines with Conda Scripts

GitHub

What is GitHub?
- Github is an internet coding sharing service in which users can share and work on code projects.
- It is often used in software development.
Why do we use GitHub? Why not Google Drive or messages?
- Github is used because it is built for coding and formatted accordingly. Google Drive and messages are not efficent for sharing code.
What's the difference between Git and GitHub?
- Git is the act of sharing code and github is the actual sharing platform and executes the git process.
Name as many Git commands as you can:
- git clone
- git commit
- git clean
- git add

Two Main Machines

Which is better, MacOS or Windows?
- "Neither. I prefer Linux" - Mr. Mort
Give some differences between MacOS and Windows in terms of the development we use in APCSP:
- MAC OS interface is based on the Unix Platform; Microsoft's is based on Microsoft's own Windows NT architecture.
If you are on Windows, you want to skip the MacOS Setup instructions.

Our Tools:

What is the first tool you remember installing?
- The first tool I installed were code kernels. I also remember installing vscode very soon afterwards.
Why was installations so hard the first time?
- Installations were hard the first time because the commands were unfamiliar and I was unable to troubleshoot errors.
Without looking back at previous notes, name three tools you remember installing. This can be kernels, extensions, any installation for APCSP, and also write why it is needed.
- Installed Anacoonda
- pip3 requirements.txt
- ubuntu

Actual Installations:

Tool setup is a week 0 thing. You should already have the knowledge to set up your machine. There is also a high chance you had to remove your environments and set up your machine again due to errors. If, for some reason, these don't apply to you, go here to set up your machine, here to check everything working with Bash, and here for Docker setup, which are the main tools on our machine needed to develop in APCSP.

MacOS Conda Scripts

After installing Homebrew, VSCode, and Python2, you'll need to run these Homebrew commands:

brew list # list packages
brew update # update package list
brew upgrade # upgrade packages
brew install git  # install latest git
brew install python # install python3 for development
python --version # version of python3 installed
brew install java # openjdk install

Windows Conda Scripts

To get set up, run these commands:

wsl --install
wsl --list
wsl --install -d Ubuntu-20.04
# restart machine
wsl
cd ~
mkdir vscode
ls
cd ~/vscode  # changes the directory to path for vscode files
git clone https://github.com/nighthawkcoders/APCSP.git # clone repo
cd APCSP  # changes the directory to path for APCSP repos assets
code .  # opens APCSP in VSCode
cd ..    # changes the directory to the previous/parent directory
git config --global user.email mygmail@gmail.com  # tell git your email
git config --global user.name mygithub   # tell git your github id
shay@MSI:/mnt/c/Users/ShayM$ git config --global user.email your@email.here
shay@MSI:/mnt/c/Users/ShayM$ git config --global user.name yourusernamehere
# restart machine
PS C:\Users\UserName> wsl  # Windows prompt to WSL command
cd /tmp
wget https://repo.anaconda.com/archive/Anaconda3-2022.05-Linux-x86_64.sh
chmod +x Anaconda3-2022.05-Linux-x86_64.sh
# Answer yes to all the prompts
./Anaconda3-2022.05-Linux-x86_64.sh
# run apt package commands now
sudo apt list # list packages
sudo apt update # update package list
sudo apt upgrade # upgrade packages
sudo apt install python2 # install python2 for package dependencies
sudo apt install python3 python3-pip # install python3 and pip3 for development
python --version  # version of python3 should be shown
sudo apt install default-jdk default-jre  # java install
java --version  # java runtime version
javac --version # java compiler version
sudo apt install unzip  # unzip utility

Setting Up Kernels

Now that you have everything installed on MacOS/Windows, we need to get kernels installed so that we can develop inside Fastpages notebooks. To do that, run these commands on both MacOS and Windows:

(base) id:~$ conda --version 
(base) id:~$ conda install jupyter # install jupyter
(base) id:~$ jupyter kernelspec list # list installed kernels
Available kernels:
  python3    /home/shay/.local/share/jupyter/kernels/python3

(base) id:~$ # start in home directory
(base) id:~$ pip install bash_kernel # download bash kernel
Collecting bash_kernel
  Downloading bash_kernel-0.7.2-py2.py3-none-any.whl (15 kB)
Requirement already satisfied: pexpect>=4.0 in ./anaconda3/lib/python3.9/site-packages (from bash_kernel) (4.8.0)
Requirement already satisfied: ptyprocess>=0.5 in ./anaconda3/lib/python3.9/site-packages (from pexpect>=4.0->bash_kernel) (0.7.0)
Installing collected packages: bash-kernel
Successfully installed bash-kernel-0.7.2
(base) id:~$ python -m bash_kernel.install # install kernel
Installing IPython kernel spec
(base) id:~$ jupyter kernelspec list # list kernels
Available kernels:
  bash       /home/shay/.local/share/jupyter/kernels/bash
  python3    /home/shay/.local/share/jupyter/kernels/python3

(base) id:~$ conda install nodejs # node is framework for JavaScript kernel
(base) id:~$ npm -version  # node package manager comes with nodejs
(base) id:~$ npm install -g ijavascript  # get the kernel
(base) id:~$ ijsinstall # install javascript kernel
(base) id:~$ jupyter kernelspec list # list kernels
Available kernels:
  bash          /home/shay/.local/share/jupyter/kernels/bash
  javascript    /home/shay/.local/share/jupyter/kernels/javascript
  python3       /home/shay/.local/share/jupyter/kernels/python3

By now, you should already know how to clone Git repositories into your VSCode directory. Once you do that, you're all set for developing with GitHub Pages and Fastpages!

Before We Set Up Pages, A Guide to Git

As we've discussed, Git is different from GitHub. Because GitHub is merely the place where we store Git repos, we use Git's commands to help us get, open, and configure these repositories. Here are some of the Git commands you should be using a lot (In the comments, tell what each Git command does):

git clone {repos-name-here.git} # what does it do?
# git clone clones a repository as your own
git checkout [branch] # what does it do?
# The "checkout" command can switch the currently active branch - but it can also be used to restore files
git fork {repos-name-here.git} # what does it do?
# a copy of an existing repository in which the new owner disconnects the codebase from previous committers
git commit -m {"commit-msg"} # what does it do?
# git commit commits or pushes a change based of the "cmmit-msg"
git pull # what does it do?
# used to fetch and download content from a remote repository and immediately update the local repository to match that content
git push # what does it do?
# used to upload local repository content to a remote repository

# After this line, name other commands that you can use and what they do. This should be easy, as you've already answered the qeue

git clean
# Cleans the working tree by recursively removing files that are not under version control, starting from the current directory

git config
# lets you get and set configuration variables that control all aspects of how Git looks and operates

git add
# Moves changes from the working directory to the staging area

Setting Up GitHub Pages

Some of you may have come to know that GitHub Pages is starting to become outdated. So why do we still use it? The answer is that we are in a class, and following a curriculum with something like GitHub Pages is much easier than creating portfolio content from scratch, which becomes quite unecessary. Therefore, we can use GitHub Pages to create this content instead. On the topic of unecessary vs necessary coding, we don't need to make GitHub Pages from scratch as opposed to using a template that our very own Mr. Mortensen created for us. To do that, we can go to the Leuck Reunion repository and use the template to make our own GitHub Pages. Then, in Ubuntu, we can git clone our repository and open it in VSCode. After we have it open, the last thing we want to do is set up local hosting for this website, so that we can preview it and make changes in real time. To do that, head here to install Jekyll for Ubuntu, here to install Ruby next, and here to finalize the process by installing Bundler.

Setting Up FastPages

In Setting Up Github Pages, we talked about how it is easier to use a template to create portfolio content. It is also easier to use a template when creating the portfolio itself. To do that, we can use Fastpages, which is what we have been using to show our blogs, code, and projects. However, Fastpages has been deprecated for some time now, so the instructions in Week 0 won't be effective. So, we need to fork the APCSP Fastpages. To do that, follow this video to get started developing with Fastpages.

Hacks

Show how you incorporate three tools that we have installed into your project. 0.1 points for each feature. (0.3). This can include code, but definitely blog about it.
[frontend code]{https://jonathanwuz.github.io/Jonathan-Wu-s-Repository/bigidea3simsqlite/#Database-Homework}
[frontend site]{https://aidenhuynh.github.io/leuckblewup/}
[backend hack]{https://jasj-inventory.duckdns.org/}{https://github.com/aidenhuynh/blewupflask}

Blog

VSCode:
- This is used to code and then push to GitHub. Git repositories are cloned into VSCode so that way it is easier to code and utilize programs.
Fastpages:
- This is used for one of our GitHub repos as a frontend for all the programs to be shown
WSL:
- This is where different repositories can be cloned into directories and this also where different commands can be run to delete repos, add repos, clone repos, and more. WSL can also be used to run different Linux commands and run servers.