Merge pull request #87 from tecladocode/develop

tecladocode · Oct 20, 2022 · bd7d743 · bd7d743
2 parents a408f34 + 3ada848
commit bd7d743
Show file tree

Hide file tree

Showing 498 changed files with 12,905 additions and 159 deletions.
diff --git a/docs/docs/05_flask_smorest/02_data_model_improvements/README.md b/docs/docs/05_flask_smorest/02_data_model_improvements/README.md
@@ -108,14 +108,14 @@ Next, let's create the `.flaskenv` file:
 
 ```txt title=".flaskenv"
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
 ```
 
 If we have the `python-dotenv` library installed, when we run the `flask run` command, Flask will read the variables inside `.flaskenv` and use them to configure the Flask app.
 
-The configuration that we'll do is to define the Flask app file (here, `app.py`). Then we'll also set the Flask environment to `development`, which does a couple things:
+The configuration that we'll do is to define the Flask app file (here, `app.py`). Then we'll also set the `FLASK_DEBUG` flag to `True`, which does a couple things:
 
-- Sets debug mode to true, which makes the app give us better error messages
+- Makes the app give us better error messages and return a traceback when we make requests if there's an error.
 - Sets the app reloading to true, so the app restarts when we make code changes
 
 We don't want debug mode to be enabled in production (when we deploy our app), but while we're doing development it's definitely a time-saving tool!

diff --git a/docs/docs/05_flask_smorest/02_data_model_improvements/end/.flaskenv b/docs/docs/05_flask_smorest/02_data_model_improvements/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/05_flask_smorest/03_improvements_on_first_rest_api/end/.flaskenv b/docs/docs/05_flask_smorest/03_improvements_on_first_rest_api/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/05_flask_smorest/03_improvements_on_first_rest_api/start/.flaskenv b/docs/docs/05_flask_smorest/03_improvements_on_first_rest_api/start/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/05_flask_smorest/04_new_endpoints_for_api/end/.flaskenv b/docs/docs/05_flask_smorest/04_new_endpoints_for_api/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/05_flask_smorest/04_new_endpoints_for_api/start/.flaskenv b/docs/docs/05_flask_smorest/04_new_endpoints_for_api/start/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/05_flask_smorest/05_reload_api_docker_container/end/.flaskenv b/docs/docs/05_flask_smorest/05_reload_api_docker_container/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/05_flask_smorest/05_reload_api_docker_container/start/.flaskenv b/docs/docs/05_flask_smorest/05_reload_api_docker_container/start/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/05_flask_smorest/06_api_with_method_views/end/.flaskenv b/docs/docs/05_flask_smorest/06_api_with_method_views/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/05_flask_smorest/06_api_with_method_views/start/.flaskenv b/docs/docs/05_flask_smorest/06_api_with_method_views/start/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/05_flask_smorest/07_marshmallow_schemas/end/.flaskenv b/docs/docs/05_flask_smorest/07_marshmallow_schemas/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/05_flask_smorest/07_marshmallow_schemas/start/.flaskenv b/docs/docs/05_flask_smorest/07_marshmallow_schemas/start/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/05_flask_smorest/08_validation_with_marshmallow/end/.flaskenv b/docs/docs/05_flask_smorest/08_validation_with_marshmallow/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/05_flask_smorest/08_validation_with_marshmallow/start/.flaskenv b/docs/docs/05_flask_smorest/08_validation_with_marshmallow/start/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/05_flask_smorest/09_decorating_responses/end/.flaskenv b/docs/docs/05_flask_smorest/09_decorating_responses/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/05_flask_smorest/09_decorating_responses/start/.flaskenv b/docs/docs/05_flask_smorest/09_decorating_responses/start/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/02_create_simple_sqlalchemy_model/end/.flaskenv b/docs/docs/06_sql_storage_sqlalchemy/02_create_simple_sqlalchemy_model/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/02_create_simple_sqlalchemy_model/start/.flaskenv b/docs/docs/06_sql_storage_sqlalchemy/02_create_simple_sqlalchemy_model/start/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/03_one_to_many_relationships_sqlalchemy/end/.flaskenv b/docs/docs/06_sql_storage_sqlalchemy/03_one_to_many_relationships_sqlalchemy/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/03_one_to_many_relationships_sqlalchemy/start/.flaskenv b/docs/docs/06_sql_storage_sqlalchemy/03_one_to_many_relationships_sqlalchemy/start/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/04_configure_flask_sqlalchemy/README.md b/docs/docs/06_sql_storage_sqlalchemy/04_configure_flask_sqlalchemy/README.md
@@ -89,8 +89,7 @@ def create_app(db_url=None):
     api = Api(app)
 
     # highlight-start
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         db.create_all()
     # highlight-end
 
