Merge branch 'master' of https://github.com/talkpython/100daysofweb-with-python-course

mikeckennedy · mikeckennedy · commit d0f67bf6684e · 2025-06-06T08:37:27.000-07:00
# Conflicts:
#	.gitignore
#	.idea/100web-course.iml
diff --git a/.gitignore b/.gitignore
@@ -174,3 +174,4 @@ days/013-016-css-basics/demos/selectorville/.idea/selectorville.iml
 days/041-044-react/**node_modules
 .idea/100web-course.iml
 .idea/ruff.xml
+ruff.xml
diff --git a/.idea/100web-course.iml b/.idea/100web-course.iml
diff --git a/.idea/ruff.xml b/.idea/ruff.xml
diff --git a/days/001-004-flask-intro/code/demo.py b/days/001-004-flask-intro/code/demo.py
@@ -1 +1 @@
-from program import app
+from program import app  # noqa: F401
diff --git a/days/001-004-flask-intro/code/program/__init__.py b/days/001-004-flask-intro/code/program/__init__.py
@@ -1,5 +1,6 @@
 from flask import Flask
+from program import routes  # noqa: F401
 
 app = Flask(__name__)
 
-from program import routes
+
diff --git a/days/001-004-flask-intro/code/requirements.piptools b/days/001-004-flask-intro/code/requirements.piptools
@@ -0,0 +1,7 @@
+click
+Flask
+itsdangerous
+Jinja2
+MarkupSafe
+python-dotenv
+werkzeug
diff --git a/days/001-004-flask-intro/code/requirements.txt b/days/001-004-flask-intro/code/requirements.txt
@@ -1,7 +1,33 @@
-click==6.7
-Flask==1.0.2
-itsdangerous==0.24
-Jinja2>=2.10.1
-MarkupSafe==1.0
-python-dotenv==0.9.1
-werkzeug>=0.15.3
+#
+# This file is autogenerated by pip-compile with Python 3.11
+# by the following command:
+#
+#    pip-compile requirements.piptools
+#
+blinker==1.7.0
+    # via flask
+click==8.1.7
+    # via
+    #   -r requirements.piptools
+    #   flask
+flask==3.0.0
+    # via -r requirements.piptools
+itsdangerous==2.1.2
+    # via
+    #   -r requirements.piptools
+    #   flask
+jinja2==3.1.2
+    # via
+    #   -r requirements.piptools
+    #   flask
+markupsafe==2.1.3
+    # via
+    #   -r requirements.piptools
+    #   jinja2
+    #   werkzeug
+python-dotenv==1.0.0
+    # via -r requirements.piptools
+werkzeug==3.0.1
+    # via
+    #   -r requirements.piptools
+    #   flask
diff --git a/days/005-008-html5/demos/yahoo_clone/.idea/dictionaries/mkennedy.xml b/days/005-008-html5/demos/yahoo_clone/.idea/dictionaries/mkennedy.xml
diff --git a/days/005-008-html5/demos/yahoo_clone/.idea/encodings.xml b/days/005-008-html5/demos/yahoo_clone/.idea/encodings.xml
diff --git a/days/009-012-modern-apis-with-fastapi/demo/main.py b/days/009-012-modern-apis-with-fastapi/demo/main.py
@@ -0,0 +1,46 @@
+from typing import Optional
+
+import fastapi
+import uvicorn
+
+api = fastapi.FastAPI()
+
+
+@api.get('/')
+def index():
+    body = "<html>" \
+           "<body style='padding: 10px;'>" \
+           "<h1>Welcome to the API</h1>" \
+           "<div>" \
+           "Try it: <a href='/api/calculate?x=7&y=11'>/api/calculate?x=7&y=11</a>" \
+           "</div>" \
+           "</body>" \
+           "</html>"
+
+    return fastapi.responses.HTMLResponse(content=body)
+
+
+@api.get('/api/calculate')
+def calculate(x: int, y: int, z: Optional[int] = None):
+    if z == 0:
+        return fastapi.responses.JSONResponse(
+            content={"error": "ERROR: Z cannot be zero."},
+            status_code=400)
+
+    value = x + y
+
+    if z is not None:
+        value /= z
+
+    return {
+        'x': x,
+        'y': y,
+        'z': z,
+        'value': value
+    }
+
+
+# uvicorn was updated, and it's type definitions don't match FastAPI,
+# but the server and code still work fine. So ignore PyCharm's warning:
+# noinspection PyTypeChecker
+uvicorn.run(api, port=8000, host="127.0.0.1")
diff --git a/days/009-012-modern-apis-with-fastapi/demo/requirements.txt b/days/009-012-modern-apis-with-fastapi/demo/requirements.txt
@@ -0,0 +1,3 @@
+fastapi
+uvicorn
+
diff --git a/days/009-012-modern-apis-with-fastapi/readme.md b/days/009-012-modern-apis-with-fastapi/readme.md
@@ -0,0 +1,98 @@
+# Days 09-12 Building APIs with FastAPI
+
+This exercise section is going to have you laughing, no doubt. You're going to use FastAPI to create an API that will return a random programming-related joke.
+
+---
+
+## Days 1-3: Watch the video lessons
+
+The first segment of this 4-day block is to watch the videos and study FastAPI. Consider downloading and trying out the [code sample developed during the course](https://github.com/talkpython/100daysofweb-with-python-course/tree/master/days/009-012-modern-apis-with-fastapi/demo).
+
+## Day 4: Funny Business
+
+Now you have seen the videos from this chapter, you're ready to build an API using FastAPI!
+
+We are going to use the [pyjokes](https://pyjok.es) package. This is usually marketed as a CLI tool to get a joke in your terminal. But it also [has an API](https://pyjok.es/api/). It's this API that we can use to build a joke API.
+
+###  Foundations
+
+Before we talk about the details of your journey, let me give you a couple of foundational concepts from FastAPI so that you don't need to search the web *too* much (programming always involves some searching or AI-asking).
+
+**FastAPI Starter Structure**
+
+Simple FastAPI apps usually look something like this:
+
+```python
+import fastapi
+import uvicorn
+
+api = fastapi.FastAPI()
+
+@api.get('/')
+def some_action():
+  return {"message": "Hello"}
+
+if __name__ == '__main__':
+  uvicorn.run(api, port=8001, host="127.0.0.1")
+```
+
+Incredible how simple these web apps are these days in their bare form.
+
+**Passing data to actions**
+
+The above api endpoint `some_action` is fun, but takes no data. If we wanted to pass a number, say `start_index`, we could do it like this using the `{}` wrappers in the URL:
+
+```python
+@api.get('/{start_index}')
+def some_action(start_index):
+```
+
+But this is a string and index implies an integer. We could parse it ourselves, but FastAPI does that for us with validation by simply specifying the type in code, some_action(start_index: **int**):
+
+```python
+@api.get('/{start_index}')
+def some_action(start_index: int):
+```
+
+**Constrained enums and string values**
+
+Finally, in this exercise, you'll work with a small set of valid string values. For example, the pyjokes methods take a `category` of **neutral**, **all**, or **chuck** (as in Norris). We can express that way better with an enum (StrEnum specifically). Note: This type is only available in Python 3.11 or higher.
+
+```python
+class JokeCategory(enum.StrEnum):
+    all = 'all'
+    chuck_norris = 'chuck'
+    neutral = 'neutral'
+```
+
+It's preferable to use this as the type in FastAPI because FastAPI will automatically reject all inputs that are not one of those three string values.
+
+### Your Joke API
+
+Use what we've given you above along with `pyjokes`, which you'll need to install as a dependency along with fastapi and uvicorn, to build a FastAPI that will listen at the URLs:
+
+- `http://127.0.0.1:8001/api/laugh/chuck/en`
+- `http://127.0.0.1:8001/api/laugh/neutral/en`
+- `http://127.0.0.1:8001/api/laugh/chuck/es`
+
+Passing in both the category and language (again see [the pyjokes API](https://pyjok.es/api/) for how to use it and valid inputs).
+
+The response should be a JSON value such as:
+
+```json
+{
+  "category": "chuck",
+  "language": "en",
+  "joke": "Every SQL statement that Chuck Norris codes has an implicit 'COMMIT' in its end."
+}
+```
+
+Be creative, explore and have fun. Remember: _the learning is in the practice_.
+
+### Time to share what you've accomplished!
+
+Be sure to share your last couple of days work on Twitter or Facebook. Use the hashtag **#100DaysOfWeb**. 
+
+Here are [some examples](https://twitter.com/search?q=%23100DaysOfCode) to inspire you. Consider including [@talkpython](https://twitter.com/talkpython) and [@pybites](https://twitter.com/pybites) in your tweets.
+
+*See a mistake in these instructions? Please [submit a new issue](https://github.com/talkpython/100daysofweb-with-python-course/issues) or fix it and [submit a PR](https://github.com/talkpython/100daysofweb-with-python-course/pulls).*

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-from program import app`
	`1`	`+from program import app # noqa: F401`