fixes #19

Author: jph00

dialoghelper/_modidx.py

@@ -8,6 +8,7 @@
   'syms': { 'dialoghelper.core': { 'dialoghelper.core._add_msg_unsafe': ('core.html#_add_msg_unsafe', 'dialoghelper/core.py'),
                                    'dialoghelper.core._msg': ('core.html#_msg', 'dialoghelper/core.py'),
                                    'dialoghelper.core._umsg': ('core.html#_umsg', 'dialoghelper/core.py'),
+                                   'dialoghelper.core.add_html': ('core.html#add_html', 'dialoghelper/core.py'),
                                    'dialoghelper.core.add_msg': ('core.html#add_msg', 'dialoghelper/core.py'),
                                    'dialoghelper.core.del_msg': ('core.html#del_msg', 'dialoghelper/core.py'),
                                    'dialoghelper.core.export_dialog': ('core.html#export_dialog', 'dialoghelper/core.py'),

dialoghelper/core.py

@@ -2,15 +2,16 @@
 
 # %% auto 0
 __all__ = ['Placements', 'empty', 'get_db', 'find_var', 'find_dialog_id', 'find_msgs', 'find_msg_id', 'read_msg_ids', 'msg_idx',
-           'read_msg', 'del_msg', 'add_msg', 'update_msg', 'load_gist', 'gist_file', 'import_string', 'is_usable_tool',
-           'mk_toollist', 'import_gist', 'export_dialog', 'import_dialog', 'tool_info', 'asdict']
+           'read_msg', 'add_html', 'del_msg', 'add_msg', 'update_msg', 'load_gist', 'gist_file', 'import_string',
+           'is_usable_tool', 'mk_toollist', 'import_gist', 'export_dialog', 'import_dialog', 'tool_info', 'asdict']
 
 # %% ../nbs/00_core.ipynb
 import json, importlib, linecache
 from typing import Dict
 from tempfile import TemporaryDirectory
 from ipykernel_helper import *
 from dataclasses import dataclass
+from fastcore.xml import to_xml
 
 from fastcore.utils import *
 from fastcore.meta import delegates
@@ -98,6 +99,14 @@ def read_msg(n:int=-1,     # Message index (if relative, +ve is downwards)
     db = get_db()
     return db.t.message.selectone('sid=?', [ids[idx]])
 
+# %% ../nbs/00_core.ipynb
+def add_html(
+    content:str, # The HTML to send to the client (generally should include hx-swap-oob)
+):
+    "Send HTML to the browser to be swapped into the DOM"
+    res = to_xml(content)
+    xpost('http://localhost:5001/add_html_', data=dict(content=res))
+
 # %% ../nbs/00_core.ipynb
 def del_msg(
     sid:str=None, # sid (stable id -- pk) of message that placement is relative to (if None, uses current message)
@@ -280,6 +289,7 @@ def import_dialog(fname, add_header=True):
 def tool_info():
     cts='''Tools available from `dialoghelper`:
 
+- &`add_html`: Send HTML to the browser to be swapped into the DOM using hx-swap-oob.
 - &`find_dialog_id`: Get the current dialog id.
 - &`find_msg_id`: Get the current message id.
 - &`find_msgs`: Find messages in current specific dialog that contain the given information.

nbs/00_core.ipynb

@@ -28,6 +28,7 @@
     "from tempfile import TemporaryDirectory\n",
     "from ipykernel_helper import *\n",
     "from dataclasses import dataclass\n",
+    "from fastcore.xml import to_xml\n",
     "\n",
     "from fastcore.utils import *\n",
     "from fastcore.meta import delegates\n",
@@ -389,6 +390,21 @@
     "read_msg(-1, relative=False)"
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "#| export\n",
+    "def add_html(\n",
+    "    content:str, # The HTML to send to the client (generally should include hx-swap-oob)\n",
+    "):\n",
+    "    \"Send HTML to the browser to be swapped into the DOM\"\n",
+    "    res = to_xml(content)\n",
+    "    xpost('http://localhost:5001/add_html_', data=dict(content=res))"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
@@ -1070,6 +1086,7 @@
     "def tool_info():\n",
     "    cts='''Tools available from `dialoghelper`:\n",
     "\n",
+    "- &`add_html`: Send HTML to the browser to be swapped into the DOM using hx-swap-oob.\n",
     "- &`find_dialog_id`: Get the current dialog id.\n",
     "- &`find_msg_id`: Get the current message id.\n",
     "- &`find_msgs`: Find messages in current specific dialog that contain the given information.\n",