Reference¶

Bring API package.

`Bring` ¶

Unofficial Bring API interface.

Init function for Bring API.

Source code in bring_api/bring.py

def __init__(
    self, session: aiohttp.ClientSession, mail: str, password: str
) -> None:
    """Init function for Bring API."""
    self._session = session

    self.mail = mail
    self.password = password

    self.public_uuid: str = ""
    self.user_list_settings: dict[str, dict[str, str]] = {}
    self.user_locale = BRING_DEFAULT_LOCALE

    self.__translations: dict[str, dict[str, str]] = {}
    self.uuid: str = ""

    self.url = URL(API_BASE_URL)

    self.headers = DEFAULT_HEADERS.copy()

    self.loop = asyncio.get_running_loop()
    self.__refresh_token: str | None = None
    self.__access_token_expires_at: float | None = None
    self._etag: dict[str, str] = {}
    self._site_cache: dict[str, str] = {}

`login` `async` ¶

Try to login.

Returns:

Type	Description
`Response`	The server response object.

Raises:

Type	Description
`BringRequestException`	If the request fails.
`BringParseException`	If the parsing of the request response fails.
`BringAuthException`	If the login fails due invalid credentials. You should check your email and password.

Source code in bring_api/bring.py

async def login(self) -> BringAuthResponse:
    """Try to login.

    Returns
    -------
    Response
        The server response object.

    Raises
    ------
    BringRequestException
        If the request fails.
    BringParseException
        If the parsing of the request response fails.
    BringAuthException
        If the login fails due invalid credentials.
        You should check your email and password.

    """
    user_data = {"email": self.mail, "password": self.password}

    try:
        url = self.url / "v2/bringauth"
        async with self._session.post(url, data=user_data) as r:
            _LOGGER.debug(
                "Response from %s [%s]: %s",
                url,
                r.status,
                await r.text()
                if r.status != 200
                else "",  # do not log response on success, as it contains sensible data
            )

            if r.status == HTTPStatus.UNAUTHORIZED:
                try:
                    errmsg = BringErrorResponse.from_json(await r.text())
                except MissingField as e:
                    raise BringParseException(
                        f"Failed to parse response: {str(e)} "
                        "This is likely a bug. Please report it at: https://github.com/miaucl/bring-api/issues",
                    ) from e
                except (JSONDecodeError, aiohttp.ClientError):
                    _LOGGER.debug(
                        "Exception: Cannot parse login request response:",
                        exc_info=True,
                    )
                else:
                    _LOGGER.debug("Exception: Cannot login: %s", errmsg.message)
                raise BringAuthException(
                    "Login failed due to authorization failure, "
                    "please check your email and password."
                )
            if r.status == HTTPStatus.BAD_REQUEST:
                _LOGGER.debug("Exception: Cannot login: %s", await r.text())
                raise BringAuthException(
                    "Login failed due to bad request, please check your email."
                )
            r.raise_for_status()

            try:
                data = BringAuthResponse.from_json(await r.text())
            except MissingField as e:
                raise BringMissingFieldException(e) from e
            except JSONDecodeError as e:
                _LOGGER.debug("Exception: Cannot login:", exc_info=True)
                raise BringParseException(
                    "Cannot parse login request response."
                ) from e
    except TimeoutError as e:
        _LOGGER.debug("Exception: Cannot login:", exc_info=True)
        raise BringRequestException(
            "Authentication failed due to connection timeout."
        ) from e
    except aiohttp.ClientError as e:
        _LOGGER.debug("Exception: Cannot login:", exc_info=True)
        raise BringRequestException(
            "Authentication failed due to request exception."
        ) from e

    self.uuid = data.uuid
    self.public_uuid = data.publicUuid
    self.headers["X-BRING-USER-UUID"] = self.uuid
    self.headers["X-BRING-PUBLIC-USER-UUID"] = self.public_uuid
    self.headers["Authorization"] = f"{data.token_type} {data.access_token}"
    self.__refresh_token = data.refresh_token
    self._expires_at = data.expires_in

    locale = (await self.get_user_account()).userLocale
    self.headers["X-BRING-COUNTRY"] = locale.country
    self.user_locale = self.map_user_language_to_locale(locale)

    await self.reload_user_list_settings()
    await self.reload_article_translations()

    return data

`reload_user_list_settings` `async` ¶

Reload the user list settings.

Raises:

Type	Description
`BringRequestException`	If the request fails.

Source code in bring_api/bring.py

async def reload_user_list_settings(self) -> None:
    """Reload the user list settings.

    Raises
    ------
    BringRequestException
        If the request fails.

    """
    self.user_list_settings = await self.__load_user_list_settings()

`reload_article_translations` `async` ¶

Reload the article translations.

Raises:

Type	Description
`BringRequestException`	If the request fails.

Source code in bring_api/bring.py

async def reload_article_translations(self) -> None:
    """Reload the article translations.

    Raises
    ------
    BringRequestException
        If the request fails.

    """
    self.__translations = await self.__load_article_translations()

`load_lists` `async` ¶

Load all shopping lists.

Returns:

Type	Description
`BringListResponse`	The JSON response.

Raises:

Type	Description
`BringRequestException`	If the request fails.
`BringParseException`	If the parsing of the request response fails.
`BringAuthException`	If the request fails due to invalid or expired authorization token.

Source code in bring_api/bring.py

async def load_lists(self) -> BringListResponse:
    """Load all shopping lists.

    Returns
    -------
    BringListResponse
        The JSON response.

    Raises
    ------
    BringRequestException
        If the request fails.
    BringParseException
        If the parsing of the request response fails.
    BringAuthException
        If the request fails due to invalid or expired authorization token.

    """

    url = self.url / "bringusers" / self.uuid / "lists"
    try:
        return BringListResponse.from_json(await self._request("GET", url))
    except MissingField as e:
        raise BringMissingFieldException(e) from e
    except JSONDecodeError as e:
        _LOGGER.debug("Exception: Cannot parse response:", exc_info=True)
        raise BringParseException(
            "Request failed during parsing of request response."
        ) from e

`get_list` `async` ¶

Get all items from a shopping list.

Parameters:

Name	Type	Description	Default
`list_uuid`	`str`	A list uuid returned by load_lists()	required

Returns:

Type	Description
`BringItemsResponse`	The JSON response.

Raises:

Type	Description
`BringRequestException`	If the request fails.
`BringParseException`	If the parsing of the request response fails.
`BringAuthException`	If the request fails due to invalid or expired authorization token.

Source code in bring_api/bring.py

