v2.0.0b10 (#1336)

- Allow `reactpy.utils.string_to_reactpy` to render empty strings as React fragments.
- Allow `reactpy.utils.reactpy_to_string` to render components that return `None` as empty output.
- Ensure `h` shorthand for `reactpy.html` is exposed at top-level module (`reactpy.h`)

Author: Archmonger

src/js/bun.lockb

@@ -1,5 +1,5 @@
 from reactpy import config, logging, reactjs, types, web, widgets
-from reactpy._html import html
+from reactpy._html import h, html
 from reactpy.core import hooks
 from reactpy.core.component import component
 from reactpy.core.events import event
@@ -23,7 +23,7 @@
 from reactpy.utils import Ref, reactpy_to_string, string_to_reactpy
 
 __author__ = "The Reactive Python Team"
-__version__ = "2.0.0b9"
+__version__ = "2.0.0b10"
 
 __all__ = [
     "Ref",
@@ -32,6 +32,7 @@
     "config",
     "create_context",
     "event",
+    "h",
     "hooks",
     "html",
     "logging",

src/reactpy/__init__.py

@@ -9,7 +9,7 @@
 from lxml import etree
 from lxml.html import fromstring
 
-from reactpy import html
+from reactpy import h
 from reactpy.transforms import RequiredTransforms, attributes_to_reactjs
 from reactpy.types import Component, VdomDict
 
@@ -105,9 +105,14 @@ def string_to_reactpy(
             event handler that prevents the browser from navigating to the link. This is
             useful if you would rather have `reactpy-router` handle your URL navigation.
     """
-    if not isinstance(html, str):  # nocov
+    if not isinstance(html, str):
         msg = f"Expected html to be a string, not {type(html).__name__}"
         raise TypeError(msg)
+    if not html.strip():
+        return h.fragment()
+    if "<" not in html or ">" not in html:
+        msg = "Expected html string to contain HTML tags, but no tags were found."
+        raise ValueError(msg)
 
     # If the user provided a string, convert it to a list of lxml.etree nodes
     try:
@@ -153,7 +158,7 @@ def _etree_to_vdom(
     attributes = attributes_to_reactjs(dict(node.items()))
 
     # Convert the lxml node to a VDOM dict
-    constructor = getattr(html, str(node.tag))
+    constructor = getattr(h, str(node.tag))
     el = constructor(attributes, children)
 
     # Perform necessary transformations on the VDOM attributes to meet VDOM spec
@@ -236,13 +241,13 @@ def component_to_vdom(component: Component) -> VdomDict:
     """Convert the first render of a component into a VDOM dictionary"""
     result = component.render()
 
+    if result is None:
+        return h.fragment()
     if isinstance(result, dict):
         return result
     if hasattr(result, "render"):
         return component_to_vdom(cast(Component, result))
-    elif isinstance(result, str):
-        return html.div(result)
-    return html()
+    return h.div(result) if isinstance(result, str) else h.div()
 
 
 def _react_attribute_to_html(key: str, value: Any) -> tuple[str, str]:

src/reactpy/utils.py

@@ -15,6 +15,8 @@
 )
 from reactpy.testing.display import _playwright_visible
 
+from . import pytestmark  # noqa: F401
+
 REACTPY_ASYNC_RENDERING.set_current(True)
 REACTPY_DEBUG.set_current(True)
 

tests/conftest.py

@@ -6,6 +6,8 @@
 from tests.tooling.common import DEFAULT_TYPE_DELAY
 from tests.tooling.hooks import use_counter
 
+from . import pytestmark  # noqa: F401
+
 JS_DIR = Path(__file__).parent / "js"
 
 

tests/test_client.py

@@ -1,6 +1,8 @@
 import reactpy
 from reactpy.testing import DisplayFixture
 
+from .. import pytestmark  # noqa: F401
+
 
 def test_component_repr():
     @reactpy.component

tests/test_core/test_component.py

@@ -13,6 +13,8 @@
 from reactpy.types import Event
 from tests.tooling.common import DEFAULT_TYPE_DELAY
 
+from .. import pytestmark  # noqa: F401
+
 
 def test_event_handler_repr():
     handler = EventHandler(lambda: None)

tests/test_core/test_events.py

@@ -13,6 +13,8 @@
 from reactpy.utils import Ref
 from tests.tooling.common import DEFAULT_TYPE_DELAY, update_message
 
+from .. import pytestmark  # noqa: F401
+
 
 async def test_must_be_rendering_in_layout_to_use_hooks():
     @reactpy.component

tests/test_core/test_hooks.py

@@ -7,6 +7,8 @@
 from tests.tooling.common import DEFAULT_TYPE_DELAY
 from tests.tooling.hooks import use_counter
 
+from . import pytestmark  # noqa: F401
+
 
 async def test_script_re_run_on_content_change(display: DisplayFixture):
     @component

tests/test_html.py

@@ -8,6 +8,8 @@
 from reactpy.testing import BackendFixture, DisplayFixture
 from reactpy.testing.backend import root_hotswap_component
 
+from .. import pytestmark  # noqa: F401
+
 
 @pytest.fixture(scope="module")
 async def display(browser):