PyLimeRPC: package pylimerpc + pyproject + tests/examples (overname van minimalLS)

- nieuwe package `pylimerpc/` (rpc, session, surveys, tokens, responses, errors, utils, config)
- pyproject.toml (name PyLimeRPC, versie 0.1.0)
- tests/ (69 passed, 2 deselected) en examples/
- .env.example: TLS-verificatie documentatie (LIMESURVEY_VERIFY_SSL)
- README/.gitignore bijgewerkt

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>
This commit is contained in:
Tammo ter Hark 2026-11-19 12:26:35 +01:00
commit d7d9dc61bf

48
pylimerpc/session.py Normal file
View file

@ -0,0 +1,48 @@
"""Session management: create and release session keys via the RemoteControl API.
- ``get_session_key(client, username, password) -> str``
Raises ``LsAuthError`` when the login is refused. Note: LimeSurvey puts
``{"status": "Invalid user name or password!"}`` in the **result** (not in
``error``) on a failed login — this is handled here.
- ``release_session_key(client, session_key)``
"""
from __future__ import annotations
from typing import Any
from .errors import LsAuthError
from .rpc import RpcClient
def get_session_key(client: RpcClient, username: str, password: str) -> str:
"""Request a session key from the RemoteControl endpoint.
Args:
client: an ``RpcClient`` (fixed endpoint URL).
username: RemoteControl user.
password: password (or API token).
Returns:
The session key as a string.
Raises:
LsAuthError: when the login is refused (wrong credentials or blocked user).
LsConnectionError: when the server is unreachable.
"""
result = client.call("get_session_key", [username, password])
if isinstance(result, str) and result:
return result
# LS error pattern: result = {"status": "Invalid user name or password!"}
status = result.get("status") if isinstance(result, dict) else result
raise LsAuthError(
f"Login failed (get_session_key): {status!r}",
method="get_session_key",
rpc_message=str(status),
raw=result,
)
def release_session_key(client: RpcClient, session_key: str) -> Any:
"""Release a session key properly (returns the RPC result)."""
return client.call("release_session_key", [session_key])