Application factory pattern in Flask - Mini Project: Build & Apply

Flask Application Factory Pattern

📖 Scenario: You are building a simple Flask web app that can be easily configured and extended. To keep your app clean and organized, you will use the application factory pattern. This pattern helps you create Flask app instances with different settings.

🎯 Goal: Create a Flask app using the application factory pattern. You will start by setting up the app creation function, add configuration, register a simple route, and finally run the app.

📋 What You'll Learn

Create a function called create_app that returns a Flask app instance

Add a configuration setting DEBUG inside the app

Register a route / that returns the text Hello, Flask!

Run the app only if the script is executed directly

💡 Why This Matters

🌍 Real World

The application factory pattern is used in real Flask projects to create multiple app instances with different settings, such as testing, development, and production.

💼 Career

Understanding this pattern is important for backend developers working with Flask, as it helps write clean, scalable, and maintainable web applications.

1

Create the application factory function

Import Flask from flask and create a function called create_app that returns a new Flask app instance with the name __name__.

Flask

from flask import Flask

# Create the application factory function
# Your code here

Hint

Think of create_app as a factory that builds and returns a new Flask app each time you call it.

2

Add configuration to the app

Inside the create_app function, set the app's DEBUG configuration to True before returning the app.

Flask

from flask import Flask

def create_app():
    app = Flask(__name__)
    # Set DEBUG configuration to True
    # Your code here
    return app

Hint

Use app.config['DEBUG'] = True to enable debug mode.

3

Register a simple route

Inside the create_app function, add a route for / using @app.route('/'). Define a function called home that returns the string 'Hello, Flask!'.

Flask

from flask import Flask

def create_app():
    app = Flask(__name__)
    app.config['DEBUG'] = True

    # Add a route for '/' that returns 'Hello, Flask!'
    # Your code here

    return app

Hint

Use the @app.route decorator to create a URL route and a function that returns the text.

4

Run the app when executed directly

Outside the create_app function, add the standard Python check if __name__ == '__main__':. Inside it, call create_app() to get the app instance and run it with app.run().

Flask

from flask import Flask

def create_app():
    app = Flask(__name__)
    app.config['DEBUG'] = True

    @app.route('/')
    def home():
        return 'Hello, Flask!'

    return app

# Add code to run the app if this script is executed directly
# Your code here

Hint

This check ensures the app runs only when you run this file directly, not when imported.

Practice

1. What is the main purpose of the application factory pattern in Flask?

easy

A. To create the Flask app inside a function for better flexibility and configuration

B. To write all routes directly in the main script without functions

C. To avoid using blueprints in the application

D. To hardcode configuration values in the app instance

Solution

1. Step 1: Understand the pattern's purpose

   The application factory pattern creates the Flask app inside a function instead of globally. This allows creating multiple app instances with different settings.

2. Step 2: Compare options to the pattern's goal

   The other options contradict the flexibility and organization benefits of the pattern. Only "To create the Flask app inside a function for better flexibility and configuration" correctly describes the main purpose.

3. Final Answer:

   To create the Flask app inside a function for better flexibility and configuration -> Option A

4. Quick Check:

   Application factory = create app in function [OK]

Hint: Remember: factory means create inside a function [OK]

Common Mistakes:

• Thinking app is created globally, not inside a function
• Confusing blueprints with the factory pattern
• Assuming configuration is hardcoded, not flexible

2. Which of the following is the correct way to define an application factory function in Flask?

easy

A. def create_app():\n return Flask

B. app = Flask(__name__)\ndef create_app():\n return app

C. def create_app():\n app = Flask(__name__)\n return app

D. def create_app():\n app = Flask\n return app

Solution

1. Step 1: Check function definition and app creation

   def create_app():\n app = Flask(__name__)\n return app correctly defines a function named create_app that creates a Flask instance and returns it.

2. Step 2: Identify syntax errors or incorrect returns

   app = Flask(__name__)\ndef create_app():\n return app creates app outside the function, which is not factory pattern. def create_app():\n return Flask returns the Flask class, not an instance. def create_app():\n app = Flask\n return app tries to assign Flask class without parentheses, causing error.

3. Final Answer:

   def create_app():\n app = Flask(__name__)\n return app -> Option C

