Updated black-formatting.

# re-format python files,

# use local maximum line-length convention ..

black:

	black --line-length=99 py

	black --line-length=99 py 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,'py')) )

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

# -- Project information -----------------------------------------------------

project = 'CSO'

copyright = '2020-2023, Arjo Segers'

author = 'Arjo Segers'

project = "CSO"

copyright = "2020-2023, Arjo Segers"

author = "Arjo Segers"

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

release = 'v2.6.1'

release = "v2.6.1"

# -- General configuration ---------------------------------------------------

# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom

# ones.

extensions = [

    'sphinx.ext.autodoc',

    'sphinx.ext.intersphinx',

    'sphinx.ext.mathjax',

    "sphinx.ext.autodoc",

    "sphinx.ext.intersphinx",

    "sphinx.ext.mathjax",

]

# Add any paths that contain templates here, relative to this directory.

templates_path = ['_templates']

templates_path = ["_templates"]

# List of patterns, relative to source directory, that match files and

# directories to ignore when looking for source files.

# * 'show-inheritance'   : name of base class;

# * 'members'            : members of modules (classes) and classes (methods);

# * 'inherited-members'  : inherited members:

autodoc_default_options = {

    'members'           :   True,

    'show-inheritance'  :   True

}

autodoc_default_options = {"members": True, "show-inheritance": True}

# do not sort methods alphabetically, keep source order:

autodoc_member_order = 'bysource'

autodoc_member_order = "bysource"

# ~~ options for intersphinx

#   https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html

# add links to existing online documentation if present:

docs_url = 'https://docs.python.org/%i.%i' % (sys.version_info.major,sys.version_info.minor)

intersphinx_mapping = { 'python' : (docs_url,None) }

docs_url = "https://docs.python.org/%i.%i" % (sys.version_info.major, sys.version_info.minor)

intersphinx_mapping = {"python": (docs_url, None)}

# -- Options for HTML output -------------------------------------------------

# The theme to use for HTML and HTML Help pages.  See the documentation for

# a list of builtin themes.

#

html_theme = 'bizstyle'

html_theme = "bizstyle"

# Add any paths that contain custom static files (such as style sheets) here,

# relative to this directory. They are copied after the builtin static files,

# -- Options for intersphinx extension ---------------------------------------

# Example configuration for intersphinx: refer to the Python standard library.

intersphinx_mapping = {'https://docs.python.org/3/': None}

intersphinx_mapping = {"https://docs.python.org/3/": None}