ragfly-cli 1.16.0__py3-none-any.whl

ragfly_cli/oop/http_client.py

@@ -0,0 +1,106 @@
+"""
+CloudHttpClient — wrapper HTTP unificado para la API cloud.
+
+Encapsula el patrón repetido en `cloud_commands.py`:
+    try:
+        r = httpx.METODO(...)
+        r.raise_for_status()
+        return r.json()
+    except httpx.HTTPStatusError as e:
+        _manejar_http_error(e)
+    except httpx.RequestError as e:
+        raise CloudError(f"Error de conexión: {e}", exit_code=2)
+
+Ejemplo:
+    from ragfly_cli.oop import CloudHttpClient
+    cli = CloudHttpClient()
+    me = cli.get("/auth/me")
+    cli.post("/cloud/algo", body={"x": 1})
+"""
+
+from __future__ import annotations
+
+from typing import Any, Optional
+
+import httpx
+
+# Import diferido para evitar ciclo
+from ragfly_cli.cloud_commands import (
+    CLOUD_URL,
+    CloudError,
+    _headers,
+    _manejar_http_error,
+)
+
+
+class CloudHttpClient:
+    """Cliente HTTP unificado contra la API cloud."""
+
+    def __init__(
+        self,
+        url: str = CLOUD_URL,
+        *,
+        timeout_get: int = 30,
+        timeout_write: int = 60,
+    ):
+        self.url = url
+        self.timeout_get = timeout_get
+        self.timeout_write = timeout_write
+
+    # ── Helper interno ────────────────────────────────────────────────────────
+
+    def _request(
+        self,
+        method: str,
+        path: str,
+        *,
+        params: Optional[dict] = None,
+        body: Optional[dict] = None,
+        token: Optional[str] = None,
+        timeout: Optional[int] = None,
+    ) -> Any:
+        """Ejecuta el request con manejo uniforme de errores."""
+        method = method.upper()
+        is_write = method in ("POST", "PUT", "PATCH", "DELETE")
+        final_timeout = timeout if timeout is not None else (
+            self.timeout_write if is_write else self.timeout_get
+        )
+
+        try:
+            kwargs: dict = {
+                "params": params,
+                "headers": _headers(token),
+                "timeout": final_timeout,
+            }
+            if is_write and method != "DELETE":
+                kwargs["json"] = body or {}
+
+            r = httpx.request(method, f"{self.url}{path}", **kwargs)
+            r.raise_for_status()
+            if r.status_code == 204 or not r.content:
+                return None
+            try:
+                return r.json()
+            except Exception:
+                return r.text
+        except httpx.HTTPStatusError as e:
+            _manejar_http_error(e)
+        except httpx.RequestError as e:
+            raise CloudError(f"Error de conexión: {e}", exit_code=2)
+
+    # ── Verbos HTTP ───────────────────────────────────────────────────────────
+
+    def get(self, path: str, *, params: Optional[dict] = None, token: Optional[str] = None, timeout: Optional[int] = None) -> Any:
+        return self._request("GET", path, params=params, token=token, timeout=timeout)
+
+    def post(self, path: str, *, body: Optional[dict] = None, params: Optional[dict] = None, token: Optional[str] = None, timeout: Optional[int] = None) -> Any:
+        return self._request("POST", path, body=body, params=params, token=token, timeout=timeout)
+
+    def put(self, path: str, *, body: Optional[dict] = None, params: Optional[dict] = None, token: Optional[str] = None, timeout: Optional[int] = None) -> Any:
+        return self._request("PUT", path, body=body, params=params, token=token, timeout=timeout)
+
+    def patch(self, path: str, *, body: Optional[dict] = None, params: Optional[dict] = None, token: Optional[str] = None, timeout: Optional[int] = None) -> Any:
+        return self._request("PATCH", path, body=body, params=params, token=token, timeout=timeout)
+
+    def delete(self, path: str, *, params: Optional[dict] = None, token: Optional[str] = None, timeout: Optional[int] = None) -> Any:
+        return self._request("DELETE", path, params=params, token=token, timeout=timeout)

ragfly_cli/version_check.py

