python-rundeck 1.1.0__tar.gz → 2.0.0__tar.gz

{python_rundeck-1.1.0 → python_rundeck-2.0.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: python-rundeck
-Version: 1.1.0
-Summary: Python client for the Rundeck API (v14-v58).
+Version: 2.0.0
+Summary: Python client for the Rundeck Community API (v14-v59).
 License-Expression: MIT
 License-File: LICENSE
 Keywords: rundeck,api,client
@@ -43,7 +43,9 @@ python-rundeck
 ![License](https://img.shields.io/pypi/l/python-rundeck)
 ![Downloads](https://static.pepy.tech/badge/python-rundeck)
 
-Python client for the Rundeck API (v14-v58), inspired by the python-gitlab architecture. The default API version is v58; current Rundeck servers require v17 or later and versions below v34 are deprecated. Provides typed managers for Community resources (projects, jobs, executions, tokens, users, system) and SCM (import/export).
+Python client for the Rundeck Community API (v14-v59), inspired by the python-gitlab architecture. The default API version is v59; current Rundeck servers require v17 or later and versions below v34 are deprecated. Provides typed managers for Community resources (projects, jobs, executions, tokens, users, system) and SCM (import/export).
+
+Version 2.0 removes commercial-only Config Management and job-tag endpoints. Cluster schedule listing and takeover are Community operations and remain available. The authorization-evaluation endpoints are experimental in Rundeck and are exposed as such by this client.
 
 Contents
 --------
@@ -69,9 +71,9 @@ Quick start
 ```python
 from rundeck.client import Rundeck
 
-rd = Rundeck(url="https://rundeck.example.com", token="MY_TOKEN", api_version=58)
+rd = Rundeck(url="https://rundeck.example.com", token="MY_TOKEN")
 # Password auth (session cookie) if no token
-rd = Rundeck(url="https://rundeck.example.com", username="admin", password="admin", api_version=58)
+rd = Rundeck(url="https://rundeck.example.com", username="admin", password="admin")
 
 # List projects
 projects = rd.projects.list()
@@ -94,7 +96,7 @@ Main parameters:
 - `url`: Rundeck URL (e.g. `https://rundeck.example.com`)
 - `token`: API token (header `X-Rundeck-Auth-Token`)
 - `username` / `password`: Session authentication (j_security_check) if no token is provided.
-- `api_version`: API version (default: `58`)
+- `api_version`: API version (default: `59`; older versions can be selected explicitly)
 - `timeout`: Request timeout (float, seconds)
 - `ssl_verify`: TLS verification (bool or CA path)
 - `user_agent`: Custom HTTP User-Agent (string)
@@ -105,7 +107,7 @@ Useful env vars (client config):
 - `RUNDECK_URL`: Base URL
 - `RUNDECK_TOKEN`: API token (header `X-Rundeck-Auth-Token`)
 - `RUNDECK_USERNAME` / `RUNDECK_PASSWORD`: Session auth (if no token)
-- `RUNDECK_API_VERSION`: API version (e.g. 58)
+- `RUNDECK_API_VERSION`: API version (default `59`; older server versions can be selected explicitly)
 - `RUNDECK_TIMEOUT`: Request timeout (seconds)
 - `RUNDECK_SSL_VERIFY`: TLS verification (bool or CA path)
 - `RUNDECK_USER_AGENT`: HTTP User-Agent
@@ -120,14 +122,14 @@ Available resources
 - `tokens` (`TokenManager`): list, get, create, delete.
 - `users` (`UserManager`): user operations (per current implementation).
 - `metrics` (`MetricsManager`): legacy `/api/V/metrics` endpoints (list/data/healthcheck/ping/threads).
-- `monitoring` (`MonitoringManager`): modern non-versioned `/monitoring/*` endpoints (Prometheus, metrics, health, info, thread dump).
+- `monitoring` (`MonitoringManager`): modern non-versioned `/monitoring/*` endpoints (Prometheus, metrics, health, readiness, info, thread dump).
+- `authorizations` (`AuthorizationsManager`): experimental authorization evaluation endpoints.
 - `plugins` (`PluginManager`): list installed plugins (`/plugin/list`).
 - `webhooks` (`WebhookEventManager` + `ProjectWebhookManager`): project webhook management and sending via token.
 - `key_storage` (`StorageKeyManager`): key storage management `/storage/keys`.
 - `adhoc` (`AdhocManager`, via `project.adhoc`): run AdHoc commands/scripts.
-- `system` (`SystemManager`): system info, executions enable/disable, logstorage, ACL.
-- `config_management` (`ConfigManagementManager`): global configuration `/config` (commercial, deprecated and scheduled for removal in 2.0).
-- `scheduler` (`SchedulerManager`): cluster scheduler takeover (commercial, deprecated and scheduled for removal in 2.0).
+- `system` (`SystemManager`): system info and summary, executions enable/disable, logstorage, ACL.
+- `scheduler` (`SchedulerManager`): scheduled job listing and cluster schedule takeover (Community).
 - `scm` (via `project.scm` and `job.scm`): import/export plugins, setup, enable/disable, status, actions (commit/import/export...).
 
 Return types policy
@@ -148,7 +150,7 @@ Factory managers:
   Returns `Execution` objects (execution factory).
 
 Utility managers:
-- `system`, `config_management`, `metrics`, `scheduler`, `webhooks` (event send).
+- `system`, `metrics`, `scheduler`, `webhooks` (event send), `authorizations` (experimental).
 - `scm` (via `project.scm` and `job.scm`), and project sub-managers like
   `project.config`, `project.resources`, `project.sources`, `project.readme`,
   `project.archive`, `project.acl`.
@@ -156,6 +158,13 @@ Utility managers:
 Note: `project.webhooks.create(...)` returns the raw API response (e.g., `{"msg": "Saved webhook"}`)
 because the Rundeck API does not return the created webhook object.
 
+Migration from 1.1.0
+-------------------
+- Set `api_version=59` explicitly when upgrading a server/client pair gradually; the default is now 59.
+- Remove calls to `rd.config_management` and `job.tags()`: their endpoints are only available in commercial Rundeck products.
+- `rd.scheduler.takeover()` and scheduler job listing remain supported by Community. On a non-cluster server, takeover returns a successful response indicating that no action was performed.
+- `rd.authorizations` wraps experimental endpoints and can change with Rundeck releases.
+
 Example:
 ```python
 job = rd.jobs.get("job-id")          # -> Job (object)
@@ -468,17 +477,6 @@ if features:
     print(first.name, status.enabled)
 ```
 
-Global configuration `/config`
-```python
-# Commercial compatibility surface; deprecated and removed in 2.0.
-cfg = rd.config_management
-all_configs = cfg.list()
-cfg.save([{"key": "ui.banner", "value": "Hello"}])
-cfg.delete("ui.banner", strata="default")
-cfg.refresh()
-cfg.restart()
-```
-
 Monitoring
 ----------
 ```python
@@ -490,6 +488,24 @@ thread_dump = rd.monitoring.thread_dump()
 
 # Legacy metrics require rundeck.metrics.legacy.enabled=true on Rundeck 6.0.
 legacy_threads = rd.metrics.threads()
+ready = rd.monitoring.readiness()
+```
+
+Community additions
+-------------------
+```python
+api_info = rd.api_info()
+summary = rd.system.summary()
+scheduled_jobs = rd.scheduler.jobs()
+rd.tokens.remove_expired("admin")  # use "*" with suitable administrator rights
+
+project = rd.projects.get("demo")
+project.plugins.save("ResourceModelSource", "resources.source", plugins=[])
+project.archive.export_async(execution_ids=["1", "2"], use_post=True)
+project.jobs.validate_option(option_data, job_was_scheduled=False)
+
+# Experimental authorization API; actions are repeated query parameters.
+permissions = rd.authorizations.application_kind("job", ["read", "run"])
 ```
 
 Pagination
@@ -510,13 +526,13 @@ Development and testing
 - Formatting/Lint: `black src/rundeck tests/`, `ruff check src/rundeck tests/`
 - Typing: `mypy src/rundeck/`
 - Tests: `pytest`
-- Local integration tests: `scripts/run-integration.sh` starts Rundeck Community 6.0.1 by default with API v58. Use `RUNDECK_IMAGE=rundeck/rundeck:5.18.0 RUNDECK_API_VERSION=56 scripts/run-integration.sh` for the v56 compatibility run. Add `KEEP_STACK=1` to keep the instance running after tests. Dedicated teardown script: `scripts/stop-integration.sh`.
+- Local integration tests: `scripts/run-integration.sh` starts Rundeck Community 6.2.1 by default with API v59. Use `RUNDECK_IMAGE=rundeck/rundeck:6.0.1 RUNDECK_API_VERSION=58` or `RUNDECK_IMAGE=rundeck/rundeck:5.18.0 RUNDECK_API_VERSION=56` for compatibility runs. Add `KEEP_STACK=1` to keep the instance running after tests. Dedicated teardown script: `scripts/stop-integration.sh`.
 - The docker compose stack mounts `tokens.properties` at the repo root to seed a local admin token for integration tests. This file is only intended for local testing.
 
 Code structure
 --------------
 - `src/rundeck/base.py`: generic objects/managers, `_build_path` helpers, pagination, CRUD.
 - `src/rundeck/client.py`: HTTP client, `http_get/post/put/delete/list` methods.
-- `src/rundeck/v1/objects/`: domain managers and objects (projects, jobs, executions, system, tokens, users, config_management).
-- Managers/objects schema: we apply the manager -> object pattern wherever the API exposes an identifiable resource (jobs, projects, users, tokens, executions, etc.). For purely global or utility endpoints without a resource (e.g., `/system` and its subdomains, `/config`, `/metrics`), we use dedicated sub-managers rather than forcing an artificial object.
+- `src/rundeck/v1/objects/`: Community domain managers and objects (projects, jobs, executions, system, tokens, users, authorizations).
+- Managers/objects schema: we apply the manager -> object pattern wherever the API exposes an identifiable resource (jobs, projects, users, tokens, executions, etc.). For global or utility endpoints without a resource (e.g., `/system`, `/scheduler`, `/metrics`), we use dedicated sub-managers rather than forcing an artificial object.
 

{python_rundeck-1.1.0 → python_rundeck-2.0.0}/README.md

@@ -5,7 +5,9 @@ python-rundeck
 ![License](https://img.shields.io/pypi/l/python-rundeck)
 ![Downloads](https://static.pepy.tech/badge/python-rundeck)
 
-Python client for the Rundeck API (v14-v58), inspired by the python-gitlab architecture. The default API version is v58; current Rundeck servers require v17 or later and versions below v34 are deprecated. Provides typed managers for Community resources (projects, jobs, executions, tokens, users, system) and SCM (import/export).
+Python client for the Rundeck Community API (v14-v59), inspired by the python-gitlab architecture. The default API version is v59; current Rundeck servers require v17 or later and versions below v34 are deprecated. Provides typed managers for Community resources (projects, jobs, executions, tokens, users, system) and SCM (import/export).
+
+Version 2.0 removes commercial-only Config Management and job-tag endpoints. Cluster schedule listing and takeover are Community operations and remain available. The authorization-evaluation endpoints are experimental in Rundeck and are exposed as such by this client.
 
 Contents
 --------
@@ -31,9 +33,9 @@ Quick start
 ```python
 from rundeck.client import Rundeck
 
-rd = Rundeck(url="https://rundeck.example.com", token="MY_TOKEN", api_version=58)
+rd = Rundeck(url="https://rundeck.example.com", token="MY_TOKEN")
 # Password auth (session cookie) if no token
-rd = Rundeck(url="https://rundeck.example.com", username="admin", password="admin", api_version=58)
+rd = Rundeck(url="https://rundeck.example.com", username="admin", password="admin")
 
 # List projects
 projects = rd.projects.list()
@@ -56,7 +58,7 @@ Main parameters:
 - `url`: Rundeck URL (e.g. `https://rundeck.example.com`)
 - `token`: API token (header `X-Rundeck-Auth-Token`)
 - `username` / `password`: Session authentication (j_security_check) if no token is provided.
-- `api_version`: API version (default: `58`)
+- `api_version`: API version (default: `59`; older versions can be selected explicitly)
 - `timeout`: Request timeout (float, seconds)
 - `ssl_verify`: TLS verification (bool or CA path)
 - `user_agent`: Custom HTTP User-Agent (string)
@@ -67,7 +69,7 @@ Useful env vars (client config):
 - `RUNDECK_URL`: Base URL
 - `RUNDECK_TOKEN`: API token (header `X-Rundeck-Auth-Token`)
 - `RUNDECK_USERNAME` / `RUNDECK_PASSWORD`: Session auth (if no token)
-- `RUNDECK_API_VERSION`: API version (e.g. 58)
+- `RUNDECK_API_VERSION`: API version (default `59`; older server versions can be selected explicitly)
 - `RUNDECK_TIMEOUT`: Request timeout (seconds)
 - `RUNDECK_SSL_VERIFY`: TLS verification (bool or CA path)
 - `RUNDECK_USER_AGENT`: HTTP User-Agent
@@ -82,14 +84,14 @@ Available resources
 - `tokens` (`TokenManager`): list, get, create, delete.
 - `users` (`UserManager`): user operations (per current implementation).
 - `metrics` (`MetricsManager`): legacy `/api/V/metrics` endpoints (list/data/healthcheck/ping/threads).
-- `monitoring` (`MonitoringManager`): modern non-versioned `/monitoring/*` endpoints (Prometheus, metrics, health, info, thread dump).
+- `monitoring` (`MonitoringManager`): modern non-versioned `/monitoring/*` endpoints (Prometheus, metrics, health, readiness, info, thread dump).
+- `authorizations` (`AuthorizationsManager`): experimental authorization evaluation endpoints.
 - `plugins` (`PluginManager`): list installed plugins (`/plugin/list`).
 - `webhooks` (`WebhookEventManager` + `ProjectWebhookManager`): project webhook management and sending via token.
 - `key_storage` (`StorageKeyManager`): key storage management `/storage/keys`.
 - `adhoc` (`AdhocManager`, via `project.adhoc`): run AdHoc commands/scripts.
-- `system` (`SystemManager`): system info, executions enable/disable, logstorage, ACL.
-- `config_management` (`ConfigManagementManager`): global configuration `/config` (commercial, deprecated and scheduled for removal in 2.0).
-- `scheduler` (`SchedulerManager`): cluster scheduler takeover (commercial, deprecated and scheduled for removal in 2.0).
+- `system` (`SystemManager`): system info and summary, executions enable/disable, logstorage, ACL.
+- `scheduler` (`SchedulerManager`): scheduled job listing and cluster schedule takeover (Community).
 - `scm` (via `project.scm` and `job.scm`): import/export plugins, setup, enable/disable, status, actions (commit/import/export...).
 
 Return types policy
@@ -110,7 +112,7 @@ Factory managers:
   Returns `Execution` objects (execution factory).
 
 Utility managers:
-- `system`, `config_management`, `metrics`, `scheduler`, `webhooks` (event send).
+- `system`, `metrics`, `scheduler`, `webhooks` (event send), `authorizations` (experimental).
 - `scm` (via `project.scm` and `job.scm`), and project sub-managers like
   `project.config`, `project.resources`, `project.sources`, `project.readme`,
   `project.archive`, `project.acl`.
@@ -118,6 +120,13 @@ Utility managers:
 Note: `project.webhooks.create(...)` returns the raw API response (e.g., `{"msg": "Saved webhook"}`)
 because the Rundeck API does not return the created webhook object.
 
+Migration from 1.1.0
+-------------------
+- Set `api_version=59` explicitly when upgrading a server/client pair gradually; the default is now 59.
+- Remove calls to `rd.config_management` and `job.tags()`: their endpoints are only available in commercial Rundeck products.
+- `rd.scheduler.takeover()` and scheduler job listing remain supported by Community. On a non-cluster server, takeover returns a successful response indicating that no action was performed.
+- `rd.authorizations` wraps experimental endpoints and can change with Rundeck releases.
+
 Example:
 ```python
 job = rd.jobs.get("job-id")          # -> Job (object)
@@ -430,17 +439,6 @@ if features:
     print(first.name, status.enabled)
 ```
 
-Global configuration `/config`
-```python
-# Commercial compatibility surface; deprecated and removed in 2.0.
-cfg = rd.config_management
-all_configs = cfg.list()
-cfg.save([{"key": "ui.banner", "value": "Hello"}])
-cfg.delete("ui.banner", strata="default")
-cfg.refresh()
-cfg.restart()
-```
-
 Monitoring
 ----------
 ```python
@@ -452,6 +450,24 @@ thread_dump = rd.monitoring.thread_dump()
 
 # Legacy metrics require rundeck.metrics.legacy.enabled=true on Rundeck 6.0.
 legacy_threads = rd.metrics.threads()
+ready = rd.monitoring.readiness()
+```
+
+Community additions
+-------------------
+```python
+api_info = rd.api_info()
+summary = rd.system.summary()
+scheduled_jobs = rd.scheduler.jobs()
+rd.tokens.remove_expired("admin")  # use "*" with suitable administrator rights
+
+project = rd.projects.get("demo")
+project.plugins.save("ResourceModelSource", "resources.source", plugins=[])
+project.archive.export_async(execution_ids=["1", "2"], use_post=True)
+project.jobs.validate_option(option_data, job_was_scheduled=False)
+
+# Experimental authorization API; actions are repeated query parameters.
+permissions = rd.authorizations.application_kind("job", ["read", "run"])
 ```
 
 Pagination
@@ -472,12 +488,12 @@ Development and testing
 - Formatting/Lint: `black src/rundeck tests/`, `ruff check src/rundeck tests/`
 - Typing: `mypy src/rundeck/`
 - Tests: `pytest`
-- Local integration tests: `scripts/run-integration.sh` starts Rundeck Community 6.0.1 by default with API v58. Use `RUNDECK_IMAGE=rundeck/rundeck:5.18.0 RUNDECK_API_VERSION=56 scripts/run-integration.sh` for the v56 compatibility run. Add `KEEP_STACK=1` to keep the instance running after tests. Dedicated teardown script: `scripts/stop-integration.sh`.
+- Local integration tests: `scripts/run-integration.sh` starts Rundeck Community 6.2.1 by default with API v59. Use `RUNDECK_IMAGE=rundeck/rundeck:6.0.1 RUNDECK_API_VERSION=58` or `RUNDECK_IMAGE=rundeck/rundeck:5.18.0 RUNDECK_API_VERSION=56` for compatibility runs. Add `KEEP_STACK=1` to keep the instance running after tests. Dedicated teardown script: `scripts/stop-integration.sh`.
 - The docker compose stack mounts `tokens.properties` at the repo root to seed a local admin token for integration tests. This file is only intended for local testing.
 
 Code structure
 --------------
 - `src/rundeck/base.py`: generic objects/managers, `_build_path` helpers, pagination, CRUD.
 - `src/rundeck/client.py`: HTTP client, `http_get/post/put/delete/list` methods.
-- `src/rundeck/v1/objects/`: domain managers and objects (projects, jobs, executions, system, tokens, users, config_management).
-- Managers/objects schema: we apply the manager -> object pattern wherever the API exposes an identifiable resource (jobs, projects, users, tokens, executions, etc.). For purely global or utility endpoints without a resource (e.g., `/system` and its subdomains, `/config`, `/metrics`), we use dedicated sub-managers rather than forcing an artificial object.
+- `src/rundeck/v1/objects/`: Community domain managers and objects (projects, jobs, executions, system, tokens, users, authorizations).
+- Managers/objects schema: we apply the manager -> object pattern wherever the API exposes an identifiable resource (jobs, projects, users, tokens, executions, etc.). For global or utility endpoints without a resource (e.g., `/system`, `/scheduler`, `/metrics`), we use dedicated sub-managers rather than forcing an artificial object.

{python_rundeck-1.1.0 → python_rundeck-2.0.0}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 name = "python-rundeck"
-version = "1.1.0"
-description = "Python client for the Rundeck API (v14-v58)."
+version = "2.0.0"
+description = "Python client for the Rundeck Community API (v14-v59)."
 authors = [
     {name = "Pascal Seckinger",email = "pascal.seckinger@protonmail.com"}
 ]

{python_rundeck-1.1.0 → python_rundeck-2.0.0}/src/rundeck/client.py

@@ -81,7 +81,7 @@ class Rundeck:
     def _init_managers(self) -> None:
         """Initialise les managers d'objets."""
         # Import paresseux pour éviter les boucles d'import.
-        from rundeck.v1.objects.config_management import ConfigManagementManager
+        from rundeck.v1.objects.authorizations import AuthorizationsManager
         from rundeck.v1.objects.executions import ExecutionManager
         from rundeck.v1.objects.features import FeatureManager
         from rundeck.v1.objects.jobs import JobManager
@@ -98,7 +98,7 @@ class Rundeck:
         self.projects = ProjectManager(self)
         self.jobs = JobManager(self)
         self.executions = ExecutionManager(self)
-        self.config_management = ConfigManagementManager(self)
+        self.authorizations = AuthorizationsManager(self)
         self.metrics = MetricsManager(self)
         self.monitoring = MonitoringManager(self)
         self.plugins = PluginManager(self)
@@ -110,6 +110,10 @@ class Rundeck:
         self.tokens = TokenManager(self)
         self.users = UserManager(self)
 
+    def api_info(self) -> dict[str, Any]:
+        """Récupère les informations de l'API utilisée par ce client."""
+        return self.http_get("/")
+
     @property
     def url(self) -> str:
         """URL fournie par l'utilisateur."""

{python_rundeck-1.1.0 → python_rundeck-2.0.0}/src/rundeck/const.py

@@ -2,9 +2,9 @@
 Constantes partagées pour le client Rundeck.
 """
 
+import tomllib
 from importlib.metadata import PackageNotFoundError, version
 from pathlib import Path
-import tomllib
 
 
 # Package metadata
@@ -40,7 +40,7 @@ FORMAT_JSON = "json"
 
 # API versions. The library remains compatible with legacy Rundeck servers
 # using v14, while current Rundeck servers require at least v17.
-API_VERSION_CURRENT = "58"
+API_VERSION_CURRENT = "59"
 API_VERSION_MIN = "14"
 API_VERSION_SERVER_MIN = "17"
 API_VERSION_DEPRECATION = "34"

{python_rundeck-1.1.0 → python_rundeck-2.0.0}/src/rundeck/exceptions.py

@@ -131,7 +131,7 @@ def raise_for_status(response: requests.Response) -> None:
         raise RundeckAuthenticationError(message, error_code, response)
     if code_lower == "api-version-unsupported":
         raise RundeckApiVersionUnsupportedError(message, error_code, response)
-    if status == 400:
+    if status in (400, 422):
         raise RundeckValidationError(message, error_code, response)
     if status in (401, 403):
         raise RundeckAuthenticationError(message, error_code, response)

{python_rundeck-1.1.0 → python_rundeck-2.0.0}/src/rundeck/v1/objects/acl.py

@@ -9,8 +9,13 @@ class YamlPolicyMixin:
     _yaml_content_type = "application/yaml"
 
     def _yaml_headers(self) -> dict[str, str]:
-        headers = build_headers(content_type=self._yaml_content_type)
-        return headers or {"Content-Type": self._yaml_content_type}
+        headers = build_headers(
+            accept=self._yaml_content_type, content_type=self._yaml_content_type
+        )
+        return headers or {
+            "Accept": self._yaml_content_type,
+            "Content-Type": self._yaml_content_type,
+        }
 
     def _post_yaml(self, path: str, content: Any) -> Any:
         return self.rd.http_post(path, data=content, headers=self._yaml_headers())

python_rundeck-2.0.0/src/rundeck/v1/objects/authorizations.py

@@ -0,0 +1,45 @@
+"""Endpoints expérimentaux d'évaluation des autorisations."""
+
+from typing import Any
+
+from rundeck.base import RundeckObjectManager
+
+
+class AuthorizationsManager(RundeckObjectManager):
+    """Évalue les droits du sujet courant (API expérimentale)."""
+
+    _path = "/authorizations"
+
+    def _check(self, path: str, actions: list[str]) -> Any:
+        return self.rd.http_get(path, params={"actions": actions})
+
+    def application_kind(self, kind: str, actions: list[str]) -> Any:
+        """Vérifie des actions sur un type de ressource de l'application."""
+        return self._check(f"/authorizations/application/{kind}", actions)
+
+    def application_resource(
+        self, resource_type: str, specifier: str, actions: list[str]
+    ) -> Any:
+        """Vérifie des actions sur une ressource de l'application."""
+        return self._check(
+            f"/authorizations/application/{resource_type}/{specifier}", actions
+        )
+
+    def project_kind(self, project: str, kind: str, actions: list[str]) -> Any:
+        """Vérifie des actions sur un type de ressource du projet."""
+        return self._check(f"/authorizations/project/{project}/{kind}", actions)
+
+    def project_resource(
+        self, project: str, resource_type: str, specifier: str, actions: list[str]
+    ) -> Any:
+        """Vérifie des actions sur une ressource du projet."""
+        return self._check(
+            f"/authorizations/project/{project}/{resource_type}/{specifier}", actions
+        )
+
+    def project_job(self, project: str, job_id: str, actions: list[str]) -> Any:
+        """Vérifie des actions sur un job du projet."""
+        return self._check(f"/authorizations/project/{project}/job/{job_id}", actions)
+
+
+__all__ = ["AuthorizationsManager"]

{python_rundeck-1.1.0 → python_rundeck-2.0.0}/src/rundeck/v1/objects/jobs.py

@@ -2,7 +2,6 @@
 Gestion des jobs Rundeck
 """
 
-import warnings
 from typing import Any, Iterator
 
 from rundeck.base import RundeckObject, RundeckObjectManager
@@ -114,16 +113,6 @@ class Job(RundeckObject):
         path = self._job_path("meta")
         return self.rd.http_get(path, params=params or None)
 
-    def tags(self) -> list[str]:
-        """Retourne les tags du job (commercial, endpoint /job/{id}/tags)."""
-        warnings.warn(
-            "Job.tags() cible un endpoint commercial et sera retiré en 2.0.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
-        path = self._job_path("tags")
-        return self.rd.http_get(path)
-
     def executions(
         self,
         status: str | None = None,
@@ -327,18 +316,42 @@ class JobManager(RundeckObjectManager[Job]):
         meta: str | None = None,
         meta_exclude: str | None = None,
         breakpoint: int | None = None,
+        use_post: bool = False,
         **filters: Any,
     ) -> dict[str, Any]:
         """Parcourt un groupe de jobs et ses sous-groupes (API v46+)."""
         project_path = self._project_path(project)
-        params = compact(
+        query = compact(meta=meta, metaExclude=meta_exclude, breakpoint=breakpoint)
+        browse_path = f"{project_path}/browse"
+        if use_post:
+            if path is not None:
+                query["path"] = path
+            return self.rd.http_post(browse_path, params=query or None, json=filters)
+        query = compact(
             filters,
             path=path,
             meta=meta,
             metaExclude=meta_exclude,
             breakpoint=breakpoint,
         )
-        return self.rd.http_get(f"{project_path}/browse", params=params or None)
+        return self.rd.http_get(browse_path, params=query or None)
+
+    def validate_option(
+        self,
+        option_data: dict[str, Any],
+        *,
+        job_was_scheduled: bool,
+        project: str | None = None,
+    ) -> Any:
+        """Valide une option de job (API v47+)."""
+        project_name = project or (self.parent.id if self.parent else None)
+        if not project_name:
+            raise ValueError("Le paramètre project est requis")
+        return self.rd.http_post(
+            f"/project/{project_name}/jobs/validateOption",
+            params={"jobWasScheduled": job_was_scheduled},
+            json=option_data,
+        )
 
     def get(self, id: str) -> "Job":
         """Récupère un job par identifiant."""

{python_rundeck-1.1.0 → python_rundeck-2.0.0}/src/rundeck/v1/objects/metrics.py

@@ -65,6 +65,10 @@ class MonitoringManager(RundeckObjectManager):
         """Récupère l'état de santé de l'application."""
         return self.rd.http_get(self._monitoring_path("health"))
 
+    def readiness(self) -> dict[str, Any]:
+        """Récupère l'état de disponibilité pour les sondes de readiness."""
+        return self.rd.http_get(self._monitoring_path("health/readiness"))
+
     def info(self) -> dict[str, Any]:
         """Récupère les informations applicatives."""
         return self.rd.http_get(self._monitoring_path("info"))

python_rundeck-2.0.0/src/rundeck/v1/objects/project_plugins.py

@@ -0,0 +1,29 @@
+"""Configuration des plugins au niveau d'un projet."""
+
+from typing import Any
+
+from rundeck.base import RundeckObjectManager
+
+
+class ProjectPluginsManager(RundeckObjectManager):
+    """Sauvegarde les configurations de plugins d'un projet (API v55+)."""
+
+    _path = "/project/{parent}/plugins"
+
+    def save(
+        self,
+        service_name: str,
+        config_prefix: str,
+        plugins: list[dict[str, Any]],
+        removed_plugins: list[dict[str, Any]] | None = None,
+    ) -> Any:
+        """Crée, modifie ou retire des configurations de plugins projet."""
+        path = self._build_path("save")
+        return self.rd.http_post(
+            path,
+            params={"serviceName": service_name, "configPrefix": config_prefix},
+            json={"plugins": plugins, "removedPlugins": removed_plugins or []},
+        )
+
+
+__all__ = ["ProjectPluginsManager"]

{python_rundeck-1.1.0 → python_rundeck-2.0.0}/src/rundeck/v1/objects/projects.py

@@ -10,6 +10,7 @@ from rundeck.v1.objects.acl import YamlPolicyMixin
 from rundeck.v1.objects.adhoc import AdhocManager
 from rundeck.v1.objects.executions import ExecutionManager
 from rundeck.v1.objects.jobs import JobManager
+from rundeck.v1.objects.project_plugins import ProjectPluginsManager
 from rundeck.v1.objects.scm import ProjectSCMManager
 from rundeck.v1.objects.webhooks import ProjectWebhookManager
 
@@ -65,6 +66,11 @@ class Project(RundeckObject):
         """Accès aux opérations SCM du projet (import/export)."""
         return ProjectSCMManager(self.rd, parent=self)
 
+    @property
+    def plugins(self) -> ProjectPluginsManager:
+        """Accès à la configuration des plugins du projet."""
+        return ProjectPluginsManager(self.rd, parent=self)
+
     @property
     def webhooks(self) -> ProjectWebhookManager:
         """Accès aux webhooks du projet."""
@@ -187,7 +193,9 @@ class ProjectACLManager(YamlPolicyMixin, RundeckObjectManager):
     def get(self, policy_name: str) -> str:
         """Récupère une politique ACL projet (contenu texte)."""
         path = self._build_path(policy_name)
-        response = self.rd.http_get(path, raw=True)
+        response = self.rd.http_get(
+            path, raw=True, headers={"Accept": "application/yaml"}
+        )
         return response.text
 
     def create(self, policy_name: str, content: str) -> dict[str, Any]:
@@ -429,9 +437,25 @@ class ProjectArchiveManager(RundeckObjectManager):
             )
         return self.rd.http_get(path, params=params or None, raw=True)
 
-    def export_async(self, **params: Any) -> Any:
-        """Lance une export async, retourne le token."""
+    def export_async(
+        self,
+        *,
+        execution_ids: list[str] | None = None,
+        use_post: bool = False,
+        **params: Any,
+    ) -> Any:
+        """Lance une export async, en POST pour les longues listes d'IDs."""
         path = self._build_path("export/async")
+        if use_post:
+            form = {"executionIds": execution_ids} if execution_ids else None
+            return self.rd.http_post(
+                path,
+                params=params or None,
+                data=form,
+                headers=build_headers(content_type="application/x-www-form-urlencoded"),
+            )
+        if execution_ids:
+            params["executionIds"] = execution_ids
         return self.rd.http_get(path, params=params or None)
 
     def export_status(self, token: str) -> Any:

{python_rundeck-1.1.0 → python_rundeck-2.0.0}/src/rundeck/v1/objects/scheduler.py

@@ -2,7 +2,6 @@
 Gestion des endpoints /scheduler
 """
 
-import warnings
 from typing import Any
 
 from rundeck.base import RundeckObjectManager
@@ -20,24 +19,24 @@ class SchedulerManager(RundeckObjectManager):
         all_servers: bool = False,
         project: str | None = None,
         job_id: str | None = None,
+        job_ids: list[str] | None = None,
     ) -> dict[str, Any]:
         """
-        Reprend le planning des jobs en mode cluster.
+        Reprend le planning des jobs. Sur un serveur sans mode cluster,
+        l'API est disponible, mais aucun planning distant n'est transféré.
 
         Args:
             server_uuid: UUID du serveur cible.
             all_servers: True pour reprendre tous les serveurs.
             project: Projet concerné (optionnel).
             job_id: Job spécifique (optionnel).
+            job_ids: Liste de jobs (exclusif avec job_id).
 
         Returns:
             Résultat de la reprise.
         """
-        warnings.warn(
-            "Les opérations Scheduler Cluster sont commerciales et seront retirées en 2.0.",
-            DeprecationWarning,
-            stacklevel=2,
-        )
+        if job_id is not None and job_ids is not None:
+            raise ValueError("job_id et job_ids ne peuvent pas être utilisés ensemble")
         path = self._build_path("takeover")
 
         server = None
@@ -50,9 +49,19 @@ class SchedulerManager(RundeckObjectManager):
             server=server,
             project=project if project else None,
             job={"id": job_id} if job_id else None,
+            jobs=[{"id": item} for item in job_ids] if job_ids else None,
         )
 
         return self.rd.http_put(path, json=data)
 
+    def jobs(self, server_uuid: str | None = None) -> Any:
+        """Liste les jobs planifiés sur le serveur courant ou le serveur donné."""
+        path = (
+            f"/scheduler/server/{server_uuid}/jobs"
+            if server_uuid
+            else "/scheduler/jobs"
+        )
+        return self.rd.http_get(path)
+
 
 __all__ = ["SchedulerManager"]

{python_rundeck-1.1.0 → python_rundeck-2.0.0}/src/rundeck/v1/objects/system.py

@@ -67,7 +67,9 @@ class SystemACLManager(YamlPolicyMixin, RundeckObjectManager[SystemACL]):
     def get(self, policy_name: str) -> SystemACL:
         """Récupère une politique ACL (contenu texte)."""
         path = self._build_path(policy_name)
-        response = self.rd.http_get(path, raw=True)
+        response = self.rd.http_get(
+            path, raw=True, headers={"Accept": "application/yaml"}
+        )
         return self._wrap({"name": policy_name, "content": response.text})
 
     def create(self, policy_name: str, content: str) -> SystemACL:
@@ -143,3 +145,7 @@ class SystemManager(RundeckObjectManager):
         """
         path = self._build_path("info")
         return self.rd.http_get(path)
+
+    def summary(self) -> dict[str, Any]:
+        """Récupère le résumé des exécutions et projets."""
+        return self.rd.http_get("/home/summary")

{python_rundeck-1.1.0 → python_rundeck-2.0.0}/src/rundeck/v1/objects/tokens.py

@@ -100,3 +100,7 @@ class TokenManager(RundeckObjectManager):
         """
         path = self._token_path(token_id)
         self._delete(token_id, path=path)
+
+    def remove_expired(self, user: str) -> Any:
+        """Supprime les tokens expirés d'un utilisateur ou de tous (``*``)."""
+        return self.rd.http_post(self._build_path(f"{user}/removeExpired"))

python_rundeck-1.1.0/src/rundeck/v1/objects/config_management.py

@@ -1,64 +0,0 @@
-"""Gestion de la configuration Rundeck (instance globale)."""
-
-from __future__ import annotations
-
-import warnings
-
-from rundeck.base import RundeckObjectManager
-
-
-class ConfigManagementManager(RundeckObjectManager):
-    """
-    Gestion des configurations globales (plugin/custom) via /config.
-    """
-
-    _path = "/config"
-
-    @staticmethod
-    def _warn_commercial() -> None:
-        warnings.warn(
-            "Config Management est une surface commerciale et sera retirée en 2.0.",
-            DeprecationWarning,
-            stacklevel=3,
-        )
-
-    def list(self) -> list[dict[str, str]]:
-        """Liste toutes les configs et propriétés."""
-        self._warn_commercial()
-        path = self._build_path("list")
-        return self.rd.http_get(path)
-
-    def save(self, entries: list[dict[str, str]]) -> dict[str, str | list[str]]:
-        """
-        Crée ou met à jour des configs (payload: liste de dicts {key, value, strata?}).
-        """
-        self._warn_commercial()
-        path = self._build_path("save")
-        return self.rd.http_post(path, json=entries)
-
-    def delete(self, key: str, strata: str | None = None) -> None:
-        """
-        Supprime une config via /config/delete avec payload JSON.
-        """
-        self._warn_commercial()
-        payload: dict[str, str] = {"key": key}
-        if strata:
-            payload["strata"] = strata
-        path = self._build_path("delete")
-        self.rd.http_delete(path, json=payload)
-
-    def refresh(self) -> dict[str, str]:
-        """
-        Recharge les configurations depuis les fichiers de propriétés.
-        """
-        self._warn_commercial()
-        path = self._build_path("refresh")
-        return self.rd.http_post(path)
-
-    def restart(self) -> dict[str, str]:
-        """
-        Redémarre le serveur Rundeck.
-        """
-        self._warn_commercial()
-        path = self._build_path("restart")
-        return self.rd.http_post(path)