mirror of
https://github.com/RetroDECK/RetroDECK.git
synced 2025-04-10 19:15:12 +00:00
Initializing ReadTheDocs [skip ci]
This commit is contained in:
parent
9e27dcee77
commit
d7cbf66527
|
@ -1,7 +0,0 @@
|
||||||
API
|
|
||||||
===
|
|
||||||
|
|
||||||
.. autosummary::
|
|
||||||
:toctree: generated
|
|
||||||
|
|
||||||
lumache
|
|
|
@ -1,35 +0,0 @@
|
||||||
# Configuration file for the Sphinx documentation builder.
|
|
||||||
|
|
||||||
# -- Project information
|
|
||||||
|
|
||||||
project = 'Lumache'
|
|
||||||
copyright = '2021, Graziella'
|
|
||||||
author = 'Graziella'
|
|
||||||
|
|
||||||
release = '0.1'
|
|
||||||
version = '0.1.0'
|
|
||||||
|
|
||||||
# -- General configuration
|
|
||||||
|
|
||||||
extensions = [
|
|
||||||
'sphinx.ext.duration',
|
|
||||||
'sphinx.ext.doctest',
|
|
||||||
'sphinx.ext.autodoc',
|
|
||||||
'sphinx.ext.autosummary',
|
|
||||||
'sphinx.ext.intersphinx',
|
|
||||||
]
|
|
||||||
|
|
||||||
intersphinx_mapping = {
|
|
||||||
'python': ('https://docs.python.org/3/', None),
|
|
||||||
'sphinx': ('https://www.sphinx-doc.org/en/master/', None),
|
|
||||||
}
|
|
||||||
intersphinx_disabled_domains = ['std']
|
|
||||||
|
|
||||||
templates_path = ['_templates']
|
|
||||||
|
|
||||||
# -- Options for HTML output
|
|
||||||
|
|
||||||
html_theme = 'sphinx_rtd_theme'
|
|
||||||
|
|
||||||
# -- Options for EPUB output
|
|
||||||
epub_show_urls = 'footnote'
|
|
|
@ -1,22 +0,0 @@
|
||||||
Welcome to Lumache's documentation!
|
|
||||||
===================================
|
|
||||||
|
|
||||||
**Lumache** (/lu'make/) is a Python library for cooks and food lovers
|
|
||||||
that creates recipes mixing random ingredients.
|
|
||||||
It pulls data from the `Open Food Facts database <https://world.openfoodfacts.org/>`_
|
|
||||||
and offers a *simple* and *intuitive* API.
|
|
||||||
|
|
||||||
Check out the :doc:`usage` section for further information, including
|
|
||||||
how to :ref:`installation` the project.
|
|
||||||
|
|
||||||
.. note::
|
|
||||||
|
|
||||||
This project is under active development.
|
|
||||||
|
|
||||||
Contents
|
|
||||||
--------
|
|
||||||
|
|
||||||
.. toctree::
|
|
||||||
|
|
||||||
usage
|
|
||||||
api
|
|
|
@ -1,34 +0,0 @@
|
||||||
Usage
|
|
||||||
=====
|
|
||||||
|
|
||||||
.. _installation:
|
|
||||||
|
|
||||||
Installation
|
|
||||||
------------
|
|
||||||
|
|
||||||
To use Lumache, first install it using pip:
|
|
||||||
|
|
||||||
.. code-block:: console
|
|
||||||
|
|
||||||
(.venv) $ pip install lumache
|
|
||||||
|
|
||||||
Creating recipes
|
|
||||||
----------------
|
|
||||||
|
|
||||||
To retrieve a list of random ingredients,
|
|
||||||
you can use the ``lumache.get_random_ingredients()`` function:
|
|
||||||
|
|
||||||
.. autofunction:: lumache.get_random_ingredients
|
|
||||||
|
|
||||||
The ``kind`` parameter should be either ``"meat"``, ``"fish"``,
|
|
||||||
or ``"veggies"``. Otherwise, :py:func:`lumache.get_random_ingredients`
|
|
||||||
will raise an exception.
|
|
||||||
|
|
||||||
.. autoexception:: lumache.InvalidKindError
|
|
||||||
|
|
||||||
For example:
|
|
||||||
|
|
||||||
>>> import lumache
|
|
||||||
>>> lumache.get_random_ingredients()
|
|
||||||
['shells', 'gorgonzola', 'parsley']
|
|
||||||
|
|
Loading…
Reference in a new issue