import pathlib from typing import Any, Literal, Self from cryptography.hazmat.backends import default_backend from cryptography.hazmat.primitives import serialization from fansifter_common.adapters.snowflake.converter import SnowflakeConverter from fansifter_common.constants import PROD_ENVIRONMENT, QA_ENVIRONMENT from fansifter_common.utils.functional import lazy_proxy from pydantic import Field, SecretStr, ValidationError, model_validator from pydantic_settings import BaseSettings, SettingsConfigDict class Settings(BaseSettings): # Main environment: str debug: bool = Field(validation_alias="APP_DEBUG", default=False) run_from_cli: bool = Field(validation_alias="APP_RUN_FROM_CLI", default=False) # Directories base_dir: pathlib.Path = pathlib.Path(__file__).resolve().parent root_dir: pathlib.Path = base_dir.parent # Service service_name: str = "ows-preference-center" service_version: str = "1.0.0" # AWS region aws_region_name: str = "us-east-1" # Snowflake settings snowflake_account: str = "account" snowflake_database: str = "database" snowflake_schema: str = "schema" snowflake_warehouse: str = "warehouse" snowflake_role: str = "role" snowflake_user: str = "user" snowflake_password: SecretStr | None = None snowflake_port: int = 443 snowflake_url: str = "" @model_validator(mode="after") def _setup_snowflake_url(self) -> Any: from snowflake.sqlalchemy import URL self.snowflake_url = URL( account=self.snowflake_account, user=self.snowflake_user, database=self.snowflake_database, schema=self.snowflake_schema, warehouse=self.snowflake_warehouse, role=self.snowflake_role, client_session_keep_alive=True, ) return self # Snowflake pool settings snowflake_echo: bool = False snowflake_pool_size: int = 10 snowflake_pool_max_overflow: int = 20 snowflake_pool_recycle: int = 4 * 55 * 60 # ~4 hours snowflake_pool_pre_ping: bool = False snowflake_pool_reset_on_return: Literal["commit", "rollback"] | None = None default_snowflake_private_key_path: pathlib.Path = ( pathlib.Path.home() / ".ssh/snowflake/rsa_key.p8" ) snowflake_private_key_path: pathlib.Path = default_snowflake_private_key_path snowflake_private_key: bytes = b"" snowflake_key_passphrase: bytes = b"" snowflake_connect_args: dict[str, Any] = { "converter_class": SnowflakeConverter, } @model_validator(mode="after") def _setup_snowflake_connect_args(self) -> Any: if self.environment == "test": return self # Load private key if not set and path exists if not self.snowflake_private_key and self.snowflake_private_key_path.exists(): self.snowflake_private_key = self.snowflake_private_key_path.read_bytes() # Check if private key and passphrase are set in QA/PROD environment if self.environment in (QA_ENVIRONMENT, PROD_ENVIRONMENT) and ( not self.snowflake_key_passphrase or not self.snowflake_private_key ): raise ValueError( "Snowflake private key passphrase and path must be set in " "QA/PROD environment." ) # Load private key if self.snowflake_private_key: pem_private_key = serialization.load_pem_private_key( self.snowflake_private_key, password=self.snowflake_key_passphrase or None, backend=default_backend(), ) private_key = pem_private_key.private_bytes( encoding=serialization.Encoding.DER, format=serialization.PrivateFormat.PKCS8, encryption_algorithm=serialization.NoEncryption(), ) self.snowflake_connect_args["private_key"] = private_key return self # ORM orm_models: list[str] = ["preference_center.profile.models"] # Redis redis_host: str = "localhost" redis_port: int = 6379 redis_ssl: bool = False @model_validator(mode="after") def _setup_redis_ssl(self) -> Self: if self.environment in [QA_ENVIRONMENT, PROD_ENVIRONMENT]: self.redis_ssl = True return self # Cache cache_backend: str = "locmem" cache_default_timeout: int = 300 cache_key_prefix: str = "ows-preference-center:" cache_redis_db: int = 0 @model_validator(mode="after") def _setup_cache_backend(self) -> Self: if self.environment in [QA_ENVIRONMENT, PROD_ENVIRONMENT]: self.cache_backend = "redis" return self # Kafka kafka_bootstrap_servers: str = "localhost:29092" kafka_use_ssl: bool = False kafka_topic_fan_update: str = "event.owsPreferenceCenter.fanUpdate" kafka_topic_fan_delete: str = "event.owsPreferenceCenter.fanDelete" kafka_topic_fan_subscriptions_update: str = ( "event.owsPreferenceCenter.fanSubscriptionsUpdate" ) kafka_topic_songwhip_fan_consent_double_opt_in: str = ( "event.songwhip.fan.consent.doubleOptIn" ) kafka_topic_double_opt_in: str = "event.owsPreferenceCenter.doubleOptInConfirmation" @model_validator(mode="after") def _kafka_use_ssl(self) -> Self: if self.environment in [QA_ENVIRONMENT, PROD_ENVIRONMENT]: self.kafka_use_ssl = True return self # API jwt_auth_enabled: bool = False @model_validator(mode="after") def _setup_jwt_auth_enabled(self) -> Self: if self.environment == PROD_ENVIRONMENT: self.jwt_auth_enabled = True return self jwt_auth_exclude_paths: list[str] = [ "/hello/", "/redoc", "/docs*", "/openapi.json", ] # OpenAPI / Swagger qa_server_url: str = "https://qa-ows-preference-center.theorchard.io" openapi_url: str | None = "/openapi.json" @model_validator(mode="after") def _setup_openapi_url(self) -> Self: if self.environment == PROD_ENVIRONMENT: self.openapi_url = None return self openapi_filepath: pathlib.Path = root_dir / "spec/ows_preference_center-1.0.0.yaml" openapi_servers: list[dict[str, Any]] | None = None @model_validator(mode="after") def _setup_openapi_servers(self) -> Self: if self.environment == "dev" and self.run_from_cli: self.openapi_servers = [{"url": self.qa_server_url}] return self # Debug include_debug_router: bool = True @model_validator(mode="after") def _setup_include_debug_router(self) -> Self: if self.environment == PROD_ENVIRONMENT or self.run_from_cli: self.include_debug_router = False return self # Encrypter secret_key: SecretStr # Location restricted_date_of_birth_countries: list[str] = ["US"] # Profiles / subscription cache settings profile_cache_prefix: str = "profile:v4" profile_cache_timeout: int = 60 * 10 # 10 minutes subscription_cache_prefix: str = "subscription:v4" subscription_cache_timeout: int = 60 * 10 # 10 minutes # Logging logging_debug: bool = Field(validation_alias="LOGGING_DEBUG", default=False) @property def logging_config(self) -> dict[str, Any]: return { "version": 1, "disable_existing_loggers": True, "formatters": { "json": { "()": "owslogger.logger.DDJsonFormatter", "service_name": self.service_name, "service_version": self.service_version, "env": self.environment, }, "console": { "()": "fansifter_common.logging.ConsoleFormatter", }, }, "filters": { "require_debug_true": { "()": "fansifter_common.logging.RequireDebugTrueFilter", "value": self.logging_debug, }, "require_debug_false": { "()": "fansifter_common.logging.RequireDebugFalseFilter", "value": self.logging_debug, }, }, "handlers": { "stream": { "level": "INFO", "class": "logging.StreamHandler", "formatter": "json", "filters": ["require_debug_false"], }, "rich": { "level": "INFO", "class": "rich.logging.RichHandler", "filters": ["require_debug_true"], "formatter": "console", }, "null": { "level": "INFO", "class": "logging.NullHandler", }, }, "loggers": { "preference_center": { "handlers": ["stream", "rich"], "level": "INFO", "propagate": False, }, "sqlalchemy.engine": { "handlers": ["stream", "rich"], "level": "WARNING", "propagate": False, }, "confluent_kafka": { "handlers": ["stream", "rich"], "level": "INFO", "propagate": False, }, "uvicorn": { "handlers": ["stream", "rich"], "level": "INFO", "propagate": False, }, "uvicorn.access": { "handlers": ["null"], "level": "INFO", "propagate": False, }, "anydi": { "handlers": ["stream", "rich"], "level": "WARNING", "propagate": False, }, }, } # Sentry sentry_dsn: str | None @model_validator(mode="after") def _setup_sentry_dsn(self) -> Any: if not self.sentry_dsn and self.environment in [ QA_ENVIRONMENT, PROD_ENVIRONMENT, ]: raise ValueError(f"Sentry is not configured in {self.environment}.") return self model_config = SettingsConfigDict( env_file=".env", env_file_encoding="utf-8", case_sensitive=False, extra="allow", ) def setup_settings(**defaults: Any) -> Settings: """Setup the application settings.""" try: return Settings(**defaults) except ValidationError as exc: errors = "\n".join( [ f" * {'.'.join(map(str, error['loc']))} - {error['msg']}" for error in exc.errors() ] ) raise RuntimeError(f"Failed to initialize settings:\n {errors}") from exc # Lazy proxy for settings settings = lazy_proxy(setup_settings)