async def get_list(self, list_uuid: str) -> BringItemsResponse:
    """Get all items from a shopping list.

    Parameters
    ----------
    list_uuid : str
        A list uuid returned by load_lists()

    Returns
    -------
    BringItemsResponse
        The JSON response.

    Raises
    ------
    BringRequestException
        If the request fails.
    BringParseException
        If the parsing of the request response fails.
    BringAuthException
        If the request fails due to invalid or expired authorization token.

    """
    url = self.url / "v2/bringlists" / list_uuid

    try:
        data = BringItemsResponse.from_json(await self._request("GET", url))
    except MissingField as e:
        raise BringMissingFieldException(e) from e
    except JSONDecodeError as e:
        _LOGGER.debug("Exception: Cannot parse response:", exc_info=True)
        raise BringParseException(
            "Request failed during parsing of request response."
        ) from e

    if TYPE_CHECKING:
        assert isinstance(data, BringItemsResponse)
    for item in chain(data.items.purchase, data.items.recently):
        item.itemId = self.__translate(
            item.itemId,
            to_locale=self.__locale(list_uuid),
        )

    return data

`get_all_item_details` `async` ¶

Get all details from a shopping list.

Parameters:

Name	Type	Description	Default
`list_uuid`	`str`	A list uuid returned by load_lists()	required

Returns:

Type	Description
`BringListItemsDetailsResponse`	The JSON response. A list of item details. Caution: This is NOT a list of the items currently marked as 'to buy'. See get_list() for that. This contains the items that where customized by changing their default icon, category or uploading an image.

Raises:

Type	Description
`BringRequestException`	If the request fails.
`BringParseException`	If the parsing of the request response fails.
`BringAuthException`	If the request fails due to invalid or expired authorization token.

Source code in bring_api/bring.py

async def get_all_item_details(
    self, list_uuid: str
) -> BringListItemsDetailsResponse:
    """Get all details from a shopping list.

    Parameters
    ----------
    list_uuid : str
        A list uuid returned by load_lists()

    Returns
    -------
    BringListItemsDetailsResponse
        The JSON response. A list of item details.
        Caution: This is NOT a list of the items currently marked as 'to buy'.
        See get_list() for that.
        This contains the items that where customized by changing
        their default icon, category or uploading an image.

    Raises
    ------
    BringRequestException
        If the request fails.
    BringParseException
        If the parsing of the request response fails.
    BringAuthException
        If the request fails due to invalid or expired authorization token.

    """
    url = self.url / "bringlists" / list_uuid / "details"

    try:
        return BringListItemsDetailsResponse.from_dict(
            {"items": orjson.loads(await self._request("GET", url))}
        )
    except JSONDecodeError as e:
        _LOGGER.debug(
            "Exception: Cannot get item details for list %s:",
            list_uuid,
            exc_info=True,
        )
        raise BringParseException(
            "Loading list details failed during parsing of request response."
        ) from e

`save_item` `async` ¶

Save an item to a shopping list.

Parameters:

Name	Type	Description	Default
`list_uuid`	`str`	A list uuid returned by load_lists()	required
`item_name`	`str`	The name of the item you want to save.	required
`specification`	`str`	The details you want to add to the item.	`''`
`item_uuid`	`str`	The uuid for the item to add. If a unique identifier is required it is recommended to generate a random uuid4.	`None`

Raises:

Type	Description
`BringRequestException`	If the request fails.

Source code in bring_api/bring.py

async def save_item(
    self,
    list_uuid: str,
    item_name: str,
    specification: str = "",
    item_uuid: str | None = None,
) -> None:
    """Save an item to a shopping list.

    Parameters
    ----------
    list_uuid : str
        A list uuid returned by load_lists()
    item_name : str
        The name of the item you want to save.
    specification : str, optional
        The details you want to add to the item.
    item_uuid : str, optional
        The uuid for the item to add. If a unique identifier is
        required it is recommended to generate a random uuid4.

    Raises
    ------
    BringRequestException
        If the request fails.

    """
    data = BringItem(itemId=item_name, spec=specification, uuid=item_uuid)
    try:
        await self.batch_update_list(list_uuid, data, BringItemOperation.ADD)
    except BringRequestException as e:
        _LOGGER.debug(
            "Exception: Cannot save item %s (%s) to list %s:",
            item_name,
            specification,
            list_uuid,
            exc_info=True,
        )
        raise BringRequestException(
            f"Saving item {item_name} ({specification}) to list {list_uuid} "
            "failed due to request exception."
        ) from e

`update_item` `async` ¶

Update an existing list item.

Caution: Do not update item_name. Providing item_uuid makes it possible to update a specific item in case there are multiple items with the same name. If uuid is not specified, the newest item with the given item_name will be updated.

Parameters:

Name	Type	Description	Default
`list_uuid`	`str`	A list uuid returned by load_lists()	required
`item_name`	`str`	The name of the item you want to update.	required
`specification`	`str`	The details you want to update on the item.	`''`
`item_uuid`	`str`	The uuid of the item to update.	`None`

Raises:

Type	Description
`BringRequestException`	If the request fails.

Source code in bring_api/bring.py

async def update_item(
    self,
    list_uuid: str,
    item_name: str,
    specification: str = "",
    item_uuid: str | None = None,
) -> None:
    """Update an existing list item.

    Caution: Do not update `item_name`. Providing `item_uuid` makes it
    possible to update a specific item in case there are multiple
    items with the same name. If uuid is not specified, the newest
    item with the given `item_name` will be updated.

    Parameters
    ----------
    list_uuid : str
        A list uuid returned by load_lists()
    item_name : str
        The name of the item you want to update.
    specification : str, optional
        The details you want to update on the item.
    item_uuid : str, optional
        The uuid of the item to update.

    Raises
    ------
    BringRequestException
        If the request fails.

    """
    data = BringItem(
        itemId=item_name,
        spec=specification,
        uuid=item_uuid,
    )
    try:
        await self.batch_update_list(list_uuid, data, BringItemOperation.ADD)
    except BringRequestException as e:
        _LOGGER.debug(
            "Exception: Cannot update item %s (%s) to list %s:",
            item_name,
            specification,
            list_uuid,
            exc_info=True,
        )
        raise BringRequestException(
            f"Updating item {item_name} ({specification}) in list {list_uuid} "
            "failed due to request exception."
        ) from e

`remove_item` `async` ¶

Remove an item from a shopping list.

Parameters:

Name	Type	Description	Default
`list_uuid`	`str`	A list uuid returned by load_lists()	required
`item_name`	`str`	The name of the item you want to remove.	required
`item_uuid`	`str`	The uuid of the item you want to remove. The item to remove can be remove by only referencing its uuid and setting item_name to any nonempty string.	`None`

Raises:

Type	Description
`BringRequestException`	If the request fails.

Source code in bring_api/bring.py

