`prefect.settings.profiles`

Functions

`load_profiles`

load_profiles(include_defaults: bool = True) -> ProfilesCollection

Load profiles from the current profile path. Optionally include profiles from the default profile path.

`load_current_profile`

load_current_profile() -> Profile

Load the current profile from the default and current profile paths. This will not include settings from the current settings context. Only settings that have been persisted to the profiles file will be saved.

`save_profiles`

save_profiles(profiles: ProfilesCollection) -> None

Writes all non-default profiles to the current profiles path.

`load_profile`

load_profile(name: str) -> Profile

Load a single profile by name.

`update_current_profile`

update_current_profile(settings: dict[str | Setting, Any]) -> Profile

Update the persisted data for the profile currently in-use. If the profile does not exist in the profiles file, it will be created. Given settings will be merged with the existing settings as described in ProfilesCollection.update_profile. Returns:

The new profile.

Classes

`Profile`

A user profile containing settings. Methods:

`to_environment_variables`

to_environment_variables(self) -> dict[str, str]

Convert the profile settings to a dictionary of environment variables.

`validate_settings`

validate_settings(self) -> None

Validate all settings in this profile by creating a partial Settings object with the nested structure properly constructed using accessor paths.

`ProfilesCollection`

” A utility class for working with a collection of profiles. Profiles in the collection must have unique names. The collection may store the name of the active profile. Methods:

`active_profile`

active_profile(self) -> Profile | None

Retrieve the active profile in this collection.

`add_profile`

add_profile(self, profile: Profile) -> None

Add a profile to the collection. If the profile name already exists, an exception will be raised.

`items`

items(self) -> list[tuple[str, Profile]]

`names`

names(self) -> set[str]

Return a set of profile names in this collection.

`remove_profile`

remove_profile(self, name: str) -> None

Remove a profile from the collection.

`set_active`

set_active(self, name: str | None, check: bool = True) -> None

Set the active profile name in the collection. A null value may be passed to indicate that this collection does not determine the active profile.

`to_dict`

to_dict(self) -> dict[str, Any]

Convert to a dictionary suitable for writing to disk.

`update_profile`

update_profile(self, name: str, settings: dict[Setting, Any], source: Path | None = None) -> Profile

Add a profile to the collection or update the existing on if the name is already present in this collection. If updating an existing profile, the settings will be merged. Settings can be dropped from the existing profile by setting them to None in the new profile. Returns the new profile object.

`without_profile_source`

without_profile_source(self, path: Path | None) -> 'ProfilesCollection'

Remove profiles that were loaded from a given path. Returns a new collection.

​prefect.settings.profiles

​Functions

​load_profiles

​load_current_profile

​save_profiles

​load_profile

​update_current_profile

​Classes

​Profile

​to_environment_variables

​validate_settings

​ProfilesCollection

​active_profile

​add_profile

​items

​names

​remove_profile

​set_active

​to_dict

​update_profile

​without_profile_source