Merge branch 'main' into 365-address-squeeze-related-deprecation-warning-in-generic-plots

test:py313:

  extends: test:py39

  image: python:3.13-rc  # TODO update once released

  allow_failure: true

  image: python:3.13

  script:

    - tox -v -e py313

# ... for building the documentation (and potentially more jobs)

build:docs:

  image: python:3.8   # to be identical to ReadTheDocs build

  image: python:3.10   # to be identical to ReadTheDocs build

  stage: build

  allow_failure: true

  needs: []

  # Run if desiring to make use of newer language features

  - repo: https://github.com/asottile/pyupgrade

    rev: v3.17.0

    rev: v3.19.0

    hooks:

    - id: pyupgrade

      name: upgrade python syntax

        args: [--project=dantro]

  - repo: https://github.com/psf/black

    rev: 24.8.0

    rev: 24.10.0

    hooks:

      - id: black

        name: black code formatting

        name: check RST backticks

  - repo: https://github.com/pre-commit/pre-commit-hooks

    rev: v4.6.0

    rev: v5.0.0

    hooks:

      - id: end-of-file-fixer

        name: fix end of files

# Changelog

`dantro` aims to adhere to [semantic versioning](https://semver.org/).  

However, given the rather burst-like development on this package, features are often released immediately, sometimes also as a "patch" (`+0.0.1`) release.

## v0.20.3 *(Work in Progress)*

- !365 allows to specify `max_workers` for parallel plotting as a float-value that denotes the fraction of available CPUs that should be used, making plot configurations more machine-averse.

## v0.20.2

- !364 adds the `without_edges` option to `GraphGroup.create_graph`, allowing ignore an edge container and create a graph only with nodes.

## v0.20.1

- !362 replaces the deprecated `pkg_resources` with `importlib.resources`.

## v0.20.0

- !352 adds the `parallel` key to the plot configuration, allowing to execute `ParamSpace`-based plots in separate threads or processes; this can significantly speed up plot creation if there are many plots to be made (and individual plots need more time than spawning the plot executor).

- !358 adds numpy >= 2.0 compatibility.

- !349 adds Windows support for dantro by ensuring paths are consistently formatted in Posix-style

- !355 improves automatic `col_wrap` in facet grid plots by using a simple optimization routine to maximize the fill ratio of the last row of a facet grid plot while trying to stay close to a square-like grid.

  The old behaviour (which may create lonely plots in the last row) is retained by setting `col_wrap: square`.

#### Bug fixes

- !359 fixes an error in the `.plot.facet_grid.scatter` base plot configuration.

#### Internal

- !360 drops testing for Python 3.8 — while dantro (or at least most parts of it) *probably* still works for that release, it will no longer be actively tested as of v0.20 due to complications in dependency management.

## v0.20.0b3

- !359 fixes an error in the `.plot.facet_grid.scatter` base plot configuration.

To assert correct functionality, tests are written alongside all features.

The [`pytest`][pytest] and [`tox`][tox] packages are used as testing frameworks.

All tests are carried out for Python 3.8 through 3.12 using the GitLab CI/CD and the newest versions of all [dependencies](#dependencies).

All tests are carried out for Python versions 3.9 to 3.13 using the GitLab CI/CD and the *newest versions* of all [dependencies](#dependencies), as resolved by `pip`.

Test coverage and pipeline status can be seen on [the project page][dantro-project].

### Copyright Notice

    dantro -- a python package for handling and plotting hierarchical data

    Copyright (C) 2018 – 2024  dantro developers

    Copyright (C) 2018 – 2025  dantro developers

    This program is free software: you can redistribute it and/or modify

    it under the terms of the GNU Lesser General Public License as published by

See :ref:`the user manual <welcome>` for more information.

"""

__version__ = "0.20.0b3"

__version__ = "0.20.3b0"

"""Package version"""

# Set up the root logger such that the logging configuration is applied