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

Application factory pattern preview

📖 Scenario: You are building a simple Flask web app that can be created using a factory function. This pattern helps you make multiple app instances easily and keeps your code clean.

🎯 Goal: Create a Flask application using the application factory pattern. You will first set up the basic app creation function, then configure it, add a simple route, and finally run the app.

📋 What You'll Learn

Create a function called create_app that returns a Flask app instance

Inside create_app, create the Flask app with Flask(__name__)

Add a configuration variable DEBUG set to True inside create_app

Add a route / that returns the text 'Hello, Flask!'

Return the app instance from create_app

💡 Why This Matters

🌍 Real World

The application factory pattern is used in real Flask projects to create multiple app instances with different settings, useful for testing and deployment.

💼 Career

Understanding this pattern is important for backend developers working with Flask, as it is a common best practice in professional Flask applications.

1

Create the application factory function

Write a function called create_app that creates a Flask app instance with Flask(__name__) and returns it.

Flask

from flask import Flask

# Your code here

Hint

Remember to import Flask first. Then define create_app and create the app inside it.

2

Add configuration to the app

Inside the create_app function, add a configuration variable DEBUG set to True on the app.config dictionary.

Flask

from flask import Flask

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

Hint

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

3

Add a route to the app

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 route for '/' here
    # Your code here
    return app

Hint

Use the @app.route('/') decorator and define a function that returns the greeting.

4

Run the app using the factory

Outside the create_app function, create an app instance by calling create_app(). Then add the block if __name__ == '__main__': and inside it call app.run() to start the server.

Flask

from flask import Flask

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

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

    return app

# Your code here

Hint

Create the app by calling create_app() and run it inside the main guard.

Practice

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

easy

A. To avoid using blueprints and extensions

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

C. To automatically generate HTML templates

D. To create the Flask app inside a function for better configuration and testing

Solution

1. Step 1: Understand the pattern's purpose

   The application factory pattern creates the Flask app inside a function instead of a global variable.

2. Step 2: Benefits of this approach

   This allows flexible configuration, easier testing, and clean registration of extensions and blueprints.

3. Final Answer:

   To create the Flask app inside a function for better configuration and testing -> Option D

4. Quick Check:

   Application factory = create app in function [OK]

Hint: Remember: factory means 'make inside a function' [OK]

Common Mistakes:

• Thinking app is created globally
• Confusing with blueprint usage
• Assuming it auto-generates templates

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

easy

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

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 return Flask

Solution

1. Step 1: Check function definition and app creation

   The factory function must create a Flask instance inside it using Flask(__name__)

2. Step 2: Verify return of the app instance

   The function should return the created app instance, not the class or a global variable.

3. Final Answer:

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

4. Quick Check:

   Factory returns new Flask instance [OK]

Hint: Create and return app inside function with Flask(__name__) [OK]

Common Mistakes:

• Returning Flask class instead of instance
• Using global app outside function
• Not calling Flask with parentheses

3. Given this code snippet, 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. True

B. False

C. None

D. KeyError

Solution

1. Step 1: Analyze config setting inside factory

   The factory sets app.config['DEBUG'] = True before returning the app.

2. Step 2: Check printed value after app creation

   After calling create_app(), app.config['DEBUG'] is True, so printing it outputs True.

3. Final Answer:

   True -> Option A

4. Quick Check:

   Config set to True inside factory [OK]

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

Common Mistakes:

• Assuming default DEBUG is False
• Expecting KeyError for missing key
• Confusing config with environment variables

4. Identify the error in this application factory code:

def create_app():
    app = Flask(__name__)
    app.register_blueprint(main)
    return app

app = create_app()

Assume main is a blueprint imported correctly.

medium

A. No error, code is correct

B. Missing app context push before registering blueprint

C. Blueprint must be registered before app creation

D. Blueprint registration should happen inside a separate function

Solution

1. Step 1: Check blueprint registration timing

   Blueprints are registered on the app instance inside the factory function, which is correct.

2. Step 2: Verify app context and function structure

   No app context push is needed for registration; the code is valid and follows the pattern.

3. Final Answer:

   No error, code is correct -> Option A

4. Quick Check:

   Blueprint registered inside factory is valid [OK]

Hint: Register blueprints inside factory before returning app [OK]

Common Mistakes:

• Thinking app context is needed for registration
• Trying to register blueprint before app exists
• Separating registration unnecessarily

5. You want to add a Flask extension (e.g., Flask-Migrate) using the application factory pattern. Which approach is correct?

hard

A. Create the extension instance inside the factory function only

B. Initialize the extension globally, then call init_app(app) inside the factory

C. Initialize the extension after app creation outside the factory

D. Pass the app instance as a parameter to the extension constructor inside the factory

Solution

1. Step 1: Understand extension initialization pattern

   Extensions are usually created globally without app, then initialized with app inside the factory using init_app(app).

2. Step 2: Why not create inside factory?

   Creating inside factory loses global access; initializing outside factory after app creation breaks pattern.

3. Final Answer:

   Initialize the extension globally, then call init_app(app) inside the factory -> Option B

4. Quick Check:

   Global extension + init_app(app) inside factory [OK]

Hint: Create extension globally, init inside factory [OK]

Common Mistakes:

• Creating extension instance inside factory only
• Initializing extension outside factory after app creation
• Passing app to extension constructor inside factory