python-fragments 0.28__tar.gz → 0.29__tar.gz

python_fragments-0.29/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 The Running Algorithm
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

python_fragments-0.29/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: python-fragments
+Version: 0.29
+Summary: Modern HTML template rendering in Python
+Author-email: The Running Algorithm <services@therunningalgorithm.info>
+License: MIT License
+        
+        Copyright (c) 2026 The Running Algorithm
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: lsp
+Requires-Dist: basedpyright>=1.39.0; extra == "lsp"
+Requires-Dist: lsprotocol>=2025.0.0; extra == "lsp"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.4.1; extra == "dev"
+Dynamic: license-file
+
+# Python Fragments
+
+> **This package is in early development and not yet stable. The API may change without notice between releases.**
+
+Modern HTML template rendering in Python — no build step, no template files, and native HTML awareness out of the box.
+
+```python
+from fragments import loader  # isort: skip
+
+from fastapi import FastAPI
+from fastapi.responses import HTMLResponse
+from components import Layout, PostCard
+
+app = FastAPI()
+
+POSTS = [...]
+
+@app.get("/", response_class=HTMLResponse)
+async def index() -> str:
+    published = [p for p in POSTS if p.published]
+    return <>
+        <Layout title="My Blog">
+            <h1>Latest Posts</h1>
+            <PostCard for={{ post in published }} post={{ post }} />
+        </Layout>
+    </>
+```
+
+## IDE Support
+
+Type checking, completions, hover docs, go-to-definition, rename, and semantic highlighting — all working inside fragment syntax.
+
+![VS Code completions demo](docs/assets/vscode.gif)
+
+## Installation
+
+```bash
+pip install python-fragments
+```
+
+Register the loader at your application's entry point, before importing any modules that contain fragments:
+
+```python
+from fragments import loader  # isort: skip
+```
+
+Any `.py` file containing `<>` is transpiled automatically. Nothing else to configure.
+
+## Feedback and feature requests
+
+Bug reports and feature requests are welcome via [GitHub Issues](https://github.com/TheRunningAlgorithm2/python-fragments/issues). The project is not currently accepting code contributions.

{python_fragments-0.28 → python_fragments-0.29}/README.md

@@ -2,7 +2,7 @@
 
 > **This package is in early development and not yet stable. The API may change without notice between releases.**
 
-Production-ready, modern HTML template rendering in Python — no build step, no template files, and native HTML awareness out of the box.
+Modern HTML template rendering in Python — no build step, no template files, and native HTML awareness out of the box.
 
 ```python
 from fragments import loader  # isort: skip
@@ -26,6 +26,12 @@ async def index() -> str:
     </>
 ```
 
+## IDE Support
+
+Type checking, completions, hover docs, go-to-definition, rename, and semantic highlighting — all working inside fragment syntax.
+
+![VS Code completions demo](docs/assets/vscode.gif)
+
 ## Installation
 
 ```bash
@@ -39,3 +45,7 @@ from fragments import loader  # isort: skip
 ```
 
 Any `.py` file containing `<>` is transpiled automatically. Nothing else to configure.
+
+## Feedback and feature requests
+
+Bug reports and feature requests are welcome via [GitHub Issues](https://github.com/TheRunningAlgorithm2/python-fragments/issues). The project is not currently accepting code contributions.

{python_fragments-0.28 → python_fragments-0.29}/fragments/ast_nodes.py

@@ -1,7 +1,7 @@
 from dataclasses import dataclass, field
 from typing import Sequence
 
-type ASTHTMLChild = ASTHTMLElement | ASTHTMLComment | ASTHTMLText | ASTInterpolation | ASTComponent | ASTControlNode
+type ASTHTMLChild = ASTHTMLElement | ASTHTMLComment | ASTHTMLText | ASTInterpolation | ASTComponent | ASTControlNode | ASTDoctype
 
 
 @dataclass(slots=True)
@@ -392,6 +392,27 @@ class ASTComponentArgument:
         return None
 
 
+@dataclass(slots=True)
+class ASTDoctype:
+    source_start: int = field(compare=False)
+    source_end: int = field(compare=False)
+
+    transpiled_content: str = field(init=False)
+    transpiled_start: int = field(init=False)
+    transpiled_end: int = field(init=False)
+
+    def transpile(self, transpiled_start: int) -> None:
+        self.transpiled_start = transpiled_start
+        self.transpiled_content = '"<!DOCTYPE html>"'
+        self.transpiled_end = self.transpiled_start + len(self.transpiled_content)
+
+    def map_offset(self, offset: int) -> None:
+        return None
+
+    def unmap_offset(self, offset: int) -> None:
+        return None
+
+
 @dataclass(slots=True)
 class ASTHTMLComment:
     source_start: int = field(compare=False)

{python_fragments-0.28 → python_fragments-0.29}/fragments/grammar.py

@@ -6,6 +6,7 @@ from fragments.ast_nodes import (
     ASTComponentArgument,
     ASTComponentName,
     ASTControlNode,
+    ASTDoctype,
     ASTFragment,
     ASTHTMLAttribute,
     ASTHTMLComment,
@@ -117,6 +118,10 @@ def expect_fragment(source: Source) -> tuple[Source, ASTFragment]:
 
 def expect_child(source: Source) -> tuple[Source, ASTHTMLChild]:
     """Any HTML / functional block that might appear as part of the fragment."""
+    if source.remaining().startswith("<!DOCTYPE html>"):
+        source, doctype = expect_doctype(source)
+        return source, doctype
+
     if source.remaining().startswith("<!--"):
         source, html_comment = expect_html_comment(source)
         return source, html_comment
@@ -192,6 +197,12 @@ def expect_component_name(source: Source) -> tuple[Source, ASTComponentName]:
     return source, ASTComponentName(source_start, source.offset, name)
 
 
+def expect_doctype(source: Source) -> tuple[Source, ASTDoctype]:
+    source_start = source.offset
+    source = expect_string(source, "<!DOCTYPE html>")
+    return source, ASTDoctype(source_start, source.offset)
+
+
 def expect_html_comment(source: Source) -> tuple[Source, ASTHTMLComment]:
     source_start = source.offset
     source = expect_string(source, "<!--")

{python_fragments-0.28 → python_fragments-0.29}/pyproject.toml

@@ -4,11 +4,11 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-fragments"
-version = "0.28"
+version = "0.29"
 description = "Modern HTML template rendering in Python"
 authors = [{ name = "The Running Algorithm", email = "services@therunningalgorithm.info" }]
 readme = "README.md"
-license = { text = "Proprietary" }
+license = { file = "LICENSE" }
 requires-python = ">=3.12"
 dependencies = []
 

python_fragments-0.29/python_fragments.egg-info/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.4
+Name: python-fragments
+Version: 0.29
+Summary: Modern HTML template rendering in Python
+Author-email: The Running Algorithm <services@therunningalgorithm.info>
+License: MIT License
+        
+        Copyright (c) 2026 The Running Algorithm
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: lsp
+Requires-Dist: basedpyright>=1.39.0; extra == "lsp"
+Requires-Dist: lsprotocol>=2025.0.0; extra == "lsp"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.4.1; extra == "dev"
+Dynamic: license-file
+
+# Python Fragments
+
+> **This package is in early development and not yet stable. The API may change without notice between releases.**
+
+Modern HTML template rendering in Python — no build step, no template files, and native HTML awareness out of the box.
+
+```python
+from fragments import loader  # isort: skip
+
+from fastapi import FastAPI
+from fastapi.responses import HTMLResponse
+from components import Layout, PostCard
+
+app = FastAPI()
+
+POSTS = [...]
+
+@app.get("/", response_class=HTMLResponse)
+async def index() -> str:
+    published = [p for p in POSTS if p.published]
+    return <>
+        <Layout title="My Blog">
+            <h1>Latest Posts</h1>
+            <PostCard for={{ post in published }} post={{ post }} />
+        </Layout>
+    </>
+```
+
+## IDE Support
+
+Type checking, completions, hover docs, go-to-definition, rename, and semantic highlighting — all working inside fragment syntax.
+
+![VS Code completions demo](docs/assets/vscode.gif)
+
+## Installation
+
+```bash
+pip install python-fragments
+```
+
+Register the loader at your application's entry point, before importing any modules that contain fragments:
+
+```python
+from fragments import loader  # isort: skip
+```
+
+Any `.py` file containing `<>` is transpiled automatically. Nothing else to configure.
+
+## Feedback and feature requests
+
+Bug reports and feature requests are welcome via [GitHub Issues](https://github.com/TheRunningAlgorithm2/python-fragments/issues). The project is not currently accepting code contributions.

{python_fragments-0.28 → python_fragments-0.29}/python_fragments.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+LICENSE
 README.md
 pyproject.toml
 fragments/__init__.py

{python_fragments-0.28 → python_fragments-0.29}/tests/test_grammar.py

@@ -6,6 +6,7 @@ from fragments.ast_nodes import (
     ASTComponentArgument,
     ASTComponentName,
     ASTControlNode,
+    ASTDoctype,
     ASTFragment,
     ASTHTMLAttribute,
     ASTHTMLComment,
@@ -23,6 +24,47 @@ def _transpiled(fragment: ASTFragment) -> ASTFragment:
     return fragment
 
 
+# ---------------------------------------------------------------------------
+# Doctype
+# ---------------------------------------------------------------------------
+
+
+def test_doctype_standalone():
+    source = Source.from_string("<><!DOCTYPE html></>")
+    source, fragment = grammar.expect_fragment(source)
+    assert source.at_end()
+    assert _transpiled(fragment) == _transpiled(ASTFragment(-1, -1, [
+        ASTDoctype(-1, -1)
+    ]))
+
+
+def test_doctype_transpiles_to_literal_string():
+    source = Source.from_string("<><!DOCTYPE html></>")
+    _, fragment = grammar.expect_fragment(source)
+    fragment.transpile(0)
+    doctype = fragment.children[0]
+    assert isinstance(doctype, ASTDoctype)
+    assert doctype.transpiled_content == '"<!DOCTYPE html>"'
+
+
+def test_doctype_followed_by_element():
+    source = Source.from_string("<><!DOCTYPE html><html></html></>")
+    source, fragment = grammar.expect_fragment(source)
+    assert source.at_end()
+    assert _transpiled(fragment) == _transpiled(ASTFragment(-1, -1, [
+        ASTDoctype(-1, -1),
+        ASTHTMLElement(-1, -1, "html", {}, [], False),
+    ]))
+
+
+def test_doctype_not_confused_with_comment():
+    source = Source.from_string("<><!DOCTYPE html><!-- a note --></>")
+    source, fragment = grammar.expect_fragment(source)
+    assert source.at_end()
+    assert isinstance(fragment.children[0], ASTDoctype)
+    assert isinstance(fragment.children[1], ASTHTMLComment)
+
+
 # ---------------------------------------------------------------------------
 # Comments
 # ---------------------------------------------------------------------------

python_fragments-0.28/PKG-INFO

@@ -1,55 +0,0 @@
-Metadata-Version: 2.4
-Name: python-fragments
-Version: 0.28
-Summary: Modern HTML template rendering in Python
-Author-email: The Running Algorithm <services@therunningalgorithm.info>
-License: Proprietary
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-Provides-Extra: lsp
-Requires-Dist: basedpyright>=1.39.0; extra == "lsp"
-Requires-Dist: lsprotocol>=2025.0.0; extra == "lsp"
-Provides-Extra: dev
-Requires-Dist: pytest>=8.4.1; extra == "dev"
-
-# Python Fragments
-
-> **This package is in early development and not yet stable. The API may change without notice between releases.**
-
-Production-ready, modern HTML template rendering in Python — no build step, no template files, and native HTML awareness out of the box.
-
-```python
-from fragments import loader  # isort: skip
-
-from fastapi import FastAPI
-from fastapi.responses import HTMLResponse
-from components import Layout, PostCard
-
-app = FastAPI()
-
-POSTS = [...]
-
-@app.get("/", response_class=HTMLResponse)
-async def index() -> str:
-    published = [p for p in POSTS if p.published]
-    return <>
-        <Layout title="My Blog">
-            <h1>Latest Posts</h1>
-            <PostCard for={{ post in published }} post={{ post }} />
-        </Layout>
-    </>
-```
-
-## Installation
-
-```bash
-pip install python-fragments
-```
-
-Register the loader at your application's entry point, before importing any modules that contain fragments:
-
-```python
-from fragments import loader  # isort: skip
-```
-
-Any `.py` file containing `<>` is transpiled automatically. Nothing else to configure.

python_fragments-0.28/python_fragments.egg-info/PKG-INFO

@@ -1,55 +0,0 @@
-Metadata-Version: 2.4
-Name: python-fragments
-Version: 0.28
-Summary: Modern HTML template rendering in Python
-Author-email: The Running Algorithm <services@therunningalgorithm.info>
-License: Proprietary
-Requires-Python: >=3.12
-Description-Content-Type: text/markdown
-Provides-Extra: lsp
-Requires-Dist: basedpyright>=1.39.0; extra == "lsp"
-Requires-Dist: lsprotocol>=2025.0.0; extra == "lsp"
-Provides-Extra: dev
-Requires-Dist: pytest>=8.4.1; extra == "dev"
-
-# Python Fragments
-
-> **This package is in early development and not yet stable. The API may change without notice between releases.**
-
-Production-ready, modern HTML template rendering in Python — no build step, no template files, and native HTML awareness out of the box.
-
-```python
-from fragments import loader  # isort: skip
-
-from fastapi import FastAPI
-from fastapi.responses import HTMLResponse
-from components import Layout, PostCard
-
-app = FastAPI()
-
-POSTS = [...]
-
-@app.get("/", response_class=HTMLResponse)
-async def index() -> str:
-    published = [p for p in POSTS if p.published]
-    return <>
-        <Layout title="My Blog">
-            <h1>Latest Posts</h1>
-            <PostCard for={{ post in published }} post={{ post }} />
-        </Layout>
-    </>
-```
-
-## Installation
-
-```bash
-pip install python-fragments
-```
-
-Register the loader at your application's entry point, before importing any modules that contain fragments:
-
-```python
-from fragments import loader  # isort: skip
-```
-
-Any `.py` file containing `<>` is transpiled automatically. Nothing else to configure.