Skip to content

config

stac_fastapi.types.config

stac_fastapi.types.config module.

ApiSettings

Bases: BaseSettings

ApiSettings.

Defines api configuration, potentially through environment variables. See pydantic-docs.helpmanual.io/usage/settings/. Attributes: environment: name of the environment (ex. dev/prod). debug: toggles debug mode. forbidden_fields: set of fields defined by STAC but not included in the database. indexed_fields: set of fields which are usually in item.properties but are indexed as distinct columns in the database.

Source code in stac_fastapi/types/config.py 
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
class ApiSettings(BaseSettings):
    """ApiSettings.

    Defines api configuration, potentially through environment variables.
    See https://pydantic-docs.helpmanual.io/usage/settings/.
    Attributes:
        environment: name of the environment (ex. dev/prod).
        debug: toggles debug mode.
        forbidden_fields: set of fields defined by STAC but not included in the database.
        indexed_fields:
            set of fields which are usually in `item.properties` but are indexed
            as distinct columns in the database.
    """

    stac_fastapi_title: str = "stac-fastapi"
    stac_fastapi_description: str = "stac-fastapi"
    stac_fastapi_version: str = "0.1"
    stac_fastapi_landing_id: str = "stac-fastapi"

    app_host: str = "0.0.0.0"
    app_port: int = 8000
    reload: bool = True

    # Enable Pydantic validation for output Response
    enable_response_models: bool = False

    # Enable direct `Response` from endpoint, skipping validation and serialization
    enable_direct_response: bool = False

    openapi_url: str = "/api"
    docs_url: str = "/api.html"
    root_path: str = ""

    model_config = SettingsConfigDict(env_file=".env", extra="allow")

    @model_validator(mode="after")
    def check_incompatible_options(self) -> Self:
        """Check for incompatible options."""
        if self.enable_response_models and self.enable_direct_response:
            raise ValueError(
                "`enable_reponse_models` and `enable_direct_response` options are incompatible"  # noqa: E501
            )

        return self

check_incompatible_options 

check_incompatible_options() -> Self

Check for incompatible options.

Source code in stac_fastapi/types/config.py 
45
46
47
48
49
50
51
52
53
@model_validator(mode="after")
def check_incompatible_options(self) -> Self:
    """Check for incompatible options."""
    if self.enable_response_models and self.enable_direct_response:
        raise ValueError(
            "`enable_reponse_models` and `enable_direct_response` options are incompatible"  # noqa: E501
        )

    return self

Settings

Holds the global instance of settings.

Source code in stac_fastapi/types/config.py 
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
class Settings:
    """Holds the global instance of settings."""

    _instance: Optional[ApiSettings] = None

    @classmethod
    def set(cls, base_settings: ApiSettings):
        """Set the global settings."""
        cls._instance = base_settings

    @classmethod
    def get(cls) -> ApiSettings:
        """Get the settings.

        If they have not yet been set, throws an exception.
        """
        if cls._instance is None:
            raise ValueError("Settings have not yet been set.")
        return cls._instance

get classmethod 

get() -> ApiSettings

Get the settings.

If they have not yet been set, throws an exception.

Source code in stac_fastapi/types/config.py 
66
67
68
69
70
71
72
73
74
@classmethod
def get(cls) -> ApiSettings:
    """Get the settings.

    If they have not yet been set, throws an exception.
    """
    if cls._instance is None:
        raise ValueError("Settings have not yet been set.")
    return cls._instance

set classmethod 

set(base_settings: ApiSettings)

Set the global settings.

Source code in stac_fastapi/types/config.py 
61
62
63
64
@classmethod
def set(cls, base_settings: ApiSettings):
    """Set the global settings."""
    cls._instance = base_settings