Merge pull request #60 from tecladocode/jose/recording-improvements-a…

…ug-22

docs/docs/01_course_intro/04_what_is_rest_api/README.md

@@ -62,9 +62,9 @@ That data might look like this:
 
 ### The purpose of APIs
 
-Okay, we've learned that we can make a Flask app and expose certain functions to the public by using endpoints. Clients can then make requests (we'll learn how later), and get data.
+We've learned that we can make a Flask app and expose certain functions to the public by using endpoints. Clients can then make requests (we'll learn how later), and get data.
 
-Clients can also send data, which the functions can use.
+Clients can also send data, which the Flask functions can use.
 
 But _why_? If you want to use certain functions, why not just code them in your application?
 
@@ -74,10 +74,14 @@ Let's say you want to build a weather app.
 
 You could try to install sensors at the top of your house, connect them directly to the computer running your code, and then offer weather info based on what the sensors say...
 
-Or you could request weather data from the OpenWeatherMap API, just as tens of thousands of other devices do. 
+Or you could request weather data from the OpenWeatherMap API, just as tens of thousands of other devices do.
 
 Much easier, and all you have to do is make a request to the API!
 
+### What is a client?
+
+An API client can be any device, such as a web app or a mobile app.
+
 ### Making an API for your own consumption
 
 Make software companies make APIs that only they use (so they aren't fully public).

docs/docs/06_sql_storage_sqlalchemy/02_create_simple_sqlalchemy_model/end/models/item.py

@@ -5,6 +5,6 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
     store_id = db.Column(db.Integer, unique=False, nullable=False)

docs/docs/06_sql_storage_sqlalchemy/03_one_to_many_relationships_sqlalchemy/end/models/item.py

@@ -5,7 +5,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(

docs/docs/06_sql_storage_sqlalchemy/03_one_to_many_relationships_sqlalchemy/start/models/item.py

@@ -5,6 +5,6 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
     store_id = db.Column(db.Integer, unique=False, nullable=False)

docs/docs/06_sql_storage_sqlalchemy/04_configure_flask_sqlalchemy/end/models/item.py

@@ -5,7 +5,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(

docs/docs/06_sql_storage_sqlalchemy/04_configure_flask_sqlalchemy/start/models/item.py

@@ -5,7 +5,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(

docs/docs/06_sql_storage_sqlalchemy/05_insert_models_sqlalchemy/README.md

@@ -14,6 +14,13 @@ description: Learn how to use SQLAlchemy to add new rows to our SQL database.
 Inserting models with SQLAlchemy couldn't be easier! We'll use the `db.session`[^1] variable to `.add()` a model. Let's begin working on our `Item` resource:
 
 ```python title="resources/item.py"
+from sqlalchemy.exc import SQLAlchemyError
+
+from db import db
+from models import ItemModel
+
+...
+
 @blp.arguments(ItemSchema)
 @blp.response(201, ItemSchema)
 def post(self, item_data):
@@ -31,6 +38,13 @@ def post(self, item_data):
 Similarly in our `Store` resource:
 
 ```python title="resources/store.py"
+from sqlalchemy.exc import SQLAlchemyError, IntegrityError
+
+from db import db
+from models import StoreModel
+
+...
+
 @blp.arguments(StoreSchema)
 @blp.response(201, StoreSchema)
 def post(self, store_data):

docs/docs/06_sql_storage_sqlalchemy/05_insert_models_sqlalchemy/end/models/item.py

@@ -5,7 +5,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(

docs/docs/06_sql_storage_sqlalchemy/05_insert_models_sqlalchemy/start/models/item.py

@@ -5,7 +5,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(

docs/docs/06_sql_storage_sqlalchemy/06_get_models_or_404/end/models/item.py

@@ -5,7 +5,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(

docs/docs/06_sql_storage_sqlalchemy/06_get_models_or_404/end/resources/item.py

@@ -23,7 +23,7 @@ def delete(self, item_id):
     @blp.arguments(ItemUpdateSchema)
     @blp.response(200, ItemSchema)
     def put(self, item_data, item_id):
-        item = ItemModel.query.get_or_404(item_id)
+        item = ItemModel.query.get(item_id)
 
         raise NotImplementedError("Updating an item is not implemented.")
 

docs/docs/06_sql_storage_sqlalchemy/06_get_models_or_404/start/models/item.py

@@ -5,7 +5,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(

docs/docs/06_sql_storage_sqlalchemy/07_updating_models_sqlalchemy/README.md

@@ -21,17 +21,17 @@ This idempotency is frequently seen with `PUT` requests. You can see it in actio
 @blp.arguments(ItemUpdateSchema)
 @blp.response(200, ItemSchema)
 def put(self, item_data, item_id):
-    item = ItemModel.query.get_or_404(item_id)
     # highlight-start
+    item = ItemModel.query.get(item_id)
     if item:
         item.price = item_data["price"]
         item.name = item_data["name"]
     else:
-        item = ItemModel(**item_data)
+        item = ItemModel(id=item_id, **item_data)
 
     db.session.add(item)
     db.session.commit()
 
     return item
     # highlight-end
-```
+```

docs/docs/06_sql_storage_sqlalchemy/07_updating_models_sqlalchemy/end/models/item.py

@@ -5,7 +5,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(

docs/docs/06_sql_storage_sqlalchemy/07_updating_models_sqlalchemy/end/resources/item.py

@@ -23,13 +23,13 @@ def delete(self, item_id):
     @blp.arguments(ItemUpdateSchema)
     @blp.response(200, ItemSchema)
     def put(self, item_data, item_id):
-        item = ItemModel.query.get_or_404(item_id)
+        item = ItemModel.query.get(item_id)
 
         if item:
             item.price = item_data["price"]
             item.name = item_data["name"]
         else:
-            item = ItemModel(**item_data)
+            item = ItemModel(id=item_id, **item_data)
 
         db.session.add(item)
         db.session.commit()

docs/docs/06_sql_storage_sqlalchemy/07_updating_models_sqlalchemy/start/models/item.py

@@ -5,7 +5,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(

docs/docs/06_sql_storage_sqlalchemy/07_updating_models_sqlalchemy/start/resources/item.py

@@ -23,7 +23,7 @@ def delete(self, item_id):
     @blp.arguments(ItemUpdateSchema)
     @blp.response(200, ItemSchema)
     def put(self, item_data, item_id):
-        item = ItemModel.query.get_or_404(item_id)
+        item = ItemModel.query.get(item_id)
 
         raise NotImplementedError("Updating an item is not implemented.")
 

docs/docs/06_sql_storage_sqlalchemy/08_retrieve_list_all_models/end/models/item.py

@@ -5,7 +5,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(

docs/docs/06_sql_storage_sqlalchemy/08_retrieve_list_all_models/end/resources/item.py

@@ -23,13 +23,13 @@ def delete(self, item_id):
     @blp.arguments(ItemUpdateSchema)
     @blp.response(200, ItemSchema)
     def put(self, item_data, item_id):
-        item = ItemModel.query.get_or_404(item_id)
+        item = ItemModel.query.get(item_id)
 
         if item:
             item.price = item_data["price"]
             item.name = item_data["name"]
         else:
-            item = ItemModel(**item_data)
+            item = ItemModel(id=item_id, **item_data)
 
         db.session.add(item)
         db.session.commit()

docs/docs/06_sql_storage_sqlalchemy/08_retrieve_list_all_models/start/models/item.py

@@ -5,7 +5,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(

docs/docs/06_sql_storage_sqlalchemy/08_retrieve_list_all_models/start/resources/item.py

@@ -23,13 +23,13 @@ def delete(self, item_id):
     @blp.arguments(ItemUpdateSchema)
     @blp.response(200, ItemSchema)
     def put(self, item_data, item_id):
-        item = ItemModel.query.get_or_404(item_id)
+        item = ItemModel.query.get(item_id)
 
         if item:
             item.price = item_data["price"]
             item.name = item_data["name"]
         else:
-            item = ItemModel(**item_data)
+            item = ItemModel(id=item_id, **item_data)
 
         db.session.add(item)
         db.session.commit()

docs/docs/06_sql_storage_sqlalchemy/09_delete_models_sqlalchemy/end/models/item.py

@@ -5,7 +5,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(

docs/docs/06_sql_storage_sqlalchemy/09_delete_models_sqlalchemy/end/resources/item.py

@@ -25,13 +25,13 @@ def delete(self, item_id):
     @blp.arguments(ItemUpdateSchema)
     @blp.response(200, ItemSchema)
     def put(self, item_data, item_id):
-        item = ItemModel.query.get_or_404(item_id)
+        item = ItemModel.query.get(item_id)
 
         if item:
             item.price = item_data["price"]
             item.name = item_data["name"]
         else:
-            item = ItemModel(**item_data)
+            item = ItemModel(id=item_id, **item_data)
 
         db.session.add(item)
         db.session.commit()

docs/docs/06_sql_storage_sqlalchemy/09_delete_models_sqlalchemy/start/models/item.py

@@ -5,7 +5,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(

docs/docs/06_sql_storage_sqlalchemy/09_delete_models_sqlalchemy/start/resources/item.py

@@ -23,13 +23,13 @@ def delete(self, item_id):
     @blp.arguments(ItemUpdateSchema)
     @blp.response(200, ItemSchema)
     def put(self, item_data, item_id):
-        item = ItemModel.query.get_or_404(item_id)
+        item = ItemModel.query.get(item_id)
 
         if item:
             item.price = item_data["price"]
             item.name = item_data["name"]
         else:
-            item = ItemModel(**item_data)
+            item = ItemModel(id=item_id, **item_data)
 
         db.session.add(item)
         db.session.commit()

docs/docs/06_sql_storage_sqlalchemy/10_conclusion/README.md

@@ -30,7 +30,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(
@@ -92,6 +92,7 @@ class ItemSchema(PlainItemSchema):
 class ItemUpdateSchema(Schema):
     name = fields.Str()
     price = fields.Float()
+    store_id = fields.Int()
 
 
 class StoreSchema(PlainStoreSchema):

docs/docs/07_sqlalchemy_many_to_many/02_one_to_many_review/end/models/item.py

@@ -5,7 +5,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(

docs/docs/07_sqlalchemy_many_to_many/02_one_to_many_review/end/resources/item.py

@@ -25,13 +25,13 @@ def delete(self, item_id):
     @blp.arguments(ItemUpdateSchema)
     @blp.response(200, ItemSchema)
     def put(self, item_data, item_id):
-        item = ItemModel.query.get_or_404(item_id)
+        item = ItemModel.query.get(item_id)
 
         if item:
             item.price = item_data["price"]
             item.name = item_data["name"]
         else:
-            item = ItemModel(**item_data)
+            item = ItemModel(id=item_id, **item_data)
 
         db.session.add(item)
         db.session.commit()

docs/docs/07_sqlalchemy_many_to_many/02_one_to_many_review/start/models/item.py

@@ -5,7 +5,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(

docs/docs/07_sqlalchemy_many_to_many/02_one_to_many_review/start/resources/item.py

@@ -25,13 +25,13 @@ def delete(self, item_id):
     @blp.arguments(ItemUpdateSchema)
     @blp.response(200, ItemSchema)
     def put(self, item_data, item_id):
-        item = ItemModel.query.get_or_404(item_id)
+        item = ItemModel.query.get(item_id)
 
         if item:
             item.price = item_data["price"]
             item.name = item_data["name"]
         else:
-            item = ItemModel(**item_data)
+            item = ItemModel(id=item_id, **item_data)
 
         db.session.add(item)
         db.session.commit()

docs/docs/07_sqlalchemy_many_to_many/03_many_to_many_relationships/end/models/item.py

@@ -5,7 +5,7 @@ class ItemModel(db.Model):
     __tablename__ = "items"
 
     id = db.Column(db.Integer, primary_key=True)
-    name = db.Column(db.String(80), unique=True, nullable=False)
+    name = db.Column(db.String(80), unique=False, nullable=False)
     price = db.Column(db.Float(precision=2), unique=False, nullable=False)
 
     store_id = db.Column(