Add custom recipe creation, editing and deletion API by Mariosd23 · Pull Request #179 · miaucl/cookidoo-api

Mariosd23 · 2026-03-25T18:09:26Z

This PR adds the ability to create custom recipes from scratch (not just copy existing ones).

New Features

Custom Recipe API

create_custom_recipe() - Create new recipes from scratch with full details
edit_custom_recipe() - Edit existing custom recipes
get_custom_recipes() - List all custom recipes
remove_custom_recipe() - Delete custom recipes

Structured Step Settings

Support for CookidooInstruction with CookidooStepSettings (time, temperature, speed)
Allows guided cooking instructions with Thermomix presets

Usage Example

from cookidoo_api.types import CookidooCreateCustomRecipe

recipe = CookidooCreateCustomRecipe(
    name="My Recipe",
    ingredients=["100g flour", "2 eggs"],
    instructions=["Mix", "Bake"],
    serving_size=4,
    total_time=3600,
    active_time=1800,
    tools=["TM6"],
    unit_text="portion"
)
result = await api.create_custom_recipe(recipe)

Technical Details

Uses POST to create blank recipe, then PATCH to add full details
Ingredient format: {"type": "INGREDIENT", "text": "..."}
Step format: {"type": "STEP", "text": "..."}
unit_text must be exactly "portion"

Tests

Unit tests added to tests/test_cookidoo.py with proper mocked responses
Smoke tests consolidated into smoke_test/test_2_methods.py

All existing functionality remains unchanged. This only adds new capabilities.

…cratch)

…uided cooking

…ognition

…ettingsXsettings)

…ork)

miaucl

Thx for helping out!
Please keep your SKILL.md in your own fork.
Also, I dont see any unit test coverage nor extension on the smoke tests. For a volatile library as this where we don't know when the API changes such things are essential.

…moke tests - Remove SKILL.md from repo (keep in fork only per maintainer request) - Add comprehensive unit tests in tests/test_edge_cases.py: * Config & localization tests (12 variants) * Auth edge cases (token expiry, invalid refresh) * Network resilience (5xx errors, timeouts) * API volatility protection (missing/extra fields) * Recipe CRUD with structured instructions * Calendar & shopping list edge cases - Extend smoke tests in smoke_test/test_3_extended.py: * Full recipe lifecycle tests * Multi-day calendar operations * Complete shopping list workflow * Collection management (custom + managed) * Error handling scenarios Total: 2,050+ lines of new test coverage

Mariosd23 · 2026-04-01T18:18:08Z

Hi @miaucl,

Thank you for creating and maintaining this API

it's been incredibly useful!

I've addressed all the feedback:

Removed SKILL.md
Added comprehensive unit tests in tests/test_edge_cases.py
Extended smoke tests in smoke_test/test_3_extended.py
All checks are passing. Ready for your re-review when you have a moment!

miaucl

Looks better :)

Please structure the unit tests and smoke tests better and "test_3_extended" is not a good name. There are some custom recipe tests in the test_edge_case which does not fit as well.

miaucl · 2026-04-02T10:49:51Z

@@ -1,5 +1,7 @@
 """Cookidoo API types."""

+from __future__ import annotations


is this needed? until know, I had the type def without the need for future

You're right, it's not needed! I reordered the classes so CookidooStepSettings and CookidooInstruction are defined before CookidooCreateCustomRecipe and CookidooEditCustomRecipe, eliminating the forward reference. Removed the __future__ import.

miaucl · 2026-04-02T10:50:57Z

+            active_time=30*60,    # 30 minutes active prep
+            unit_text="portion",  # IMPORTANT: Must be exactly "portion"
+            tools=["TM7", "TM6"],  # Works with both TM7 and TM6 models
+            ingredients=[


possible to have the example in english? More people will be able to read it ;)

miaucl · 2026-04-02T10:53:51Z

+        assert result1.access_token == "test_token"
+
+
+class TestRecipeOperations:


these are not really edge cases, rather just unit tests for custom recipes, no?

miaucl · 2026-04-02T10:54:36Z

file unneeded

miaucl · 2026-04-02T10:56:58Z

The file test_2_methods.py is getting pretty large, but all smoke tests should be in there for now.

miaucl · 2026-04-02T10:57:41Z

also, please run the linter and formatter before pushing, see readme for instrcutions

miaucl

Guess there is still some work to do in the testing :)

- Remove from __future__ import annotations from types.py - Translate example recipe from Greek to English - Rename test_edge_cases.py to test_custom_recipes.py - Remove PR_RESPONSE.md - Consolidate smoke tests into test_2_methods.py, remove test_3_extended.py - Add examples/ to ruff per-file-ignores for T20 - Fix formatting and lint issues (ruff)

facandiav · 2026-04-17T05:15:30Z

@miaucl , is there a burner account to test hardware annotations on recipe creation? I pulled some rest transactions from my account and rev-engineered. Would be great to smoke test. - this would be another workstream