@@ -0,0 +1,96 @@
+"""
+Check de versión del RAGfly Cliente.
+
+Consulta GET /version/cliente/latest al backend y compara con la versión actual.
+Si hay una versión nueva, retorna un mensaje legible para mostrar al usuario.
+Si no hay nueva versión o el backend no responde, retorna None silenciosamente
+(la app sigue funcionando sin red).
+
+Uso:
+
+    from ragfly_cli.version_check import chequear_actualizacion
+    aviso = chequear_actualizacion()
+    if aviso:
+        click.echo(aviso, err=True)
+"""
+
+from __future__ import annotations
+
+import re
+from typing import Optional
+
+import httpx
+
+from . import __version__
+from ._http import default_headers
+
+_RE_VERSION = re.compile(r"^(\d+)\.(\d+)\.(\d+)(?:(a|b|rc)(\d+))?")
+_RANGO_PRE = {"a": 0, "b": 1, "rc": 2}  # final (sin pre) = 3, por encima de todas
+
+
+def _version_tuple(v: str) -> tuple[int, ...]:
+    """Ordena versiones PEP 440 simples: 2.0.0a8 < 2.0.0a9 < 2.0.0b1 < 2.0.0rc1 < 2.0.0.
+
+    Devuelve (major, minor, patch, rango_pre, num_pre). El sufijo alfa/beta/rc
+    YA NO se ignora (antes colapsaba a (0,) y el aviso de upgrade nunca se
+    disparaba entre versiones aN). Una versión final ranquea por encima de sus
+    pre-releases (rango 3 > 2/1/0).
+    """
+    m = _RE_VERSION.match(v.strip())
+    if not m:
+        return (0,)
+    major, minor, patch = int(m.group(1)), int(m.group(2)), int(m.group(3))
+    rango = _RANGO_PRE.get(m.group(4), 3)
+    num_pre = int(m.group(5)) if m.group(5) else 0
+    return (major, minor, patch, rango, num_pre)
+
+
+def chequear_actualizacion(
+    *,
+    cloud_url: Optional[str] = None,
+    timeout: int = 5,
+) -> Optional[str]:
+    """Consulta /version/cliente/latest. Si hay versión nueva, retorna aviso.
+
+    Returns:
+        - str con mensaje "Hay una nueva versión..." si versión actual < latest.
+        - None si está al día, si no hay red, o si el endpoint no existe (404).
+
+    Nota: silencioso ante errores de red — la app no debe romperse por esto.
+    """
+    if cloud_url is None:
+        try:
+            from .config import get_config
+            cloud_url = get_config().cloud_url
+        except Exception:
+            return None
+
+    url = f"{cloud_url.rstrip('/')}/version/cliente/latest"
+    try:
+        r = httpx.get(url, headers=default_headers(), timeout=timeout)
+    except Exception:
+        return None  # sin red u otro error: silencioso
+
+    if r.status_code != 200:
+        return None
+
+    try:
+        data = r.json()
+    except Exception:
+        return None
+
+    latest = data.get("version")
+    if not latest:
+        return None
+
+    if _version_tuple(__version__) >= _version_tuple(latest):
+        return None  # estamos al día o más nuevos
+
+    obligatoria = data.get("obligatoria", False)
+    notas = data.get("notas") or ""
+    prefix = "⚠️  ACTUALIZACIÓN OBLIGATORIA" if obligatoria else "ℹ️  Hay una nueva versión disponible"
+
+    msg = f"{prefix}: RAGfly Desktop v{latest} (tu versión: v{__version__})"
+    if notas:
+        msg += f"\n   {notas}"
+    return msg

