Thank you for considering contributing to Transonic. Transonic is a community-driven project. It's people like you that make Transonic useful and successful. There are many ways to contribute, from writing tutorials or examples, improvements to the documentation, submitting bug reports and feature requests, or even writing code which can be incorporated into Transonic for everyone to use. (Paragraph shamelessly taken and adapted from the MetPy project!)
When opening an issue to report a problem
(https://foss.heptapod.net/fluiddyn/transonic/issues), please try to provide a minimal
code example that reproduces the issue along with details of the system you are using.
You can copy-paste the output of the command fluidinfo -v provided by the Python
package fluiddyn
(Github gists are good for that!).
Transonic is part of the wider project FluidDyn. For FluidDyn, we use the revision control software Mercurial and our main repositories are hosted here: https://foss.heptapod.net/fluiddyn.
Please read our documentation on developer essentials, and especially on setting up Mercurial.
We use PDM so the first step is to install this tool. Then, in the root directory of the repository, you can create and activate a local virtual environment with:
pdm install
source .venv/bin/activateThere is a Makefile with few useful commands. For example, one can run some tests with
make tests_python
make tests_pythranTo build the documentation:
cd doc
make cleanall
makeFor now, we push on PyPI manually:
hg pull
hg up default
hg tag 0.5.3
hg push
pdm publish