python-rundeck 1.1.0__py3-none-any.whl → 2.0.1__py3-none-any.whl

{python_rundeck-1.1.0.dist-info → python_rundeck-2.0.1.dist-info}/METADATA

@@ -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.1
+Summary: Python client for the Rundeck Community API (v14-v60, default v59).
 License-Expression: MIT
 License-File: LICENSE
 Keywords: rundeck,api,client
@@ -21,12 +21,12 @@ Classifier: Topic :: System :: Systems Administration
 Classifier: Typing :: Typed
 Provides-Extra: dev
 Requires-Dist: bandit (>=1.7.9,<2.0.0) ; extra == "dev"
-Requires-Dist: black (>=25.11.0,<26.0.0) ; extra == "dev"
+Requires-Dist: black (>=26.3.1,<27.0.0) ; extra == "dev"
 Requires-Dist: flake8 (>=7.0.0,<8.0.0) ; extra == "dev"
 Requires-Dist: isort (>=7.0.0,<8.0.0) ; extra == "dev"
-Requires-Dist: pytest (>=9.0.2,<10.0.0) ; extra == "dev"
+Requires-Dist: pytest (>=9.0.3,<10.0.0) ; extra == "dev"
 Requires-Dist: pytest-cov (>=5.0.0,<6.0.0) ; extra == "dev"
-Requires-Dist: requests (>=2.32.5,<3.0.0)
+Requires-Dist: requests (>=2.33.0,<3.0.0)
 Requires-Dist: ruff (>=0.7.0,<1.0.0) ; extra == "dev"
 Requires-Dist: safety (>=3.2.0,<4.0.0) ; extra == "dev"
 Project-URL: Changelog, https://gitlab.com/pascal.seckinger/python-rundeck/-/blob/main/CHANGELOG.md
@@ -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-v60), inspired by the python-gitlab architecture. Rundeck Community 6.3.0 is the integration reference. The default API version remains v59; use `api_version=60` explicitly with 6.3.0. 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,23 @@ 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.
 
+Compatibility with Community 6.3.0 (2.0.1)
+---------------------------------------
+- API v60 is recognized; the default stays v59 to retain compatibility with Community 6.2.1. The new v60 cluster endpoints are Enterprise-only and excluded.
+- ACL creation and updates send the YAML text inside a JSON `contents` envelope and request JSON responses. Reads still request YAML and unwrap legacy JSON responses from older project ACL controllers. Python signatures and resource return conventions are unchanged.
+- `job.meta(meta="executionAclValid")` and `project.jobs.browse(meta="executionAclValid")` expose the server's saved-user authorization warning. It does not block execution. Plugin `outputs` and property `outputMetadata` are preserved when returned by the server.
+- Archive imports with `importConfig=True` or `importNodesSources=True` also require project `configure` authorization on 6.3.0. Use explicit `False` values for jobs-only imports. Authorization failures retain the server response in `RundeckAuthenticationError.response_body`.
+- Webhook tokens remain opaque public secrets. The server handles hashing and migration; callers must continue sending the original secret.
+- Session authentication uses standard cookie handling; 6.3.0 fixes direct HTTP authentication when the public URL is HTTPS behind forwarded headers.
+- The stable 6.3.0 sources restore the trailing slash on `${job.serverUrl}` (RUN-5051), despite the earlier release-note wording. The client does not rewrite job context URLs.
+
+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 +487,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 +498,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 +536,16 @@ 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/rundeck:6.3.0-20261022` with API v59. Each run has an isolated Compose project and cleans up even when tests fail. With `KEEP_STACK=1`, the script prints the project name needed by `scripts/stop-integration.sh`.
+- GitLab runs five integration targets: 6.3.0/API 59, 6.3.0/API 60, 6.2.1/API 59, 6.0.1/API 58 and 5.18.0/API 56. Set `RUNDECK_IMAGE` and `RUNDECK_API_VERSION` to run each target locally. Python compatibility tests retain 3.11–3.15 (3.15-rc Docker image).
+- To exercise the 6.3.0 session regression and legacy metrics: `RUNDECK_PUBLIC_URL=https://rundeck.example.invalid RUNDECK_METRICS_LEGACY_ENABLED=true scripts/run-integration.sh`. The client still connects to `RUNDECK_URL` (default `http://localhost:4440`). The public URL defaults to the client URL, ensuring session redirects also work on older servers. Optional `RUNDECK_HTTP_PORT` changes the published port; set `RUNDECK_URL` accordingly.
 - 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.
