operx-cli 0.3.0__tar.gz → 0.3.2__tar.gz

{operx_cli-0.3.0 → operx_cli-0.3.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: operx-cli
-Version: 0.3.0
+Version: 0.3.2
 Summary: La línea de comandos de OperX: tu empresa desde la terminal, con tu token de API.
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -36,8 +36,10 @@ curl -LsSf https://astral.sh/uv/install.sh | sh && uv tool install operx-cli
 Python 3.10 o más nuevo, también sirve `pipx install operx-cli`. Abre una
 terminal nueva y comprueba con `operx --version`.
 
-Para actualizar: cierra `operx` y escribe `uv tool upgrade operx-cli`. La
-pantalla de bienvenida avisa cuando hay una versión nueva.
+Para actualizar: `operx update`. La pantalla de bienvenida avisa cuando hay una
+versión nueva. En Windows la instala otra ventana, que espera a que se cierre
+`operx` (Windows no deja reemplazar un programa abierto); si quedó a medias,
+`uv tool install operx-cli --force --refresh` lo deja bien.
 
 ## Entrar
 
@@ -87,8 +89,9 @@ operx › ayuda
 operx › salir
 ```
 
-`salir` (o Ctrl+D) termina la sesión sin borrar tu token. En un script o una
-tubería, `operx` solo muestra la ayuda y no espera a nadie.
+`salir` (o Ctrl+D) termina la sesión sin borrar tu token. `ayuda` y Tab
+muestran solo los comandos de los productos que tiene tu empresa. En un script
+o una tubería, `operx` solo muestra la ayuda y no espera a nadie.
 
 ## Comandos
 

{operx_cli-0.3.0 → operx_cli-0.3.2}/README.md

@@ -22,8 +22,10 @@ curl -LsSf https://astral.sh/uv/install.sh | sh && uv tool install operx-cli
 Python 3.10 o más nuevo, también sirve `pipx install operx-cli`. Abre una
 terminal nueva y comprueba con `operx --version`.
 
-Para actualizar: cierra `operx` y escribe `uv tool upgrade operx-cli`. La
-pantalla de bienvenida avisa cuando hay una versión nueva.
+Para actualizar: `operx update`. La pantalla de bienvenida avisa cuando hay una
+versión nueva. En Windows la instala otra ventana, que espera a que se cierre
+`operx` (Windows no deja reemplazar un programa abierto); si quedó a medias,
+`uv tool install operx-cli --force --refresh` lo deja bien.
 
 ## Entrar
 
@@ -73,8 +75,9 @@ operx › ayuda
 operx › salir
 ```
 
-`salir` (o Ctrl+D) termina la sesión sin borrar tu token. En un script o una
-tubería, `operx` solo muestra la ayuda y no espera a nadie.
+`salir` (o Ctrl+D) termina la sesión sin borrar tu token. `ayuda` y Tab
+muestran solo los comandos de los productos que tiene tu empresa. En un script
+o una tubería, `operx` solo muestra la ayuda y no espera a nadie.
 
 ## Comandos
 

{operx_cli-0.3.0 → operx_cli-0.3.2}/operx_cli/__init__.py

@@ -2,4 +2,4 @@
 API (backend/users/api_allowlist.py) from a terminal, with a personal API
 token."""
 
-__version__ = "0.3.0"
+__version__ = "0.3.2"

{operx_cli-0.3.0 → operx_cli-0.3.2}/operx_cli/app.py

@@ -12,7 +12,9 @@ from typer.core import TyperGroup
 from . import __version__, settings, shell
 from .agent_guide import guide_text
 from .client import ApiError
-from .commands import ambiental, account, inventario, lecturas, ordenes, personas, preventivos, raw, registros, search, sst
+from .commands import (
+    account, ambiental, inventario, lecturas, ordenes, personas, preventivos, raw, registros, search, sst, update,
+)
 from .commands.common import CliError, Session
 from .lookup import NoSingleMatch
 from .spreadsheet import SpreadsheetError
@@ -123,6 +125,9 @@ app.command()(account.logout)
 app.command(name="entrar", hidden=True)(account.entrar)
 app.command(name="salir", hidden=True)(account.logout)
 app.command()(account.cuenta)
+app.command()(update.update)
+# In Spanish too, as the other commands are: out of the help.
+app.command(name="actualizar", hidden=True)(update.update)
 app.command()(search.buscar)
 app.command()(raw.api)
 app.add_typer(ordenes.app, name="ordenes")

{operx_cli-0.3.0 → operx_cli-0.3.2}/operx_cli/commands/common.py

@@ -36,6 +36,9 @@ class Session:
     # While the interactive prompt runs: what is typed there must not open
     # another one.
     in_shell: bool = False
+    # Set by a command that needs this operx closed (`update` on Windows):
+    # the prompt ends after it.
+    leave_shell: bool = False
 
     def address(self):
         return settings.address_of(self.profile)

operx_cli-0.3.2/operx_cli/commands/update.py

@@ -0,0 +1,37 @@
+"""`operx update` (self_update.py does the installing)."""
+
+import os
+
+import typer
+
+from .. import __version__, self_update, updates
+from .common import CliError, Session
+
+NO_INSTALLER = (
+    "No encontré uv ni pipx para actualizar. Actualiza como instalaste operx: "
+    "uv tool upgrade operx-cli (o pipx upgrade operx-cli)."
+)
+
+
+def update(ctx: typer.Context):
+    """Instala la versión más nueva de operx."""
+    # Asked now, not the welcome's once-a-day answer: the person wants to know.
+    latest = updates.fetch_latest()
+    if latest and not updates.is_newer(latest, __version__):
+        typer.echo(f"Ya tienes la versión más nueva: {__version__}.")
+        return
+    command = self_update.installer_command(latest)
+    if command is None:
+        raise CliError(NO_INSTALLER)
+    target = f"la {latest}" if latest else "la versión más nueva"
+
+    if self_update.on_windows():
+        self_update.start_window(self_update.window_script(command, os.getpid()))
+        typer.echo(f"Instalando {target} en otra ventana. Esta sesión de operx se cierra para que Windows deje reemplazarlo.")
+        ctx.find_object(Session).leave_shell = True
+        return
+
+    if self_update.run_here(command) != 0:
+        raise CliError("No se pudo actualizar: mira el mensaje de arriba.")
+    typer.echo(f"Listo: tienes {target}. Abre operx de nuevo para usarla.")
+    ctx.find_object(Session).leave_shell = True

operx_cli-0.3.2/operx_cli/self_update.py

@@ -0,0 +1,79 @@
+"""`operx update`: the newest operx from PyPI, installed the way it came
+(uv, or pipx).
+
+On Windows a running program can't be replaced: uv answers "Access is
+denied" and leaves an install that no longer starts. There the work goes to
+a PowerShell window that waits for this operx to close first. Elsewhere it
+happens right here."""
+
+import os
+import shutil
+import subprocess
+import sys
+
+PACKAGE = "operx-cli"
+# How long the window waits for this operx to close before trying anyway.
+WAIT_SECONDS = 60
+
+
+def on_windows():
+    return os.name == "nt"
+
+
+def installer_command(latest=None):
+    """The command that installs the newest operx, or None when neither uv
+    nor pipx is here. --force reinstalls without a pin (a pinned install
+    never upgrades); --refresh skips uv's cached answers, which can lag
+    behind a release (--refresh-package alone put 0.3.0 back the minute
+    0.3.1 came out). With `latest`, PyPI's newest, uv must install at least
+    that one: it fails rather than put the old one back."""
+    if "pipx" in sys.prefix.lower():
+        pipx = shutil.which("pipx")
+        return [pipx, "upgrade", PACKAGE] if pipx else None
+    uv = shutil.which("uv")
+    spec = f"{PACKAGE}>={latest}" if latest else PACKAGE
+    return [uv, "tool", "install", spec, "--force", "--refresh"] if uv else None
+
+
+def _quoted(part):
+    """A PowerShell literal: single quotes, a quote inside doubled."""
+    return "'" + str(part).replace("'", "''") + "'"
+
+
+def window_script(command, pid):
+    """What the window runs: wait for operx (process `pid`) and any other
+    open operx to close, install, and say how it went. It closes by itself
+    when it worked; when not, it says the command that repairs it, since a
+    half-done install may not start operx anymore."""
+    install = "& " + " ".join(_quoted(part) for part in command)
+    by_hand = " ".join([os.path.splitext(os.path.basename(command[0]))[0], *command[1:]])
+    return "; ".join([
+        "$Host.UI.RawUI.WindowTitle = 'Actualizando operx'",
+        "Write-Host 'Esperando a que se cierre operx…'",
+        f"Wait-Process -Id {pid} -Timeout {WAIT_SECONDS} -ErrorAction SilentlyContinue",
+        # operx.exe, the launcher around this Python, closes right after it.
+        "Start-Sleep -Seconds 1",
+        # Another window with operx open would make the install fail halfway.
+        "$others = Get-Process operx -ErrorAction SilentlyContinue",
+        "if ($others) { Write-Host 'Hay otra ventana con operx abierto: ciérrala para seguir.' -ForegroundColor Yellow; "
+        f"$others | Wait-Process -Timeout {WAIT_SECONDS * 2} -ErrorAction SilentlyContinue }}",
+        install,
+        "if ($LASTEXITCODE -eq 0) { "
+        "Write-Host ''; Write-Host 'Listo: ya tienes la versión nueva. Abre operx de nuevo.' -ForegroundColor Green; "
+        "Start-Sleep -Seconds 6 } else { "
+        "Write-Host ''; Write-Host 'No se pudo actualizar. Cierra las ventanas con operx abierto y escribe: "
+        f"{by_hand}' -ForegroundColor Red; Read-Host 'Pulsa Enter para cerrar' }}",
+    ])
+
+
+def start_window(script):
+    """A PowerShell window of its own: it outlives this operx."""
+    subprocess.Popen(
+        ["powershell", "-NoProfile", "-ExecutionPolicy", "Bypass", "-Command", script],
+        creationflags=subprocess.CREATE_NEW_CONSOLE,
+    )
+
+
+def run_here(command):
+    """The install in this terminal, its output shown; its exit code."""
+    return subprocess.run(command).returncode

{operx_cli-0.3.0 → operx_cli-0.3.2}/operx_cli/shell.py

@@ -30,6 +30,27 @@ SHELL_WORDS = [
     ("ayuda", "Muestra los comandos. También: help, ?."),
 ]
 AMBER = "#fbbf24"
+# What a command needs: one of these products (the backend's tenants/products.py
+# API_PRODUCT). Without one, the API answers "Tu empresa no tiene …", so the
+# prompt doesn't offer it. A command not here works for every company.
+COMMAND_PRODUCTS = {
+    "ordenes": ("maintenance",),
+    "preventivos": ("maintenance",),
+    "equipos": ("maintenance", "inventory", "equipment", "environment"),
+    "clientes": ("maintenance", "inventory", "sst", "environment"),
+    "inventario": ("inventory",),
+    "lecturas": ("equipment",),
+    "personas importar": ("people",),
+    "sst": ("sst",),
+    "ambiental": ("environment",),
+}
+
+
+def offered_to(command_path, products):
+    """Whether the company's products let it use the command; every command
+    when they aren't known (not signed in)."""
+    needed = COMMAND_PRODUCTS.get(command_path)
+    return products is None or needed is None or bool(set(needed) & set(products))
 
 
 def split_line(line, windows=None):
@@ -66,16 +87,18 @@ def _option_named(command, word):
     return None
 
 
-def suggestions(root, text):
+def suggestions(root, text, products=None):
     """What to offer after `text`, as (word, help) pairs: the commands of
-    where the line has got to, the options of a command, or the values an
-    option allows."""
+    where the line has got to (only those `products` allow, when known), the
+    options of a command, or the values an option allows."""
     words = text.split()
     current = "" if not words or text.endswith(" ") else words.pop()
     node = root
+    path = []
     for word in words:
         if hasattr(node, "commands") and word in node.commands:
             node = node.commands[word]
+            path.append(word)
 
     option = _option_named(node, words[-1]) if words else None
     if option is not None and not getattr(option, "is_flag", False):
@@ -83,7 +106,10 @@ def suggestions(root, text):
         return [(choice, "") for choice in choices if choice.startswith(current)]
 
     if hasattr(node, "commands"):
-        offered = [(name, _first_line(command.help)) for name, command in node.commands.items() if _visible(command)]
+        offered = [
+            (name, _first_line(command.help)) for name, command in node.commands.items()
+            if _visible(command) and offered_to(" ".join([*path, name]), products)
+        ]
         if node is root:
             offered += SHELL_WORDS
         return [(name, help_text) for name, help_text in offered if name.startswith(current)]
@@ -114,9 +140,12 @@ def spanish_usage_error(error):
     return f"No entendí eso ({message}). Prueba con --help."
 
 
-def print_help(root, console):
+def print_help(root, console, products=None):
     console.print(Text("Comandos", style=f"bold {AMBER}"))
-    commands = [(name, _first_line(command.help)) for name, command in root.commands.items() if _visible(command)]
+    commands = [
+        (name, _first_line(command.help)) for name, command in root.commands.items()
+        if _visible(command) and offered_to(name, products)
+    ]
     # Two columns: on a narrow screen a long description wraps inside its own.
     print_aligned(console, commands + SHELL_WORDS, label_style="bold")
     console.print(Text("Escribe un comando con --help para ver sus opciones.", style="dim"))
@@ -137,8 +166,9 @@ def run_command(session, root, argv):
             typer.echo(f"Error: algo falló ({type(error).__name__}).", err=True)
 
 
-def handle_line(session, root, line, console):
-    """Runs one typed line; False when the person asked to leave."""
+def handle_line(session, root, line, console, products=None):
+    """Runs one typed line; False when the person asked to leave. `products`:
+    the company's, so `ayuda` lists only what it can use."""
     try:
         argv = split_line(line)
     except ValueError:
@@ -151,7 +181,7 @@ def handle_line(session, root, line, console):
         if word in STOP_WORDS:
             return False
         if word in HELP_WORDS:
-            print_help(root, console)
+            print_help(root, console, products)
             return True
         if word in CLEAR_WORDS:
             console.clear()
@@ -166,11 +196,11 @@ def history_path():
     return folder / "historial"
 
 
-def make_reader(root, status="", records=None):
+def make_reader(root, status="", records=None, products=None):
     """A function that reads a line: prompt_toolkit with completion and a
     history where the terminal allows it, else the plain input(). `records`
     (record_completion.RecordNames) adds the company's records where a
-    command takes one."""
+    command takes one; `products` leaves out the commands it can't use."""
     try:
         from prompt_toolkit import PromptSession
         from prompt_toolkit.completion import Completer, Completion, ThreadedCompleter
@@ -182,7 +212,7 @@ def make_reader(root, status="", records=None):
                 text = document.text_before_cursor
                 words = text.split()
                 typed = "" if not text or text.endswith(" ") else words.pop()
-                offered = suggestions(root, text)
+                offered = suggestions(root, text, products)
                 for name, help_text in offered:
                     yield Completion(name, start_position=-len(typed), display_meta=help_text)
                 if offered or records is None:
@@ -246,14 +276,17 @@ def enter(session, root):
     console = Console()
     me = print_welcome(session, console)
     print_tips(console, (me or {}).get("products") or [])
-    run_shell(session, root, console, reader=session.reader, status=status_line(me))
+    # Unknown without signing in: then every command is offered.
+    products = me.get("products") if me else None
+    run_shell(session, root, console, reader=session.reader, status=status_line(me), products=products)
 
 
-def run_shell(session, root, console=None, reader=None, status=""):
+def run_shell(session, root, console=None, reader=None, status="", products=None):
     """The prompt: reads a line, runs it, until the person leaves (salir,
-    Ctrl+D). Ctrl+C only clears the line."""
+    Ctrl+D). Ctrl+C only clears the line. `products`: the company's, so
+    `ayuda` and Tab offer only what it can use."""
     console = console or Console()
-    reader = reader or make_reader(root, status, RecordNames(session))
+    reader = reader or make_reader(root, status, RecordNames(session), products)
     session.in_shell = True
     try:
         while True:
@@ -263,7 +296,10 @@ def run_shell(session, root, console=None, reader=None, status=""):
                 break
             except KeyboardInterrupt:
                 continue
-            if not handle_line(session, root, line, console):
+            if not handle_line(session, root, line, console, products):
+                break
+            if session.leave_shell:
+                # `update` on Windows: this operx must close to be replaced.
                 break
     finally:
         session.in_shell = False

{operx_cli-0.3.0 → operx_cli-0.3.2}/operx_cli/updates.py

@@ -14,7 +14,7 @@ PYPI_URL = "https://pypi.org/pypi/operx-cli/json"
 CHECK_EVERY = timedelta(days=1)
 TIMEOUT_SECONDS = 1.0
 SAVED_FILE = "version.json"
-UPGRADE_LINE = "uv tool upgrade operx-cli"
+UPGRADE_LINE = "operx update"
 
 
 def fetch_latest(transport=None):
@@ -40,11 +40,15 @@ def newer_version(current, fetch=None, now=None):
         latest = fetch()
         # Kept even when PyPI didn't answer: offline, it's tried again tomorrow.
         _save(now, latest)
-    if latest and _parts(latest) > _parts(current):
+    if latest and is_newer(latest, current):
         return latest
     return None
 
 
+def is_newer(version, current):
+    return _parts(version) > _parts(current)
+
+
 def _parts(version):
     """'0.10.2' → (0, 10, 2), so 0.10 comes after 0.9."""
     try:

{operx_cli-0.3.0 → operx_cli-0.3.2}/operx_cli/welcome.py

@@ -87,8 +87,7 @@ def print_welcome(session, console=None):
     console.print(Text(f"OperX desde la terminal · v{__version__}", style="dim"))
     newer = updates.newer_version(__version__)
     if newer:
-        # An open operx keeps Windows from replacing it: close it first.
-        console.print(Text(f"Hay una versión nueva: {newer}. Cierra operx y escribe: {updates.UPGRADE_LINE}", style=AMBER))
+        console.print(Text(f"Hay una versión nueva: {newer}. Escribe: {updates.UPGRADE_LINE}", style=AMBER))
     console.print()
 
     token = settings.token_of(session.profile)

{operx_cli-0.3.0 → operx_cli-0.3.2}/operx_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: operx-cli
-Version: 0.3.0
+Version: 0.3.2
 Summary: La línea de comandos de OperX: tu empresa desde la terminal, con tu token de API.
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -36,8 +36,10 @@ curl -LsSf https://astral.sh/uv/install.sh | sh && uv tool install operx-cli
 Python 3.10 o más nuevo, también sirve `pipx install operx-cli`. Abre una
 terminal nueva y comprueba con `operx --version`.
 
-Para actualizar: cierra `operx` y escribe `uv tool upgrade operx-cli`. La
-pantalla de bienvenida avisa cuando hay una versión nueva.
+Para actualizar: `operx update`. La pantalla de bienvenida avisa cuando hay una
+versión nueva. En Windows la instala otra ventana, que espera a que se cierre
+`operx` (Windows no deja reemplazar un programa abierto); si quedó a medias,
+`uv tool install operx-cli --force --refresh` lo deja bien.
 
 ## Entrar
 
@@ -87,8 +89,9 @@ operx › ayuda
 operx › salir
 ```
 
-`salir` (o Ctrl+D) termina la sesión sin borrar tu token. En un script o una
-tubería, `operx` solo muestra la ayuda y no espera a nadie.
+`salir` (o Ctrl+D) termina la sesión sin borrar tu token. `ayuda` y Tab
+muestran solo los comandos de los productos que tiene tu empresa. En un script
+o una tubería, `operx` solo muestra la ayuda y no espera a nadie.
 
 ## Comandos
 

{operx_cli-0.3.0 → operx_cli-0.3.2}/operx_cli.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ operx_cli/client.py
 operx_cli/lookup.py
 operx_cli/output.py
 operx_cli/record_completion.py
+operx_cli/self_update.py
 operx_cli/settings.py
 operx_cli/shell.py
 operx_cli/spreadsheet.py
@@ -35,6 +36,7 @@ operx_cli/commands/raw.py
 operx_cli/commands/registros.py
 operx_cli/commands/search.py
 operx_cli/commands/sst.py
+operx_cli/commands/update.py
 tests/test_agentes.py
 tests/test_app.py
 tests/test_cards.py
@@ -49,6 +51,7 @@ tests/test_personas.py
 tests/test_preventivos.py
 tests/test_record_completion.py
 tests/test_registros.py
+tests/test_self_update.py
 tests/test_settings.py
 tests/test_shell.py
 tests/test_spreadsheet.py

{operx_cli-0.3.0 → operx_cli-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "operx-cli"
-version = "0.3.0"
+version = "0.3.2"
 description = "La línea de comandos de OperX: tu empresa desde la terminal, con tu token de API."
 readme = "README.md"
 requires-python = ">=3.10"

operx_cli-0.3.2/tests/test_self_update.py

@@ -0,0 +1,155 @@
+"""`operx update`: the newest operx from PyPI, installed the way it was. On
+Windows a running program can't be replaced, so a PowerShell window does it
+once this operx has closed."""
+
+import os
+
+import httpx
+import pytest
+
+from operx_cli import __version__, self_update
+from operx_cli.commands.common import Session
+from operx_cli.shell import run_shell
+
+from .fake_api import FakeApi, run
+from .test_shell import ROOT, typed
+
+UV = r"C:\Users\Ana\.local\bin\uv.exe"
+
+
+@pytest.fixture
+def started(monkeypatch):
+    """The PowerShell windows `operx update` asked for, and the commands it ran here."""
+    calls = {"windows": [], "ran": []}
+    monkeypatch.setattr(self_update, "start_window", lambda script: calls["windows"].append(script))
+    monkeypatch.setattr(self_update, "run_here", lambda command: calls["ran"].append(command) or 0)
+    monkeypatch.setattr(
+        self_update, "installer_command", lambda latest=None: [UV, "tool", "install", "operx-cli", "--force"],
+    )
+    return calls
+
+
+def newest_is(monkeypatch, version):
+    monkeypatch.setattr("operx_cli.updates.fetch_latest", lambda transport=None: version)
+
+
+def test_with_the_newest_already_it_does_nothing(monkeypatch, started):
+    newest_is(monkeypatch, __version__)
+
+    result = run(FakeApi({}), "update")
+
+    assert result.exit_code == 0, result.output
+    assert f"Ya tienes la versión más nueva: {__version__}" in result.output
+    assert started == {"windows": [], "ran": []}
+
+
+def test_on_windows_a_window_updates_once_this_operx_closes(monkeypatch, started):
+    newest_is(monkeypatch, "9.9.9")
+    monkeypatch.setattr(self_update, "on_windows", lambda: True)
+
+    result = run(FakeApi({}), "update")
+
+    assert result.exit_code == 0, result.output
+    assert "9.9.9" in result.output and "otra ventana" in result.output
+    [script] = started["windows"]
+    assert f"Wait-Process -Id {os.getpid()}" in script
+    assert f"& '{UV}' 'tool' 'install' 'operx-cli' '--force'" in script
+    assert started["ran"] == []
+
+
+def test_at_the_prompt_on_windows_the_session_ends_so_it_can_be_replaced(monkeypatch, started):
+    newest_is(monkeypatch, "9.9.9")
+    monkeypatch.setattr(self_update, "on_windows", lambda: True)
+    session = Session(transport=httpx.MockTransport(FakeApi({})))
+    lines_left = typed("update", "cuenta")
+
+    run_shell(session, ROOT, reader=lines_left)
+
+    assert len(started["windows"]) == 1
+    assert lines_left() == "cuenta"  # never read: the prompt closed after update
+
+
+def test_elsewhere_it_updates_right_here(monkeypatch, started):
+    newest_is(monkeypatch, "9.9.9")
+    monkeypatch.setattr(self_update, "on_windows", lambda: False)
+
+    result = run(FakeApi({}), "update")
+
+    assert result.exit_code == 0, result.output
+    assert started["ran"] == [[UV, "tool", "install", "operx-cli", "--force"]]
+    assert "9.9.9" in result.output
+
+
+def test_a_failed_install_says_so(monkeypatch, started):
+    newest_is(monkeypatch, "9.9.9")
+    monkeypatch.setattr(self_update, "on_windows", lambda: False)
+    monkeypatch.setattr(self_update, "run_here", lambda command: 1)
+
+    result = run(FakeApi({}), "update")
+
+    assert result.exit_code == 1
+    assert "No se pudo actualizar" in result.output
+
+
+def test_when_pypi_cannot_say_it_updates_anyway(monkeypatch, started):
+    newest_is(monkeypatch, None)
+    monkeypatch.setattr(self_update, "on_windows", lambda: False)
+
+    assert run(FakeApi({}), "update").exit_code == 0
+    assert len(started["ran"]) == 1
+
+
+def test_without_uv_or_pipx_it_says_how(monkeypatch, started):
+    newest_is(monkeypatch, "9.9.9")
+    monkeypatch.setattr(self_update, "installer_command", lambda latest=None: None)
+
+    result = run(FakeApi({}), "update")
+
+    assert result.exit_code == 1
+    assert "uv tool upgrade operx-cli" in result.output
+
+
+def test_the_installer_is_uv_unless_operx_came_with_pipx(monkeypatch):
+    monkeypatch.setattr(self_update.shutil, "which", lambda name: f"/bin/{name}")
+    monkeypatch.setattr(self_update.sys, "prefix", "/home/ana/.local/share/uv/tools/operx-cli")
+    assert self_update.installer_command() == ["/bin/uv", "tool", "install", "operx-cli", "--force", "--refresh"]
+
+    monkeypatch.setattr(self_update.sys, "prefix", "/home/ana/.local/pipx/venvs/operx-cli")
+    assert self_update.installer_command() == ["/bin/pipx", "upgrade", "operx-cli"]
+
+
+def test_uv_is_asked_for_at_least_the_version_pypi_named(monkeypatch):
+    # Right after a release uv's answer can lag behind PyPI's: then it fails
+    # instead of putting the old version back and saying it worked.
+    monkeypatch.setattr(self_update.shutil, "which", lambda name: f"/bin/{name}")
+    monkeypatch.setattr(self_update.sys, "prefix", "/home/ana/.local/share/uv/tools/operx-cli")
+
+    assert self_update.installer_command("0.3.2") == [
+        "/bin/uv", "tool", "install", "operx-cli>=0.3.2", "--force", "--refresh",
+    ]
+
+
+def test_update_passes_pypi_s_version_to_the_installer(monkeypatch, started):
+    newest_is(monkeypatch, "9.9.9")
+    monkeypatch.setattr(self_update, "on_windows", lambda: False)
+    asked = []
+    monkeypatch.setattr(self_update, "installer_command", lambda latest=None: asked.append(latest) or ["uv"])
+
+    run(FakeApi({}), "update")
+
+    assert asked == ["9.9.9"]
+
+
+def test_the_window_quotes_a_path_with_spaces_and_quotes():
+    script = self_update.window_script([r"C:\Users\Ana O'Neil\uv.exe", "tool"], 4242)
+
+    assert "& 'C:\\Users\\Ana O''Neil\\uv.exe' 'tool'" in script
+    assert "Wait-Process -Id 4242" in script
+
+
+def test_the_window_waits_for_other_operx_windows_and_says_how_to_repair():
+    # Another open operx makes uv fail halfway and leaves an operx that won't start.
+    script = self_update.window_script([r"C:\bin\uv.exe", "tool", "install", "operx-cli", "--force"], 4242)
+
+    assert "Get-Process operx" in script
+    assert "uv tool install operx-cli --force" in script

{operx_cli-0.3.0 → operx_cli-0.3.2}/tests/test_shell.py

@@ -32,10 +32,10 @@ def typed(*lines):
     return read
 
 
-def shell(fake, *lines):
+def shell(fake, *lines, products=None):
     settings.save_token("principal", "opx_test")
     session = Session(transport=httpx.MockTransport(fake), sleep=lambda seconds: None)
-    run_shell(session, ROOT, reader=typed(*lines))
+    run_shell(session, ROOT, reader=typed(*lines), products=products)
 
 
 # ── Reading a line the way a person types it ─────────────────────────────────
@@ -82,6 +82,19 @@ def test_operx_alone_on_a_terminal_shows_the_welcome_and_opens_the_prompt(monkey
     assert result.output.index("Para empezar") < result.output.index("Correo")
 
 
+def test_the_prompt_takes_the_company_s_products_from_who_signed_in(monkeypatch):
+    monkeypatch.setattr("operx_cli.app.is_interactive", lambda: True)
+    settings.save_token("principal", "opx_test")
+    fake = FakeApi({("GET", "auth/me/"): ME, ("GET", "work-orders/facets/"): FACETS})  # ME has only maintenance
+    session = Session(transport=httpx.MockTransport(fake), reader=typed("ayuda", "salir"))
+
+    result = CliRunner().invoke(app, [], obj=session)
+
+    listed = help_commands(result.output.split("Comandos", 1)[1])
+    assert "ordenes" in listed
+    assert "sst" not in listed and "inventario" not in listed
+
+
 def test_operx_alone_without_a_token_still_opens_the_prompt_so_login_can_be_typed(monkeypatch):
     monkeypatch.setattr("operx_cli.app.is_interactive", lambda: True)
     session = Session(transport=httpx.MockTransport(FakeApi({})), reader=typed("salir"))
@@ -206,6 +219,45 @@ def test_ayuda_lists_the_commands(capsys):
     assert "entrar" not in out
 
 
+def help_commands(out):
+    """The command names `ayuda` printed, one per line."""
+    return {line.split()[0] for line in out.splitlines()[1:] if line.startswith("  ") and line.strip()}
+
+
+def test_ayuda_shows_only_the_products_the_company_has(capsys):
+    shell(FakeApi({}), "ayuda", products=["maintenance"])
+    listed = help_commands(capsys.readouterr().out)
+
+    assert {"ordenes", "preventivos", "equipos", "clientes", "lugares", "buscar", "personas"} <= listed
+    assert not {"inventario", "lecturas", "sst", "ambiental"} & listed
+
+
+def test_a_shared_record_shows_with_any_of_its_products(capsys):
+    shell(FakeApi({}), "ayuda", products=["inventory"])
+    listed = help_commands(capsys.readouterr().out)
+
+    assert {"inventario", "equipos", "clientes"} <= listed
+    assert not {"ordenes", "preventivos", "lecturas"} & listed
+
+
+def test_without_knowing_the_products_ayuda_shows_everything(capsys):
+    shell(FakeApi({}), "ayuda")
+
+    assert {"ordenes", "inventario", "lecturas", "sst", "ambiental"} <= help_commands(capsys.readouterr().out)
+
+
+def test_tab_offers_only_the_products_the_company_has():
+    offered = names(suggestions(ROOT, "", products=["sst"]))
+
+    assert "sst" in offered and "lugares" in offered
+    assert "ordenes" not in offered and "ambiental" not in offered
+
+
+def test_tab_hides_a_subcommand_of_a_product_the_company_lacks():
+    assert names(suggestions(ROOT, "personas ", products=["maintenance"])) == ["listar"]
+    assert set(names(suggestions(ROOT, "personas ", products=["people"]))) == {"listar", "importar"}
+
+
 def test_ayuda_lists_every_word_the_prompt_understands(capsys):
     shell(FakeApi({}), "ayuda")
     out = capsys.readouterr().out

{operx_cli-0.3.0 → operx_cli-0.3.2}/tests/test_welcome.py

@@ -64,7 +64,7 @@ def test_a_newer_version_is_announced_with_how_to_update(monkeypatch):
     text = welcome(api())
 
     assert "9.9.9" in text
-    assert "Cierra operx" in text and "uv tool upgrade operx-cli" in text
+    assert "operx update" in text
 
 
 def test_no_notice_when_this_is_the_newest_version():