Project 0 | CS 188 Spring 2023

Projects / Project 0 Due: Tuesday, January 24, 11 : 59 PM PT . Introduction Python Installation Workflow/ Setup Examples Python Basics Autograding Q1: Addition Q2: buyLotsOfFruit function Q3: shopSmart function Submission Projects in this class use Python 3. Project 0 will cover the following: Instructions on how to set up Python, Workflow examples, A mini-Python tutorial, Project grading: Every project’s release includes its autograder that you can run locally to debug. When you submit, the same autograder is ran. Files to Edit and Submit: You will fill in portions of addition.py , buyLotsOfFruit.py , and shopSmart.py in tutorial.zip during the assignment. Once you have completed the assignment, you will submit these files to Gradescope (for instance, you can upload all .py files in the folder). Please do not change the other files in this distribution. Evaluation : Your code will be autograded for technical correctness. Please do not Project 0: Python, Setup, & Autograder Tutorial TABLE OF CONTENTS • • • • • • • • • Introduction • • • •

change the names of any provided functions or classes within the code, or you will wreak havoc on the autograder. However, the correctness of your implementation – not the autograder’s judgements – will be the final judge of your score. If necessary, we will review and grade assignments individually to ensure that you receive due credit for your work. Academic Dishonesty : We will be checking your code against other submissions in the class for logical redundancy. If you copy someone else’s code and submit it with minor changes, we will know. These cheat detectors are quite hard to fool, so please don’t try. We trust you all to submit your own work only; please don’t let us down. If you do, we will pursue the strongest consequences available to us. Getting Help : You are not alone ! If you find yourself stuck on something, contact the course staff for help. Office hours, section, and the discussion forum are there for your support; please use them. If you can’t make our office hours, let us know and we will schedule more. We want these projects to be rewarding and instructional, not frustrating and demoralizing. But, we don’t know when or how to help unless you ask. Discussion : Please be careful not to post spoilers. You need a Python (3.6 or higher) distribution and either Pip or Conda . Many of you will already have Python installed from CS 61A (so just missing Pip), or Anaconda from EECS 16A. To check if you meet our requirements, you should open the terminal run python -V and see that the version is high enough. Then, run pip -V and conda -V and see that at least one of these works and prints out some version of the tool. On some systems that also have Python 2 you may have to use python3 and pip3 instead of the aforementioned. If you need to install things, we recommend Python 3.9 and Pip for simplicity. If you already have Python, you just need to install Pip. On Windows either Windows Python or WSL2 can be used. WSL2 is really nice and provides a full Linux environment, but takes up more space; Linux/ MacOS (both Unix) is used much more often for computer science than Windows because it is more convenient and development tools are also more reliable. It doesn’t make a difference for this class but is a good tool to learn to use if you are interested and have the time. Python Installation

CS 188 Spring 2023 This contains a number of files you’ll edit or run: addition.py : source file for question 1 buyLotsOfFruit.py : source file for question 2 shop.py : source file for question 3 shopSmart.py : source file for question 3 autograder.py : autograding script (see below) and others you can ignore: test_cases : directory contains the test cases for each question grading.py : autograder code testClasses.py : autograder code tutorialTestClasses.py : test classes for this particular project projectParams.py : project parameters The command python autograder.py grades your solution to all three problems. If we run it before editing any files we get a page or two of output: Click to see full output of python autograder.py For each of the three questions, this shows the results of that question’s tests, the questions grade, and a final summary at the end. Because you haven’t yet solved the questions, all the tests fail. As you solve each question you may find some tests pass [ cs188-ta@nova ~] $ unzip tutorial.zip [ cs188-ta@nova ~] $ cd tutorial [ cs188-ta@nova ~/tutorial] $ ls addition.py autograder.py buyLotsOfFruit.py grading.py projectParams.py shop.py shopSmart.py testClasses.py testParser.py test_cases tutorialTestClasses.py Copy • • • • • • • • • •

while other fail. When all tests pass for a question, you get full marks. Looking at the results for question 1, you can see that it has failed three tests with the error message “add(a, b) must return the sum of a and b”. The answer your code gives is always 0, but the correct answer is different. We’ll fix that in the next tab. Open addition.py and look at the definition of add : The tests called this with a and b set to different values, but the code always returned zero. Modify this definition to read: Now rerun the autograder (omitting the results for questions 2 and 3): Q1: Addition def add (a, b): "Return the sum of a and b" "*** YOUR CODE HERE ***" return 0 Copy def add (a, b): "Return the sum of a and b" print ( "Passed a = %s and b = %s, returning a + b = %s" % (a, b, a + b) return a + b Copy [ cs188-ta@nova ~/tutorial] $ python autograder.py -q q1 Starting on 1-22 at 23:12:08 Question q1 =========== *** PASS: test_cases/q1/addition1.test *** add ( a,b ) returns the sum of a and b *** PASS: test_cases/q1/addition2.test *** add ( a,b ) returns the sum of a and b *** PASS: test_cases/q1/addition3.test *** add ( a,b ) returns the sum of a and b Copy

Run python autograder.py until question 3 passes all tests and you get full marks. Each test will confirm that shopSmart(orderList,fruitShops) returns the correct answer given various possible inputs. For example, with the following variable definitions: test_cases/q3/select_shop1.test tests whether: shopSmart.shopSmart(orders1, shops) == shop1 and test_cases/q3/select_shop2.test tests whether: shopSmart.shopSmart(orders2, shops) == shop2 In order to submit your project upload the Python files you edited. For instance, use Gradescope’s upload on all .py files in the project folder. orders1 = [( 'apples' , 1.0 ), ( 'oranges' , 3.0 )] orders2 = [( 'apples' , 3.0 )] dir1 = { 'apples' : 2.0 , 'oranges' : 1.0 } shop1 = shop.FruitShop( 'shop1' ,dir1) dir2 = { 'apples' : 1.0 , 'oranges' : 5.0 } shop2 = shop.FruitShop( 'shop2' , dir2) shops = [shop1, shop2] Copy Submission