Skip to content

lewisjared/fgen-example

Repository files navigation

Fgen Example

Example project using fgen to wrap a simple module

CI Coverage Docs

PyPI : PyPI PyPI: Supported Python versions PyPI install

Other info : License Last Commit Contributors

Full documentation can be found at: fgen-example.readthedocs.io. We recommend reading the docs there because the internal documentation links don't render correctly on GitHub's viewer.

Installation

TODO: set up this part of the workflow and test it (https://gitlab.com/magicc/copier-fgen-based-repository/-/issues/5)

Fgen Example can be installed with conda or pip:

pip install fgen-example
conda install -c conda-forge fgen-example

For developers

make virtual-environment
make fgen-wrappers
make build-fgen
make install
make test

TODO: update this because we have non-Python dependencies (related to https://gitlab.com/magicc/copier-fgen-based-repository/-/issues/6)

For development, we rely on poetry for all our dependency management. To get started, you will need to make sure that poetry is installed (instructions here, we found that pipx and pip worked better to install on a Mac).

For all of our work, we use our Makefile. You can read the instructions out and run the commands by hand if you wish, but we generally discourage this because it can be error prone. In order to create your environment, run make virtual-environment.

If there are any issues, the messages from the Makefile should guide you through. If not, please raise an issue in the issue tracker.

For the rest of our developer docs, please see .