GALACTIC convex algebra instructions

GALACTIC convex algebra instructions#

hatch pre-commit ruff black doc8 mypy pylint slotscheck

Prerequisite#

galactic-algebra-convex requires python 3.10, a programming language that comes pre-installed on linux and Mac OS X, and which is easily installed on Windows;

Installation#

Install galactic-algebra-convex using the bash command

$ pip install \
    --index-url https://gitlab.univ-lr.fr/api/v4/groups/galactic/-/packages/pypi/simple \
    galactic-algebra-convex[docs]

The docs extra needs an install of graphviz. Donโ€™t forget to add the --pre flag if you want the latest unstable build.

Contributing#

Build#

Building galactic-algebra-convex requires

  • hatch, which is a tool for dependency management and packaging in Python;

  • graphviz, which is a graph visualization software;

Build galactic-algebra-convex using the bash command

$ hatch build

Testing#

Test galactic-algebra-convex using the bash command:

$ hatch test

for running the tests.

$ hatch test --cover

for running the tests with the coverage.

$ hatch test --doctest-modules src

for running the doctest.

Linting#

Lint galactic-algebra-convex using the bash commands:

$ hatch fmt --check

for running static linting.

$ hatch fmt

for automatic fixing of static linting issues.

$ hatch run lint:check

for running dynamic linting.

Documentation#

Build the documentation using the bash commands:

$ hatch run docs:build

Getting Help#

Important

If you have any difficulties with galactic-algebra-convex, please feel welcome to file an issue on gitlab so that we can help.