lkr-dev-cli 0.0.40__tar.gz → 0.0.42__tar.gz

{lkr_dev_cli-0.0.40 → lkr_dev_cli-0.0.42}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lkr-dev-cli
-Version: 0.0.40
+Version: 0.0.42
 Summary: lkr: a command line interface for looker
 Author: bwebs
 License-Expression: MIT
@@ -288,9 +288,51 @@ gcloud run deploy lkr-access-token-updater \
   --set-env-vars LOOKERSDK_CLIENT_ID=<your client id>,LOOKERSDK_CLIENT_SECRET=<your client secret>,LOOKERSDK_BASE_URL=<your instance url>,LOOKER_WHITELISTED_BASE_URLS=<your instance url>
   ```
 
-## UserAttributeUpdater `lkr-dev-cli`
+## Python SDK & Library Usage
 
-Exported from the `lkr-dev-cli` package is the `UserAttributeUpdater` pydantic class. This class has all the necessary logic to update a user attribute value. 
+When installing `lkr-dev-cli` in your Python environment, you can import tools and pre-authenticated Looker SDK clients directly into your scripts, apps, or Jupyter notebooks.
+
+### Package Import Aliases (`lkr` vs `lkr_dev_cli`)
+To maximize convenience and match user intuition, both `lkr` and `lkr_dev_cli` are available as identical top-level Python packages. You can use them completely interchangeably:
+
+```python
+from lkr import init_sdk, UserAttributeUpdater
+# works exactly identical to:
+from lkr_dev_cli import init_sdk, UserAttributeUpdater
+```
+
+### Initializing the Looker SDK (`init_sdk`)
+The `init_sdk()` function initializes and returns an authenticated `ExtendedLooker40SDK` instance. It automatically handles credential discovery and authentication:
+
+```python
+from lkr_dev_cli import init_sdk
+
+# Option 1: Explicit API Authentication
+sdk = init_sdk(
+    base_url="https://acme.cloud.looker.com",
+    client_id="your-client-id",
+    client_secret="your-client-secret",
+    verify_ssl=True,  # optional, defaults to True
+)
+
+# Option 2: Environment Variable API Authentication
+# Automatically uses LOOKERSDK_BASE_URL, LOOKERSDK_CLIENT_ID, LOOKERSDK_CLIENT_SECRET
+sdk = init_sdk()
+
+# Option 3: Database (SQLite) OAuth Login Profile
+# Uses your saved active session from running `lkr auth login`
+sdk = init_sdk()  # Picks the active current_instance = 1
+# Or pick a specific named login profile:
+sdk = init_sdk(instance_name="my_dev_instance")
+
+# Make an API call
+me = sdk.me()
+print(f"Hello, {me.display_name}")
+```
+
+### UserAttributeUpdater
+
+Exported from the package is the `UserAttributeUpdater` pydantic class. This class has all the necessary logic to update a user attribute value. 
 
 It supports the following operations:
 - Updating a default value

{lkr_dev_cli-0.0.40 → lkr_dev_cli-0.0.42}/README.md

@@ -252,9 +252,51 @@ gcloud run deploy lkr-access-token-updater \
   --set-env-vars LOOKERSDK_CLIENT_ID=<your client id>,LOOKERSDK_CLIENT_SECRET=<your client secret>,LOOKERSDK_BASE_URL=<your instance url>,LOOKER_WHITELISTED_BASE_URLS=<your instance url>
   ```
 
-## UserAttributeUpdater `lkr-dev-cli`
+## Python SDK & Library Usage
 
-Exported from the `lkr-dev-cli` package is the `UserAttributeUpdater` pydantic class. This class has all the necessary logic to update a user attribute value. 
+When installing `lkr-dev-cli` in your Python environment, you can import tools and pre-authenticated Looker SDK clients directly into your scripts, apps, or Jupyter notebooks.
+
+### Package Import Aliases (`lkr` vs `lkr_dev_cli`)
+To maximize convenience and match user intuition, both `lkr` and `lkr_dev_cli` are available as identical top-level Python packages. You can use them completely interchangeably:
+
+```python
+from lkr import init_sdk, UserAttributeUpdater
+# works exactly identical to:
+from lkr_dev_cli import init_sdk, UserAttributeUpdater
+```
+
+### Initializing the Looker SDK (`init_sdk`)
+The `init_sdk()` function initializes and returns an authenticated `ExtendedLooker40SDK` instance. It automatically handles credential discovery and authentication:
+
+```python
+from lkr_dev_cli import init_sdk
+
+# Option 1: Explicit API Authentication
+sdk = init_sdk(
+    base_url="https://acme.cloud.looker.com",
+    client_id="your-client-id",
+    client_secret="your-client-secret",
+    verify_ssl=True,  # optional, defaults to True
+)
+
+# Option 2: Environment Variable API Authentication
+# Automatically uses LOOKERSDK_BASE_URL, LOOKERSDK_CLIENT_ID, LOOKERSDK_CLIENT_SECRET
+sdk = init_sdk()
+
+# Option 3: Database (SQLite) OAuth Login Profile
+# Uses your saved active session from running `lkr auth login`
+sdk = init_sdk()  # Picks the active current_instance = 1
+# Or pick a specific named login profile:
+sdk = init_sdk(instance_name="my_dev_instance")
+
+# Make an API call
+me = sdk.me()
+print(f"Hello, {me.display_name}")
+```
+
+### UserAttributeUpdater
+
+Exported from the package is the `UserAttributeUpdater` pydantic class. This class has all the necessary logic to update a user attribute value. 
 
 It supports the following operations:
 - Updating a default value

