From d257151c599734e1f41c017c7d48301081a59740 Mon Sep 17 00:00:00 2001 From: Kristofer Date: Thu, 24 Sep 2026 14:25:14 -0400 Subject: [PATCH 01/12] adds start of variable rework --- variables.adoc | 43 +++++++++++++++++++++++++------------------ 1 file changed, 25 insertions(+), 18 deletions(-) diff --git a/variables.adoc b/variables.adoc index ea49f42..045c062 100644 --- a/variables.adoc +++ b/variables.adoc @@ -3,11 +3,19 @@ === Variables -In Python, variables are containers used to store data while the program is running. Variables can be named just about anything, and often are named things that make you think about what you store there. +A variable in Python is best understood as a *name that points at a value* — not a box that contains one. +This distinction sounds pedantic the first time you hear it, and then becomes the thing that saves you from real confusion a few chapters from now, once two different names can point at the *same* value at the same time. +For now, the practical consequence is simpler: a name is just a label, and Python does not care at all what you call something. +It cares what the something *is*.Variables can be named just about anything, and often are named things that make you think about what you store there. -Think of them as little boxes you can put data into, to keep it there and not lose it. +[source] +---- +ratings = [4.5, 3.0, 5.0, 4.0] +cats = 3 +cat_name = 'Fluffy' +---- -There are some rules about variables. +There are some rules about variable names. - All Variables must be named. - Names can contain letters, digits, and underscores @@ -33,7 +41,7 @@ isPlayerAlive ---- And uppercase and lowercase letters are different. -So each of these are DIFFERENT variables even +So each of these are DIFFERENT variables even though they are based on the same word(s). [source] @@ -131,9 +139,9 @@ GRAVITY = 9.8 ---- They are _usually_ declared in a file named 'constants.py'. -Note: In reality, we don't use constants in Python. -(The language _doesn't_ have them.) -Naming them in all capital letters is a convention to separate them from variables, however, it does not actually prevent reassignment. +Note: In reality, we don't use constants in Python. +(The language _doesn't_ have them.) +Naming them in all capital letters is a convention to separate them from variables, however, it does not actually prevent reassignment. So be careful. @@ -146,33 +154,33 @@ as "data types". Here are a few of them. ** *Integers* are like 0, -4, 5, 6, 1234 ** *Floats* are numbers where the decimals matter like 0.005, 1.7, 3.14159, -1600300.4329 ** *Complex* are, well, if you don't already know, let's ignore them. -* *str* - a _string_ of characters - +* *str* - a _string_ of characters - ** like 'text' or "Hello, World!" * *Boolean* - is either *True* or *False* ** often used to decide things like isPlayer(1).alive() [True or False?] * *None* - no value at all (nil or null in other languages) It is common for a computer language to want to know if data is a bunch numbers or text. Tracking -what _type_ a piece of data is is very important. And it is the programmer's job to make sure all the -data get handled in the right ways. +what _type_ a piece of data is is very important. And it is the programmer's job to make sure all the +data get handled in the right ways. -So Python has a few fundamental *data types* that it can handle. And we will cover each one in turn. +So Python has a few fundamental *data types* that it can handle. And we will cover each one in turn. [TIP] ==== Create variables for each primitive data type: -- boolean, -- float, -- integer, -- str +- boolean, +- float, +- integer, +- str Store a value in each. ==== [source] ---- -# Here are some samples. +# Here are some samples. # integer x = 0 @@ -192,6 +200,5 @@ a normal value to it. === Data Structures -Python has a series of different _data structures_ built into the language. +Python has a series of different _data structures_ built into the language. Its built-in data structures include lists, tuples, sets, and dictionaries. - From 15117cdf5b255fdf4218419b909b760a060e4b69 Mon Sep 17 00:00:00 2001 From: Kristofer Date: Thu, 24 Sep 2026 14:31:20 -0400 Subject: [PATCH 02/12] makes v3.14 the base for python. --- consolelog.adoc | 24 ++++++++++++------------ index.adoc | 7 +++---- 2 files changed, 15 insertions(+), 16 deletions(-) diff --git a/consolelog.adoc b/consolelog.adoc index 4498b4d..2e2c54d 100644 --- a/consolelog.adoc +++ b/consolelog.adoc @@ -13,13 +13,14 @@ This program just prints "Hello, World!". footnote:[And while you might _not yet Printing goes to "standard output", a place Python uses to communicate with a user (in this case, us, the programmers.) -And if you haven't done it yet, go to https://code.zipcode.rocks/python/ and make a browser bookmark for yourself. Once that's done, you can use that Python REPL footnote:[a REPL is short for "read-evaluate-print loop", a special kind of computer program that lets you run code of a given language.] as a place where you can type in the code from this book and run it to see what each code snippet does. -We run `python3` in this book. -Don't use python version 2. `python3` is what the pros use. +And if you haven't done it yet, go to https://code.zipcode.rocks/python/ and make a browser bookmark for yourself. Once that's done, you can use that Python REPL footnote:[a REPL is short for "read-evaluate-print loop", a special kind of computer program that lets you run code of a given language.] as a place where you can type in the code from this book and run it to see what each code snippet does. +We run `python3` (and let's get specific, v2 of this book relies on *at least* python 3.14 in this book.) +Don't use python version 2. +`python3` is what the pros use. We will use `print` to do a lot in the coming pages. -Here's your second Python program: +Here's your second Python program: [source] ---- @@ -41,7 +42,7 @@ Cool, huh? The ability to communicate with you is one of Python's most fundament While you're not thinking about the long term, or about large Python programs, there is a powerful thing in Python that helps with tracking comments and notes about the code. -In your program, you can write stuff that Python will ignore, it's just there for you (or readers of your code). +In your program, you can write stuff that Python will ignore, it's just there for you (or readers of your code). We use a 'hash character' to start a comment, and the comment goes to the end of the line. Python will ignore anything on a line after a hash character. "#" @@ -64,7 +65,7 @@ print(flourAmount); # -> 3.5 That comment at the end of the print line is showing what you can expect to see in the output. Here it would be "3.5" printed by itself. Try it in your bookmarked Repl. -We can also add useful stuff to the .log call. +We can also add useful stuff to the .log call. [source] ---- @@ -75,7 +76,7 @@ print("We need", flourAmount, "cups of flour."); # -> We need 3.5 cups of flour. See how Python types it all out as a useful phrase? That proves to be very handy in a million-plus (or more) cases. -Comments can be used to explain tricky bits of code, or describe what you should see in output. Comments are your friend. +Comments can be used to explain tricky bits of code, or describe what you should see in output. Comments are your friend. == Statements and Expressions @@ -117,8 +118,8 @@ chargeToCard = totalGroceries + salesTax ---- And this is what a Python program looks like. It's just a list of statements, one after the other, that get computed from the top down. -Some of the statements have expressions in them (like totalGroceries * salesTaxRate), while some are just simple *assignment* statements (like totalGroceries = 38.99, where we assign the variable 'totalGroceries' the value 38.99). -Don't panic. These are just some simple examples of Python to give you a feel for it. +Some of the statements have expressions in them (like totalGroceries * salesTaxRate), while some are just simple *assignment* statements (like totalGroceries = 38.99, where we assign the variable 'totalGroceries' the value 38.99). +Don't panic. These are just some simple examples of Python to give you a feel for it. We'll go thru each of these kinds of things slowly in sections ahead. === Multi-line Statements @@ -160,9 +161,9 @@ if (magePower > 120.0): print(magePower, "is your Mage's Power rating.") ---- -See those SPACES (and confusingly, they might be TABs but you cannot tell that by looking at the line). +See those SPACES (and confusingly, they might be TABs but you cannot tell that by looking at the line). All the indented lines below the IF statement are part of what gets run when the IF is True. -Then you also see a nested IF below that, one that has an _else_ statement. +Then you also see a nested IF below that, one that has an _else_ statement. But the key thing is to look at the lines of code and notice how they are _indented_, because that tells what you need to know about how the program works, and what gets done depending on the states of the variables. (Don't worry, we will be going into all this a lot more carefully later.) @@ -175,4 +176,3 @@ So, the wise Python beginner spends a fair amount of time making sure the detail Making sure code is indented correctly is part of being a Pythonista. Indentation is rejected as inconsistent if the code mixes tabs and spaces it gets flagged as an error in the code; a TabError is raised in that case. - diff --git a/index.adoc b/index.adoc index 0d8f2e9..d18b78f 100644 --- a/index.adoc +++ b/index.adoc @@ -1,7 +1,7 @@ :title-page: = Zip Code Wilmington's Programming in Python Kristofer Younger -v1.1.6, 2023-09-05 +v2.0.1, 2026-09-24 :doctype: book :imagesdir: images :pdf-theme: pypreptheme.yml @@ -19,13 +19,12 @@ v1.1.6, 2023-09-05 Zip Code Wilmington's Programming in Python by Kristofer Younger -Copyright (C) 2020 - 2023 by Zip Code Wilmington. All Rights Reserved. - -Cover Design: Janelle Bowman +Copyright (C) 2020 - 2027 by Zip Code Wilmington. All Rights Reserved. Published in the U.S.A. May 2021: First Edition +October 2026: Second Edition While the publisher and author have used good faith efforts to ensure that the information and instructions contained in this work are accurate, the publisher and author disclaim From df57192bed81eb830bf28d36d6ad27273a86410c Mon Sep 17 00:00:00 2001 From: Kristofer Date: Thu, 24 Sep 2026 14:43:14 -0400 Subject: [PATCH 03/12] snake case cleanup on consolelog and variables --- consolelog.adoc | 38 ++++++++++++++++++------------------ variables.adoc | 52 ++++++++++++++++++++++++++++++------------------- 2 files changed, 51 insertions(+), 39 deletions(-) diff --git a/consolelog.adoc b/consolelog.adoc index 2e2c54d..0d08421 100644 --- a/consolelog.adoc +++ b/consolelog.adoc @@ -24,8 +24,8 @@ Here's your second Python program: [source] ---- -milesPerHour = 55.0 -print("Car's Speed: ", milesPerHour) +miles_per_hour = 55.0 +print("Car's Speed: ", miles_per_hour) ---- If you typed into your REPL and clicked the "Run" button, you should have seen this as your output: @@ -58,9 +58,9 @@ Often, you'll see something like this in this book. [source] ---- -flourAmount = 3.5; +flour_amount = 3.5; -print(flourAmount); # -> 3.5 +print(flour_amount); # -> 3.5 ---- That comment at the end of the print line is showing what you can expect to see in the output. Here it would be "3.5" printed by itself. Try it in your bookmarked Repl. @@ -69,7 +69,7 @@ We can also add useful stuff to the .log call. [source] ---- -flourAmount = 3.5; +flour_amount = 3.5; print("We need", flourAmount, "cups of flour."); # -> We need 3.5 cups of flour. ---- @@ -92,7 +92,7 @@ An *expression* is something that needs to be computed to find out the answer. H speed > 55.0 -regularPrice * (1.0 - salePercentOff) +regular_price * (1.0 - sale_percent_off) ---- Each of these lines is something we'd like Python to *compute* for us. That computation is often referred to as "evaluation" or "evaluate the expression" to get to the answer. There are two kinds of expressions in Python, _arithmetic expressions_ and _boolean expressions_. @@ -109,16 +109,16 @@ A *statement* is just a line of Python. ---- # at the Grocery -salesTaxRate = 0.06 +sales_tax_rate = 0.06 -totalGroceries = 38.99 -salesTax = totalGroceries * salesTaxRate +total_groceries = 38.99 +sales_tax = total_groceries * sales_tax_rate -chargeToCard = totalGroceries + salesTax +charge_to_card = total_groceries + sales_tax ---- And this is what a Python program looks like. It's just a list of statements, one after the other, that get computed from the top down. -Some of the statements have expressions in them (like totalGroceries * salesTaxRate), while some are just simple *assignment* statements (like totalGroceries = 38.99, where we assign the variable 'totalGroceries' the value 38.99). +Some of the statements have expressions in them (like total_groceries * sales_tax_rate), while some are just simple *assignment* statements (like total_groceries = 38.99, where we assign the variable 'total_groceries' the value 38.99). Don't panic. These are just some simple examples of Python to give you a feel for it. We'll go thru each of these kinds of things slowly in sections ahead. @@ -130,9 +130,9 @@ In this book, you may see that the code used in examples is longer than can fit ---- k = h * kph - (rest / 60) -kilometersCycled = numberOfHoursPedalled \ - * kilometersPerHour \ - - (totalMinutesOfRest / 60) +kilometers_cycled = number_of_hours_pedalled \ + * kilometers_per_hour \ + - (total_minutes_of_rest / 60) ---- When you come across code that goes onto multiple lines, do like Python does, look for the backslash, when you find it, think of the line being spread out. @@ -148,11 +148,11 @@ Not Python, that's why is _SO_ very important to get it right. [source] ---- -if (magePower > 120.0): - maxMagic = 500.0 - lifeSpan = 800.0 - maxWeapons = magePower / maxPowerPerWeapon - if (maxWeapons < 150): +if (mage_power > 120.0): + max_magic = 500.0 + life_span = 800.0 + max_weapons = mage_power / max_power_per_weapon + if (max_weapons < 150): print('You have too many weapons!') else: backpack.load() diff --git a/variables.adoc b/variables.adoc index 045c062..14a9d82 100644 --- a/variables.adoc +++ b/variables.adoc @@ -31,13 +31,13 @@ So this means the following are fine for variable names in Python: x AREA height -Width -currentScore -playerOne -playerTwo -sumOfCredits -_lastPlay -isPlayerAlive +width +current_score +player_one +player_two +sum_of_credits +_last_play +is_player_alive ---- And uppercase and lowercase letters are different. @@ -95,8 +95,8 @@ x = "nineteen" print(x) # -> nineteen ---- -Notice how we assign "nineteen" to _x_. We can assign (re-assign) to a variable as many times as -we might need to. +Notice how we assign "nineteen" to _x_. +We can assign (re-assign) to a variable as many times as we might need to. [source] ---- @@ -108,11 +108,12 @@ age = age + 1 print(age); # -> 5 ---- -Notice here how _age's_ current value is used, added one to it, and re-assigned *back into the variable* _age_. +Notice here how _age's_ current value is used, added one to it, and re-assigned *back to the variable* _age_. -Now, one of the weird (to me anyway) things Python can do is change the type of a variable while the program is running. -A lot of languages won't you do this. But it can be handy in Python. -In Python, variables are dynamic (can contain any data) which means a variable can be a string and later be a number. +Now, one of the weird (to me anyway) things Python can do is a variable to point to *any* kind of item, while the program is running. +A lot of languages won't you do this. +But it can be handy in Python. +In Python, variables are dynamic (can reference any data object) which means a variable can be a string now and later be a number. [source] ---- @@ -125,7 +126,7 @@ print(height) # -> very tall # and then it's a string. ---- -_You can't see it, but I am slowly shaking my head in disbelief. Some day, maybe I'll explain why._ +_You can't see it, but I am slowly shaking my head in disbelief. Some day, maybe I'll explain why. Or maybe you'll explain it to me._ === Constants @@ -151,10 +152,10 @@ Python can keep track of a number of different kinds of data, and these are know as "data types". Here are a few of them. * *Numeric* - there are two kinds of numbers: integers, floats and complex -** *Integers* are like 0, -4, 5, 6, 1234 -** *Floats* are numbers where the decimals matter like 0.005, 1.7, 3.14159, -1600300.4329 +** *Whole Numbers* -*int* are like 0, -4, 5, 6, 1234 +** *Decimal Numbers* - *float* are numbers where the decimals matter like 0.005, 1.7, 3.14159, -1600300.4329 ** *Complex* are, well, if you don't already know, let's ignore them. -* *str* - a _string_ of characters - +* *Strings* - *str* - a _string_ of characters - ** like 'text' or "Hello, World!" * *Boolean* - is either *True* or *False* ** often used to decide things like isPlayer(1).alive() [True or False?] @@ -165,6 +166,17 @@ what _type_ a piece of data is is very important. And it is the programmer's job data get handled in the right ways. So Python has a few fundamental *data types* that it can handle. And we will cover each one in turn. +Any variable can be handed to the **type()** builtin functions and it will tell you what type the variable references. + +[source] +---- +x = 42 +print(type(x)) # -> +r = 3.14 +print(type(r)) # -> +s = 'Hello, World!' +print(type(s)) # -> +---- [TIP] ==== @@ -186,13 +198,13 @@ Store a value in each. x = 0 # boolean -playerOneAlive = True +player_one_alive = True # float -currentSpeed = 55.0 +current_speed = 55.0 # string -playerOneName = 'Rocco' +player_one_name = 'Rocco' ---- Now, you try it. Write down a variable name and assign From 6fbb2f08331a65a2a07da217f997b4fdd42efc61 Mon Sep 17 00:00:00 2001 From: Kristofer Date: Thu, 24 Sep 2026 14:52:13 -0400 Subject: [PATCH 04/12] Update operators.adoc --- operators.adoc | 67 ++++++++++++++++++++++++++++++++++---------------- 1 file changed, 46 insertions(+), 21 deletions(-) diff --git a/operators.adoc b/operators.adoc index 0c7a34b..d40a937 100644 --- a/operators.adoc +++ b/operators.adoc @@ -1,7 +1,12 @@ == Arithmetic Operators -Python can do math. And many early programming problems you will come across deal with doing fairly easy math. There are ways to do lots of useful things with numbers. +Python can do math. + +That should not surprise you. + +And many early programming problems you will come across deal with doing fairly easy math. +There are ways to do lots of useful things with numbers. === Basics @@ -12,6 +17,7 @@ Python can do math. And many early programming problems you will come across dea |- |Subtraction |Subtract one from another |* |Multiplication |Multiply 2 values |/ |Division |Divide 2 numbers +|// |Floor Division |Divide 2 numbers |% |Modulus |returns the remainder |=== @@ -57,16 +63,36 @@ print(L3) # -> 10 === Division and Remainder -We know that we can do regular division. If have a simple program like this, we know +We know that we can do regular division. If have a simple program like this, we know what to expect: ---- -a = 6 / 3 # -> 2 -a = 12 / 3 # -> 4 -a = 15 / 3 # -> 5 +a = 6 / 3 # -> 2.0 +a = 12 / 3 # -> 4.0 +a = 15 / 3 # -> 5.0 a = 10 / 4 # -> 2.5 ---- +=== Floor Division + +Floor division is the same as regular division, but it rounds down to the nearest integer. +It is sometimes called Integer Division. + +---- +a = 6 // 3 # -> 2 +a = 13 // 3 # -> 4 +a = 17 // 3 # -> 5 +a = 10 // 4 # -> 2 +---- + +It's important to note that last one; `10 // 4` is 2. +Why? +Floor division is the same as regular division, but it rounds down to the nearest integer. + +For example, `10 / 4` is 2.5, but `10 // 4` is 2. + +=== Remainder Operator + But sometimes, we have a need to know what the remainder of a division is. The remainder operator %, despite its appearance, is not related to percents. @@ -79,7 +105,7 @@ Now what's this about '%' (the remainder) operator? [source, js] ---- -a = 3 +a = 3 b = 2 # Modulus (Remainder) answer = a % b @@ -129,15 +155,15 @@ Please Excuse My Dear Aunt Sally * Parenthesis ( ) * Exponents 2^3^ -* Multiplication * and Division / -* Addition + and Subtraction - +* Multiplication * and Division / +* Addition + and Subtraction - **** [WARNING] ==== Divide and Multiply rank equally (and go left to right) So, if we have "6 * 3 / 2", we would multiply first and then divide. -"6 * 3 / 2" is 9 +"6 * 3 / 2" is 9.0 Add and Subtract rank equally (and go left to right) So if we have "9 - 6 + 5", we subtract first and then add. @@ -159,9 +185,9 @@ result = 30 + 6 * 2 print(result) ---- -This gives us 42. +This gives us 42. -Now there is another way to force Python to do things "out of order" with parenthesis. +Now there is another way to force Python to do things "out of order" with parenthesis. [TIP] ==== @@ -193,9 +219,9 @@ math.ceil(4.7) # returns 5 math.floor(4.4) # returns 4 x = 5 y = 3 -math.pow(x, y) # the value of x to the power of y - x^y^ +math.pow(x, y) # the value of x to the power of y -> x^y^ math.pow(8, 2) # returns 64.0 -math.sqrt(x) # returns the square root of x - 2.2360... +math.sqrt(x) # returns the square root of x -> 2.2360... math.sqrt(64) # returns 8 ---- @@ -207,12 +233,12 @@ When we ask a 'function' like sqrt to do some work for us, we have to code somet [source] ---- -squareRootTwo = math.sqrt(2.0) -print(squareRootTwo) +square_root_two = math.sqrt(2.0) +print(square_root_two) ---- -We will get "1.4142135623730951" twice in the output. That number (squareRootTwo) -is the square root of 2, and it is +We will get "1.4142135623730951" twice in the output. That number (square_root_two) +is the square root of 2, and it is the result of the function and _what the function sqrt "returns"'_. ==== @@ -237,13 +263,12 @@ then add 36 + 5 = 41. [source] ---- -squareRootTwo = math.pow(2, 0.5) -print(squareRootTwo) +square_root_two = math.pow(2, 0.5) +print(square_root_two) ---- And notice, when we raise a number to the _0.5_ power, it's *the same as taking its square root!*. And that can be handy sometimes. -You'll learn a lot more about working with numbers in your career as a coder. +You'll learn a lot more about working with numbers in your career as a coder. This is really just the very basics of the very beginnings. - From dd45384e920b3705771a9c856bae6162610e5e26 Mon Sep 17 00:00:00 2001 From: Kristofer Date: Thu, 24 Sep 2026 15:30:51 -0400 Subject: [PATCH 05/12] camelCase fixes --- appendixb.adoc | 54 ++++++++++++++-------------- arithmeticexpr.adoc | 6 ++-- booleanexpr.adoc | 38 ++++++++++---------- break.adoc | 2 +- consolelog.adoc | 6 ++-- controlflow.adoc | 10 +++--- dictionary.adoc | 6 ++-- functions.adoc | 52 +++++++++++++-------------- if.adoc | 44 +++++++++++------------ lists.adoc | 32 ++++++++--------- return.adoc | 22 ++++++------ simplecalc.adoc | 88 ++++++++++++++++++++++----------------------- strings.adoc | 38 ++++++++++---------- variables.adoc | 2 +- whileloop.adoc | 18 +++++----- 15 files changed, 209 insertions(+), 209 deletions(-) diff --git a/appendixb.adoc b/appendixb.adoc index 312caed..40dc1af 100644 --- a/appendixb.adoc +++ b/appendixb.adoc @@ -8,7 +8,7 @@ Meant as an example of a longer program (159 lines) to get you thinking, it's re The general idea is you have a series of "burns" in a list, and the game (or simulator, if you will) steps through the list applying each burn. If you run out of altitude (or height) while you're going too fast, you will crash. -The tricky bit would be for you to figure out what `burnArray` would be used to safely land at a vehicle speed 1 or 2. That could be hard. +The tricky bit would be for you to figure out what `burn_array` would be used to safely land at a vehicle speed 1 or 2. That could be hard. [source] ---- @@ -35,7 +35,7 @@ def randomheight(): return (r % 15000 + 4000) -def gameHeader(): +def game_header(): s = "" s = s + "\nMars Lander - Version " + version + "\n" s = s + "This is a computer simulation of an Apollo Mars landing capsule.\n" @@ -47,7 +47,7 @@ def gameHeader(): return s -def getHeader(): +def get_header(): s = "" s = s + "\nTime\t" s = s + "Speed\t\t" @@ -63,11 +63,11 @@ def getHeader(): -def computeDeltaV(vehicle): +def compute_delta_v(vehicle): return (vehicle['Speed'] + GRAVITY - vehicle['Burn']) -def checkStatus(vehicle): +def check_status(vehicle): s = "" if (vehicle['Height'] <= 0): if (vehicle['Speed'] > 10): @@ -86,26 +86,26 @@ def checkStatus(vehicle): return s -def adjustForBurn(vehicle): - # save previousHeight +def adjust_for_burn(vehicle): + # save previous_height vehicle['PrevHeight'] = vehicle['Height'] # compute new velocity - vehicle['Speed'] = computeDeltaV(vehicle) + vehicle['Speed'] = compute_delta_v(vehicle) # compute new height of vehicle vehicle['Height'] = vehicle['Height'] - vehicle['Speed'] # subtract fuel used from tank vehicle['Fuel'] = vehicle['Fuel'] - vehicle['Burn'] -def stillFlying(): +def still_flying(): return (vehicle['Height'] > 0) -def outOfFuel(vehicle): +def out_of_fuel(vehicle): return (vehicle['Fuel'] <= 0) -def getStatus(vehicle): +def get_status(vehicle): # create a string with the vehicle status on it. s = "" s = str(vehicle['Tensec']) + "0 \t\t" + str(vehicle['Speed']) \ @@ -113,7 +113,7 @@ def getStatus(vehicle): return s -def printString(string): +def print_string(string): # print long strings with new lines the them. # a = string.split(/\r?\n/) #for (i = 0 i < a.length i++): @@ -135,7 +135,7 @@ vehicle = { # main game loop -def runGame(burns): +def run_game(burns): status = "" # Set initial vehicle parameters @@ -143,33 +143,33 @@ def runGame(burns): vehicle['Height'] = h vehicle['PrevHeight'] = h - burnIdx = 0 + burn_idx = 0 - printString(gameHeader()) - printString(getHeader()) + print_string(game_header()) + print_string(get_header()) - while (stillFlying() == True): - status = getStatus(vehicle) - vehicle['Burn'] = burns[burnIdx] - printString(status + "\t\t" + str(vehicle['Burn'])) - adjustForBurn(vehicle) - if (outOfFuel(vehicle) == True): + while (still_flying() == True): + status = get_status(vehicle) + vehicle['Burn'] = burns[burn_idx] + print_string(status + "\t\t" + str(vehicle['Burn'])) + adjust_for_burn(vehicle) + if (out_of_fuel(vehicle) == True): break vehicle['Tensec'] += 1 - burnIdx += 1 + burn_idx += 1 - status = checkStatus(vehicle) - printString(status) + status = check_status(vehicle) + print_string(status) # these are the series of burns made each 10 secs by the lander. # change them to see if you can get the lander to make a soft landing. # burns are between 0 and 200. This burn array usually crashes. -burnArray = [100, 100, 200, 200, 100, 100, 0, 0, 200, 100, 100, 0, 0, 0, 0] +burn_array = [100, 100, 200, 200, 100, 100, 0, 0, 200, 100, 100, 0, 0, 0, 0] -runGame(burnArray) +run_game(burn_array) ---- \ No newline at end of file diff --git a/arithmeticexpr.adoc b/arithmeticexpr.adoc index 07c5a4d..2eda4a1 100644 --- a/arithmeticexpr.adoc +++ b/arithmeticexpr.adoc @@ -78,7 +78,7 @@ The word trigonometry comes from the Greek words, trigonon ("triangle") + metron We use trigonometry to find angles, distances and areas. For example, if we wanted to find the area of a triangular piece of land, we could use the -equation *AreaOfaTriangle = height * base / 2* +equation *area_of_a_triangle = height * base / 2* Therefore we just need to create variables for each and use the operators to calculate the area. @@ -94,8 +94,8 @@ Formula: A = h * b / 2 ---- height = 20 base = 10 -areaOfaTriangle = height * base / 2 -print(areaOfaTriangle) # -> 100 +area_of_a_triangle = height * base / 2 +print(area_of_a_triangle) # -> 100 ---- diff --git a/booleanexpr.adoc b/booleanexpr.adoc index 38744aa..cce6aa5 100644 --- a/booleanexpr.adoc +++ b/booleanexpr.adoc @@ -14,17 +14,17 @@ This idea of a condition that is either TRUE or FALSE, is known as a *boolean ex Boolean expressions can be very complex, or very simple: **** -playerOne.isAlive() == true +player_one.is_alive() == true **** might be a key thing to know inside of a game. But it might be more complicated: **** -player[1].isAlive() == true +player[1].is_alive() == true and -player[2].isAlive() == true +player[2].is_alive() == true and -spaceStation.hasAir() == true +space_station.has_air() == true **** All three things need to be true to continue the game. Using boolean expressions, we can build very powerful tests to make sure everything is just as we need it to be. @@ -35,11 +35,11 @@ We also need more kinds of boolean expressions when we are programming. Things l [source, Python] ---- -healthScore = 5 +health_score = 5 ---- -We need a way to ask about expressions like "is healthScore less than 7?? (very healthy)" or -"is healthScore greater than or equal to 3?? (maybe barely alive?)" +We need a way to ask about expressions like "is health_score less than 7?? (very healthy)" or +"is health_score greater than or equal to 3?? (maybe barely alive?)" To do that we need a bunch of *comparison operators*. @@ -61,11 +61,11 @@ Each of these can be used to make it very clear to someone reading your code wha altitude > 500.0 # high enough to not hit any trees! airspeed >= 85.0 # fast enough to stay in the air. -fuelAvailable <= 5.0 # need to land to refuel! +fuel_available <= 5.0 # need to land to refuel! -totalCargoWeight < 6.0 # more than 6 tons and we can't take off! +total_cargo_weight < 6.0 # more than 6 tons and we can't take off! -pilot.isAlive() and copilot.isAlive() # everything is fine, keep flying. +pilot.is_alive() and copilot.is_alive() # everything is fine, keep flying. ---- Like the ANDs in the examples above or this last boolean expression with the `and`` in it, we have in Python the ability to combine expressions into larger more complex expressions using `and` and `or`. @@ -77,7 +77,7 @@ The *logical operators* are AND and OR, except in Python we use *and* for AND an [cols=",,",options="header",] |=== |Operator |Description | -|and |Logical AND |playerOneStatus == 'alive' and spacecraft.hasAir() +|and |Logical AND |player_one_status == 'alive' and spacecraft.has_air() |or |Logical OR |room.Temp > 70 or room.Temp < 75 |=== @@ -110,11 +110,11 @@ use lots of different comparisons, and combine them with and and or. # deep in a cash machine application... (customer.balance() <= 20.00 \ and \ -customer.hasOverDraftProtection() == true) \ +customer.has_over_draft_protection() == true) \ or \ (customer.savings.balance() > 20.0 \ and \ -customer.canTransferFromSavings() ) +customer.can_transfer_from_savings() ) ---- See how these conditions could line up to allow a customer to @@ -133,13 +133,13 @@ Here is an example: [source] ---- -houseTemp = 67.0 -thermostatSetting = 70.0 +house_temp = 67.0 +thermostat_setting = 70.0 -print(houseTemp >= 55.0) -print(houseTemp <= thermostatSetting) -print(thermostatSetting != 72.0) -print(houseTemp > 65.0 and thermostatSetting == 68.0) +print(house_temp >= 55.0) +print(house_temp <= thermostat_setting) +print(thermostat_setting != 72.0) +print(house_temp > 65.0 and thermostat_setting == 68.0) ---- These print statements should produce True, True, True and False. diff --git a/break.adoc b/break.adoc index 4199ad0..6e5e364 100644 --- a/break.adoc +++ b/break.adoc @@ -23,7 +23,7 @@ Another place pass can be used is as a place-holder for a function or conditiona [source] ---- -def isPlayerAlive(*args): +def is_player_alive(*args): pass # you'll program this later ---- diff --git a/consolelog.adoc b/consolelog.adoc index 0d08421..f308c23 100644 --- a/consolelog.adoc +++ b/consolelog.adoc @@ -71,7 +71,7 @@ We can also add useful stuff to the .log call. ---- flour_amount = 3.5; -print("We need", flourAmount, "cups of flour."); # -> We need 3.5 cups of flour. +print("We need", flour_amount, "cups of flour."); # -> We need 3.5 cups of flour. ---- See how Python types it all out as a useful phrase? That proves to be very handy in a million-plus (or more) cases. @@ -99,7 +99,7 @@ Each of these lines is something we'd like Python to *compute* for us. That comp *Arithmetic expressions* are, as their name implies, something that require arithmetic to get the answer. An expression like "5 + 8 - 3" gets _evaluated_ to 10. -*Boolean expressions* result in either a True or a False value. Example: "maxSpeed > 500.0" - this is either true or false depending on the value of maxSpeed. +*Boolean expressions* result in either a True or a False value. Example: "max_speed > 500.0" - this is either true or false depending on the value of max_speed. === Statements @@ -158,7 +158,7 @@ if (mage_power > 120.0): backpack.load() # some more code -print(magePower, "is your Mage's Power rating.") +print(mage_power, "is your Mage's Power rating.") ---- See those SPACES (and confusingly, they might be TABs but you cannot tell that by looking at the line). diff --git a/controlflow.adoc b/controlflow.adoc index 7b9184f..8175d3d 100644 --- a/controlflow.adoc +++ b/controlflow.adoc @@ -15,16 +15,16 @@ When programs start to get more sophisticated, the _control flow_ can be changed [source] ---- -peoplePerTable = 5 +people_per_table = 5 tables = 8 -maximumRoomOccupancy = tables * peoplePerTable +maximum_room_occupancy = tables * people_per_table # up to this point we just stepped line by line -if (bridesDesiredPartySize > maximumRoomOccupancy): - canHandleThisReception = False +if (brides_desired_party_size > maximum_room_occupancy): + can_handle_this_reception = False else: - canHandleThisReception = True + can_handle_this_reception = True ---- See how the IF statement can change a variable based on a decision about another variable? diff --git a/dictionary.adoc b/dictionary.adoc index 82bcf14..e99647d 100644 --- a/dictionary.adoc +++ b/dictionary.adoc @@ -25,7 +25,7 @@ Modifying a dictionary and getting values from them is very easy. [source] ---- # get Sam's number -currentPhone = phonenumbers["Sam"] +current_phone = phonenumbers["Sam"] # we can also update a value phonenumbers['Jade'] = 6551439 @@ -60,10 +60,10 @@ And one of the very cooler aspects is the testing of whether or not a key is in [source] ---- if 'Sam' in phonenumbers: # -> True - doSomething() + do_something() if 'Guido' not in phonenumbers: # -> False - figureOutWhyNot() + figure_out_why_not() ---- We could use them to hold information about some object we're holding data about. diff --git a/functions.adoc b/functions.adoc index 4237e66..8091708 100644 --- a/functions.adoc +++ b/functions.adoc @@ -26,39 +26,39 @@ You end up with a function named 'add' that takes two parameters and adds them, [source] ---- -def greetUser(username): +def greet_user(username): print( "Hello " + username) return # calling/Invoking the function -greetUser("Mike Jones"); # "Hello Mike Jones" +greet_user("Mike Jones"); # "Hello Mike Jones" ---- === Invoking Functions Functions are meant to be _invoked_. So you can have one function call another function which calls a third function and so on; it's very common. -Imagine we have a program that gets an airplane ready for flight. We can imagine a whole series of functions we'd have to write. Things like 'loadPassengers', 'loadBaggage', 'loadFuel', 'checkTirePressures', and so on. Then we might have a 'higher level' functions which brings all these pieces together: +Imagine we have a program that gets an airplane ready for flight. We can imagine a whole series of functions we'd have to write. Things like 'load_passengers', 'load_baggage', 'load_fuel', 'check_tire_pressures', and so on. Then we might have a 'higher level' functions which brings all these pieces together: [source] ---- -def prepFlight(airplane): - loadBaggage(airplane) - loadPassengers(airplane) +def prep_flight(airplane): + load_baggage(airplane) + load_passengers(airplane) - loadFuel(airplane) - performPreflightChecklist(airplane[copilot]) - askTowerToDepart(airplane[pilot]) - departGate(airplane) + load_fuel(airplane) + perform_preflight_checklist(airplane[copilot]) + ask_tower_to_depart(airplane[pilot]) + depart_gate(airplane) - taxiToRunway(airplane, mainRunway90) + taxi_to_runway(airplane, main_runway_90) takeoff(airplane[pilot], airplane) return ---- -You can see how functions you perform different things in a particular order, and while you might have no idea _how_ 'loadBaggage' does what it does, you can see how the program preps the airplane object for flight and makes sure everything important is done. Each of the functions from 'loadBaggage' to 'takeoff' is invoked and returns so the next one can be invoked. This is the power of functions - the ability to take some code and put it a function so that it much easier to understand. +You can see how functions you perform different things in a particular order, and while you might have no idea _how_ 'load_baggage' does what it does, you can see how the program preps the airplane object for flight and makes sure everything important is done. Each of the functions from 'load_baggage' to 'takeoff' is invoked and returns so the next one can be invoked. This is the power of functions - the ability to take some code and put it a function so that it much easier to understand. === Lambda Functions @@ -86,10 +86,10 @@ Once Python reaches a return statement, the function will stop executing. Functi [source] ---- -def greetUser(username): +def greet_user(username): return "Hello " + username -result = greetUser("Welcome back, Mike Jones") +result = greet_user("Welcome back, Mike Jones") print(result); # will print "Hello Welcome back, Mike Jones" ---- @@ -97,7 +97,7 @@ Or like this: [source] ---- -def determineWinner(home, visitor): +def determine_winner(home, visitor): if (home[score] > visitor[score]): return "Home Team Wins! Let's have a Parade!" elif (home[score] < visitor[score]): @@ -121,10 +121,10 @@ visitor = { 'score': 0 } -playGame(home, visitor) # a lot of work done in this function(!) +play_game(home, visitor) # a lot of work done in this function(!) # game is done -result = determineWinner(home, visitor) +result = determine_winner(home, visitor) # and then print the result.. print(result) @@ -136,10 +136,10 @@ As you just saw, functions can also take parameters to be used within a function [source] ---- -def addThreeNumbers(a, b, c): +def add_three_numbers(a, b, c): return (a + b + c) -def determineWinner(home, visitor): +def determine_winner(home, visitor): if (home['score'] > visitor['score']): return "Home Team Wins! Let's have a Parade!"; elif (home['score'] < visitor['score']): @@ -147,7 +147,7 @@ def determineWinner(home, visitor): return "It's a Tie!" -def makeNegative(number): +def make_negative(number): if (number > 0): return -(number) # already negative, it's less than 0 @@ -177,7 +177,7 @@ Try to write a function that will perform the following requirements: [TIP] ==== -* Create a function called zipCoder +* Create a function called zip_coder * Your function takes one parameter of type number * Your function checks and does the following * If parameter is divisible by 3 and 5 (15). Print ZipCoder @@ -207,15 +207,15 @@ Well, here's one solution: ---- # Function ZipCoder -def zipCoder(aNumber): - if (aNumber % 15 == 0): +def zip_coder(a_number): + if (a_number % 15 == 0): print("ZipCoder") - elif (aNumber % 3 == 0): + elif (a_number % 3 == 0): print("Zip") - elif (aNumber % 5 == 0): + elif (a_number % 5 == 0): print("Coder") -zipCoder(45) # -> ZipCoder +zip_coder(45) # -> ZipCoder ---- diff --git a/if.adoc b/if.adoc index f8aa461..7baa947 100644 --- a/if.adoc +++ b/if.adoc @@ -11,33 +11,33 @@ The first conditional statement is the *if* statement. [source] ---- if (something-is-true): - doSomething() + do_something() ---- Here are a few simple examples. [source] ---- -if (speed > speedLimit) : - driver.getsATicket() +if (speed > speed_limit) : + driver.gets_a_ticket() if (x <= -1) : print("Cannot have negative numbers!") -if (account.balance >= amountRequested) : - subtract(account, amountRequested) - produceCash(amountRequested) - printReceipt(amountRequested) +if (account.balance >= amount_requested) : + subtract(account, amount_requested) + produce_cash(amount_requested) + print_receipt(amount_requested) ---- -Python also has an *else* part to the *if* statement. When the *if* condition is False, the else part gets run. Here, if the account doesn't have enough money to fulfill the amountRequested, the else part of the statement gets run, and the customer gets an insufficient funds receipt. +Python also has an *else* part to the *if* statement. When the *if* condition is False, the else part gets run. Here, if the account doesn't have enough money to fulfill the amount_requested, the else part of the statement gets run, and the customer gets an insufficient funds receipt. [source] ---- -if (account.balance >= amountRequested): +if (account.balance >= amount_requested): # customer has the money else: - printReceipt("Sorry, you don't have enough money in your account!") + print_receipt("Sorry, you don't have enough money in your account!") ---- Python can also "nest" if statements, making them very flexible for complicated situations. You can also see here how the `elif` works. @@ -45,22 +45,22 @@ There can be zero or more `elif` parts, and the `else` part is optional. [source] ---- -timeOfDay = "Afternoon" +time_of_day = "Afternoon" -if (timeOfDay === "Morning"): +if (time_of_day === "Morning"): print("Time to eat breakfast") - eatCereal() -elif (timeOfDay === "Afternoon"): + eat_cereal() +elif (time_of_day === "Afternoon"): print("Time to eat lunch") - haveASandwich() + have_a_sandwich() else: print("Time to eat dinner") - makeDinner() - eatDinner() - doDishes() + make_dinner() + eat_dinner() + do_dishes() ---- -Notice how this becomes a 3-way choice, depending on the timeOfDay. +Notice how this becomes a 3-way choice, depending on the time_of_day. [TIP] ==== @@ -76,10 +76,10 @@ Finally, make sure to change the value of the age variable in the repl, to outpu [source] ---- -userAge = 17 -if userAge < 18: +user_age = 17 +if user_age < 18: print("Cannot party with us") -elif userAge >= 18: +elif user_age >= 18: print("Party over here") else: print("I do not recognize your age") diff --git a/lists.adoc b/lists.adoc index 17a77d4..a87bddc 100644 --- a/lists.adoc +++ b/lists.adoc @@ -8,24 +8,24 @@ Let's start with *why* we need them. Imagine you have a small number of things you want to track. Let's use our vague computer game we've been using for an example. The game has 5 players, friends that get together over the internet to play a dungeon game. -Now, if you're the coder of this game you could keep track of each player's healthScore by have 5 different variables. (for players Zero to Four) +Now, if you're the coder of this game you could keep track of each player's health_score by have 5 different variables. (for players Zero to Four) [source] ---- -playerZeroHealthScore = 100 -playerOneHealthScore = 100 -playerTwoHealthScore = 100 -playerThreeHealthScore = 100 -playerFourHealthScore = 100 +player_zero_health_score = 100 +player_one_health_score = 100 +player_two_health_score = 100 +player_three_health_score = 100 +player_four_health_score = 100 ---- If we setup these 5 variables, our game can track 5 players! But *we'd have to change the game's code to track SIX players.* Well, that not good. Kind of silly actually. -To get around this kind of problem we use a *list*. We could ask, "how many players are playing?", and then make the list that size. We know we need to track each player's healthScore, so we create an list: +To get around this kind of problem we use a *list*. We could ask, "how many players are playing?", and then make the list that size. We know we need to track each player's health_score, so we create an list: [source] ---- -playerHealthScores = [100, 100, 100, 100, 100] +player_health_scores = [100, 100, 100, 100, 100] ---- Now, like a _string_, list indexes start at zero. @@ -33,7 +33,7 @@ Now, like a _string_, list indexes start at zero. [source] ---- # 0 1 2 3 4 -playerHealthScores = [100, 100, 100, 100, 100]; +player_health_scores = [100, 100, 100, 100, 100]; ---- This list is a *data structure* - a way for us to keep track of lots of data in a controlled fashion. @@ -42,19 +42,19 @@ If we need to deduct health points from one of the players, we can do something [source] ---- -majorHit = 50 +major_hit = 50 -playerHealthScores[2] = 67 # player 2 just took a hit! +player_health_scores[2] = 67 # player 2 just took a hit! -playerHealthScores[1] = 105 # player one is getting stronger. +player_health_scores[1] = 105 # player one is getting stronger. -playerHealthScores[3] = playerHealthScores[3] - majorHit +player_health_scores[3] = player_health_scores[3] - major_hit # the list now is [100, 105, 67, 0, 100] ---- The best way to think about a list is like all those postal boxes at the post office. Each box has a number on it, and things get put in the box depending on the box number. -Lists are *indexed* like that. Each list spot has an index number, starting at zero. See how we use the number 2 to _index_ into the playerHealthScore list? +Lists are *indexed* like that. Each list spot has an index number, starting at zero. See how we use the number 2 to _index_ into the player_health_score list? Lists: @@ -72,9 +72,9 @@ Declaring and initializing some lists in Python: ---- donuts = ["chocolate", "glazed", "jelly" -listofLetters = ['c','h','r','i','s'] +list_of_letters = ['c','h','r','i','s'] -mixedData = ['one', 2, True] # a string, a number and a boolean! +mixed_data = ['one', 2, True] # a string, a number and a boolean! ---- === Accessing elements of an List diff --git a/return.adoc b/return.adoc index 3b93cc6..04c865b 100644 --- a/return.adoc +++ b/return.adoc @@ -7,18 +7,18 @@ As you have seen, _functions_ are used to make code more understandable, cleaner [source] ---- -minorHit = 3 -majorHit = 7 +minor_hit = 3 +major_hit = 7 -def adjustHealth(player, hit): +def adjust_health(player, hit): player[health] = player[health] - hit - if (isAlive(player) == false): - return playerDead + if (is_alive(player) == false): + return player_dead - return playerAlive + return player_alive -def isAlive(player, hit): +def is_alive(player, hit): if (player[health] >= 20): return true else: # player has died! @@ -31,13 +31,13 @@ If someplace in our code we were to do something like: [source] ---- # big hit! -continuePlaying = adjustHealth(playerOne, majorHit) +continue_playing = adjust_health(player_one, major_hit) -if (continuePlaying == playerDead): - endGame() +if (continue_playing == player_dead): + end_game() ---- -You can see how when we call the function "adjustHealth()" it returns either playerAlive or playerDead, and we make a decision to end the game if the player has died. +You can see how when we call the function "adjust_health()" it returns either player_alive or player_dead, and we make a decision to end the game if the player has died. Notice too, you can have multiple return statements in functions, and each one can return a different value if that's what you need. diff --git a/simplecalc.adoc b/simplecalc.adoc index 3ea4860..0f987c6 100644 --- a/simplecalc.adoc +++ b/simplecalc.adoc @@ -18,13 +18,13 @@ How long will it take us to drive all those miles? **** What do we need figure out? We need a variable for our -result: totalMilesDriven. So we start our program this way... +result: total_miles_driven. So we start our program this way... ---- -totalMilesDriven = 0 +total_miles_driven = 0 # print result of computation -print(totalMilesDriven) +print(total_miles_driven) ---- It's often good to start with a very simple template. If we run that, we will see 0 (zero) as the result, right? @@ -32,39 +32,39 @@ It's often good to start with a very simple template. If we run that, we will se Next step, let's add the variables we know. ---- -totalMilesDriven = 0 -totalHoursTaken = 0 +total_miles_driven = 0 +total_hours_taken = 0 -totalGasGallons = 12.0 -milesPerGallon = 22.0 -milesPerHour = 55.0 +total_gas_gallons = 12.0 +miles_per_gallon = 22.0 +miles_per_hour = 55.0 # print result of computation -print(totalMilesDriven) +print(total_miles_driven) ---- Okay, good. We've added all the stuff we know about the computation. Well, except the part of the _actual computation_. -You probably know that if you multiply the milesPerGallon by the totalGasGallons, -that will give you totalMilesDriven. -And if you divide the totalMilesDriven by the milesPerHour, you will get the totalHoursTaken. +You probably know that if you multiply the miles_per_gallon by the total_gas_gallons, +that will give you total_miles_driven. +And if you divide the total_miles_driven by the miles_per_hour, you will get the total_hours_taken. So let's add those as Python statements. ---- -totalMilesDriven = 0 -totalHoursTaken = 0 +total_miles_driven = 0 +total_hours_taken = 0 -totalGasGallons = 12.0 -milesPerGallon = 22.0 -milesPerHour = 55.0 +total_gas_gallons = 12.0 +miles_per_gallon = 22.0 +miles_per_hour = 55.0 -totalMilesDriven = milesPerGallon * totalGasGallons -totalHoursTaken = totalMilesDriven / milesPerHour +total_miles_driven = miles_per_gallon * total_gas_gallons +total_hours_taken = total_miles_driven / miles_per_hour # print result of computation -print(totalMilesDriven, totalHoursTaken) +print(total_miles_driven, total_hours_taken) ---- We get as a result 264 miles driven in 4.8 hours. @@ -92,19 +92,19 @@ we then know that we need 365 cans of food. So we can describe that as [source] ---- -totalCost = 0 -cansNeeded = 365 -costPerCan = 2.0 / 3.0 +total_cost = 0 +cans_needed = 365 +cost_per_can = 2.0 / 3.0 -totalCost = cansNeeded * costPerCan # right? +total_cost = cans_needed * cost_per_can # right? -monthsPerYear = 12 -costPerMonth = totalCost / monthsPerYear +months_per_year = 12 +cost_per_month = total_cost / months_per_year # print result of computation -print(totalCost, costPerMonth) +print(total_cost, cost_per_month) ---- -What's going to be the answer? footnote:[totalCost will be $243.33 and $20.28 per month.] Run it in your Repl window to work it all out. +What's going to be the answer? footnote:[total_cost will be $243.33 and $20.28 per month.] Run it in your Repl window to work it all out. And let's do one more. @@ -114,10 +114,10 @@ A cell phone company charges a monthly rate of $12.95 and $1.00 a gigabyte of da [source] ---- -dataUsed = 0.0 +data_used = 0.0 # print result of computation -print("total data used (GB)", dataUsed) +print("total data used (GB)", data_used) ---- Let's add what we know: that the monthly base charge (for calls, and so on) is $12.95 @@ -127,31 +127,31 @@ that written down. [source] ---- -dataUsed = 0.0 -costPerGB = 1.0 -monthlyRate = 12.95 +data_used = 0.0 +cost_per_gb = 1.0 +monthly_rate = 12.95 -thisBill = 21.20 +this_bill = 21.20 # print result of computation -print("total data used (GB)", dataUsed) +print("total data used (GB)", data_used) ---- -Now we're ready to do the computation. If we subtract the monthlyRate from thisBill, we get the total cost of data. Then, if we divide the total cost of data by the cost per gigabyte, we -will get the dataUsed. +Now we're ready to do the computation. If we subtract the monthly_rate from this_bill, we get the total cost of data. Then, if we divide the total cost of data by the cost per gigabyte, we +will get the data_used. [source] ---- -dataUsed = 0.0 -costPerGB = 1.0 -monthlyRate = 12.95 +data_used = 0.0 +cost_per_gb = 1.0 +monthly_rate = 12.95 -thisBill = 21.20 -totalDataCost = thisBill - monthlyRate +this_bill = 21.20 +total_data_cost = this_bill - monthly_rate -dataUsed = totalDataCost / costPerGB +data_used = total_data_cost / cost_per_gb # print result of computation -print("total data used (GB)", dataUsed) +print("total data used (GB)", data_used) ---- How many GBs of data did we use? Turns out to be 8.25 gigabytes. diff --git a/strings.adoc b/strings.adoc index 2ab9cfa..e339fb1 100644 --- a/strings.adoc +++ b/strings.adoc @@ -99,8 +99,8 @@ This simply means joining strings together using the + operator. We have to turn [source] ---- price = 20 -dollarSign = "$" -priceTag = dollarSign + str(price) # $20 +dollar_sign = "$" +price_tag = dollar_sign + str(price) # $20 ---- @@ -109,10 +109,10 @@ Or perhaps a little more useful example: [source] ---- name = "Mikaila" -hoursWorked = str(12) +hours_worked = str(12) -workReport = "Today, " + name + " worked a total of " + hoursWorked + " hours." -print(workReport) +work_report = "Today, " + name + " worked a total of " + hours_worked + " hours." +print(work_report) ---- The output would be: @@ -140,24 +140,24 @@ Characters are extracted from a string between "start" and "end", not including [source] ---- -firstName = "Christopher" +first_name = "Christopher" ---- -Now let's use the 3 substring method-functions on firstName and extract and print out "Chris" +Now let's use the 3 substring method-functions on first_name and extract and print out "Chris" [source] ---- -firstName = "Christopher" +first_name = "Christopher" -print(firstName[0:5]) # "Chris" +print(first_name[0:5]) # "Chris" ---- -We took the `firstName` string and extracted the characters 0 to 4. BUT, let's try to extract the string "stop" from the name. +We took the `first_name` string and extracted the characters 0 to 4. BUT, let's try to extract the string "stop" from the name. [source] ---- -firstName = "Christopher" -print(firstName[4:8]) # -> "stop" +first_name = "Christopher" +print(first_name[4:8]) # -> "stop" ---- Let's try a little harder idea... @@ -166,9 +166,9 @@ Let's try a little harder idea... ==== [source] ---- -firstName = "Christopher" +first_name = "Christopher" ---- -- Your turn to use the string slicing on firstName +- Your turn to use the string slicing on first_name - Extract and print out "STOP" from inside the string above - And make it uppercase! ("stop" to "STOP") footnote:[You could google how to do this, try "python string make upper case"] ==== @@ -177,8 +177,8 @@ Well? [source] ---- -firstName = "Christopher" -print(firstName[4:8].upper()) +first_name = "Christopher" +print(first_name[4:8].upper()) ---- Want to bet there is also a ".lower()" method-function as well? @@ -215,7 +215,7 @@ This is a powerful way to handle strings in Python. === Reverse a String -Now, using the `firstName` variable again, let's reverse the string "STOP" to say "POTS". +Now, using the `first_name` variable again, let's reverse the string "STOP" to say "POTS". [TIP] ==== @@ -234,8 +234,8 @@ Solution [source] ---- -firstName = "Christopher" -res = firstName[4: 8].upper() # -> "STOP" +first_name = "Christopher" +res = first_name[4: 8].upper() # -> "STOP" rev = res[::-1] # -> POTS print(rev) # -> POTS diff --git a/variables.adoc b/variables.adoc index 14a9d82..2547cbf 100644 --- a/variables.adoc +++ b/variables.adoc @@ -158,7 +158,7 @@ as "data types". Here are a few of them. * *Strings* - *str* - a _string_ of characters - ** like 'text' or "Hello, World!" * *Boolean* - is either *True* or *False* -** often used to decide things like isPlayer(1).alive() [True or False?] +** often used to decide things like is_player(1).alive() [True or False?] * *None* - no value at all (nil or null in other languages) It is common for a computer language to want to know if data is a bunch numbers or text. Tracking diff --git a/whileloop.adoc b/whileloop.adoc index 9c0d838..9286ef1 100644 --- a/whileloop.adoc +++ b/whileloop.adoc @@ -37,9 +37,9 @@ While loops work well in situations where the condition you are testing at the t of the loop is one that may not be related to a simple number. ---- -while (player[1].isAlive() == True): - player[1].takeTurn() - game.updateStatus(player[1]) +while (player[1].is_alive() == True): + player[1].take_turn() + game.update_status(player[1]) ---- This will keep letting player[1] take a turn in the game until the player dies. Another way to do something like this is with an _infinite loop_. @@ -47,20 +47,20 @@ This will keep letting player[1] take a turn in the game until the player dies. We're going to use both *continue* and *break* in this example, and we will describe them better after we're done with loops. ---- -player = game.newPlayer() +player = game.new_player() while (true): # <- notice right here, an infinite loop - player.takeTurn() - game.updateScores() - game.advanceTime() + player.take_turn() + game.update_scores() + game.advance_time() - if (player.isAlive() == true): + if (player.is_alive() == true): continue # start at top of loop again. else: break # breaks out of loop and ends game. -game.sayToHuman("Game Over!") +game.say_to_human("Game Over!") ---- Here, we are using the continue statement to force the flow of control to the top of the loop if the player is still alive after the 'take turn' code. We are also using the break statement to break out of the infinite loop when the player dies, letting us do other things after the player has 'died'. From c3f005152a6743f14099cdb69214ac6658afdd31 Mon Sep 17 00:00:00 2001 From: Kristofer Date: Thu, 24 Sep 2026 15:50:08 -0400 Subject: [PATCH 06/12] adds Sets and Tuples --- index.adoc | 4 ++ sets.adoc | 124 ++++++++++++++++++++++++++++++++++++++++++++++++++++ tuples.adoc | 111 ++++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 239 insertions(+) create mode 100644 sets.adoc create mode 100644 tuples.adoc diff --git a/index.adoc b/index.adoc index d18b78f..a77b9dc 100644 --- a/index.adoc +++ b/index.adoc @@ -172,6 +172,10 @@ include::return.adoc[] include::dictionary.adoc[] +include::sets.adoc[] + +include::tuples.adoc[] + include::modules.adoc[] include::objectsmethods.adoc[] diff --git a/sets.adoc b/sets.adoc new file mode 100644 index 0000000..bddfbec --- /dev/null +++ b/sets.adoc @@ -0,0 +1,124 @@ + + +== Sets + +We just talked about dictionaries and their key:value pairs. Now let's talk about their cousin, the *set*. + +A set is a collection, like a list, but with one big difference: *a set will not allow duplicates.* Every item in a set is unique. Think of a set as a bag of marbles where, no matter how many times you try to drop in a second red marble, the bag just quietly refuses to hold two. There's only ever one red marble in there. + +Sets also don't care about order. If a list is like the post office boxes we talked about earlier - numbered and in a row - a set is more like a junk drawer. Everything's in there, but nobody's keeping track of what's "first." + +=== Creating a Set + +You make a set with curly braces, much like a dictionary, but without the `key:value` pairs - just values. + +[source] +---- +donut_flavors = {"chocolate", "glazed", "jelly"} +---- + +Here's the fun part. What happens if we try to sneak in a duplicate? + +[source] +---- +donut_flavors = {"chocolate", "glazed", "jelly", "chocolate"} + +print(donut_flavors) +# output is +# {'chocolate', 'glazed', 'jelly'} +---- + +See that? We tried to add "chocolate" twice, and the set just kept the one copy. That's the whole point of a set: it *guarantees uniqueness* for you, automatically, without you having to write any code to check for it yourself. + +NOTE: An empty pair of curly braces, `{}`, actually creates an empty *dictionary*, not an empty set. To make an empty set, you have to use `set()`. + +[source] +---- +empty_set = set() +---- + +=== Adding and Removing Items + +You add items to a set with `.add()`, and remove them with `.remove()`. + +[source] +---- +donut_flavors = {"chocolate", "glazed", "jelly"} + +donut_flavors.add("sprinkled") +print(donut_flavors) +# output is +# {'chocolate', 'glazed', 'jelly', 'sprinkled'} + +donut_flavors.remove("jelly") +print(donut_flavors) +# output is +# {'chocolate', 'glazed', 'sprinkled'} +---- + +If you try to add something that's already there, nothing bad happens - Python just shrugs and leaves the set exactly as it was. + +[source] +---- +donut_flavors.add("chocolate") # already there, no change +---- + +=== Testing Membership + +Just like with dictionaries, we can use `in` and `not in` to ask a set whether it holds something. + +[source] +---- +donut_flavors = {"chocolate", "glazed", "jelly"} + +if "jelly" in donut_flavors: + print("Good, we have jelly donuts!") + +if "cronut" not in donut_flavors: + print("No cronuts here, sadly.") +---- + +This is actually one of the best reasons to use a set. Checking "is this thing in here?" on a big set is very fast, much faster than checking a big list one item at a time. + +=== Where Sets Really Shine: Removing Duplicates + +Let's say five friends are playing our dungeon game, and each one picked a favorite weapon. We want to know how *many different* weapons were picked, not how many friends picked each one. + +[source] +---- +weapons_picked = ["sword", "bow", "sword", "axe", "bow"] + +unique_weapons = set(weapons_picked) + +print(unique_weapons) +# output is +# {'sword', 'bow', 'axe'} + +print(len(unique_weapons)) # -> 3 +---- + +We took a list, which allowed duplicates, and turned it into a set with one line of code. Just like that, the duplicates vanished, and we're left with only the unique weapons. + +=== Combining Sets + +Sets have a few operators borrowed straight from math class, back when you drew those overlapping circles (Venn diagrams, if you remember the name). The two you'll use most are *union* (everything from both sets, combined) and *intersection* (only what's in both sets). + +[source] +---- +players_with_sword = {"Sam", "Jade", "Sadie"} +players_with_shield = {"Jade", "Sadie", "Marcus"} + +# union: everyone who has a sword OR a shield (or both) +print(players_with_sword | players_with_shield) +# output is +# {'Sam', 'Jade', 'Sadie', 'Marcus'} + +# intersection: only the players who have BOTH +print(players_with_sword & players_with_shield) +# output is +# {'Jade', 'Sadie'} +---- + +You don't need to memorize every set operation Python offers. Just remember that `|` glues two sets together (removing duplicates along the way, of course), and `&` finds what they have in common. + +Sets are a handy tool to keep in your back pocket. Whenever you find yourself needing to guarantee "no duplicates allowed" or asking "is this thing in that collection?" over and over, a set is very likely the right data structure for the job. diff --git a/tuples.adoc b/tuples.adoc new file mode 100644 index 0000000..7109d3f --- /dev/null +++ b/tuples.adoc @@ -0,0 +1,111 @@ + + +== Tuples + +We've talked about lists, and how they're a great way to store a bunch of things in order. Now, let's meet the list's more stubborn sibling: the *tuple*. + +A tuple looks a lot like a list, and acts a lot like a list... except for one very important thing: *once you create a tuple, you cannot change it.* No adding, no removing, no swapping out an item. It's locked, permanently, the moment you create it. Programmers call this *immutable*, which is just a fancy word for "cannot be changed once made." + +Why would you ever want that? Well, imagine you've got some data that should never accidentally get messed with later on in your program - like a person's date of birth, or the (x, y) coordinates of a spot on a map. A tuple is Python's way of saying "this data is locked in, don't touch it." + +=== Creating a Tuple + +You create a tuple with parentheses instead of the square brackets you'd use for a list. + +[source] +---- +coordinates = (10, 20) + +katniss_info = ("Katniss", "Everdeen", 12) +---- + +Just like lists, tuples can hold any mix of data types - strings, numbers, booleans, even other tuples or lists. + +NOTE: If you want a tuple with just *one* item in it, you need a trailing comma, like `(100,)`. Without the comma, Python thinks you just wrote the number `100` inside some plain parentheses, not a tuple at all! + +[source] +---- +not_a_tuple = (100) # this is just the number 100 +single_tuple = (100,) # this IS a tuple with one item +---- + +=== Accessing Items in a Tuple + +Reading from a tuple works exactly like reading from a list. Tuples are indexed starting at zero, just like everything else we've indexed so far. + +[source] +---- +katniss_info = ("Katniss", "Everdeen", 12) + +print(katniss_info[0]) # "Katniss" +print(katniss_info[2]) # 12 +---- + +You can slice a tuple too, the same way you'd slice a list or a string. + +[source] +---- +weekday_scores = (88, 92, 79, 95, 100) + +print(weekday_scores[1:3]) # (92, 79) +print(weekday_scores[-1]) # 100 +---- + +=== You Really Can't Change It + +Let's prove it. If you try to change an item in a tuple, Python will stop you cold with an error. + +[source] +---- +katniss_info = ("Katniss", "Everdeen", 12) + +katniss_info[2] = 13 +# TypeError: 'tuple' object does not support item assignment +---- + +Compare that to a list, where this same kind of line would work just fine. This is the whole reason tuples exist: sometimes you *want* that safety net, so nothing later in your program can accidentally mangle your data. + +=== Unpacking a Tuple + +One of the nicest tricks with tuples is *unpacking* - pulling the items out into their own separate variables, all in one line. + +[source] +---- +katniss_info = ("Katniss", "Everdeen", 12) + +first_name, last_name, home_district = katniss_info + +print(first_name) # "Katniss" +print(last_name) # "Everdeen" +print(home_district) # 12 +---- + +This works because Python matches up each variable on the left with the item in the same position on the right. It's a very clean way to hand out a tuple's contents without writing `katniss_info[0]`, `katniss_info[1]`, and so on. + +You'll also see this used a lot with coordinates: + +[source] +---- +location = (35, 80) + +x, y = location + +print(x) # 35 +print(y) # 80 +---- + +=== Tuples vs. Lists + +So when do you reach for a tuple instead of a list? Here's a simple way to think about it: + +* Use a *list* when you have a collection of things that might change - growing, shrinking, or getting swapped around. +* Use a *tuple* when you have a fixed little bundle of data that should stay exactly as it is - like a coordinate pair, a date, or a record you're just reading from, never editing. + +[source] +---- +player_health_scores = [100, 100, 100, 100, 100] # this will change during the game + +spawn_point = (0, 0) # this should never change +---- + +Tuples aren't as flashy as lists, but they earn their keep. Whenever you find yourself thinking "this data should never change," reach for a tuple, and let Python enforce that promise for you. From 141c4595263be0d73d594ab55037fbdf2cd029c5 Mon Sep 17 00:00:00 2001 From: Kristofer Date: Fri, 25 Sep 2026 11:38:10 -0400 Subject: [PATCH 07/12] lots o changes --- booleanexpr.adoc | 2 +- builtins.adoc | 203 +++++++++++++++++++++++++++++++++++++++++ builtinsadvanced.adoc | 115 +++++++++++++++++++++++ consolelog.adoc | 17 ++-- dictcomprehension.adoc | 109 ++++++++++++++++++++++ dundermethods.adoc | 154 +++++++++++++++++++++++++++++++ forloop.adoc | 11 +-- if.adoc | 3 +- index.adoc | 67 ++++++++------ lambdas.adoc | 122 +++++++++++++++++++++++++ listcomprehension.adoc | 111 ++++++++++++++++++++++ lists.adoc | 4 +- modules.adoc | 117 +++++++++++++++++++----- objectsmethods.adoc | 55 +++++------ operators.adoc | 15 ++- patterns.adoc | 4 +- setcomprehension.adoc | 86 +++++++++++++++++ strings.adoc | 2 +- variables.adoc | 17 ++-- whileloop.adoc | 15 ++- 20 files changed, 1111 insertions(+), 118 deletions(-) create mode 100644 builtins.adoc create mode 100644 builtinsadvanced.adoc create mode 100644 dictcomprehension.adoc create mode 100644 dundermethods.adoc create mode 100644 lambdas.adoc create mode 100644 listcomprehension.adoc create mode 100644 setcomprehension.adoc diff --git a/booleanexpr.adoc b/booleanexpr.adoc index cce6aa5..fe0bf0c 100644 --- a/booleanexpr.adoc +++ b/booleanexpr.adoc @@ -119,7 +119,7 @@ customer.can_transfer_from_savings() ) See how these conditions could line up to allow a customer to get cash from the cash machine? Again, this is *why* boolean expressions are important and powerful and -why coders need to be able to use them to get the software *just right*. +why programmers need to be able to use them to get the software *just right*. [TIP] diff --git a/builtins.adoc b/builtins.adoc new file mode 100644 index 0000000..524d42e --- /dev/null +++ b/builtins.adoc @@ -0,0 +1,203 @@ + + +== Built-in Functions + +You've already met a few of Python's *built-in functions* without me making a big deal about it. `print()`, `len()`, `type()`, `range()` - these have been showing up in almost every chapter so far. That's because Python ships with a whole toolbox of these ready-made functions, sitting there waiting for you to use them, no importing required. + +Think of built-in functions as the tools that came in the toolbox when you bought it, versus tools you'd have to go buy separately (that's what _modules_ are for, which we'll get to). You don't have to build a hammer before you can hammer a nail. Python already handed you the hammer. + +We're not going to cover *all* of them - there are over 70 in Python - but let's round up the ones you'll reach for every single day. + +=== The Everyday Ones + +These are the built-ins you'll type without even thinking about it, mostly for looking at what's going on inside your program. + +[cols=",",options="header",] +|=== +|Function |What it does +|`print()` |Sends text or a value out to the screen +|`len()` |Tells you how many items are in a string, list, tuple, dictionary, or set +|`type()` |Tells you what kind of thing a variable actually is +|`input()` |Pauses your program and waits for the human to type something +|=== + +You already know `print()` and `len()` well. `type()` showed up back when we talked about data types - it's your go-to when you're not sure what you're holding. + +[source] +---- +donut_count = 12 +print(type(donut_count)) # -> +---- + +`input()` is new, and it's a fun one, because it's the first time your program actually *listens* to a human being instead of just talking at them. + +[source] +---- +player_name = input("What's your character's name? ") +print("Welcome to the dungeon, " + player_name + "!") +---- + +Whatever the person types gets handed back to you *as a string*, every single time - even if they type a number. + +[source] +---- +age = input("How old is your character? ") +print(type(age)) # -> , even though they typed "25" +---- + +NOTE: If you need that input as an actual number, you have to convert it yourself, which brings us to our next set of tools. + +=== Converting Between Types + +`str()`, `int()`, `float()`, and `bool()` let you convert a value from one data type into another. You've actually already seen `str()` back when we talked about joining a number onto a string. + +[source] +---- +hours_worked = 12 +report = "Hours worked: " + str(hours_worked) +---- + +The reverse trick works too. Remember how `input()` always hands you back a string? Here's how you turn that string into a real number you can do math with. + +[source] +---- +age_text = input("How old is your character? ") +age = int(age_text) + +print(age + 1) # works! age is now a real number. +---- + +[source] +---- +print(int("42")) # -> 42 +print(float("3.14")) # -> 3.14 +print(bool(0)) # -> False +print(bool(1)) # -> True +print(bool("")) # -> False, an empty string is "falsy" +print(bool("hello")) # -> True, almost anything else is "truthy" +---- + +There are four more constructors just like these, except they build *data structures* instead of simple values: `list()`, `dict()`, `set()`, and `tuple()`. We met `set()` this way back in the Sets chapter, turning a list with duplicates into a set with none. + +[source] +---- +weapons_picked = ["sword", "bow", "sword", "axe", "bow"] + +unique_weapons = set(weapons_picked) +print(unique_weapons) # -> {'sword', 'bow', 'axe'} + +back_to_a_list = list(unique_weapons) +print(back_to_a_list) # -> ['sword', 'bow', 'axe'] +---- + +Each of these constructors is handy any time you need an empty starting point, too - `[]` and `list()` do the same job, but sometimes writing `list()` makes your intention clearer to someone reading your code. + +=== Looping Like a Pro + +We introduced `range()` back in the For Loop chapter, so you already know it generates a sequence of numbers to loop over. Now let's meet a couple of its cousins that make loops even more powerful. + +`enumerate()` solves a really common headache: needing *both* an item from a list *and* its index, at the same time, without writing your own counter variable. + +[source] +---- +donut_flavors = ["chocolate", "glazed", "jelly"] + +for index, flavor in enumerate(donut_flavors): + print(index, "-", flavor) + +# output is +# 0 - chocolate +# 1 - glazed +# 2 - jelly +---- + +Before `enumerate()`, you'd have had to do something clunkier, like looping over `range(len(donut_flavors))` and indexing in yourself. `enumerate()` just hands you both pieces, gift-wrapped, every time through the loop. + +`zip()` is for when you've got two (or more) lists that go together, item by item, and you want to walk through them side by side. + +[source] +---- +player_names = ["Sam", "Jade", "Sadie"] +player_health_scores = [100, 87, 42] +player_data = zip(player_names, player_health_scores) +print(type(player_data)) # -> + +for name, health in player_data: + print(name, "has", health, "health points.") + +# output is +# Sam has 100 health points. +# Jade has 87 health points. +# Sadie has 42 health points. +---- + +`zip()` pairs up the first item of each list, then the second item of each, and so on - like a zipper on a jacket, pulling two rows of teeth (data) together one pair at a time. That's actually where it gets its name. + +Finally, `sorted()` hands you back a *brand new* sorted list, and - importantly - it leaves your original list completely untouched. + +[source] +---- +player_health_scores = [100, 87, 42, 100, 65] + +ranked = sorted(player_health_scores) +print(ranked) # -> [42, 65, 87, 100, 100] +print(player_health_scores) # -> [100, 87, 42, 100, 65], unchanged! +---- + +Want it the other way around, highest to lowest? Just add `reverse=True`. + +[source] +---- +ranked = sorted(player_health_scores, reverse=True) +print(ranked) # -> [100, 100, 87, 65, 42] +---- + +=== Doing Math Without the `math` Module + +A handful of built-ins handle simple math jobs so commonly needed that Python doesn't even make you `import` anything for them. + +[source] +---- +weekday_scores = [88, 92, 79, 95, 100] + +print(sum(weekday_scores)) # -> 454 +print(max(weekday_scores)) # -> 100 +print(min(weekday_scores)) # -> 79 +---- + +`sum()`, `max()`, and `min()` all work on any list (or tuple, or set) full of numbers. `max()` and `min()` also work if you just hand them a plain old comma-separated list of values, no brackets needed. + +[source] +---- +print(max(4, 19, 7)) # -> 19 +print(min(4, 19, 7)) # -> 4 +---- + +`abs()` gives you the *absolute value* of a number - meaning, it strips away any negative sign and hands you back the positive version. + +[source] +---- +altitude_change = -350 + +print(abs(altitude_change)) # -> 350 +---- + +Why would you want that? Imagine our Mars Lander from the Appendix, tracking how far off course it drifted. Sometimes it drifts left (negative), sometimes right (positive), but for a warning light, you often just care *how much* it drifted, not which direction. + +[source] +---- +drift = -12.5 + +if abs(drift) > 10: + print("Warning: lander has drifted too far off course!") +---- + +[TIP] +==== +* Make a list of five numbers, some positive and some negative +* Use `sum()` to add them all up +* Use `max()` and `min()` to find the highest and lowest +* Use `abs()` on the lowest one to see how "big" it really is, ignoring its sign +==== + +We've covered the built-ins you'll reach for constantly, in almost every program you write. Once these feel comfortable in your hands, head on to the next chapter, where we'll take a closer look at lambdas - small, throwaway functions that pair up with a few more built-in functions you're about to meet. diff --git a/builtinsadvanced.adoc b/builtinsadvanced.adoc new file mode 100644 index 0000000..84f6e8e --- /dev/null +++ b/builtinsadvanced.adoc @@ -0,0 +1,115 @@ + + +== Advanced Built-in Functions + +A couple of chapters back, we covered the built-in functions you'll use constantly, without much thought. And in the last chapter, you got comfortable with lambdas - those small, throwaway, one-line functions. Now let's put lambdas to work, alongside a handful of built-in functions that let you test or transform an *entire collection* in one line, instead of writing out a `for` loop by hand every time. + +These aren't harder to use than what you've already seen, they're just a bit less obvious *why* you'd want them, until you've hit the problem they solve. So let's hit those problems. + +=== Testing a Whole Collection at Once + +`any()` and `all()` save you from writing a bunch of `and`/`or` chains by hand, when what you really want to know is something about a *whole group* of true/false values. + +`all()` checks whether *every single item* in a collection is `True`. If even one item is `False`, the whole thing is `False`. + +[source] +---- +players_alive = [True, True, True] +print(all(players_alive)) # -> True, everybody made it! + +players_alive = [True, False, True] +print(all(players_alive)) # -> False, someone didn't make it. +---- + +`any()` checks whether *at least one* item is `True`. It only comes back `False` if every single item is `False`. + +[source] +---- +players_alive = [False, False, True] +print(any(players_alive)) # -> True, at least one player survived! + +players_alive = [False, False, False] +print(any(players_alive)) # -> False, nobody made it. Game over. +---- + +These come in especially handy paired with a quick list of boolean expressions, so you can check a whole batch of conditions in one line instead of writing them all out with `and` or `or`. + +[source] +---- +checks = [ + fuel_available > 0, + altitude > 0, + pilot.is_alive() +] + +if all(checks): + print("Cleared for takeoff!") +---- + +=== Applying a Function to an Entire List + +`map()` takes a function and a list, and runs that function on *every single item* in the list, handing you back the results. It saves you from writing out a `for` loop just to transform each item the same way. + +[source] +---- +player_health_scores = [100, 87, 42] + +def apply_shield_bonus(score): + return score + 10 + +boosted_scores = list(map(apply_shield_bonus, player_health_scores)) +print(boosted_scores) # -> [110, 97, 52] +---- + +Notice we had to wrap it in `list()`. That's because `map()` doesn't hand you back a list directly - it hands you back something called a *map object*, which is really just a promise to compute those values when you actually ask for them. Wrapping it in `list()` says "okay, compute them now, and give me a real list." + +You'll often see `map()` paired with a `lambda`, since the function you're applying is frequently a small, throwaway one. + +[source] +---- +donut_prices = [1.50, 1.75, 2.00] + +prices_with_tax = list(map(lambda price: price * 1.06, donut_prices)) +print(prices_with_tax) # -> [1.59, 1.855, 2.12] +---- + +=== Filtering a List + +`filter()` is `map()`'s close cousin. Instead of transforming every item, it *keeps only the items that pass a test*, throwing the rest away. + +[source] +---- +player_health_scores = [100, 87, 0, 42, 0] + +def is_still_alive(score): + return score > 0 + +survivors = list(filter(is_still_alive, player_health_scores)) +print(survivors) # -> [100, 87, 42] +---- + +Just like `map()`, `filter()` needs a function that returns `True` or `False` for each item, and just like `map()`, you'll usually wrap the result in `list()` to see it plainly. And just like `map()`, a `lambda` often does the job without needing a separate named function at all. + +[source] +---- +donut_flavors = ["chocolate", "glazed", "jelly", "chocolate glaze"] + +chocolatey_ones = list(filter(lambda flavor: "chocolate" in flavor, donut_flavors)) +print(chocolatey_ones) # -> ['chocolate', 'chocolate glaze'] +---- + +Between `map()` (transform everything) and `filter()` (keep only some things), you can do an enormous amount of list-wrangling without ever writing a manual `for` loop. + +[TIP] +==== +* Start with a list of five player health scores, mixing in a couple of zeros for "fallen" players +* Use `filter()` to build a list of only the survivors +* Use `map()` on that survivor list to give everyone a `+5` health bonus +* Use `all()` to check whether every remaining survivor now has more than 50 health +==== + +=== Keep Exploring + +Between the last chapter and this one, we've covered a solid dozen of Python's built-in functions, but there are dozens more out there, quietly waiting to make your life easier. The real lesson isn't "memorize this list." It's this: *before you write ten lines of code to solve a problem, check if Python already gave you a built-in function that does it in one.* More often than you'd think, it already has. + +Coming up next, we'll look at *comprehensions* - Python's even shorter, and arguably more popular, way to do what `map()` and `filter()` just did for us. diff --git a/consolelog.adoc b/consolelog.adoc index f308c23..fcbc195 100644 --- a/consolelog.adoc +++ b/consolelog.adoc @@ -36,7 +36,7 @@ Car's Speed: 55 as the program's output. -Cool, huh? The ability to communicate with you is one of Python's most fundamental capabilities. And you've run two Python programs. Congratulations, you're a coder. (Well, at least for today you are.) +Cool, huh? The ability to communicate with you is one of Python's most fundamental capabilities. And you've run two Python programs. Congratulations, you're a programmer. (Well, at least for today you are.) == Comments @@ -99,11 +99,12 @@ Each of these lines is something we'd like Python to *compute* for us. That comp *Arithmetic expressions* are, as their name implies, something that require arithmetic to get the answer. An expression like "5 + 8 - 3" gets _evaluated_ to 10. -*Boolean expressions* result in either a True or a False value. Example: "max_speed > 500.0" - this is either true or false depending on the value of max_speed. +*Boolean expressions* result in either a True or a False value. Example: "max_speed > 500.0" - this evaluates to either true or false depending on the value of max_speed. === Statements A *statement* is just a line of Python. +All python statements have very specific patterns. [source] ---- @@ -118,6 +119,8 @@ charge_to_card = total_groceries + sales_tax ---- And this is what a Python program looks like. It's just a list of statements, one after the other, that get computed from the top down. +This is referred to control flow. The first statement is executed, then the second, and so on, until the program reaches the end. + Some of the statements have expressions in them (like total_groceries * sales_tax_rate), while some are just simple *assignment* statements (like total_groceries = 38.99, where we assign the variable 'total_groceries' the value 38.99). Don't panic. These are just some simple examples of Python to give you a feel for it. We'll go thru each of these kinds of things slowly in sections ahead. @@ -141,10 +144,8 @@ When you come across code that goes onto multiple lines, do like Python does, lo Very often in Python, we will see a *block* of statements. It is a list of statements _indented_ the same amount. (Yes, unlike many languages, in Python, _white space is important_.) It acts like a container to make clear what statements are included in the block. -It is _so important_ that indentation, and making sure you have everything aligned properly, is one of the most important thing to learn about Python when you are a beginner. -Many a beginner discovers that the braces _{ }_ that other languages use to manage the way code is grouped together are missing from Python. Java, JavaScript, and many other languages use braces to handle how code gets grouped together. - -Not Python, that's why is _SO_ very important to get it right. +It is _so important_ that *indentation* and *making sure you have everything aligned properly* is *one of the most important things to learn* about Python when you are a beginner. +Many beginners discover that the braces _{ }_ that other languages use to manage the way code is grouped together are missing from Python. Java, JavaScript, and many other languages use braces to handle how code gets grouped together. [source] ---- @@ -161,6 +162,10 @@ if (mage_power > 120.0): print(mage_power, "is your Mage's Power rating.") ---- +**Python does not use braces to group code together. Instead, it uses indentation.** + +Not Python, that's why is _SO_ *very important* to get it right. + See those SPACES (and confusingly, they might be TABs but you cannot tell that by looking at the line). All the indented lines below the IF statement are part of what gets run when the IF is True. Then you also see a nested IF below that, one that has an _else_ statement. diff --git a/dictcomprehension.adoc b/dictcomprehension.adoc new file mode 100644 index 0000000..bd97f0a --- /dev/null +++ b/dictcomprehension.adoc @@ -0,0 +1,109 @@ + + +== Dictionary Comprehensions + +Now that list comprehensions feel familiar, let's reuse that exact same idea to build a *dictionary* instead of a list. Not surprisingly, this is called a *dictionary comprehension*. + +=== Building a Dictionary the Old Way + +Remember `zip()`, from the Built-in Functions chapter? We used it to pair up player names with their health scores and loop over both together. + +[source] +---- +player_names = ["Sam", "Jade", "Sadie"] +player_health_scores = [100, 87, 42] + +health_lookup = {} +for name, health in zip(player_names, player_health_scores): + health_lookup[name] = health + +print(health_lookup) +# output is +# {'Sam': 100, 'Jade': 87, 'Sadie': 42} +---- + +We're building an empty dictionary, then looping and adding one key:value pair at a time. It works, but just like with lists, there's a shortcut. + +=== The Dictionary Comprehension Way + +[source] +---- +player_names = ["Sam", "Jade", "Sadie"] +player_health_scores = [100, 87, 42] + +health_lookup = {name: health for name, health in zip(player_names, player_health_scores)} + +print(health_lookup) +# output is +# {'Sam': 100, 'Jade': 87, 'Sadie': 42} +---- + +Same result, one line. The pattern looks almost exactly like a list comprehension, except it's wrapped in curly braces `{}` (just like a dictionary itself), and instead of one expression, you provide *two*, separated by a colon - a key and a value. + +[source] +---- +{key_expression: value_expression for item in iterable} +---- + +* `key_expression` - what becomes the key for this pair +* `value_expression` - what becomes the value for this pair +* `item` - the name for whatever you're pulling out of `iterable`, one at a time + +=== A Simpler Example + +Let's build a dictionary that maps each donut flavor to the length of its name - no `zip()` required this time, just one list. + +[source] +---- +donut_flavors = ["chocolate", "glazed", "jelly"] + +flavor_lengths = {flavor: len(flavor) for flavor in donut_flavors} + +print(flavor_lengths) +# output is +# {'chocolate': 9, 'glazed': 6, 'jelly': 5} +---- + +Here, `flavor` is both the key *and* used to compute the value (`len(flavor)`). The key and the value don't have to come from different places - they can both be built from the very same item. + +=== Filtering, Same as Before + +Just like list comprehensions, you can tack an `if` onto the end to only include certain pairs. + +[source] +---- +player_health_scores = {"Sam": 100, "Jade": 87, "Sadie": 0} + +survivors_only = {name: health for name, health in player_health_scores.items() if health > 0} + +print(survivors_only) +# output is +# {'Sam': 100, 'Jade': 87} +---- + +NOTE: To loop over an *existing* dictionary's key:value pairs, you call `.items()` on it, which is what hands you both `name` and `health` together, one pair at a time. + +=== Transforming an Existing Dictionary + +Dictionary comprehensions are also great for building a *new, changed* version of a dictionary you already have, without touching the original. + +[source] +---- +player_health_scores = {"Sam": 100, "Jade": 87, "Sadie": 42} + +boosted = {name: health + 10 for name, health in player_health_scores.items()} + +print(boosted) # -> {'Sam': 110, 'Jade': 97, 'Sadie': 52} +print(player_health_scores) # -> {'Sam': 100, 'Jade': 87, 'Sadie': 42}, unchanged! +---- + +[TIP] +==== +* Start with a dictionary mapping three donut flavors to their prices +* Build a new dictionary, using a comprehension, with 6% sales tax added to every price +* Now build a second comprehension that only keeps the flavors priced under $2.00 +==== + +Dictionary comprehensions come in handy any time you're building a lookup table from some other collection of data - which, now that you're thinking in Python, turns out to be *very* often. + +There's one more comprehension left to meet. Let's finish this trio by building a set. diff --git a/dundermethods.adoc b/dundermethods.adoc new file mode 100644 index 0000000..377c4ca --- /dev/null +++ b/dundermethods.adoc @@ -0,0 +1,154 @@ + + +== Dunder Methods + +In the last chapter, our `Spacecraft` class had two methods that looked a little strange: `__init__` and `__str__`. Those double underscores on both sides aren't a typo, and they aren't decoration. They're Python's way of marking a method as special. Programmers call these *dunder methods* - short for "Double UNDERscore" - and this chapter is all about what they are and why they matter. + +=== What Makes a Method a "Dunder" + +Any method whose name starts and ends with two underscores, like `__init__` or `__str__`, is a dunder method. You don't invent these names yourself - Python has a fixed list of them, and each one has a specific job. What makes them special is that you almost never call them directly. Instead, *Python calls them for you*, automatically, in response to something else you do to the object - creating it, printing it, comparing it, and so on. + +Think of dunder methods as hooks. You write the hook, and Python promises to pull it at just the right moment. + +=== `__init__`: The Constructor You Already Know + +You met this one last chapter, but let's call it out by name: `__init__` is called automatically the *instant* you create a new object. It's where you set up all of an object's starting values. + +[source] +---- +class Spacecraft: + def __init__(self, name, topspeed): + self.name = name + self.topspeed = topspeed + self.current_speed = 0 + +enterprise = Spacecraft("Enterprise", 9.9) +print(enterprise.name) # -> Enterprise +print(enterprise.topspeed) # -> 9.9 +---- + +Notice we didn't have to set `enterprise.name = "Enterprise"` on a separate line afterward, like we did before `__init__` showed up. Passing `"Enterprise"` and `9.9` straight into `Spacecraft(...)` hands them right to `__init__`, which tucks them away on `self`. `__init__` is a dunder, but it's such a common one you'll write it in almost every class you ever build. + +=== `__str__`: Controlling How print() Sees You + +You also met `__str__` last chapter. It's the hook that Python pulls whenever your object needs to be turned into a readable string - most commonly, when you `print()` it. + +[source] +---- +class Spacecraft: + def __init__(self, name, topspeed): + self.name = name + self.topspeed = topspeed + + def __str__(self): + return "Starship " + self.name + +enterprise = Spacecraft("Enterprise", 9.9) +print(enterprise) +# -> Starship Enterprise +---- + +Without `__str__`, `print(enterprise)` would spit out something ugly and unhelpful, like `<__main__.Spacecraft object at 0x103013100>`. With it, you decide exactly what shows up. + +=== `__eq__`: Teaching Python What "Equal" Means + +By default, Python considers two objects equal only if they are *literally the same object* in memory - not just similar, but the exact same one. + +[source] +---- +enterprise = Spacecraft("Enterprise", 9.9) +enterprise_copy = Spacecraft("Enterprise", 9.9) + +print(enterprise == enterprise_copy) # -> False, even though they look identical! +---- + +That's often not what we want. If two spacecraft have the same name, we probably want `==` to say they're equal. That's what `__eq__` is for. + +[source] +---- +class Spacecraft: + def __init__(self, name, topspeed): + self.name = name + self.topspeed = topspeed + + def __eq__(self, other): + return self.name == other.name + +enterprise = Spacecraft("Enterprise", 9.9) +enterprise_copy = Spacecraft("Enterprise", 9.9) + +print(enterprise == enterprise_copy) # -> True now! +---- + +`__eq__` takes two things to compare: `self` (the object on the left of `==`) and `other` (the object on the right). Whatever expression you return becomes the answer to "are these equal?" + +=== `__len__`: Letting Your Object Work With len() + +Remember `len()`, from way back in the Built-in Functions chapter? It works on strings, lists, dicts, and sets - and it can work on *your own* classes too, if you define `__len__`. + +[source] +---- +class Fleet: + def __init__(self, ships): + self.ships = ships + + def __len__(self): + return len(self.ships) + +home_fleet = Fleet(["Enterprise", "Constellation", "Defiant"]) + +print(len(home_fleet)) # -> 3 +---- + +Whatever number `__len__` returns is exactly what `len()` hands back to whoever calls it. This is a small example of a bigger idea: dunder methods are how your *own* classes get to plug into Python's built-in functions and operators, instead of only working with Python's built-in types. + +=== `__add__`: Teaching Python What "+" Means for You + +That same idea applies to operators, not just functions. `__add__` controls what happens when your object is used on the left side of a `+`. + +[source] +---- +class Fleet: + def __init__(self, ships): + self.ships = ships + + def __add__(self, other): + return Fleet(self.ships + other.ships) + + def __len__(self): + return len(self.ships) + +home_fleet = Fleet(["Enterprise", "Constellation"]) +reserve_fleet = Fleet(["Defiant"]) + +combined_fleet = home_fleet + reserve_fleet + +print(len(combined_fleet)) # -> 3 +---- + +Without `__add__`, writing `home_fleet + reserve_fleet` would just crash with an error, since Python has no idea how to "add" two `Fleet` objects together. With it, you decide what `+` should mean for your own class. + +=== A Quick Reference + +[cols=",,",options="header",] +|=== +|Dunder Method |Gets Called When... |Common Use +|`__init__` |An object is created |Setting up starting values +|`__str__` |The object is printed, or turned into a string |A friendly, readable description +|`__eq__` |Two objects are compared with `==` |Deciding what "equal" means for your class +|`__len__` |`len()` is called on the object |Reporting some meaningful "size" +|`__add__` |Two objects are combined with `+` |Deciding what "adding" means for your class +|=== + +[TIP] +==== +* Add a `__len__` method to a `Player` class that returns how many items are in that player's inventory list +* Add an `__eq__` method that considers two players equal if they have the same name +* Try `len(player)` and `player_one == player_two` and see your dunder methods kick in +==== + +=== Why This Matters + +Here's the big idea to walk away with: dunder methods are the bridge between *your own* custom classes and all the built-in syntax and functions you've already learned throughout this book - `print()`, `len()`, `==`, `+`, and plenty more we haven't shown here. You're not learning a pile of odd, unrelated tricks. You're learning the *one mechanism* Python uses, over and over, to let your objects behave like they belong in the language, right alongside strings, lists, and dictionaries. + +You won't need most dunder methods most of the time. But `__init__` and `__str__` will show up in nearly every class you write from here on out, so make sure those two, at least, feel like old friends. diff --git a/forloop.adoc b/forloop.adoc index 50e68b8..7b5a880 100644 --- a/forloop.adoc +++ b/forloop.adoc @@ -5,7 +5,7 @@ The *for* loop is more complex, but it’s also the most commonly used loop. In Python, the for loop is very powerful. It has a number of different forms, including one which is remarkably simple. -Maybe we have a list of donuts. +Maybe we have a list of donuts. And we want to print out each one. [source] @@ -39,7 +39,7 @@ for index in range(len(list_of_donuts)): Here the index was set to 0 and then 1, and then 2, and the index was used to retrieve from the list the donut name at the index. list_of_donuts[1] is "glazed". This example's out is the same as the for-each loop above. -Let's use range() is much more common usage. +Let's use *range()* is much more common usage. Here's one where we go from 0 to 4. @@ -58,12 +58,12 @@ Now say we wanted to print out the sum of all the numbers from 1 to 10. ---- # performing sum of 1 to 10 sum = 0 -for i in range(1, 11): - sum = sum + i +for i in range(1, 11): + sum = sum + i print("Sum of first 10 natural numbers is ", sum) ---- -Wait! Notice how we have to ask range to *one beyond* the last number we want added to the sum! +Wait! Notice how we have to ask range to *one beyond* (11) the last number we want added to the sum! That's because the range starts at 0 and includes every whole number up to, but *not including*, the number that you have provided as the stop number. There are three versions to the range()'s mechanism. @@ -102,4 +102,3 @@ Look, we had to range(10, 0, -1) to get the one to print. Otherwise if we had ha The *range()* function gets used a lot in Python, and is the envy of many programmers in other languages who have use the *for* loop that was handed down from the C programming language. So use it widely, and don't gloat -- too much :-) - diff --git a/if.adoc b/if.adoc index 7baa947..b407470 100644 --- a/if.adoc +++ b/if.adoc @@ -2,11 +2,12 @@ == Conditional Statements We have been seeing programs which consist of a list of statements, one after another, where the "flow of control" goes from one line to the next, top to bottom, and so on to the end of the list of lines. + There are more useful ways of breaking up the "control flow" of a program. Python has several conditional statements that the programmer do things based on conditions in the data. === If statement -The first conditional statement is the *if* statement. +The first conditional statement is the *if* statement. [source] ---- diff --git a/index.adoc b/index.adoc index a77b9dc..4fe83bc 100644 --- a/index.adoc +++ b/index.adoc @@ -10,7 +10,7 @@ v2.0.1, 2026-09-24 :source-language: python :icons: font :homepage: https://zipcodewilmington.com/pyprep -:pdf-page-size: [5.5in, 8.5in] +:pdf-page-size: [7.0in, 9.0in] :toc: [colophon] @@ -29,21 +29,21 @@ October 2026: Second Edition While the publisher and author have used good faith efforts to ensure that the information and instructions contained in this work are accurate, the publisher and author disclaim all responsibility for errors or omissions, including without limitation responsibility for damages resulting from the use of or reliance on this work. -Use of the information and instructions in this work is at your own risk. If any code samples or other information this work contains or describes is subject to open source licenses or the intellectual property rights of others, it is your responsibility to ensure that your use thereof complies with such licenses and/or rights. +Use of the information and instructions in this work is at your own risk. If any code samples or other information this work contains or describes is subject to open source licenses or the intellectual property rights of others, it is your responsibility to ensure that your use thereof complies with such licenses and/or rights. [preface] == Preface This book is a cousin of the same text for JavaScript. Many of the Java programmers we've trained at ZipCodeWilmington look at Python as a possible second 'main' language, one that'd be good to pick up and have on the resume. I'd agree. Python has been good to me, as I first learned it when I got back into coding about 2007, I've written a *lot* of python, and consider it an old friend. -I especially wish to thank Mikaila Akeredolu: without his brilliant javascript prep session slides as the starting point for the javascript version of this book, I would never have thought a small book on the basic fundamentals of programming would be possible or even useful. +I especially wish to thank Mikaila Akeredolu: without his brilliant javascript prep session slides as the starting point for the javascript version of this book, I would never have thought a small book on the basic fundamentals of programming would be possible or even useful. Zip Code Wilmington is a non-profit coding boot-camp in Delaware for people who wish to change their lives by becoming proficient at coding. Find out more about us at https://zipcodewilmington.com == About this book -This book's aim is to provide you with the most basic of fundamentals regarding Python, one of the most popular programming languages available. -It springs from the Javascript preparation sessions we often give prospective Zip Code applicants on how to do well on the Zip Code application coding assessment. -To someone who has spent some time with programming languages, this might be just a breezy intro to Python. +This book's aim is to provide you with the most basic of fundamentals regarding Python, one of the most popular programming languages available. +It springs from the Javascript preparation sessions we often give prospective Zip Code applicants on how to do well on the Zip Code application coding assessment. +To someone who has spent some time with programming languages, this might be just a breezy intro to Python. If you have almost any serious coding experience, this book is probably too elementary for you. You might, however, find the ideas in the Appendices interesting. There I've added some material that have a few advanced ideas in them, plus there is a full code listing of a Mars Lander simulation. @@ -60,45 +60,45 @@ Python also has the advantage that one can learn to use it without a lot of setu ==== Focuses on coding -Finally, because in this book all we aim to teach you is "programming in the small", Python is great for that. Many of the examples here are significantly less that 20 lines in length. We want you to get better at looking at small blocks of code to see how they work. These smaller examples and concepts are a core building block as you become proficient in coding. +Finally, because in this book all we aim to teach you is "programming in the small", Python is great for that. Many of the examples here are significantly less that 20 lines in length. We want you to get better at looking at small blocks of code to see how they work. These smaller examples and concepts are a core building block as you become proficient in coding. ==== You'll learn it eventually -The truth is, in today's coding world, all of us eventually learn to do things with Python. (I've said this about JavaScript too.) +The truth is, in today's coding world, all of us eventually learn to do things with Python. (I've said this about JavaScript too.) And as of 2023, it's perhaps the world's most popular programming language. -So, start early, get comfortable with it, and then go on and study other computer languages like Java or JavaScript. -Python will always be there, waiting patiently for you to return. +So, start early, get comfortable with it, and then go on and study other computer languages like Java or JavaScript. +Python will always be there, waiting patiently for you to return. And hey, if you've already learned Java, you might find this book helpful - bridging languages is a great skill for a developer to have. -=== Coding _The Hard Way_. +=== Coding _The Hard Way_. Zed A. Shaw is a popular author of several books where he describes learning a programming language _The Hard Way_. Zed suggests, and we at Zip Code agree with him whole-heartedly, that the best, most impactful, highest return for your investment when learning to code, is *type the code using your own fingers* footnote:[check out his terrific work: https://learncodethehardway.org] That's right. Whether you are a "visual learner", a "video learner", or someone who can read textbooks like novels (are there any more of these out there?), the best way to learn to code is *to code* and *to code by typing out the code with your own fingers*. This means you DO NOT do a lot of copy and paste of code blocks; you really put in the work, making your brain better wired to code by *coding with your own typing of the code.* -You're here, reading this, because you're thinking (or maybe you know) that you want to become a coder. It's pretty straight-forward. +You're here, reading this, because you're thinking (or maybe you know) that you want to become a programmer. It's pretty straight-forward. You may have heard a friend wistfully dream of making a career at writing. "Oh," they say, "I wish I had time to write a great novel, I want to be a writer someday". -So you can ask them: Did you write _today_? _How many words?_ +So you can ask them: Did you write _today_? _How many words?_ And the excuses flow: "Oh, I have to pick up the kids" "Ran out of time, I'm so busy at work." "I had to cut the grass" and so on. Well, I'm here to tell you that all the excuses in the world don't stop a real writer from writing. They just sit down and do it. As often as they can, sometimes even when they can't (or shouldn't). -Coding, like writing, isn't something you can do when all your other chores, obligations, and entertainments are done. If you're serious about learning coding, you must make time for coding. +Coding, like writing, isn't something you can do when all your other chores, obligations, and entertainments are done. If you're serious about learning coding, you must make time for coding. -Watching hours of YouTube videos _will not_ make you a coder. +Watching hours of YouTube videos _will not_ make you a programmer. -Reading dozens of blog posts, Medium articles, and books _will not_ make you a coder. +Reading dozens of blog posts, Medium articles, and books _will not_ make you a programmer. -Following along with endless step-by-step tutorials _will not_ make you a coder. +Following along with endless step-by-step tutorials _will not_ make you a programmer. -The only way you're going to learn to code is by doing it. Trying to solve a problem. Making mistakes, fixing them, learning from what worked and what didn't at the keyboard. +The only way you're going to learn to code is by doing it. Trying to solve a problem. Making mistakes, fixing them, learning from what worked and what didn't at the keyboard. -Many have heard my often-repeated admonition: *If you coded today, you're a coder. If not, you're not a coder.* It really is as simple as that. +Many have heard my often-repeated admonition: *If you coded today, you're a programmer. If not, you're not a programmer.* It really is as simple as that. === Dedication to the mission -I happen to be among those who feel anyone can learn to code. It's a 21st century superpower. When you code, you can change the world. Being proficient at coding can be a life-changing skill that impacts your life, your family's life and your future forever. +I happen to be among those who feel anyone can learn to code. It's a 21st century superpower. When you code, you can change the world. Being proficient at coding can be a life-changing skill that impacts your life, your family's life and your future forever. Time and time again, I've seen that the ability to learn to code is evenly distributed across the population, but the _opportunity to learn to code is not_. So, we run Zip Code to give people a shot at learning a 21st century superpower, no matter where you come from. And fortune favors the prepared. Some day, you may be working at a great company, making a decent living, working with professionals in a great technical job. Your friends may say "You are so lucky!" @@ -107,16 +107,16 @@ And you will think: *Nope. It wasn't luck.* You'll know that truly. You got ther As many know, getting a spot in a Zip Code cohort is a hard thing to do. Many try but only a few manage it. I often get asked "what can I do to prepare to get into Zip Code?" -The best way is to start solving coding problems on sites like https://hackerrank.com - HackerRank (among others) has many programming assignments, from extremely simple to very advanced. You login, and just do exercise after exercise, relieving you of one of the hardest of coding frustrations, that of trying to figure out *what* to code. Solving programming assignments is a good way to start to cultivate a coding mindset. Such a mindset is based on your ability to pay very close attention to detail, a desire to continually learn, and being able to stay focused on problem solving even if it takes a lot of grit and dedication. +The best way is to start solving coding problems on sites like https://hackerrank.com - HackerRank (among others) has many programming assignments, from extremely simple to very advanced. You login, and just do exercise after exercise, relieving you of one of the hardest of coding frustrations, that of trying to figure out *what* to code. Solving programming assignments is a good way to start to cultivate a coding mindset. Such a mindset is based on your ability to pay very close attention to detail, a desire to continually learn, and being able to stay focused on problem solving even if it takes a lot of grit and dedication. Spending even 20 minutes a day, making progress on a programming task can make all the difference. Day after day your skills will grow, and before long you'll look back on the early things you did and be astonished as to how simple the assignments were. You may even experience embarrassment at remembering how hard these simple exercises seemed at the time you did them. (It's okay, we've all felt it. It's part of the gig.) -Working on code every day makes you a coder. And coding everyday will help with your ability to eventually score high enough on the Zip Code admissions assessment that you get asked to group and potentially final interviews. And then, well, then you get to learn Java or Python and work yourself to exhaustion doing so. Lots and lots more hours. +Working on code every day makes you a programmer. And coding everyday will help with your ability to eventually score high enough on the Zip Code admissions assessment that you get asked to group and potentially final interviews. And then, well, then you get to learn Java or Python and work yourself to exhaustion doing so. Lots and lots more hours. -Why? +Why? -You do that hard work, you put in those hours, you create lots of great code, -you'll make your own luck, and someone will be impressed and they will offer you a job. +You do that hard work, you put in those hours, you create lots of great code, +you'll make your own luck, and someone will be impressed and they will offer you a job. And that is the point, right? A job, doing what you love, coding. Right? RIGHT? You're Welcome, @@ -125,7 +125,7 @@ _-Kristofer_ Ready? -Okay, let's go. +Okay, let's go. :sectnums: @@ -176,10 +176,24 @@ include::sets.adoc[] include::tuples.adoc[] +include::builtins.adoc[] + +include::lambdas.adoc[] + +include::builtinsadvanced.adoc[] + +include::listcomprehension.adoc[] + +include::dictcomprehension.adoc[] + +include::setcomprehension.adoc[] + include::modules.adoc[] include::objectsmethods.adoc[] +include::dundermethods.adoc[] + include::appendixa.adoc[] include::appendixb.adoc[] @@ -196,4 +210,3 @@ Some Python sites for you to explore: If you're looking for more of a professional code tool, use an IDE like vscode: https://code.visualstudio.com (Many people use this these days.) It has all sorts of tools to help you create Python programs. - diff --git a/lambdas.adoc b/lambdas.adoc new file mode 100644 index 0000000..dde1d04 --- /dev/null +++ b/lambdas.adoc @@ -0,0 +1,122 @@ + + +== Lambdas + +Back in the Functions chapter, you got a quick glimpse of something called a *lambda*. Let's slow down and really look at it, because you're about to see lambdas everywhere, especially in the next chapter. + +=== What Is a Lambda? + +A lambda is just a *function without a name*. That's really it. It's a small, one-line function you can write right where you need it, without going through the whole `def` ceremony. + +[source] +---- +double = lambda x: x * 2 + +print(double(5)) # -> 10 +---- + +Compare that to writing it the regular way: + +[source] +---- +def double(x): + return x * 2 + +print(double(5)) # -> 10 +---- + +Same result. The lambda version is just shorter - one line instead of two, no `def`, no `return`. Python quietly adds the `return` for you; whatever the expression evaluates to is automatically handed back. + +=== The Lambda Recipe + +Every lambda follows the same simple pattern: + +[source] +---- +lambda parameters: expression +---- + +* `lambda` - the keyword that says "I'm making a tiny function" +* `parameters` - whatever inputs it needs, just like a normal function (zero, one, or several) +* `expression` - one single calculation, whose result gets returned automatically + +[source] +---- +add2 = lambda p1, p2: p1 + p2 +print(add2(5, 7)) # -> 12 + +shout = lambda word: word.upper() + "!" +print(shout("watch out")) # -> WATCH OUT! + +always_true = lambda: True +print(always_true()) # -> True +---- + +Notice there's no name for the function itself in the `lambda` line - that's the "anonymous" part. We only gave it a name (`add2`, `shout`) by assigning it to a variable, the same way we'd name any other value. + +=== Why Bother? + +Fair question. If `def` already works, why does Python give you a second way to write functions? + +The honest answer: *lambdas exist for quick, throwaway functions you only need for a moment*, usually because some other function needs a little function handed to it as an argument. Writing out a whole `def`, giving it a name you'll never reuse, just to use it once, is a lot of ceremony for a one-off job. + +Think about `sorted()`, which you met in the Built-in Functions chapter. By default it sorts numbers and strings in their normal order. But what if we want to sort a list of players by their health score, where each player is a dictionary? + +[source] +---- +players = [ + {"name": "Sam", "health": 42}, + {"name": "Jade", "health": 100}, + {"name": "Sadie", "health": 87}, +] + +ranked = sorted(players, key=lambda player: player["health"]) + +for p in ranked: + print(p["name"], p["health"]) + +# output is +# Sam 42 +# Sadie 87 +# Jade 100 +---- + +That `key=lambda player: player["health"]` is telling `sorted()` exactly *what to look at* on each player when deciding the order. We needed a tiny function just for this one call - we're never going to reuse "look up a player's health" anywhere else in the program. A lambda lets us hand that logic straight to `sorted()` without ever giving it a name. + +=== The Catch + +Lambdas are deliberately limited, and that's on purpose: + +* A lambda can only hold *one expression* - no `if` statements with multiple lines, no loops, no several lines of logic. +* A lambda always returns the result of that one expression - you never write the word `return` yourself. +* If what you're trying to do needs more than a single simple calculation, that's Python's way of telling you: *just write a regular function with `def` instead.* + +[source] +---- +# fine for a lambda - one simple expression +square = lambda x: x * x + +# too much for a lambda - write a real function instead +def grade_test(score): + if score >= 90: + return "A" + elif score >= 80: + return "B" + else: + return "C" +---- + +Trying to cram the `grade_test` logic into a lambda would just make your code harder to read, which defeats the entire purpose of using one. + +[TIP] +==== +* Write a lambda called `is_even` that takes a number and returns `True` if it's even +* Try it with a couple of numbers, printing the result each time +* Now write the same thing as a regular `def` function, and compare how each one reads +==== + +=== A Quick Rule of Thumb + +Use a `def` function when you're naming something you'll call again, or when the logic takes more than one line to express. Reach for a `lambda` when you need a tiny, use-once function, usually as an argument being passed straight into something else, like `sorted()`. + +Keep that rule of thumb in mind, because in the next chapter, you're going to see lambdas paired constantly with two more built-in functions: `map()` and `filter()`. diff --git a/listcomprehension.adoc b/listcomprehension.adoc new file mode 100644 index 0000000..862d5a5 --- /dev/null +++ b/listcomprehension.adoc @@ -0,0 +1,111 @@ + + +== List Comprehensions + +Remember `map()` and `filter()` from the last chapter? They're powerful, but let's be honest - wrapping everything in `list(map(...))` and `list(filter(...))` gets a little wordy. Python has a shorter, more popular way to do the exact same jobs, called a *list comprehension*. + +=== Building a List the Old Way + +Let's go back to our dungeon game. We want to double every player's health score, the same problem we solved with `map()` last chapter. + +[source] +---- +player_health_scores = [100, 87, 42] + +boosted_scores = [] +for score in player_health_scores: + boosted_scores.append(score + 10) + +print(boosted_scores) # -> [110, 97, 52] +---- + +Four lines just to build a new list. Nothing wrong with it, but Python programmers found themselves typing this same shape - "make an empty list, loop over something, append a transformed value" - so often that they built a shortcut right into the language. + +=== The List Comprehension Way + +Here's the exact same result, in one line: + +[source] +---- +player_health_scores = [100, 87, 42] + +boosted_scores = [score + 10 for score in player_health_scores] + +print(boosted_scores) # -> [110, 97, 52] +---- + +That's a *list comprehension*. It follows this pattern: + +[source] +---- +[expression for item in iterable] +---- + +* `expression` - what you want to happen to each item, before it lands in the new list +* `item` - the name you're giving each thing as you pull it out, one at a time +* `iterable` - the list (or string, or range, or anything else you can loop over) you're pulling items from + +Read it out loud almost like English: "give me `score + 10`, *for* each `score` *in* `player_health_scores`." That's really all a list comprehension is - a `for` loop and an `append()`, squeezed into a single line, wrapped in square brackets. + +=== Filtering, Too + +Comprehensions can also do what `filter()` does - keep only the items that pass a test - by tacking an `if` onto the end. + +[source] +---- +player_health_scores = [100, 87, 0, 42, 0] + +survivors = [score for score in player_health_scores if score > 0] + +print(survivors) # -> [100, 87, 42] +---- + +The pattern grows just slightly: + +[source] +---- +[expression for item in iterable if condition] +---- + +Only items where `condition` comes out `True` get run through `expression` and added to the new list. Everything else gets skipped entirely. + +Here's one more, using our donut flavors: + +[source] +---- +donut_flavors = ["chocolate", "glazed", "jelly", "chocolate glaze"] + +chocolatey_ones = [flavor for flavor in donut_flavors if "chocolate" in flavor] + +print(chocolatey_ones) # -> ['chocolate', 'chocolate glaze'] +---- + +Compare that to the `filter()` version from the last chapter - same result, but no `lambda`, no `list()` wrapper needed. + +=== Combining Transform and Filter + +You can do both at once - transform *and* filter - in the very same comprehension. + +[source] +---- +player_health_scores = [100, 87, 0, 42, 0] + +boosted_survivors = [score + 5 for score in player_health_scores if score > 0] + +print(boosted_survivors) # -> [105, 92, 47] +---- + +Notice the order: the `if` at the end decides *who gets in*, and the expression at the front decides *what happens to them* once they're in. Zeros never even make it to the `+ 5` part. + +[TIP] +==== +* Start with a list of five donut prices +* Build a new list, using a comprehension, that adds 6% sales tax to each price +* Now build a second comprehension that only keeps the donuts priced under $2.00 (before tax) +==== + +=== map()/filter() or a Comprehension? + +Both do the same job. Most Python programmers reach for a list comprehension first, since it tends to read more clearly, especially once you're used to the pattern. `map()` and `filter()` aren't wrong, and you'll still see them out in the wild - now you'll recognize both styles when you run into them. + +Lists aren't the only thing you can build this way. Next up, we'll use this exact same idea to build dictionaries. diff --git a/lists.adoc b/lists.adoc index a87bddc..f5fbfcd 100644 --- a/lists.adoc +++ b/lists.adoc @@ -8,7 +8,7 @@ Let's start with *why* we need them. Imagine you have a small number of things you want to track. Let's use our vague computer game we've been using for an example. The game has 5 players, friends that get together over the internet to play a dungeon game. -Now, if you're the coder of this game you could keep track of each player's health_score by have 5 different variables. (for players Zero to Four) +Now, if you're the programmer of this game you could keep track of each player's health_score by have 5 different variables. (for players Zero to Four) [source] ---- @@ -60,7 +60,7 @@ Lists: * Can store multiple values in a single variable * Start counting from index position zero -* Elements can be primitive data types or/and Objects +* Elements can be builtin data types or/and Objects So let's think about an list of donuts for the following examples. diff --git a/modules.adoc b/modules.adoc index e665af8..2ae4d5b 100644 --- a/modules.adoc +++ b/modules.adoc @@ -1,39 +1,108 @@ + == Modules -In Python, modules allow for code to loaded into a program only if it is needed. Modules are one of the advanced topics in Python that we won't spend too much time on, but here are the basics. +Every code example so far in this book has lived in one single file, or one single REPL session. That's fine while you're learning, but real programs grow. Once a program gets big enough, you don't want every function and variable crammed into one giant file - you want to split things up, and *reuse* code you already wrote instead of retyping it into every new program. + +That's exactly the problem *modules* solve. + +=== What Is a Module? + +Here's the good news: you've already been creating modules this whole time, without realizing it. *Any Python file you write is automatically a module.* If you save some code in a file named `greetings.py`, you now have a module named `greetings`, and any other Python file can borrow the things defined inside it. + +Let's make that real with two files. + +[source] +---- +def greet_user(username): + return "Hello, " + username + "!" +---- +_greetings.py_ + +That's our module - just a plain `.py` file with one function in it, sitting in the same folder as the program we're about to write. + +=== Importing a Module + +The first, most basic way to use another file's code is the plain `import` statement. + +[source] +---- +import greetings + +message = greetings.greet_user("Mike Jones") +print(message) # -> Hello, Mike Jones! +---- +_main.py_ + +Notice the pattern: `import greetings` loads up the whole `greetings.py` file, and then we reach *into* it using a dot, `greetings.greet_user(...)`, the same way we've been reaching into objects and their methods. This is a genuinely good habit to get into, because it's always crystal clear, just by reading the code, exactly *where* `greet_user` came from - it's right there in the name, `greetings.greet_user`. + +=== Importing Just What You Need + +Sometimes you don't want to type the module name every single time, especially if you're going to use a function over and over. That's what `from ... import ...` is for. + +[source] +---- +from greetings import greet_user + +message = greet_user("Mike Jones") +print(message) # -> Hello, Mike Jones! +---- +_main.py_ + +This time, we pulled `greet_user` directly into `main.py`, so we can call it plain, with no `greetings.` in front. Shorter to type, and often reads a little cleaner. + +You can even import several names from the same module this way, separated by commas. + +[source] +---- +from greetings import greet_user, greet_admin +---- + +NOTE: There's also a *from greetings import ** form, which grabs *everything* out of a module at once. It's tempting, but most Python programmers avoid it - once you've done that a few times from a few different modules, it gets hard to tell, just by looking at your code, which module any given function actually came from. -If you quit from the Python interpreter and enter it again, the definitions you have made (functions and variables) are lost. -Therefore, if you want to write a somewhat longer program, you are better off using a text editor to prepare the input for the interpreter and running it with that file as input instead. -This is known as creating a script. -As your program gets longer, you may want to split it into several files for easier maintenance. -You may also want to use a handy function that you’ve written in several programs without copying its definition into each program. +=== Which Style Should You Use? -To support this, Python has a way to put definitions in a file and use them in a script or in an interactive instance of the interpreter. -Such a file is called a module; definitions from a module can be imported into other modules or into the main module (the collection of variables that you have access to in a script executed at the top level and in calculator mode). +Neither style is "wrong" - it's mostly a judgment call. -A module is a file containing Python definitions and statements. -The file name is the module name with the suffix .py appended. -Within a module, the module’s name (as a string) is available as the value of the global variable __name__. +* Use `import module_name` when you're using a few different things from that module, or when you like being able to see exactly where a function came from at a glance. +* Use `from module_name import name` when you only need one or two things from a module and you'll be using them a lot, and typing the module name every time would get repetitive. -Most of your Python programs are fairly small when you are creating solutions to HackerRank type problems. +Just be a little careful with the second style: if you `from` import a function named `greet_user` from _two different_ modules, the second import silently replaces the first one. `import module_name` never has that problem, since everything stays safely namespaced behind the module's name. + +=== Modules from Python's Standard Library + +Modules aren't just for files you write yourself. Python ships with a huge collection of modules already built in, ready for you to `import` - this is called the *standard library*. You've likely already seen the `math` module mentioned in passing; it works exactly the same way as our homemade `greetings` module. + +[source] +---- +import math + +print(math.sqrt(64)) # -> 8.0 +print(math.pi) # -> 3.141592653589793 +---- + +Or, using the second style: [source] ---- -print("Hello, World!"); +from math import sqrt, pi + +print(sqrt(64)) # -> 8.0 +print(pi) # -> 3.141592653589793 ---- -_helloworld.py_ -If your program is much larger, it might be split into different files to keep it all more organized or readable. -All those files might be kept in a folder all together, as a project. -But again, this is beyond what you need to know to do HackerRank Python problems. +Same functions, same values - just a different way of reaching for them. + +[TIP] +==== +* Create a file named `mathhelpers.py` with a function `double(number)` that returns `number * 2` +* In a second file, `import mathhelpers` and call `mathhelpers.double(21)` +* Now rewrite that second file using `from mathhelpers import double` instead, and call `double(21)` directly +* Notice both versions print the same answer, just written a little differently +==== -Modules are also used to import code others have written that you wish to take advantage of. -You've seen examples of this when we've used "import math" to get access to function definitions within the math module. -There are millions of chunks of Python you can find and use in your code. -A lot of it is used by many, many people, and it's important to know where the code you use comes from. -It can be dangerous to use someone else's code that isn't trustworthy. +=== A Word of Caution -See https://docs.python.org/3/tutorial/modules.html for more on modules! -Look for information on "import" to see how modules interact with your code. +Modules also let you import code that *other* people have written - there are millions of these floating around for Python, doing everything imaginable. That's an enormous amount of free help. But it also means it's important to know where the code you're importing actually comes from. Not everything you find is trustworthy, and importing someone else's module means running their code, right alongside yours. Stick to well-known, widely-used packages, especially while you're still learning to tell the difference yourself. +See https://docs.python.org/3/tutorial/modules.html for a deeper dive into everything modules can do. diff --git a/objectsmethods.adoc b/objectsmethods.adoc index 2dd1d5c..2e93923 100644 --- a/objectsmethods.adoc +++ b/objectsmethods.adoc @@ -1,16 +1,23 @@ -== Objects +== Objects/Instances -There are only a few data types in Python. All but one of them are called “primitive” data types, because their values contain only a single thing (be it a string or a number or whatever). +There are a series if key data types pre-defined (builtin) to Python. The key primaries: "int", "float", "str", "bool", "None". +And there are the "sequence" types: "list", "tuple", "range". +Several can also be thought of as "container" types: "list", "tuple","dict", "set", "frozenset". -Python is an object oriented programming language. -Almost everything in Python is an object, with its properties and methods. -A Class is like an object constructor, or a "blueprint" for creating objects. +All of these are actually Classes in Python. +They are all built-in classes, and are available to use without any special syntax. -So you write "classes", and then when you run the code, Python then creates the objects to be used by the code. +Moreover, Python is an object oriented programming language. +Everything in Python is an object, with its properties/attributes and methods. +A Class is an object constructor, or a "blueprint" for creating objects. -Objects are used to collect and organize data - and that data can be variable values, functions and other things. -Objects can also contain other objects(!), in kind of a "nesting" way. +So you write "classes", and then when you run the code, Python then creates the objects/instances to be used by the code. + +NOTE: You'll see both words used - *object* and *instance* - and they mean the same thing. When you create an object from a class, programmers usually say you've "created an instance of that class." So "object" and "instance" are really just two names for the same idea, and you'll see both used throughout this book (and in Python's own error messages). + +Objects are used to collect and organize data - and that data can be variable values, functions and other things. +Objects can also contain other objects(!), in kind of a "nesting" way. This allows for large data structures to be built using a very simple and elegant mechanism. @@ -19,14 +26,14 @@ This allows for large data structures to be built using a very simple and elegan class Spacecraft: name = "" type = 'warp starship' - topspeed = 9.9 + topspeed = 9.9 ---- === Object Creation -We can imagine an object as a container where everything is collected about some thing in the program: +We can imagine an object - an instance of a class - as a container where everything is collected about some thing in the program: [source] ---- @@ -41,14 +48,16 @@ Which isn't very helpful, is it? We need to create a _method_ in our class. One [source] ---- class Spacecraft: - name = "" - type = 'warp starship' - topspeed = 9.9 - + def __init__(self): + self.name = "" + self.type = 'warp starship' + self.topspeed = 9.9 + self.current_speed = 0 + def __str__(self): return "Starship " + self.name - def speed(self): + def tp_speed(self): return self.topspeed enterprise = Spacecraft() @@ -59,7 +68,9 @@ print(enterprise) # we get: Starship Enterprise ---- -There a few things to point out in this class. First, notice how the __str__ function is indented? It's defined _inside_ the class. That makes the function a _method_; objects have methods. You can call a method on a particular object. +There a few things to point out in this class. First, notice how the functions are indented? Those functions are defined _inside_ the class. That makes the function a _method_; objects have methods. You can call a method on a particular object. + +Also notice that first parameter, `self`, on every method. `self` is how a method knows *which instance* it's being called on - when you call `enterprise.tp_speed()`, Python quietly hands `tp_speed` the `enterprise` instance as `self`, so `self.topspeed` reaches into that specific instance's data, not some other spacecraft's. [source] ---- @@ -77,14 +88,4 @@ cts = constellation.speed() # ets will be 9.9, cts will be 9.2 ---- -This example also shows how you use a class to create multiple objects. It helps with making code simpler, and easier to follow when reading it. - -=== Follow Ons - -There are a number of very powerful things we have left out of this discussion about Python objects. -We have not covered the ideas of *inheritance* or the idea of *subclassing*. -And there is much more in Python about objects. -Master what we've written about here and then forge ahead into more complicated and powerful capabilities. - -There is a lot more to learn about Python. - +This example also shows how you use a class to create multiple objects. `enterprise` and `constellation` are two separate *instances* of `Spacecraft` - each one built from the very same blueprint, but each holding its own, independent set of values. Changing `constellation.topspeed` had no effect at all on `enterprise`. Using a class this way helps with making code simpler, and easier to follow when reading it. diff --git a/operators.adoc b/operators.adoc index d40a937..96e341a 100644 --- a/operators.adoc +++ b/operators.adoc @@ -61,10 +61,12 @@ print(L2) # -> 3 print(L3) # -> 10 ---- -=== Division and Remainder +=== Division(s) and Remainder -We know that we can do regular division. If have a simple program like this, we know -what to expect: +There are *two* types of division in Python: regular division and floor division. Plus, there is the remainder operator. + +We know that we can do regular division. +If we have a simple program like this, we know what to expect: ---- a = 6 / 3 # -> 2.0 @@ -73,9 +75,12 @@ a = 15 / 3 # -> 5.0 a = 10 / 4 # -> 2.5 ---- +Division always returns a floating-point number. It never returns an integer. + === Floor Division -Floor division is the same as regular division, but it rounds down to the nearest integer. +Floor division is the same as regular division, but it rounds down to the nearest integer. It always returns an integer. *Always*. + It is sometimes called Integer Division. ---- @@ -270,5 +275,5 @@ print(square_root_two) And notice, when we raise a number to the _0.5_ power, it's *the same as taking its square root!*. And that can be handy sometimes. -You'll learn a lot more about working with numbers in your career as a coder. +You'll learn a lot more about working with numbers in your career as a programmer. This is really just the very basics of the very beginnings. diff --git a/patterns.adoc b/patterns.adoc index 39023c0..5f10bfe 100644 --- a/patterns.adoc +++ b/patterns.adoc @@ -1,7 +1,7 @@ == Code Patterns -Any experienced coder would say that the ability to see patterns in code, remember them, and learn from them when creating code is another kind of 'superpower'. +Any experienced programmer would say that the ability to see patterns in code, remember them, and learn from them when creating code is another kind of 'superpower'. The following samples are really simple techniques, but they show some common ways of doing things that you should think about and study. In almost all these examples, there may be some missing variable declarations. Just roll with it. @@ -110,7 +110,7 @@ for i in range(1, n): === List Patterns -Lists are often something that confuses beginning coders. Let's look at some code patterns with lists that you see how lists and loops can work together to get a lot of work pretty easily. +Lists are often something that confuses beginning programmers. Let's look at some code patterns with lists that you see how lists and loops can work together to get a lot of work pretty easily. The list we are going to use in all these cases is pretty simple. It's a list of 7 numbers. diff --git a/setcomprehension.adoc b/setcomprehension.adoc new file mode 100644 index 0000000..c7227d4 --- /dev/null +++ b/setcomprehension.adoc @@ -0,0 +1,86 @@ + + +== Set Comprehensions + +We've built lists and dictionaries with comprehensions. Let's round out the trio with the *set comprehension* - and by now, the pattern should feel very familiar. + +=== Building a Set the Old Way + +Back in the Sets chapter, we cleaned up a list of duplicate weapon picks using `set()`. + +[source] +---- +weapons_picked = ["sword", "bow", "sword", "axe", "bow"] + +unique_weapons = set(weapons_picked) + +print(unique_weapons) # -> {'sword', 'bow', 'axe'} +---- + +That works great when you just want the unique items, unchanged. But what if you want to *transform* each item on the way in, the same way we did with list and dictionary comprehensions? + +=== The Set Comprehension Way + +[source] +---- +donut_flavors = ["Chocolate", "GLAZED", "jelly", "chocolate"] + +lowercase_flavors = {flavor.lower() for flavor in donut_flavors} + +print(lowercase_flavors) +# output is +# {'chocolate', 'glazed', 'jelly'} +---- + +Look closely at what happened. We had four flavors, two of them really the same flavor just typed with different capitalization. By lowercasing each one *and* dropping it into a set, we ended up with exactly three truly unique flavors. A plain `for` loop building a list wouldn't have caught that duplicate on its own - the set part is doing real work here. + +The pattern looks just like a list comprehension, but wrapped in curly braces `{}` with a single expression, no colon: + +[source] +---- +{expression for item in iterable} +---- + +That curly-brace syntax is shared with dictionary comprehensions, so how does Python know which one you mean? It comes down to whether you write one expression (a set) or two, separated by a colon (a dictionary). + +[source] +---- +{x for x in range(5)} # a set: {0, 1, 2, 3, 4} +{x: x * x for x in range(5)} # a dict: {0: 0, 1: 1, 2: 4, 3: 9, 4: 16} +---- + +=== Filtering Into a Set + +Just like the other two comprehensions, you can add an `if` to only keep certain items. + +[source] +---- +player_health_scores = [100, 87, 0, 42, 0, 87] + +unique_survivor_scores = {score for score in player_health_scores if score > 0} + +print(unique_survivor_scores) # -> {100, 87, 42} +---- + +Notice the `87` only shows up once in the result, even though it appeared twice in the original list. That's the set doing what sets do best - guaranteeing uniqueness, automatically, even while you're transforming and filtering at the same time. + +[TIP] +==== +* Start with a list of donut flavor names, with a few duplicates typed in different cases (like "Jelly" and "jelly") +* Use a set comprehension to build a set of the unique flavors, all lowercased +* Now add an `if` so only flavors longer than 5 letters make it into the set +==== + +=== Three Comprehensions, One Idea + +You've now seen the same core idea three times over: + +[cols=",,",options="header",] +|=== +|Comprehension |Brackets |Produces +|List |`[ ]` |An ordered collection, duplicates allowed +|Dictionary |`{ }` with a `key: value` |Key:value pairs, unique keys +|Set |`{ }` with one expression |Unique values, no particular order +|=== + +Once "expression, for, in, and maybe an if" clicks for one of them, it clicks for all three. That's the real payoff here - you're not learning three separate tricks, you're learning one very reusable way of thinking about building a new collection from an old one. diff --git a/strings.adoc b/strings.adoc index e339fb1..ad7b37a 100644 --- a/strings.adoc +++ b/strings.adoc @@ -241,5 +241,5 @@ rev = res[::-1] # -> POTS print(rev) # -> POTS ---- -Strings are perhaps the most important data type in almost any language. Being able to manipulate them easily and do powerful things with them in Python, makes you a better coder. +Strings are perhaps the most important data type in almost any language. Being able to manipulate them easily and do powerful things with them in Python, makes you a better programmer. diff --git a/variables.adoc b/variables.adoc index 2547cbf..44ad0f3 100644 --- a/variables.adoc +++ b/variables.adoc @@ -63,7 +63,7 @@ cats = 3 print(cats) # -> 3 dogs = 1 -print(cats) # -> 1 +print(dogs) # -> 1 player1alive = true carspeed = 55.6 @@ -152,12 +152,12 @@ Python can keep track of a number of different kinds of data, and these are know as "data types". Here are a few of them. * *Numeric* - there are two kinds of numbers: integers, floats and complex -** *Whole Numbers* -*int* are like 0, -4, 5, 6, 1234 +** *Whole Numbers* - *int* are like 0, -4, 5, 6, 1234 ** *Decimal Numbers* - *float* are numbers where the decimals matter like 0.005, 1.7, 3.14159, -1600300.4329 -** *Complex* are, well, if you don't already know, let's ignore them. +** *Complex* are, well, if you don't already know, let's ignore them. _But, I should make a joke about how there are two kinds of number and then then show three kinds, and mumble something about an 'off-by-one' bug._ * *Strings* - *str* - a _string_ of characters - -** like 'text' or "Hello, World!" -* *Boolean* - is either *True* or *False* +** like 'text' or "Hello, World!" or 'Wow, I really like Python!' +* *Boolean* - *bool* - is either *True* or *False* ** often used to decide things like is_player(1).alive() [True or False?] * *None* - no value at all (nil or null in other languages) @@ -180,7 +180,7 @@ print(type(s)) # -> [TIP] ==== -Create variables for each primitive data type: +Create variables for each builtin data type: - boolean, - float, @@ -212,5 +212,6 @@ a normal value to it. === Data Structures -Python has a series of different _data structures_ built into the language. -Its built-in data structures include lists, tuples, sets, and dictionaries. +Python has a series of different _data structures_ built into the language. These are also referred to as _collections_. +Its built-in data structures include *lists*, *tuples*, *sets*, and *dictionaries*. +We will cover each one in turn in later chapters. diff --git a/whileloop.adoc b/whileloop.adoc index 9286ef1..ba86d3c 100644 --- a/whileloop.adoc +++ b/whileloop.adoc @@ -1,18 +1,18 @@ == Loops -Loops allow you control over repetitive steps you need to do in your _control flow_. Python has two different kinds of loops we will talk about: *while* loops and *for* loops. +Loops allow you control over repetitive steps you need to do in your _control flow_. Python has two different kinds of loops we will talk about: *while* loops and *for* loops. Either one can be used interchangeably; but, as you will see there are couple cases where using one over the other makes more sense. -The primary purpose of loops is to avoid having lots of repetitive code. +The primary purpose of loops is to avoid having lots of repetition in code. === While Loop -Loop through a block of code (the body) WHILE a condition is true. +Loop through a block of code (the body) WHILE a condition is true. ---- while (condition_is_true): - # execute the code statements + # execute the code statements # in the loop body pass ---- @@ -34,7 +34,7 @@ print("ending at", x) # ? what will print here ? ---- While loops work well in situations where the condition you are testing at the top -of the loop is one that may not be related to a simple number. +of the loop is one that may not be related to a simple number. ---- while (player[1].is_alive() == True): @@ -42,8 +42,8 @@ while (player[1].is_alive() == True): game.update_status(player[1]) ---- -This will keep letting player[1] take a turn in the game until the player dies. Another way to do something like this is with an _infinite loop_. -(No, infinite loops are not necessarily a bad thing, watch.) +This will keep letting player[1] take a turn in the game until the player dies. Another way to do something like this is with an _infinite loop_. +(No, infinite loops are not necessarily a bad thing, watch.) We're going to use both *continue* and *break* in this example, and we will describe them better after we're done with loops. ---- @@ -64,4 +64,3 @@ game.say_to_human("Game Over!") ---- Here, we are using the continue statement to force the flow of control to the top of the loop if the player is still alive after the 'take turn' code. We are also using the break statement to break out of the infinite loop when the player dies, letting us do other things after the player has 'died'. - From 2a9d2a064bbc0dca28b93e34060e86b7631d6132 Mon Sep 17 00:00:00 2001 From: Kristofer Date: Fri, 25 Sep 2026 14:57:53 -0400 Subject: [PATCH 08/12] whole bunch of changes --- appendixc.adoc | 92 ++++++++++++++++++++++ appendixd.adoc | 170 +++++++++++++++++++++++++++++++++++++++ appendixe.adoc | 179 ++++++++++++++++++++++++++++++++++++++++++ booleanexpr.adoc | 2 +- builtinsadvanced.adoc | 2 +- dundermethods.adoc | 50 ++++++------ forloop.adoc | 8 ++ functionparams.adoc | 149 +++++++++++++++++++++++++++++++++++ generators.adoc | 137 ++++++++++++++++++++++++++++++++ index.adoc | 18 ++++- iterators.adoc | 105 +++++++++++++++++++++++++ objectsmethods.adoc | 10 ++- runvsimport.adoc | 108 +++++++++++++++++++++++++ strings.adoc | 2 +- tuples.adoc | 2 + typehints.adoc | 126 +++++++++++++++++++++++++++++ 16 files changed, 1128 insertions(+), 32 deletions(-) create mode 100644 appendixc.adoc create mode 100644 appendixd.adoc create mode 100644 appendixe.adoc create mode 100644 functionparams.adoc create mode 100644 generators.adoc create mode 100644 iterators.adoc create mode 100644 runvsimport.adoc create mode 100644 typehints.adoc diff --git a/appendixc.adoc b/appendixc.adoc new file mode 100644 index 0000000..2ace707 --- /dev/null +++ b/appendixc.adoc @@ -0,0 +1,92 @@ + + +[appendix] +== Virtual Environments and `-m venv` + +Throughout this book, we've mostly run small snippets in a REPL, or a single standalone file. But the moment you start writing real projects - and especially once you start installing packages other people have written - you'll run into a very common problem: different projects on the same computer often need *different versions* of the same package. Python's answer to keeping projects from tripping over each other is called a *virtual environment*. + +=== The Problem: One Shared, Global Python + +Normally, when you install a package (using a tool called `pip`, Python's package installer), it gets installed *globally* - shared by your entire computer, available to every Python program you run. That sounds convenient, until you have two different projects that each need a different version of the same package. Upgrade it for one project, and you might quietly break the other one. + +=== What Is a Virtual Environment? + +A virtual environment is a private, self-contained folder that holds its own separate copy of Python and its own separate collection of installed packages - completely walled off from your computer's main Python installation, and from every other project's virtual environment. + +Think of it like this: instead of every project reaching into one shared, communal toolbox (where someone might swap out a tool you were relying on), each project gets its *own* toolbox, set up exactly the way that project needs it. + +=== Creating One with `-m venv` + +The good news: you don't need to install anything extra to make one. Python already ships with the tool for this, called `venv`, built right in. From a terminal, inside your project's folder, run: + +[source,bash] +---- +python3 -m venv myenv +---- + +That `-m` flag tells `python3`: "don't run a file - run the built-in module named `venv` as a program instead." `myenv` is just the name you're giving this new virtual environment; you'll commonly see it named `venv` or `.venv` in real projects. + +After that command finishes, you'll notice a new folder has appeared, named `myenv`, sitting right there next to your code. + +=== Activating It + +Just creating the environment doesn't put you "inside" it yet - you have to *activate* it, and you'll need to do this again each time you open a fresh terminal window to work on that project. + +[source,bash] +---- +source myenv/bin/activate +---- + +NOTE: On Windows, the activation command looks a little different: `myenv\Scripts\activate`. + +Once it's activated, you'll usually see the environment's name show up right inside your terminal prompt, something like `(myenv) $`, letting you know, at a glance, that you're "inside" it. + +=== Installing Packages Inside It + +With the environment activated, anything you install with `pip install` gets installed *only* inside that environment - not system-wide, and not visible to any other project's environment. + +[source,bash] +---- +pip install requests +---- + +Now `requests` lives only inside `myenv`. A completely different project, with its own separate virtual environment, won't see it at all, unless you install it there too. + +=== Leaving the Environment + +When you're done working, one simple command returns you to your regular, system-wide Python. + +[source,bash] +---- +deactivate +---- + +=== Sharing a Project Without Sharing the Folder + +Here's an important habit: when you share your code with someone else, or move it to a new computer, you almost never copy the `myenv` folder itself along with it - it's often huge, and tied specifically to the machine it was created on. Instead, Python programmers list out *which* packages a project depends on in a plain text file, usually named `requirements.txt`. + +[source,bash] +---- +pip freeze > requirements.txt +---- + +That command writes out everything currently installed in your active virtual environment into `requirements.txt`. Then, anyone else working on the project - on their own computer - creates their own fresh virtual environment and installs everything from that same list: + +[source,bash] +---- +pip install -r requirements.txt +---- + +That way, everyone working on a project ends up with the exact same packages installed, without ever having to share the environment folder itself. + +[TIP] +==== +* In a terminal, `cd` into a new, empty folder +* Run `python3 -m venv venv` to create a virtual environment +* Activate it, and notice your terminal prompt change +* Run `pip install requests`, and notice it installs without needing any special permissions +* Run `pip freeze > requirements.txt` and take a look at what got written into that file +* Run `deactivate` when you're finished +==== + +Virtual environments might feel like unnecessary ceremony while you're working through small examples in this book. But the moment you start building real, multi-package projects - which won't be long now - you'll find that almost every professional Python project you ever touch uses one. It's one of those habits well worth building early. diff --git a/appendixd.adoc b/appendixd.adoc new file mode 100644 index 0000000..83a8d08 --- /dev/null +++ b/appendixd.adoc @@ -0,0 +1,170 @@ + + +[appendix] +== Four Essential Packages to Know + +Back in the venv appendix, we talked about `pip install`-ing packages other people have written. PyPI - the *Python Package Index* - hosts hundreds of thousands of these, but a small handful show up in an enormous share of real-world Python projects. Let's meet four of the most popular: `requests`, `pydantic`, `SQLAlchemy`, and `FastAPI`. + +We're not going to make you an expert in any of these - that's well beyond a beginner's book. The goal here is just *recognition*: when you see one of these names later in your coding life, you'll already know roughly what it does and why people reach for it. + +=== requests: Talking to the Web + +Almost every program eventually needs to fetch data from somewhere out on the internet - checking the weather, pulling stock prices, hitting some company's API. Python's built-in tools for this are clunky. `requests` makes it feel almost as simple as `print()`. + +[source,bash] +---- +pip install requests +---- + +[source] +---- +import requests + +response = requests.get("https://api.github.com") + +print(response.status_code) # -> 200, meaning "OK, success!" +print(response.json()) # -> a dictionary, parsed straight from the response +---- + +That `.get()` call reaches out over the internet and fetches whatever's at that address - the same basic thing your web browser does every time you visit a page, just done from your own code. `.status_code` tells you whether it worked (`200` means success; you'll also see `404` for "not found," and others), and `.json()` conveniently turns the response straight into a Python dictionary, ready to use. + +Sending data works about the same way, using `.post()` instead of `.get()`: + +[source] +---- +new_player = {"name": "Sam", "health": 100} + +response = requests.post("https://example.com/players", json=new_player) + +print(response.status_code) # -> 201, meaning "Created!" +---- + +If `requests` has one core lesson, it's this: your program isn't limited to the data sitting on your own computer. It can reach out and talk to almost anything on the web. + +=== pydantic: Data You Can Trust + +Remember type hints, from a few chapters back? We mentioned that Python doesn't actually *enforce* them - they're just polite suggestions. `pydantic` is a package built entirely around fixing that: it uses your type hints to *actually validate* data, at the moment your program receives it. + +[source,bash] +---- +pip install pydantic +---- + +You describe your data's shape once, as a class, using the same type hints you already know: + +[source] +---- +from pydantic import BaseModel + +class Player(BaseModel): + name: str + health: int = 100 + +sam = Player(name="Sam", health=87) +print(sam.health) # -> 87 +---- + +That looks a lot like the classes from the Objects chapter, except we didn't have to write our own `+++__init__+++`. `BaseModel`, the class we inherited from, builds one for us automatically, based entirely on the type hints we wrote. + +Here's the real payoff - what happens when the data is *wrong*: + +[source] +---- +bad_player = Player(name="Sam", health="a lot") +# pydantic.ValidationError: 1 validation error for Player +# health +# Input should be a valid integer +---- + +`pydantic` looked at our hint, `health: int`, and refused to accept the string `"a lot"` in its place. Instead of your program silently accepting bad data and crashing later, somewhere confusing, `pydantic` stops it immediately, right at the door, with a clear error explaining exactly what went wrong. + +=== SQLAlchemy: Talking to a Database + +Most real programs need to remember things even after they stop running - player accounts, orders, inventory. That's what a *database* is for. `SQLAlchemy` lets you work with a database using ordinary Python classes and objects, instead of writing raw database query language by hand. + +[source,bash] +---- +pip install sqlalchemy +---- + +[source] +---- +from sqlalchemy import create_engine, Column, Integer, String +from sqlalchemy.orm import declarative_base, Session + +Base = declarative_base() + +class Player(Base): + __tablename__ = "players" + id = Column(Integer, primary_key=True) + name = Column(String) + health = Column(Integer) + +engine = create_engine("sqlite:///game.db") +Base.metadata.create_all(engine) +---- + +NOTE: That `+++__tablename__+++` looks a lot like the dunder methods from a few chapters back, but it isn't one - it's not a method Python itself ever calls. It's just a special *attribute* name that `SQLAlchemy` itself looks for, as part of its own class-building machinery, to know what to name the table. Still handy to recognize the double-underscore naming pattern showing up again, in a different context. + +Once that `Player` class exists, we can save new players and look them back up, all with ordinary-looking Python: + +[source] +---- +with Session(engine) as session: + session.add(Player(name="Sam", health=100)) + session.commit() + + sam = session.query(Player).filter_by(name="Sam").first() + print(sam.health) # -> 100 +---- + +Notice we never wrote a single line of raw database query syntax. `SQLAlchemy` translated `session.query(Player).filter_by(name="Sam")` into the appropriate database query behind the scenes, and handed us back a real `Player` object - the very same kind of class we defined ourselves, complete with a `.health` attribute we can just read. + +=== FastAPI: Building Your Own Web API + +`requests` let us *call* someone else's web service. `FastAPI` flips that around - it's for *building your own*. It's one of the most popular ways to build a web API in Python today, largely because it leans so heavily on type hints and `pydantic`, both of which you already know. + +[source,bash] +---- +pip install fastapi uvicorn +---- + +NOTE: `uvicorn` is a second package you install alongside `FastAPI` - it's the actual program that runs your API and listens for incoming requests. `FastAPI` describes *what* your API does; `uvicorn` is what keeps it running. + +[source] +---- +from fastapi import FastAPI +from pydantic import BaseModel + +app = FastAPI() + +class Player(BaseModel): + name: str + health: int = 100 + +@app.get("/") +def read_root(): + return {"message": "Welcome to the dungeon API!"} + +@app.post("/players") +def create_player(player: Player): + return {"greeting": "Welcome, " + player.name + "!"} +---- +_main.py_ + +That `@app.get("/")` line is a *decorator* - something we haven't covered in this book, but you can read it simply as "run the function right below this when someone visits this address." The second one, `@app.post("/players")`, does the same thing for incoming data - and notice the parameter, `player: Player`. That type hint isn't just documentation here; `FastAPI` and `pydantic` team up to automatically validate every incoming request against our `Player` model, before our function even runs. + +You'd start this API from a terminal with: + +[source,bash] +---- +uvicorn main:app --reload +---- + +and `FastAPI` even generates interactive, browsable documentation for your API automatically, for free, just from your type hints - no extra work required. + +=== How These Four Fit Together + +Picture a simple game server. `FastAPI` handles incoming web requests; `pydantic` (working right alongside `FastAPI`) validates that the data in each request actually makes sense; `SQLAlchemy` saves and retrieves player data from a real database; and some *other* program, maybe even one you write yourself, uses `requests` to call your finished API from the outside, the exact same way it might call anyone else's. + +Four different jobs, four different packages - and every single one of them is built on ideas you already know: classes, type hints, dictionaries, and dunder-style naming conventions. That's really the whole point of a solid beginner's foundation: once you have it, even "advanced" packages like these turn out to be built from pieces you already recognize. diff --git a/appendixe.adoc b/appendixe.adoc new file mode 100644 index 0000000..8b8880b --- /dev/null +++ b/appendixe.adoc @@ -0,0 +1,179 @@ + + +[appendix] +== The Shell Pattern: Setup, Loop, Ending + +Here's something fun: a number-guessing game, a game of Hangman, and a little terminal calculator all have almost nothing in common - and yet, underneath, they're all built from the exact same skeleton. Once you learn to see that skeleton, you can build your own terminal programs just by filling in the blanks. Programmers sometimes call this the *shell* pattern, since everything else gets built inside this one reusable shape. + +=== The Three Phases + +Every simple terminal program breaks into three phases, in this exact order: + +[cols=",,",options="header",] +|=== +|Phase |Runs |Typical Jobs +|*Setup* |Once, before anything else happens |Create your variables, generate the secret, print a welcome message +|*Loop* |Repeatedly, until the program is done |Get input, check it, update the game's state, give feedback +|*Ending* |Once, after the loop breaks |Announce the result, reveal the answer, offer to go again +|=== + +That's really it. Setup happens once. The loop happens over and over. Ending happens once. Let's build a real one. + +=== A Worked Example: Too High / Too Low + +We'll build a classic: the computer picks a secret number between 1 and 100, and the player has 7 guesses to find it, with a hint of "too high" or "too low" after each try. + +==== Setup + +[source] +---- +import random + +# ---------- SETUP (runs once) ---------- +secret = random.randint(1, 100) +guesses_left = 7 +game_over = False +player_won = False + +print("Welcome to Too High / Too Low!") +print("I'm thinking of a number between 1 and 100. You have 7 guesses.") +---- + +Notice everything here happens *before* the player has done anything at all: we pick the secret number, set up our tracking variables, and print the instructions. None of this needs to happen again once the game is underway. + +==== Loop + +[source] +---- +# ---------- LOOP (runs until the game ends) ---------- +while not game_over: + guess = int(input("Your guess: ")) + guesses_left -= 1 + + if guess == secret: + player_won = True + elif guess < secret: + print("Too low!") + else: + print("Too high!") + + print(guesses_left, "guesses left.") + + if player_won or guesses_left == 0: + game_over = True +---- + +This is where the game actually lives. Every single time through the loop, we ask for a guess, check it against the secret, print a hint, and then ask one important question at the very bottom: *should we keep going?* That last `if` is the loop's exit check - it's the only thing standing between "keep playing" and "stop." Set `game_over` to `True`, and the `while not game_over:` condition at the top goes false, and the loop ends. + +==== Ending + +[source] +---- +# ---------- ENDING (runs once, after the loop stops) ---------- +if player_won: + print("You got it! The number was", secret) +else: + print("Out of guesses. The number was", secret) +---- + +Once the loop breaks, we never go back into it. We just look at what happened - did `player_won` end up `True` or not? - and print one final message. + +Put all three pieces together, one after another in a single file, and you have a complete, playable game. + +=== Playing Again, Without Repeating Yourself + +Most games ask "play again?" when they're done. The cleanest way to do that is to wrap your whole Setup/Loop/Ending shell inside a function, and then call that function from a *second*, outer loop. + +[source] +---- +def play_round(): + # ---------- SETUP ---------- + secret = random.randint(1, 100) + guesses_left = 7 + game_over = False + player_won = False + + print("Welcome to Too High / Too Low!") + print("I'm thinking of a number between 1 and 100. You have 7 guesses.") + + # ---------- LOOP ---------- + while not game_over: + guess = int(input("Your guess: ")) + guesses_left -= 1 + + if guess == secret: + player_won = True + elif guess < secret: + print("Too low!") + else: + print("Too high!") + + print(guesses_left, "guesses left.") + + if player_won or guesses_left == 0: + game_over = True + + # ---------- ENDING ---------- + if player_won: + print("You got it! The number was", secret) + else: + print("Out of guesses. The number was", secret) + + +playing = True +while playing: + play_round() + again = input("Play again? (y/n): ") + if again.lower() != "y": + playing = False + +print("Thanks for playing!") +---- + +NOTE: You might come across other versions of this pattern online that have the game's function call *itself* again to restart, instead of using an outer loop like we did. That trick is called *recursion* - a function calling itself - and it's a genuinely useful technique, but it's a bit further down the road than this book goes. The outer `while playing:` loop above gets you the exact same "play again" behavior, using only tools you already have. + +=== A Decision Guide: What Goes Where? + +Whenever you're not sure which of the three phases a piece of code belongs in, ask yourself these questions, in order: + +* *Does it happen exactly once, before the player does anything?* → Setup. +* *Does it need to happen again on every single turn?* → The loop's body. +* *Does it decide whether the loop should keep going, or stop?* → The loop's exit check. +* *Does it only make sense after the game is completely finished?* → Ending. + +If you can answer one of those confidently, you already know exactly where that code belongs. + +=== The Same Shell, Different Games + +Here's the real payoff: this shell isn't specific to number-guessing at all. Swap out what happens *inside* each phase, and the very same three-part shape builds an entirely different program. + +Take Hangman: + +* *Setup* - pick a secret word, set `lives = 6`, start an empty list of guessed letters, and display the word as a row of blanks. +* *Loop* - show the word's current progress, ask for a letter, reveal it if it's in the word (or subtract a life if it isn't), and check whether the player has run out of lives or guessed the whole word. +* *Ending* - announce a win or a loss, reveal the secret word, and ask to play again. + +Or think back to the calculator programs from the Simple Calculation Programs chapter. Turn one into an interactive, REPL-style calculator, and it fits this exact same shell too: + +* *Setup* - print a welcome banner, and set up an empty `history` list to remember past calculations. +* *Loop* - print a `calc>` prompt, read in an operation and some numbers, compute the result, add it to `history`, and print it - checking each time whether the player typed `"quit"`. +* *Ending* - print "Goodbye!" and maybe show the full history of everything that was calculated. + +Different game, different calculator, same three-part skeleton underneath. The player becomes the user; the guess becomes a math operation; the secret number becomes a computed result. The shape never changes. + +[TIP] +==== +* Pick either Hangman or the REPL calculator described above +* Sketch out, in plain English, what belongs in *your* Setup, Loop, and Ending +* Then write the actual code, one phase at a time, using the Too High / Too Low example above as your model +==== + +=== Key Takeaways + +* Every simple terminal program follows the same shape: *Setup → Loop → Ending* +* The loop is the heart of the program - it keeps running until some condition breaks it +* For any piece of code, ask: does this run *once* (Setup or Ending), or does it run *every turn* (the Loop)? +* This shell works for games *and* for tools - calculators, quizzes, unit converters, anything with a "keep going until the user is done" feel to it +* Naming your boolean variables clearly - `game_over`, `player_won` - makes the whole thing dramatically easier to read later + +Learn this one shape well, and you'll find yourself reusing it constantly. Build the pattern once, and you can adapt it to almost anything. diff --git a/booleanexpr.adoc b/booleanexpr.adoc index fe0bf0c..7cc4238 100644 --- a/booleanexpr.adoc +++ b/booleanexpr.adoc @@ -68,7 +68,7 @@ total_cargo_weight < 6.0 # more than 6 tons and we can't take off! pilot.is_alive() and copilot.is_alive() # everything is fine, keep flying. ---- -Like the ANDs in the examples above or this last boolean expression with the `and`` in it, we have in Python the ability to combine expressions into larger more complex expressions using `and` and `or`. +Like the ANDs in the examples above or this last boolean expression with the `and` in it, we have in Python the ability to combine expressions into larger more complex expressions using `and` and `or`. == Logical Operators diff --git a/builtinsadvanced.adoc b/builtinsadvanced.adoc index 84f6e8e..21cae5f 100644 --- a/builtinsadvanced.adoc +++ b/builtinsadvanced.adoc @@ -75,7 +75,7 @@ print(prices_with_tax) # -> [1.59, 1.855, 2.12] === Filtering a List -`filter()` is `map()`'s close cousin. Instead of transforming every item, it *keeps only the items that pass a test*, throwing the rest away. +`filter()` is a close cousin of `map()`. Instead of transforming every item, it *keeps only the items that pass a test*, throwing the rest away. [source] ---- diff --git a/dundermethods.adoc b/dundermethods.adoc index 377c4ca..2d781f8 100644 --- a/dundermethods.adoc +++ b/dundermethods.adoc @@ -2,17 +2,17 @@ == Dunder Methods -In the last chapter, our `Spacecraft` class had two methods that looked a little strange: `__init__` and `__str__`. Those double underscores on both sides aren't a typo, and they aren't decoration. They're Python's way of marking a method as special. Programmers call these *dunder methods* - short for "Double UNDERscore" - and this chapter is all about what they are and why they matter. +In the last chapter, our `Spacecraft` class had two methods that looked a little strange: `+++__init__+++` and `+++__str__+++`. Those double underscores on both sides aren't a typo, and they aren't decoration. They're Python's way of marking a method as special. Programmers call these *dunder methods* - short for "Double UNDERscore" - and this chapter is all about what they are and why they matter. === What Makes a Method a "Dunder" -Any method whose name starts and ends with two underscores, like `__init__` or `__str__`, is a dunder method. You don't invent these names yourself - Python has a fixed list of them, and each one has a specific job. What makes them special is that you almost never call them directly. Instead, *Python calls them for you*, automatically, in response to something else you do to the object - creating it, printing it, comparing it, and so on. +Any method whose name starts and ends with two underscores, like `+++__init__+++` or `+++__str__+++`, is a dunder method. You don't invent these names yourself - Python has a fixed list of them, and each one has a specific job. What makes them special is that you almost never call them directly. Instead, *Python calls them for you*, automatically, in response to something else you do to the object - creating it, printing it, comparing it, and so on. Think of dunder methods as hooks. You write the hook, and Python promises to pull it at just the right moment. -=== `__init__`: The Constructor You Already Know +=== `+++__init__+++`: The Constructor You Already Know -You met this one last chapter, but let's call it out by name: `__init__` is called automatically the *instant* you create a new object. It's where you set up all of an object's starting values. +You met this one last chapter, but let's call it out by name: `+++__init__+++` is called automatically the *instant* you create a new object. It's where you set up all of an object's starting values. [source] ---- @@ -27,11 +27,11 @@ print(enterprise.name) # -> Enterprise print(enterprise.topspeed) # -> 9.9 ---- -Notice we didn't have to set `enterprise.name = "Enterprise"` on a separate line afterward, like we did before `__init__` showed up. Passing `"Enterprise"` and `9.9` straight into `Spacecraft(...)` hands them right to `__init__`, which tucks them away on `self`. `__init__` is a dunder, but it's such a common one you'll write it in almost every class you ever build. +Notice we didn't have to set `enterprise.name = "Enterprise"` on a separate line afterward, like we did before `+++__init__+++` showed up. Passing `"Enterprise"` and `9.9` straight into `Spacecraft(...)` hands them right to `+++__init__+++`, which tucks them away on `self`. `+++__init__+++` is a dunder, but it's such a common one you'll write it in almost every class you ever build. -=== `__str__`: Controlling How print() Sees You +=== `+++__str__+++`: Controlling How print() Sees You -You also met `__str__` last chapter. It's the hook that Python pulls whenever your object needs to be turned into a readable string - most commonly, when you `print()` it. +You also met `+++__str__+++` last chapter. It's the hook that Python pulls whenever your object needs to be turned into a readable string - most commonly, when you `print()` it. [source] ---- @@ -48,9 +48,9 @@ print(enterprise) # -> Starship Enterprise ---- -Without `__str__`, `print(enterprise)` would spit out something ugly and unhelpful, like `<__main__.Spacecraft object at 0x103013100>`. With it, you decide exactly what shows up. +Without `+++__str__+++`, `print(enterprise)` would spit out something ugly and unhelpful, like `<+++__main__+++.Spacecraft object at 0x103013100>`. With it, you decide exactly what shows up. -=== `__eq__`: Teaching Python What "Equal" Means +=== `+++__eq__+++`: Teaching Python What "Equal" Means By default, Python considers two objects equal only if they are *literally the same object* in memory - not just similar, but the exact same one. @@ -62,7 +62,7 @@ enterprise_copy = Spacecraft("Enterprise", 9.9) print(enterprise == enterprise_copy) # -> False, even though they look identical! ---- -That's often not what we want. If two spacecraft have the same name, we probably want `==` to say they're equal. That's what `__eq__` is for. +That's often not what we want. If two spacecraft have the same name, we probably want `==` to say they're equal. That's what `+++__eq__+++` is for. [source] ---- @@ -80,11 +80,11 @@ enterprise_copy = Spacecraft("Enterprise", 9.9) print(enterprise == enterprise_copy) # -> True now! ---- -`__eq__` takes two things to compare: `self` (the object on the left of `==`) and `other` (the object on the right). Whatever expression you return becomes the answer to "are these equal?" +`+++__eq__+++` takes two things to compare: `self` (the object on the left of `==`) and `other` (the object on the right). Whatever expression you return becomes the answer to "are these equal?" -=== `__len__`: Letting Your Object Work With len() +=== `+++__len__+++`: Letting Your Object Work With len() -Remember `len()`, from way back in the Built-in Functions chapter? It works on strings, lists, dicts, and sets - and it can work on *your own* classes too, if you define `__len__`. +Remember `len()`, from way back in the Built-in Functions chapter? It works on strings, lists, dicts, and sets - and it can work on *your own* classes too, if you define `+++__len__+++`. [source] ---- @@ -100,11 +100,11 @@ home_fleet = Fleet(["Enterprise", "Constellation", "Defiant"]) print(len(home_fleet)) # -> 3 ---- -Whatever number `__len__` returns is exactly what `len()` hands back to whoever calls it. This is a small example of a bigger idea: dunder methods are how your *own* classes get to plug into Python's built-in functions and operators, instead of only working with Python's built-in types. +Whatever number `+++__len__+++` returns is exactly what `len()` hands back to whoever calls it. This is a small example of a bigger idea: dunder methods are how your *own* classes get to plug into Python's built-in functions and operators, instead of only working with Python's built-in types. -=== `__add__`: Teaching Python What "+" Means for You +=== `+++__add__+++`: Teaching Python What "+" Means for You -That same idea applies to operators, not just functions. `__add__` controls what happens when your object is used on the left side of a `+`. +That same idea applies to operators, not just functions. `+++__add__+++` controls what happens when your object is used on the left side of a `+`. [source] ---- @@ -126,24 +126,24 @@ combined_fleet = home_fleet + reserve_fleet print(len(combined_fleet)) # -> 3 ---- -Without `__add__`, writing `home_fleet + reserve_fleet` would just crash with an error, since Python has no idea how to "add" two `Fleet` objects together. With it, you decide what `+` should mean for your own class. +Without `+++__add__+++`, writing `home_fleet + reserve_fleet` would just crash with an error, since Python has no idea how to "add" two `Fleet` objects together. With it, you decide what `+` should mean for your own class. === A Quick Reference [cols=",,",options="header",] |=== |Dunder Method |Gets Called When... |Common Use -|`__init__` |An object is created |Setting up starting values -|`__str__` |The object is printed, or turned into a string |A friendly, readable description -|`__eq__` |Two objects are compared with `==` |Deciding what "equal" means for your class -|`__len__` |`len()` is called on the object |Reporting some meaningful "size" -|`__add__` |Two objects are combined with `+` |Deciding what "adding" means for your class +|`+++__init__+++` |An object is created |Setting up starting values +|`+++__str__+++` |The object is printed, or turned into a string |A friendly, readable description +|`+++__eq__+++` |Two objects are compared with `==` |Deciding what "equal" means for your class +|`+++__len__+++` |`len()` is called on the object |Reporting some meaningful "size" +|`+++__add__+++` |Two objects are combined with `+` |Deciding what "adding" means for your class |=== [TIP] ==== -* Add a `__len__` method to a `Player` class that returns how many items are in that player's inventory list -* Add an `__eq__` method that considers two players equal if they have the same name +* Add a `+++__len__+++` method to a `Player` class that returns how many items are in that player's inventory list +* Add an `+++__eq__+++` method that considers two players equal if they have the same name * Try `len(player)` and `player_one == player_two` and see your dunder methods kick in ==== @@ -151,4 +151,4 @@ Without `__add__`, writing `home_fleet + reserve_fleet` would just crash with an Here's the big idea to walk away with: dunder methods are the bridge between *your own* custom classes and all the built-in syntax and functions you've already learned throughout this book - `print()`, `len()`, `==`, `+`, and plenty more we haven't shown here. You're not learning a pile of odd, unrelated tricks. You're learning the *one mechanism* Python uses, over and over, to let your objects behave like they belong in the language, right alongside strings, lists, and dictionaries. -You won't need most dunder methods most of the time. But `__init__` and `__str__` will show up in nearly every class you write from here on out, so make sure those two, at least, feel like old friends. +You won't need most dunder methods most of the time. But `+++__init__+++` and `+++__str__+++` will show up in nearly every class you write from here on out, so make sure those two, at least, feel like old friends. diff --git a/forloop.adoc b/forloop.adoc index 7b5a880..a13a698 100644 --- a/forloop.adoc +++ b/forloop.adoc @@ -102,3 +102,11 @@ Look, we had to range(10, 0, -1) to get the one to print. Otherwise if we had ha The *range()* function gets used a lot in Python, and is the envy of many programmers in other languages who have use the *for* loop that was handed down from the C programming language. So use it widely, and don't gloat -- too much :-) + +=== A Quick Word: Iterables + +Notice that we've now written `for donut in list_of_donuts:` and `for j in range(5):` - two very different-looking things sitting after that `in`. Python has a name for anything that's allowed to sit there: an *iterable*. Something is iterable if a `for` loop knows how to walk through it, one item at a time. + +Lists and ranges are iterables. So are strings - that's exactly what let us loop over "hello" letter by letter, back in the Strings chapter. As you meet more data structures later in this book - dictionaries, sets, tuples - you'll find every single one of them is iterable too, which means `for thing in that_data_structure:` will always just work. + +You don't need to know *how* Python pulls this off yet - just get comfortable with the word "iterable," since we'll use it constantly from here on. Much later in the book, in a chapter called Iterators, we'll open the hood and see exactly what makes something iterable in the first place. diff --git a/functionparams.adoc b/functionparams.adoc new file mode 100644 index 0000000..049e785 --- /dev/null +++ b/functionparams.adoc @@ -0,0 +1,149 @@ + + +== Flexible Function Parameters + +Back in the Functions chapter, every parameter we wrote was required - the caller had to hand over exactly the right number of values, in exactly the right order, every single time. That works fine for simple functions, but real programs often need more flexibility: an optional parameter with a sensible fallback, or a function that has no idea in advance how many values it's about to receive. Python gives you three tools for exactly this: *default parameter values*, `*args`, and `**kwargs`. + +=== Default Parameter Values + +A default parameter value is a fallback - a value Python uses automatically if the caller doesn't bother providing one. + +[source] +---- +def greet_user(username, greeting="Hello"): + return greeting + ", " + username + "!" + +print(greet_user("Mike Jones")) # -> Hello, Mike Jones! +print(greet_user("Mike Jones", "Welcome back")) # -> Welcome back, Mike Jones! +---- + +Notice `greeting` has `="Hello"` right in the function definition. If the caller only passes one argument, Python fills in `"Hello"` for `greeting` automatically. But if the caller *does* provide a second argument, that value wins instead, overriding the default. + +Here's one for our dungeon game: + +[source] +---- +def take_damage(player, amount=10): + player["health"] = player["health"] - amount + +sam = {"name": "Sam", "health": 100} + +take_damage(sam) # uses the default, amount=10 +print(sam["health"]) # -> 90 + +take_damage(sam, 25) # overrides the default +print(sam["health"]) # -> 65 +---- + +NOTE: Default parameters must come *after* any required ones in your function's parameter list. `def take_damage(amount=10, player):` would confuse Python - it wouldn't know if a lone argument was meant for `amount` or `player`. Required parameters always come first, defaults come last. + +=== Accepting Any Number of Arguments: `*args` + +Sometimes you genuinely don't know, ahead of time, how many values a function needs to accept. Maybe you're totaling up hits from an unpredictable, chaotic battle - sometimes there are two hits, sometimes there are seven. That's what `*args` is for. + +[source] +---- +def total_damage(*hits): + return sum(hits) + +print(total_damage(5, 10, 3)) # -> 18 +print(total_damage(5, 10, 3, 20)) # -> 38 +print(total_damage()) # -> 0 +---- + +That single `*` in front of `hits` tells Python: "scoop up *any* number of extra positional arguments, and gather them together." And gather them into what, exactly? A *tuple* - the very thing we covered a couple chapters back. + +[source] +---- +def show_me(*hits): + print(type(hits)) + print(hits) + +show_me(5, 10, 3) +# output is +# +# (5, 10, 3) +---- + +Since it's just a tuple, everything you already know about tuples - indexing, slicing, looping over it - works on `*args` too. You can also mix `*args` with regular parameters, as long as the regular ones come first. + +[source] +---- +def introduce_party(leader, *members): + print(leader, "is leading the party.") + for member in members: + print(member, "is along for the ride.") + +introduce_party("Sam", "Jade", "Sadie", "Marcus") +# output is +# Sam is leading the party. +# Jade is along for the ride. +# Sadie is along for the ride. +# Marcus is along for the ride. +---- + +NOTE: The name `args` is just a convention, not a rule - you could call it `*hits` or `*members` or `*anything_you_want`. It's the single `*` in front that makes it special to Python, not the word "args" itself. + +=== Accepting Any Number of Keyword Arguments: `**kwargs` + +`**kwargs` is a close cousin of `*args`, except instead of gathering up a bunch of unnamed positional arguments, it gathers up *named* ones - the `key=value` style of arguments - into a dictionary. + +[source] +---- +def build_character(**traits): + for key, value in traits.items(): + print(key, "->", value) + +build_character(name="Katniss", district=12, weapon="bow") +# output is +# name -> Katniss +# district -> 12 +# weapon -> bow +---- + +Just like `*args` gathers extras into a tuple, `**kwargs` gathers extras into a dictionary - which is why we can loop over it with `.items()`, exactly like we learned in the Dictionaries chapter. + +[source] +---- +def show_me(**traits): + print(type(traits)) + print(traits) + +show_me(name="Katniss", district=12) +# output is +# +# {'name': 'Katniss', 'district': 12} +---- + +Again, `kwargs` is just a common convention for the name - the double `**` is what actually matters to Python. + +=== Putting It All Together + +You can combine regular parameters, default parameters, `*args`, and `**kwargs` in a single function - but Python insists they show up in this order: regular parameters first, then defaults, then `*args`, then `**kwargs` last. + +[source] +---- +def cast_spell(caster, spell="fireball", *targets, **effects): + print(caster, "casts", spell, "on", targets) + for effect, value in effects.items(): + print(" ", effect, "->", value) + +cast_spell("Gandalf", "lightning bolt", "Orc1", "Orc2", damage=50, stun=True) +# output is +# Gandalf casts lightning bolt on ('Orc1', 'Orc2') +# damage -> 50 +# stun -> True +---- + +You won't need all four at once very often, but now you'll recognize each piece when you see it. + +[TIP] +==== +* Write a function `order_donuts(customer, *flavors, **extras)` +* `customer` is a required, regular parameter +* `*flavors` should collect any number of donut flavor names +* `**extras` should collect optional named details, like `sprinkles=True` or `dozen=True` +* Call it a few different ways, and print out everything the function received +==== + +Between default values, `*args`, and `**kwargs`, your functions can now flex to fit however they're called, instead of demanding one rigid, fixed shape every time. diff --git a/generators.adoc b/generators.adoc new file mode 100644 index 0000000..7a19679 --- /dev/null +++ b/generators.adoc @@ -0,0 +1,137 @@ + + +== Generators + +That `Countdown` class from the last chapter worked, but notice how much ceremony it took: a `+++__init__+++` to set up state, a `+++__iter__+++` that just returned `self`, and a `+++__next__+++` that had to manually track `self.current` and remember to raise `StopIteration` at exactly the right moment. That's a lot of bookkeeping for something as simple as "count down from 3 to 0." Python has a much shorter way to write the same thing, called a *generator*. + +=== A Simpler Way: The `yield` Keyword + +Here's `Countdown`, rewritten as a plain function: + +[source] +---- +def countdown(start): + current = start + while current >= 0: + yield current + current -= 1 + +for count in countdown(3): + print(count) + +# output is +# 3 +# 2 +# 1 +# 0 +---- + +Same result, in a fraction of the code, and no class in sight. The magic word is `yield`. The moment a function contains `yield` anywhere in its body, Python treats it completely differently from a regular function - it becomes a *generator function*. + +=== What `yield` Actually Does + +When you call `countdown(3)`, the function body *doesn't run yet*. Instead, you get back a special generator object - one that already knows how to act as an iterator, with `+++__iter__+++` and `+++__next__+++` built in for you automatically. No writing those dunders yourself; Python hands you a working iterator just by seeing `yield` in your function. + +Each time something calls `next()` on it, the function runs until it hits `yield`, hands back that value, and then *pauses* - completely frozen, remembering every local variable exactly as it was. The next time `next()` is called, it picks up right where it left off, continuing the loop, right after that `yield` line. + +[source] +---- +def countdown(start): + current = start + while current >= 0: + yield current + current -= 1 + +counter = countdown(2) + +print(next(counter)) # -> 2 +print(next(counter)) # -> 1 +print(next(counter)) # -> 0 +print(next(counter)) # -> StopIteration +---- + +When the function finally falls off the end (here, once the `while` condition goes false), Python automatically raises `StopIteration` for you too - just like the manual iterator from last chapter, except you never had to write that part yourself. + +=== Generators Are Lazy (In a Good Way) + +Here's the real payoff. A list comprehension builds its *entire* result, all at once, sitting in memory. + +[source] +---- +squares = [x * x for x in range(1000000)] +---- + +That line immediately creates a list with a million numbers in it, whether you ever use all of them or not. A generator, on the other hand, produces values *one at a time, only when asked*. Nothing gets computed until `next()` actually calls for it. + +[source] +---- +def squares_up_to(limit): + x = 0 + while x < limit: + yield x * x + x += 1 + +for square in squares_up_to(1000000): + if square > 100: + break + print(square) +---- + +Even though `squares_up_to` could technically go all the way to a million, we only ever computed the handful of squares we actually printed before `break` stopped things. This "produce only what's needed, only when it's needed" behavior is called being *lazy*, and it can save a serious amount of memory and time once your data gets large. + +=== Generator Expressions + +Remember comprehensions? Generators have their own version of that shorthand too, called a *generator expression* - it looks just like a list comprehension, but with parentheses instead of square brackets. + +[source] +---- +squares = (x * x for x in range(1000000)) + +print(type(squares)) # -> +---- + +Nothing gets computed yet - `squares` is just a generator, waiting patiently to be asked for values. You can loop over it like anything else iterable: + +[source] +---- +squares = (x * x for x in range(5)) + +for square in squares: + print(square) + +# output is +# 0 +# 1 +# 4 +# 9 +# 16 +---- + +You'll often see a generator expression used directly inside a function call, with the parentheses left off entirely. + +[source] +---- +total = sum(x * x for x in range(1000000)) +print(total) +---- + +That computes the sum of a million squares without ever holding all million of them in memory at the same time - each one gets produced, added to the running total, and thrown away, one at a time. + +[TIP] +==== +* Rewrite the `HealthDrain` class from the last chapter's exercise as a generator function using `yield` +* Compare how many lines it took as a class versus as a generator function +* Then write a generator expression that produces the squares of only the *even* numbers from 0 to 20 +==== + +=== Iterators and Generators, Side by Side + +[cols=",,",options="header",] +|=== +| |Iterator (a class) |Generator (a function) +|How you build one |Write `+++__init__+++`, `+++__iter__+++`, `+++__next__+++` |Write a function using `yield` +|State tracking |You manage it yourself, on `self` |Python remembers it for you automatically +|Typical amount of code |More |Much less +|=== + +Both approaches produce the exact same thing from the outside - something you can hand to a `for` loop, or to `next()`, one value at a time. Now that you've built one the hard way with a class, and the easy way with `yield`, you'll recognize both wherever they show up in real Python code - and you'll almost always reach for `yield`. diff --git a/index.adoc b/index.adoc index 4fe83bc..0bb23c8 100644 --- a/index.adoc +++ b/index.adoc @@ -1,7 +1,7 @@ :title-page: = Zip Code Wilmington's Programming in Python Kristofer Younger -v2.0.1, 2026-09-24 +v2.0.2, 2026-09-28 :doctype: book :imagesdir: images :pdf-theme: pypreptheme.yml @@ -176,6 +176,10 @@ include::sets.adoc[] include::tuples.adoc[] +include::functionparams.adoc[] + +include::typehints.adoc[] + include::builtins.adoc[] include::lambdas.adoc[] @@ -190,14 +194,26 @@ include::setcomprehension.adoc[] include::modules.adoc[] +include::runvsimport.adoc[] + include::objectsmethods.adoc[] include::dundermethods.adoc[] +include::iterators.adoc[] + +include::generators.adoc[] + include::appendixa.adoc[] include::appendixb.adoc[] +include::appendixc.adoc[] + +include::appendixd.adoc[] + +include::appendixe.adoc[] + [appendix] == Additional Python Resources diff --git a/iterators.adoc b/iterators.adoc new file mode 100644 index 0000000..ca01b31 --- /dev/null +++ b/iterators.adoc @@ -0,0 +1,105 @@ + + +== Iterators + +Back in the Loops chapter, we introduced the word *iterable* - anything a `for` loop knows how to walk through, one item at a time. We've used plenty of iterables since then: lists, strings, ranges, dictionaries, sets, tuples. Now that you know classes and dunder methods, we can finally open the hood and see exactly what makes something iterable in the first place. + +=== Iterable vs. Iterator + +These two words look almost identical, and that trips people up, so let's be precise: + +* An *iterable* is anything you *can* loop over - a list, a string, a range. +* An *iterator* is the actual object doing the walking - it remembers exactly where it currently is, and knows how to fetch the *next* item. + +Here's the relationship: an iterable doesn't walk itself. When a `for` loop wants to walk through one, it first asks the iterable for an iterator, and *that* iterator is what actually keeps track of position and hands back values, one at a time. + +=== Getting an Iterator by Hand + +You can do this yourself, without a `for` loop at all, using two built-in functions: `iter()` and `next()`. + +[source] +---- +donut_flavors = ["chocolate", "glazed", "jelly"] + +flavor_iterator = iter(donut_flavors) + +print(next(flavor_iterator)) # -> chocolate +print(next(flavor_iterator)) # -> glazed +print(next(flavor_iterator)) # -> jelly +---- + +`iter()` takes an iterable and hands you back its iterator. Each call to `next()` moves that iterator forward by one and gives you the next value. What happens if you call `next()` one time too many, once there's nothing left? + +[source] +---- +print(next(flavor_iterator)) +# StopIteration +---- + +Python raises a `StopIteration` error. That's not really a "problem" - it's the iterator's official way of saying "I'm out of items, we're done here." + +=== What a `for` Loop Is Really Doing + +Here's the secret: a `for` loop is just doing exactly what we did above, automatically, and quietly catching `StopIteration` for you so your program doesn't crash. + +[source] +---- +donut_flavors = ["chocolate", "glazed", "jelly"] + +flavor_iterator = iter(donut_flavors) + +while True: + try: + flavor = next(flavor_iterator) + except: + break + print(flavor) +---- + +That clunky `while True` / `try` / `except` mess is precisely what `for donut in donut_flavors:` is doing behind the scenes, every single time you write it. This is why `for` works identically on a list, a string, a dictionary, or anything else iterable - they all agree to answer `iter()` and `next()` the same way, so `for` never needs to know or care what kind of thing it's actually looping over. + +=== Making Your Own Class Iterable + +Since `+++__iter__+++` and `+++__next__+++` are just two more dunder methods, you can add them to any class you write, and suddenly a `for` loop will work on your own objects too. + +[source] +---- +class Countdown: + def __init__(self, start): + self.current = start + + def __iter__(self): + return self + + def __next__(self): + if self.current < 0: + raise StopIteration + value = self.current + self.current -= 1 + return value + +for count in Countdown(3): + print(count) + +# output is +# 3 +# 2 +# 1 +# 0 +---- + +Let's break down the two dunders doing the work here: + +* `+++__iter__+++` needs to return *an iterator* - here, we just return `self`, since our `Countdown` object is perfectly capable of tracking its own position and handing back its own next value. +* `+++__next__+++` does the real work: it computes the next value, and once there's nothing left to give, it raises `StopIteration` itself, exactly like the built-in iterators did. + +Because `Countdown` defines both, Python's `for` loop is happy to walk right through it, exactly like it would a list or a range. + +[TIP] +==== +* Write a class `HealthDrain` that starts a player at some health value and counts *down by 5* each time, stopping once health reaches 0 +* Give it `+++__init__+++`, `+++__iter__+++`, and `+++__next__+++` +* Use it in a `for` loop and print each health value along the way +==== + +All of this - `iter()`, `next()`, `StopIteration`, `+++__iter__+++`, `+++__next__+++` - is the real machinery under every `for` loop you've ever written. It's a little bit of ceremony to write by hand, though. In the next chapter, we'll meet *generators* - Python's much shorter way to build your own iterator, without writing a whole class at all. diff --git a/objectsmethods.adoc b/objectsmethods.adoc index 2e93923..2865250 100644 --- a/objectsmethods.adoc +++ b/objectsmethods.adoc @@ -1,12 +1,16 @@ == Objects/Instances -There are a series if key data types pre-defined (builtin) to Python. The key primaries: "int", "float", "str", "bool", "None". -And there are the "sequence" types: "list", "tuple", "range". -Several can also be thought of as "container" types: "list", "tuple","dict", "set", "frozenset". +There are a series if key data types pre-defined (builtin) to Python. The key primaries: *"int", "float", "str", "bool", "None"*. + +And there are the "sequence" types: *"list", "tuple", "range"*. + +Several can also be thought of as "container" types: *"list", "tuple","dict", "set", "frozenset"*. All of these are actually Classes in Python. They are all built-in classes, and are available to use without any special syntax. +And `type()` will tell you the class of an object. +Any object at all. Moreover, Python is an object oriented programming language. Everything in Python is an object, with its properties/attributes and methods. diff --git a/runvsimport.adoc b/runvsimport.adoc new file mode 100644 index 0000000..4ae09aa --- /dev/null +++ b/runvsimport.adoc @@ -0,0 +1,108 @@ + + +== Loading vs. Running a File + +In the Modules chapter, we split code across two files and used `import` to borrow a function from one file into another. That raises a fair question, though: when Python "imports" a file, does it actually *run* that file's code, or just quietly *load* the function definitions sitting inside it? The answer, a little surprisingly, is: it runs *all* of it, every time - and once you understand that, a strange-looking line you'll see constantly in real Python code, `+++if __name__ == "__main__":+++`, stops being a mystery. + +=== Every File Gets Run, Top to Bottom + +Whether you run a file directly, or another file imports it with `import`, Python does the exact same first step: it executes every top-level statement in that file, in order, from top to bottom. + +[source] +---- +print("Loading greetings module...") + +def greet_user(username): + return "Hello, " + username + "!" +---- +_greetings.py_ + +[source] +---- +import greetings + +print("Now in main.py") +---- +_main.py_ + +Now run `main.py`. Here's the output, in order: + +[source] +---- +Loading greetings module... +Now in main.py +---- + +That first `print()`, sitting in `greetings.py`, ran the *instant* `main.py` imported it - well before that second `print()`, the one actually sitting in `main.py`, ever got a turn. That's the "run" half of "loading vs. running": importing a file isn't some special, gentler process that skips over code. It's the exact same thing as running that file, just triggered by another file asking for it instead of you typing its name at a terminal. + +=== The Hidden Variable: `+++__name__+++` + +Every Python file, while it's actually running, has access to a hidden variable named `+++__name__+++` that tells it exactly *how* it's currently being used. + +* If you run a file *directly* - typing something like `python3 greetings.py` at a terminal - Python sets that file's `+++__name__+++` to the special string `+++"__main__"+++`. +* If a file gets *imported* instead, Python sets its `+++__name__+++` to the module's own name, as a string - so `greetings.py`, when imported, sees `+++__name__+++` equal to `"greetings"`. + +[source] +---- +print("This file's name is:", __name__) +---- +_greetings.py_ + +Run it straight from the terminal, `python3 greetings.py`, and you'll see: + +[source] +---- +This file's name is: __main__ +---- + +But add `import greetings` to the top of `main.py` and run *that* instead, and inside `greetings.py`, that very same line prints something different: + +[source] +---- +This file's name is: greetings +---- + +Same file, same line of code - but `+++__name__+++` tells it which situation it's actually in. + +=== The `+++if __name__ == "__main__":+++` Pattern + +Once you know `+++__name__+++` changes like that, this extremely common pattern stops looking so mysterious: + +[source] +---- +def greet_user(username): + return "Hello, " + username + "!" + +if __name__ == "__main__": + print(greet_user("Mike Jones")) +---- +_greetings.py_ + +Read it exactly as it's written: if this file's name is `+++__main__+++`, that means *this exact file* is the one that got launched directly - so run the code indented underneath. + +* Run `python3 greetings.py` directly, and `+++__name__+++` really is `+++"__main__"+++`, so the `print()` fires: `Hello, Mike Jones!` +* But have `main.py` do `import greetings` instead, and inside `greetings.py`, `+++__name__+++` is `"greetings"`, not `+++"__main__"+++` - so that whole `if` block gets skipped entirely. `main.py` still gets the `greet_user` function, ready to use, but that test/demo `print()` never runs on its own. + +=== Why This Matters + +This pattern lets a single file do double duty: it can be a reusable module, full of functions other files are meant to `import` and borrow, *and* a standalone, runnable script with its own little demo or test code - all without those two jobs interfering with each other. Without the `+++if __name__ == "__main__":+++` guard, importing a module would also, unavoidably, run every last one of its "just testing this" print statements and demo calls, every single time. + +Remember the Mars Lander program from the appendix? Its very last line just calls `run_game(burn_array)` directly, with no guard at all. That's fine as a single, standalone program - but it does mean if you ever wanted to `import` those Mars Lander functions into a *different* program, just to reuse `compute_delta_v()` or `check_status()`, you'd immediately launch an entire, uninvited simulation the moment your `import` line ran. Wrapping that final call like this would fix it: + +[source] +---- +if __name__ == "__main__": + run_game(burn_array) +---- + +Now the simulation only launches when you run that file directly - and anyone who wants to `import` just a function or two from it can do so safely, without triggering a whole game. + +[TIP] +==== +* Take the `greetings.py` file from the Modules chapter +* Add an `+++if __name__ == "__main__":+++` block at the bottom with a test call or two to `greet_user` +* Run `greetings.py` directly, and confirm your test calls print +* Then, from a second file, `import greetings` and confirm those same test calls *don't* print this time +==== + +You'll see `+++if __name__ == "__main__":+++` at the bottom of an enormous number of real Python files out in the wild. Now you know exactly what it's checking, and why it's there. diff --git a/strings.adoc b/strings.adoc index ad7b37a..dbb3439 100644 --- a/strings.adoc +++ b/strings.adoc @@ -133,7 +133,7 @@ It follows this pattern: `end:` The ending index of the substring. The character at this index is NOT included in the substring. If end is not included, or if the value is greater than the string length, it is assumed to be equal to the `len()` of the string by default. -`step:`` Every ‘step’ character after the current character to be included. If the step value is not there, Python sets it to 1. +`step:` Every ‘step’ character after the current character to be included. If the step value is not there, Python sets it to 1. A start position is required, where to begin the extraction (or substring). Remember, first character is at position 0. Characters are extracted from a string between "start" and "end", not including "end" itself. diff --git a/tuples.adoc b/tuples.adoc index 7109d3f..6d43640 100644 --- a/tuples.adoc +++ b/tuples.adoc @@ -109,3 +109,5 @@ spawn_point = (0, 0) # this should never change ---- Tuples aren't as flashy as lists, but they earn their keep. Whenever you find yourself thinking "this data should never change," reach for a tuple, and let Python enforce that promise for you. + +Keep tuples in mind as you move on - they're about to make a surprise appearance in the next chapter, tucked inside one of Python's more flexible function tricks. diff --git a/typehints.adoc b/typehints.adoc new file mode 100644 index 0000000..eb5eb29 --- /dev/null +++ b/typehints.adoc @@ -0,0 +1,126 @@ + + +== Type Hints + +Way back in the Variables chapter, we saw that Python variables are dynamic - a variable can hold a string one moment and a number the next, and Python never complains. That flexibility is one of Python's superpowers. But it comes with a cost: just by glancing at a function, there's often no way to tell what kind of data it expects, or what kind of data it's going to hand back to you. + +*Type hints* are Python's answer to that problem. + +=== What Is a Type Hint? + +A type hint is a little note you add to a function (or a variable) saying what type of data you *expect* to be dealing with. + +[source] +---- +def greet_user(username: str) -> str: + return "Hello, " + username + "!" + +print(greet_user("Mike Jones")) # -> Hello, Mike Jones! +---- + +Two new things showed up here: + +* `username: str` - this says "I expect `username` to be a string." +* `-> str` - this says "this function returns a string." + +Read the whole line almost like a sentence: `greet_user` takes a `username`, which should be a `str`, and returns a `str`. + +=== Important: Hints Are Not Enforced + +Here's the part that trips people up: type hints are *hints*, not rules. Python will not stop you from breaking one. + +[source] +---- +def add_bonus(score: int, bonus: int) -> int: + return score + bonus + +print(add_bonus(50, "10")) +# TypeError: unsupported operand type(s) for +: 'int' and 'str' +---- + +We hinted `bonus` as an `int`, but nothing physically stopped us from calling `add_bonus` with the string `"10"` instead. The program still crashed - but notice *why*. It crashed because `+` genuinely can't combine a number and a string together, the same problem you've run into before with strings and numbers. It did *not* crash because we broke the type hint; Python never even glances at the hint while your program is running. The hint didn't prevent this mistake - it just would have warned a careful reader (or a smart editor) about it *before* the code ever ran. + +NOTE: Type hints are sometimes called "optional" for a good reason - your code runs exactly the same with them or without them. They're there for *people* (including future-you) and for tools, not for the Python interpreter to police. + +=== Why Bother, Then? + +If Python doesn't enforce them, what's the point? A few good reasons: + +* *Readability* - anyone reading `def greet_user(username: str) -> str:` instantly knows what to hand this function, without having to go read the whole function body first. +* *Self-documentation* - the hints live right in the code, so they can't drift out of date the way a separate comment or document sometimes does. +* *Tooling* - modern code editors read your type hints and warn you *immediately*, often as you're typing, if you're about to pass the wrong kind of thing into a function. That catches a whole category of mistakes before you ever hit run. + +As your programs get bigger, and especially once you're working on a team where other people read your code, these small hints save a surprising amount of confusion. + +=== Common Types You'll Hint + +You already know most of these types by name - now you know how to write them as hints. + +[cols=",",options="header",] +|=== +|Hint |Means +|`str` |A string +|`int` |A whole number +|`float` |A decimal number +|`bool` |True or False +|`list` |A list +|`dict` |A dictionary +|`tuple` |A tuple +|`set` |A set +|`None` |Nothing at all +|=== + +[source] +---- +def take_damage(player: dict, amount: int) -> None: + player["health"] = player["health"] - amount +---- + +That `-> None` is a common one - it says "this function doesn't hand anything back." `take_damage` just changes `player` in place and returns nothing, so `None` is the honest, accurate hint. + +=== Hinting What's *Inside* a Collection + +You can get more specific than just "this is a list" - you can say what kind of thing fills that list. + +[source] +---- +def total_damage(hits: list[int]) -> int: + return sum(hits) +---- + +`list[int]` means "a list, and every item inside it should be an `int`." The same trick works for dictionaries, showing both the key type and the value type. + +[source] +---- +def build_health_lookup(names: list[str], scores: list[int]) -> dict[str, int]: + return {name: score for name, score in zip(names, scores)} +---- + +That return hint, `dict[str, int]`, tells us this function hands back a dictionary whose keys are strings and whose values are integers - exactly the kind of dictionary comprehension we built a couple chapters back. + +=== Type Hints and Default Parameters Play Nicely Together + +You can combine everything from the last chapter with type hints, all in the same function signature. + +[source] +---- +def cast_spell(caster: str, spell: str = "fireball", power: int = 50) -> str: + return caster + " casts " + spell + " for " + str(power) + " damage!" + +print(cast_spell("Gandalf")) +# -> Gandalf casts fireball for 50 damage! +---- + +Notice the hint and the default value sit right next to each other: `spell: str = "fireball"` says both "this should be a string" *and* "if you don't provide one, use `'fireball'`." + +[TIP] +==== +* Take the `take_damage(player, amount=10)` function from the last chapter +* Add type hints: `player` should be hinted as a `dict`, `amount` as an `int` +* Give the function a `-> None` return hint, since it doesn't return anything +* Call it once with correct types, and once "incorrectly" (like a string for `amount`) just to see that Python still runs it either way +==== + +=== A Habit Worth Building Now + +You don't have to type-hint every single line of code you write, especially while you're still learning. But it's a genuinely good professional habit to start building early - the kind of thing that makes your code easier for *other* people (and future-you) to pick up and trust at a glance. The more Python you write, the more you'll find yourself reaching for a type hint out of habit, simply because it makes the code that much clearer. From 306a9199b80f74be7b3afe66b7d20e23c4c97812 Mon Sep 17 00:00:00 2001 From: Kristofer Date: Fri, 25 Sep 2026 14:58:44 -0400 Subject: [PATCH 09/12] Update .gitignore --- .gitignore | 1 + 1 file changed, 1 insertion(+) diff --git a/.gitignore b/.gitignore index bffb888..267fa6e 100755 --- a/.gitignore +++ b/.gitignore @@ -26,3 +26,4 @@ index.pdf EPUB/index.epub *.epub *.pdf +.DS_Store From 88d3b4b838271347a3466a088933548e87c7564a Mon Sep 17 00:00:00 2001 From: Kristofer Date: Mon, 5 Oct 2026 10:43:22 -0400 Subject: [PATCH 10/12] adds func params --- functionparams.adoc | 26 +++++++++++++------------- index.adoc | 4 ++-- 2 files changed, 15 insertions(+), 15 deletions(-) diff --git a/functionparams.adoc b/functionparams.adoc index 049e785..86de58f 100644 --- a/functionparams.adoc +++ b/functionparams.adoc @@ -2,7 +2,7 @@ == Flexible Function Parameters -Back in the Functions chapter, every parameter we wrote was required - the caller had to hand over exactly the right number of values, in exactly the right order, every single time. That works fine for simple functions, but real programs often need more flexibility: an optional parameter with a sensible fallback, or a function that has no idea in advance how many values it's about to receive. Python gives you three tools for exactly this: *default parameter values*, `*args`, and `**kwargs`. +Back in the Functions chapter, every parameter we wrote was required - the caller had to hand over exactly the right number of values, in exactly the right order, every single time. That works fine for simple functions, but real programs often need more flexibility: an optional parameter with a sensible fallback, or a function that has no idea in advance how many values it's about to receive. Python gives you three tools for exactly this: *default parameter values*, `+++*args+++`, and `+++**kwargs+++`. === Default Parameter Values @@ -37,9 +37,9 @@ print(sam["health"]) # -> 65 NOTE: Default parameters must come *after* any required ones in your function's parameter list. `def take_damage(amount=10, player):` would confuse Python - it wouldn't know if a lone argument was meant for `amount` or `player`. Required parameters always come first, defaults come last. -=== Accepting Any Number of Arguments: `*args` +=== Accepting Any Number of Arguments: `+++*args+++` -Sometimes you genuinely don't know, ahead of time, how many values a function needs to accept. Maybe you're totaling up hits from an unpredictable, chaotic battle - sometimes there are two hits, sometimes there are seven. That's what `*args` is for. +Sometimes you genuinely don't know, ahead of time, how many values a function needs to accept. Maybe you're totaling up hits from an unpredictable, chaotic battle - sometimes there are two hits, sometimes there are seven. That's what `+++*args+++` is for. [source] ---- @@ -51,7 +51,7 @@ print(total_damage(5, 10, 3, 20)) # -> 38 print(total_damage()) # -> 0 ---- -That single `*` in front of `hits` tells Python: "scoop up *any* number of extra positional arguments, and gather them together." And gather them into what, exactly? A *tuple* - the very thing we covered a couple chapters back. +That single `+++*+++` in front of `hits` tells Python: "scoop up *any* number of extra positional arguments, and gather them together." And gather them into what, exactly? A *tuple* - the very thing we covered a couple chapters back. [source] ---- @@ -65,7 +65,7 @@ show_me(5, 10, 3) # (5, 10, 3) ---- -Since it's just a tuple, everything you already know about tuples - indexing, slicing, looping over it - works on `*args` too. You can also mix `*args` with regular parameters, as long as the regular ones come first. +Since it's just a tuple, everything you already know about tuples - indexing, slicing, looping over it - works on `+++*args+++` too. You can also mix `+++*args+++` with regular parameters, as long as the regular ones come first. [source] ---- @@ -82,11 +82,11 @@ introduce_party("Sam", "Jade", "Sadie", "Marcus") # Marcus is along for the ride. ---- -NOTE: The name `args` is just a convention, not a rule - you could call it `*hits` or `*members` or `*anything_you_want`. It's the single `*` in front that makes it special to Python, not the word "args" itself. +NOTE: The name `args` is just a convention, not a rule - you could call it `+++*hits+++` or `+++*members+++` or `+++*anything_you_want+++`. It's the single `+++*+++` in front that makes it special to Python, not the word "args" itself. -=== Accepting Any Number of Keyword Arguments: `**kwargs` +=== Accepting Any Number of Keyword Arguments: `+++**kwargs+++` -`**kwargs` is a close cousin of `*args`, except instead of gathering up a bunch of unnamed positional arguments, it gathers up *named* ones - the `key=value` style of arguments - into a dictionary. +`+++**kwargs+++` is a close cousin of `+++*args+++`, except instead of gathering up a bunch of unnamed positional arguments, it gathers up *named* ones - the `key=value` style of arguments - into a dictionary. [source] ---- @@ -101,7 +101,7 @@ build_character(name="Katniss", district=12, weapon="bow") # weapon -> bow ---- -Just like `*args` gathers extras into a tuple, `**kwargs` gathers extras into a dictionary - which is why we can loop over it with `.items()`, exactly like we learned in the Dictionaries chapter. +Just like `+++*args+++` gathers extras into a tuple, `+++**kwargs+++` gathers extras into a dictionary - which is why we can loop over it with `.items()`, exactly like we learned in the Dictionaries chapter. [source] ---- @@ -119,7 +119,7 @@ Again, `kwargs` is just a common convention for the name - the double `**` is wh === Putting It All Together -You can combine regular parameters, default parameters, `*args`, and `**kwargs` in a single function - but Python insists they show up in this order: regular parameters first, then defaults, then `*args`, then `**kwargs` last. +You can combine regular parameters, default parameters, `+++*args+++`, and `+++**kwargs+++` in a single function - but Python insists they show up in this order: regular parameters first, then defaults, then `+++*args+++`, then `+++**kwargs+++` last. [source] ---- @@ -141,9 +141,9 @@ You won't need all four at once very often, but now you'll recognize each piece ==== * Write a function `order_donuts(customer, *flavors, **extras)` * `customer` is a required, regular parameter -* `*flavors` should collect any number of donut flavor names -* `**extras` should collect optional named details, like `sprinkles=True` or `dozen=True` +* `+++*flavors+++` should collect any number of donut flavor names +* `+++**extras+++` should collect optional named details, like `sprinkles=True` or `dozen=True` * Call it a few different ways, and print out everything the function received ==== -Between default values, `*args`, and `**kwargs`, your functions can now flex to fit however they're called, instead of demanding one rigid, fixed shape every time. +Between default values, `+++*args+++`, and `+++**kwargs+++`, your functions can now flex to fit however they're called, instead of demanding one rigid, fixed shape every time. diff --git a/index.adoc b/index.adoc index 0bb23c8..5436ce4 100644 --- a/index.adoc +++ b/index.adoc @@ -1,7 +1,7 @@ :title-page: = Zip Code Wilmington's Programming in Python Kristofer Younger -v2.0.2, 2026-09-28 +v2.0.3, 2026-09-28 :doctype: book :imagesdir: images :pdf-theme: pypreptheme.yml @@ -9,7 +9,7 @@ v2.0.2, 2026-09-28 :rouge-style: github :source-language: python :icons: font -:homepage: https://zipcodewilmington.com/pyprep +:homepage: https://zipcodewilmington.com :pdf-page-size: [7.0in, 9.0in] :toc: From 76405a3d6e42689321976d2336daa83f838595e7 Mon Sep 17 00:00:00 2001 From: Kristofer Date: Mon, 5 Oct 2026 10:44:54 -0400 Subject: [PATCH 11/12] adds v2 cover --- PythonBookv2-cover.pages | Bin 0 -> 405643 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100755 PythonBookv2-cover.pages diff --git a/PythonBookv2-cover.pages b/PythonBookv2-cover.pages new file mode 100755 index 0000000000000000000000000000000000000000..d172d59ffc59179cff21aa0d85bdebe436f386df GIT binary patch literal 405643 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