+- Run local compatibility targets sequentially, stopping each stack before starting the next. This keeps at most one Rundeck JVM and one PostgreSQL container active.
 
 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-2.0.1.dist-info/RECORD

@@ -0,0 +1,31 @@
+rundeck/__init__.py,sha256=M413mLKjB08nWuo5godsAmk2ly9vEYw5Xzc-Pt4Pqds,951
+rundeck/base.py,sha256=TGqxLj9F4Y0x7nQGqkjuw7xitzxWOa2fn4apkjpckwE,7119
+rundeck/client.py,sha256=r3LNO9TDqjiwT-XZI_xFQeWXaajPV9AxFtBUlqe-pOc,11433
+rundeck/config.py,sha256=bVCuqD6Nk6RDS-WAt81uMh6PfQ2ocZDN51Aspjnhjxc,5331
+rundeck/const.py,sha256=uDE6Qt1_RrpzuRG9xHIlv5q4tKVtpuN_zKrZYMpqVPo,1681
+rundeck/exceptions.py,sha256=3XVZi9mnsDYPqmFI-yV0wxNaTy3bdsrTRwWJKt8rqf8,4778
+rundeck/py.typed,sha256=3Q9vdii9v-_pbj9sglgDzJAIelvARaYaDJlB2u-NDqg,38
+rundeck/utils.py,sha256=L4ohGScvN1lj3HM0A1mdxEEEm3GMJ3ISm_UjBPeXQmo,940
+rundeck/v1/__init__.py,sha256=stKy-CO4DYAq_xa35LOgghZQ6LtrDcZ5WkuffNPGR0I,13
+rundeck/v1/objects/__init__.py,sha256=5n01WuyYDbuLLGGKoqO342Nb15Qgk3s5MUpJKp-o8Ko,21
+rundeck/v1/objects/acl.py,sha256=sTdOxdmsb0DL3OAQNtzZvdxDdTRkKIRZm_UpipMdpI4,1227
+rundeck/v1/objects/adhoc.py,sha256=E5cYrQfI1_fi4ReVTRAX6zcP8fZn77uc3K4XICc2E_4,2787
+rundeck/v1/objects/authorizations.py,sha256=dugrkboWxkQ0phv15CTXTwTfaJKwRRi9UK8zPWoVlmo,1751
+rundeck/v1/objects/executions.py,sha256=amX2zYZkEqwGwLXOGDoA0gdtpS57xzO-pTtvdgPvF_Q,14752
+rundeck/v1/objects/features.py,sha256=bVMLB86HIZF7dhN3EpqMVP_Yo_J2_hqtbJjZFb7BMxU,1283
+rundeck/v1/objects/jobs.py,sha256=9UPmkZn_NNEjGkbY9ysS4vL_QXXYACucOyE2D-UxLe8,14166
+rundeck/v1/objects/key_storage.py,sha256=mPZYqgqeeI_ujvwXHGLjTwxbgoMk_Pw7ND-dlob2WAY,3807
+rundeck/v1/objects/metrics.py,sha256=Q4amOwyZyRQltozxCiYYLWxhCdps7kN74nXDmSz2FFI,2909
+rundeck/v1/objects/plugins.py,sha256=a2vGsiQGz8V5gXNepj2KP98M926zzxRpksddKtZy5N8,1124
+rundeck/v1/objects/project_plugins.py,sha256=Ecy-kWIlUKuFspXbcH8neTYu_0qr2_XE0Pb8DzVnfBc,871
+rundeck/v1/objects/projects.py,sha256=0D1BAzBrHzTV0pcHa1wzA5skOGGEqmV5_OsQ2NkZzQU,18645
+rundeck/v1/objects/scheduler.py,sha256=yUG_vF5SdP7g0nEkwQ5D4WfA7xeer3blAaHdp7LsnVs,2033
+rundeck/v1/objects/scm.py,sha256=Fobtecr-7GH71nTCn5Jf-6RANMVdnVQDzoFaFsrH9y8,7940
+rundeck/v1/objects/system.py,sha256=h1sJ2fXxKp9PLL4Mz1fxMYjUe0oyjsXMSbMD20ExTas,4897
+rundeck/v1/objects/tokens.py,sha256=R36R7z8jSsRUYDmuihE8b9er7uYcyoQw3n5HbveAE5E,2578
+rundeck/v1/objects/users.py,sha256=hJFMvO1_L_Qql2_K3VvS3EXOxZow4ucQ8yLijziOL8s,3870
+rundeck/v1/objects/webhooks.py,sha256=F_HzNvlBRPvS_viu2reCRc7ECqRSUhp5RfD_G3r-ZZk,3358
+python_rundeck-2.0.1.dist-info/METADATA,sha256=AfKPQ4AREsjZHliQ3N0LbNPWrAClq45e0CyMiBt_WmQ,23062
+python_rundeck-2.0.1.dist-info/WHEEL,sha256=L-WvLdSBvJWHXv5zrQxDvNRnIgoBzLUpcbuiw19KCuQ,88
+python_rundeck-2.0.1.dist-info/licenses/LICENSE,sha256=3X-BjvCzow8iLfLMykDaEAXjE9JvDrEHPkH9UK7MMMA,1073
+python_rundeck-2.0.1.dist-info/RECORD,,

