operx-cli 0.2.1__tar.gz → 0.2.2__tar.gz

{operx_cli-0.2.1 → operx_cli-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: operx-cli
-Version: 0.2.1
+Version: 0.2.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

{operx_cli-0.2.1 → operx_cli-0.2.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.2.1"
+__version__ = "0.2.2"

{operx_cli-0.2.1 → operx_cli-0.2.2}/operx_cli/app.py

@@ -136,7 +136,7 @@ app.add_typer(personas.app, name="personas")
 
 @app.command()
 def agentes(ctx: typer.Context):
-    """La guía para agentes de IA (Claude, ChatGPT, Copilot): cómo usar operx bien, con cada comando y sus opciones."""
+    """La guía para que un agente de IA (Claude, ChatGPT…) use operx bien."""
     typer.echo(guide_text(ctx.find_root().command))
 
 

{operx_cli-0.2.1 → operx_cli-0.2.2}/operx_cli/commands/account.py

@@ -100,5 +100,6 @@ def cuenta(ctx: typer.Context, as_json: JsonOption = False):
         "Rol": [role for role in roles if role],
         "Productos": [PRODUCT_LABELS.get(product, product) for product in me.get("products") or []],
         "Perfil": session.profile,
-        "Dirección": session.address(),
+        # The API's address, the same for every company (not acme.operx.pro, the app's).
+        "API": session.address(),
     }, "tabla")

{operx_cli-0.2.1 → operx_cli-0.2.2}/operx_cli/shell.py

@@ -13,6 +13,8 @@ import shlex
 
 import typer
 from rich.console import Console
+from rich.padding import Padding
+from rich.table import Table
 from rich.text import Text
 
 from . import settings
@@ -21,8 +23,12 @@ PROMPT = "operx › "
 STOP_WORDS = ("salir", "exit", "quit")
 HELP_WORDS = ("/ayuda", "ayuda", "/help", "help", "?")
 CLEAR_WORDS = ("limpiar", "/limpiar", "clear", "cls")
-# What the prompt offers besides the commands: leaving, and the list of them.
-SHELL_WORDS = [("salir", "Termina esta sesión. No borra tu token."), ("ayuda", "Muestra los comandos.")]
+# What the prompt offers besides the commands, with the other words that do the same.
+SHELL_WORDS = [
+    ("limpiar", "Limpia la pantalla. También: clear, cls."),
+    ("salir", "Termina esta sesión. No borra tu token. También: exit, quit, Ctrl+D."),
+    ("ayuda", "Muestra los comandos. También: help, ?."),
+]
 AMBER = "#fbbf24"
 
 
@@ -111,8 +117,13 @@ def spanish_usage_error(error):
 def print_help(root, console):
     console.print(Text("Comandos", style=f"bold {AMBER}"))
     commands = [(name, _first_line(command.help)) for name, command in root.commands.items() if _visible(command)]
+    # Two columns: on a narrow screen a long description wraps inside its own.
+    table = Table.grid(padding=(0, 2))
+    table.add_column(style="bold", no_wrap=True)
+    table.add_column()
     for name, help_text in commands + SHELL_WORDS:
-        console.print(Text.assemble(("  " + name.ljust(12), "bold"), help_text))
+        table.add_row(name, help_text)
+    console.print(Padding(table, (0, 0, 0, 2)))
     console.print(Text("Escribe un comando con --help para ver sus opciones.", style="dim"))
 
 

{operx_cli-0.2.1 → operx_cli-0.2.2}/operx_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: operx-cli
-Version: 0.2.1
+Version: 0.2.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

{operx_cli-0.2.1 → operx_cli-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "operx-cli"
-version = "0.2.1"
+version = "0.2.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.2.1 → operx_cli-0.2.2}/tests/test_app.py

@@ -70,6 +70,9 @@ def test_cuenta_shows_who_and_where(signed_in):
     assert result.exit_code == 0, result.output
     for text in ("Ana Ruiz", "ana@acme.co", "Acme S.A.S.", "Administrador", "Trabajos, Personas", "https://api.operx.pro"):
         assert text in result.output
+    # The API's address, the same for every company: not the company's web address.
+    api_line = next(line for line in result.output.splitlines() if "https://api.operx.pro" in line)
+    assert api_line.startswith("API ")
 
 
 def test_buscar_lists_what_the_top_bar_finds(signed_in):

{operx_cli-0.2.1 → operx_cli-0.2.2}/tests/test_shell.py

@@ -206,6 +206,49 @@ def test_ayuda_lists_the_commands(capsys):
     assert "entrar" not in out
 
 
+def test_ayuda_lists_every_word_the_prompt_understands(capsys):
+    shell(FakeApi({}), "ayuda")
+    out = capsys.readouterr().out
+    for word in ("salir", "exit", "quit", "Ctrl+D", "limpiar", "clear", "cls", "ayuda", "help", "?"):
+        assert word in out
+
+
+def test_limpiar_is_offered_while_typing():
+    assert "limpiar" in names(suggestions(ROOT, "lim"))
+
+
+def test_ayuda_keeps_a_long_description_in_its_own_column_on_a_narrow_screen():
+    import io
+
+    from rich.console import Console
+
+    from operx_cli.shell import print_help
+
+    out = io.StringIO()
+    print_help(ROOT, Console(file=out, width=60, force_terminal=False, color_system=None))
+    lines = out.getvalue().splitlines()
+    column = lines[1].index("Entra con tu cuenta")
+    wrapped = [line for line in lines[1:-1] if line[:column].strip() == ""]
+
+    assert wrapped  # at 60 columns some descriptions take two lines
+    for line in wrapped:
+        assert line[column - 1] == " " and line[column] != " "
+
+
+def test_every_description_fits_one_line_on_a_common_screen():
+    import io
+
+    from rich.console import Console
+
+    from operx_cli.shell import print_help
+
+    out = io.StringIO()
+    print_help(ROOT, Console(file=out, width=120, force_terminal=False, color_system=None))
+    lines = out.getvalue().splitlines()[1:-1]
+
+    assert all(line[:2] == "  " and line[2] != " " for line in lines)
+
+
 def test_the_old_names_stay_out_of_what_is_offered(capsys):
     shell(FakeApi({}), "ayuda")
     assert "entrar" not in capsys.readouterr().out