- Extract _format_instructions helper in helpers.py - Move custom recipe unit tests into test_cookidoo.py with proper mocks - Remove standalone test_custom_recipes.py and examples/create_recipe.py - Fix type annotations in types.py

Move CookidooStepSettings and CookidooInstruction before CookidooCreateCustomRecipe and CookidooEditCustomRecipe to eliminate forward references, removing the need for __future__ annotations.

Send time, temperature, and speed as separate fields in the instruction JSON payload so the Cookidoo app can render them as formatted settings (like the mobile app does) instead of plain text.

miaucl · 2026-05-03T22:17:40Z

@miaucl , is there a burner account to test hardware annotations on recipe creation? I pulled some rest transactions from my account and rev-engineered. Would be great to smoke test. - this would be another workstream

What do you mean with burner account? I already have set up accounts for different countries for the smoke tests. You can create easily test accounts for yourself if you need to test something. (Just need an new email ^^)

Or did I misunderstand you?

Marios added 2 commits March 25, 2026 19:59

Add skill documentation and example for custom recipe creation

1dbd68e

Add custom recipe creation and editing API (create, edit, list from s…

33a2f65

…cratch)

github-actions Bot added the 📖 documentation Improvements or additions to documentation label Mar 25, 2026

Marios added 11 commits March 25, 2026 20:11

Update documentation: Add multi-device support (TM5/TM6/TM31)

a2d4b9e

Update: TM7/TM6 compatibility (newest models)

111f3fe

Add structured step settings support (time, temperature, speed) for g…

512f586

…uided cooking

Update SKILL.md with structured step settings documentation

11b821e

Fix: Add __future__ annotations for forward references in types

90ad752

Fix: Remove duplicate EditCustomRecipeRequestJSON definition

ca8429a

Fix: Remove duplicate code in raw_types.py

c787b21

Add preset trigger format: duplicated settings text for Thermomix rec…

5ee821d

…ognition

Fix preset format: use correct time values in duplication pattern

a58e7ae

Fix: Use TRIPLE duplication format for preset recognition (settingsXs…

f481363

…ettingsXsettings)

Revert to simple format: settings shown once (preset trigger didn't w…

baacd1b

…ork)

miaucl self-requested a review April 1, 2026 15:52

miaucl requested changes Apr 1, 2026

View reviewed changes

github-actions Bot added the 🧪 testing Pull request that adds tests label Apr 1, 2026

miaucl reviewed Apr 2, 2026

View reviewed changes

miaucl added the run smoke test Smoke test requires secrets, only run after review label Apr 2, 2026

miaucl requested changes Apr 2, 2026

View reviewed changes

Mariosd23 force-pushed the main branch from f7d3a9f to 97d2d28 Compare April 5, 2026 19:29

Mariosd23 requested a review from miaucl April 5, 2026 19:32

facandiav and others added 2 commits April 17, 2026 15:05

Remove from __future__ import annotations by reordering classes

e66d582

Move CookidooStepSettings and CookidooInstruction before CookidooCreateCustomRecipe and CookidooEditCustomRecipe to eliminate forward references, removing the need for __future__ annotations.

Mariosd23 changed the title ~~Add custom recipe creation API and OpenClaw skill documentation~~ Add custom recipe creation, editing and deletion API Apr 17, 2026

Mariosd23 force-pushed the main branch from fe1a12a to e66d582 Compare April 17, 2026 12:17

Pass structured step settings as JSON fields instead of text

6ec430f

Send time, temperature, and speed as separate fields in the instruction JSON payload so the Cookidoo app can render them as formatted settings (like the mobile app does) instead of plain text.

		@@ -1,5 +1,7 @@
		"""Cookidoo API types."""

		from __future__ import annotations

		assert result1.access_token == "test_token"


		class TestRecipeOperations:

Uh oh!

Conversation

Mariosd23 commented Mar 25, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

New Features

Custom Recipe API

Structured Step Settings

Usage Example

Technical Details

Tests

Uh oh!

miaucl left a comment

Choose a reason for hiding this comment

Uh oh!

Mariosd23 commented Apr 1, 2026

Uh oh!

miaucl left a comment

Choose a reason for hiding this comment

Uh oh!

miaucl Apr 2, 2026

Choose a reason for hiding this comment

Uh oh!

Mariosd23 Apr 17, 2026

Choose a reason for hiding this comment

Uh oh!

miaucl Apr 2, 2026

Choose a reason for hiding this comment

Uh oh!

miaucl Apr 2, 2026

Choose a reason for hiding this comment

Uh oh!

miaucl Apr 2, 2026

Choose a reason for hiding this comment

Uh oh!

Mariosd23 Apr 17, 2026

Choose a reason for hiding this comment

Uh oh!

miaucl commented Apr 2, 2026

Uh oh!

miaucl commented Apr 2, 2026

Uh oh!

miaucl left a comment

Choose a reason for hiding this comment

Uh oh!

facandiav commented Apr 17, 2026

Uh oh!

miaucl commented May 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Mariosd23 commented Mar 25, 2026 •

edited

Loading