| Age | Commit message (Collapse) | Author |
|---|
|
This is not 100% fietsboek, but it's closely related, and I don't think
setting up a separate site for hittekaart is worth it. At the moment,
this is a bit WIP, as the module sits in its own branch in the
hittekaart repository, but in the long run I want to use this. It also
is an experiment to see how well PyO3 works, as we potentially want to
migrate other parts of fietsboek to Rust in the future (no specifics
yet, but keeping the option available is nice).
In tox.ini, we disable -f for sphinx-apidoc, so that it doesn't
overwrite the modules.rst file. This means that the directory must be
clean if you re-generate the docs (it is on the CI server).
Also, we un-gitignore the modules.rst and hittekaart_py.rst files, as
special cases. The others are still auto-generated, so all good, but
these two we need.
|
|
I'm not the biggest fan of combining many package managers, but the
JavaScript libraries (Bootstrap, Bootstrap-Icons, later the @types
modules and Leaflet) are easy to get via npm, so maybe we can use that
to our advantage and have npm at least download them.
|
|
We have so many nice docstrings, but they aren't really rendered
anywhere (expect locally in your IDE), as we did not include the API
docs anywhere.
This change uses sphinx-apidoc to generate autodoc stubs for Sphinx, so
that the docstrings are actually rendered to HTML. This is not perfect
yet (I'm not too happy about the default modules.rst simply listing one
package), but it is good enough for the start and makes it possible to
actually browse the docstrings in a browser.
|
|
|
|
setup.py is the very old style for packaging, so I wanted to replace it
with something more "modern". pyproject.toml seems like the way to go in
the future.
At first, I wanted to simply configure setuptools using pyproject.toml,
but that support is in beta and seemed to cause some issues with the tox
virtualenvs.
Poetry seems to work fine and provides a better dependency resolver
(given that dependencies are actually specified well) and some other
goodies. For users, nothing much should change, as "pip install" still
works.
|
|
|
|
|
|
|
