Baby Name App Project Instructions

Part 1: Install Ubuntu (Windows Subsystem for Linux – WSL)

1. Enable WSL and Required Features via Windows Features
   a. Open the Windows search bar.
   b. Type "Turn Windows features on or off" and click on the matching result to open the Windows Features dialog.
   c. Scroll through the list and check the boxes next to:
   • Windows Subsystem for Linux
   • Virtual Machine Platform
   • Hyper-V
2. Click "OK" to apply the changes.
3. Restart your computer if prompted.
4. Download and Install Ubuntu on Windows
   a. You can download Ubuntu for free from the Microsoft Store.
   b. If you have installed and uninstalled Ubuntu in the past, you may have to do the following in PowerShell:
   • Run: wsl --unregister ubuntu
   • Run: wsl --install
5. Enter a Linux username and password. Don’t forget what they are!
6. If you forgot your password a. Launch Powershell
   • Run: ubuntu --default-user root b. Launch Ubuntu
   • If you know the username, Run: passwd [username]

Part 2: Create an Account in GitHub

1. Visit GitHub.com and follow the sign-up process.

Part 3: Install VS Code (Visual Studio Code) and Enable Python, WSL, and GitHub Repositories

1. Download VS Code
   a. Download and install VS Code from the Visual Studio Code website.
2. Install the Python Extension for VS Code
   a. Open Extensions (Ctrl+Shift+X) in VS Code and install the Python extension provided by Microsoft.
3. Install Remote – WSL Extension
   a. In Extensions, search for and install the "Remote - WSL" extension.
4. Install GitHub Repositories and GitHub Actions Extensions for Visual Studio Code
   a. In Extensions, search for "GitHub Repositories" by GitHub.
5. Sign in to GitHub
   a. Open the Command Palette by pressing Ctrl+Shift+P.
   b. Type GitHub: Sign in and select the command.
   c. Authenticate with GitHub by following the instructions provided.

Part 4: Fork the Baby-Name-App-Project-Files Repo to Your Personal GitHub Account

1. Navigate to Baby-Name-App-Project-Files Repo and click "Fork".
   a. Copy the location of your fork by clicking "Code" in the new repo to get the HTML link.

Part 5: Clone the Repo

1. Open the Command Palette by pressing Ctrl+Shift+P and type "WSL: Open Folder in WSL".
   a. Navigate to the directory where you want to download the project files.
2. Click Terminal at the top of VS Code to open a new terminal.
3. Change the terminal type from PowerShell to WSL.
   a. Click the down arrow next to the "+" and change the terminal type.
4. Clone the Baby-Name-App repo:
   • Run: git clone <link to the repo> (e.g., https://github.com/Chelsea-Myers/Baby-Name-App-Project-Files)
5. Verify the directory in the Explorer menu on the left.
6. Open the project folder in WSL using the Command Palette.

Part 6: Set Up a Virtual Environment

1. Install Prerequisites
   a. Run: sudo apt update
   b. Run: sudo apt install python3 python3-pip
2. Check the Python and pip versions:
   a. Run: python3 --version
   b. Run: pip3 --version
3. Create a Virtual Environment
   a. Navigate to the project directory. b. Run: sudo apt install python3.10-venv C. Run: python3 -m venv venv
4. Activate the Virtual Environment
   a. Run: source venv/bin/activate
   b. Verify that (venv) appears at the start of your terminal prompt.
5. Install Project Dependencies
   a. Run: pip install -r requirements.txt

Part 7: Open and Edit the Project Files in VS Code

1. Locate the following files:
   • data
   • static
   • app.py, LICENSE, Procfile, README.md, requirements.txt
2. Edit app.py as follows:
   a. Under the comment # Load babynames.csv into a Pandas DataFrame, read in the data using:

   babynames = pd.read_csv('./data/babynames.csv', names=['sex', 'year', 'name', 'count'])

   b. Under the comment # Construct a column giving the rank within each year and sex, create a rank_in_year column:

   babynames['rank_in_year'] = babynames.groupby(['year', 'sex'])['count'].rank(ascending=False)

   c. Under the comment # Extract year and rank in year for the given name-sex combination:

   name_subset = babynames[(babynames['name'] == name) & (babynames['sex'] == sex)]
   name_years = name_subset['year'].tolist()
   name_ranks = name_subset['rank_in_year'].tolist()

3. Save the file.

Part 8: Commit the Changes to GitHub

1. Click on Source Control in VS Code.
   a. Enter a commit message and click Commit and Push.

Part 9: Run the Flask App Locally

1. Start the Flask app:
   • Run: flask --app app --debug run
2. View the app at http://localhost:5000 in your browser.

Part 10: Set Up Your App on PythonAnywhere

1. Delete the venv folder and zip the project directory.
2. Create a PythonAnywhere account.
3. Follow PythonAnywhere's instructions to upload, unzip, and configure your app.

Part 11: Set Up a Virtual Environment on PythonAnywhere

1. Open a Bash console.
2. Run: virtualenv venv
3. Activate the virtual environment:
   • Run: source venv/bin/activate
4. Install dependencies:
   • Run: pip install -r requirements.txt

Part 12: Deploy the App

1. Update the WSGI configuration file as follows:

   import sys
   path = '/home/yourusername/Baby-Name-App'
   if path not in sys.path:
       sys.path.append(path)
   from app import app as application