@@ -104,7 +103,7 @@ We've done three things:
 
 1. Added the `db_url` parameter. This lets us create an app with a certain database URL, or alternatively try to fetch the database URL from the environment variables. The default value will be a local SQLite file, if we don't pass a value ourselves and it isn't in the environment.
 2. Added two SQLAlchemy values to `app.config`. One is the database URL (or URI), the other is a [configuration option](https://flask-sqlalchemy.palletsprojects.com/en/2.x/config/) which improves performance.
-3. Registered a function to run before our Flask app handles its first request. The function will tell SQLAlchemy to use what it knows in order to create all the database tables we need.
+3. When the app is created, tell SQLAlchemy to create all the database tables we need.
 
 :::tip How does SQLAlchemy know what tables to create?
 The line `import models` lets SQLAlchemy know what models exist in our application. Because they are `db.Model` instances, SQLAlchemy will look at their `__tablename__` and defined `db.Column` attributes to create the tables.

diff --git a/docs/docs/06_sql_storage_sqlalchemy/04_configure_flask_sqlalchemy/end/.flaskenv b/docs/docs/06_sql_storage_sqlalchemy/04_configure_flask_sqlalchemy/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/04_configure_flask_sqlalchemy/end/app.py b/docs/docs/06_sql_storage_sqlalchemy/04_configure_flask_sqlalchemy/end/app.py
@@ -25,8 +25,7 @@ def create_app(db_url=None):
     db.init_app(app)
     api = Api(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         db.create_all()
 
     api.register_blueprint(ItemBlueprint)

diff --git a/docs/docs/06_sql_storage_sqlalchemy/04_configure_flask_sqlalchemy/start/.flaskenv b/docs/docs/06_sql_storage_sqlalchemy/04_configure_flask_sqlalchemy/start/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/05_insert_models_sqlalchemy/end/.flaskenv b/docs/docs/06_sql_storage_sqlalchemy/05_insert_models_sqlalchemy/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/05_insert_models_sqlalchemy/end/app.py b/docs/docs/06_sql_storage_sqlalchemy/05_insert_models_sqlalchemy/end/app.py
@@ -25,8 +25,7 @@ def create_app(db_url=None):
     db.init_app(app)
     api = Api(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         db.create_all()
 
     api.register_blueprint(ItemBlueprint)

diff --git a/docs/docs/06_sql_storage_sqlalchemy/05_insert_models_sqlalchemy/start/.flaskenv b/docs/docs/06_sql_storage_sqlalchemy/05_insert_models_sqlalchemy/start/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/05_insert_models_sqlalchemy/start/app.py b/docs/docs/06_sql_storage_sqlalchemy/05_insert_models_sqlalchemy/start/app.py
@@ -25,8 +25,7 @@ def create_app(db_url=None):
     db.init_app(app)
     api = Api(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         db.create_all()
 
     api.register_blueprint(ItemBlueprint)

diff --git a/docs/docs/06_sql_storage_sqlalchemy/06_get_models_or_404/end/.flaskenv b/docs/docs/06_sql_storage_sqlalchemy/06_get_models_or_404/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/06_get_models_or_404/end/app.py b/docs/docs/06_sql_storage_sqlalchemy/06_get_models_or_404/end/app.py
@@ -25,8 +25,7 @@ def create_app(db_url=None):
     db.init_app(app)
     api = Api(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         db.create_all()
 
     api.register_blueprint(ItemBlueprint)

diff --git a/docs/docs/06_sql_storage_sqlalchemy/06_get_models_or_404/start/.flaskenv b/docs/docs/06_sql_storage_sqlalchemy/06_get_models_or_404/start/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/06_get_models_or_404/start/app.py b/docs/docs/06_sql_storage_sqlalchemy/06_get_models_or_404/start/app.py
@@ -25,8 +25,7 @@ def create_app(db_url=None):
     db.init_app(app)
     api = Api(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         db.create_all()
 
     api.register_blueprint(ItemBlueprint)

diff --git a/docs/docs/06_sql_storage_sqlalchemy/07_updating_models_sqlalchemy/end/.flaskenv b/docs/docs/06_sql_storage_sqlalchemy/07_updating_models_sqlalchemy/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/07_updating_models_sqlalchemy/end/app.py b/docs/docs/06_sql_storage_sqlalchemy/07_updating_models_sqlalchemy/end/app.py
@@ -25,8 +25,7 @@ def create_app(db_url=None):
     db.init_app(app)
     api = Api(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         db.create_all()
 
     api.register_blueprint(ItemBlueprint)

diff --git a/docs/docs/06_sql_storage_sqlalchemy/07_updating_models_sqlalchemy/start/.flaskenv b/docs/docs/06_sql_storage_sqlalchemy/07_updating_models_sqlalchemy/start/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/07_updating_models_sqlalchemy/start/app.py b/docs/docs/06_sql_storage_sqlalchemy/07_updating_models_sqlalchemy/start/app.py
@@ -25,8 +25,7 @@ def create_app(db_url=None):
     db.init_app(app)
     api = Api(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         db.create_all()
 
     api.register_blueprint(ItemBlueprint)

diff --git a/docs/docs/06_sql_storage_sqlalchemy/08_retrieve_list_all_models/end/.flaskenv b/docs/docs/06_sql_storage_sqlalchemy/08_retrieve_list_all_models/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/08_retrieve_list_all_models/end/app.py b/docs/docs/06_sql_storage_sqlalchemy/08_retrieve_list_all_models/end/app.py
@@ -25,8 +25,7 @@ def create_app(db_url=None):
     db.init_app(app)
     api = Api(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         db.create_all()
 
     api.register_blueprint(ItemBlueprint)

diff --git a/docs/docs/06_sql_storage_sqlalchemy/08_retrieve_list_all_models/start/.flaskenv b/docs/docs/06_sql_storage_sqlalchemy/08_retrieve_list_all_models/start/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/08_retrieve_list_all_models/start/app.py b/docs/docs/06_sql_storage_sqlalchemy/08_retrieve_list_all_models/start/app.py
@@ -25,8 +25,7 @@ def create_app(db_url=None):
     db.init_app(app)
     api = Api(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         db.create_all()
 
     api.register_blueprint(ItemBlueprint)

diff --git a/docs/docs/06_sql_storage_sqlalchemy/09_delete_models_sqlalchemy/end/.flaskenv b/docs/docs/06_sql_storage_sqlalchemy/09_delete_models_sqlalchemy/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/09_delete_models_sqlalchemy/end/app.py b/docs/docs/06_sql_storage_sqlalchemy/09_delete_models_sqlalchemy/end/app.py
@@ -25,8 +25,7 @@ def create_app(db_url=None):
     db.init_app(app)
     api = Api(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         db.create_all()
 
     api.register_blueprint(ItemBlueprint)

diff --git a/docs/docs/06_sql_storage_sqlalchemy/09_delete_models_sqlalchemy/start/.flaskenv b/docs/docs/06_sql_storage_sqlalchemy/09_delete_models_sqlalchemy/start/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/06_sql_storage_sqlalchemy/09_delete_models_sqlalchemy/start/app.py b/docs/docs/06_sql_storage_sqlalchemy/09_delete_models_sqlalchemy/start/app.py
@@ -25,8 +25,7 @@ def create_app(db_url=None):
     db.init_app(app)
     api = Api(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         db.create_all()
 
     api.register_blueprint(ItemBlueprint)

diff --git a/docs/docs/07_sqlalchemy_many_to_many/02_one_to_many_review/README.md b/docs/docs/07_sqlalchemy_many_to_many/02_one_to_many_review/README.md
@@ -83,7 +83,6 @@ class TagSchema(PlainTagSchema):
 
 Let's add the Tag endpoints that aren't related to Items:
 
-
 | Method     | Endpoint              | Description                                             |
 | ---------- | --------------------- | ------------------------------------------------------- |
 | ✅ `GET`    | `/store/{id}/tag`     | Get a list of tags in a store.                          |
@@ -177,8 +176,7 @@ def create_app(db_url=None):
     db.init_app(app)
     api = Api(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         db.create_all()
 
     api.register_blueprint(ItemBlueprint)
@@ -188,4 +186,4 @@ def create_app(db_url=None):
     # highlight-end
 
     return app
-```
+```
diff --git a/docs/docs/07_sqlalchemy_many_to_many/02_one_to_many_review/end/.flaskenv b/docs/docs/07_sqlalchemy_many_to_many/02_one_to_many_review/end/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/07_sqlalchemy_many_to_many/02_one_to_many_review/end/app.py b/docs/docs/07_sqlalchemy_many_to_many/02_one_to_many_review/end/app.py
@@ -25,8 +25,7 @@ def create_app(db_url=None):
     db.init_app(app)
     api = Api(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         db.create_all()
 
     api.register_blueprint(ItemBlueprint)

diff --git a/docs/docs/07_sqlalchemy_many_to_many/02_one_to_many_review/start/.flaskenv b/docs/docs/07_sqlalchemy_many_to_many/02_one_to_many_review/start/.flaskenv
@@ -1,2 +1,2 @@
 FLASK_APP=app
-FLASK_ENV=development
+FLASK_DEBUG=True
diff --git a/docs/docs/07_sqlalchemy_many_to_many/02_one_to_many_review/start/app.py b/docs/docs/07_sqlalchemy_many_to_many/02_one_to_many_review/start/app.py
@@ -24,8 +24,7 @@ def create_app(db_url=None):
     db.init_app(app)
     api = Api(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         db.create_all()
 
     api.register_blueprint(ItemBlueprint)