Skip to main content

Our Groceries Unofficial Python Package

Project description

Unofficial asyncio python wrapper for the Our Groceries API. This library requires Python >=3.5.


pip install ourgroceries


import asyncio
from ourgroceries import OurGroceries

username = ''
password = ''

og = OurGroceries(username, password)

loop = asyncio.get_event_loop()

my_lists = loop.run_until_complete(og.get_my_lists())

my_todo_list = loop.run_until_complete(og.get_list_items(list_id=''))


def login()

Logs into our groceries

def get_my_lists()

Gets all of your lists

def get_category_items()

Gets all of your category items

def get_list_items(list_id)

Gets the items for a list

def create_list(name, list_type='SHOPPING')

Creates a new list. list_type can be 'RECIPES' or 'SHOPPING'

def create_category(name)

Create a new category

def toggle_item_crossed_off(list_id, item_id, cross_off=False)

Toggle a list item's crossed off property based on cross_off

def add_item_to_list(list_id, value, category="uncategorized")

Adds a new item to a given list/category

def remove_item_from_list(list_id, item_id)

Removes an item from a given list


throws InvalidLoginException if can't login.



python3 -m pip install --user --upgrade setuptools wheel
python3 -m pip install --user --upgrade twine

increment version in ``
delete build folder

python3 sdist bdist_wheel
twine upload --repository ourgroceries dist/*

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

ourgroceries-1.3.10.tar.gz (4.7 kB view hashes)

Uploaded source

Built Distribution

ourgroceries-1.3.10-py3-none-any.whl (5.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page