lkr-dev-cli 0.0.43__tar.gz → 0.0.45__tar.gz

lkr_dev_cli-0.0.45/.github/workflows/website.yml

@@ -0,0 +1,18 @@
+name: Deploy Website
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "**.md"
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Trigger Website Deploy
+        run: |
+          curl -fSL "$DEPLOY_URL"
+        env:
+          DEPLOY_URL: ${{ secrets.DEPLOY_URL }}

{lkr_dev_cli-0.0.43 → lkr_dev_cli-0.0.45}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lkr-dev-cli
-Version: 0.0.43
+Version: 0.0.45
 Summary: lkr: a command line interface for looker
 Author: bwebs
 License-Expression: MIT
@@ -40,7 +40,7 @@ The `lkr` cli is a tool for interacting with Looker. It combines Looker's SDK an
 
 ## Usage
 
-`uv` makes everyone's life easier. Go [install it](https://docs.astral.sh/uv/getting-started/installation/). You can start using `lkr` by running `uvx --from lkr-dev-cli[all] lkr --help`.
+`uv` makes everyone's life easier. Go [install it](https://docs.astral.sh/uv/getting-started/installation/). You can start using `lkr` by running `uvx lkr-dev-cli --help`.
 
 Alternatively, you can install `lkr` with `pip install lkr-dev-cli[all]` and use commands directly like `lkr <command>`.
 