async def remove_item(
    self, list_uuid: str, item_name: str, item_uuid: str | None = None
) -> None:
    """Remove an item from a shopping list.

    Parameters
    ----------
    list_uuid : str
        A list uuid returned by load_lists()
    item_name : str
        The name of the item you want to remove.
    item_uuid : str, optional
        The uuid of the item you want to remove. The item to remove can be remove by only
        referencing its uuid and setting item_name to any nonempty string.

    Raises
    ------
    BringRequestException
        If the request fails.

    """
    data = BringItem(
        itemId=item_name,
        spec="",
        uuid=item_uuid,
    )
    try:
        await self.batch_update_list(list_uuid, data, BringItemOperation.REMOVE)
    except BringRequestException as e:
        _LOGGER.debug(
            "Exception: Cannot delete item %s from list %s:",
            item_name,
            list_uuid,
            exc_info=True,
        )
        raise BringRequestException(
            f"Removing item {item_name} from list {list_uuid} "
            "failed due to request exception."
        ) from e

`complete_item` `async` ¶

Complete an item from a shopping list. This will add it to recent items.

If it was not on the list, it will still be added to recent items.

Parameters:

Name	Type	Description	Default
`list_uuid`	`str`	A list uuid returned by load_lists()	required
`item_name`	`str`	The name of the item you want to complete.	required
`specification`	`str`	The details you want to update on the item.	`''`
`item_uuid`	`str`	The uuid of the item you want to complete.	`None`

Raises:

Type	Description
`BringRequestException`	If the request fails.

Source code in bring_api/bring.py

async def complete_item(
    self,
    list_uuid: str,
    item_name: str,
    specification: str = "",
    item_uuid: str | None = None,
) -> None:
    """Complete an item from a shopping list. This will add it to recent items.

    If it was not on the list, it will still be added to recent items.

    Parameters
    ----------
    list_uuid : str
        A list uuid returned by load_lists()
    item_name : str
        The name of the item you want to complete.
    specification : str, optional
        The details you want to update on the item.
    item_uuid : str, optional
        The uuid of the item you want to complete.

    Raises
    ------
    BringRequestException
        If the request fails.

    """
    data = BringItem(
        itemId=item_name,
        spec=specification,
        uuid=item_uuid,
    )
    try:
        await self.batch_update_list(list_uuid, data, BringItemOperation.COMPLETE)
    except BringRequestException as e:
        _LOGGER.debug(
            "Exception: Cannot complete item %s in list %s:",
            item_name,
            list_uuid,
            exc_info=True,
        )
        raise BringRequestException(
            f"Completing item {item_name} from list {list_uuid} "
            "failed due to request exception."
        ) from e

`notify` `async` ¶

Send a push notification to all other members of a shared list.

Parameters:

Name	Type	Description	Default
`list_uuid`	`str`	The unique identifier of the list.	required
`notification_type`	`BringNotificationType`	The type of notification to be sent.	required
`item_name`	`str`	The name of the item. Required if notification_type is URGENT_MESSAGE.	`None`
`activity`	`str \| Activity \| None`	The UUID or the Activity object of the activity to react to. Required if notification_type is LIST_ACTIVITY_STREAM_REACTION.	`None`
`receiver`	`str \| None`	The public user UUID of the recipient. Required if notification_type is LIST_ACTIVITY_STREAM_REACTION and activity is referenced by it's uuid.	`None`
`activity_type`	`ActivityType \| None`	Required if notification_type is LIST_ACTIVITY_STREAM_REACTION and activity is referenced by it's uuid.	`None`
`reaction`	`ReactionType \| None`	The type of reaction. Either :MONOCLE:, :THUMBS_UP:, :HEART:, or :DROOLING: Required if notification_type is LIST_ACTIVITY_STREAM_REACTION.	`None`

Raises:

Type	Description
`BringRequestException`	If the request fails.
`BringAuthException`	If the request fails due to invalid or expired authorization token.
`TypeError`	If the notification_type parameter is invalid.
`ValueError`	If the value for item_name, receiver, activity, activity_type, or reaction is invalid.

Source code in bring_api/bring.py

async def notify(
    self,
    list_uuid: str,
    notification_type: BringNotificationType,
    item_name: str | None = None,
    activity: str | Activity | None = None,
    receiver: str | None = None,
    activity_type: ActivityType | None = None,
    reaction: ReactionType | None = None,
) -> None:
    """Send a push notification to all other members of a shared list.

    Parameters
    ----------
    list_uuid : str
        The unique identifier of the list.
    notification_type : BringNotificationType
        The type of notification to be sent.
    item_name : str, optional
        The name of the item. Required if notification_type is URGENT_MESSAGE.
    activity: str or Activity, optional
        The UUID or the Activity object of the activity to react to.
        Required if notification_type is LIST_ACTIVITY_STREAM_REACTION.
    receiver: str, optional
        The public user UUID of the recipient.
        Required if notification_type is LIST_ACTIVITY_STREAM_REACTION and activity is referenced by it's uuid.
    activity_type: ActivityType, optional
        Required if notification_type is LIST_ACTIVITY_STREAM_REACTION and activity is referenced by it's uuid.
    reaction: ReactionType, optional
        The type of reaction. Either :MONOCLE:, :THUMBS_UP:, :HEART:, or :DROOLING:
        Required if notification_type is LIST_ACTIVITY_STREAM_REACTION.


    Raises
    ------
    BringRequestException
        If the request fails.
    BringAuthException
        If the request fails due to invalid or expired authorization token.
    TypeError
        If the notification_type parameter is invalid.
    ValueError
        If the value for item_name, receiver, activity, activity_type, or reaction is invalid.

    """
    json = BringNotificationsConfigType(
        arguments=[],
        listNotificationType=notification_type.value,
        senderPublicUserUuid=self.public_uuid,
    )

    if not isinstance(notification_type, BringNotificationType):
        raise TypeError(
            f"notificationType {notification_type} not supported,"
            "must be of type BringNotificationType."
        )

    if notification_type is BringNotificationType.URGENT_MESSAGE:
        if not item_name or len(item_name) == 0:
            raise ValueError(
                "notificationType is URGENT_MESSAGE but argument itemName missing."
            )
        else:
            json["arguments"] = [item_name]

    if notification_type is BringNotificationType.LIST_ACTIVITY_STREAM_REACTION:
        if isinstance(activity, Activity) and reaction:
            json["receiverPublicUserUuid"] = activity.content.publicUserUuid
            json["listActivityStreamReaction"] = ActivityReaction(
                moduleUuid=activity.content.uuid,
                moduleType=activity.type.name,
                reactionType=reaction.name,
            )
        elif isinstance(activity, str) and receiver and activity_type and reaction:
            json["receiverPublicUserUuid"] = receiver
            json["listActivityStreamReaction"] = ActivityReaction(
                moduleUuid=activity,
                moduleType=activity_type.name,
                reactionType=reaction.name,
            )
        else:
            raise ValueError(
                "notificationType is LIST_ACTIVITY_STREAM_REACTION but a parameter is missing. "
                f"[{receiver=},{activity=},{activity_type=},{reaction=}]"
            )

    url = self.url / "v2/bringnotifications/lists" / list_uuid
    await self._request("POST", url, json=json)