4. Quick Check:

   Factory function creates and returns app instance [OK]

Hint: Factory returns a new Flask instance inside a function [OK]

Common Mistakes:

• Returning the Flask class instead of an instance
• Creating app outside the factory function
• Missing parentheses when creating Flask instance

3. Given this code snippet using the application factory pattern, what will print(app.config['DEBUG']) output?

def create_app():
    app = Flask(__name__)
    app.config['DEBUG'] = True
    return app

app = create_app()
print(app.config['DEBUG'])

medium

A. False

B. True

C. None

D. KeyError

Solution

1. Step 1: Trace the factory function execution

   The function create_app creates a Flask app and sets app.config['DEBUG'] = True before returning the app.

2. Step 2: Check the printed config value

   After calling create_app(), the returned app has DEBUG set to True. So printing it outputs True.

3. Final Answer:

   True -> Option B

4. Quick Check:

   Config DEBUG set True, print shows True [OK]

Hint: Config set inside factory is available after creation [OK]

Common Mistakes:

• Assuming default DEBUG is False without setting
• Expecting KeyError if config key is missing (it's set here)
• Confusing app instance with factory function

4. Identify the error in this application factory code:

def create_app():
    app = Flask(__name__)
    @app.route('/')
    def home():
        return 'Hello'
    return app

app = create_app()
app.run()

medium

A. Missing parentheses in Flask constructor

B. Calling app.run() outside the factory is incorrect

C. Route decorator used incorrectly inside factory

D. No error; code runs correctly

Solution

1. Step 1: Review the factory function structure

   The function creates a Flask app, defines a route inside it, and returns the app instance.

2. Step 2: Check usage of app.run()

   Calling app.run() outside the factory is normal to start the server. The code is valid and will run correctly.

3. Final Answer:

   No error; code runs correctly -> Option D

4. Quick Check:

   Defining routes inside factory and running app outside is valid [OK]

Hint: Routes can be inside factory; run app after creation [OK]

Common Mistakes:

• Thinking app.run() must be inside factory
• Assuming route decorators can't be inside factory
• Confusing Flask constructor syntax

5. You want to create a Flask app using the application factory pattern that registers a blueprint and initializes an extension. Which code snippet correctly applies this pattern?

hard

A. def create_app():
app = Flask(__name__)
from .views import main_bp
app.register_blueprint(main_bp)
from flask_sqlalchemy import SQLAlchemy
db = SQLAlchemy()
db.init_app(app)
return app

B. app = Flask(__name__)
from .views import main_bp
app.register_blueprint(main_bp)
from flask_sqlalchemy import SQLAlchemy
db = SQLAlchemy(app)

C. def create_app():
app = Flask(__name__)
from .views import main_bp
app.register_blueprint(main_bp)
from flask_sqlalchemy import SQLAlchemy
db = SQLAlchemy(app)
return app

D. def create_app():
app = Flask(__name__)
from .views import main_bp
main_bp.register_blueprint(app)
from flask_sqlalchemy import SQLAlchemy
db = SQLAlchemy(app)
return app

Solution

1. Step 1: Understand blueprint registration

   Blueprints are registered on the app using app.register_blueprint(). Two options do this correctly, while one incorrectly calls main_bp.register_blueprint(app).

2. Step 2: Check extension initialization

   For extensions like SQLAlchemy, the recommended pattern is to instantiate the extension without the app (db = SQLAlchemy()) and then call db.init_app(app). The option that does db = SQLAlchemy(); db.init_app(app) follows this correctly. The other factory option with correct blueprint registration uses db = SQLAlchemy(app), which binds it directly to the app and is less flexible.

3. Final Answer:

   def create_app(): app = Flask(__name__) from .views import main_bp app.register_blueprint(main_bp) from flask_sqlalchemy import SQLAlchemy db = SQLAlchemy() db.init_app(app) return app -> Option A

4. Quick Check:

   Blueprint registered on app; extension initialized with init_app [OK]

Hint: Register blueprints on app; init extensions with init_app(app) [OK]

Common Mistakes:

• Registering blueprint on blueprint instead of app
• Creating extension with app inside factory instead of init_app
• Not importing blueprint inside factory function