Skip to content
This repository has been archived by the owner on Nov 19, 2024. It is now read-only.

Commit

Permalink
Docs: Updated docs for first publish
Browse files Browse the repository at this point in the history
  • Loading branch information
Seluj78 committed Jun 9, 2024
1 parent 2f2f400 commit e906890
Show file tree
Hide file tree
Showing 5 changed files with 9 additions and 31 deletions.
6 changes: 3 additions & 3 deletions .github/workflows/preview-docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@ name: Read the Docs PR preview
# to the documentation's preview on Read the Docs.

on:
pull_request:
branches:
- main
pull_request_target:
types:
- opened
paths:
- 'docs/**'
- '.github/workflows/preview-docs.yml'
Expand Down
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -127,3 +127,4 @@ dmypy.json

# Pyre type checker
.pyre/
docs/source/generated/
4 changes: 0 additions & 4 deletions docs/source/generated/flask_utils.rst

This file was deleted.

7 changes: 2 additions & 5 deletions docs/source/index.rst
Original file line number Diff line number Diff line change
@@ -1,10 +1,7 @@
Welcome to Lumache's documentation!
Welcome to Flask-Util'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.
**Flask Utils** is a Python library that contains a bunch of useful utilities for Flask applications.

Check out the :doc:`usage` section for further information, including
how to :ref:`installation` the project.
Expand Down
22 changes: 3 additions & 19 deletions docs/source/usage.rst
Original file line number Diff line number Diff line change
Expand Up @@ -10,24 +10,8 @@ To use Lumache, first install it using pip:

.. code-block:: console
(.venv) $ pip install lumache
(.venv) $ pip install flask-utils
Creating recipes
----------------
.. note::

To retrieve a list of random ingredients,
you can use the ``lumache.get_random_ingredients()`` function:

.. autofunction:: flask_utils.register_error_handlers

The ``kind`` parameter should be either ``"meat"``, ``"fish"``,
or ``"veggies"``. Otherwise, :py:func:`lumache.get_random_ingredients`
will raise an exception.

.. autoexception:: flask_utils.NotFoundError

For example:

>>> import lumache
>>> lumache.get_random_ingredients()
['shells', 'gorgonzola', 'parsley']
I am working on getting this package on PyPI. For now, you can install it through git

0 comments on commit e906890

Please sign in to comment.