`does_user_exist` `async` ¶

Check if e-mail is valid and user exists.

Parameters:

Name	Type	Description	Default
`mail`	`str`	An e-mail address.	`None`

Returns:

Type	Description
`bool`	True if user exists.

Raises:

Type	Description
`BringRequestException`	If the request fails.
`BringEMailInvalidException`	If the email is invalid.
`BringUserUnknownException`	If the user is does not exist

Source code in bring_api/bring.py

async def does_user_exist(self, mail: str | None = None) -> bool:
    """Check if e-mail is valid and user exists.

    Parameters
    ----------
    mail : str
        An e-mail address.

    Returns
    -------
    bool
        True if user exists.

    Raises
    ------
    BringRequestException
        If the request fails.
    BringEMailInvalidException
        If the email is invalid.
    BringUserUnknownException
        If the user is does not exist

    """
    mail = mail or self.mail

    if not mail:
        raise ValueError("Argument mail missing.")

    try:
        url = self.url / "bringusers" % {"email": mail}
        async with self._session.get(url, headers=self.headers) as r:
            _LOGGER.debug(
                "Response from %s [%s]: %s", url, r.status, await r.text()
            )

            if r.status == HTTPStatus.NOT_FOUND:
                raise BringUserUnknownException(f"User {mail} does not exist.")

            r.raise_for_status()

    except TimeoutError as e:
        _LOGGER.debug(
            "Exception: Cannot get verification for %s:", mail, exc_info=True
        )
        raise BringRequestException(
            "Verifying email failed due to connection timeout."
        ) from e
    except aiohttp.ClientError as e:
        raise BringEMailInvalidException(f"E-mail {mail} is invalid.") from e

    return True

`__load_article_translations_from_file` ¶

Read localization ressource files from disk.

Parameters:

Name	Type	Description	Default
`locale`	`str`	A locale string	required

Returns:

Type	Description
`dict[str, str]:`	A translation table as a dict

Source code in bring_api/bring.py

def __load_article_translations_from_file(self, locale: str) -> dict[str, str]:
    """Read localization ressource files from disk.

    Parameters
    ----------
    locale : str
        A locale string

    Returns
    -------
        dict[str, str]:
            A translation table as a dict

    """
    dictionary_from_file: dict[str, str]

    path = os.path.join(
        os.path.dirname(os.path.abspath(__file__)),
        "locales",
        f"articles.{locale}.json",
    )
    with open(path, encoding="UTF-8") as f:
        dictionary_from_file = json.load(f)

    return dictionary_from_file

`__load_article_translations` `async` ¶

Load all required translation dictionaries into memory.

Raises:

Type	Description
`BringRequestException`	If the request fails.
`BringParseException`	If the parsing of the request response fails.

Returns:

Type	Description
`dict`	dict of downloaded dictionaries

Source code in bring_api/bring.py

async def __load_article_translations(self) -> dict[str, dict[str, str]]:
    """Load all required translation dictionaries into memory.

    Raises
    ------
    BringRequestException
        If the request fails.
    BringParseException
        If the parsing of the request response fails.

    Returns
    -------
    dict
        dict of downloaded dictionaries

    """
    dictionaries: dict[str, dict[str, str]] = {}

    locales_required = list(
        dict.fromkeys(
            [
                list_setting.get("listArticleLanguage", self.user_locale)
                for list_setting in self.user_list_settings.values()
            ]
            + [self.user_locale]
        )
    )

    for locale in locales_required:
        if locale == BRING_DEFAULT_LOCALE or locale not in BRING_SUPPORTED_LOCALES:
            continue

        try:
            dictionaries[locale] = await self.loop.run_in_executor(
                None, self.__load_article_translations_from_file, locale
            )
            continue
        except OSError:
            _LOGGER.warning(
                "Locale file articles.%s.json could not be loaded from filesystem. "
                "Will continue trying to download locale.",
                locale,
            )

        try:
            url = URL(LOCALES_BASE_URL) / f"articles.{locale}.json"
            async with self._session.get(url) as r:
                _LOGGER.debug("Response from %s [%s]", url, r.status)
                r.raise_for_status()

                try:
                    dictionaries[locale] = await r.json()
                except JSONDecodeError as e:
                    _LOGGER.debug(
                        "Exception: Cannot load articles.%s.json:",
                        locale,
                        exc_info=True,
                    )
                    raise BringParseException(
                        f"Loading article translations for locale {locale} "
                        "failed during parsing of request response."
                    ) from e
        except TimeoutError as e:
            _LOGGER.debug(
                "Exception: Cannot load articles.%s.json:", locale, exc_info=True
            )
            raise BringRequestException(
                f"Loading article translations for locale {locale} "
                "failed due to connection timeout."
            ) from e

        except aiohttp.ClientError as e:
            _LOGGER.debug(
                "Exception: Cannot load articles.%s.json:", locale, exc_info=True
            )
            raise BringRequestException(
                f"Loading article translations for locale {locale} "
                "failed due to request exception."
            ) from e

    return dictionaries

`__translate` ¶

Translate a catalog item from or to a language.

Parameters:

Name	Type	Description	Default
`item_id`	`str`	Item name.	required
`to_locale`	`str`	locale to translate to.	`None`
`from_locale`	`str`	locale to translate from.	`None`

Returns:

Type	Description
`str`	Translated Item name.

Raises:

Type	Description
`BringTranslationException`	If the translation fails.

Source code in bring_api/bring.py

def __translate(
    self,
    item_id: str,
    *,
    to_locale: str | None = None,
    from_locale: str | None = None,
) -> str:
    """Translate a catalog item from or to a language.

    Parameters
    ----------
    item_id : str
        Item name.
    to_locale : str
        locale to translate to.
    from_locale : str
        locale to translate from.

    Returns
    -------
    str
        Translated Item name.

    Raises
    ------
    BringTranslationException
        If the translation fails.

    """

    locale = to_locale or from_locale

    if locale == BRING_DEFAULT_LOCALE:
        return item_id

    if not locale:
        raise ValueError("One of the arguments from_locale or to_locale required.")

    if locale not in BRING_SUPPORTED_LOCALES:
        _LOGGER.debug("Locale %s not supported by Bring.", locale)
        raise ValueError(f"Locale {locale} not supported by Bring.")
    try:
        return (
            self.__translations[locale].get(item_id, item_id)
            if to_locale
            else (
                {value: key for key, value in self.__translations[locale].items()}
            ).get(item_id, item_id)
        )

    except Exception as e:
        _LOGGER.debug(
            "Exception: Cannot load translation dictionary:", exc_info=True
        )
        raise BringTranslationException(
            "Translation failed due to error loading translation dictionary."
        ) from e

`__load_user_list_settings` `async` ¶

Load user list settings into memory.

Raises:

Type	Description
`BringTranslationException`	If the user list settings could not be loaded.

Returns:

