docs: Add playground to docs

Author: kayjan

docs/_static/playground-config.js

@@ -1,5 +1,5 @@
-    var colorNotebook = {
-        "playgroundWheels": ['pygments-2.17.2-py3-none-any.whl', 'bigtree-0.19.0-py3-none-any.whl'],
-        "notebookWheels": [],
-        "defaultPlayground": "print('hello world')"
-    }
+var colorNotebook = {
+    "playgroundWheels": ['pygments-2.17.2-py3-none-any.whl', 'bigtree-0.19.0-py3-none-any.whl'],
+    "notebookWheels": [],
+    "defaultPlayground": ""
+}

docs/_static/playground.js

@@ -2,9 +2,6 @@
 Execute Python code in code blocks (Adapted from ColorAide).
 
 This can be executed in either a Pyodide environment of a normal Python environment.
-3rd party libraries (that are not available directly from Pyodide) are only loaded
-when needed so that Pyodide will have a chance to load them if necessary.
-
 Transform Python code by executing it, transforming to a Python console output,
 and finding and outputting color previews.
 """
@@ -20,8 +17,6 @@
 from pygments.formatters import find_formatter_class
 from pygments.lexers import get_lexer_by_name
 
-from bigtree import *  # noqa
-
 PY310 = (3, 10) <= sys.version_info
 PY311 = (3, 11) <= sys.version_info
 
@@ -63,7 +58,7 @@
 </div>
 <div class="playground-footer" data-search-exclude>
 <hr>
-<button id="__playground-edit_{el_id}" class="playground-edit" title="Edit the current snippet">Edit</button>
+<button id="__playground-edit_{el_id}" class="playground-edit" title="Edit the code snippet">Edit</button>
 <button id="__playground-share_{el_id}" class="playground-share" title="Copy URL to current snippet">Share</button>
 <button id="__playground-run_{el_id}" class="playground-run hidden" title="Run code (Ctrl + Enter)">Run</button>
 <button id="__playground-cancel_{el_id}" class="playground-cancel hidden" title="Cancel edit (Escape)">Cancel</button>

docs/_static/playground.py

@@ -8,14 +8,28 @@
 import urllib.request
 
 # Output files
-OUTPUT_WHL = "docs/playground/"
+OUTPUT_WHL = "docs/_static/"
 OUTPUT_JS = "docs/_static/"
 
 # Build message output
-BUILD_WHL_MESSAGE = f"{OUTPUT_WHL}(.*whl)"
-BUILD_WHL_COMMAND = [sys.executable, "-m", "hatch", "build", OUTPUT_WHL]
+# BUILD_WHL_MESSAGE = f"{OUTPUT_WHL}(.*whl)"
+# BUILD_WHL_COMMAND = [sys.executable, "-m", "hatch", "build", OUTPUT_WHL]
+BUILD_WHL_MESSAGE = r"Successfully built ([-_0-9.a-zA-Z]+?\.whl)"
+BUILD_WHL_COMMAND = [sys.executable, "-m", "build", "--wheel", "-o", OUTPUT_WHL]
 
-DEFAULT_COMMANDS = ["print('hello world')"]
+DEFAULT_COMMANDS = [""]
+
+PLAYGROUND_WHEELS = [
+    "https://files.pythonhosted.org/packages/97/9c/372fef8377a6e340b1704768d20daaded98bf13282b5327beb2e2fe2c7ef/pygments-2.17.2-py3-none-any.whl"
+]
+
+CONFIG = """\
+var colorNotebook = {{
+    "playgroundWheels": {},
+    "notebookWheels": [],
+    "defaultPlayground": "{}"
+}}
+"""
 
 
 def build_package():
@@ -39,7 +53,9 @@ def build_package():
             env=os.environ.copy(),
         )
     out, _ = process.communicate()
-    m = re.compile(BUILD_WHL_MESSAGE).search(out.decode("utf-8"))
+    build_message = out.decode("utf-8")
+    m = re.compile(BUILD_WHL_MESSAGE).search(build_message)
+    print(build_message)
 
     return process.returncode, m.group(1) if m else ""
 
@@ -67,18 +83,6 @@ def download_wheel(url, dest):
 
 if __name__ == "__main__":
 
-    PLAYGROUND_WHEELS = [
-        "https://files.pythonhosted.org/packages/97/9c/372fef8377a6e340b1704768d20daaded98bf13282b5327beb2e2fe2c7ef/pygments-2.17.2-py3-none-any.whl"
-    ]
-
-    CONFIG = """\
-    var colorNotebook = {{
-        "playgroundWheels": {},
-        "notebookWheels": [],
-        "defaultPlayground": "{}"
-    }}
-    """
-
     PLAYGROUND = {}
     for url in PLAYGROUND_WHEELS:
         PLAYGROUND[os.path.join(OUTPUT_WHL, url.split("/")[-1])] = url

docs/_static/playground_whl.py

@@ -0,0 +1,21 @@
+---
+title: Playground
+hide:
+  - navigation
+  - toc
+---
+
+# 🎡️ Playground
+
+```py play
+# from bigtree import dict_to_tree
+
+path_dict = {
+   "a": {"age": 90},
+   "a/b": {"age": 65},
+   "a/c": {"age": 60},
+   "a/b/d": {"age": 40},
+}
+root = dict_to_tree(path_dict)
+root.show()
+```

docs/playground/index.md

@@ -1,4 +1,5 @@
 black>=24.1.0
+build
 IPython
 mdx_truly_sane_lists==1.3
 mkdocs==1.5.3

docs/playground/playground.md

@@ -29,7 +29,7 @@ nav:
     - Resources:
       - gettingstarted/resources/articles.md
   - Playground:
-      - playground/playground.md
+      - playground/index.md
   - Code Documentation:
     - Node:
         - bigtree/node/index.md