Skip to content

GrandMoff100/MealieAPI

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

76 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mealie-image

⛔️Paused⛔️

Not actively being developed, I don't have the bandwidth to develop this anymore.

If anyone wants to become the steward of this project, open an issue and tell me what your plans are! I'd love for someone to help this project reach its full potential.

Mealie API

If you are running a self-hosted Mealie server you can use this library to authenticate yourself with and intereact with it! Create mealplans, import recipes, remove users, modify user groups, upload recipe images. All with MealieAPI.

Installation

$ pip install mealieapi

Usage

Authentication

To start you need your Mealie server url, and your login credentials or an API key (which you can create at https://[YOUR_MEALIE_SERVER]/admin/profile). MealieAPI uses the async/await syntax so you must run it inside an async function or event loop like so (if you are not familiar with async applications already.)

import asyncio
from mealieapi import MealieClient


client = MealieClient("<YOUR_MEALIE_SERVER_ADDRESS>")

This next part depends on whether you have an API key, or your login credentials.

If you want to use your username and password you must use await client.login("<USERNAME_OR_EMAIL>", "<PASSWORD>") or if you are using an API key you need to use client.authorize("<API_KEY>") (Note: without the await).

async def main():
    await client.login("<USERNAME_OR_EMAIL>", "<PASSWORD>")
    # OR
    client.authorize("<API_KEY>")

loop = asyncio.get_event_loop()
loop.run_until_complete(main())

Docs

A work in progress.

Contributions

All contributions are welcome! Thats what makes Open-Source so special.