Type	Description
`dict[str, dict[str, str]]`	A dict of settings of the users lists

Source code in bring_api/bring.py

async def __load_user_list_settings(self) -> dict[str, dict[str, str]]:
    """Load user list settings into memory.

    Raises
    ------
    BringTranslationException
        If the user list settings could not be loaded.

    Returns
    -------
     dict[str, dict[str, str]]
        A dict of settings of the users lists

    """
    try:
        return {
            user_list_setting.listUuid: {
                user_setting.key: user_setting.value
                for user_setting in user_list_setting.usersettings
            }
            for user_list_setting in (
                await self.get_all_user_settings()
            ).userlistsettings
        }

    except Exception as e:
        _LOGGER.debug("Exception: Cannot load user list settings:", exc_info=True)
        raise BringTranslationException(
            "Translation failed due to error loading user list settings."
        ) from e

`get_all_user_settings` `async` ¶

Load all user settings and user list settings.

Returns:

Type	Description
`BringUserSettingsResponse`	The JSON response.

Raises:

Type	Description
`BringRequestException`	If the request fails.
`BringParseExceptiontry:`	If the parsing of the request response fails.
`BringAuthException`	If the request fails due to invalid or expired authorization token.

Source code in bring_api/bring.py

async def get_all_user_settings(self) -> BringUserSettingsResponse:
    """Load all user settings and user list settings.

    Returns
    -------
    BringUserSettingsResponse
        The JSON response.


    Raises
    ------
    BringRequestException
        If the request fails.
    BringParseExceptiontry:
        If the parsing of the request response fails.
    BringAuthException
        If the request fails due to invalid or expired authorization token.

    """
    url = self.url / "bringusersettings" / self.uuid
    try:
        return BringUserSettingsResponse.from_json(await self._request("GET", url))
    except MissingField as e:
        raise BringMissingFieldException(e) from e
    except JSONDecodeError as e:
        _LOGGER.debug("Exception: Cannot parse response:", exc_info=True)
        raise BringParseException(
            "Request failed during parsing of request response."
        ) from e

`__locale` ¶

Get list or user locale.

Returns:

Type	Description
`str`	The locale from userlistsettings or user.

Raises:

Type	Description
`BringTranslationException`	If list locale could not be determined from the userlistsettings or user.

Source code in bring_api/bring.py

def __locale(self, list_uuid: str) -> str:
    """Get list or user locale.

    Returns
    -------
    str
        The locale from userlistsettings or user.

    Raises
    ------
    BringTranslationException
        If list locale could not be determined from the userlistsettings or user.

    """
    if list_uuid in self.user_list_settings:
        return self.user_list_settings[list_uuid].get(
            "listArticleLanguage", self.user_locale
        )
    return self.user_locale

`map_user_language_to_locale` ¶

Map user language to a supported locale.

The userLocale returned from the user account settings is not necessarily one of the 20 locales used by the Bring App but rather what the user has set as language on their phone and the country where they are located. Usually the locale for the lists is always returned from the bringusersettings API endpoint. One exception exists, when user onboarding happens through the webApp, then the locale for the automatically created initial list is not set. For other lists this does not happen, as it is not possible to create more lists in the webApp, only in the mobile apps.

Parameters:

Name	Type	Description	Default
`user_locale`	`dict`	user locale as a dict containing `language` and `country`.	required

Returns:

Type	Description
`str`	The locale corresponding to the users language.

Source code in bring_api/bring.py

def map_user_language_to_locale(self, user_locale: UserLocale) -> str:
    """Map user language to a supported locale.

    The userLocale returned from the user account settings is not necessarily one of the 20
    locales used by the Bring App but rather what the user has set as language on their phone
    and the country where they are located. Usually the locale for the lists is always returned
    from the bringusersettings API endpoint. One exception exists, when user onboarding happens
    through the webApp, then the locale for the automatically created initial list is not set.
    For other lists this does not happen, as it is not possible to create more lists in the
    webApp, only in the mobile apps.

    Parameters
    ----------
    user_locale : dict
        user locale as a dict containing `language` and `country`.

    Returns
    -------
    str
        The locale corresponding to the users language.

    """
    locale = f"{user_locale.language}-{user_locale.country}"
    # if locale is a valid and supported locale we can use it.
    if locale in BRING_SUPPORTED_LOCALES:
        return locale

    # if language and country are not valid locales, we use only the language part and
    # map it to a corresponding locale or the most common for that language.
    return MAP_LANG_TO_LOCALE.get(user_locale.language, BRING_DEFAULT_LOCALE)

`get_user_account` `async` ¶

Get current user account.

Returns:

Type	Description
`BringSyncCurrentUserResponse`	The JSON response.

Raises:

Type	Description
`BringRequestException`	If the request fails.
`BringParseException`	If the parsing of the request response fails.
`BringAuthException`	If the request fails due to invalid or expired authorization token.

Source code in bring_api/bring.py

async def get_user_account(self) -> BringSyncCurrentUserResponse:
    """Get current user account.

    Returns
    -------
    BringSyncCurrentUserResponse
        The JSON response.


    Raises
    ------
    BringRequestException
        If the request fails.
    BringParseException
        If the parsing of the request response fails.
    BringAuthException
        If the request fails due to invalid or expired authorization token.

    """
    url = self.url / "v2/bringusers" / self.uuid

    try:
        return BringSyncCurrentUserResponse.from_json(
            await self._request("GET", url)
        )
    except MissingField as e:
        raise BringMissingFieldException(e) from e
    except JSONDecodeError as e:
        _LOGGER.debug("Exception: Cannot parse response:", exc_info=True)
        raise BringParseException(
            "Request failed during parsing of request response."
        ) from e

`batch_update_list` `async` ¶

Batch update items on a shopping list.

Parameters:

Name	Type	Description	Default
`list_uuid`	`str`	The listUuid of the list to make the changes to	required
`items`	`BringItem or List of BringItem`	Item(s) to add, complete or remove from the list	required
`operation`	`BringItemOperation`	The Operation (ADD, COMPLETE, REMOVE) to perform for the supplied items on the list. Parameter can be ommited, and the BringItem key 'operation' can be set to TO_PURCHASE, TO_RECENTLY or REMOVE. Defaults to BringItemOperation.ADD if operation is neither passed as parameter nor is set in the BringItem.	`None`

Raises:

Type	Description
`BringRequestException`	If the request fails.
`BringParseException`	If the parsing of the request response fails.
`BringAuthException`	If the request fails due to invalid or expired authorization token.

Source code in bring_api/bring.py

