Instructions#
Prerequisites#
galactic-description-numerical-hull requires Python 3.11, a programming language that comes preinstalled on Linux and macOS, and is easy to install on Windows;
Installation#
First, install galactic in a virtual environment (conda or venv)
using the instructions in the
Quick start guide.
Then, install galactic-description-numerical-hull in the same environment using the following bash command:
(galactic) $ pip install "galactic-description-numerical-hull[docs]"
Donโt forget to add the --pre flag if you want the latest unstable build.
If you want to verify package integrity using hashes, you can install galactic-description-numerical-hull in the same environment with one of the following bash commands:
(galactic) $ pip install -r https://www.thegalactic.org/requirements/stable/galactic-description-numerical-hull.txt
(galactic) $ pip install -r https://www.thegalactic.org/requirements/stable/galactic-description-numerical-hull_docs.txt
For the pre-release version, use one of the following bash commands:
(galactic) $ pip install -r https://www.thegalactic.org/requirements/pre/galactic-description-numerical-hull.txt
(galactic) $ pip install -r https://www.thegalactic.org/requirements/pre/galactic-description-numerical-hull_docs.txt
Contributing#
Build#
To build galactic-description-numerical-hull, you need:
hatch, a tool for dependency management and packaging in Python;
graphviz, graph visualization software;
Build galactic-description-numerical-hull using the following bash command:
$ hatch build
Testing#
Test galactic-description-numerical-hull using the following bash command:
$ hatch test
to run the tests.
$ hatch test --cover
to run the tests with coverage.
$ hatch test --doctest-modules src
to run the doctests.
Linting#
Lint galactic-description-numerical-hull using the following bash commands:
$ hatch check
to run linting.
$ hatch check --fix
to automatically fix linting issues.
Documentation#
Build the documentation using the following bash command:
$ hatch run docs:build
Getting Help#
Important
If you have any difficulties with galactic-description-numerical-hull, please feel free to file an issue on GitLab so that we can help.