python-fragments 0.33__tar.gz → 0.36__tar.gz

python_fragments-0.36/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: python-fragments
+Version: 0.36
+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.
+        
+Project-URL: Homepage, https://python-fragments.io
+Project-URL: Documentation, https://python-fragments.io
+Project-URL: Source, https://github.com/TheRunningAlgorithm2/python-fragments
+Project-URL: Issues, https://github.com/TheRunningAlgorithm2/python-fragments/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup :: HTML
+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
+
+<p align="center">
+  <img src="logo.svg" alt="Python Fragments" width="300" />
+</p>
+
+<p align="center">
+  <a href="https://github.com/TheRunningAlgorithm2/python-fragments/actions/workflows/test.yml"><img src="https://github.com/TheRunningAlgorithm2/python-fragments/actions/workflows/test.yml/badge.svg" alt="Tests" /></a>
+  <a href="https://pypi.org/project/python-fragments/"><img src="https://img.shields.io/pypi/v/python-fragments" alt="PyPI version" /></a>
+  <a href="https://pypi.org/project/python-fragments/"><img src="https://img.shields.io/pypi/pyversions/python-fragments" alt="Python versions" /></a>
+  <a href="https://github.com/TheRunningAlgorithm2/python-fragments/blob/main/LICENSE"><img src="https://img.shields.io/github/license/TheRunningAlgorithm2/python-fragments" alt="License" /></a>
+  <a href="https://python-fragments.io"><img src="https://img.shields.io/badge/docs-python--fragments.io-blue" alt="Documentation" /></a>
+  <a href="https://marketplace.visualstudio.com/items?itemName=tra-technologies-ltd.python-fragments"><img src="https://img.shields.io/badge/VS%20Code-Extension-blue?logo=visualstudiocode" alt="VS Code Extension" /></a>
+</p>
+
+> **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. [Read More](https://python-fragments.io)
+
+```python
+from fastapi import APIRouter
+
+router = APIRouter()
+
+@router.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.
+
+Install the [Python Fragments VS Code extension](https://marketplace.visualstudio.com/items?itemName=tra-technologies-ltd.python-fragments) to get started.
+
+![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.
+
+## Documentation
+
+Full documentation is available at [python-fragments.io](https://python-fragments.io).
+
+## Contributing
+
+Bug reports, feature requests, and documentation improvements are all welcome. Code contributions aren't open yet while we work toward v1. See [CONTRIBUTING.md](CONTRIBUTING.md) for details.

python_fragments-0.36/README.md

@@ -0,0 +1,62 @@
+<p align="center">
+  <img src="logo.svg" alt="Python Fragments" width="300" />
+</p>
+
+<p align="center">
+  <a href="https://github.com/TheRunningAlgorithm2/python-fragments/actions/workflows/test.yml"><img src="https://github.com/TheRunningAlgorithm2/python-fragments/actions/workflows/test.yml/badge.svg" alt="Tests" /></a>
+  <a href="https://pypi.org/project/python-fragments/"><img src="https://img.shields.io/pypi/v/python-fragments" alt="PyPI version" /></a>
+  <a href="https://pypi.org/project/python-fragments/"><img src="https://img.shields.io/pypi/pyversions/python-fragments" alt="Python versions" /></a>
+  <a href="https://github.com/TheRunningAlgorithm2/python-fragments/blob/main/LICENSE"><img src="https://img.shields.io/github/license/TheRunningAlgorithm2/python-fragments" alt="License" /></a>
+  <a href="https://python-fragments.io"><img src="https://img.shields.io/badge/docs-python--fragments.io-blue" alt="Documentation" /></a>
+  <a href="https://marketplace.visualstudio.com/items?itemName=tra-technologies-ltd.python-fragments"><img src="https://img.shields.io/badge/VS%20Code-Extension-blue?logo=visualstudiocode" alt="VS Code Extension" /></a>
+</p>
+
+> **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. [Read More](https://python-fragments.io)
+
+```python
+from fastapi import APIRouter
+
+router = APIRouter()
+
+@router.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.
+
+Install the [Python Fragments VS Code extension](https://marketplace.visualstudio.com/items?itemName=tra-technologies-ltd.python-fragments) to get started.
+
+![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.
+
+## Documentation
+
+Full documentation is available at [python-fragments.io](https://python-fragments.io).
+
+## Contributing
+
+Bug reports, feature requests, and documentation improvements are all welcome. Code contributions aren't open yet while we work toward v1. See [CONTRIBUTING.md](CONTRIBUTING.md) for details.

{python_fragments-0.33 → python_fragments-0.36}/fragments/ast_nodes.py

@@ -253,6 +253,7 @@ class ASTComponent:
     name: "ASTComponentName"
     arguments: dict[str, "ASTComponentArgument"]
     children: Sequence["ASTHTMLChild"]
+    self_closing: bool
 
     transpiled_content: str = field(init=False)
     transpiled_start: int = field(init=False)
@@ -263,13 +264,14 @@ class ASTComponent:
     def transpile(self, transpiled_start: int) -> None:
         self.transpiled_start = transpiled_start
         self.name.transpile(self.transpiled_start)
-        self.transpiled_content = self.name.transpiled_content + '(""'
-
-        for child in self.children:
-            child.transpile(self.transpiled_start + len(self.transpiled_content))
-            self.transpiled_content += "+" + child.transpiled_content
-
-        self.transpiled_content += ","
+        self.transpiled_content = self.name.transpiled_content + "("
+
+        if not self.self_closing:
+            self.transpiled_content += 'children=""'
+            for child in self.children:
+                child.transpile(self.transpiled_start + len(self.transpiled_content))
+                self.transpiled_content += "+" + child.transpiled_content
+            self.transpiled_content += ","
 
         for argument in self.arguments.values():
             argument.transpile(self.transpiled_start + len(self.transpiled_content))

{python_fragments-0.33 → python_fragments-0.36}/fragments/grammar.py

@@ -180,7 +180,7 @@ def expect_component(source: Source) -> tuple[Source, ASTComponent | ASTControlN
     if source.starts_with("/>"):
         source = expect_string(source, "/>")
         return source, ASTControlNode[ASTComponent].wrap_child(
-            ASTComponent(source_start, source.offset, name, arguments, []),
+            ASTComponent(source_start, source.offset, name, arguments, [], self_closing=True),
             if_argument.interpolation if if_argument is not None else None,
             for_argument.interpolation if for_argument is not None else None,
         )
@@ -196,7 +196,7 @@ def expect_component(source: Source) -> tuple[Source, ASTComponent | ASTControlN
         raise ParsingError(f"Element closed ({closing_name.name}) is not the same as currently opened element ({name.name})", source.offset)
 
     return source, ASTControlNode[ASTComponent].wrap_child(
-        ASTComponent(source_start=source_start, source_end=source.offset, name=name, arguments=arguments, children=children),
+        ASTComponent(source_start=source_start, source_end=source.offset, name=name, arguments=arguments, children=children, self_closing=False),
         if_argument.interpolation if if_argument is not None else None,
         for_argument.interpolation if for_argument is not None else None,
     )

{python_fragments-0.33 → python_fragments-0.36}/fragments/html/elements.py

@@ -21,12 +21,12 @@ def attribute_to_string(name: str, value: Any) -> str:
         return style_to_string(value)
 
     if isinstance(value, dict) or isinstance(value, list):
-        value = html.escape(json.dumps(value))
+        value = json.dumps(value)
 
     if isinstance(value, bool):
         value = str(value).lower()
 
-    return f'{name}="{value}"'
+    return f'{name}="{html.escape(str(value))}"'
 
 
 def className_to_string(contents: list[str] | str) -> str:

{python_fragments-0.33 → python_fragments-0.36}/pyproject.toml

@@ -4,13 +4,30 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-fragments"
-version = "0.33"
+version = "0.36"
 description = "Modern HTML template rendering in Python"
 authors = [{ name = "The Running Algorithm", email = "services@therunningalgorithm.info" }]
 readme = "README.md"
 license = { file = "LICENSE" }
 requires-python = ">=3.12"
 dependencies = []
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Text Processing :: Markup :: HTML",
+]
+
+[project.urls]
+Homepage = "https://python-fragments.io"
+Documentation = "https://python-fragments.io"
+Source = "https://github.com/TheRunningAlgorithm2/python-fragments"
+Issues = "https://github.com/TheRunningAlgorithm2/python-fragments/issues"
 
 [project.optional-dependencies]
 lsp = [

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

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: python-fragments
+Version: 0.36
+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.
+        
+Project-URL: Homepage, https://python-fragments.io
+Project-URL: Documentation, https://python-fragments.io
+Project-URL: Source, https://github.com/TheRunningAlgorithm2/python-fragments
+Project-URL: Issues, https://github.com/TheRunningAlgorithm2/python-fragments/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Markup :: HTML
+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
+
+<p align="center">
+  <img src="logo.svg" alt="Python Fragments" width="300" />
+</p>
+
+<p align="center">
+  <a href="https://github.com/TheRunningAlgorithm2/python-fragments/actions/workflows/test.yml"><img src="https://github.com/TheRunningAlgorithm2/python-fragments/actions/workflows/test.yml/badge.svg" alt="Tests" /></a>
+  <a href="https://pypi.org/project/python-fragments/"><img src="https://img.shields.io/pypi/v/python-fragments" alt="PyPI version" /></a>
+  <a href="https://pypi.org/project/python-fragments/"><img src="https://img.shields.io/pypi/pyversions/python-fragments" alt="Python versions" /></a>
+  <a href="https://github.com/TheRunningAlgorithm2/python-fragments/blob/main/LICENSE"><img src="https://img.shields.io/github/license/TheRunningAlgorithm2/python-fragments" alt="License" /></a>
+  <a href="https://python-fragments.io"><img src="https://img.shields.io/badge/docs-python--fragments.io-blue" alt="Documentation" /></a>
+  <a href="https://marketplace.visualstudio.com/items?itemName=tra-technologies-ltd.python-fragments"><img src="https://img.shields.io/badge/VS%20Code-Extension-blue?logo=visualstudiocode" alt="VS Code Extension" /></a>
+</p>
+
+> **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. [Read More](https://python-fragments.io)
+
+```python
+from fastapi import APIRouter
+
+router = APIRouter()
+
+@router.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.
+
+Install the [Python Fragments VS Code extension](https://marketplace.visualstudio.com/items?itemName=tra-technologies-ltd.python-fragments) to get started.
+
+![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.
+
+## Documentation
+
+Full documentation is available at [python-fragments.io](https://python-fragments.io).
+
+## Contributing
+
+Bug reports, feature requests, and documentation improvements are all welcome. Code contributions aren't open yet while we work toward v1. See [CONTRIBUTING.md](CONTRIBUTING.md) for details.

{python_fragments-0.33 → python_fragments-0.36}/tests/test_end_to_end.py

@@ -127,14 +127,22 @@ def test_for_loop_empty():
 # ---------------------------------------------------------------------------
 
 
-def test_component_no_children():
-    def Badge(children: str, label: str) -> str:
+def test_void_component():
+    def Badge(label: str) -> str:
         return f"<span>{label}</span>"
 
     result = render('<><Badge label="hi" /></>', Badge=Badge)
     assert result == "<span>hi</span>"
 
 
+def test_component_no_children():
+    def Badge(children: str, label: str) -> str:
+        return f"<h1>{label}</h1><span>{children}</span>"
+
+    result = render('<><Badge label="hi"></Badge></>', Badge=Badge)
+    assert result == "<h1>hi</h1><span></span>"
+
+
 def test_component_with_children():
     from fragments.types import Children
 

{python_fragments-0.33 → python_fragments-0.36}/tests/test_grammar.py

@@ -263,7 +263,7 @@ def test_component_self_closing():
     source, fragment = grammar.expect_fragment(source)
     assert source.at_end()
     assert _transpiled(fragment) == _transpiled(ASTFragment(-1, -1, [
-        ASTComponent(-1, -1, ASTComponentName(-1, -1, "MyComp"), {}, [])
+        ASTComponent(-1, -1, ASTComponentName(-1, -1, "MyComp"), {}, [], self_closing=True)
     ]))
 
 
@@ -274,7 +274,7 @@ def test_component_with_double_quote_argument():
     assert _transpiled(fragment) == _transpiled(ASTFragment(-1, -1, [
         ASTComponent(-1, -1, ASTComponentName(-1, -1, "MyComp"), {
             "name": ASTComponentArgument(-1, -1, "name", '"hello"', None)
-        }, [])
+        }, [], self_closing=True)
     ]))
 
 
@@ -285,7 +285,7 @@ def test_component_with_single_quote_argument():
     assert _transpiled(fragment) == _transpiled(ASTFragment(-1, -1, [
         ASTComponent(-1, -1, ASTComponentName(-1, -1, "MyComp"), {
             "name": ASTComponentArgument(-1, -1, "name", "'hello'", None)
-        }, [])
+        }, [], self_closing=True)
     ]))
 
 
@@ -296,7 +296,7 @@ def test_component_with_interpolation_argument():
     assert _transpiled(fragment) == _transpiled(ASTFragment(-1, -1, [
         ASTComponent(-1, -1, ASTComponentName(-1, -1, "MyComp"), {
             "value": ASTComponentArgument(-1, -1, "value", None, ASTInterpolation(-1, -1, "expr", 1, 1))
-        }, [])
+        }, [], self_closing=True)
     ]))
 
 
@@ -307,7 +307,7 @@ def test_component_with_children():
     assert _transpiled(fragment) == _transpiled(ASTFragment(-1, -1, [
         ASTComponent(-1, -1, ASTComponentName(-1, -1, "MyComp"), {}, [
             ASTHTMLElement(-1, -1, "p", {}, [ASTHTMLText(-1, -1, "text")], False)
-        ])
+        ], self_closing=False)
     ]))
 
 
@@ -318,7 +318,7 @@ def test_component_whitespace_stripped_from_children():
     assert _transpiled(fragment) == _transpiled(ASTFragment(-1, -1, [
         ASTComponent(-1, -1, ASTComponentName(-1, -1, "MyComp"), {}, [
             ASTHTMLElement(-1, -1, "p", {}, [ASTHTMLText(-1, -1, "text")], False)
-        ])
+        ], self_closing=False)
     ]))
 
 
@@ -330,7 +330,7 @@ def test_component_with_if():
         ASTControlNode(-1, -1,
             ASTInterpolation(-1, -1, "condition", 1, 1),
             None,
-            ASTComponent(-1, -1, ASTComponentName(-1, -1, "MyComp"), {}, []),
+            ASTComponent(-1, -1, ASTComponentName(-1, -1, "MyComp"), {}, [], self_closing=True),
         )
     ]))
 
@@ -343,7 +343,7 @@ def test_component_with_for():
         ASTControlNode(-1, -1,
             None,
             ASTInterpolation(-1, -1, "item in items", 1, 1),
-            ASTComponent(-1, -1, ASTComponentName(-1, -1, "MyComp"), {}, []),
+            ASTComponent(-1, -1, ASTComponentName(-1, -1, "MyComp"), {}, [], self_closing=True),
         )
     ]))
 
@@ -482,7 +482,7 @@ def test_interpolation_no_trailing_whitespace():
     assert _transpiled(fragment) == _transpiled(ASTFragment(-1, -1, [
         ASTComponent(-1, -1, ASTComponentName(-1, -1, "NotificationBar"), {
             "user": ASTComponentArgument(-1, -1, "user", None, ASTInterpolation(-1, -1, "user", 1, 0))
-        }, [])
+        }, [], self_closing=True)
     ]))
 
 
@@ -493,7 +493,7 @@ def test_interpolation_no_leading_whitespace():
     assert _transpiled(fragment) == _transpiled(ASTFragment(-1, -1, [
         ASTComponent(-1, -1, ASTComponentName(-1, -1, "NotificationBar"), {
             "user": ASTComponentArgument(-1, -1, "user", None, ASTInterpolation(-1, -1, "user", 0, 1))
-        }, [])
+        }, [], self_closing=True)
     ]))
 
 
@@ -504,7 +504,7 @@ def test_interpolation_no_whitespace():
     assert _transpiled(fragment) == _transpiled(ASTFragment(-1, -1, [
         ASTComponent(-1, -1, ASTComponentName(-1, -1, "NotificationBar"), {
             "user": ASTComponentArgument(-1, -1, "user", None, ASTInterpolation(-1, -1, "user", 0, 0))
-        }, [])
+        }, [], self_closing=True)
     ]))
 
 

python_fragments-0.36/tests/test_html_elements.py

@@ -0,0 +1,55 @@
+from fragments.html.elements import attribute_to_string, className_to_string
+
+
+def test_attribute_plain_string():
+    assert attribute_to_string("href", "/path") == 'href="/path"'
+
+
+def test_attribute_string_escapes_double_quote():
+    assert attribute_to_string("data-value", 'say "hello"') == 'data-value="say "hello""'
+
+
+def test_attribute_string_escapes_ampersand():
+    assert attribute_to_string("title", "cats & dogs") == 'title="cats & dogs"'
+
+
+def test_attribute_string_escapes_arrow_in_expression():
+    assert attribute_to_string("x-on:click", "items.filter(item => item.active)") == (
+        'x-on:click="items.filter(item => item.active)"'
+    )
+
+
+def test_attribute_dict_escapes_quotes_from_json():
+    assert attribute_to_string("data-config", {"key": "value"}) == 'data-config="{"key": "value"}"'
+
+
+def test_attribute_bool_true():
+    assert attribute_to_string("disabled", True) == 'disabled="true"'
+
+
+def test_attribute_bool_false():
+    assert attribute_to_string("disabled", False) == 'disabled="false"'
+
+
+def test_attribute_none_returns_empty():
+    assert attribute_to_string("hidden", None) == ""
+
+
+def test_className_list_joined_with_spaces():
+    result = className_to_string(["foo", "bar", "baz"])
+    assert result == 'class="foo bar baz"'
+
+
+def test_className_empty_list():
+    result = className_to_string([])
+    assert result == 'class=""'
+
+
+def test_className_single_item_list():
+    result = className_to_string(["only"])
+    assert result == 'class="only"'
+
+
+def test_className_string_passthrough():
+    result = className_to_string("already-a-string")
+    assert result == 'class="already-a-string"'

python_fragments-0.33/PKG-INFO

@@ -1,88 +0,0 @@
-Metadata-Version: 2.4
-Name: python-fragments
-Version: 0.33
-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.33/README.md

@@ -1,51 +0,0 @@
-# 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.33/python_fragments.egg-info/PKG-INFO

@@ -1,88 +0,0 @@
-Metadata-Version: 2.4
-Name: python-fragments
-Version: 0.33
-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.33/tests/test_html_elements.py

@@ -1,21 +0,0 @@
-from fragments.html.elements import className_to_string
-
-
-def test_className_list_joined_with_spaces():
-    result = className_to_string(["foo", "bar", "baz"])
-    assert result == 'class="foo bar baz"'
-
-
-def test_className_empty_list():
-    result = className_to_string([])
-    assert result == 'class=""'
-
-
-def test_className_single_item_list():
-    result = className_to_string(["only"])
-    assert result == 'class="only"'
-
-
-def test_className_string_passthrough():
-    result = className_to_string("already-a-string")
-    assert result == 'class="already-a-string"'