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

Commit e906890

Browse files
committed
Docs: Updated docs for first publish
1 parent 2f2f400 commit e906890

File tree

5 files changed

+9
-31
lines changed

5 files changed

+9
-31
lines changed

.github/workflows/preview-docs.yml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,9 @@ name: Read the Docs PR preview
33
# to the documentation's preview on Read the Docs.
44

55
on:
6-
pull_request:
7-
branches:
8-
- main
6+
pull_request_target:
7+
types:
8+
- opened
99
paths:
1010
- 'docs/**'
1111
- '.github/workflows/preview-docs.yml'

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -127,3 +127,4 @@ dmypy.json
127127

128128
# Pyre type checker
129129
.pyre/
130+
docs/source/generated/

docs/source/generated/flask_utils.rst

Lines changed: 0 additions & 4 deletions
This file was deleted.

docs/source/index.rst

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,7 @@
1-
Welcome to Lumache's documentation!
1+
Welcome to Flask-Util's documentation!
22
===================================
33

4-
**Lumache** (/lu'make/) is a Python library for cooks and food lovers
5-
that creates recipes mixing random ingredients.
6-
It pulls data from the `Open Food Facts database <https://world.openfoodfacts.org/>`_
7-
and offers a *simple* and *intuitive* API.
4+
**Flask Utils** is a Python library that contains a bunch of useful utilities for Flask applications.
85

96
Check out the :doc:`usage` section for further information, including
107
how to :ref:`installation` the project.

docs/source/usage.rst

Lines changed: 3 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -10,24 +10,8 @@ To use Lumache, first install it using pip:
1010

1111
.. code-block:: console
1212
13-
(.venv) $ pip install lumache
13+
(.venv) $ pip install flask-utils
1414
15-
Creating recipes
16-
----------------
15+
.. note::
1716

18-
To retrieve a list of random ingredients,
19-
you can use the ``lumache.get_random_ingredients()`` function:
20-
21-
.. autofunction:: flask_utils.register_error_handlers
22-
23-
The ``kind`` parameter should be either ``"meat"``, ``"fish"``,
24-
or ``"veggies"``. Otherwise, :py:func:`lumache.get_random_ingredients`
25-
will raise an exception.
26-
27-
.. autoexception:: flask_utils.NotFoundError
28-
29-
For example:
30-
31-
>>> import lumache
32-
>>> lumache.get_random_ingredients()
33-
['shells', 'gorgonzola', 'parsley']
17+
I am working on getting this package on PyPI. For now, you can install it through git

0 commit comments

Comments
 (0)