{lkr_dev_cli-0.0.40 → lkr_dev_cli-0.0.42}/codemode.md

@@ -47,5 +47,14 @@ To check things out on a web panel:
 npx @modelcontextprotocol/inspector uvx -q --from lkr-dev-cli[codemode] lkr code-mode run
 ```
 
-```
+## Architectural & Troubleshooting Notes
+
+### The stdio Stream Corruption Trap
+When running an MCP server over standard input/output (`stdio`) transport, JSON-RPC packets are transmitted directly through the process's `stdout`. 
+
+If Python code executed within the server (such as tool execution or third-party libraries) writes raw text directly to `sys.stdout` via standard `print()` calls, that raw text corrupts the JSON-RPC response stream. This causes fatal JSON parsing errors on the client (e.g., `invalid character 'C' looking for beginning of value`) and immediately closes the connection.
+
+To safeguard against this:
+1. `run_python_code` automatically wraps all Monty execution in a `redirect_stdout` block.
+2. If any `print()` output is captured, it is safely packaged and returned as part of a valid JSON structure rather than polluting raw `stdout`.
 

lkr_dev_cli-0.0.42/lkr/__init__.py

@@ -0,0 +1,5 @@
+from lkr.tools.classes import UserAttributeUpdater
+from lkr.extended_sdk_methods import ExtendedLooker40SDK
+from lkr.auth_service import init_sdk
+
+__all__ = ["UserAttributeUpdater", "ExtendedLooker40SDK", "init_sdk"]

{lkr_dev_cli-0.0.40 → lkr_dev_cli-0.0.42}/lkr/auth_service.py

@@ -22,7 +22,13 @@ from lkr.constants import LOOKER_API_VERSION, OAUTH_CLIENT_ID
 from lkr.custom_types import NewTokenCallback
 from lkr.logger import logger
 
-__all__ = ["get_auth", "ApiKeyAuthSession", "DbOAuthSession", "is_auth_expired"]
+__all__ = [
+    "get_auth",
+    "ApiKeyAuthSession",
+    "DbOAuthSession",
+    "is_auth_expired",
+    "init_sdk",
+]
 
 
 def is_auth_expired(e: Exception) -> bool:
@@ -57,6 +63,7 @@ class ApiKeyApiSettings(ApiSettings):
             base_url=self.api_key.base_url,
             client_id=self.api_key.client_id,
             client_secret=self.api_key.client_secret,
+            verify_ssl=str(self.api_key.verify_ssl).lower(),
         )
 
 
@@ -624,3 +631,57 @@ class ApiKeyAuth:
         raise NotImplementedError(
             "ApiKeyAuth does not support getting current instance"
         )
+
+
+def init_sdk(
+    base_url: str | None = None,
+    client_id: str | None = None,
+    client_secret: str | None = None,
+    verify_ssl: bool | None = None,
+    use_production: bool = True,
+    instance_name: str | None = None,
+) -> Looker40SDK:
+    resolved_base_url = base_url or os.environ.get("LOOKERSDK_BASE_URL")
+    resolved_client_id = client_id or os.environ.get("LOOKERSDK_CLIENT_ID")
+    resolved_client_secret = (
+        client_secret or os.environ.get("LOOKERSDK_CLIENT_SECRET")
+    )
+
+    resolved_verify_ssl: bool
+    if verify_ssl is not None:
+        resolved_verify_ssl = verify_ssl
+    else:
+        if "LOOKERSDK_VERIFY_SSL" in os.environ:
+            verify_ssl_str = os.environ.get("LOOKERSDK_VERIFY_SSL", "true").lower()
+            resolved_verify_ssl = verify_ssl_str not in ("false", "0", "f")
+        else:
+            resolved_verify_ssl = True
+
+    if resolved_base_url or resolved_client_id or resolved_client_secret:
+        if not (
+            resolved_base_url and resolved_client_id and resolved_client_secret
+        ):
+            missing = []
+            if not resolved_base_url:
+                missing.append("base_url")
+            if not resolved_client_id:
+                missing.append("client_id")
+            if not resolved_client_secret:
+                missing.append("client_secret")
+            raise ValueError(
+                f"Incomplete API key configuration. Missing: {', '.join(missing)}"
+            )
+        api_key = LookerApiKey(
+            client_id=resolved_client_id,
+            client_secret=resolved_client_secret,
+            base_url=resolved_base_url,
+            verify_ssl=resolved_verify_ssl,
+        )
+        return init_api_key_sdk(api_key, use_production=use_production)
+
+    ctx = LkrCtxObj(
+        force_oauth=True, oauth_account=instance_name, use_production=use_production
+    )
+    sql_auth = SqlLiteAuth(ctx)
+    return sql_auth.get_current_sdk()
+