async def batch_update_list(
    self,
    list_uuid: str,
    items: BringItem | list[BringItem] | list[dict[str, str]],
    operation: BringItemOperation | None = None,
) -> None:
    """Batch update items on a shopping list.

    Parameters
    ----------
    list_uuid : str
        The listUuid of the list to make the changes to
    items : BringItem or List of BringItem
        Item(s) to add, complete or remove from the list
    operation : BringItemOperation, optional
        The Operation (ADD, COMPLETE, REMOVE) to perform for the supplied items on the list.
        Parameter can be ommited, and the BringItem key 'operation' can be set to TO_PURCHASE,
        TO_RECENTLY or REMOVE. Defaults to BringItemOperation.ADD if operation is neither
        passed as parameter nor is set in the BringItem.

    Raises
    ------
    BringRequestException
        If the request fails.
    BringParseException
        If the parsing of the request response fails.
    BringAuthException
        If the request fails due to invalid or expired authorization token.

    """
    if operation is None:
        operation = BringItemOperation.ADD

    _base_params = {
        "accuracy": "0.0",
        "altitude": "0.0",
        "latitude": "0.0",
        "longitude": "0.0",
    }
    if isinstance(items, dict):
        items = [items]
    json_data = {
        "changes": [
            {
                **_base_params,
                **item,
                "itemId": self.__translate(
                    item["itemId"],
                    from_locale=self.__locale(list_uuid),
                ),
                "operation": str(item.get("operation", operation)),
            }
            for item in items
        ],
        "sender": "",
    }
    url = self.url / "v2/bringlists" / list_uuid / "items"
    await self._request("PUT", url, json=json_data)

`retrieve_new_access_token` `async` ¶

Refresh the access token.

Parameters:

Name	Type	Description	Default
`refresh_token`	`str`	The refresh token to use to retrieve a new access token	`None`

Returns:

Type	Description
`BringAuthTokenRespone`	The JSON response.

Raises:

Type	Description
`BringRequestException`	If the request fails.
`BringAuthException`	If the request fails due to invalid or expired refresh token.

Source code in bring_api/bring.py

async def retrieve_new_access_token(
    self, refresh_token: str | None = None
) -> BringAuthTokenResponse:
    """Refresh the access token.

    Parameters
    ----------
    refresh_token : str, optional
        The refresh token to use to retrieve a new access token

    Returns
    -------
    BringAuthTokenRespone
        The JSON response.

    Raises
    ------
    BringRequestException
        If the request fails.
    BringAuthException
        If the request fails due to invalid or expired refresh token.

    """
    if not (refresh_token := refresh_token or self.__refresh_token):
        raise BringAuthException("Refresh token not found. Login required.")

    user_data = {"grant_type": "refresh_token", "refresh_token": refresh_token}
    try:
        url = self.url / "v2/bringauth/token"
        async with self._session.post(
            url, headers=self.headers, data=user_data
        ) as r:
            _LOGGER.debug(
                "Response from %s [%s]: %s",
                url,
                r.status,
                await r.text()
                if r.status != 200
                else "",  # do not log response on success, as it contains sensible data
            )
            if r.status == HTTPStatus.UNAUTHORIZED:
                try:
                    errmsg = BringErrorResponse.from_json(await r.text())
                except (JSONDecodeError, aiohttp.ClientError):
                    _LOGGER.debug(
                        "Exception: Cannot parse token request response:",
                        exc_info=True,
                    )
                else:
                    _LOGGER.debug(
                        "Exception: Cannot retrieve new access token: %s",
                        errmsg.message,
                    )
                raise BringAuthException(
                    "Retrieve new access token failed due to authorization failure, "
                    "the refresh token is invalid or expired."
                )

            r.raise_for_status()

            try:
                data = BringAuthTokenResponse.from_json(await r.text())
            except MissingField as e:
                raise BringMissingFieldException(e) from e
            except JSONDecodeError as e:
                _LOGGER.debug(
                    "Exception: Cannot retrieve new access token:", exc_info=True
                )
                raise BringParseException(
                    "Cannot parse token request response."
                ) from e
    except TimeoutError as e:
        _LOGGER.debug("Exception: Cannot login:", exc_info=True)
        raise BringRequestException(
            "Retrieve new access token failed due to connection timeout."
        ) from e
    except aiohttp.ClientError as e:
        _LOGGER.debug("Exception: Cannot login:", exc_info=True)
        raise BringRequestException(
            "Retrieve new access token failed due to request exception."
        ) from e

    self.headers["Authorization"] = f"{data.token_type} {data.access_token}"
    self._expires_at = data.expires_in

    return data

`set_list_article_language` `async` ¶

Set the article language for a specified list.

Parameters:

Name	Type	Description	Default
`list_uuid`	`str`	The unique identifier for the list.	required
`language`	`str`	The language to set for the list articles.	required

Raises:

Type	Description
`ValueError`	If the specified language is not supported.
`BringRequestException`	If the request fails.
`BringAuthException`	If the request fails due to invalid or expired authorization token.

Source code in bring_api/bring.py

async def set_list_article_language(self, list_uuid: str, language: str) -> None:
    """Set the article language for a specified list.

    Parameters
    ----------
    list_uuid : str
        The unique identifier for the list.
    language : str
        The language to set for the list articles.

    Raises
    ------
    ValueError
        If the specified language is not supported.
    BringRequestException
        If the request fails.
    BringAuthException
        If the request fails due to invalid or expired authorization token.

    """
    if language not in BRING_SUPPORTED_LOCALES:
        raise ValueError(f"Language {language} not supported.")

    url = (
        self.url
        / "bringusersettings"
        / self.uuid
        / list_uuid
        / "listArticleLanguage"
    )

    data = {"value": language}
    await self._request("POST", url, data=data)

`get_activity` `async` ¶

Get activity for given list.

Source code in bring_api/bring.py

async def get_activity(self, list_uuid: str) -> BringActivityResponse:
    """Get activity for given list."""
    url = self.url / "v2/bringlists" / list_uuid / "activity"

    try:
        return BringActivityResponse.from_json(await self._request("GET", url))
    except MissingField as e:
        raise BringMissingFieldException(e) from e
    except JSONDecodeError as e:
        _LOGGER.debug("Exception: Cannot parse response:", exc_info=True)
        raise BringParseException(
            "Request failed during parsing of request response."
        ) from e

`get_list_users` `async` ¶

Retrieve members of a shared list.

Source code in bring_api/bring.py

async def get_list_users(self, list_uuid: str) -> BringUsersResponse:
    """Retrieve members of a shared list."""

    url = self.url / "v2/bringlists" / list_uuid / "users"

    try:
        return BringUsersResponse.from_json(await self._request("GET", url))
    except MissingField as e:
        raise BringMissingFieldException(e) from e
    except JSONDecodeError as e:
        _LOGGER.debug("Exception: Cannot parse response:", exc_info=True)
        raise BringParseException(
            "Request failed during parsing of request response."
        ) from e

`parse_recipe` `async` ¶

Parse a recipe from a URL into a BringTemplate.

Parameters:

Name	Type	Description	Default
`recipe_url`	`str`	The URL of the recipe to be parsed.	required

Returns:

