# SPDX-FileCopyrightText: 2026 Dennis Fink # # SPDX-License-Identifier: BSD-3-Clause import logging import logging.handlers import os from pathlib import Path import coloredlogs from flask import Flask from flask_bootstrap import Bootstrap5 from flask_mail import Mail from flask_migrate import Migrate from flask_sqlalchemy import SQLAlchemy from flask_wtf.csrf import CSRFProtect from sqlalchemy.orm import DeclarativeBase from webmentions_ssg.config import DefaultConfig, DevelopmentConfig, ProductionConfig from .tasks import Huey APP_NAME = "webmentions-ssg" VERSION = "0.0.1" class Base(DeclarativeBase): pass CSRF = CSRFProtect() BOOTSTRAP = Bootstrap5() DATABASE = SQLAlchemy(model_class=Base) MIGRATE = Migrate() HUEY = Huey() MAIL = Mail() def create_app(config_class: type[DefaultConfig] | None = None) -> Flask: """ Create and configure the Flask application. The application configuration is selected based on the development environment unless an explicit configuration class is provided. Logging, extensions, authentication, Huey, blueprints, and CLI commands are then initialized. :param config_class: Configuration class to use, or ``None`` to select the development or production configuration automatically. :return: Configured Flask application. """ development = os.environ.get("WEBMENTIONS_SSG_DEV", "").lower() in { "1", "true", "yes", "on", } if config_class is None: config_class = DevelopmentConfig if development else ProductionConfig app = Flask( __name__, instance_path=str(Path("testing").absolute()) if development else None ) app.config.from_object(config_class) if not app.testing: app.config.from_pyfile(app.config["CONFIG_FILE"], silent=True) app.config.from_prefixed_env(prefix="FLASK") app.config.from_prefixed_env(prefix="WEBMENTIONS_SSG") default_logging_formatter = logging.Formatter(app.config["LOG_FORMAT"]) log_file_handler = logging.handlers.RotatingFileHandler( app.config["LOG_FILE"], maxBytes=app.config["LOGFILE_MAX_BYTES"], backupCount=app.config["LOGFILE_BACKUP_COUNT"], ) log_file_handler.setLevel(app.config["LOG_LEVEL"]) log_file_handler.setFormatter(default_logging_formatter) logging.basicConfig(level=logging.DEBUG, handlers=[logging.NullHandler()]) app.logger.handlers.clear() app.logger.setLevel(app.config["LOG_LEVEL"]) app.logger.addHandler(log_file_handler) werkzeug_logger = logging.getLogger("werkzeug") werkzeug_logger.setLevel(app.config["LOG_LEVEL"]) werkzeug_logger.addHandler(log_file_handler) coloredlogs.install( level=app.config["LOG_LEVEL"], logger=app.logger, fmt=app.config["LOG_FORMAT"] ) coloredlogs.install( level=app.config["LOG_LEVEL"], logger=werkzeug_logger, fmt=app.config["LOG_FORMAT"], ) DATABASE.init_app(app) MIGRATE.init_app( app, db=DATABASE, directory=str(Path(__file__).resolve().parent / "migrations"), command="migrate", ) CSRF.init_app(app) MAIL.init_app(app) from .auth import AUTH AUTH.init_app(app) BOOTSTRAP.init_app(app) HUEY.init_app(app) @app.context_processor def inject_version(): """ Add the application version to the template context. :return: Template context containing the application version. """ return {"VERSION": VERSION} from .views import root_page app.register_blueprint(root_page) from .cli.users import USERS_CLI app.cli.add_command(USERS_CLI) from .cli.mail import MAIL_CLI app.cli.add_command(MAIL_CLI) from .cli.database import DB_CLI app.cli.add_command(DB_CLI) return app