fabaccess-docs/docs/usage.md
2024-05-13 13:00:03 +02:00

35 lines
705 B
Markdown

Usage
=====
Installation
------------
To use Lumache, first install it using pip:
```console
(.venv) $ pip install lumache
```
Creating recipes
----------------
To retrieve a list of random ingredients, you can use the
`lumache.get_random_ingredients()` function:
::: lumache.get_random_ingredients
options:
show_root_heading: true
<br>
The `kind` parameter should be either `"meat"`, `"fish"`, or `"veggies"`.
Otherwise, [`get_random_ingredients`][lumache.get_random_ingredients] will raise an exception [`lumache.InvalidKindError`](/api#lumache.InvalidKindError).
For example:
```python
>>> import lumache
>>> lumache.get_random_ingredients()
['shells', 'gorgonzola', 'parsley']
```