codebind 0.4.2__py3-none-any.whl → 0.4.3__py3-none-any.whl

codebind/extension.py

@@ -2,6 +2,9 @@
 
 from __future__ import annotations
 
+import json
+import os
+from pathlib import Path
 from typing import Any
 
 from IPython.core.interactiveshell import InteractiveShell
@@ -14,8 +17,28 @@ from .session import Session
 _NAMESPACE_ATTRIBUTE = "_codebind_extension_namespace"
 
 
+def _models_path() -> Path:
+    configured = os.environ.get("XDG_CONFIG_HOME")
+    if configured:
+        config_home = Path(configured).expanduser()
+        if config_home.is_absolute():
+            return config_home / "codebind" / "models.json"
+    return Path.home() / ".config" / "codebind" / "models.json"
+
+
+def _load_models() -> Models:
+    path = _models_path()
+    if not path.exists():
+        return Models()
+    values = json.loads(path.read_text())
+    if not isinstance(values, dict):
+        raise ValueError(f"Codebind model configuration must be a JSON object: {path}")
+    return Models(values)
+
+
 def load_ipython_extension(ipython: InteractiveShell) -> None:
     """Load Codebind into the active IPython user namespace."""
+    models = _load_models()
     previous = getattr(ipython, _NAMESPACE_ATTRIBUTE, None)
     if isinstance(previous, dict):
         previous_chat = previous.get("chat")
@@ -26,6 +49,7 @@ def load_ipython_extension(ipython: InteractiveShell) -> None:
     namespace: dict[str, Any] = {
         "chat": Session(shell=ipython, bridge=bridge),
         "Models": Models,
+        "models": models,
     }
     ipython.push(namespace)
     setattr(ipython, _NAMESPACE_ATTRIBUTE, namespace)