{lkr_dev_cli-0.0.40 → lkr_dev_cli-0.0.42}/lkr/classes.py

@@ -8,14 +8,18 @@ class LookerApiKey(BaseModel):
     client_id: str = Field(..., min_length=1)
     client_secret: str = Field(..., min_length=1)
     base_url: str = Field(..., min_length=1)
+    verify_ssl: bool = True
 
     @classmethod
     def from_env(cls):
         try:
+            verify_ssl_str = os.environ.get("LOOKERSDK_VERIFY_SSL", "true").lower()
+            verify_ssl = verify_ssl_str not in ("false", "0", "f")
             return cls(
                 client_id=os.environ.get("LOOKERSDK_CLIENT_ID"),  # type: ignore
                 client_secret=os.environ.get("LOOKERSDK_CLIENT_SECRET"),  # type: ignore
                 base_url=os.environ.get("LOOKERSDK_BASE_URL"),  # type: ignore
+                verify_ssl=verify_ssl,
             )
         except Exception:
             return None

{lkr_dev_cli-0.0.40 → lkr_dev_cli-0.0.42}/lkr/codemode/main.py

@@ -1,7 +1,9 @@
 import inspect
-import io
 import json
-from contextlib import redirect_stdout
+import os
+import sys
+import tempfile
+from contextlib import contextmanager
 
 import typer
 import pydantic_monty
@@ -21,8 +23,38 @@ __all__ = ["group"]
 mcp = FastMCP("lkr:codemode")
 group = typer.Typer()
 ctx_lkr: LkrCtxObj | None = None
-
-
+class OSCapture:
+    def __init__(self):
+        self.output = ""
+
+@contextmanager
+def capture_os_stdout():
+    cap = OSCapture()
+    fd, temp_path = tempfile.mkstemp()
+    
+    if sys.stdout and hasattr(sys.stdout, "flush"):
+        sys.stdout.flush()
+        
+    original_stdout = sys.stdout
+    original_stdout_fd = os.dup(1)
+    try:
+        os.dup2(fd, 1)
+        with os.fdopen(os.dup(1), "w") as f:
+            sys.stdout = f
+            yield cap
+            f.flush()
+    finally:
+        sys.stdout = original_stdout
+        os.dup2(original_stdout_fd, 1)
+        os.close(original_stdout_fd)
+        os.close(fd)
+        
+        try:
+            with open(temp_path, "r") as f:
+                cap.output = f.read()
+        finally:
+            if os.path.exists(temp_path):
+                os.remove(temp_path)
 
 def get_mcp_sdk(ctx: LkrCtxObj):
     sdk = get_auth(ctx).get_current_sdk(prompt_refresh_invalid_token=True)
@@ -126,13 +158,12 @@ def run_python_code(code: str, dev_mode: bool = False) -> str:
 
         m = pydantic_monty.Monty(code)
         
-        # Redirect stdout to capture any print() statements
-        # and prevent them from corrupting the JSON-RPC stream
-        f = io.StringIO()
-        with redirect_stdout(f):
+        # Use low-level OS stdout capture to ensure any print() statements
+        # in Rust or sub-interpreters don't corrupt the JSON-RPC stream
+        with capture_os_stdout() as cap:
             result = m.run(external_functions=external_funcs)
         
-        printed_output = f.getvalue()
+        printed_output = cap.output
         
         # m.run() returns the evaluated result of the last expression (which is already a primitive)
         try:
@@ -148,7 +179,10 @@ def run_python_code(code: str, dev_mode: bool = False) -> str:
             output = repr(result)
             
         if printed_output:
-            return f"PRINTED OUTPUT:\n{printed_output}\nRESULT:\n{output}"
+            return json.dumps({
+                "stdout": printed_output,
+                "result": result
+            }, indent=2, default=str)
         return output
     except Exception as e:
         logger.error(f"Error executing Monty: {e}")

{lkr_dev_cli-0.0.40 → lkr_dev_cli-0.0.42}/lkr/extended_sdk_methods/__init__.py

@@ -8,6 +8,7 @@ from lkr.extended_sdk_methods.classes import (
     ProjectGeneratorColumn,
     ProjectGeneratorTable,
     SelectedTable,
+    ProjectCommitRequest,
 )
 from lkr.extended_sdk_methods.main import ExtendedLooker40SDK
 
@@ -22,4 +23,5 @@ __all__ = [
     "GenerateLookMLParameters",
     "SelectedTable",
     "GenerateLookMLWithNewFilesResponse",
+    "ProjectCommitRequest",
 ]