{python_rundeck-1.1.0.dist-info → python_rundeck-2.0.1.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.4.0
+Generator: poetry-core 2.5.0
 Root-Is-Purelib: true
 Tag: py3-none-any

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."""

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,13 +40,14 @@ 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 = "60"
 API_VERSION_MIN = "14"
 API_VERSION_SERVER_MIN = "17"
 API_VERSION_DEPRECATION = "34"
 
 # Defaults
-DEFAULT_API_VERSION = API_VERSION_CURRENT
+# v60 adds Enterprise endpoints only; keep the Community-compatible default.
+DEFAULT_API_VERSION = "59"
 DEFAULT_TIMEOUT = 30
 USER_AGENT = "python-rundeck"
 

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)

rundeck/v1/objects/acl.py

@@ -6,14 +6,32 @@ from rundeck.utils import build_headers
 
 
 class YamlPolicyMixin:
-    _yaml_content_type = "application/yaml"
+    def _get_yaml(self, path: str) -> str:
+        response = self.rd.http_get(
+            path, raw=True, headers={"Accept": "application/yaml"}
+        )
+        # Some older project ACL controllers return a JSON envelope despite Accept.
+        if (
+            "application/json"
+            in getattr(response, "headers", {}).get("Content-Type", "").lower()
+        ):
+            result = response.json()
+            if isinstance(result, dict) and isinstance(result.get("contents"), str):
+                return result["contents"]
+        return response.text
 
     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}
+        return (
+            build_headers(accept="application/json", content_type="application/json")
+            or {}
+        )
 
     def _post_yaml(self, path: str, content: Any) -> Any:
-        return self.rd.http_post(path, data=content, headers=self._yaml_headers())
+        return self.rd.http_post(
+            path, json={"contents": content}, headers=self._yaml_headers()
+        )
 
     def _put_yaml(self, path: str, content: Any) -> Any:
-        return self.rd.http_put(path, data=content, headers=self._yaml_headers())
+        return self.rd.http_put(
+            path, json={"contents": content}, headers=self._yaml_headers()
+        )

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"]

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."""

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"))

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"]

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,8 +193,7 @@ 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)
-        return response.text
+        return self._get_yaml(path)
 
     def create(self, policy_name: str, content: str) -> dict[str, Any]:
         """Crée une politique ACL projet."""
@@ -429,9 +434,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:
@@ -460,6 +481,9 @@ class ProjectArchiveManager(RundeckObjectManager):
     ) -> Any:
         """
         Importe une archive ZIP dans le projet.
+
+        Community 6.3+ exige aussi le droit configure lorsque importConfig ou
+        importNodesSources est activé. Les options et refus sont transmis tels quels.
         """
         params = compact(
             component_options,

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"]

rundeck/v1/objects/system.py

@@ -67,8 +67,7 @@ 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)
-        return self._wrap({"name": policy_name, "content": response.text})
+        return self._wrap({"name": policy_name, "content": self._get_yaml(path)})
 
     def create(self, policy_name: str, content: str) -> SystemACL:
         """Crée une politique ACL système."""
@@ -143,3 +142,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")

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.dist-info/RECORD

