Merge pull request #77 from tecladocode/jose/cou-141-update-rest-api-ebook-to-remove

jslvtr · web-flow · commit 3f3f278f3f79 · 2022-10-03T14:27:07.000+01:00
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/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/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/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/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/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/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/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/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/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/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/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/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/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)
diff --git a/docs/docs/07_sqlalchemy_many_to_many/03_many_to_many_relationships/end/app.py b/docs/docs/07_sqlalchemy_many_to_many/03_many_to_many_relationships/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/03_many_to_many_relationships/start/app.py b/docs/docs/07_sqlalchemy_many_to_many/03_many_to_many_relationships/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/08_flask_jwt_extended/04_flask_jwt_extended_setup/README.md b/docs/docs/08_flask_jwt_extended/04_flask_jwt_extended_setup/README.md
@@ -51,8 +51,7 @@ def create_app(db_url=None):
     jwt = JWTManager(app)
     # highlight-end
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         import models  # noqa: F401
 
         db.create_all()
@@ -68,4 +67,4 @@ def create_app(db_url=None):
 The secret key set here, `"jose"`, is **not very safe**.
 
 Instead you should generate a long and random secret key using something like `secrets.SystemRandom().getrandbits(128)`.
-:::
+:::
diff --git a/docs/docs/08_flask_jwt_extended/04_flask_jwt_extended_setup/end/app.py b/docs/docs/08_flask_jwt_extended/04_flask_jwt_extended_setup/end/app.py
@@ -28,8 +28,7 @@ def create_app(db_url=None):
     app.config["JWT_SECRET_KEY"] = "jose"
     jwt = JWTManager(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         import models  # noqa: F401
 
         db.create_all()
diff --git a/docs/docs/08_flask_jwt_extended/04_flask_jwt_extended_setup/start/app.py b/docs/docs/08_flask_jwt_extended/04_flask_jwt_extended_setup/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():
         import models  # noqa: F401
 
         db.create_all()
diff --git a/docs/docs/08_flask_jwt_extended/05_user_model_and_schema/end/app.py b/docs/docs/08_flask_jwt_extended/05_user_model_and_schema/end/app.py
@@ -28,8 +28,7 @@ def create_app(db_url=None):
     app.config["JWT_SECRET_KEY"] = "jose"
     jwt = JWTManager(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         import models  # noqa: F401
 
         db.create_all()
diff --git a/docs/docs/08_flask_jwt_extended/05_user_model_and_schema/start/app.py b/docs/docs/08_flask_jwt_extended/05_user_model_and_schema/start/app.py
@@ -28,8 +28,7 @@ def create_app(db_url=None):
     app.config["JWT_SECRET_KEY"] = "jose"
     jwt = JWTManager(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         import models  # noqa: F401
 
         db.create_all()
diff --git a/docs/docs/08_flask_jwt_extended/06_registering_users_rest_api/end/app.py b/docs/docs/08_flask_jwt_extended/06_registering_users_rest_api/end/app.py
@@ -29,8 +29,7 @@ def create_app(db_url=None):
     app.config["JWT_SECRET_KEY"] = "jose"
     jwt = JWTManager(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         import models  # noqa: F401
 
         db.create_all()
diff --git a/docs/docs/08_flask_jwt_extended/06_registering_users_rest_api/start/app.py b/docs/docs/08_flask_jwt_extended/06_registering_users_rest_api/start/app.py
@@ -28,8 +28,7 @@ def create_app(db_url=None):
     app.config["JWT_SECRET_KEY"] = "jose"
     jwt = JWTManager(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         import models  # noqa: F401
 
         db.create_all()
diff --git a/docs/docs/08_flask_jwt_extended/07_login_users_rest_api/end/app.py b/docs/docs/08_flask_jwt_extended/07_login_users_rest_api/end/app.py
@@ -29,8 +29,7 @@ def create_app(db_url=None):
     app.config["JWT_SECRET_KEY"] = "jose"
     jwt = JWTManager(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         import models  # noqa: F401
 
         db.create_all()
diff --git a/docs/docs/08_flask_jwt_extended/07_login_users_rest_api/start/app.py b/docs/docs/08_flask_jwt_extended/07_login_users_rest_api/start/app.py
@@ -29,8 +29,7 @@ def create_app(db_url=None):
     app.config["JWT_SECRET_KEY"] = "jose"
     jwt = JWTManager(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         import models  # noqa: F401
 
         db.create_all()
diff --git a/docs/docs/08_flask_jwt_extended/08_protect_resources_with_jwt_required/end/app.py b/docs/docs/08_flask_jwt_extended/08_protect_resources_with_jwt_required/end/app.py
@@ -68,8 +68,7 @@ def revoked_token_callback(jwt_header, jwt_payload):
 
     # JWT configuration ends
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         import models  # noqa: F401
 
         db.create_all()
diff --git a/docs/docs/08_flask_jwt_extended/08_protect_resources_with_jwt_required/start/app.py b/docs/docs/08_flask_jwt_extended/08_protect_resources_with_jwt_required/start/app.py
@@ -29,8 +29,7 @@ def create_app(db_url=None):
     app.config["JWT_SECRET_KEY"] = "jose"
     jwt = JWTManager(app)
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         import models  # noqa: F401
 
         db.create_all()
diff --git a/docs/docs/08_flask_jwt_extended/09_jwt_claims_and_authorization/end/app.py b/docs/docs/08_flask_jwt_extended/09_jwt_claims_and_authorization/end/app.py
@@ -75,8 +75,7 @@ def revoked_token_callback(jwt_header, jwt_payload):
 
     # JWT configuration ends
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         import models  # noqa: F401
 
         db.create_all()
diff --git a/docs/docs/08_flask_jwt_extended/09_jwt_claims_and_authorization/start/app.py b/docs/docs/08_flask_jwt_extended/09_jwt_claims_and_authorization/start/app.py
@@ -68,8 +68,7 @@ def revoked_token_callback(jwt_header, jwt_payload):
 
     # JWT configuration ends
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         import models  # noqa: F401
 
         db.create_all()
diff --git a/docs/docs/08_flask_jwt_extended/10_logout_users_rest_api/end/app.py b/docs/docs/08_flask_jwt_extended/10_logout_users_rest_api/end/app.py
@@ -80,8 +80,7 @@ def revoked_token_callback(jwt_header, jwt_payload):
 
     # JWT configuration ends
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         import models  # noqa: F401
 
         db.create_all()
diff --git a/docs/docs/08_flask_jwt_extended/10_logout_users_rest_api/start/app.py b/docs/docs/08_flask_jwt_extended/10_logout_users_rest_api/start/app.py
@@ -66,8 +66,7 @@ def missing_token_callback(error):
 
     # JWT configuration ends
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         import models  # noqa: F401
 
         db.create_all()
diff --git a/docs/docs/08_flask_jwt_extended/12_token_refreshing_flask_jwt_extended/end/app.py b/docs/docs/08_flask_jwt_extended/12_token_refreshing_flask_jwt_extended/end/app.py
@@ -92,8 +92,7 @@ def revoked_token_callback(jwt_header, jwt_payload):
 
     # JWT configuration ends
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         import models  # noqa: F401
 
         db.create_all()
diff --git a/docs/docs/08_flask_jwt_extended/12_token_refreshing_flask_jwt_extended/start/app.py b/docs/docs/08_flask_jwt_extended/12_token_refreshing_flask_jwt_extended/start/app.py
@@ -80,8 +80,7 @@ def revoked_token_callback(jwt_header, jwt_payload):
 
     # JWT configuration ends
 
-    @app.before_first_request
-    def create_tables():
+    with app.app_context():
         import models  # noqa: F401
 
         db.create_all()
diff --git a/docs/docs/09_flask_migrate/02_add_flask_migrate_to_app/README.md b/docs/docs/09_flask_migrate/02_add_flask_migrate_to_app/README.md
@@ -9,7 +9,7 @@ Adding Flask-Migrate to our app is simple, just install it and add a couple line
 
 To install:
 
-```
+```bash
 pip install flask-migrate
 ```
 
@@ -33,7 +33,6 @@ migrate = Migrate(app, db)
 # highlight-end
 api = Api(app)
 
-@app.before_first_request
-def create_tables():
+with app.app_context():
     db.create_all()
-```
+```
diff --git a/project/04-items-stores-smorest-sqlalchemy/app.py b/project/04-items-stores-smorest-sqlalchemy/app.py
diff --git a/project/05-add-many-to-many/app.py b/project/05-add-many-to-many/app.py
diff --git a/project/06-add-db-migrations/app.py b/project/06-add-db-migrations/app.py
diff --git a/project/using-flask-restful/app.py b/project/using-flask-restful/app.py
diff --git a/project/using-flask-restx/app.py b/project/using-flask-restx/app.py
diff --git a/project/using-flask-smorest-docker b/project/using-flask-smorest-docker
diff --git a/project/using-flask-smorest/app.py b/project/using-flask-smorest/app.py
