BACKPORT: Build system changes, doc fixes, few attribute renames (#359)

* pyslurm.Job: add attribute run_time_remaining
* pyslurm.JobStep: add run_time_remaining and elapsed_cpu_time attributes
* rename __version__.py to just version.py
* update doc_requirements to exclude cython 3.1.* releases
* mkdocs.yml updates
* move flake8 config to pyproject.toml
* move away from invoking setup.py directly
* build.sh: use pip install
* rename pyslurm.pyx to deprecated.pyx

anything in there is effectively the old api, which is considered
deprecated. The name change doesn't affect anything, because all the
stuff is wildcard-imported anyway.

But it prevents the documentation from being built due to circular alias
errors.

* add first working pyslurm.spec file for building rpms

* ability to provide core-count for builddocs.sh

* remove configure.sh script

obsolete, should use a slurm-container solution for testing and dev

* remove run_tests* scripts
* add cython-lint config, update flake8 config
* remove cython.cfg, flake8 config is in pyproject.toml
* update tox.ini
* pyslurm.JobStep: rename step.alloc_cpus to step.cpus
* update copyright for docs
* doc: add JobStepStatistics
* core job+step: fix docs

Author: tazend

cython.cfg

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

doc_requirements.txt

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

docs/reference/config.md

@@ -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

docs/reference/db/cluster.md

@@ -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/db/event.md

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

docs/reference/db/jobstats.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

docs/reference/db/reservation.md

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

docs/reference/frontend.md

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

docs/reference/hostlist.md

@@ -6,5 +6,5 @@ title: Job
     This is superseded by [pyslurm.db.Job](../../db/job.md) class and will
     be removed in a future release
 
-::: pyslurm.slurmdb_jobs
+::: pyslurm.deprecated.slurmdb_jobs
     handler: python