qnarO9My;^H!w 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ΚJ$<`vP{ww$!u1@b4MCfNu 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 literal 0 HcmV?d00001 From c25da38d7435880e66734c750fbf1493febdedaf Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Mon, 5 Oct 2026 15:19:42 +0000 Subject: [PATCH 12/12] Add Python mixins chapter Co-authored-by: kristofer <17994+kristofer@users.noreply.github.com> --- index.adoc | 2 ++ mixins.adoc | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 61 insertions(+) create mode 100644 mixins.adoc diff --git a/index.adoc b/index.adoc index 5436ce4..9fc4567 100644 --- a/index.adoc +++ b/index.adoc @@ -204,6 +204,8 @@ include::iterators.adoc[] include::generators.adoc[] +include::mixins.adoc[] + include::appendixa.adoc[] include::appendixb.adoc[] diff --git a/mixins.adoc b/mixins.adoc new file mode 100644 index 0000000..cdcb381 --- /dev/null +++ b/mixins.adoc @@ -0,0 +1,59 @@ + +== Mixins + +Sometimes several classes need the same small piece of behavior. You could copy the same methods into each class, but then a change to that behavior means editing every copy. A *mixin* lets you write that behavior once and add it to classes through inheritance. + +A mixin is usually a small class that provides a focused capability. It is not generally meant to represent a complete thing on its own. For example, a mixin can give different kinds of objects the ability to take damage: + +[source] +---- +class DamageMixin: + def take_damage(self, amount): + self.health = max(0, self.health - amount) + +class Spacecraft: + def __init__(self, name, health): + self.name = name + self.health = health +---- + +`DamageMixin` defines a method that uses `self.health`. It does not create or set up that attribute; the class using the mixin is responsible for providing it. + +=== Combining Behaviors + +To add the mixin's behavior to `Spacecraft`, list it as a parent class: + +[source] +---- +class DamageMixin: + def take_damage(self, amount): + self.health = max(0, self.health - amount) + +class RepairMixin: + def repair(self, amount): + self.health = min(self.max_health, self.health + amount) + +class Spacecraft(DamageMixin, RepairMixin): + def __init__(self, name, health): + self.name = name + self.health = health + self.max_health = health + +enterprise = Spacecraft("Enterprise", 100) +enterprise.take_damage(30) +print(enterprise.health) # -> 70 + +enterprise.repair(10) +print(enterprise.health) # -> 80 +---- + +`Spacecraft` gets both `take_damage()` and `repair()` without defining either method itself. `DamageMixin` and `RepairMixin` each contribute a separate behavior, while `Spacecraft` supplies the data those behaviors need. + +Mixins work best when they stay focused and have clear expectations about what the class using them provides. If multiple parent classes define methods with the same name, Python's method resolution order determines which one is used. For now, give each mixin its own methods and avoid name clashes. + +[TIP] +==== +* Create an `InventoryMixin` with an `add_item(item)` method +* Add it to a `Player` class that initializes an empty `inventory` list +* Create a player, add two items, and print the inventory +====