importpython-markdown 0.1.0__py3-none-any.whl → 0.1.1__py3-none-any.whl

importpython_markdown/__init__.py

@@ -49,8 +49,9 @@ ATTRIBUTE = re.compile(r'([\w-]+)(?:="([^"]*)")?')
 # fail the build, not be silently ignored in every reader's
 # browser.
 TYPES = ("py", "mpy")
-FLAGS = ("terminal", "debug")
-VALUED = ("title", "run-label", "stop-label", "theme", "class", "id")
+FLAGS = ("terminal", "debug", "send-embedder-url")
+VALUED = ("title", "run-label", "stop-label", "theme", "class",
+          "id", "terminal-rows", "terminal-cols")
 
 
 class ExampleError(ValueError):
@@ -106,6 +107,23 @@ def parse_gate(header, line):
         raise ExampleError(
             line, f'cannot parse attributes at "{rest[span:]}"'
         )
+    # The terminal's explicit size: each dimension needs the
+    # terminal it sizes, and only a positive whole number will do
+    # - the same rules the element applies, failing the build
+    # here instead of a reader's browser there.
+    for name in ("terminal-rows", "terminal-cols"):
+        if name in attributes:
+            if "terminal" not in attributes:
+                raise ExampleError(
+                    line, f"{name} requires the terminal flag"
+                )
+            value = attributes[name]
+            if not (value.isdigit() and int(value) >= 1):
+                raise ExampleError(
+                    line,
+                    f'{name} is "{value}"; use a positive whole '
+                    "number",
+                )
     return attributes
 
 
@@ -173,7 +191,7 @@ def split_example(lines, first_line):
     return pieces
 
 
-def validate(pieces, line):
+def validate(pieces, attributes, line):
     """
     The element's own rules, applied at build time: exactly one
     program, no duplicate filenames, at most one config (as valid
@@ -201,12 +219,37 @@ def validate(pieces, line):
             )
     for piece in [p for p in pieces if p["part"] == "config"]:
         try:
-            json.loads("\n".join(piece["text"]))
+            settings = json.loads("\n".join(piece["text"]))
         except json.JSONDecodeError as error:
             raise ExampleError(
                 piece["line"],
                 f"the config block is not valid JSON: {error}",
             ) from None
+        # send-embedder-url writes importpython.py, so while the
+        # flag is on the name is reserved - here in the author's
+        # own config files too, matching the element's rule.
+        if "send-embedder-url" in attributes:
+            names = (settings.get("files") or {}).values()
+            if any(
+                str(name).removeprefix("./") == "importpython.py"
+                for name in names
+            ):
+                raise ExampleError(
+                    piece["line"],
+                    "the send-embedder-url flag reserves the "
+                    'file "importpython.py"',
+                )
+    if "send-embedder-url" in attributes:
+        for piece in pieces:
+            if (
+                piece["part"] == "file"
+                and piece["title"] == "importpython.py"
+            ):
+                raise ExampleError(
+                    piece["line"],
+                    "the send-embedder-url flag reserves the "
+                    'file "importpython.py"',
+                )
 
 
 class ImportPythonPreprocessor(Preprocessor):
@@ -301,7 +344,7 @@ class ImportPythonPreprocessor(Preprocessor):
         """
         attributes = parse_gate(header, first_line)
         pieces = split_example(lines, first_line + 1)
-        validate(pieces, first_line)
+        validate(pieces, attributes, first_line)
         parts = ["<import-python"]
         for name, value in attributes.items():
             if value is None:
@@ -385,7 +428,7 @@ class ImportPythonExtension(Extension):
     def __init__(self, **kwargs):
         self.config = {
             "script_url": [
-                "https://importpython.org/bfp/test/embed.js",
+                "https://importpython.org/v/test/embed.js",
                 "Where embed.js is served from; point this at "
                 "your own copy to use one.",
             ],

{importpython_markdown-0.1.0.dist-info → importpython_markdown-0.1.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: importpython-markdown
-Version: 0.1.0
+Version: 0.1.1
 Summary: Runnable Python examples in Markdown, via importpython.org.
 Author-email: "Nicholas H.Tollervey" <ntoll@ntoll.org>
 License: MIT
@@ -43,9 +43,11 @@ reader presses Run. Plain fences are the program; a fence with
 `title="name.py"` is a file delivered beside it; `config` and
 `body` fences carry BFP settings and page markup (escaped for
 you). The `py` and `mpy` types choose Pyodide or MicroPython,
-and `terminal`, `debug`, `title="..."`, `run-label="..."`,
-`stop-label="..."`, `theme="..."`, `class` and `id` pass through
-to the element.
+and `terminal`, `debug`, `send-embedder-url`, `title="..."`,
+`run-label="..."`, `stop-label="..."`, `theme="..."`,
+`terminal-rows="..."`, `terminal-cols="..."`, `class` and `id`
+pass through to the element - each documented at
+[importpython.org](https://importpython.org/docs/writing-markdown/).
 
 Install and enable:
 

importpython_markdown-0.1.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+importpython_markdown/__init__.py,sha256=Un8CqZvwxhC8YT21jS2LxZM4_qOaVtczn0wM_kSqfUE,17832
+importpython_markdown-0.1.1.dist-info/licenses/LICENSE,sha256=ksfiPPZ3bBB4_KgmDo6-NLda44B_-onAZ3JLVxYSIVg,1077
+importpython_markdown-0.1.1.dist-info/METADATA,sha256=1S3ya5P9DRheIA2oMrBS3JXZYWCFws7WbHr8T1vXQCE,2335
+importpython_markdown-0.1.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+importpython_markdown-0.1.1.dist-info/entry_points.txt,sha256=0Fo68SFJa3rmdmuysJyRTCu35rve3xGdegmhOutPs18,81
+importpython_markdown-0.1.1.dist-info/top_level.txt,sha256=gZT7U42MZK8PK1UxWpt0IGHGv8ynHvdYlxn-OjZRQ-0,22
+importpython_markdown-0.1.1.dist-info/RECORD,,

importpython_markdown-0.1.0.dist-info/RECORD

@@ -1,7 +0,0 @@
-importpython_markdown/__init__.py,sha256=hT7LSHnfozBbaNInQD6vsTC5dO4EcKRV9KY2zLBjyw8,15955
-importpython_markdown-0.1.0.dist-info/licenses/LICENSE,sha256=ksfiPPZ3bBB4_KgmDo6-NLda44B_-onAZ3JLVxYSIVg,1077
-importpython_markdown-0.1.0.dist-info/METADATA,sha256=uzuRuKzAGStQHOnMMAKbp6G4iayeKl8SzOJLDpqt8Rk,2179
-importpython_markdown-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-importpython_markdown-0.1.0.dist-info/entry_points.txt,sha256=0Fo68SFJa3rmdmuysJyRTCu35rve3xGdegmhOutPs18,81
-importpython_markdown-0.1.0.dist-info/top_level.txt,sha256=gZT7U42MZK8PK1UxWpt0IGHGv8ynHvdYlxn-OjZRQ-0,22
-importpython_markdown-0.1.0.dist-info/RECORD,,