clikernel 0.2.15__tar.gz → 0.2.16__tar.gz

{clikernel-0.2.15 → clikernel-0.2.16}/CHANGELOG.md

@@ -2,6 +2,15 @@
 
 <!-- do not remove -->
 
+## 0.2.16
+
+### New Features
+
+- Add clikernel-hook PreToolUse hook giving Claude Code subagents their own kernels ([#57](https://github.com/AnswerDotAI/clikernel/issues/57))
+- Display only top-level expression results in Python kernels and cap total image data per tool result at 5 MB to avoid stdio disconnects ([#56](https://github.com/AnswerDotAI/clikernel/issues/56))
+- Switch to BPL ([#55](https://github.com/AnswerDotAI/clikernel/issues/55))
+
+
 ## 0.2.15
 
 ### New Features

{clikernel-0.2.15/clikernel.egg-info → clikernel-0.2.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clikernel
-Version: 0.2.15
+Version: 0.2.16
 Summary: Serve persistent Jupyter kernels to LLMs as concise text, over MCP or a plain stream protocol
 Author: clikernel contributors
 License-Expression: Apache-2.0
@@ -15,7 +15,7 @@ Requires-Dist: fastcore>=2.2.2
 Requires-Dist: jupyasyncclient>=0.2.10
 Requires-Dist: jupywire>=0.1.9
 Requires-Dist: mcpmini>=0.0.5
-Requires-Dist: rustygate>=0.1.22
+Requires-Dist: rustygate>=0.1.25
 Requires-Dist: ipymini>=0.1.23
 Requires-Dist: httpx
 Requires-Dist: ipython
@@ -61,7 +61,9 @@ create(kernel="py")
 exec(code="6*7")
 ```
 
-Use `kernel="luau"` for bundled Luau, or `kernel="apl"` for APL when `basedpl` is installed in the gateway’s environment. `create` accepts any kernelspec the gateway finds. `exec` never creates or switches kernels. See [MCP](https://AnswerDotAI.github.io/clikernel/mcp.html) for named gateways, dialog bindings, and other tools.
+Use `kernel="luau"` for bundled Luau, or `kernel="bpl"` for BPL when `basedpl` is installed in the gateway’s environment. `create` accepts any kernelspec the gateway finds. In the main conversation, `exec` never creates or switches kernels. See [MCP](https://AnswerDotAI.github.io/clikernel/mcp.html) for named gateways, dialog bindings, and other tools.
+
+In Claude Code, subagents share the current kernel unless `clikernel-hook` is registered as a `PreToolUse` hook. With the hook, each subagent’s first `exec` creates a kernel of its own. See [Subagent kernels](https://AnswerDotAI.github.io/clikernel/mcp.html#subagent-kernels) for the settings entry.
 
 The router checks each `exec` cell against built-in rules for mistakes agents often make with this toolkit. Most rules add a note to the reply, and `--quiet` leaves the notes out. Two rules always block the cell: shell access through `subprocess`, [`os.system`](https://docs.python.org/3/library/os.html#os.system) or [`os.popen`](https://docs.python.org/3/library/os.html#os.popen), and changes to `sys.path`.
 

{clikernel-0.2.15 → clikernel-0.2.16}/README.md

@@ -36,7 +36,9 @@ create(kernel="py")
 exec(code="6*7")
 ```
 
-Use `kernel="luau"` for bundled Luau, or `kernel="apl"` for APL when `basedpl` is installed in the gateway’s environment. `create` accepts any kernelspec the gateway finds. `exec` never creates or switches kernels. See [MCP](https://AnswerDotAI.github.io/clikernel/mcp.html) for named gateways, dialog bindings, and other tools.
+Use `kernel="luau"` for bundled Luau, or `kernel="bpl"` for BPL when `basedpl` is installed in the gateway’s environment. `create` accepts any kernelspec the gateway finds. In the main conversation, `exec` never creates or switches kernels. See [MCP](https://AnswerDotAI.github.io/clikernel/mcp.html) for named gateways, dialog bindings, and other tools.
+
+In Claude Code, subagents share the current kernel unless `clikernel-hook` is registered as a `PreToolUse` hook. With the hook, each subagent’s first `exec` creates a kernel of its own. See [Subagent kernels](https://AnswerDotAI.github.io/clikernel/mcp.html#subagent-kernels) for the settings entry.
 
 The router checks each `exec` cell against built-in rules for mistakes agents often make with this toolkit. Most rules add a note to the reply, and `--quiet` leaves the notes out. Two rules always block the cell: shell access through `subprocess`, [`os.system`](https://docs.python.org/3/library/os.html#os.system) or [`os.popen`](https://docs.python.org/3/library/os.html#os.popen), and changes to `sys.path`.
 

{clikernel-0.2.15 → clikernel-0.2.16}/clikernel/__init__.py

@@ -5,7 +5,7 @@ Modules:
 - `clikernel.cli`: The stream-protocol frontend: the service on stdin/stdout for token-reading clients
 - `clikernel.core`: Gateway naming, startup delivery, and MCP sessions on rustygate gateways
 - `clikernel.mcp`: Route stdio MCP requests to rustygate gateways
-- `clikernel.skill`: Use the `clikernel` MCP session as the default workspace for Python work: reading and changing files, notebook work, trying things out, checking how a library behaves, and reshaping data. One session stays open, so imports and variables carry between calls. Read this before writing, running, or debugging Python code in a session with `clikernel` connected.
+- `clikernel.skill`: Use `clikernel` MCP as the default persistent Python workspace for file/notebook reads and edits, exploration, library checks, data reshaping and debugging. Imports and variables carry across calls. Read before writing, running or debugging Python with `clikernel` connected.
 - `clikernel.stream`: Streaming JSON-lines worker protocol: nbformat-shaped output events, and a supervisor for select-based UIs."""
 
-__version__ = "0.2.15"
+__version__ = "0.2.16"

{clikernel-0.2.15 → clikernel-0.2.16}/clikernel/_modidx.py

@@ -23,7 +23,8 @@ d = { 'settings': { 'branch': 'main',
                                 'clikernel.core.Gateway.rpc': ('core.html#gateway.rpc', 'clikernel/core.py'),
                                 'clikernel.core.Gateway.text': ('core.html#gateway.text', 'clikernel/core.py'),
                                 'clikernel.core.Gateway.tools': ('core.html#gateway.tools', 'clikernel/core.py'),
-                                'clikernel.core._startup_src': ('core.html#_startup_src', 'clikernel/core.py'),
+                                'clikernel.core._top_level_display': ('core.html#_top_level_display', 'clikernel/core.py'),
+                                'clikernel.core._with_file': ('core.html#_with_file', 'clikernel/core.py'),
                                 'clikernel.core.cfg_dir': ('core.html#cfg_dir', 'clikernel/core.py'),
                                 'clikernel.core.default_gateway': ('core.html#default_gateway', 'clikernel/core.py'),
                                 'clikernel.core.gateways': ('core.html#gateways', 'clikernel/core.py'),
@@ -36,4 +37,7 @@ d = { 'settings': { 'branch': 'main',
                                'clikernel.mcp.Router.dispatch': ('mcp.html#router.dispatch', 'clikernel/mcp.py'),
                                'clikernel.mcp.Router.session': ('mcp.html#router.session', 'clikernel/mcp.py'),
                                'clikernel.mcp.Router.tools': ('mcp.html#router.tools', 'clikernel/mcp.py'),
+                               'clikernel.mcp._cap_images': ('mcp.html#_cap_images', 'clikernel/mcp.py'),
+                               'clikernel.mcp.agent_input': ('mcp.html#agent_input', 'clikernel/mcp.py'),
+                               'clikernel.mcp.hook': ('mcp.html#hook', 'clikernel/mcp.py'),
                                'clikernel.mcp.main': ('mcp.html#main', 'clikernel/mcp.py')}}}

{clikernel-0.2.15 → clikernel-0.2.16}/clikernel/core.py

@@ -16,7 +16,7 @@ Docs: https://AnswerDotAI.github.io/clikernel/core.html.md"""
 __all__ = ['DEFAULT_URL', 'cfg_dir', 'gateways', 'resolve', 'startup_src', 'session_defaults', 'Gateway', 'default_gateway']
 
 # %% ../nbs/00_core.ipynb #2b3b7f4a
-import os, tomllib, httpx
+import os, inspect, tomllib, httpx
 from fastcore.utils import *
 from fastcore.xdg import xdg_config_home
 from mcpmini.core import HTTPTransport, jreq
@@ -46,18 +46,31 @@ def resolve(host='', cfgdir=None):
 
 
 # %% ../nbs/00_core.ipynb #0d846754
-def _startup_src(src, path):
+def _with_file(src, path):
     "Wrap startup source with `__file__` set to its path during execution and deleted afterwards."
     return f'''__file__ = {str(path)!r}
 try: exec(compile({src!r}, __file__, 'exec'))
 finally: del __file__'''
 
+# %% ../nbs/00_core.ipynb #b0dd40c1
+def _top_level_display(shell):
+    "Make `ast_node_interactivity='all'` display top-level expressions only."
+    import ast
+    run = shell.run_ast_nodes
+    async def run_ast_nodes(nodelist, cell_name, interactivity='last_expr', **kwargs):
+        if interactivity != 'all': return await run(nodelist, cell_name, interactivity, **kwargs)
+        for n in nodelist:
+            if await run([n], cell_name, 'last' if isinstance(n, ast.Expr) else 'none', **kwargs): return True
+        return False
+    shell.run_ast_nodes = run_ast_nodes
+    shell.ast_node_interactivity = 'all'
+
 # %% ../nbs/00_core.ipynb #1362e6ce
 def startup_src(cfgdir=None):
     "Build Python defaults and user startup, in that order."
     d = Path(cfgdir) if cfgdir else cfg_dir()
-    parts = ["get_ipython().ast_node_interactivity = 'all'"]
-    if (p := d/'startup.py').exists(): parts.append(_startup_src(p.read_text(), p))
+    parts = [inspect.getsource(_top_level_display) + '_top_level_display(get_ipython())\ndel _top_level_display']
+    if (p := d/'startup.py').exists(): parts.append(_with_file(p.read_text(), p))
     return '\n'.join(parts)
 
 def session_defaults(cfgdir=None, quiet=False, local=True):

{clikernel-0.2.15 → clikernel-0.2.16}/clikernel/mcp.py

@@ -13,10 +13,10 @@ Docs: https://AnswerDotAI.github.io/clikernel/mcp.html.md"""
 # AUTOGENERATED! DO NOT EDIT! File to edit: ../nbs/01_mcp.ipynb.
 
 # %% auto #0
-__all__ = ['HOST_PARAM', 'HOSTED', 'Router', 'main']
+__all__ = ['HOST_PARAM', 'HOSTED', 'Router', 'main', 'agent_input', 'hook']
 
 # %% ../nbs/01_mcp.ipynb #28c42902
-import asyncio, httpx
+import asyncio, httpx, json
 from fastcore.utils import *
 from fastcore.script import call_parse, store_true
 from mcpmini.core import serve_stdio, jresp, jerr
@@ -55,6 +55,17 @@ async def tools(self:Router):
         if t['name'] in HOSTED: t['inputSchema'].setdefault('properties', {})['host'] = dict(HOST_PARAM)
     return ts
 
+# %% ../nbs/01_mcp.ipynb #6da913bf
+def _cap_images(content, budget=5 << 20):
+    "`content`, with each image that would take the total base64 image data past `budget` bytes replaced by a line of text."
+    left,res = budget,[]
+    for b in content:
+        if b['type'] == 'image':
+            if (n := len(b['data'])) > left: b = dict(type='text', text=f"[{b['mimeType']} image of {n:,} bytes omitted: images in one reply are limited to {budget:,} bytes]")
+            else: left -= n
+        res.append(b)
+    return res
+
 # %% ../nbs/01_mcp.ipynb #e1b057dd
 @patch
 async def dispatch(self:Router, msg, requester=None):
@@ -83,10 +94,11 @@ async def dispatch(self:Router, msg, requester=None):
             try: res = await s.tr.send(msg)
             except httpx.HTTPStatusError as e:
                 if e.response.status_code != 404: raise
-                del self.sessions[h]  # a restarted gateway answers 404 for a session id it no longer knows
+                del self.sessions[h]
                 res = await (await self.session(h)).tr.send(msg)
-            if fired and not self.quiet and 'result' in res:
-                res['result']['content'].insert(0, dict(type='text', text=''.join(f'<note>\n{r.note}\n</note>\n' for r in fired)))
+            if 'result' in res:
+                content = res['result']['content'] = _cap_images(res['result']['content'])
+                if fired and not self.quiet: content.insert(0, dict(type='text', text=''.join(f'<note>\n{r.note}\n</note>\n' for r in fired)))
             return res
         return jerr(id, -32601, f'method not found: {method}')
     except Exception as e: return None if id is None else jerr(id, -32603, str(e))
@@ -114,3 +126,15 @@ def main(
         finally: await router.aclose()
     asyncio.run(_main())
 
+
+# %% ../nbs/01_mcp.ipynb #bc8afe8c
+def agent_input(
+    event:dict,  # A Claude Code `PreToolUse` hook event
+):
+    "`event`'s tool input with `agent` set to the calling subagent's id, or None for a call from the main conversation."
+    if aid := event.get('agent_id'): return event['tool_input'] | dict(agent=aid)
+
+# %% ../nbs/01_mcp.ipynb #105e6780
+def hook():
+    "Run `clikernel-hook`: read a `PreToolUse` event on stdin, and print the `updatedInput` that gives a subagent its own kernel."
+    if upd := agent_input(json.load(sys.stdin)): print(json.dumps(dict(hookSpecificOutput=dict(hookEventName='PreToolUse', updatedInput=upd))))

{clikernel-0.2.15 → clikernel-0.2.16}/clikernel/rules.py

@@ -139,7 +139,7 @@ def _sys_path(tree, src):
 
 
 RULES = [
-    Rule('read_file', 'Read files with lnhashview_file (for editing) or view_file(nums=False).', _read_file),
+    Rule('read_file', 'Read files with open_doc (large), lnhashview_file (for editing) or view_file(nums=False).', _read_file),
     Rule('big_replace', 'Replace a whole cell or file with %%exhash <path> [<cell_id>] % c; an inner region with a range-c address.', _big_replace),
     Rule('cell_str_replace', 'Edit notebook cells with %%exhash <path> <cell_id>.', _cell_str_replace),
     Rule('rawstr', 'Write non-trivial strings as r""" raw strings; %%exhash text needs no escaping at all.', _rawstr),

clikernel-0.2.16/clikernel/skill.py

@@ -0,0 +1,24 @@
+"""Use `clikernel` MCP as the default persistent Python workspace for file/notebook reads and edits, exploration, library checks, data reshaping and debugging. Imports and variables carry across calls. Read before writing, running or debugging Python with `clikernel` connected.
+
+Prefer it to one-off scripts (`python -c`, shell heredocs) and installed in-kernel pyskills to shell equivalents: `rgapi` (`rg()`/`fd()`/`ls()`) for search/listing; `ghapi` for GitHub/local git. Shell stays right for project tests/builds and non-Python tools.
+
+MCP tool descriptions give parameters/rules; this guide combines calls.
+
+`create(kernel="py")` first; read its reply's startup imports and next steps before running anything. Kernels this conversation creates stop at its end. For one that should outlive it, `create(kernel="py", dlgname="work", autoclose=false)` and tell the user its id. It needs a gateway that keeps running; say so if the reply shows a conversation-started gateway.
+
+To continue earlier work or use the user's solveit kernel: `list_kernels`, then `use_kernel` with the id. Attach runs no setup, claims no ownership and never stops that live kernel for you.
+
+`restart` reruns Python startup only in kernels this conversation created; redo everything else. `interrupt` stops a long `exec`, keeping state. A kernel-gone reply requires `create` or `use_kernel` before executing again.
+
+Remote gateways are named in `~/.config/clikernel/gateways.toml`. Same tools/rules: `host=` on `list_kernels`/`use_kernel`/`create`; plain `exec` follows the selected host until the next selection.
+
+`create(kernel="luau")`/`create(kernel="bpl")`: same `exec`/autoclose rules, no Python startup/magics. Each creation reply gives language basics. Luau's `exec(code="help()")` gives the full native API; `help("ex.edit_file")` covers one function. BPL needs `basedpl` in the gateway environment for its `bpl` kernelspec.
+
+# Python
+- Magics work as written, including `%%bash`. Change directory with `%cd` (expands `~`), not `os.chdir`.
+- clikernel-created Python kernels display every top-level expression, not expressions inside loops/blocks. User startup can override this.
+- All cell output reaches the conversation: `len(v)` first, then choose what to show.
+- Don't repeat imports. A `NameError` for a name you set up means the kernel restarted or is newly attached: redo setup.
+- After `nbdev-export` or imported-module edits, `importlib.reload` and re-import held names: `from x import y` keeps the old object; `@patch` refreshes on reload by writing onto the shared class. Restart only when a class you hold instances of was redefined. Check loaded behavior by calling it, never `inspect.getsource` (reads disk).
+- Try the simple import/API call before environment changes, monkeypatching or extra setup.
+"""

{clikernel-0.2.15 → clikernel-0.2.16/clikernel.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clikernel
-Version: 0.2.15
+Version: 0.2.16
 Summary: Serve persistent Jupyter kernels to LLMs as concise text, over MCP or a plain stream protocol
 Author: clikernel contributors
 License-Expression: Apache-2.0
@@ -15,7 +15,7 @@ Requires-Dist: fastcore>=2.2.2
 Requires-Dist: jupyasyncclient>=0.2.10
 Requires-Dist: jupywire>=0.1.9
 Requires-Dist: mcpmini>=0.0.5
-Requires-Dist: rustygate>=0.1.22
+Requires-Dist: rustygate>=0.1.25
 Requires-Dist: ipymini>=0.1.23
 Requires-Dist: httpx
 Requires-Dist: ipython
@@ -61,7 +61,9 @@ create(kernel="py")
 exec(code="6*7")
 ```
 
-Use `kernel="luau"` for bundled Luau, or `kernel="apl"` for APL when `basedpl` is installed in the gateway’s environment. `create` accepts any kernelspec the gateway finds. `exec` never creates or switches kernels. See [MCP](https://AnswerDotAI.github.io/clikernel/mcp.html) for named gateways, dialog bindings, and other tools.
+Use `kernel="luau"` for bundled Luau, or `kernel="bpl"` for BPL when `basedpl` is installed in the gateway’s environment. `create` accepts any kernelspec the gateway finds. In the main conversation, `exec` never creates or switches kernels. See [MCP](https://AnswerDotAI.github.io/clikernel/mcp.html) for named gateways, dialog bindings, and other tools.
+
+In Claude Code, subagents share the current kernel unless `clikernel-hook` is registered as a `PreToolUse` hook. With the hook, each subagent’s first `exec` creates a kernel of its own. See [Subagent kernels](https://AnswerDotAI.github.io/clikernel/mcp.html#subagent-kernels) for the settings entry.
 
 The router checks each `exec` cell against built-in rules for mistakes agents often make with this toolkit. Most rules add a note to the reply, and `--quiet` leaves the notes out. Two rules always block the cell: shell access through `subprocess`, [`os.system`](https://docs.python.org/3/library/os.html#os.system) or [`os.popen`](https://docs.python.org/3/library/os.html#os.popen), and changes to `sys.path`.
 

{clikernel-0.2.15 → clikernel-0.2.16}/clikernel.egg-info/entry_points.txt

@@ -1,5 +1,6 @@
 [console_scripts]
 clikernel = clikernel.cli:main
+clikernel-hook = clikernel.mcp:hook
 clikernel-mcp = clikernel.mcp:main
 
 [nbdev]

{clikernel-0.2.15 → clikernel-0.2.16}/clikernel.egg-info/requires.txt

@@ -2,7 +2,7 @@ fastcore>=2.2.2
 jupyasyncclient>=0.2.10
 jupywire>=0.1.9
 mcpmini>=0.0.5
-rustygate>=0.1.22
+rustygate>=0.1.25
 ipymini>=0.1.23
 httpx
 ipython

{clikernel-0.2.15 → clikernel-0.2.16}/pyproject.toml

@@ -20,7 +20,7 @@ dependencies = [
   "jupyasyncclient>=0.2.10",
   "jupywire>=0.1.9",
   "mcpmini>=0.0.5",
-  "rustygate>=0.1.22",
+  "rustygate>=0.1.25",
   "ipymini>=0.1.23",
   "httpx",
   "ipython",
@@ -42,6 +42,7 @@ Documentation = "https://AnswerDotAI.github.io/clikernel/"
 [project.scripts]
 clikernel = "clikernel.cli:main"
 clikernel-mcp = "clikernel.mcp:main"
+clikernel-hook = "clikernel.mcp:hook"
 
 [project.entry-points.nbdev]
 clikernel = "clikernel._modidx:d"

{clikernel-0.2.15 → clikernel-0.2.16}/tests/test_rules.py

@@ -67,11 +67,11 @@ def test_rules():
     assert fires(f"file_exhash(p, ('1|aa|', 's', 'x', {'y'*121!r}))", "s_long")
     assert not fires(f"file_exhash(p, ('1|aa|', 's', 'x', {'y'*120!r}))", "s_long")
 
-    # blockers: Python's own shell routes, but not `!` escapes, since the router can't tell Python from APL
+    # blockers: Python's own shell routes, but not `!` escapes, since the router can't tell Python from BPL
     assert fires("import subprocess", "shell_escape")
     assert fires("os.system('ls')", "shell_escape")
     assert fires("os.popen('ls')", "shell_escape")
-    assert not fires("!5", "shell_escape")                           # APL's factorial parses exactly like IPython's `!ls`
+    assert not fires("!5", "shell_escape")                           # BPL's factorial parses exactly like IPython's `!ls`
     assert not fires("io.popen('ls')", "shell_escape")               # Luau's popen
     assert fires("import subprocess.x", "shell_escape")          # submodule spellings
     assert fires("from subprocess.x import y", "shell_escape")

clikernel-0.2.15/clikernel/skill.py

@@ -1,29 +0,0 @@
-"""Use the `clikernel` MCP session as the default workspace for Python work: reading and changing files, notebook work, trying things out, checking how a library behaves, and reshaping data. One session stays open, so imports and variables carry between calls. Read this before writing, running, or debugging Python code in a session with `clikernel` connected.
-
-Prefer it to one-off scripts (`python -c`, shell heredocs), and in-kernel pyskills to shell equivalents when installed: `rgapi` (`rg()`/`fd()`/`ls()`) for search and listing, `ghapi` for GitHub and local git. Shell stays right for project tests/builds and non-Python tools.
-
-# Kernels
-
-MCP tool descriptions give each tool's parameters and rules; this covers combining them.
-
-`create(kernel="py")` first; its reply reports what startup imported and what to run next: read it before running anything. Kernels this conversation creates stop when it ends; for one that should outlive it, `create(kernel="py", dlgname="work", autoclose=false)` and tell the user its id. That needs a gateway that keeps running: say so if the reply shows a conversation-started gateway.
-
-To continue earlier work or use the user's solveit kernel: `list_kernels`, then `use_kernel` with the id. Attaching runs no setup and claims no ownership: the live state is the point, and it's never stopped for you.
-
-`restart` re-runs Python startup only in kernels this conversation created; redo everything else. `interrupt` stops a long `exec`, keeping state. If a reply says the kernel is gone, `create` or `use_kernel` before executing again.
-
-Remote gateways (named in `~/.config/clikernel/gateways.toml`): same tools, with `host=` on `list_kernels`/`use_kernel`/`create`; all other rules unchanged. After selecting with a host, plain `exec` runs there until the next selection.
-
-# Luau and APL
-
-`create(kernel="luau")`/`create(kernel="apl")`: same `exec` and autoclose rules; no Python startup or magics. Each `create` reply gives the language basics; Luau's `exec(code="help()")` is its full native API guide (`help("ex.edit_file")` for one function). APL needs `basedpl` in the gateway's environment, which provides the `apl` kernelspec.
-
-# Python
-
-- Magics work as written, incl. `%%bash`. Change directory with `%cd` (expands `~`), not `os.chdir`.
-- clikernel-created Python kernels display every expression result (`ast_node_interactivity='all'`); user startup can override.
-- All cell output lands in the conversation: `len(v)` first, then choose what to show.
-- Don't re-run imports already run. A `NameError` for a name you set up means the kernel restarted or is newly attached: redo setup.
-- After `nbdev-export` or any edit to an imported module, `importlib.reload` it and re-import held names: `from x import y` keeps the old object; a `@patch`ed method refreshes on reload (the patch writes onto the shared class). Restart only when a class you hold instances of was redefined. Check what's loaded by calling it, never with `inspect.getsource` (reads the file on disk).
-- Try the simple import or API call before changing the environment, monkeypatching, or adding setup.
-"""