Type	Description
`BringTemplate`	An instance of BringTemplate representing the parsed recipe.

Raises:

Type	Description
`BringRequestException`	If the request fails.
`BringParseException`	If the parsing of the response fails.
`BringAuthException`	If the request fails due to invalid or expired authorization token.

Source code in bring_api/bring.py

async def parse_recipe(
    self,
    recipe_url: str,
) -> BringTemplate:
    """Parse a recipe from a URL into a BringTemplate.

    Parameters
    ----------
    recipe_url : str
        The URL of the recipe to be parsed.

    Returns
    -------
    BringTemplate
        An instance of BringTemplate representing the parsed recipe.

    Raises
    ------
    BringRequestException
        If the request fails.
    BringParseException
        If the parsing of the response fails.
    BringAuthException
        If the request fails due to invalid or expired authorization token.

    """
    url = self.url / "bringrecipes/parser"
    params = {"url": str(recipe_url)}

    try:
        return BringTemplate.from_json(
            await self._request("GET", url, params=params)
        )
    except MissingField as e:
        raise BringMissingFieldException(e) from e
    except JSONDecodeError as e:
        _LOGGER.debug("Exception: Cannot parse response:", exc_info=True)
        raise BringParseException(
            "Request failed during parsing of request response."
        ) from e

`create_template` `async` ¶

Create a new template or recipe in Bring.

Parameters:

Name	Type	Description	Default
`template`	`BringTemplate`	An instance of BringTemplate containing the template or recipe details to be created.	required
`template_type`	`TemplateType`	The type of template to be created. It can be either a standard template or a recipe.	`TEMPLATE`

Returns:

Type	Description
`BringTemplate`	An instance of BringTemplate representing the created template.

Raises:

Type	Description
`BringRequestException`	If the request fails.
`BringParseException`	If the parsing of the request response fails.
`BringAuthException`	If the request fails due to invalid or expired authorization token.

Source code in bring_api/bring.py

async def create_template(
    self,
    template: BringTemplate,
    template_type: TemplateType = TemplateType.TEMPLATE,
) -> BringTemplate:
    """Create a new template or recipe in Bring.

    Parameters
    ----------
    template : BringTemplate
        An instance of BringTemplate containing the template or recipe details to be created.
    template_type: TemplateType
        The type of template to be created. It can be either a standard template or a recipe.

    Returns
    -------
    BringTemplate
        An instance of BringTemplate representing the created template.

    Raises
    ------
    BringRequestException
        If the request fails.
    BringParseException
        If the parsing of the request response fails.
    BringAuthException
        If the request fails due to invalid or expired authorization token.

    """

    url = self.url / "v2/bringtemplates"

    data = {
        "content": template.to_dict(omit_none=True),
        "type": template_type,
        "userUuid": self.uuid,
    }
    try:
        return BringTemplate.from_json(await self._request("POST", url, json=data))
    except MissingField as e:
        raise BringMissingFieldException(e) from e
    except JSONDecodeError as e:
        _LOGGER.debug("Exception: Cannot parse response:", exc_info=True)
        raise BringParseException(
            "Request failed during parsing of request response."
        ) from e

`delete_template` `async` ¶

Delete a template or recipe by its UUID.

Parameters:

Name	Type	Description	Default
`template_uuid`	`str`	The unique identifier of the template or recipe to be deleted.	required

Returns:

Type	Description
`None`

Raises:

Type	Description
`BringRequestException`	If the request fails.
`BringAuthException`	If the request fails due to invalid or expired authorization token.

Source code in bring_api/bring.py

async def delete_template(self, template_uuid: str) -> None:
    """Delete a template or recipe by its UUID.

    Parameters
    ----------
    template_uuid : str
        The unique identifier of the template or recipe to be deleted.

    Returns
    -------
    None

    Raises
    ------
    BringRequestException
        If the request fails.
    BringAuthException
        If the request fails due to invalid or expired authorization token.

    """

    url = self.url / "v2/bringtemplates" / template_uuid
    await self._request("DELETE", url)

`get_inspirations` `async` ¶

Get inspirations (recipes/templates) for a given tag from Bring.

Parameters:

Name	Type	Description	Default
`filter`	`str`	The tag to filter inspirations by. Default is "mine". Possible filter tags: all, mine, bring_trending_recipes, chefkoch.de Other promotional filter tags are available depending on the season and can be retrieved with `get_inspiration_filters`	`'mine'`

Returns:

Type	Description
`BringInspirationsResponse`	A response object containing the inspirations data.

Raises:

Type	Description
`BringRequestException`	If the request fails.
`BringParseException`	If the parsing of the request response fails.
`BringAuthException`	If the request fails due to invalid or expired authorization token.

Source code in bring_api/bring.py

async def get_inspirations(self, filter: str = "mine") -> BringInspirationsResponse:
    """Get inspirations (recipes/templates) for a given tag from Bring.

    Parameters
    ----------
    filter : str, optional
        The tag to filter inspirations by. Default is "mine".
        Possible filter tags: all, mine, bring_trending_recipes, chefkoch.de
        Other promotional filter tags are available depending on the season
        and can be retrieved with `get_inspiration_filters`

    Returns
    -------
    BringInspirationsResponse
        A response object containing the inspirations data.

    Raises
    ------
    BringRequestException
        If the request fails.
    BringParseException
        If the parsing of the request response fails.
    BringAuthException
        If the request fails due to invalid or expired authorization token.

    """

    url = self.url / "v2/bringusers/" / self.uuid / "inspirations"

    params = {
        "filterTags": filter,
        "offset": 0,
        "limit": 2147483647,
    }
    try:
        return BringInspirationsResponse.from_json(
            await self._request("GET", url, params=params)
        )
    except MissingField as e:
        raise BringMissingFieldException(e) from e
    except JSONDecodeError as e:
        _LOGGER.debug("Exception: Cannot parse response:", exc_info=True)
        raise BringParseException(
            "Request failed during parsing of request response."
        ) from e

`get_inspiration_filters` `async` ¶

Retrieve categories (filters) for the inspiration stream.

Returns:

Type	Description
`BringInspirationFiltersResponse`	An instance of BringInspirationFiltersResponse containing the filters.

Raises:

Type	Description
`BringRequestException`	If the request fails.
`BringParseException`	If the parsing of the request response fails.
`BringAuthException`	If the request fails due to invalid or expired authorization token.

Source code in bring_api/bring.py

async def get_inspiration_filters(self) -> BringInspirationFiltersResponse:
    """Retrieve categories (filters) for the inspiration stream.

    Returns
    -------
    BringInspirationFiltersResponse
        An instance of BringInspirationFiltersResponse containing the filters.

    Raises
    ------
    BringRequestException
        If the request fails.
    BringParseException
        If the parsing of the request response fails.
    BringAuthException
        If the request fails due to invalid or expired authorization token.

    """

    url = self.url / "v2/bringusers/" / self.uuid / "inspirationstreamfilters"
    try:
        return BringInspirationFiltersResponse.from_json(
            await self._request("GET", url)
        )
    except MissingField as e:
        raise BringMissingFieldException(e) from e
    except JSONDecodeError as e:
        _LOGGER.debug("Exception: Cannot parse response:", exc_info=True)
        raise BringParseException(
            "Request failed during parsing of request response."
        ) from e