@@ -60,7 +60,7 @@ See the [prerequisites section](#oauth2-prerequisites)
 Login to `lkr`
 
 ```bash
-uvx --from lkr-dev-cli[all] lkr auth login
+uvx lkr-dev-cli auth login
 ```
 
 - Select a new instance
@@ -73,7 +73,7 @@ You will be redirected to the Looker OAuth authorization page, click Allow. If y
 If everything is successful, you will see `Successfully authenticated!`. Test it with
 
 ```bash
-uvx --from lkr-dev-cli[all] lkr auth whoami
+uvx lkr-dev-cli auth whoami
 ```
 
 ### Using API Key
@@ -81,7 +81,7 @@ uvx --from lkr-dev-cli[all] lkr auth whoami
 If you provide environment variables for `LOOKERSDK_CLIENT_ID`, `LOOKERSDK_CLIENT_SECRET`, and `LOOKERSDK_BASE_URL`, `lkr` will use the API key to authenticate and the commands.  We also support command line arguments to pass in the client id, client secret, and base url.
 
 ```bash
-uvx --from lkr-dev-cli[all]  lkr --client-id <your client id> --client-secret <your client secret> --base-url <your instance url> auth whoami
+uvx lkr-dev-cli --client-id <your client id> --client-secret <your client secret> --base-url <your instance url> auth whoami
 ```
 
 
@@ -111,7 +111,19 @@ Go to the Looker API Explorer for Register OAuth App (https://your.looker.instan
 
 ## Code Mode
 
-Execute Python code safely with full Looker SDK coverage within a secure sandbox environment. Constructed as an MCP tool, it dynamically inspects the Looker SDK for all public methods and injects them into the Monty sandbox safely. For detailed options, safe primitives transformations, and PKCE configurations, view the full [Code Mode Docs](./codemode.md).
+Execute Python code safely with full Looker SDK coverage within a secure sandbox environment (`Monty`). It dynamically inspects the Looker SDK for all public methods and injects them into the sandbox safely, supporting both Model Context Protocol (MCP) server mode and direct standalone CLI execution.
+
+### Direct CLI Execution (Sandbox Mode)
+Run scripts or inline code directly against your active Looker instance:
+```bash
+# Execute inline Python code
+uvx lkr-dev-cli code-mode sandbox --code="return me()"
+
+# Execute a Python script file
+uvx lkr-dev-cli code-mode sandbox --file=./path/to/script.py
+```
+
+For detailed options, safe primitive transformations, MCP server configurations, and PKCE recovery, view the full [Code Mode Docs](./codemode.md).
 
 ## MCP
 Built into the `lkr` is an MCP server. Right now its tools are based on helping you work within an IDE. To use it a tool like [Cursor](https://www.cursor.com/), add this to your mcp.json
@@ -120,8 +132,8 @@ Built into the `lkr` is an MCP server. Right now its tools are based on helping
 {
   "mcpServers": {
     "lkr-mcp": {
-      "command": "uv",
-      "args": ["run", "--with", "lkr-dev-cli[all]", "lkr", "mcp", "run"]
+      "command": "uvx",
+      "args": ["lkr-dev-cli[all]", "mcp", "run"]
     },
     "lkr-mcp-docker": {
       "command": "docker",
@@ -422,7 +434,7 @@ By running this tool, an admin can proactively identify and fix permission gaps
 This command should be run by a **Looker Admin**.
 
 ```bash
-uvx --from lkr-dev-cli[all] lkr tools schedule-download-deprecation
+uvx lkr-dev-cli[all] tools schedule-download-deprecation
 ```
 
 Options:

{lkr_dev_cli-0.0.43 → lkr_dev_cli-0.0.45}/README.md

@@ -4,7 +4,7 @@ The `lkr` cli is a tool for interacting with Looker. It combines Looker's SDK an
 
 ## Usage
 
-`uv` makes everyone's life easier. Go [install it](https://docs.astral.sh/uv/getting-started/installation/). You can start using `lkr` by running `uvx --from lkr-dev-cli[all] lkr --help`.
+`uv` makes everyone's life easier. Go [install it](https://docs.astral.sh/uv/getting-started/installation/). You can start using `lkr` by running `uvx lkr-dev-cli --help`.
 
 Alternatively, you can install `lkr` with `pip install lkr-dev-cli[all]` and use commands directly like `lkr <command>`.
 
@@ -24,7 +24,7 @@ See the [prerequisites section](#oauth2-prerequisites)
 Login to `lkr`
 
 ```bash
-uvx --from lkr-dev-cli[all] lkr auth login
+uvx lkr-dev-cli auth login
 ```
 
 - Select a new instance
@@ -37,7 +37,7 @@ You will be redirected to the Looker OAuth authorization page, click Allow. If y
 If everything is successful, you will see `Successfully authenticated!`. Test it with
 
 ```bash
-uvx --from lkr-dev-cli[all] lkr auth whoami
+uvx lkr-dev-cli auth whoami
 ```
 
 ### Using API Key
@@ -45,7 +45,7 @@ uvx --from lkr-dev-cli[all] lkr auth whoami
 If you provide environment variables for `LOOKERSDK_CLIENT_ID`, `LOOKERSDK_CLIENT_SECRET`, and `LOOKERSDK_BASE_URL`, `lkr` will use the API key to authenticate and the commands.  We also support command line arguments to pass in the client id, client secret, and base url.
 
 ```bash
-uvx --from lkr-dev-cli[all]  lkr --client-id <your client id> --client-secret <your client secret> --base-url <your instance url> auth whoami
+uvx lkr-dev-cli --client-id <your client id> --client-secret <your client secret> --base-url <your instance url> auth whoami
 ```
 
 
@@ -75,7 +75,19 @@ Go to the Looker API Explorer for Register OAuth App (https://your.looker.instan
 
 ## Code Mode
 
-Execute Python code safely with full Looker SDK coverage within a secure sandbox environment. Constructed as an MCP tool, it dynamically inspects the Looker SDK for all public methods and injects them into the Monty sandbox safely. For detailed options, safe primitives transformations, and PKCE configurations, view the full [Code Mode Docs](./codemode.md).
+Execute Python code safely with full Looker SDK coverage within a secure sandbox environment (`Monty`). It dynamically inspects the Looker SDK for all public methods and injects them into the sandbox safely, supporting both Model Context Protocol (MCP) server mode and direct standalone CLI execution.
+
+### Direct CLI Execution (Sandbox Mode)
+Run scripts or inline code directly against your active Looker instance:
+```bash
+# Execute inline Python code
+uvx lkr-dev-cli code-mode sandbox --code="return me()"
+
+# Execute a Python script file
+uvx lkr-dev-cli code-mode sandbox --file=./path/to/script.py
+```
+
+For detailed options, safe primitive transformations, MCP server configurations, and PKCE recovery, view the full [Code Mode Docs](./codemode.md).
 
 ## MCP
 Built into the `lkr` is an MCP server. Right now its tools are based on helping you work within an IDE. To use it a tool like [Cursor](https://www.cursor.com/), add this to your mcp.json
@@ -84,8 +96,8 @@ Built into the `lkr` is an MCP server. Right now its tools are based on helping
 {
   "mcpServers": {
     "lkr-mcp": {
-      "command": "uv",
-      "args": ["run", "--with", "lkr-dev-cli[all]", "lkr", "mcp", "run"]
+      "command": "uvx",
+      "args": ["lkr-dev-cli[all]", "mcp", "run"]
     },
     "lkr-mcp-docker": {
       "command": "docker",
@@ -386,7 +398,7 @@ By running this tool, an admin can proactively identify and fix permission gaps
 This command should be run by a **Looker Admin**.
 
 ```bash
-uvx --from lkr-dev-cli[all] lkr tools schedule-download-deprecation
+uvx lkr-dev-cli[all] tools schedule-download-deprecation
 ```
 
 Options:

{lkr_dev_cli-0.0.43 → lkr_dev_cli-0.0.45}/codemode.md

@@ -16,10 +16,21 @@ The tool instantiates Looker SDK natively, searches all bound methods, and passe
 
 ## Continuous Usage
 
-### 1. Starting the Server
-To immediately trigger the stdio listener, use:
+### 1. Direct CLI Execution (Sandbox Mode)
+If you want to execute Python scripts or inline code directly against your Looker instance without setting up an MCP client, use the `sandbox` command:
+
+```bash
+# Execute inline Python code
+uvx lkr-dev-cli code-mode sandbox --code="return me()"
+
+# Execute Python script file
+uvx lkr-dev-cli code-mode sandbox --file=./path/to/script.py
+```
+
+### 2. Starting the Server
+To immediately trigger the MCP stdio listener, use:
 ```bash
-uvx -q --from lkr-dev-cli[codemode] lkr code-mode run
+uvx -q lkr-dev-cli[codemode] code-mode run
 ```
 
 ### 2. Client Configuration
@@ -30,7 +41,7 @@ To hook this server into Cursor or Claude Desktop natively over stdio, append th
   "mcpServers": {
     "lkr_codemode": {
       "command": "uvx",
-      "args": ["-q", "--from", "lkr-dev-cli[codemode]", "lkr", "code-mode", "run"],
+      "args": ["-q", "lkr-dev-cli[codemode]", "code-mode", "run"],
       "env": {
         "LOOKERSDK_BASE_URL": "https://your.looker.instance",
         "LOOKERSDK_CLIENT_ID": "your-client-id",
@@ -44,7 +55,7 @@ To hook this server into Cursor or Claude Desktop natively over stdio, append th
 ### 3. Visual Inspector
 To check things out on a web panel:
 ```bash
-npx @modelcontextprotocol/inspector uvx -q --from lkr-dev-cli[codemode] lkr code-mode run
+npx @modelcontextprotocol/inspector uvx -q lkr-dev-cli[codemode] code-mode run
 ```
 
 ## Architectural & Troubleshooting Notes

{lkr_dev_cli-0.0.43 → lkr_dev_cli-0.0.45}/lkr/codemode/main.py

@@ -1,6 +1,8 @@
+import ast
 import inspect
 import json
 import os
+import re
 import sys
 import tempfile
 from contextlib import contextmanager
@@ -21,7 +23,7 @@ from lkr.logger import logger
 __all__ = ["group"]
 
 mcp = FastMCP("lkr:codemode")
-group = typer.Typer()
+group = typer.Typer(no_args_is_help=True)
 ctx_lkr: LkrCtxObj | None = None
 class OSCapture:
     def __init__(self):
@@ -156,6 +158,24 @@ def run_python_code(code: str, dev_mode: bool = False) -> str:
                 setattr(SDK, name, staticmethod(func))
         external_funcs['sdk'] = SDK
 
+        # Monty external_functions do not support attribute lookups on objects.
+        # Pre-process the code to replace `sdk.method_name` with `method_name` safely using AST.
+        try:
+            class SDKAttributeRewriter(ast.NodeTransformer):
+                def visit_Attribute(self, node):
+                    self.generic_visit(node)
+                    if isinstance(node.value, ast.Name) and node.value.id == 'sdk':
+                        return ast.copy_location(ast.Name(id=node.attr, ctx=node.ctx), node)
+                    return node
+
+            tree = ast.parse(code)
+            tree = SDKAttributeRewriter().visit(tree)
+            ast.fix_missing_locations(tree)
+            code = ast.unparse(tree)
+        except Exception:
+            # Fallback to regex if parsing fails
+            code = re.sub(r"\bsdk\.([a-zA-Z_][a-zA-Z0-9_]*)\b", r"\1", code)
+
         m = pydantic_monty.Monty(code)
         
         # Use low-level OS stdout capture to ensure any print() statements
@@ -191,7 +211,45 @@ def run_python_code(code: str, dev_mode: bool = False) -> str:
         return f"Error: {str(e)}"
 
 
+@group.command(name="sandbox")
+def sandbox(
+    ctx: typer.Context,
+    code: str | None = typer.Option(
+        None, "--code", "-c", help="Execute Python code directly in the sandbox"
+    ),
+    file: str | None = typer.Option(
+        None, "--file", "-f", help="Execute Python code from a file in the sandbox"
+    ),
+    dev_mode: bool = typer.Option(
+        False, "--dev-mode", help="Run in dev mode"
+    ),
+):
+    if not code and not file:
+        logger.error("Must specify either --code or --file")
+        raise typer.Exit(1)
+        
+    if code and file:
+        logger.error("Cannot specify both --code and --file")
+        raise typer.Exit(1)
+        
+    if file:
+        try:
+            with open(file, "r", encoding="utf-8") as f:
+                code_to_run = f.read()
+        except Exception as e:
+            logger.error(f"Failed to read file {file}: {e}")
+            raise typer.Exit(1)
+    else:
+        code_to_run = code
 
+    global ctx_lkr
+    ctx_lkr = (
+        ctx.obj.get("ctx_lkr")
+        if (ctx and ctx.obj and "ctx_lkr" in ctx.obj)
+        else LkrCtxObj(force_oauth=False)
+    )
+    result = run_python_code(code_to_run, dev_mode=dev_mode)
+    typer.echo(result)
 
 
 @group.command(name="run")
@@ -202,7 +260,7 @@ def run(
     global ctx_lkr
     ctx_lkr = (
         ctx.obj.get("ctx_lkr")
-        if (ctx.obj and "ctx_lkr" in ctx.obj)
+        if (ctx and ctx.obj and "ctx_lkr" in ctx.obj)
         else LkrCtxObj(force_oauth=False)
     )
     mcp.run()

{lkr_dev_cli-0.0.43 → lkr_dev_cli-0.0.45}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lkr-dev-cli"
-version = "0.0.43"
+version = "0.0.45"
 description = "lkr: a command line interface for looker"
 readme = "README.md"
 license = "MIT"

{lkr_dev_cli-0.0.43 → lkr_dev_cli-0.0.45}/tests/test_codemode.py

@@ -1,11 +1,15 @@
 from typing import Any, cast
 import json
+import os
+import tempfile
 import pytest
 from unittest.mock import patch, MagicMock
+from typer.testing import CliRunner
 from looker_sdk.rtl.auth_session import AuthSession
 from looker_sdk.rtl.transport import Transport
 from lkr.codemode.main import run_python_code
 from lkr.extended_sdk_methods import ExtendedLooker40SDK
+from lkr.main import app
 
 
 class DummyAuth:
@@ -67,7 +71,7 @@ me_obj = sdk.me()
 return me_obj["first_name"]
 """
     result = run_python_code(code_sdk)
-    assert len(result) > 0
+    assert result == "Test"
 
 def test_examples():
     code_examples = """
@@ -283,3 +287,36 @@ return {"status": "clean"}
     
     out, err = capfd.readouterr()
     assert out == ""
+
+runner = CliRunner()
+
+def test_cli_code_mode_sandbox_code():
+    result = runner.invoke(app, ["code-mode", "sandbox", "--code", "return me()"])
+    assert result.exit_code == 0
+    assert "Test" in result.stdout
+
+def test_cli_code_mode_sandbox_sdk_code():
+    result = runner.invoke(app, ["code-mode", "sandbox", "--code", "return sdk.me()"])
+    assert result.exit_code == 0
+    assert "Test" in result.stdout
+
+def test_cli_code_mode_sandbox_file():
+    with tempfile.NamedTemporaryFile(mode="w", delete=False) as f:
+        f.write("return me()")
+        temp_path = f.name
+        
+    try:
+        result = runner.invoke(app, ["code-mode", "sandbox", "--file", temp_path])
+        assert result.exit_code == 0
+        assert "Test" in result.stdout
+    finally:
+        if os.path.exists(temp_path):
+            os.remove(temp_path)
+
+def test_cli_code_mode_sandbox_both_error():
+    result = runner.invoke(app, ["code-mode", "sandbox", "--code", "return me()", "--file", "dummy.py"])
+    assert result.exit_code == 1
+
+def test_cli_code_mode_sandbox_neither_error():
+    result = runner.invoke(app, ["code-mode", "sandbox"])
+    assert result.exit_code == 1