A drainage basin collects all precipitation in an area, first in to smaller streams and finally in to a large river. Similarly, Konfluks brings together small streams of web content from different places together in a single large stream.
Go to file
rra b0f77831bd add 'contributors' as metadata category 2022-06-02 06:45:54 +02:00
lumbunglib add 'contributors' as metadata category 2022-06-02 06:45:54 +02:00
.gitignore feat: pull posts from mastodon 2022-01-10 15:07:04 +01:00
LICENSE.md add agplv3 license 2022-02-16 13:02:55 +01:00
README.md hacking docs 2022-02-07 13:47:11 +01:00
poetry.lock Revert "feed: move to saneyaml" 2022-04-13 12:48:13 +02:00
pyproject.toml Revert "feed: move to saneyaml" 2022-04-13 12:48:13 +02:00
setup.py feat: pull posts from mastodon 2022-01-10 15:07:04 +01:00

README.md

lumbunglib

Python lib which powers lumbung.space automation

hacking

Install poetry:

curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python -

We use Poetry because it locks the dependencies all the way down and makes it easier to manage installation & maintenance in the long-term. Then install the dependencies & have them managed by Poetry:

poetry install

Each script requires some environment variables to run, you can see the latest deployment configuration over here, look for the values under the environment: ... stanza.

All scripts have an entrypoint described in the pypoetry.toml which you can run via poetry run .... For example, if you want to run the lumbunglib/video.py script, you'd do:

mkdir -p testdir
export OUTPUT_DIR=/testdir
poetry run lumbunglib-vid

Run poetry run poetry2setup > setup.py if updating the poetry dependencies. This allows us to run pip install . in the deployment and Pip will understand that it is just a regular Python package. If adding a new cli command, extend pyproject.toml with a new [tool.poetry.scripts] entry.