@@ -1,30 +0,0 @@
-rundeck/__init__.py,sha256=M413mLKjB08nWuo5godsAmk2ly9vEYw5Xzc-Pt4Pqds,951
-rundeck/base.py,sha256=TGqxLj9F4Y0x7nQGqkjuw7xitzxWOa2fn4apkjpckwE,7119
-rundeck/client.py,sha256=0q7weqAXvl5JDriFol9GVBnqK1NVaOhP_8iMw6QfUzc,11290
-rundeck/config.py,sha256=bVCuqD6Nk6RDS-WAt81uMh6PfQ2ocZDN51Aspjnhjxc,5331
-rundeck/const.py,sha256=RNAix0dcldqI3PhvoZn8F0OmpuNu9ReG21u_ZNxjCec,1619
-rundeck/exceptions.py,sha256=HV5c-YDf0XmV3ia-4kC0iukonsZYLBK1R8X8w05Iw2w,4771
-rundeck/py.typed,sha256=3Q9vdii9v-_pbj9sglgDzJAIelvARaYaDJlB2u-NDqg,38
-rundeck/utils.py,sha256=L4ohGScvN1lj3HM0A1mdxEEEm3GMJ3ISm_UjBPeXQmo,940
-rundeck/v1/__init__.py,sha256=stKy-CO4DYAq_xa35LOgghZQ6LtrDcZ5WkuffNPGR0I,13
-rundeck/v1/objects/__init__.py,sha256=5n01WuyYDbuLLGGKoqO342Nb15Qgk3s5MUpJKp-o8Ko,21
-rundeck/v1/objects/acl.py,sha256=Rt8BFnOi_z_x4RpT-2G7Tf4SVcrCCUh8vLd1j5GIHZk,637
-rundeck/v1/objects/adhoc.py,sha256=E5cYrQfI1_fi4ReVTRAX6zcP8fZn77uc3K4XICc2E_4,2787
-rundeck/v1/objects/config_management.py,sha256=Z5WiqmvPHVsrW65XDmingwar-KGKguyPZAjAP8emnB0,1946
-rundeck/v1/objects/executions.py,sha256=amX2zYZkEqwGwLXOGDoA0gdtpS57xzO-pTtvdgPvF_Q,14752
-rundeck/v1/objects/features.py,sha256=bVMLB86HIZF7dhN3EpqMVP_Yo_J2_hqtbJjZFb7BMxU,1283
-rundeck/v1/objects/jobs.py,sha256=I58FF3-3P5O1dqmpr9AwQH6pGPYqrbR-KK2Gx9vTQyw,13630
-rundeck/v1/objects/key_storage.py,sha256=mPZYqgqeeI_ujvwXHGLjTwxbgoMk_Pw7ND-dlob2WAY,3807
-rundeck/v1/objects/metrics.py,sha256=ipe5WhP1yd3LKqTGPBDFLDG3cjaWPHkkPxw0KGPpDos,2709
-rundeck/v1/objects/plugins.py,sha256=a2vGsiQGz8V5gXNepj2KP98M926zzxRpksddKtZy5N8,1124
-rundeck/v1/objects/projects.py,sha256=eMxKxvTGkmZi-SptJEMKS9kA4YnaXQ8jCOZSk1233Us,17730
-rundeck/v1/objects/scheduler.py,sha256=g16YsnA_QoCH81NtCEgPS31CNFyk5aLZhCMKnfoVTC0,1496
-rundeck/v1/objects/scm.py,sha256=Fobtecr-7GH71nTCn5Jf-6RANMVdnVQDzoFaFsrH9y8,7940
-rundeck/v1/objects/system.py,sha256=x34Cvc8VzaxtbXMzxHPUIxV2YkvFXLI8IiwV4cyvt6A,4786
-rundeck/v1/objects/tokens.py,sha256=OWnfs1QUTpJbsaKf7r0Y7w3VYxxGZxBDead8JAoPKck,2373
-rundeck/v1/objects/users.py,sha256=hJFMvO1_L_Qql2_K3VvS3EXOxZow4ucQ8yLijziOL8s,3870
-rundeck/v1/objects/webhooks.py,sha256=F_HzNvlBRPvS_viu2reCRc7ECqRSUhp5RfD_G3r-ZZk,3358
-python_rundeck-1.1.0.dist-info/METADATA,sha256=11iEODsK7GFF9BqT6g03rp62GZALh9rWl7WntRCwqxg,19406
-python_rundeck-1.1.0.dist-info/WHEEL,sha256=EGEvSphFYqXKs23-kQBeyNoJP1nrT8ZJKQoi5p5DYL8,88
-python_rundeck-1.1.0.dist-info/licenses/LICENSE,sha256=3X-BjvCzow8iLfLMykDaEAXjE9JvDrEHPkH9UK7MMMA,1073
-python_rundeck-1.1.0.dist-info/RECORD,,

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)