tests / tests (push) Failing after 1m5s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
91 lines
4.5 KiB
Python
91 lines
4.5 KiB
Python
"""Le client LibreDesk restreint : le seul code du dépôt qui parle à LibreDesk.
|
||
|
||
Lire des conversations et des messages ; écrire seulement une note privée et des étiquettes (spec §7.2, §7.3).
|
||
Pas de requête générique : une écriture qui n'est pas ici n'existe pas. `ecrire=False` (simulation) : rien n'est envoyé.
|
||
"""
|
||
import json
|
||
import urllib.error
|
||
import urllib.parse
|
||
import urllib.request
|
||
|
||
|
||
class Garde(Exception):
|
||
"""Anomalie du garde-fou d'envoi : l'appelant arrête toute l'exécution (spec §7.3)."""
|
||
|
||
|
||
class LibreDesk:
|
||
def __init__(self, url: str, cle: str, secret: str, ecrire: bool):
|
||
self.url, self.ecrire = url.rstrip("/"), ecrire
|
||
self._auth = f"token {cle}:{secret}"
|
||
|
||
def _requete(self, methode: str, chemin: str, corps: dict | None = None) -> bytes:
|
||
url = urllib.parse.urljoin(self.url + "/", chemin.lstrip("/"))
|
||
r = urllib.request.Request(url, method=methode, data=json.dumps(corps).encode() if corps is not None else None,
|
||
headers={"Content-Type": "application/json"})
|
||
if urllib.parse.urlsplit(url)[:2] == urllib.parse.urlsplit(self.url)[:2]: # la clé ne va qu'à LibreDesk
|
||
r.add_unredirected_header("Authorization", self._auth) # ni à S3 si une pièce y redirige
|
||
with urllib.request.urlopen(r, timeout=30) as rep:
|
||
return rep.read()
|
||
|
||
def _data(self, methode: str, chemin: str, corps: dict | None = None):
|
||
return json.loads(self._requete(methode, chemin, corps) or b"{}").get("data")
|
||
|
||
# --- lectures
|
||
|
||
def moi(self) -> int:
|
||
return self._data("GET", "/api/v1/agents/me")["id"]
|
||
|
||
def ids_etiquettes(self) -> dict[str, int]:
|
||
return {t["name"]: t["id"] for t in self._data("GET", "/api/v1/tags") or []}
|
||
|
||
def conversations(self, avec: int) -> list[dict]:
|
||
"""Toutes les conversations qui portent l'étiquette d'id `avec`."""
|
||
filtre = json.dumps([{"model": "conversations", "field": "tags", "operator": "contains", "value": f"[{avec}]"}])
|
||
tout, page = [], 1
|
||
while True:
|
||
d = self._data("GET", f"/api/v1/conversations/all?page_size=50&page={page}"
|
||
f"&order_by=conversations.last_message_at&order=asc&filters={urllib.parse.quote(filtre)}")
|
||
tout += d.get("results") or []
|
||
if page >= (d.get("total_pages") or 1):
|
||
return tout
|
||
page += 1
|
||
|
||
def etiquettes(self, uuid: str) -> list[str]:
|
||
return self._data("GET", f"/api/v1/conversations/{uuid}").get("tags") or []
|
||
|
||
def messages(self, uuid: str) -> list[dict]:
|
||
return self._data("GET", f"/api/v1/conversations/{uuid}/messages?page_size=500").get("results") or []
|
||
|
||
def piece(self, url: str) -> bytes:
|
||
return self._requete("GET", url)
|
||
|
||
# --- écritures
|
||
|
||
def etiqueter(self, uuid: str, ajouter: list[str] = (), retirer: list[str] = ()) -> None:
|
||
"""Toujours add_tags / remove_tags : sans action, LibreDesk remplacerait toutes les étiquettes."""
|
||
if not self.ecrire:
|
||
print(f"[simulation] {uuid} : + {list(ajouter)} − {list(retirer)}")
|
||
return
|
||
for action, noms in (("add_tags", ajouter), ("remove_tags", retirer)):
|
||
if noms:
|
||
self._data("POST", f"/api/v1/conversations/{uuid}/tags", {"tags": list(noms), "action": action})
|
||
if ajouter and (manque := set(ajouter) - set(self.etiquettes(uuid))):
|
||
raise RuntimeError(f"étiquettes absentes de LibreDesk (ignorées en silence) : {sorted(manque)}")
|
||
|
||
def note_privee(self, uuid: str, html: str) -> dict | None:
|
||
"""La seule écriture de message : private en dur, ni to, ni cc, ni bcc. Toute réponse qui n'est pas une note
|
||
privée lève Garde."""
|
||
if not self.ecrire:
|
||
print(f"[simulation] note pour {uuid} :\n{html}")
|
||
return None
|
||
try:
|
||
m = self._data("POST", f"/api/v1/conversations/{uuid}/messages",
|
||
{"message": html, "private": True, "sender_type": "agent"})
|
||
except urllib.error.HTTPError as e:
|
||
raise Garde(f"note privée refusée ({e.code}) sur {uuid}") from e
|
||
except Exception as e: # injoignable, délai, réponse illisible : rien ne prouve une note privée
|
||
raise Garde(f"réponse invérifiable à la note sur {uuid} : {type(e).__name__}: {e}") from e
|
||
if not isinstance(m, dict) or m.get("private") is not True:
|
||
raise Garde(f"la réponse de LibreDesk n'est pas une note privée ({uuid}) : {str(m)[:200]}")
|
||
return m
|