Skip to main content

Unofficial python package to access Bring! shopping lists API.

Project description

Bring Shopping Lists API

An unofficial python package to access the Bring! shopping lists API.

This is a minimal python port of the node-bring-api by foxriver76. All credit goes to him for making this awesome API possible!

Disclaimer

The developers of this module are in no way endorsed by or affiliated with Bring! Labs AG, or any associated subsidiaries, logos or trademarks.

Installation

pip install python-bring-api

Documentation

See below for usage examples. See Exceptions for API-specific exceptions and mitigation strategies for common exceptions.

Usage Example

The API is available both sync and async, where sync is the default for simplicity. Both implementations of each function use the same async HTTP library aiohttp in the back.

Sync

import logging
import sys

from python_bring_api.bring import Bring

logging.basicConfig(stream=sys.stdout, level=logging.DEBUG)

# Create Bring instance with email and password
bring = Bring("MAIL", "PASSWORD")
# Login
bring.login()

# Get information about all available shopping lists
lists = bring.loadLists()["lists"]

# Save an item with specifications to a certain shopping list
bring.saveItem(lists[0]['listUuid'], 'Milk', 'low fat')

# Save another item
bring.saveItem(lists[0]['listUuid'], 'Carrots')

# Get all the items of a list
items = bring.getItems(lists[0]['listUuid'])
print(items)

# Check off an item
bring.completeItem(lists[0]['listUuid'], 'Carrots')

# Remove an item from a list
bring.removeItem(lists[0]['listUuid'], 'Milk')

Async

import aiohttp
import asyncio
import logging
import sys

from python_bring_api.bring import Bring

logging.basicConfig(stream=sys.stdout, level=logging.DEBUG)

async def main():
  async with aiohttp.ClientSession() as session:
    # Create Bring instance with email and password
    bring = Bring("MAIL", "PASSWORD", sessionAsync=session)
    # Login
    await bring.loginAsync()

    # Get information about all available shopping lists
    lists = (await bring.loadListsAsync())["lists"]

    # Save an item with specifications to a certain shopping list
    await bring.saveItemAsync(lists[0]['listUuid'], 'Milk', 'low fat')

    # Save another item
    await bring.saveItemAsync(lists[0]['listUuid'], 'Carrots')

    # Get all the items of a list
    items = await bring.getItemsAsync(lists[0]['listUuid'])
    print(items)

    # Check off an item
    await bring.completeItemAsync(lists[0]['listUuid'], 'Carrots')

    # Remove an item from a list
    await bring.removeItemAsync(lists[0]['listUuid'], 'Milk')

asyncio.run(main())

Exceptions

In case something goes wrong during a request, several exceptions can be thrown. They will either be BringRequestException, BringParseException, or BringAuthException, depending on the context. All inherit from BringException.

Another asyncio event loop is already running

Because even the sync methods use async calls under the hood, you might encounter an error that another asyncio event loop is already running on the same thread. This is expected behavior according to the asyncio.run() documentation. You cannot call the sync methods when another event loop is already running. When you are already inside an async function, you should use the async methods instead.

Exception ignored: RuntimeError: Event loop is closed

Due to a known issue in some versions of aiohttp when using Windows, you might encounter a similar error to this:

Exception ignored in: <function _ProactorBasePipeTransport.__del__ at 0x00000000>
Traceback (most recent call last):
  File "C:\...\py38\lib\asyncio\proactor_events.py", line 116, in __del__
    self.close()
  File "C:\...\py38\lib\asyncio\proactor_events.py", line 108, in close
    self._loop.call_soon(self._call_connection_lost, None)
  File "C:\...\py38\lib\asyncio\base_events.py", line 719, in call_soon
    self._check_closed()
  File "C:\...\py38\lib\asyncio\base_events.py", line 508, in _check_closed
    raise RuntimeError('Event loop is closed')
RuntimeError: Event loop is closed

You can fix this according to this stackoverflow answer by adding the following line of code before executing the library:

asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())

Changelog

3.0.0

Change backend library from requests to aiohttp, thanks to @miaucl! This makes available async versions of all methods.

Fix encoding of request data, thanks to @miaucl!

2.1.0

Add notify() method to send push notifications to other list members, thanks to @tr4nt0r!

Add method to complete items, thanks to @tr4nt0r!

Fix error handling in login method, thanks to @tr4nt0r!

2.0.0

Add exceptions and typings, thanks to @miaucl!

Important: Unsuccessful HTTP status codes will now raise an exception.

Module now requires Python version >= 3.8.

1.2.2

Clean up unused code 🧹

1.2.1

Fix encoding in login request, thanks to @tony059!

1.2.0

Add function to update an item, thanks to @Dielee!

1.1.2

Add option to provide own headers, thanks to @Dielee!

1.1.0

Add item details endpoint, thanks to @Dielee!

1.0.2

Fixed error handling Added response return to login

1.0.1

Add github repo

1.0.0

Initial release

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-bring-api-3.0.0.tar.gz (10.5 kB view details)

Uploaded Source

Built Distribution

python_bring_api-3.0.0-py3-none-any.whl (8.6 kB view details)

Uploaded Python 3

File details

Details for the file python-bring-api-3.0.0.tar.gz.

File metadata

  • Download URL: python-bring-api-3.0.0.tar.gz
  • Upload date:
  • Size: 10.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.4

File hashes

Hashes for python-bring-api-3.0.0.tar.gz
Algorithm Hash digest
SHA256 f612c631b549ae8cff2ec5bbbc86247446762bf91afea5a9f6ffbd9bdeb922ec
MD5 c9f06dc5bc72646c9f426149d9c4142e
BLAKE2b-256 85669ae35b80b3903fee45e9cb401e44dfeb7e53cd0f6f0f53ba79db6e377598

See more details on using hashes here.

File details

Details for the file python_bring_api-3.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for python_bring_api-3.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 937517638a7e96205dbc10804b089ed15e038d1fe2f012862f86cd394c3e1a01
MD5 919b153d7319c1dd7fdc026d98a02ef1
BLAKE2b-256 35a458b8c7398f6130b7d0dc51e478a0c52467ef856d6b3c813ce7908e8688bf

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page