Install the GALACTIC core kernel

Prerequisite

galactic-core-kernel 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-core-kernel using the bash command

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

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

Build

Building galactic-core-kernel requires

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

• graphviz, which is a graph visualization software;

• plantuml, which is a software able to produce schema from uml sources. This software is only useful for producing the documentation.

Build galactic-core-kernel using the bash command

$ hatch build

Documentation

Build the documentation using the bash command:

$ hatch run docs:build

Testing

Test galactic-core-kernel using the bash commands:

$ 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-core-kernel 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.

Getting Help

Important

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