{codebind-0.4.2.dist-info → codebind-0.4.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codebind
-Version: 0.4.2
+Version: 0.4.3
 Summary: A frontend-neutral model loop for persistent IPython sessions.
 Keywords: ai,ipython,llm,repl,agents
 Author: Giovanni Gravili
@@ -47,11 +47,9 @@ After installation, start ordinary IPython with the Codebind extension from any
 codebind
 ```
 
-It opens standard IPython with `chat` and `Models` in the user namespace. All normal IPython command-line options remain available.
+It opens standard IPython with `chat`, `models`, and `Models` in the user namespace. `models` loads provider values from `$XDG_CONFIG_HOME/codebind/models.json`, or `~/.config/codebind/models.json` when `XDG_CONFIG_HOME` is unset. Keep that credential file readable only by its owner. All normal IPython command-line options remain available.
 
 ```python
-models = Models({"openai": "OPENAI_API_KEY"})
-
 chat.send(
     "Inspect this project and tell me what to implement first.",
     models.chat("openai/gpt-5", reasoning_effort="medium"),
@@ -65,7 +63,7 @@ Codebind does not load files or construct a project prompt automatically. The us
 Start JupyterLab with Codebind from any directory without a permanent installation:
 
 ```console
-uvx --from jupyterlab --with codebind jupyter lab
+uvx --from jupyterlab --with codebind --with 'nbconvert[webpdf]' jupyter lab
 ```
 
 Or install both packages into the same environment, then start JupyterLab normally:
@@ -84,7 +82,6 @@ Load Codebind in a notebook:
 Run that cell once so JupyterLab can connect to the extension, then use Codebind in later cells:
 
 ```python
-models = Models({"openai": "OPENAI_API_KEY"})
 model = models.chat("openai/gpt-5")
 await chat.asend("Inspect the current notebook state.", model)
 ```
@@ -111,6 +108,6 @@ chat.send(
 )
 ```
 
-The authorization remains in memory for this session. Persistent credential storage belongs to the host application.
+The authorization remains in memory for this session. Save provider values as a JSON object in Codebind's XDG configuration file and reload the extension to expose them through `models`.
 
 OpenAI officially supports ChatGPT subscription sign-in for Codex clients. Models Provider reproduces that account-access boundary for this library; it is separate from the public, pay-as-you-go OpenAI API and may require compatibility updates when the Codex account protocol changes.

{codebind-0.4.2.dist-info → codebind-0.4.3.dist-info}/RECORD

@@ -2,18 +2,18 @@ codebind/__init__.py,sha256=GNO_K5EPAdgiK2CWsPVVY-3bAmH2TnFJ9ReAWgSbnqM,514
 codebind/cli.py,sha256=9LOR1L3P8sPsOOgsnpbOsA1PNUZdAj1Z9ROFKeo3EV8,423
 codebind/display.py,sha256=IpxcElyNcr5olRIatEduN_d-sRwpsMlaq1UtrOXocQA,494
 codebind/execution.py,sha256=b1U0iT0e9fDpvGZclGGihod_iLFjJ7wLUkXhmawgeRs,11968
-codebind/extension.py,sha256=elIDW_zl5o3uyil1tEnJ0A5jVkADalqPWI_qcDw4xhY,1460
+codebind/extension.py,sha256=xzdBpUtQnjJVqCivuW3uruTURrkKhMnY_YsHFHl53IQ,2176
 codebind/jupyter.py,sha256=xuoiV2-pqtcb_dWXvaaVrlSvqcYfqRYtbX4B-Zh_pBA,3272
 codebind/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 codebind/session.py,sha256=6KK2d55XsKaq5IVRQmUp5Pzdg-O76bAZvCYgxBU2BN0,7455
-codebind-0.4.2.dist-info/licenses/LICENSE,sha256=ujX46e0LFBIBTnCDY0u3Q7LV363B7CiI7QJZxIkEXlk,1073
-codebind-0.4.2.data/data/share/jupyter/labextensions/codebind-jupyterlab/install.json,sha256=78rEThkfrk1pXtekX5WrG9_Y0lJYi5XBEm8n9athpFE,164
-codebind-0.4.2.data/data/share/jupyter/labextensions/codebind-jupyterlab/package.json,sha256=HYr80rRV4byoPUvhf5r9swwnssr7eGxIay227Cusyqo,1152
-codebind-0.4.2.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/590.6544266cd73a003b.js,sha256=zrQdGY0320_MGN8KRf8dzMXCjXI_6jtZoAnW4UhDquo,2771
-codebind-0.4.2.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/remoteEntry.6f017385dfc989f1.js,sha256=Cwm6yVfy68shv0OTb6yIbHwV5FxozSz-jO9gf9WE0vc,11087
-codebind-0.4.2.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/style.js,sha256=Opy15wyuR_ABqsrk-cOcOj2yZtvtq0r36aDkErnloD0,113
-codebind-0.4.2.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/third-party-licenses.json,sha256=MNToQfru1YnHAie-2Virp23yWsc5co3qG0IzrO6SEfw,20
-codebind-0.4.2.dist-info/WHEEL,sha256=R1d3uUTbmXM1FHXH_itQashbrqrOSVj-hvBCpmkIIGE,81
-codebind-0.4.2.dist-info/entry_points.txt,sha256=GiPcU63sULDlywJSKigAS4M3vaziYIrubXOb3fAg2_c,48
-codebind-0.4.2.dist-info/METADATA,sha256=oWEAHVAAIlHYBAE_kcRViMyLALj56VMMxIWdD5PF_Ys,4062
-codebind-0.4.2.dist-info/RECORD,,
+codebind-0.4.3.dist-info/licenses/LICENSE,sha256=ujX46e0LFBIBTnCDY0u3Q7LV363B7CiI7QJZxIkEXlk,1073
+codebind-0.4.3.data/data/share/jupyter/labextensions/codebind-jupyterlab/install.json,sha256=78rEThkfrk1pXtekX5WrG9_Y0lJYi5XBEm8n9athpFE,164
+codebind-0.4.3.data/data/share/jupyter/labextensions/codebind-jupyterlab/package.json,sha256=HYr80rRV4byoPUvhf5r9swwnssr7eGxIay227Cusyqo,1152
+codebind-0.4.3.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/590.6544266cd73a003b.js,sha256=zrQdGY0320_MGN8KRf8dzMXCjXI_6jtZoAnW4UhDquo,2771
+codebind-0.4.3.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/remoteEntry.6f017385dfc989f1.js,sha256=Cwm6yVfy68shv0OTb6yIbHwV5FxozSz-jO9gf9WE0vc,11087
+codebind-0.4.3.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/style.js,sha256=Opy15wyuR_ABqsrk-cOcOj2yZtvtq0r36aDkErnloD0,113
+codebind-0.4.3.data/data/share/jupyter/labextensions/codebind-jupyterlab/static/third-party-licenses.json,sha256=MNToQfru1YnHAie-2Virp23yWsc5co3qG0IzrO6SEfw,20
+codebind-0.4.3.dist-info/WHEEL,sha256=R1d3uUTbmXM1FHXH_itQashbrqrOSVj-hvBCpmkIIGE,81
+codebind-0.4.3.dist-info/entry_points.txt,sha256=GiPcU63sULDlywJSKigAS4M3vaziYIrubXOb3fAg2_c,48
+codebind-0.4.3.dist-info/METADATA,sha256=fc0mvklMLUXzsIUZLuAaLJP10eI4HnWu-pCa94enbEE,4277
+codebind-0.4.3.dist-info/RECORD,,