Merge branch 'release-tag' into 'master'

# re-format python files,

# use local maximum line-length convention ..

black:

	black --line-length=99 py doc/source/conf.py

	black --line-length=99 src doc/source/conf.py

# generate documentation:

docu:

#

import os

import sys

#

sys.path.insert(0, os.path.abspath(os.path.join(os.pardir, os.pardir, "src")))

sys.path.insert(0, os.path.abspath(os.path.join(os.pardir, os.pardir, "src", "utopya")))

else:

    # modules:

    import toml

    # open file:

    with open(ppfile, "r") as f:

        config = toml.load(f)

How to create a version tag

===========================

Example for tag "v2.11".

Example for tag "v2.12".

1. Update file formatting following conventions.

   b. Update the source file `doc/source/history.rst <../../source/history.rst>`_ of this chapter.

   c. Change the release tag that will be shown in the documentation in the file

      `doc/source/conf.py <../../source/conf.py>`_::

   c. Change the release tag that will also be imported to the documenation in the `pyproject.toml <../../../pyproject.toml>`_ file::

        # The full version, including alpha/beta/rc tags

        release = "v2.11"

        release = "2.12"

   d. Commit and push these changes::

       git commit -m 'Defined v2.11' .

       git commit -m 'Defined v2.12' .

       git push

4. Tag and push the code to the git repository::

      git tag -a 'v2.11' -m 'Tagged v2.11'

      git push origin v2.11

      git tag -a 'v2.12' -m 'Tagged v2.12'

      git push origin v2.12

# store version number:

from importlib import metadata

__version__ = metadata.version(__package__)

# import entities from sub-modules:

):

    """🛰️  CAMS Satellite Operator (CSO) Command Line Interface"""

@main.command()

def run(rc_file: str = typer.Argument(..., help="Provide .rc file")):

    """Run cso based on settings provided in .rc file (e.g., cso run config/tutorial/tutorial.rc)"""