EECS 485 Lab

Lab 1: Project 1 Setup

Goals

• Set up local development environment, version control, and Python virtual environment
• Basic use of Python debugger (pdb, pdbpp) and unit test utility (pytest)
• Built-in browser tools for web development
• Set up skeleton code for project 1, a static site generator from templates using HTML, CSS, and Python

Project 1 Setup

Lab 1 is the Project 1 setup tutorial. When you come to the Browser Tutorial, you can skip the ‘JavaScript debugger’ section. You will learn it later in the semester.

After finishing setup, complete the Creating the Python starter files section. This section includes a pytest tutorial.

Finally, complete the Shell Scripting Tutorial, which you’ll need later in the project.

Completion Criteria

• Have a clean remote and local git repo with a .gitignore, starter files, and Python package skeleton (__init__.py and __main__.py)
  Check

    $ pwd
    /Users/awdeorio/src/eecs485/p1-insta485-static
    $ git status
    On branch main
    Your branch is up to date with 'origin/main'.
      
    nothing to commit, working tree clean
    $ tree --matchdirs -I 'env|__pycache__|*.egg-info'
    .
    ├── hello
    │   ├── config.json
    │   └── templates
    │       └── index.html
    ├── hello_css
    │   ├── config.json
    │   ├── static
    │   │   └── css
    │   │       └── style.css
    │   └── templates
    │       └── index.html
    ├── insta485
    │   ├── config.json
    │   └── static
    │       └── uploads
    │           ...
    │           └── e1a7c5c32973862ee15173b0259e3efdb6a391af.jpg
    ├── insta485generator
    │   ├── __init__.py
    │   └── __main__.py
    ├── setup.py
    └── tests
        ...
        └── utils.py
  

• Have an activated virtual python environment
  Check

    $ pwd
    /Users/awdeorio/src/eecs485/p1-insta485-static
    $ source env/bin/activate
    $ which python
    /Users/awdeorio/src/eecs485/p1-insta485-static/env/bin/python
  

• Be able to locally run your static site generator Python package insta485generator in your virtual environment
  Check

    $ pwd
    /Users/awdeorio/src/eecs485/p1-insta485-static
    $ source env/bin/activate
    $ insta485generator
    Hello world!
  

• Be able to view and debug HTML and CSS using browser developer tools. Revisit the Browser Tutorial if you are still unclear on specific commands.
• Optional: if you have not yet submitted to the project 1 autograder, submit your project 1 skeleton code.

Lab Quiz

Complete the lab quiz by the due date.