sadda.recipe¶
Reproducibility primitive: a context manager that links operations
inside it to a named recipe_run row, plus a generated .py script
at block exit. PROVISIONAL tier.
See the quickstart for a worked example. Design rationale lives in the 2026-05-22 DEVLOG entry "Recipes (F1)".
record ¶
Opens a recipe block. Returns a context manager — use it in a
with statement.
:param project: a :class:sadda.Project.
:param name: unique recipe name within the project. Recording the
same name twice errors (UNIQUE constraint on
recipe_run.name).
:param parameters: optional dict of user-supplied metadata,
serialised to JSON and recorded in recipe_run.parameters.
Not interpreted by sadda; available to your own tooling via
:func:get.
list ¶
Lists every recipe in the project in id order.
get ¶
Fetches a single recipe by name. Raises if the name isn't found.
script_path ¶
Returns the conventional path to a recipe's .py script,
whether or not the file exists. Use this to discover where the
generator would write.
Recipe ¶
Python-side representation of one recipe_run row.
Source: crates/python/src/recipe.rs:17
__doc__
class-attribute
¶
str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str
Create a new string object from the given object. If encoding or errors is specified, then the object must expose a data buffer that will be decoded using the given encoding and error handler. Otherwise, returns the result of object.str() (if defined) or repr(object). encoding defaults to sys.getdefaultencoding(). errors defaults to 'strict'.
__module__
class-attribute
¶
str(object='') -> str str(bytes_or_buffer[, encoding[, errors]]) -> str
Create a new string object from the given object. If encoding or errors is specified, then the object must expose a data buffer that will be decoded using the given encoding and error handler. Otherwise, returns the result of object.str() (if defined) or repr(object). encoding defaults to sys.getdefaultencoding(). errors defaults to 'strict'.