ragfly_cli-1.16.0.dist-info/METADATA

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: ragfly-cli
+Version: 1.16.0
+Summary: RAGfly CLI — operate RAGfly from the terminal and CI (login + cloud API). Lightweight, no desktop dependencies.
+Author: CAB Ltda
+License: Proprietary
+Project-URL: Homepage, https://ragfly.ai
+Project-URL: Documentation, https://api.ragfly.ai/docs
+Keywords: ragfly,rag,cli,retrieval,ai,mcp
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.1
+Requires-Dist: rich>=13.0
+Requires-Dist: httpx>=0.27
+Requires-Dist: keyring>=25.0
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pydantic-settings>=2.6
+
+# RAGfly CLI
+
+Operate RAGfly from the terminal and CI — `login` + the full `cloud` API surface
+against `api.ragfly.ai`. Lightweight: depends only on `click`, `rich`, `httpx`
+and `keyring`. **No desktop / PySide6 / OCR dependencies.**
+
+```bash
+pip install ragfly-cli
+ragfly version
+ragfly login
+ragfly cloud me
+```
+
+> This package ships the **`ragfly` binary** for scripting and automation.
+> It is distinct from `pip install ragfly` (the **Python SDK**, import `import ragfly`)
+> and from **RAGfly Desktop** (the DMG/exe that bundles the local file worker for
+> `ragfly local scan/sync/daemon`).
+
+## Authentication
+
+```bash
+# Interactive (JWT, stored in the OS keyring)
+ragfly login
+
+# Non-interactive / CI (API key, no expiry)
+export RAGFLY_TOKEN=slm_live_xxxxxxxxxx
+```
+
+## Command surface
+
+```
+ragfly
+├── login / logout / version
+└── cloud                    ← operations against api.ragfly.ai
+    ├── me
+    ├── grupo       listar | cambiar | limpiar
+    ├── documento   listar | ver
+    ├── espacio     listar | ver
+    ├── cola        ver | ejecuciones
+    ├── habilidad   listar | ver | ejecutar
+    ├── catalogo
+    ├── buscar
+    └── chat        preguntar
+```
+
+Full reference: <https://api.ragfly.ai/docs> and `docs/integradores/CLI.md`.
+
+> **Local operations** (`ragfly local scan/sync/daemon`) require the local file
+> worker and ship with **RAGfly Desktop**, not with this package.
+
+## Source
+
+The command logic is extracted from the RAGfly Desktop client
+(`cliente/ragfly/`). Canonical source of each module lives there; keep this
+package's copies in sync when the cloud command surface changes.

ragfly_cli-1.16.0.dist-info/RECORD

@@ -0,0 +1,17 @@
+ragfly_cli/__init__.py,sha256=zXjo5icgcGx5X40awUvUOk5_ohh0Pz1N3VFKYCfYEcM,23
+ragfly_cli/__main__.py,sha256=DBYMZTzAAf_L8mKAB-tea6WqnNAeMMReFFDUuCRIFM4,107
+ragfly_cli/_http.py,sha256=XkRMvauPJO_ZWT-Hf8vo2h-LDtRnAOf_0dBLcjQD0bE,2262
+ragfly_cli/cli.py,sha256=9OsdxDpV0qHtAyqKQwseFWogPCNYsEP3jHeiNuBqq5Y,36721
+ragfly_cli/cloud_commands.py,sha256=M-emTLhWbx2dbmg6zAhLc_r-P8u4IXTD27J_b1vFIes,7138
+ragfly_cli/config.py,sha256=mUXFgOls6ww7lA6LQw2MPchUTAF7SqqfOKU9L5mVuSA,3578
+ragfly_cli/grupo_activo.py,sha256=nFMWtQc7WoUB2mLeCnZihMSVQLXo7YPaVRYCvjLgjnY,4599
+ragfly_cli/keyring_store.py,sha256=_EERcMoVl6FKwWu4pt4wtz3EHvI01MBfun--fuRng0Y,2143
+ragfly_cli/version_check.py,sha256=mluP0v7oVyFZ5BEJ0FwU_FZFVO88AVtmvy1RhaTmXwg,3005
+ragfly_cli/oop/__init__.py,sha256=AFp0nkOgQu0MgIi6JvyigcY8DDfn6pxHeEGNBqPyFME,414
+ragfly_cli/oop/cli_command.py,sha256=IpFaB0LEd6CG2KutorBHkXcAy1YgquPEqKjXhsru-gU,2748
+ragfly_cli/oop/http_client.py,sha256=9kpmwr4wPsLAnY1bKUKad057oYpkPuVKNvcR6wZVeBE,4036
+ragfly_cli-1.16.0.dist-info/METADATA,sha256=7zb23zm8_59mW8_5T-_Xm_8qiDOinAAh9Ixs8l_UU1I,2273
+ragfly_cli-1.16.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+ragfly_cli-1.16.0.dist-info/entry_points.txt,sha256=_4aVAF9r1xKUjOI-XDjeWOgyEEmp60POOQkx8Qz7y9M,46
+ragfly_cli-1.16.0.dist-info/top_level.txt,sha256=xFhtEPu_3-oWUbNi36KnBkri5RwLrLBiI8GPrM88BNk,11
+ragfly_cli-1.16.0.dist-info/RECORD,,

ragfly_cli-1.16.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ragfly_cli-1.16.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+ragfly = ragfly_cli.cli:app

ragfly_cli-1.16.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ragfly_cli