`BringListItemDetails` `dataclass` ¶

Bases: DataClassORJSONMixin

An item details class.

Includes several details of an item in the context of a list. Caution: This does not have to be an item that is currently marked as 'to buy'.

`BringListItemsDetailsResponse` `dataclass` ¶

Bases: DataClassORJSONMixin

A response class of a list of item details.

`BringListResponse` `dataclass` ¶

Bases: DataClassORJSONMixin

A list response class.

`BringNotificationsConfigType` ¶

Bases: TypedDict

A notification config.

`BringNotificationType` ¶

Bases: StrEnum

Notification type.

GOING_SHOPPING: "I'm going shopping! - Last chance for adjustments" CHANGED_LIST: "List changed - Check it out" SHOPPING_DONE: "Shopping done - you can relax" URGENT_MESSAGE: "Breaking news - Please get {itemName}! LIST_ACTIVITY_STREAM_REACTION: React with 🧐, 👍🏼, 🤤 or 💜 to activity

`BringPurchase` `dataclass` ¶

Bases: DataClassORJSONMixin

A purchase class. Represents a single item.

`BringSyncCurrentUserResponse` `dataclass` ¶

Bases: DataClassORJSONMixin

A sync current user response class.

`BringTemplate` `dataclass` ¶

Bases: BaseModel

Bring recipe.

Bring ¶

login async ¶

reload_user_list_settings async ¶

reload_article_translations async ¶

load_lists async ¶

get_list async ¶

get_all_item_details async ¶

save_item async ¶

update_item async ¶

remove_item async ¶

complete_item async ¶

notify async ¶

does_user_exist async ¶

__load_article_translations_from_file ¶

__load_article_translations async ¶

__translate ¶

__load_user_list_settings async ¶

get_all_user_settings async ¶

__locale ¶

map_user_language_to_locale ¶

get_user_account async ¶

batch_update_list async ¶

retrieve_new_access_token async ¶

set_list_article_language async ¶

get_activity async ¶

get_list_users async ¶

parse_recipe async ¶

create_template async ¶

delete_template async ¶

get_inspirations async ¶

get_inspiration_filters async ¶

BringAuthException ¶

BringEMailInvalidException ¶

BringParseException ¶

BringRequestException ¶

BringTranslationException ¶

BringUserUnknownException ¶

Activity dataclass ¶

ActivityReaction ¶

ActivityType ¶

Attribute dataclass ¶

BringActivityResponse dataclass ¶

BringAttribute ¶

BringAuthResponse dataclass ¶

BringAuthTokenResponse dataclass ¶

BringErrorResponse dataclass ¶

BringInspirationFiltersResponse dataclass ¶

BringInspirationsResponse dataclass ¶

BringItem ¶

BringItemOperation ¶

BringItemsResponse dataclass ¶

BringList dataclass ¶

BringListItemDetails dataclass ¶

BringListItemsDetailsResponse dataclass ¶

BringListResponse dataclass ¶

BringNotificationsConfigType ¶

BringNotificationType ¶

BringPurchase dataclass ¶

BringSyncCurrentUserResponse dataclass ¶

BringTemplate dataclass ¶

BringUser dataclass ¶

BringUserListSettingEntry dataclass ¶

BringUserSettingsEntry dataclass ¶

BringUserSettingsResponse dataclass ¶

BringUsersResponse dataclass ¶

Content dataclass ¶

Inspiration dataclass ¶

InspirationFilter dataclass ¶

Items dataclass ¶

PremiumConfiguration dataclass ¶

ReactionType ¶

Status ¶

TemplateType ¶

UserLocale dataclass ¶

`Bring` ¶

`login` `async` ¶

`reload_user_list_settings` `async` ¶

`reload_article_translations` `async` ¶

`load_lists` `async` ¶

`get_list` `async` ¶

`get_all_item_details` `async` ¶

`save_item` `async` ¶

`update_item` `async` ¶

`remove_item` `async` ¶

`complete_item` `async` ¶

`notify` `async` ¶

`does_user_exist` `async` ¶

`__load_article_translations_from_file` ¶

`__load_article_translations` `async` ¶

`__translate` ¶

`__load_user_list_settings` `async` ¶

`get_all_user_settings` `async` ¶

`__locale` ¶

`map_user_language_to_locale` ¶

`get_user_account` `async` ¶

`batch_update_list` `async` ¶

`retrieve_new_access_token` `async` ¶

`set_list_article_language` `async` ¶

`get_activity` `async` ¶

`get_list_users` `async` ¶

`parse_recipe` `async` ¶

`create_template` `async` ¶

`delete_template` `async` ¶

`get_inspirations` `async` ¶

`get_inspiration_filters` `async` ¶

`BringAuthException` ¶

`BringEMailInvalidException` ¶

`BringParseException` ¶

`BringRequestException` ¶

`BringTranslationException` ¶

`BringUserUnknownException` ¶

`Activity` `dataclass` ¶

`ActivityReaction` ¶

`ActivityType` ¶

`Attribute` `dataclass` ¶

`BringActivityResponse` `dataclass` ¶

`BringAttribute` ¶

`BringAuthResponse` `dataclass` ¶

`BringAuthTokenResponse` `dataclass` ¶

`BringErrorResponse` `dataclass` ¶

`BringInspirationFiltersResponse` `dataclass` ¶

`BringInspirationsResponse` `dataclass` ¶

`BringItem` ¶

`BringItemOperation` ¶

`BringItemsResponse` `dataclass` ¶

`BringList` `dataclass` ¶

`BringListItemDetails` `dataclass` ¶

`BringListItemsDetailsResponse` `dataclass` ¶

`BringListResponse` `dataclass` ¶

`BringNotificationsConfigType` ¶

`BringNotificationType` ¶

`BringPurchase` `dataclass` ¶

`BringSyncCurrentUserResponse` `dataclass` ¶

`BringTemplate` `dataclass` ¶

`BringUser` `dataclass` ¶

`BringUserListSettingEntry` `dataclass` ¶

`BringUserSettingsEntry` `dataclass` ¶

`BringUserSettingsResponse` `dataclass` ¶

`BringUsersResponse` `dataclass` ¶

`Content` `dataclass` ¶

`Inspiration` `dataclass` ¶

`InspirationFilter` `dataclass` ¶

`Items` `dataclass` ¶

`PremiumConfiguration` `dataclass` ¶

`ReactionType` ¶

`Status` ¶

`TemplateType` ¶

`UserLocale` `dataclass` ¶