Update upstream source from tag 'upstream/25.5.0'

Update to upstream version '25.5.0'
with Debian dir af00d0a

Author: Farid CHABANE

CHANGELOG.md

@@ -6,18 +6,18 @@ pyslurm is the Python client library for the [Slurm Workload Manager](https://sl
 
 * [Slurm](https://slurm.schedmd.com) - Slurm shared library and header files
 * [Python](https://www.python.org) - >= 3.6
-* [Cython](https://cython.org) - >= 0.29.36
+* [Cython](https://cython.org) - >= 0.29.37
 
-This Version is for Slurm 23.11.x
+This Version is for Slurm 25.05.x
 
 ## Versioning
 
 In pyslurm, the versioning scheme follows the official Slurm versioning. The
 first two numbers (`MAJOR.MINOR`) always correspond to Slurms Major-Release,
-for example `23.11`.
+for example `25.05`.
 The last number (`MICRO`) is however not tied in any way to Slurms `MICRO`
 version, but is instead PySlurm's internal Patch-Level. For example, any
-pyslurm 23.11.X version should work with any Slurm 23.11.X release.
+pyslurm 25.05.X version should work with any Slurm 25.05.X release.
 
 ## Installation
 
@@ -29,21 +29,29 @@ the corresponding paths to the necessary files.
 You can specify those with environment variables (recommended), for example:
 
 ```shell
-export SLURM_INCLUDE_DIR=/opt/slurm/23.11/include
-export SLURM_LIB_DIR=/opt/slurm/23.11/lib
+export SLURM_INCLUDE_DIR=/opt/slurm/25.05/include
+export SLURM_LIB_DIR=/opt/slurm/25.05/lib
 ```
 
 Then you can proceed to install pyslurm, for example by cloning the Repository:
 
 ```shell
 git clone https://github.com/PySlurm/pyslurm.git && cd pyslurm
 scripts/build.sh
+```
 
-# Or simply with pip
-pip install .
+Also see `scripts/build.sh -h`. You can specify multiple cores for building
+with the `-j` option (also possible to set via environment variable `PYSLURM_BUILD_JOBS`):
+
+```shell
+scripts/build.sh -j4
 ```
 
-Also see `python setup.py --help`
+Or simply with `pip` directly:
+
+```shell
+pip install .
+```
 
 ## Contributors
 

README.md

@@ -1,4 +1,4 @@
 setuptools>=59.2.0
 wheel>=0.37.0
-Cython>=0.29.36
+Cython>=0.29.37
 packaging>=21.3

build_requirements.txt

@@ -1,4 +1,4 @@
-cython>=3.0.0b1
+cython>=3.0.11,<3.1
 wheel
 setuptools
 mkdocstrings[python]

cython.cfg

@@ -6,4 +6,4 @@ title: Cluster
     This API is currently being completely reworked, and is subject to be
     removed in the future when a replacement is introduced
 
-::: pyslurm.slurmdb_clusters
+::: pyslurm.deprecated.slurmdb_clusters

doc_requirements.txt

@@ -6,4 +6,4 @@ title: Event
     This API is currently being completely reworked, and is subject to be
     removed in the future when a replacement is introduced
 
-::: pyslurm.slurmdb_events
+::: pyslurm.deprecated.slurmdb_events

docs/reference/config.md

@@ -3,3 +3,4 @@ title: JobStatistics
 ---
 
 ::: pyslurm.db.JobStatistics
+::: pyslurm.db.JobStepStatistics

docs/reference/db/cluster.md

@@ -6,4 +6,4 @@ title: Reservation
     This API is currently being completely reworked, and is subject to be
     removed in the future when a replacement is introduced
 
-::: pyslurm.slurmdb_reservations
+::: pyslurm.deprecated.slurmdb_reservations