From 79388674f977307648dfd4068d8c64d61ecf7100 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Mon, 18 Sep 2023 23:00:21 -0700
Subject: [PATCH 01/28] `view_to_iframe` component

---
 docs/src/reference/components.md | 120 +++++++++++++++++++------------
 src/reactpy_django/components.py |  58 ++++++++-------
 src/reactpy_django/config.py     |   4 +-
 src/reactpy_django/http/urls.py  |   4 +-
 src/reactpy_django/http/views.py |  13 ++--
 src/reactpy_django/types.py      |  14 ++--
 6 files changed, 130 insertions(+), 83 deletions(-)

diff --git a/docs/src/reference/components.md b/docs/src/reference/components.md
index d3f235da..fb4bd0b9 100644
--- a/docs/src/reference/components.md
+++ b/docs/src/reference/components.md
@@ -10,7 +10,9 @@ We supply some pre-designed that components can be used to help simplify develop
 
 ## View To Component
 
-Convert any Django view into a ReactPy component by using this decorator. Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/topics/http/views/) and [Class Based Views](https://docs.djangoproject.com/en/dev/topics/class-based-views/). Views can be sync or async.
+Automatically convert a Django view into a ReactPy component.
+
+Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/topics/http/views/) and [Class Based Views](https://docs.djangoproject.com/en/dev/topics/class-based-views/). These views can be sync or async.
 
 === "components.py"
 
@@ -25,7 +27,7 @@ Convert any Django view into a ReactPy component by using this decorator. Compat
     | Name | Type | Description | Default |
     | --- | --- | --- | --- |
     | `#!python view` | `#!python Callable | View` | The view function or class to convert. | N/A |
-    | `#!python compatibility` | `#!python bool` | If `#!python True`, the component will be rendered in an iframe. When using compatibility mode `#!python tranforms`, `#!python strict_parsing`, `#!python request`, `#!python args`, and `#!python kwargs` arguments will be ignored. | `#!python False` |
+    | `#!python compatibility` | `#!python bool` | If `#!python True`, the component will be rendered in an `iframe`. When using compatibility mode `#!python tranforms`, `#!python strict_parsing`, `#!python request`, `#!python args`, and `#!python kwargs` arguments will be ignored. | `#!python False` |
     | `#!python transforms` | `#!python Sequence[Callable[[VdomDict], Any]]` | A list of functions that transforms the newly generated VDOM. The functions will be called on each VDOM node. | `#!python tuple` |
     | `#!python strict_parsing` | `#!python bool` | If `#!python True`, an exception will be generated if the HTML does not perfectly adhere to HTML5. | `#!python True` |
 
@@ -35,35 +37,51 @@ Convert any Django view into a ReactPy component by using this decorator. Compat
     | --- | --- |
     | `#!python _ViewComponentConstructor` | A function that takes `#!python request, *args, key, **kwargs` and returns a ReactPy component. All parameters are directly provided to your view, besides `#!python key` which is used by ReactPy. |
 
-??? Warning "Potential information exposure when using `#!python compatibility = True`"
+??? info "Existing limitations"
 
-    When using `#!python compatibility` mode, ReactPy automatically exposes a URL to your view.
+    There are currently several limitations of using `#!python view_to_component` that may be resolved in a future version.
 
-    It is your responsibility to ensure privileged information is not leaked via this method.
+    - Requires manual intervention to change request methods beyond `GET`.
+    - ReactPy events cannot conveniently be attached to converted view HTML.
+    - Has no option to automatically intercept local anchor link (such as `#!html <a href='example/'></a>`) click events.
 
-    You must implement a method to ensure only authorized users can access your view. This can be done via directly writing conditionals into your view, or by adding decorators such as [`#!python user_passes_test`](https://docs.djangoproject.com/en/dev/topics/auth/default/#django.contrib.auth.decorators.user_passes_test) to your views. For example...
+??? question "How do I customize this component's behavior?"
 
-    === "Function Based View"
+    This component accepts several `kwargs` that can be used to customize its behavior.
 
-        ```python
-        {% include "../../python/vtc-fbv-compat.py" %}
-        ```
+    Below are all the `kwargs` that can be used.
 
-    === "Class Based View"
+    ---
+
+    <font size="4">**`#!python strict_parsing`**</font>
+
+    By default, an exception will be generated if your view's HTML does not perfectly adhere to HTML5.
+
+    However, there are some circumstances where you may not have control over the original HTML, so you may be unable to fix it. Or you may be relying on non-standard HTML tags such as `#!html <my-tag> Hello World </my-tag>`.
+
+    In these scenarios, you may want to rely on best-fit parsing by setting the `#!python strict_parsing` parameter to `#!python False`. This uses `libxml2` recovery algorithm, which is designed to be similar to how web browsers would attempt to parse non-standard or broken HTML.
+
+    === "components.py"
 
         ```python
-        {% include "../../python/vtc-cbv-compatibility.py" %}
+        {% include "../../python/vtc-strict-parsing.py" %}
         ```
 
-??? info "Existing limitations"
+    ---
 
-    There are currently several limitations of using `#!python view_to_component` that may be resolved in a future version.
+    <font size="4">**`#!python transforms`**</font>
 
-    - Requires manual intervention to change request methods beyond `GET`.
-    - ReactPy events cannot conveniently be attached to converted view HTML.
-    - Has no option to automatically intercept local anchor link (such as `#!html <a href='example/'></a>`) click events.
+    After your view has been turned into [VDOM](https://reactpy.dev/docs/reference/specifications.html#vdom) (python dictionaries), `#!python view_to_component` will call your `#!python transforms` functions on every VDOM node.
+
+    This allows you to modify your view prior to rendering.
+
+    For example, if you are trying to modify the text of a node with a certain `#!python id`, you can create a transform like such:
 
-    _Please note these limitations do not exist when using `#!python compatibility` mode._
+    === "components.py"
+
+        ```python
+        {% include "../../python/vtc-transforms.py" %}
+        ```
 
 ??? question "How do I use this for Class Based Views?"
 
@@ -109,57 +127,71 @@ Convert any Django view into a ReactPy component by using this decorator. Compat
         {% include "../../python/vtc-args-kwargs.py" %}
         ```
 
-??? question "How do I use `#!python strict_parsing`, `#!python compatibility`, and `#!python transforms`?"
+## View To Iframe
 
-    <font size="4">**`#!python strict_parsing`**</font>
+Automatically convert a Django view into an `iframe`.
 
-    By default, an exception will be generated if your view's HTML does not perfectly adhere to HTML5.
+The contents of this `iframe` is handled entirely by traditional Django view rendering. While this solution is compatible with more views than `view_to_component`, it comes with different limitations.
 
-    However, there are some circumstances where you may not have control over the original HTML, so you may be unable to fix it. Or you may be relying on non-standard HTML tags such as `#!html <my-tag> Hello World </my-tag>`.
+Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/topics/http/views/) and [Class Based Views](https://docs.djangoproject.com/en/dev/topics/class-based-views/). These views can be sync or async.
 
-    In these scenarios, you may want to rely on best-fit parsing by setting the `#!python strict_parsing` parameter to `#!python False`.
+=== "components.py"
 
-    === "components.py"
+    ```python
+    {% include "../../python/vtc-compatibility.py" %}
+    ```
 
-        ```python
-        {% include "../../python/vtc-strict-parsing.py" %}
-        ```
+??? example "See Interface"
 
-    _Note: Best-fit parsing is designed to be similar to how web browsers would handle non-standard or broken HTML._
+    <font size="4">**Parameters**</font>
 
-    ---
+    | Name | Type | Description | Default |
+    | --- | --- | --- | --- |
 
-    <font size="4">**`#!python compatibility`**</font>
+    <font size="4">**Returns**</font>
 
-    For views that rely on HTTP responses other than `GET` (such as `PUT`, `POST`, `PATCH`, etc), you should consider using compatibility mode to render your view within an iframe.
+    | Type | Description |
+    | --- | --- |
+    | `#!python _ViewComponentConstructor` | A function that takes `#!python request, *args, key, **kwargs` and returns a ReactPy component. All parameters are directly provided to your view, besides `#!python key` which is used by ReactPy. |
 
-    Any view can be rendered within compatibility mode. However, the `#!python transforms`, `#!python strict_parsing`, `#!python request`, `#!python args`, and `#!python kwargs` arguments do not apply to compatibility mode.
+??? Warning "Potential information exposure when using this component"
 
+    When using this component, ReactPy automatically exposes a URL to your view.
 
+    It is your responsibility to ensure privileged information is not leaked via this method.
 
-    === "components.py"
+    You must implement a method to ensure only authorized users can access your view. This can be done via directly writing conditionals into your view, or by adding decorators such as [`#!python user_passes_test`](https://docs.djangoproject.com/en/dev/topics/auth/default/#django.contrib.auth.decorators.user_passes_test) to your views. For example...
+
+    === "Function Based View"
 
         ```python
-        {% include "../../python/vtc-compatibility.py" %}
+        {% include "../../python/vtc-fbv-compat.py" %}
         ```
 
-    _Note: By default the `#!python compatibility` iframe is unstyled, and thus won't look pretty until you add some CSS._
+    === "Class Based View"
 
-    ---
+        ```python
+        {% include "../../python/vtc-cbv-compatibility.py" %}
+        ```
 
-    <font size="4">**`#!python transforms`**</font>
+??? info "Existing limitations"
 
-    After your view has been turned into [VDOM](https://reactpy.dev/docs/reference/specifications.html#vdom) (python dictionaries), `#!python view_to_component` will call your `#!python transforms` functions on every VDOM node.
+    There are currently several limitations of using `#!python view_to_iframe` that may be resolved in a future version.
 
-    This allows you to modify your view prior to rendering.
+    - Inability to signal events back to the parent component.
+    - You must ensure all `view_to_iframe` components are manually loaded during Django startup to ensure multiprocessing compatibility. This usually involves import the file where you define your `view_to_iframe` functions within your `MyAppConfig.ready` method.
+    - The `iframe` component will always load **after** the parent component.
+    - CSS styling restrictions inherent to `iframe` elements.
 
-    For example, if you are trying to modify the text of a node with a certain `#!python id`, you can create a transform like such:
+??? Question "Why do my converted components look ugly?"
 
-    === "components.py"
+    The `iframe` generated by this component is unstyled, and thus won't look pretty until you add some CSS.
 
-        ```python
-        {% include "../../python/vtc-transforms.py" %}
-        ```
+    We recommend removing the `border`, and configuring a `height` and `width`.
+
+??? question "How do I provide `#!python args` and `#!python kwargs` to a view?"
+
+    ...
 
 ## Django CSS
 
diff --git a/src/reactpy_django/components.py b/src/reactpy_django/components.py
index 31df3e2e..f5b576d9 100644
--- a/src/reactpy_django/components.py
+++ b/src/reactpy_django/components.py
@@ -2,7 +2,8 @@
 
 import json
 import os
-from typing import Any, Callable, Protocol, Sequence, Union, cast, overload
+from typing import Any, Callable, Sequence, Union, cast, overload
+from warnings import warn
 
 from django.contrib.staticfiles.finders import find
 from django.core.cache import caches
@@ -10,19 +11,12 @@
 from django.urls import reverse
 from django.views import View
 from reactpy import component, hooks, html, utils
-from reactpy.types import ComponentType, Key, VdomDict
+from reactpy.types import Key, VdomDict
 
-from reactpy_django.types import ViewComponentIframe
+from reactpy_django.types import IframeComponent, ViewComponentConstructor
 from reactpy_django.utils import generate_obj_name, render_view
 
 
-class _ViewComponentConstructor(Protocol):
-    def __call__(
-        self, request: HttpRequest | None = None, *args: Any, **kwargs: Any
-    ) -> ComponentType:
-        ...
-
-
 @component
 def _view_to_component(
     view: Callable | View,
@@ -33,8 +27,6 @@ def _view_to_component(
     args: Sequence | None,
     kwargs: dict | None,
 ):
-    from reactpy_django.config import REACTPY_VIEW_COMPONENT_IFRAMES
-
     converted_view, set_converted_view = hooks.use_state(
         cast(Union[VdomDict, None], None)
     )
@@ -72,17 +64,15 @@ async def async_render():
 
     # Render in compatibility mode, if needed
     if compatibility:
-        dotted_path = f"{view.__module__}.{view.__name__}".replace("<", "").replace(">", "")  # type: ignore
-        REACTPY_VIEW_COMPONENT_IFRAMES[dotted_path] = ViewComponentIframe(
-            view, _args, _kwargs
-        )
-        return html.iframe(
-            {
-                "src": reverse("reactpy:view_to_component", args=[dotted_path]),
-                "loading": "lazy",
-            }
+        # Warn the user that compatibility mode is deprecated
+        warn(
+            "view_to_component(compatibility=True) is deprecated and will be removed in a future version. "
+            "Please use `view_to_iframe_component` instead.",
+            DeprecationWarning,
         )
 
+        return view_to_iframe(view)(_args, **_kwargs)
+
     # Return the view if it's been rendered via the `async_render` hook
     return converted_view
 
@@ -96,7 +86,7 @@ def view_to_component(
     compatibility: bool = False,
     transforms: Sequence[Callable[[VdomDict], Any]] = (),
     strict_parsing: bool = True,
-) -> _ViewComponentConstructor:
+) -> ViewComponentConstructor:
     ...
 
 
@@ -108,7 +98,7 @@ def view_to_component(
     compatibility: bool = False,
     transforms: Sequence[Callable[[VdomDict], Any]] = (),
     strict_parsing: bool = True,
-) -> Callable[[Callable], _ViewComponentConstructor]:
+) -> Callable[[Callable], ViewComponentConstructor]:
     ...
 
 
@@ -119,7 +109,7 @@ def view_to_component(
     compatibility: bool = False,
     transforms: Sequence[Callable[[VdomDict], Any]] = (),
     strict_parsing: bool = True,
-) -> _ViewComponentConstructor | Callable[[Callable], _ViewComponentConstructor]:
+) -> ViewComponentConstructor | Callable[[Callable], ViewComponentConstructor]:
     """Converts a Django view to a ReactPy component.
 
     Keyword Args:
@@ -163,6 +153,26 @@ def wrapper(
     return decorator(view) if view else decorator
 
 
+def view_to_iframe(view: Callable | View):
+    from reactpy_django.config import REACTPY_REGISTERED_IFRAMES
+
+    dotted_path = f"{view.__module__}.{view.__name__}".replace("<", "").replace(">", "")  # type: ignore
+    REACTPY_REGISTERED_IFRAMES[dotted_path] = IframeComponent(view)
+
+    @component
+    def _view_to_iframe(*args: Any, **kwargs: Any):
+        return html.iframe(
+            {
+                "src": reverse(
+                    "reactpy:view_to_iframe", args=[dotted_path, *args], kwargs=kwargs
+                ),
+                "loading": "lazy",
+            }
+        )
+
+    return _view_to_iframe
+
+
 @component
 def _django_css(static_path: str):
     return html.style(_cached_static_contents(static_path))
diff --git a/src/reactpy_django/config.py b/src/reactpy_django/config.py
index 56011c83..fa4b75ae 100644
--- a/src/reactpy_django/config.py
+++ b/src/reactpy_django/config.py
@@ -10,8 +10,8 @@
 
 from reactpy_django.types import (
     AsyncPostprocessor,
+    IframeComponent,
     SyncPostprocessor,
-    ViewComponentIframe,
 )
 from reactpy_django.utils import import_dotted_path
 
@@ -19,7 +19,7 @@
 REACTPY_DEBUG_MODE.set_current(getattr(settings, "DEBUG"))
 REACTPY_REGISTERED_COMPONENTS: dict[str, ComponentConstructor] = {}
 REACTPY_FAILED_COMPONENTS: set[str] = set()
-REACTPY_VIEW_COMPONENT_IFRAMES: dict[str, ViewComponentIframe] = {}
+REACTPY_REGISTERED_IFRAMES: dict[str, IframeComponent] = {}
 
 
 # Remove in a future release
diff --git a/src/reactpy_django/http/urls.py b/src/reactpy_django/http/urls.py
index 05bac8e5..8a466e3f 100644
--- a/src/reactpy_django/http/urls.py
+++ b/src/reactpy_django/http/urls.py
@@ -12,7 +12,7 @@
     ),
     path(
         "iframe/<str:view_path>",
-        views.view_to_component_iframe,  # type: ignore[arg-type]
-        name="view_to_component",
+        views.view_to_iframe,  # type: ignore[arg-type]
+        name="view_to_iframe",
     ),
 ]
diff --git a/src/reactpy_django/http/views.py b/src/reactpy_django/http/views.py
index 12129791..5fbae810 100644
--- a/src/reactpy_django/http/views.py
+++ b/src/reactpy_django/http/views.py
@@ -39,20 +39,19 @@ async def web_modules_file(request: HttpRequest, file: str) -> HttpResponse:
     return HttpResponse(file_contents, content_type="text/javascript")
 
 
-async def view_to_component_iframe(
-    request: HttpRequest, view_path: str
+async def view_to_iframe(
+    request: HttpRequest, view_path: str, *args, **kwargs
 ) -> HttpResponse:
-    """Returns a view that was registered by view_to_component.
-    This view is intended to be used as iframe, for compatibility purposes."""
-    from reactpy_django.config import REACTPY_VIEW_COMPONENT_IFRAMES
+    """Returns a view that was registered by reactpy_django.components.view_to_iframe."""
+    from reactpy_django.config import REACTPY_REGISTERED_IFRAMES
 
     # Get the view from REACTPY_REGISTERED_IFRAMES
-    iframe = REACTPY_VIEW_COMPONENT_IFRAMES.get(view_path)
+    iframe = REACTPY_REGISTERED_IFRAMES.get(view_path)
     if not iframe:
         return HttpResponseNotFound()
 
     # Render the view
-    response = await render_view(iframe.view, request, iframe.args, iframe.kwargs)
+    response = await render_view(iframe.view, request, args, kwargs)
 
     # Ensure page can be rendered as an iframe
     response["X-Frame-Options"] = "SAMEORIGIN"
diff --git a/src/reactpy_django/types.py b/src/reactpy_django/types.py
index 3c77a1eb..83d29790 100644
--- a/src/reactpy_django/types.py
+++ b/src/reactpy_django/types.py
@@ -18,6 +18,7 @@
 from django.db.models.query import QuerySet
 from django.http import HttpRequest
 from django.views.generic import View
+from reactpy.types import ComponentType
 from reactpy.types import Connection as _Connection
 from typing_extensions import ParamSpec
 
@@ -29,7 +30,7 @@
     "Query",
     "Mutation",
     "Connection",
-    "ViewComponentIframe",
+    "IframeComponent",
     "AsyncPostprocessor",
     "SyncPostprocessor",
     "QueryOptions",
@@ -75,10 +76,8 @@ class Mutation(Generic[_Params]):
 
 
 @dataclass
-class ViewComponentIframe:
+class IframeComponent:
     view: View | Callable
-    args: Sequence
-    kwargs: dict
 
 
 class AsyncPostprocessor(Protocol):
@@ -134,3 +133,10 @@ class ComponentParams:
 
     args: Sequence
     kwargs: MutableMapping[str, Any]
+
+
+class ViewComponentConstructor(Protocol):
+    def __call__(
+        self, request: HttpRequest | None = None, *args: Any, **kwargs: Any
+    ) -> ComponentType:
+        ...

From 0ab58227ff58ae40f34978915f02844978355bff Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Mon, 18 Sep 2023 23:01:31 -0700
Subject: [PATCH 02/28] add changelog

---
 CHANGELOG.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f8f0ec63..62027875 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -44,6 +44,10 @@ Using the following categories, list your changes in this order:
 
 -   Renamed undocumented utility function `reactpy_django.utils.ComponentPreloader` to `reactpy_django.utils.RootComponentFinder`.
 
+### Deprecated
+
+-   The `compatibility` argument on `reactpy_django.components.view_to_component` is deprecated. Use `view_to_iframe_component` instead.
+
 ## [3.5.1] - 2023-09-07
 
 ### Added

From 79462f97a981957d074d889ff041b36aa593ff9b Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Thu, 21 Sep 2023 18:45:14 -0700
Subject: [PATCH 03/28] functional view_to_iframe

---
 src/reactpy_django/checks.py            |  2 +-
 src/reactpy_django/components.py        | 17 +++++++++++++----
 src/reactpy_django/http/views.py        | 10 +++++++---
 src/reactpy_django/types.py             |  2 ++
 tests/test_app/components.py            | 11 ++++++++++-
 tests/test_app/templates/base.html      |  5 ++++-
 tests/test_app/tests/test_components.py |  5 +++++
 tests/test_app/views.py                 | 16 +++++++++++++++-
 8 files changed, 57 insertions(+), 11 deletions(-)

diff --git a/src/reactpy_django/checks.py b/src/reactpy_django/checks.py
index 489888eb..77bb4153 100644
--- a/src/reactpy_django/checks.py
+++ b/src/reactpy_django/checks.py
@@ -39,7 +39,7 @@ def reactpy_warnings(app_configs, **kwargs):
     # ReactPy URLs exist
     try:
         reverse("reactpy:web_modules", kwargs={"file": "example"})
-        reverse("reactpy:view_to_component", kwargs={"view_path": "example"})
+        reverse("reactpy:view_to_iframe", kwargs={"view_path": "example"})
     except Exception:
         warnings.append(
             Warning(
diff --git a/src/reactpy_django/components.py b/src/reactpy_django/components.py
index 09bca072..009ded3a 100644
--- a/src/reactpy_django/components.py
+++ b/src/reactpy_django/components.py
@@ -3,6 +3,7 @@
 import json
 import os
 from typing import Any, Callable, Sequence, Union, cast, overload
+from urllib.parse import urlencode
 from warnings import warn
 
 from django.contrib.staticfiles.finders import find
@@ -71,7 +72,7 @@ async def async_render():
             DeprecationWarning,
         )
 
-        return view_to_iframe(view)(_args, **_kwargs)
+        return view_to_iframe(view)(*_args, **_kwargs)
 
     # Return the view if it's been rendered via the `async_render` hook
     return converted_view
@@ -161,11 +162,19 @@ def view_to_iframe(view: Callable | View):
 
     @component
     def _view_to_iframe(*args: Any, **kwargs: Any):
+        query_string = ""
+        query = {}
+        if args:
+            query["_args"] = args
+        if kwargs:
+            query.update(kwargs)
+        if args or kwargs:
+            query_string = f"?{urlencode(query, doseq=True)}"
+
         return html.iframe(
             {
-                "src": reverse(
-                    "reactpy:view_to_iframe", args=[dotted_path, *args], kwargs=kwargs
-                ),
+                "src": reverse("reactpy:view_to_iframe", args=[dotted_path])
+                + query_string,
                 "loading": "lazy",
             }
         )
diff --git a/src/reactpy_django/http/views.py b/src/reactpy_django/http/views.py
index 5fbae810..4e4424bd 100644
--- a/src/reactpy_django/http/views.py
+++ b/src/reactpy_django/http/views.py
@@ -1,4 +1,5 @@
 import os
+from urllib.parse import parse_qs
 
 from aiofile import async_open
 from django.core.cache import caches
@@ -39,9 +40,7 @@ async def web_modules_file(request: HttpRequest, file: str) -> HttpResponse:
     return HttpResponse(file_contents, content_type="text/javascript")
 
 
-async def view_to_iframe(
-    request: HttpRequest, view_path: str, *args, **kwargs
-) -> HttpResponse:
+async def view_to_iframe(request: HttpRequest, view_path: str) -> HttpResponse:
     """Returns a view that was registered by reactpy_django.components.view_to_iframe."""
     from reactpy_django.config import REACTPY_REGISTERED_IFRAMES
 
@@ -50,6 +49,11 @@ async def view_to_iframe(
     if not iframe:
         return HttpResponseNotFound()
 
+    # Get args and kwargs from the request
+    query = request.META.get("QUERY_STRING", "")
+    kwargs = {k: v if len(v) > 1 else v[0] for k, v in parse_qs(query).items()}
+    args = kwargs.pop("_args", [])
+
     # Render the view
     response = await render_view(iframe.view, request, args, kwargs)
 
diff --git a/src/reactpy_django/types.py b/src/reactpy_django/types.py
index 83d29790..7fb47166 100644
--- a/src/reactpy_django/types.py
+++ b/src/reactpy_django/types.py
@@ -77,6 +77,8 @@ class Mutation(Generic[_Params]):
 
 @dataclass
 class IframeComponent:
+    """Views registered by `view_to_iframe`."""
+
     view: View | Callable
 
 
diff --git a/tests/test_app/components.py b/tests/test_app/components.py
index ec53c031..db118343 100644
--- a/tests/test_app/components.py
+++ b/tests/test_app/components.py
@@ -7,7 +7,7 @@
 from django.http import HttpRequest
 from django.shortcuts import render
 from reactpy import component, hooks, html, web
-from reactpy_django.components import view_to_component
+from reactpy_django.components import view_to_component, view_to_iframe
 from reactpy_django.types import QueryOptions
 
 from test_app.models import (
@@ -468,6 +468,7 @@ async def on_change(event):
 _view_to_component_template_view_class_compatibility = view_to_component(
     views.ViewToComponentTemplateViewClassCompatibility, compatibility=True
 )
+_view_to_iframe_args = view_to_iframe(views.view_to_iframe_args)
 view_to_component_script = view_to_component(views.view_to_component_script)
 _view_to_component_request = view_to_component(views.view_to_component_request)
 _view_to_component_args = view_to_component(views.view_to_component_args)
@@ -514,6 +515,14 @@ def view_to_component_template_view_class_compatibility():
     )
 
 
+@component
+def view_to_iframe_args():
+    return html.div(
+        {"id": inspect.currentframe().f_code.co_name},  # type: ignore
+        _view_to_iframe_args("Arg1", "Arg2", kwarg1="Kwarg1", kwarg2="Kwarg2"),
+    )
+
+
 @component
 def view_to_component_request():
     request, set_request = hooks.use_state(None)
diff --git a/tests/test_app/templates/base.html b/tests/test_app/templates/base.html
index 03dd3ba3..f2042fd4 100644
--- a/tests/test_app/templates/base.html
+++ b/tests/test_app/templates/base.html
@@ -81,6 +81,8 @@ <h1>ReactPy Test Page</h1>
   <hr>
   {% component "test_app.components.view_to_component_template_view_class_compatibility" %}
   <hr>
+  {% component "test_app.components.view_to_iframe_args" %}
+  <hr>
   {% component "test_app.components.view_to_component_decorator" %}
   <hr>
   {% component "test_app.components.view_to_component_decorator_args" %}
@@ -92,7 +94,8 @@ <h1>ReactPy Test Page</h1>
   <div id="invalid_host_error">{% component "test_app.components.hello_world" host="https://example.com/" %}</div>
   <hr>
   <div id="broken_postprocessor_query">
-    {% component "test_app.components.broken_postprocessor_query" %}</div>
+    {% component "test_app.components.broken_postprocessor_query" %}
+  </div>
   <hr>
 </body>
 
diff --git a/tests/test_app/tests/test_components.py b/tests/test_app/tests/test_components.py
index 36f3f164..d6b49793 100644
--- a/tests/test_app/tests/test_components.py
+++ b/tests/test_app/tests/test_components.py
@@ -264,6 +264,11 @@ def test_view_to_component_template_view_class_compatibility(self):
             "#ViewToComponentTemplateViewClassCompatibility[data-success=true]"
         ).wait_for()
 
+    def test_view_to_iframe_args(self):
+        self.page.frame_locator("#view_to_iframe_args > iframe").locator(
+            "#view_to_iframe_args[data-success=Success]"
+        ).wait_for()
+
     def test_view_to_component_decorator(self):
         self.page.locator("#view_to_component_decorator[data-success=true]").wait_for()
 
diff --git a/tests/test_app/views.py b/tests/test_app/views.py
index 689d8f8c..2bd06747 100644
--- a/tests/test_app/views.py
+++ b/tests/test_app/views.py
@@ -124,6 +124,21 @@ def get_context_data(self, **kwargs):
         return {"test_name": self.__class__.__name__}
 
 
+def view_to_iframe_args(request, arg1, arg2, kwarg1=None, kwarg2=None):
+    success = (
+        arg1 == "Arg1" and arg2 == "Arg2" and kwarg1 == "Kwarg1" and kwarg2 == "Kwarg2"
+    )
+
+    return render(
+        request,
+        "view_to_component.html",
+        {
+            "test_name": inspect.currentframe().f_code.co_name,  # type:ignore
+            "status": "Success" if success else "false",
+        },
+    )
+
+
 def view_to_component_script(request):
     return render(
         request,
@@ -149,7 +164,6 @@ def view_to_component_request(request):
         {
             "test_name": inspect.currentframe().f_code.co_name,  # type:ignore
             "status": "false",
-            "success": "false",
         },
     )
 

From 68e15a05d0ad85e5cc92064c811d0f8f3f720aa4 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Thu, 21 Sep 2023 19:21:56 -0700
Subject: [PATCH 04/28] ViewToIframeConstructor type

---
 docs/src/reference/components.md |  4 ++--
 src/reactpy_django/components.py | 14 +++++++-------
 src/reactpy_django/config.py     |  5 +++--
 src/reactpy_django/http/views.py |  2 +-
 src/reactpy_django/types.py      | 16 ++++++----------
 src/reactpy_django/utils.py      |  5 +++++
 6 files changed, 24 insertions(+), 22 deletions(-)

diff --git a/docs/src/reference/components.md b/docs/src/reference/components.md
index 2f7d7015..b2eb4fe0 100644
--- a/docs/src/reference/components.md
+++ b/docs/src/reference/components.md
@@ -35,7 +35,7 @@ Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/top
 
     | Type | Description |
     | --- | --- |
-    | `#!python _ViewComponentConstructor` | A function that takes `#!python request, *args, key, **kwargs` and returns a ReactPy component. All parameters are directly provided to your view, besides `#!python key` which is used by ReactPy. |
+    | `#!python ViewToComponentConstructor` | A function that takes `#!python request, *args, key, **kwargs` and returns a ReactPy component. All parameters are directly provided to your view, besides `#!python key` which is used by ReactPy. |
 
 ??? info "Existing limitations"
 
@@ -152,7 +152,7 @@ Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/top
 
     | Type | Description |
     | --- | --- |
-    | `#!python _ViewComponentConstructor` | A function that takes `#!python request, *args, key, **kwargs` and returns a ReactPy component. All parameters are directly provided to your view, besides `#!python key` which is used by ReactPy. |
+    | `#!python ViewToComponentConstructor` | A function that takes `#!python request, *args, key, **kwargs` and returns a ReactPy component. All parameters are directly provided to your view, besides `#!python key` which is used by ReactPy. |
 
 ??? Warning "Potential information exposure when using this component"
 
diff --git a/src/reactpy_django/components.py b/src/reactpy_django/components.py
index 009ded3a..991c1b36 100644
--- a/src/reactpy_django/components.py
+++ b/src/reactpy_django/components.py
@@ -14,7 +14,7 @@
 from reactpy import component, hooks, html, utils
 from reactpy.types import Key, VdomDict
 
-from reactpy_django.types import IframeComponent, ViewComponentConstructor
+from reactpy_django.types import ViewToComponentConstructor, ViewToIframeConstructor
 from reactpy_django.utils import generate_obj_name, render_view
 
 
@@ -87,7 +87,7 @@ def view_to_component(
     compatibility: bool = False,
     transforms: Sequence[Callable[[VdomDict], Any]] = (),
     strict_parsing: bool = True,
-) -> ViewComponentConstructor:
+) -> ViewToComponentConstructor:
     ...
 
 
@@ -99,7 +99,7 @@ def view_to_component(
     compatibility: bool = False,
     transforms: Sequence[Callable[[VdomDict], Any]] = (),
     strict_parsing: bool = True,
-) -> Callable[[Callable], ViewComponentConstructor]:
+) -> Callable[[Callable], ViewToComponentConstructor]:
     ...
 
 
@@ -110,7 +110,7 @@ def view_to_component(
     compatibility: bool = False,
     transforms: Sequence[Callable[[VdomDict], Any]] = (),
     strict_parsing: bool = True,
-) -> ViewComponentConstructor | Callable[[Callable], ViewComponentConstructor]:
+) -> ViewToComponentConstructor | Callable[[Callable], ViewToComponentConstructor]:
     """Converts a Django view to a ReactPy component.
 
     Keyword Args:
@@ -154,11 +154,11 @@ def wrapper(
     return decorator(view) if view else decorator
 
 
-def view_to_iframe(view: Callable | View):
+def view_to_iframe(view: Callable | View) -> ViewToIframeConstructor:
     from reactpy_django.config import REACTPY_REGISTERED_IFRAMES
 
-    dotted_path = f"{view.__module__}.{view.__name__}".replace("<", "").replace(">", "")  # type: ignore
-    REACTPY_REGISTERED_IFRAMES[dotted_path] = IframeComponent(view)
+    dotted_path = generate_obj_name(view).replace("<", "").replace(">", "")
+    REACTPY_REGISTERED_IFRAMES[dotted_path] = view
 
     @component
     def _view_to_iframe(*args: Any, **kwargs: Any):
diff --git a/src/reactpy_django/config.py b/src/reactpy_django/config.py
index fa4b75ae..c0d8524d 100644
--- a/src/reactpy_django/config.py
+++ b/src/reactpy_django/config.py
@@ -1,16 +1,17 @@
 from __future__ import annotations
 
 from itertools import cycle
+from typing import Callable
 
 from django.conf import settings
 from django.core.cache import DEFAULT_CACHE_ALIAS
 from django.db import DEFAULT_DB_ALIAS
+from django.views import View
 from reactpy.config import REACTPY_DEBUG_MODE
 from reactpy.core.types import ComponentConstructor
 
 from reactpy_django.types import (
     AsyncPostprocessor,
-    IframeComponent,
     SyncPostprocessor,
 )
 from reactpy_django.utils import import_dotted_path
@@ -19,7 +20,7 @@
 REACTPY_DEBUG_MODE.set_current(getattr(settings, "DEBUG"))
 REACTPY_REGISTERED_COMPONENTS: dict[str, ComponentConstructor] = {}
 REACTPY_FAILED_COMPONENTS: set[str] = set()
-REACTPY_REGISTERED_IFRAMES: dict[str, IframeComponent] = {}
+REACTPY_REGISTERED_IFRAMES: dict[str, Callable | View] = {}
 
 
 # Remove in a future release
diff --git a/src/reactpy_django/http/views.py b/src/reactpy_django/http/views.py
index 4e4424bd..87c1a837 100644
--- a/src/reactpy_django/http/views.py
+++ b/src/reactpy_django/http/views.py
@@ -55,7 +55,7 @@ async def view_to_iframe(request: HttpRequest, view_path: str) -> HttpResponse:
     args = kwargs.pop("_args", [])
 
     # Render the view
-    response = await render_view(iframe.view, request, args, kwargs)
+    response = await render_view(iframe, request, args, kwargs)
 
     # Ensure page can be rendered as an iframe
     response["X-Frame-Options"] = "SAMEORIGIN"
diff --git a/src/reactpy_django/types.py b/src/reactpy_django/types.py
index 7fb47166..8ccb1790 100644
--- a/src/reactpy_django/types.py
+++ b/src/reactpy_django/types.py
@@ -17,7 +17,6 @@
 from django.db.models.base import Model
 from django.db.models.query import QuerySet
 from django.http import HttpRequest
-from django.views.generic import View
 from reactpy.types import ComponentType
 from reactpy.types import Connection as _Connection
 from typing_extensions import ParamSpec
@@ -30,7 +29,6 @@
     "Query",
     "Mutation",
     "Connection",
-    "IframeComponent",
     "AsyncPostprocessor",
     "SyncPostprocessor",
     "QueryOptions",
@@ -75,13 +73,6 @@ class Mutation(Generic[_Params]):
     reset: Callable[[], None]
 
 
-@dataclass
-class IframeComponent:
-    """Views registered by `view_to_iframe`."""
-
-    view: View | Callable
-
-
 class AsyncPostprocessor(Protocol):
     async def __call__(self, data: Any) -> Any:
         ...
@@ -137,8 +128,13 @@ class ComponentParams:
     kwargs: MutableMapping[str, Any]
 
 
-class ViewComponentConstructor(Protocol):
+class ViewToComponentConstructor(Protocol):
     def __call__(
         self, request: HttpRequest | None = None, *args: Any, **kwargs: Any
     ) -> ComponentType:
         ...
+
+
+class ViewToIframeConstructor(Protocol):
+    def __call__(self, *args: Any, **kwargs: Any) -> ComponentType:
+        ...
diff --git a/src/reactpy_django/utils.py b/src/reactpy_django/utils.py
index e06df1ce..143f69ff 100644
--- a/src/reactpy_django/utils.py
+++ b/src/reactpy_django/utils.py
@@ -225,14 +225,19 @@ def register_components(self, components: set[str]) -> None:
 def generate_obj_name(object: Any) -> str:
     """Makes a best effort to create a name for an object.
     Useful for JSON serialization of Python objects."""
+
+    # Attempt to use dunder methods to create a name
     if hasattr(object, "__module__"):
         if hasattr(object, "__name__"):
             return f"{object.__module__}.{object.__name__}"
         if hasattr(object, "__class__"):
             return f"{object.__module__}.{object.__class__.__name__}"
 
+    # First fallback: String representation
     with contextlib.suppress(Exception):
         return str(object)
+
+    # Last fallback: Empty string
     return ""
 
 

From 46dc39e0ec2b34f72cceaa212832fbddc2953f2a Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Thu, 21 Sep 2023 19:28:57 -0700
Subject: [PATCH 05/28] temporarily remove section index plugin

---
 mkdocs.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/mkdocs.yml b/mkdocs.yml
index 35bb6bb0..5c308d00 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -74,7 +74,6 @@ markdown_extensions:
 plugins:
     - search
     - include-markdown
-    - section-index
     - git-authors
     - minify:
           minify_html: true
@@ -87,6 +86,7 @@ plugins:
           known_words: dictionary.txt
           allow_unicode: no
           ignore_code: yes
+    # - section-index
 
 extra:
     generator: false

From b5085893b21f8cb8aa8dd216d295a6e3b72b6077 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sat, 23 Sep 2023 01:36:04 -0700
Subject: [PATCH 06/28] better API

---
 src/reactpy_django/components.py | 65 +++++++++++++++++++-------------
 src/reactpy_django/types.py      |  5 ---
 tests/test_app/components.py     |  5 ++-
 3 files changed, 42 insertions(+), 33 deletions(-)

diff --git a/src/reactpy_django/components.py b/src/reactpy_django/components.py
index 991c1b36..b6cd9837 100644
--- a/src/reactpy_django/components.py
+++ b/src/reactpy_django/components.py
@@ -12,9 +12,9 @@
 from django.urls import reverse
 from django.views import View
 from reactpy import component, hooks, html, utils
-from reactpy.types import Key, VdomDict
+from reactpy.types import ComponentType, Key, VdomDict
 
-from reactpy_django.types import ViewToComponentConstructor, ViewToIframeConstructor
+from reactpy_django.types import ViewToComponentConstructor
 from reactpy_django.utils import generate_obj_name, render_view
 
 
@@ -68,11 +68,11 @@ async def async_render():
         # Warn the user that compatibility mode is deprecated
         warn(
             "view_to_component(compatibility=True) is deprecated and will be removed in a future version. "
-            "Please use `view_to_iframe_component` instead.",
+            "Please use `view_to_iframe` instead.",
             DeprecationWarning,
         )
 
-        return view_to_iframe(view)(*_args, **_kwargs)
+        return view_to_iframe(view, *_args, **_kwargs)
 
     # Return the view if it's been rendered via the `async_render` hook
     return converted_view
@@ -103,8 +103,6 @@ def view_to_component(
     ...
 
 
-# TODO: Might want to intercept href clicks and form submit events.
-# Form events will probably be accomplished through the upcoming DjangoForm.
 def view_to_component(
     view: Callable | View | None = None,
     compatibility: bool = False,
@@ -151,35 +149,50 @@ def wrapper(
 
         return wrapper
 
+    if not view:
+        warn(
+            "Using `view_to_component` as a decorator is deprecated. "
+            "This functionality will be removed in a future version.",
+            DeprecationWarning,
+        )
+
     return decorator(view) if view else decorator
 
 
-def view_to_iframe(view: Callable | View) -> ViewToIframeConstructor:
+@component
+def _view_to_iframe(
+    view: Callable | View, *args, extra_props: dict | None = None, **kwargs
+) -> VdomDict:
     from reactpy_django.config import REACTPY_REGISTERED_IFRAMES
 
     dotted_path = generate_obj_name(view).replace("<", "").replace(">", "")
     REACTPY_REGISTERED_IFRAMES[dotted_path] = view
+    extra_props = extra_props or {}
+    extra_props.pop("src", None)
+
+    query = kwargs.copy()
+    if args:
+        query["_args"] = args
+
+    query_string = f"?{urlencode(query, doseq=True)}" if args or kwargs else ""
+
+    return html.iframe(
+        {
+            "src": reverse("reactpy:view_to_iframe", args=[dotted_path]) + query_string,
+            "style": {"border": "none", "width": "100%", "height": "auto"},
+            "loading": "lazy",
+        }
+        | extra_props
+    )
 
-    @component
-    def _view_to_iframe(*args: Any, **kwargs: Any):
-        query_string = ""
-        query = {}
-        if args:
-            query["_args"] = args
-        if kwargs:
-            query.update(kwargs)
-        if args or kwargs:
-            query_string = f"?{urlencode(query, doseq=True)}"
-
-        return html.iframe(
-            {
-                "src": reverse("reactpy:view_to_iframe", args=[dotted_path])
-                + query_string,
-                "loading": "lazy",
-            }
-        )
 
-    return _view_to_iframe
+def view_to_iframe(
+    view: Callable | View, *args, extra_props: dict | None = None, **kwargs
+) -> ComponentType:
+    """
+    TODO: Fill this out
+    """
+    return _view_to_iframe(view, *args, extra_props=extra_props, **kwargs)
 
 
 @component
diff --git a/src/reactpy_django/types.py b/src/reactpy_django/types.py
index 8ccb1790..2be95e7a 100644
--- a/src/reactpy_django/types.py
+++ b/src/reactpy_django/types.py
@@ -133,8 +133,3 @@ def __call__(
         self, request: HttpRequest | None = None, *args: Any, **kwargs: Any
     ) -> ComponentType:
         ...
-
-
-class ViewToIframeConstructor(Protocol):
-    def __call__(self, *args: Any, **kwargs: Any) -> ComponentType:
-        ...
diff --git a/tests/test_app/components.py b/tests/test_app/components.py
index db118343..444d49d8 100644
--- a/tests/test_app/components.py
+++ b/tests/test_app/components.py
@@ -468,7 +468,6 @@ async def on_change(event):
 _view_to_component_template_view_class_compatibility = view_to_component(
     views.ViewToComponentTemplateViewClassCompatibility, compatibility=True
 )
-_view_to_iframe_args = view_to_iframe(views.view_to_iframe_args)
 view_to_component_script = view_to_component(views.view_to_component_script)
 _view_to_component_request = view_to_component(views.view_to_component_request)
 _view_to_component_args = view_to_component(views.view_to_component_args)
@@ -519,7 +518,9 @@ def view_to_component_template_view_class_compatibility():
 def view_to_iframe_args():
     return html.div(
         {"id": inspect.currentframe().f_code.co_name},  # type: ignore
-        _view_to_iframe_args("Arg1", "Arg2", kwarg1="Kwarg1", kwarg2="Kwarg2"),
+        view_to_iframe(
+            views.view_to_iframe_args, "Arg1", "Arg2", kwarg1="Kwarg1", kwarg2="Kwarg2"
+        ),
     )
 
 

From afe31ac8aa84bbddd49a0998caa18b018bb373dd Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sat, 23 Sep 2023 01:37:18 -0700
Subject: [PATCH 07/28] update docs

---
 CHANGELOG.md                           |   4 +-
 docs/python/hello_world_args_kwargs.py |   5 +
 docs/python/hello_world_cbv.py         |   7 ++
 docs/python/hello_world_fbv.py         |   5 +
 docs/python/hello_world_fbv_with_id.py |   5 +
 docs/python/views.py                   |   7 ++
 docs/python/vtc-args-kwargs.py         |  21 ----
 docs/python/vtc-args.py                |  23 ++++
 docs/python/vtc-cbv-compatibility.py   |  10 --
 docs/python/vtc-cbv.py                 |  12 +-
 docs/python/vtc-compatibility.py       |  15 ---
 docs/python/vtc-fbv-compat.py          |   8 --
 docs/python/vtc-func.py                |  12 --
 docs/python/vtc-request.py             |  20 ---
 docs/python/vtc-strict-parsing.py      |   8 +-
 docs/python/vtc-transforms.py          |  13 +-
 docs/python/vtc.py                     |   8 +-
 docs/python/vti-args.py                |  17 +++
 docs/python/vti-cbv.py                 |  11 ++
 docs/python/vti-extra-props.py         |  11 ++
 docs/python/vti.py                     |  11 ++
 docs/src/reference/components.md       | 167 +++++++++++++++----------
 22 files changed, 223 insertions(+), 177 deletions(-)
 create mode 100644 docs/python/hello_world_args_kwargs.py
 create mode 100644 docs/python/hello_world_cbv.py
 create mode 100644 docs/python/hello_world_fbv.py
 create mode 100644 docs/python/hello_world_fbv_with_id.py
 create mode 100644 docs/python/views.py
 delete mode 100644 docs/python/vtc-args-kwargs.py
 create mode 100644 docs/python/vtc-args.py
 delete mode 100644 docs/python/vtc-cbv-compatibility.py
 delete mode 100644 docs/python/vtc-compatibility.py
 delete mode 100644 docs/python/vtc-fbv-compat.py
 delete mode 100644 docs/python/vtc-func.py
 delete mode 100644 docs/python/vtc-request.py
 create mode 100644 docs/python/vti-args.py
 create mode 100644 docs/python/vti-cbv.py
 create mode 100644 docs/python/vti-extra-props.py
 create mode 100644 docs/python/vti.py

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 62027875..423940d1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -39,6 +39,7 @@ Using the following categories, list your changes in this order:
 -   ReactPy components can now use SEO compatible rendering!
     -   `settings.py:REACTPY_PRERENDER` can be set to `True` to enable this behavior by default
     -   Or, you can enable it on individual components via the template tag: `{% component "..." prerender="True" %}`
+-   `reactpy_django.components.view_to_iframe` component has been added, which uses an `<iframe>` to render a Django view.
 
 ### Changed
 
@@ -46,7 +47,8 @@ Using the following categories, list your changes in this order:
 
 ### Deprecated
 
--   The `compatibility` argument on `reactpy_django.components.view_to_component` is deprecated. Use `view_to_iframe_component` instead.
+-   The `compatibility` argument on `reactpy_django.components.view_to_component` is deprecated. Use `reactpy_django.components.view_to_iframe` instead.
+-   Using `reactpy_django.components.view_to_component` as a `#!python @decorator` is deprecated. Check the docs on the new suggested usage.
 
 ## [3.5.1] - 2023-09-07
 
diff --git a/docs/python/hello_world_args_kwargs.py b/docs/python/hello_world_args_kwargs.py
new file mode 100644
index 00000000..890148dd
--- /dev/null
+++ b/docs/python/hello_world_args_kwargs.py
@@ -0,0 +1,5 @@
+from django.http import HttpResponse
+
+
+def hello_world(request, arg1, arg2, key1=None, key2=None):
+    return HttpResponse(f"Hello World! {arg1} {arg2} {key1} {key2}")
diff --git a/docs/python/hello_world_cbv.py b/docs/python/hello_world_cbv.py
new file mode 100644
index 00000000..15850e94
--- /dev/null
+++ b/docs/python/hello_world_cbv.py
@@ -0,0 +1,7 @@
+from django.http import HttpResponse
+from django.views import View
+
+
+class HelloWorld(View):
+    def get(self, request):
+        return HttpResponse("Hello World!")
diff --git a/docs/python/hello_world_fbv.py b/docs/python/hello_world_fbv.py
new file mode 100644
index 00000000..25e52040
--- /dev/null
+++ b/docs/python/hello_world_fbv.py
@@ -0,0 +1,5 @@
+from django.http import HttpResponse
+
+
+def hello_world(request):
+    return HttpResponse("Hello World!")
diff --git a/docs/python/hello_world_fbv_with_id.py b/docs/python/hello_world_fbv_with_id.py
new file mode 100644
index 00000000..03a67b08
--- /dev/null
+++ b/docs/python/hello_world_fbv_with_id.py
@@ -0,0 +1,5 @@
+from django.http import HttpResponse
+
+
+def hello_world(request):
+    return HttpResponse('<div id="hello-world"> Hello World! </div>')
diff --git a/docs/python/views.py b/docs/python/views.py
new file mode 100644
index 00000000..60ebc945
--- /dev/null
+++ b/docs/python/views.py
@@ -0,0 +1,7 @@
+from .hello_world_cbv import HelloWorld
+from .hello_world_fbv import hello_world
+
+__all__ = [
+    "HelloWorld",
+    "hello_world",
+]
diff --git a/docs/python/vtc-args-kwargs.py b/docs/python/vtc-args-kwargs.py
deleted file mode 100644
index e4973e6b..00000000
--- a/docs/python/vtc-args-kwargs.py
+++ /dev/null
@@ -1,21 +0,0 @@
-from django.http import HttpResponse
-from reactpy import component, html
-from reactpy_django.components import view_to_component
-
-
-@view_to_component
-def hello_world_view(request, arg1, arg2, key1=None, key2=None):
-    return HttpResponse(f"Hello World! {arg1} {arg2} {key1} {key2}")
-
-
-@component
-def my_component():
-    return html.div(
-        hello_world_view(
-            None,  # Your request object (optional)
-            "value_1",
-            "value_2",
-            key1="abc",
-            key2="123",
-        ),
-    )
diff --git a/docs/python/vtc-args.py b/docs/python/vtc-args.py
new file mode 100644
index 00000000..19783121
--- /dev/null
+++ b/docs/python/vtc-args.py
@@ -0,0 +1,23 @@
+from django.http import HttpRequest
+from reactpy import component, html
+from reactpy_django.components import view_to_component
+
+from . import views
+
+hello_world_component = view_to_component(views.hello_world)
+
+
+@component
+def my_component():
+    request = HttpRequest()
+    request.method = "GET"
+
+    return html.div(
+        hello_world_component(
+            request,  # This request object is optional.
+            "value_1",
+            "value_2",
+            key1="abc",
+            key2="123",
+        ),
+    )
diff --git a/docs/python/vtc-cbv-compatibility.py b/docs/python/vtc-cbv-compatibility.py
deleted file mode 100644
index aa616cf8..00000000
--- a/docs/python/vtc-cbv-compatibility.py
+++ /dev/null
@@ -1,10 +0,0 @@
-from django.contrib.auth.decorators import user_passes_test
-from django.utils.decorators import method_decorator
-from django.views.generic import TemplateView
-from reactpy_django.components import view_to_component
-
-
-@view_to_component(compatibility=True)
-@method_decorator(user_passes_test(lambda u: u.is_superuser), name="dispatch")  # type: ignore[union-attr]
-class ExampleView(TemplateView):
-    ...
diff --git a/docs/python/vtc-cbv.py b/docs/python/vtc-cbv.py
index a0b2fe45..244ad026 100644
--- a/docs/python/vtc-cbv.py
+++ b/docs/python/vtc-cbv.py
@@ -1,19 +1,13 @@
-from django.http import HttpResponse
-from django.views import View
 from reactpy import component, html
 from reactpy_django.components import view_to_component
 
+from . import views
 
-class HelloWorldView(View):
-    def get(self, request):
-        return HttpResponse("Hello World!")
-
-
-vtc = view_to_component(HelloWorldView)
+hello_world_component = view_to_component(views.HelloWorld)
 
 
 @component
 def my_component():
     return html.div(
-        vtc(),
+        hello_world_component(),
     )
diff --git a/docs/python/vtc-compatibility.py b/docs/python/vtc-compatibility.py
deleted file mode 100644
index 93d15536..00000000
--- a/docs/python/vtc-compatibility.py
+++ /dev/null
@@ -1,15 +0,0 @@
-from django.http import HttpResponse
-from reactpy import component, html
-from reactpy_django.components import view_to_component
-
-
-@view_to_component(compatibility=True)
-def hello_world_view(request):
-    return HttpResponse("Hello World!")
-
-
-@component
-def my_component():
-    return html.div(
-        hello_world_view(),
-    )
diff --git a/docs/python/vtc-fbv-compat.py b/docs/python/vtc-fbv-compat.py
deleted file mode 100644
index 6ef3e40a..00000000
--- a/docs/python/vtc-fbv-compat.py
+++ /dev/null
@@ -1,8 +0,0 @@
-from django.contrib.auth.decorators import user_passes_test
-from reactpy_django.components import view_to_component
-
-
-@view_to_component(compatibility=True)
-@user_passes_test(lambda u: u.is_superuser)  # type: ignore[union-attr]
-def example_view(request):
-    ...
diff --git a/docs/python/vtc-func.py b/docs/python/vtc-func.py
deleted file mode 100644
index 82f1bcd0..00000000
--- a/docs/python/vtc-func.py
+++ /dev/null
@@ -1,12 +0,0 @@
-from example.views import example_view
-from reactpy import component, html
-from reactpy_django.components import view_to_component
-
-example_vtc = view_to_component(example_view)
-
-
-@component
-def my_component():
-    return html.div(
-        example_vtc(),
-    )
diff --git a/docs/python/vtc-request.py b/docs/python/vtc-request.py
deleted file mode 100644
index cf3d3cb0..00000000
--- a/docs/python/vtc-request.py
+++ /dev/null
@@ -1,20 +0,0 @@
-from django.http import HttpRequest, HttpResponse
-from reactpy import component, html
-from reactpy_django.components import view_to_component
-
-example_request = HttpRequest()
-example_request.method = "PUT"
-
-
-@view_to_component
-def hello_world_view(request):
-    return HttpResponse(f"Hello World! {request.method}")
-
-
-@component
-def my_component():
-    return html.div(
-        hello_world_view(
-            example_request,
-        ),
-    )
diff --git a/docs/python/vtc-strict-parsing.py b/docs/python/vtc-strict-parsing.py
index d4da513c..194d35cc 100644
--- a/docs/python/vtc-strict-parsing.py
+++ b/docs/python/vtc-strict-parsing.py
@@ -1,15 +1,13 @@
-from django.http import HttpResponse
 from reactpy import component, html
 from reactpy_django.components import view_to_component
 
+from . import views
 
-@view_to_component(strict_parsing=False)
-def hello_world_view(request):
-    return HttpResponse("<my-tag> Hello World </my-tag>")
+hello_world_component = view_to_component(views.hello_world)
 
 
 @component
 def my_component():
     return html.div(
-        hello_world_view(),
+        hello_world_component(),
     )
diff --git a/docs/python/vtc-transforms.py b/docs/python/vtc-transforms.py
index 3d8c716a..adbf9ea1 100644
--- a/docs/python/vtc-transforms.py
+++ b/docs/python/vtc-transforms.py
@@ -1,21 +1,22 @@
-from django.http import HttpResponse
 from reactpy import component, html
 from reactpy_django.components import view_to_component
 
+from . import views
+
 
 def example_transform(vdom):
     attributes = vdom.get("attributes")
     if attributes and attributes.get("id") == "hello-world":
-        vdom["children"][0] = "Good Bye World!"
+        vdom["children"][0] = "Farewell World!"
 
 
-@view_to_component(transforms=[example_transform])
-def hello_world_view(request):
-    return HttpResponse("<div id='hello-world'> Hello World! <div>")
+hello_world_component = view_to_component(
+    views.hello_world, transforms=[example_transform]
+)
 
 
 @component
 def my_component():
     return html.div(
-        hello_world_view(),
+        hello_world_component(),
     )
diff --git a/docs/python/vtc.py b/docs/python/vtc.py
index 92fea793..194d35cc 100644
--- a/docs/python/vtc.py
+++ b/docs/python/vtc.py
@@ -1,15 +1,13 @@
-from django.http import HttpResponse
 from reactpy import component, html
 from reactpy_django.components import view_to_component
 
+from . import views
 
-@view_to_component
-def hello_world_view(request):
-    return HttpResponse("Hello World!")
+hello_world_component = view_to_component(views.hello_world)
 
 
 @component
 def my_component():
     return html.div(
-        hello_world_view(),
+        hello_world_component(),
     )
diff --git a/docs/python/vti-args.py b/docs/python/vti-args.py
new file mode 100644
index 00000000..f9c20469
--- /dev/null
+++ b/docs/python/vti-args.py
@@ -0,0 +1,17 @@
+from reactpy import component, html
+from reactpy_django.components import view_to_iframe
+
+from . import views
+
+
+@component
+def my_component():
+    return html.div(
+        view_to_iframe(
+            views.hello_world,
+            "value_1",
+            "value_2",
+            key1="abc",
+            key2="123",
+        ),
+    )
diff --git a/docs/python/vti-cbv.py b/docs/python/vti-cbv.py
new file mode 100644
index 00000000..81909bb9
--- /dev/null
+++ b/docs/python/vti-cbv.py
@@ -0,0 +1,11 @@
+from reactpy import component, html
+from reactpy_django.components import view_to_iframe
+
+from . import views
+
+
+@component
+def my_component():
+    return html.div(
+        view_to_iframe(views.HelloWorld),
+    )
diff --git a/docs/python/vti-extra-props.py b/docs/python/vti-extra-props.py
new file mode 100644
index 00000000..bc2de6dd
--- /dev/null
+++ b/docs/python/vti-extra-props.py
@@ -0,0 +1,11 @@
+from reactpy import component, html
+from reactpy_django.components import view_to_iframe
+
+from . import views
+
+
+@component
+def my_component():
+    return html.div(
+        view_to_iframe(views.hello_world, extra_props={"title": "Hello World!"}),
+    )
diff --git a/docs/python/vti.py b/docs/python/vti.py
new file mode 100644
index 00000000..ff5bd243
--- /dev/null
+++ b/docs/python/vti.py
@@ -0,0 +1,11 @@
+from reactpy import component, html
+from reactpy_django.components import view_to_iframe
+
+from . import views
+
+
+@component
+def my_component():
+    return html.div(
+        view_to_iframe(views.hello_world),
+    )
diff --git a/docs/src/reference/components.md b/docs/src/reference/components.md
index b2eb4fe0..39cc806c 100644
--- a/docs/src/reference/components.md
+++ b/docs/src/reference/components.md
@@ -10,7 +10,9 @@ We supply some pre-designed that components can be used to help simplify develop
 
 ## View To Component
 
-Automatically convert a Django view into a ReactPy component.
+Automatically convert a Django view into a component.
+
+At this time, this component works best with static views that do not rely on HTTP methods other than `GET`.
 
 Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/topics/http/views/) and [Class Based Views](https://docs.djangoproject.com/en/dev/topics/class-based-views/). These views can be sync or async.
 
@@ -20,6 +22,12 @@ Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/top
     {% include "../../python/vtc.py" %}
     ```
 
+=== "views.py"
+
+    ```python
+    {% include "../../python/hello_world_fbv.py" %}
+    ```
+
 ??? example "See Interface"
 
     <font size="4">**Parameters**</font>
@@ -41,104 +49,110 @@ Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/top
 
     There are currently several limitations of using `#!python view_to_component` that may be resolved in a future version.
 
-    - Requires manual intervention to change request methods beyond `GET`.
+    - Requires manual intervention to change HTTP methods to anything other than `GET`.
     - ReactPy events cannot conveniently be attached to converted view HTML.
     - Has no option to automatically intercept local anchor link (such as `#!html <a href='example/'></a>`) click events.
 
-??? question "How do I customize this component's behavior?"
+??? question "How do I use this for Class Based Views?"
 
-    This component accepts several `kwargs` that can be used to customize its behavior.
+    Class Based Views are accepted by `#!python view_to_component` as an argument. For example...
 
-    Below are all the `kwargs` that can be used.
+    === "components.py"
 
-    ---
+        ```python
+        {% include "../../python/vtc-cbv.py" %}
+        ```
 
-    <font size="4">**`#!python strict_parsing`**</font>
+    === "views.py"
 
-    By default, an exception will be generated if your view's HTML does not perfectly adhere to HTML5.
+        ```python
+        {% include "../../python/hello_world_cbv.py" %}
+        ```
 
-    However, there are some circumstances where you may not have control over the original HTML, so you may be unable to fix it. Or you may be relying on non-standard HTML tags such as `#!html <my-tag> Hello World </my-tag>`.
+??? question "How do I provide `#!python request`, `#!python args`, and `#!python kwargs` to a converted view?"
 
-    In these scenarios, you may want to rely on best-fit parsing by setting the `#!python strict_parsing` parameter to `#!python False`. This uses `libxml2` recovery algorithm, which is designed to be similar to how web browsers would attempt to parse non-standard or broken HTML.
+    This component accepts `#!python request`, `#!python *args`, and `#!python **kwargs` arguments, which are sent to your provided view.
 
     === "components.py"
 
         ```python
-        {% include "../../python/vtc-strict-parsing.py" %}
+        {% include "../../python/vtc-args.py" %}
         ```
 
-    ---
-
-    <font size="4">**`#!python transforms`**</font>
+??? question "How do I customize this component's behavior?"
 
-    After your view has been turned into [VDOM](https://reactpy.dev/docs/reference/specifications.html#vdom) (python dictionaries), `#!python view_to_component` will call your `#!python transforms` functions on every VDOM node.
+    This component accepts arguments that can be used to customize its behavior.
 
-    This allows you to modify your view prior to rendering.
+    Below are all the arguments that can be used.
 
-    For example, if you are trying to modify the text of a node with a certain `#!python id`, you can create a transform like such:
+    ---
 
-    === "components.py"
+    <font size="4">**`#!python strict_parsing`**</font>
 
-        ```python
-        {% include "../../python/vtc-transforms.py" %}
-        ```
+    By default, an exception will be generated if your view's HTML does not perfectly adhere to HTML5.
 
-??? question "How do I use this for Class Based Views?"
+    However, there are some circumstances where you may not have control over the original HTML, so you may be unable to fix it. Or you may be relying on non-standard HTML tags such as `#!html <my-tag> Hello World </my-tag>`.
 
-    You can simply pass your Class Based View directly into `#!python view_to_component`.
+    In these scenarios, you may want to rely on best-fit parsing by setting the `#!python strict_parsing` parameter to `#!python False`. This uses `libxml2` recovery algorithm, which is designed to be similar to how web browsers would attempt to parse non-standard or broken HTML.
 
     === "components.py"
 
         ```python
-        {% include "../../python/vtc-cbv.py" %}
+        {% include "../../python/vtc-strict-parsing.py" %}
         ```
 
-??? question "How do I transform views from external libraries?"
-
-    In order to convert external views, you can utilize `#!python view_to_component` as a function, rather than a decorator.
-
-    === "components.py"
+    === "views.py"
 
         ```python
-        {% include "../../python/vtc-func.py" %}
+        {% include "../../python/hello_world_fbv.py" %}
         ```
 
-??? question "How do I provide `#!python request`, `#!python args`, and `#!python kwargs` to a view?"
+    ---
 
-    <font size="4">**`#!python Request`**</font>
+    <font size="4">**`#!python transforms`**</font>
 
-    You can use the `#!python request` parameter to provide the view a custom request object.
+    After your view has been turned into [VDOM](https://reactpy.dev/docs/reference/specifications.html#vdom) (python dictionaries), `#!python view_to_component` will call your `#!python transforms` functions on every VDOM node.
+
+    This allows you to modify your view prior to rendering.
+
+    For example, if you are trying to modify the text of a node with a certain `#!python id`, you can create a transform like such:
 
     === "components.py"
 
         ```python
-        {% include "../../python/vtc-request.py" %}
+        {% include "../../python/vtc-transforms.py" %}
         ```
 
-    ---
-
-    <font size="4">**`#!python args` and `#!python kwargs`**</font>
-
-    You can use the `#!python args` and `#!python kwargs` parameters to provide positional and keyworded arguments to a view.
-
-    === "components.py"
+    === "views.py"
 
         ```python
-        {% include "../../python/vtc-args-kwargs.py" %}
+        {% include "../../python/hello_world_fbv_with_id.py" %}
         ```
 
 ## View To Iframe
 
-Automatically convert a Django view into an `iframe`.
+Automatically convert a Django view into an [`iframe` element](https://www.techtarget.com/whatis/definition/IFrame-Inline-Frame).
 
-The contents of this `iframe` is handled entirely by traditional Django view rendering. While this solution is compatible with more views than `view_to_component`, it comes with different limitations.
+The contents of this `#!python iframe` is handled entirely by traditional Django view rendering. While this solution is compatible with more views than `#!python view_to_component`, it comes with different limitations.
 
 Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/topics/http/views/) and [Class Based Views](https://docs.djangoproject.com/en/dev/topics/class-based-views/). These views can be sync or async.
 
+!!! Warning "Pitfall"
+
+    When using this component, ReactPy automatically exposes a URL to your view. If your view contains sensitive information, you must ensure only authorized users can access this view.
+
+    This can be done via directly writing conditionals into your view, or by using [Django's `user_passes_test`](https://docs.djangoproject.com/en/dev/topics/auth/default/#django.contrib.auth.decorators.user_passes_test).
+
 === "components.py"
 
     ```python
-    {% include "../../python/vtc-compatibility.py" %}
+    {% include "../../python/vti.py" %}
+    ```
+
+=== "views.py"
+
+    ```python
+    {% include "../../python/hello_world_fbv.py" %}
     ```
 
 ??? example "See Interface"
@@ -152,46 +166,69 @@ Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/top
 
     | Type | Description |
     | --- | --- |
-    | `#!python ViewToComponentConstructor` | A function that takes `#!python request, *args, key, **kwargs` and returns a ReactPy component. All parameters are directly provided to your view, besides `#!python key` which is used by ReactPy. |
 
-??? Warning "Potential information exposure when using this component"
+??? info "Existing limitations"
 
-    When using this component, ReactPy automatically exposes a URL to your view.
+    There are currently several limitations of using `#!python view_to_iframe` that may be resolved in a future version.
 
-    It is your responsibility to ensure privileged information is not leaked via this method.
+    - No built-in method of signalling events back to the parent component.
+    - All provided `#!python *args` and `#!python *kwargs` must be serializable values, since they are encoded into the URL.
+    - The `#!python iframe`'s contents will always load **after** the parent component.
+    - CSS styling for `#!python iframe` elements tends to be awkward/difficult.
 
-    You must implement a method to ensure only authorized users can access your view. This can be done via directly writing conditionals into your view, or by adding decorators such as [`#!python user_passes_test`](https://docs.djangoproject.com/en/dev/topics/auth/default/#django.contrib.auth.decorators.user_passes_test) to your views. For example...
+??? question "How do I use this for Class Based Views?"
 
-    === "Function Based View"
+    Class Based Views are accepted by `#!python view_to_iframe` as an argument. For example...
+
+    === "components.py"
 
         ```python
-        {% include "../../python/vtc-fbv-compat.py" %}
+        {% include "../../python/vti-cbv.py" %}
         ```
 
-    === "Class Based View"
+    === "views.py"
 
         ```python
-        {% include "../../python/vtc-cbv-compatibility.py" %}
+        {% include "../../python/hello_world_cbv.py" %}
         ```
 
-??? info "Existing limitations"
+??? question "How do I provide `#!python args` and `#!python kwargs` to a converted view?"
 
-    There are currently several limitations of using `#!python view_to_iframe` that may be resolved in a future version.
+    This component accepts `#!python *args` and `#!python **kwargs` arguments, which are sent to your provided view.
 
-    - Inability to signal events back to the parent component.
-    - You must ensure all `view_to_iframe` components are manually loaded during Django startup to ensure multiprocessing compatibility. This usually involves import the file where you define your `view_to_iframe` functions within your `MyAppConfig.ready` method.
-    - The `iframe` component will always load **after** the parent component.
-    - CSS styling restrictions inherent to `iframe` elements.
+    All provided `#!python *args` and `#!python *kwargs` must be serializable values, since they are encoded into the URL.
 
-??? Question "Why do my converted components look ugly?"
+    === "components.py"
 
-    The `iframe` generated by this component is unstyled, and thus won't look pretty until you add some CSS.
+        ```python
+        {% include "../../python/vti-args.py" %}
+        ```
 
-    We recommend removing the `border`, and configuring a `height` and `width`.
+    === "views.py"
+
+        ```python
+        {% include "../../python/hello_world_fbv.py" %}
+        ```
+
+??? question "How do I customize this component's behavior?"
 
-??? question "How do I provide `#!python args` and `#!python kwargs` to a view?"
+    This component accepts arguments that can be used to customize its behavior.
 
-    ...
+    Below are all the arguments that can be used.
+
+    ---
+
+    <font size="4">**`#!python extra_props`**</font>
+
+    This component accepts a `#!python extra_props` parameter, which is a dictionary of additional properties to add to the `#!python iframe` element.
+
+    For example, if you want to add a `#!python title` attribute to the `#!python iframe` element, you can do so like such:
+
+    === "components.py"
+
+        ```python
+        {% include "../../python/vti-extra-props.py" %}
+        ```
 
 ## Django CSS
 

From 1b466641a885b884cb48756776f868c5b5ffc87d Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sat, 23 Sep 2023 02:09:11 -0700
Subject: [PATCH 08/28] Auto height and width

---
 src/reactpy_django/components.py | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/src/reactpy_django/components.py b/src/reactpy_django/components.py
index b6cd9837..f134a737 100644
--- a/src/reactpy_django/components.py
+++ b/src/reactpy_django/components.py
@@ -113,9 +113,7 @@ def view_to_component(
 
     Keyword Args:
         view: The view function or class to convert.
-        compatibility: If True, the component will be rendered in an iframe. \
-            When using compatibility mode `tranforms`, `strict_parsing`, `request`, \
-            `args, and `kwargs` arguments will be ignored.
+        compatibility: **DEPRECATED.** Use `view_to_iframe` instead.
         transforms: A list of functions that transforms the newly generated VDOM. \
             The functions will be called on each VDOM node.
         strict_parsing: If True, an exception will be generated if the HTML does not \
@@ -161,7 +159,7 @@ def wrapper(
 
 @component
 def _view_to_iframe(
-    view: Callable | View, *args, extra_props: dict | None = None, **kwargs
+    view: Callable | View, *args, extra_props: dict[str, Any] | None = None, **kwargs
 ) -> VdomDict:
     from reactpy_django.config import REACTPY_REGISTERED_IFRAMES
 
@@ -179,7 +177,8 @@ def _view_to_iframe(
     return html.iframe(
         {
             "src": reverse("reactpy:view_to_iframe", args=[dotted_path]) + query_string,
-            "style": {"border": "none", "width": "100%", "height": "auto"},
+            "style": {"border": "none"},
+            "onload": 'javascript:(function(o){o.style.height=o.contentWindow.document.body.scrollHeight+"px";}(this));',
             "loading": "lazy",
         }
         | extra_props
@@ -187,10 +186,19 @@ def _view_to_iframe(
 
 
 def view_to_iframe(
-    view: Callable | View, *args, extra_props: dict | None = None, **kwargs
+    view: Callable | View, *args, extra_props: dict[str, Any] | None = None, **kwargs
 ) -> ComponentType:
     """
-    TODO: Fill this out
+    Args:
+        view: The view function or class to convert.
+        *args: The positional arguments to provide to the view.
+
+    Keyword Args:
+        extra_props: Additional properties to add to the `iframe` element.
+        **kwargs: The keyword arguments to provide to the view.
+
+    Returns:
+        A `Component` that renders the view within an `iframe`.
     """
     return _view_to_iframe(view, *args, extra_props=extra_props, **kwargs)
 

From 38799cee844853d87a6233eb918b8911b588513b Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sat, 23 Sep 2023 02:09:19 -0700
Subject: [PATCH 09/28] interface docs

---
 docs/src/reference/components.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/docs/src/reference/components.md b/docs/src/reference/components.md
index 39cc806c..66e2867f 100644
--- a/docs/src/reference/components.md
+++ b/docs/src/reference/components.md
@@ -35,7 +35,6 @@ Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/top
     | Name | Type | Description | Default |
     | --- | --- | --- | --- |
     | `#!python view` | `#!python Callable | View` | The view function or class to convert. | N/A |
-    | `#!python compatibility` | `#!python bool` | If `#!python True`, the component will be rendered in an `iframe`. When using compatibility mode `#!python tranforms`, `#!python strict_parsing`, `#!python request`, `#!python args`, and `#!python kwargs` arguments will be ignored. | `#!python False` |
     | `#!python transforms` | `#!python Sequence[Callable[[VdomDict], Any]]` | A list of functions that transforms the newly generated VDOM. The functions will be called on each VDOM node. | `#!python tuple` |
     | `#!python strict_parsing` | `#!python bool` | If `#!python True`, an exception will be generated if the HTML does not perfectly adhere to HTML5. | `#!python True` |
 
@@ -161,11 +160,17 @@ Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/top
 
     | Name | Type | Description | Default |
     | --- | --- | --- | --- |
+    | `#!python view` | `#!python Callable | View` | The view function or class to convert. | N/A |
+    | `#!python *args` | `#!python Sequence[Any]` | A list of arguments to provide to your view. | N/A |
+    | `#!python extra_props` | `#!python Mapping[str, Any] | None` | Additional properties to add to the `iframe` element. | `#!python None` |
+    | `#!python **kwargs` | `#!python dict[str, Any]` | A dictionary of keyword arguments to provide to your view. | N/A |
+
 
     <font size="4">**Returns**</font>
 
     | Type | Description |
     | --- | --- |
+    | `#!python ComponentType` | A ReactPy `iframe` component. |
 
 ??? info "Existing limitations"
 

From b45f7a958815f0713d8645c4b20eb7be9e09f33c Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sat, 23 Sep 2023 22:23:50 -0700
Subject: [PATCH 10/28] register_iframe function

---
 CHANGELOG.md                                  |  1 +
 src/reactpy_django/checks.py                  |  2 +-
 src/reactpy_django/components.py              | 60 +++++++++++++------
 src/reactpy_django/config.py                  |  2 +-
 src/reactpy_django/exceptions.py              |  4 ++
 src/reactpy_django/http/urls.py               |  2 +-
 src/reactpy_django/http/views.py              | 12 ++--
 .../templates/reactpy/component.html          |  2 +-
 src/reactpy_django/types.py                   | 15 ++++-
 src/reactpy_django/utils.py                   | 15 +++++
 tests/test_app/apps.py                        | 17 ++++++
 tests/test_app/components.py                  |  5 +-
 12 files changed, 103 insertions(+), 34 deletions(-)
 create mode 100644 tests/test_app/apps.py

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 423940d1..75e872f4 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -40,6 +40,7 @@ Using the following categories, list your changes in this order:
     -   `settings.py:REACTPY_PRERENDER` can be set to `True` to enable this behavior by default
     -   Or, you can enable it on individual components via the template tag: `{% component "..." prerender="True" %}`
 -   `reactpy_django.components.view_to_iframe` component has been added, which uses an `<iframe>` to render a Django view.
+-   `reactpy_django.utils.register_iframe` function has been added, which is mandatory to use alongside `reactpy_django.components.view_to_iframe`.
 
 ### Changed
 
diff --git a/src/reactpy_django/checks.py b/src/reactpy_django/checks.py
index 77bb4153..02f3147a 100644
--- a/src/reactpy_django/checks.py
+++ b/src/reactpy_django/checks.py
@@ -39,7 +39,7 @@ def reactpy_warnings(app_configs, **kwargs):
     # ReactPy URLs exist
     try:
         reverse("reactpy:web_modules", kwargs={"file": "example"})
-        reverse("reactpy:view_to_iframe", kwargs={"view_path": "example"})
+        reverse("reactpy:view_to_iframe", kwargs={"dotted_path": "example"})
     except Exception:
         warnings.append(
             Warning(
diff --git a/src/reactpy_django/components.py b/src/reactpy_django/components.py
index f134a737..1ba3ba35 100644
--- a/src/reactpy_django/components.py
+++ b/src/reactpy_django/components.py
@@ -12,9 +12,10 @@
 from django.urls import reverse
 from django.views import View
 from reactpy import component, hooks, html, utils
-from reactpy.types import ComponentType, Key, VdomDict
+from reactpy.types import Key, VdomDict
 
-from reactpy_django.types import ViewToComponentConstructor
+from reactpy_django.exceptions import ComponentNotRegisteredError
+from reactpy_django.types import ViewToComponentConstructor, ViewToIframeConstructor
 from reactpy_django.utils import generate_obj_name, render_view
 
 
@@ -28,6 +29,7 @@ def _view_to_component(
     args: Sequence | None,
     kwargs: dict | None,
 ):
+    """The actual component. Used to prevent pollution of acceptable kwargs keys."""
     converted_view, set_converted_view = hooks.use_state(
         cast(Union[VdomDict, None], None)
     )
@@ -72,7 +74,7 @@ async def async_render():
             DeprecationWarning,
         )
 
-        return view_to_iframe(view, *_args, **_kwargs)
+        return view_to_iframe(view)(*_args, **_kwargs)
 
     # Return the view if it's been rendered via the `async_render` hook
     return converted_view
@@ -128,7 +130,7 @@ def decorator(view: Callable | View):
         if not view:
             raise ValueError("A view must be provided to `view_to_component`")
 
-        def wrapper(
+        def constructor(
             request: HttpRequest | None = None,
             *args: Any,
             key: Key | None = None,
@@ -145,7 +147,7 @@ def wrapper(
                 key=key,
             )
 
-        return wrapper
+        return constructor
 
     if not view:
         warn(
@@ -159,20 +161,32 @@ def wrapper(
 
 @component
 def _view_to_iframe(
-    view: Callable | View, *args, extra_props: dict[str, Any] | None = None, **kwargs
+    view: Callable | View | str,
+    extra_props: dict[str, Any] | None,
+    args: Sequence | None,
+    kwargs: dict | None,
 ) -> VdomDict:
-    from reactpy_django.config import REACTPY_REGISTERED_IFRAMES
+    """The actual component. Used to prevent pollution of acceptable kwargs keys."""
+    from reactpy_django.config import REACTPY_REGISTERED_IFRAME_VIEWS
 
-    dotted_path = generate_obj_name(view).replace("<", "").replace(">", "")
-    REACTPY_REGISTERED_IFRAMES[dotted_path] = view
-    extra_props = extra_props or {}
-    extra_props.pop("src", None)
+    if isinstance(view, str):
+        dotted_path = view
+    else:
+        dotted_path = generate_obj_name(view).replace("<", "").replace(">", "")
+    registered_view = REACTPY_REGISTERED_IFRAME_VIEWS.get(dotted_path)
+
+    if not registered_view:
+        raise ComponentNotRegisteredError(
+            f"'{dotted_path}' has not been registered as an iframe component! "
+            "Are you sure you called `register_iframe` within a Django `AppConfig.ready` method?"
+        )
 
     query = kwargs.copy()
     if args:
         query["_args"] = args
-
     query_string = f"?{urlencode(query, doseq=True)}" if args or kwargs else ""
+    extra_props = extra_props or {}
+    extra_props.pop("src", None)
 
     return html.iframe(
         {
@@ -186,21 +200,29 @@ def _view_to_iframe(
 
 
 def view_to_iframe(
-    view: Callable | View, *args, extra_props: dict[str, Any] | None = None, **kwargs
-) -> ComponentType:
+    view: Callable | View | str, extra_props: dict[str, Any] | None = None
+) -> ViewToIframeConstructor:
     """
     Args:
-        view: The view function or class to convert.
-        *args: The positional arguments to provide to the view.
+        view: The view function or class to convert, or the dotted path to the view.
 
     Keyword Args:
         extra_props: Additional properties to add to the `iframe` element.
-        **kwargs: The keyword arguments to provide to the view.
 
     Returns:
-        A `Component` that renders the view within an `iframe`.
+        A function that takes `*args: Any, key: Key | None, **kwargs: Any` and returns a ReactPy component.
     """
-    return _view_to_iframe(view, *args, extra_props=extra_props, **kwargs)
+
+    def constructor(
+        *args: Any,
+        key: Key | None = None,
+        **kwargs: Any,
+    ):
+        return _view_to_iframe(
+            view=view, extra_props=extra_props, args=args, kwargs=kwargs, key=key
+        )
+
+    return constructor
 
 
 @component
diff --git a/src/reactpy_django/config.py b/src/reactpy_django/config.py
index c0d8524d..e316e210 100644
--- a/src/reactpy_django/config.py
+++ b/src/reactpy_django/config.py
@@ -20,7 +20,7 @@
 REACTPY_DEBUG_MODE.set_current(getattr(settings, "DEBUG"))
 REACTPY_REGISTERED_COMPONENTS: dict[str, ComponentConstructor] = {}
 REACTPY_FAILED_COMPONENTS: set[str] = set()
-REACTPY_REGISTERED_IFRAMES: dict[str, Callable | View] = {}
+REACTPY_REGISTERED_IFRAME_VIEWS: dict[str, Callable | View] = {}
 
 
 # Remove in a future release
diff --git a/src/reactpy_django/exceptions.py b/src/reactpy_django/exceptions.py
index 49c6fef3..d2910ce8 100644
--- a/src/reactpy_django/exceptions.py
+++ b/src/reactpy_django/exceptions.py
@@ -12,3 +12,7 @@ class InvalidHostError(ValueError):
 
 class ComponentCarrierError(ValueError):
     ...
+
+
+class ComponentNotRegisteredError(ComponentDoesNotExistError):
+    ...
diff --git a/src/reactpy_django/http/urls.py b/src/reactpy_django/http/urls.py
index 8a466e3f..23bf4a7e 100644
--- a/src/reactpy_django/http/urls.py
+++ b/src/reactpy_django/http/urls.py
@@ -11,7 +11,7 @@
         name="web_modules",
     ),
     path(
-        "iframe/<str:view_path>",
+        "iframe/<str:dotted_path>",
         views.view_to_iframe,  # type: ignore[arg-type]
         name="view_to_iframe",
     ),
diff --git a/src/reactpy_django/http/views.py b/src/reactpy_django/http/views.py
index 87c1a837..983c8361 100644
--- a/src/reactpy_django/http/views.py
+++ b/src/reactpy_django/http/views.py
@@ -40,13 +40,13 @@ async def web_modules_file(request: HttpRequest, file: str) -> HttpResponse:
     return HttpResponse(file_contents, content_type="text/javascript")
 
 
-async def view_to_iframe(request: HttpRequest, view_path: str) -> HttpResponse:
+async def view_to_iframe(request: HttpRequest, dotted_path: str) -> HttpResponse:
     """Returns a view that was registered by reactpy_django.components.view_to_iframe."""
-    from reactpy_django.config import REACTPY_REGISTERED_IFRAMES
+    from reactpy_django.config import REACTPY_REGISTERED_IFRAME_VIEWS
 
-    # Get the view from REACTPY_REGISTERED_IFRAMES
-    iframe = REACTPY_REGISTERED_IFRAMES.get(view_path)
-    if not iframe:
+    # Get the view
+    registered_view = REACTPY_REGISTERED_IFRAME_VIEWS.get(dotted_path)
+    if not registered_view:
         return HttpResponseNotFound()
 
     # Get args and kwargs from the request
@@ -55,7 +55,7 @@ async def view_to_iframe(request: HttpRequest, view_path: str) -> HttpResponse:
     args = kwargs.pop("_args", [])
 
     # Render the view
-    response = await render_view(iframe, request, args, kwargs)
+    response = await render_view(registered_view, request, args, kwargs)
 
     # Ensure page can be rendered as an iframe
     response["X-Frame-Options"] = "SAMEORIGIN"
diff --git a/src/reactpy_django/templates/reactpy/component.html b/src/reactpy_django/templates/reactpy/component.html
index 1a6b4669..052dc517 100644
--- a/src/reactpy_django/templates/reactpy/component.html
+++ b/src/reactpy_django/templates/reactpy/component.html
@@ -1,7 +1,7 @@
 {% load static %}
 
 {% if reactpy_failure and reactpy_debug_mode %}
-<b>{% firstof reactpy_error "UnknownError" %}:</b> "{% firstof reactpy_dotted_path "UnknownPath" %}"
+<pre>{% firstof reactpy_error "UnknownError" %}: "{% firstof reactpy_dotted_path "UnknownPath" %}"</pre>
 {% endif %}
 
 {% if not reactpy_failure %}
diff --git a/src/reactpy_django/types.py b/src/reactpy_django/types.py
index 2be95e7a..b4cb9290 100644
--- a/src/reactpy_django/types.py
+++ b/src/reactpy_django/types.py
@@ -17,7 +17,7 @@
 from django.db.models.base import Model
 from django.db.models.query import QuerySet
 from django.http import HttpRequest
-from reactpy.types import ComponentType
+from reactpy.types import ComponentType, Key
 from reactpy.types import Connection as _Connection
 from typing_extensions import ParamSpec
 
@@ -130,6 +130,17 @@ class ComponentParams:
 
 class ViewToComponentConstructor(Protocol):
     def __call__(
-        self, request: HttpRequest | None = None, *args: Any, **kwargs: Any
+        self,
+        request: HttpRequest | None = None,
+        *args: Any,
+        key: Key | None = None,
+        **kwargs: Any,
+    ) -> ComponentType:
+        ...
+
+
+class ViewToIframeConstructor(Protocol):
+    def __call__(
+        self, *args: Any, key: Key | None = None, **kwargs: Any
     ) -> ComponentType:
         ...
diff --git a/src/reactpy_django/utils.py b/src/reactpy_django/utils.py
index 143f69ff..063716ff 100644
--- a/src/reactpy_django/utils.py
+++ b/src/reactpy_django/utils.py
@@ -105,6 +105,21 @@ def register_component(dotted_path: str) -> ComponentConstructor:
     return REACTPY_REGISTERED_COMPONENTS[dotted_path]
 
 
+def register_iframe(view: Callable | View | str):
+    """Registers a view to be used as an iframe component."""
+    from reactpy_django.config import REACTPY_REGISTERED_IFRAME_VIEWS
+
+    resolved_view: Callable | View
+    if isinstance(view, str):
+        resolved_view = import_dotted_path(view)
+        dotted_path = view
+    else:
+        resolved_view = view
+        dotted_path = generate_obj_name(view).replace("<", "").replace(">", "")
+
+    REACTPY_REGISTERED_IFRAME_VIEWS[dotted_path] = resolved_view
+
+
 def import_dotted_path(dotted_path: str) -> Callable:
     """Imports a dotted path and returns the callable."""
     module_name, component_name = dotted_path.rsplit(".", 1)
diff --git a/tests/test_app/apps.py b/tests/test_app/apps.py
new file mode 100644
index 00000000..9cad19ab
--- /dev/null
+++ b/tests/test_app/apps.py
@@ -0,0 +1,17 @@
+from django.apps import AppConfig
+from reactpy_django.utils import register_iframe
+
+from test_app import views
+
+
+class TestAppConfig(AppConfig):
+    name = "test_app"
+
+    def ready(self):
+        # Populate the ReactPy component registry when Django is ready
+        register_iframe("test_app.views.view_to_component_sync_func_compatibility")
+        register_iframe(views.view_to_component_async_func_compatibility)
+        register_iframe(views.ViewToComponentSyncClassCompatibility)
+        register_iframe(views.ViewToComponentAsyncClassCompatibility)
+        register_iframe(views.ViewToComponentTemplateViewClassCompatibility)
+        register_iframe(views.view_to_iframe_args)
diff --git a/tests/test_app/components.py b/tests/test_app/components.py
index 444d49d8..db118343 100644
--- a/tests/test_app/components.py
+++ b/tests/test_app/components.py
@@ -468,6 +468,7 @@ async def on_change(event):
 _view_to_component_template_view_class_compatibility = view_to_component(
     views.ViewToComponentTemplateViewClassCompatibility, compatibility=True
 )
+_view_to_iframe_args = view_to_iframe(views.view_to_iframe_args)
 view_to_component_script = view_to_component(views.view_to_component_script)
 _view_to_component_request = view_to_component(views.view_to_component_request)
 _view_to_component_args = view_to_component(views.view_to_component_args)
@@ -518,9 +519,7 @@ def view_to_component_template_view_class_compatibility():
 def view_to_iframe_args():
     return html.div(
         {"id": inspect.currentframe().f_code.co_name},  # type: ignore
-        view_to_iframe(
-            views.view_to_iframe_args, "Arg1", "Arg2", kwarg1="Kwarg1", kwarg2="Kwarg2"
-        ),
+        _view_to_iframe_args("Arg1", "Arg2", kwarg1="Kwarg1", kwarg2="Kwarg2"),
     )
 
 

From 8ac34157cf3d60abaa125c58a5b415945c870bfb Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sat, 23 Sep 2023 22:37:16 -0700
Subject: [PATCH 11/28] move error tests to their own URL

---
 tests/test_app/templates/base.html      | 18 ++------
 tests/test_app/templates/errors.html    | 28 +++++++++++++
 tests/test_app/tests/test_components.py | 56 ++++++++++++++-----------
 tests/test_app/urls.py                  |  1 +
 tests/test_app/views.py                 |  4 ++
 5 files changed, 68 insertions(+), 39 deletions(-)
 create mode 100644 tests/test_app/templates/errors.html

diff --git a/tests/test_app/templates/base.html b/tests/test_app/templates/base.html
index f2042fd4..a10e2b33 100644
--- a/tests/test_app/templates/base.html
+++ b/tests/test_app/templates/base.html
@@ -71,6 +71,10 @@ <h1>ReactPy Test Page</h1>
   <hr>
   {% component "test_app.components.view_to_component_kwargs" %}
   <hr>
+  {% component "test_app.components.view_to_component_decorator" %}
+  <hr>
+  {% component "test_app.components.view_to_component_decorator_args" %}
+  <hr>
   {% component "test_app.components.view_to_component_sync_func_compatibility" %}
   <hr>
   {% component "test_app.components.view_to_component_async_func_compatibility" %}
@@ -83,20 +87,6 @@ <h1>ReactPy Test Page</h1>
   <hr>
   {% component "test_app.components.view_to_iframe_args" %}
   <hr>
-  {% component "test_app.components.view_to_component_decorator" %}
-  <hr>
-  {% component "test_app.components.view_to_component_decorator_args" %}
-  <hr>
-  <div id="component_does_not_exist_error">{% component "test_app.components.does_not_exist" %}</div>
-  <hr>
-  <div id="component_param_error">{% component "test_app.components.hello_world" invalid_param="random_value" %}</div>
-  <hr>
-  <div id="invalid_host_error">{% component "test_app.components.hello_world" host="https://example.com/" %}</div>
-  <hr>
-  <div id="broken_postprocessor_query">
-    {% component "test_app.components.broken_postprocessor_query" %}
-  </div>
-  <hr>
 </body>
 
 </html>
diff --git a/tests/test_app/templates/errors.html b/tests/test_app/templates/errors.html
new file mode 100644
index 00000000..43ed26cf
--- /dev/null
+++ b/tests/test_app/templates/errors.html
@@ -0,0 +1,28 @@
+{% load static %} {% load reactpy %}
+<!DOCTYPE html>
+<html lang="en">
+
+<head>
+    <meta charset="UTF-8" />
+    <meta http-equiv="X-UA-Compatible" content="IE=edge" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <link rel="shortcut icon" type="image/png" href="{% static 'favicon.ico' %}" />
+    <title>ReactPy</title>
+</head>
+
+<body>
+    <h1>ReactPy Errors Test Page</h1>
+    <hr>
+    <div id="component_does_not_exist_error">{% component "test_app.components.does_not_exist" %}</div>
+    <hr>
+    <div id="component_param_error">{% component "test_app.components.hello_world" invalid_param="random_value" %}</div>
+    <hr>
+    <div id="invalid_host_error">{% component "test_app.components.hello_world" host="https://example.com/" %}</div>
+    <hr>
+    <div id="broken_postprocessor_query">
+        {% component "test_app.components.broken_postprocessor_query" %}
+    </div>
+    <hr>
+</body>
+
+</html>
diff --git a/tests/test_app/tests/test_components.py b/tests/test_app/tests/test_components.py
index d6b49793..6aeab1e3 100644
--- a/tests/test_app/tests/test_components.py
+++ b/tests/test_app/tests/test_components.py
@@ -277,16 +277,6 @@ def test_view_to_component_decorator_args(self):
             "#view_to_component_decorator_args[data-success=true]"
         ).wait_for()
 
-    def test_component_does_not_exist_error(self):
-        broken_component = self.page.locator("#component_does_not_exist_error")
-        broken_component.wait_for()
-        self.assertIn("ComponentDoesNotExistError:", broken_component.text_content())
-
-    def test_component_param_error(self):
-        broken_component = self.page.locator("#component_param_error")
-        broken_component.wait_for()
-        self.assertIn("ComponentParamError:", broken_component.text_content())
-
     def test_component_session_exists(self):
         """Session should exist for components with args/kwargs."""
         component = self.page.locator("#parametrized-component")
@@ -314,8 +304,8 @@ def test_component_session_missing(self):
     def test_custom_host(self):
         """Make sure that the component is rendered by a separate server."""
         new_page = self.browser.new_page()
+        new_page.goto(f"{self.live_server_url}/port/{self._port2}/")
         try:
-            new_page.goto(f"{self.live_server_url}/port/{self._port2}/")
             elem = new_page.locator(".custom_host-0")
             elem.wait_for()
             self.assertIn(
@@ -341,10 +331,8 @@ def test_custom_host_wrong_port(self):
     def test_host_roundrobin(self):
         """Verify if round-robin host selection is working."""
         new_page = self.browser.new_page()
+        new_page.goto(f"{self.live_server_url}/roundrobin/{self._port}/{self._port2}/8")
         try:
-            new_page.goto(
-                f"{self.live_server_url}/roundrobin/{self._port}/{self._port2}/8"
-            )
             elem0 = new_page.locator(".custom_host-0")
             elem1 = new_page.locator(".custom_host-1")
             elem2 = new_page.locator(".custom_host-2")
@@ -372,21 +360,11 @@ def test_host_roundrobin(self):
         finally:
             new_page.close()
 
-    def test_invalid_host_error(self):
-        broken_component = self.page.locator("#invalid_host_error")
-        broken_component.wait_for()
-        self.assertIn("InvalidHostError:", broken_component.text_content())
-
-    def test_broken_postprocessor_query(self):
-        broken_component = self.page.locator("#broken_postprocessor_query pre")
-        broken_component.wait_for()
-        self.assertIn("SynchronousOnlyOperation:", broken_component.text_content())
-
     def test_prerender(self):
         """Verify if round-robin host selection is working."""
         new_page = self.browser.new_page()
+        new_page.goto(f"{self.live_server_url}/prerender/")
         try:
-            new_page.goto(f"{self.live_server_url}/prerender/")
             string = new_page.locator("#prerender_string")
             vdom = new_page.locator("#prerender_vdom")
             component = new_page.locator("#prerender_component")
@@ -414,3 +392,31 @@ def test_prerender(self):
             )
         finally:
             new_page.close()
+
+    def test_component_errors(self):
+        new_page = self.browser.new_page()
+        new_page.goto(f"{self.live_server_url}/errors/")
+        try:
+            # ComponentDoesNotExistError
+            broken_component = new_page.locator("#component_does_not_exist_error")
+            broken_component.wait_for()
+            self.assertIn(
+                "ComponentDoesNotExistError:", broken_component.text_content()
+            )
+
+            # ComponentParamError
+            broken_component = new_page.locator("#component_param_error")
+            broken_component.wait_for()
+            self.assertIn("ComponentParamError:", broken_component.text_content())
+
+            # InvalidHostError
+            broken_component = new_page.locator("#invalid_host_error")
+            broken_component.wait_for()
+            self.assertIn("InvalidHostError:", broken_component.text_content())
+
+            # SynchronousOnlyOperation
+            broken_component = new_page.locator("#broken_postprocessor_query pre")
+            broken_component.wait_for()
+            self.assertIn("SynchronousOnlyOperation:", broken_component.text_content())
+        finally:
+            new_page.close()
diff --git a/tests/test_app/urls.py b/tests/test_app/urls.py
index fea71309..1fc803cb 100644
--- a/tests/test_app/urls.py
+++ b/tests/test_app/urls.py
@@ -33,6 +33,7 @@ class AccessUser:
         "roundrobin/<int:port1>/<int:port2>/<int:count>/",
         views.host_port_roundrobin_template,
     ),
+    path("errors/", views.errors_template),
     path("", include("test_app.prerender.urls")),
     path("", include("test_app.performance.urls")),
     path("reactpy/", include("reactpy_django.http.urls")),
diff --git a/tests/test_app/views.py b/tests/test_app/views.py
index 2bd06747..c31b9008 100644
--- a/tests/test_app/views.py
+++ b/tests/test_app/views.py
@@ -13,6 +13,10 @@ def base_template(request):
     return render(request, "base.html", {"my_object": TestObject(1)})
 
 
+def errors_template(request):
+    return render(request, "errors.html", {})
+
+
 def host_port_template(request: HttpRequest, port: int):
     host = request.get_host().replace(str(request.get_port()), str(port))
     return render(request, "host_port.html", {"new_host": host})

From 89af32d4b670baf48cb763a1f3d278cb5499e6c6 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 02:17:44 -0700
Subject: [PATCH 12/28] reorganize and fix type hints

---
 src/reactpy_django/components.py | 255 +++++++++++++++----------------
 src/reactpy_django/types.py      |  18 ---
 tests/test_app/apps.py           |   1 -
 3 files changed, 127 insertions(+), 147 deletions(-)

diff --git a/src/reactpy_django/components.py b/src/reactpy_django/components.py
index 1ba3ba35..af77507b 100644
--- a/src/reactpy_django/components.py
+++ b/src/reactpy_django/components.py
@@ -15,69 +15,7 @@
 from reactpy.types import Key, VdomDict
 
 from reactpy_django.exceptions import ComponentNotRegisteredError
-from reactpy_django.types import ViewToComponentConstructor, ViewToIframeConstructor
-from reactpy_django.utils import generate_obj_name, render_view
-
-
-@component
-def _view_to_component(
-    view: Callable | View,
-    compatibility: bool,
-    transforms: Sequence[Callable[[VdomDict], Any]],
-    strict_parsing: bool,
-    request: HttpRequest | None,
-    args: Sequence | None,
-    kwargs: dict | None,
-):
-    """The actual component. Used to prevent pollution of acceptable kwargs keys."""
-    converted_view, set_converted_view = hooks.use_state(
-        cast(Union[VdomDict, None], None)
-    )
-    _args: Sequence = args or ()
-    _kwargs: dict = kwargs or {}
-    if request:
-        _request: HttpRequest = request
-    else:
-        _request = HttpRequest()
-        _request.method = "GET"
-
-    # Render the view render within a hook
-    @hooks.use_effect(
-        dependencies=[
-            json.dumps(vars(_request), default=lambda x: generate_obj_name(x)),
-            json.dumps([_args, _kwargs], default=lambda x: generate_obj_name(x)),
-        ]
-    )
-    async def async_render():
-        """Render the view in an async hook to avoid blocking the main thread."""
-        # Compatibility mode doesn't require a traditional render
-        if compatibility:
-            return
-
-        # Render the view
-        response = await render_view(view, _request, _args, _kwargs)
-        set_converted_view(
-            utils.html_to_vdom(
-                response.content.decode("utf-8").strip(),
-                utils.del_html_head_body_transform,
-                *transforms,
-                strict=strict_parsing,
-            )
-        )
-
-    # Render in compatibility mode, if needed
-    if compatibility:
-        # Warn the user that compatibility mode is deprecated
-        warn(
-            "view_to_component(compatibility=True) is deprecated and will be removed in a future version. "
-            "Please use `view_to_iframe` instead.",
-            DeprecationWarning,
-        )
-
-        return view_to_iframe(view)(*_args, **_kwargs)
-
-    # Return the view if it's been rendered via the `async_render` hook
-    return converted_view
+from reactpy_django.utils import generate_obj_name, import_module, render_view
 
 
 # Type hints for:
@@ -85,11 +23,11 @@ async def async_render():
 #   2. @view_to_component
 @overload
 def view_to_component(
-    view: Callable | View,
+    view: Callable | View | str,
     compatibility: bool = False,
     transforms: Sequence[Callable[[VdomDict], Any]] = (),
     strict_parsing: bool = True,
-) -> ViewToComponentConstructor:
+) -> Any:
     ...
 
 
@@ -101,20 +39,20 @@ def view_to_component(
     compatibility: bool = False,
     transforms: Sequence[Callable[[VdomDict], Any]] = (),
     strict_parsing: bool = True,
-) -> Callable[[Callable], ViewToComponentConstructor]:
+) -> Callable[[Callable], Any]:
     ...
 
 
 def view_to_component(
-    view: Callable | View | None = None,
+    view: Callable | View | str | None = None,
     compatibility: bool = False,
     transforms: Sequence[Callable[[VdomDict], Any]] = (),
     strict_parsing: bool = True,
-) -> ViewToComponentConstructor | Callable[[Callable], ViewToComponentConstructor]:
+) -> Any | Callable[[Callable], Any]:
     """Converts a Django view to a ReactPy component.
 
     Keyword Args:
-        view: The view function or class to convert.
+        view: The view to convert, or the view's dotted path as a string.
         compatibility: **DEPRECATED.** Use `view_to_iframe` instead.
         transforms: A list of functions that transforms the newly generated VDOM. \
             The functions will be called on each VDOM node.
@@ -122,19 +60,18 @@ def view_to_component(
             perfectly adhere to HTML5.
 
     Returns:
-        A function that takes `request: HttpRequest | None, *args: Any, key: Key | None, **kwargs: Any` \
-            and returns a ReactPy component.
+        A function that takes `request, *args, key, **kwargs` and returns a ReactPy component.
     """
 
-    def decorator(view: Callable | View):
+    def decorator(view: Callable | View | str):
         if not view:
             raise ValueError("A view must be provided to `view_to_component`")
 
         def constructor(
             request: HttpRequest | None = None,
-            *args: Any,
+            *args,
             key: Key | None = None,
-            **kwargs: Any,
+            **kwargs,
         ):
             return _view_to_component(
                 view=view,
@@ -159,49 +96,9 @@ def constructor(
     return decorator(view) if view else decorator
 
 
-@component
-def _view_to_iframe(
-    view: Callable | View | str,
-    extra_props: dict[str, Any] | None,
-    args: Sequence | None,
-    kwargs: dict | None,
-) -> VdomDict:
-    """The actual component. Used to prevent pollution of acceptable kwargs keys."""
-    from reactpy_django.config import REACTPY_REGISTERED_IFRAME_VIEWS
-
-    if isinstance(view, str):
-        dotted_path = view
-    else:
-        dotted_path = generate_obj_name(view).replace("<", "").replace(">", "")
-    registered_view = REACTPY_REGISTERED_IFRAME_VIEWS.get(dotted_path)
-
-    if not registered_view:
-        raise ComponentNotRegisteredError(
-            f"'{dotted_path}' has not been registered as an iframe component! "
-            "Are you sure you called `register_iframe` within a Django `AppConfig.ready` method?"
-        )
-
-    query = kwargs.copy()
-    if args:
-        query["_args"] = args
-    query_string = f"?{urlencode(query, doseq=True)}" if args or kwargs else ""
-    extra_props = extra_props or {}
-    extra_props.pop("src", None)
-
-    return html.iframe(
-        {
-            "src": reverse("reactpy:view_to_iframe", args=[dotted_path]) + query_string,
-            "style": {"border": "none"},
-            "onload": 'javascript:(function(o){o.style.height=o.contentWindow.document.body.scrollHeight+"px";}(this));',
-            "loading": "lazy",
-        }
-        | extra_props
-    )
-
-
 def view_to_iframe(
     view: Callable | View | str, extra_props: dict[str, Any] | None = None
-) -> ViewToIframeConstructor:
+):
     """
     Args:
         view: The view function or class to convert, or the dotted path to the view.
@@ -210,13 +107,13 @@ def view_to_iframe(
         extra_props: Additional properties to add to the `iframe` element.
 
     Returns:
-        A function that takes `*args: Any, key: Key | None, **kwargs: Any` and returns a ReactPy component.
+        A function that takes `*args, key, **kwargs` and returns a ReactPy component.
     """
 
     def constructor(
-        *args: Any,
+        *args,
         key: Key | None = None,
-        **kwargs: Any,
+        **kwargs,
     ):
         return _view_to_iframe(
             view=view, extra_props=extra_props, args=args, kwargs=kwargs, key=key
@@ -225,11 +122,6 @@ def constructor(
     return constructor
 
 
-@component
-def _django_css(static_path: str):
-    return html.style(_cached_static_contents(static_path))
-
-
 def django_css(static_path: str, key: Key | None = None):
     """Fetches a CSS static file for use within ReactPy. This allows for deferred CSS loading.
 
@@ -243,11 +135,6 @@ def django_css(static_path: str, key: Key | None = None):
     return _django_css(static_path=static_path, key=key)
 
 
-@component
-def _django_js(static_path: str):
-    return html.script(_cached_static_contents(static_path))
-
-
 def django_js(static_path: str, key: Key | None = None):
     """Fetches a JS static file for use within ReactPy. This allows for deferred JS loading.
 
@@ -261,6 +148,118 @@ def django_js(static_path: str, key: Key | None = None):
     return _django_js(static_path=static_path, key=key)
 
 
+@component
+def _view_to_component(
+    view: Callable | View | str,
+    compatibility: bool,
+    transforms: Sequence[Callable[[VdomDict], Any]],
+    strict_parsing: bool,
+    request: HttpRequest | None,
+    args: Sequence | None,
+    kwargs: dict | None,
+):
+    """The actual component. Used to prevent pollution of acceptable kwargs keys."""
+    converted_view, set_converted_view = hooks.use_state(
+        cast(Union[VdomDict, None], None)
+    )
+    _args: Sequence = args or ()
+    _kwargs: dict = kwargs or {}
+    if request:
+        _request: HttpRequest = request
+    else:
+        _request = HttpRequest()
+        _request.method = "GET"
+    resolved_view: Callable = import_module(view) if isinstance(view, str) else view  # type: ignore[assignment]
+
+    # Render the view render within a hook
+    @hooks.use_effect(
+        dependencies=[
+            json.dumps(vars(_request), default=lambda x: generate_obj_name(x)),
+            json.dumps([_args, _kwargs], default=lambda x: generate_obj_name(x)),
+        ]
+    )
+    async def async_render():
+        """Render the view in an async hook to avoid blocking the main thread."""
+        # Compatibility mode doesn't require a traditional render
+        if compatibility:
+            return
+
+        # Render the view
+        response = await render_view(resolved_view, _request, _args, _kwargs)
+        set_converted_view(
+            utils.html_to_vdom(
+                response.content.decode("utf-8").strip(),
+                utils.del_html_head_body_transform,
+                *transforms,
+                strict=strict_parsing,
+            )
+        )
+
+    # Render in compatibility mode, if needed
+    if compatibility:
+        # Warn the user that compatibility mode is deprecated
+        warn(
+            "view_to_component(compatibility=True) is deprecated and will be removed in a future version. "
+            "Please use `view_to_iframe` instead.",
+            DeprecationWarning,
+        )
+
+        return view_to_iframe(resolved_view)(*_args, **_kwargs)
+
+    # Return the view if it's been rendered via the `async_render` hook
+    return converted_view
+
+
+@component
+def _view_to_iframe(
+    view: Callable | View | str,
+    extra_props: dict[str, Any] | None,
+    args: Sequence,
+    kwargs: dict,
+) -> VdomDict:
+    """The actual component. Used to prevent pollution of acceptable kwargs keys."""
+    from reactpy_django.config import REACTPY_REGISTERED_IFRAME_VIEWS
+
+    if isinstance(view, str):
+        dotted_path = view
+    else:
+        dotted_path = generate_obj_name(view).replace("<", "").replace(">", "")
+    registered_view = REACTPY_REGISTERED_IFRAME_VIEWS.get(dotted_path)
+
+    if not registered_view:
+        raise ComponentNotRegisteredError(
+            f"'{dotted_path}' has not been registered as an iframe component! "
+            "Are you sure you called `register_iframe` within a Django `AppConfig.ready` method?"
+        )
+
+    query = kwargs.copy()
+    if args:
+        query["_args"] = args
+    query_string = f"?{urlencode(query, doseq=True)}" if args or kwargs else ""
+    extra_props = extra_props or {}
+    extra_props.pop("src", None)
+
+    return html.iframe(
+        {
+            "src": reverse("reactpy:view_to_iframe", args=[dotted_path]) + query_string,
+            "style": {"border": "none"},
+            "onload": 'javascript:(function(o){o.style.height=o.contentWindow.document.body.scrollHeight+"px";}(this));',
+            "loading": "lazy",
+        }
+        | extra_props
+    )
+
+
+@component
+def _django_css(static_path: str):
+    return html.style(_cached_static_contents(static_path))
+
+
+@component
+def _django_js(static_path: str):
+    return html.script(_cached_static_contents(static_path))
+
+
 def _cached_static_contents(static_path: str):
     from reactpy_django.config import REACTPY_CACHE
 
diff --git a/src/reactpy_django/types.py b/src/reactpy_django/types.py
index b4cb9290..151b0709 100644
--- a/src/reactpy_django/types.py
+++ b/src/reactpy_django/types.py
@@ -126,21 +126,3 @@ class ComponentParams:
 
     args: Sequence
     kwargs: MutableMapping[str, Any]
-
-
-class ViewToComponentConstructor(Protocol):
-    def __call__(
-        self,
-        request: HttpRequest | None = None,
-        *args: Any,
-        key: Key | None = None,
-        **kwargs: Any,
-    ) -> ComponentType:
-        ...
-
-
-class ViewToIframeConstructor(Protocol):
-    def __call__(
-        self, *args: Any, key: Key | None = None, **kwargs: Any
-    ) -> ComponentType:
-        ...
diff --git a/tests/test_app/apps.py b/tests/test_app/apps.py
index 9cad19ab..a9a87919 100644
--- a/tests/test_app/apps.py
+++ b/tests/test_app/apps.py
@@ -8,7 +8,6 @@ class TestAppConfig(AppConfig):
     name = "test_app"
 
     def ready(self):
-        # Populate the ReactPy component registry when Django is ready
         register_iframe("test_app.views.view_to_component_sync_func_compatibility")
         register_iframe(views.view_to_component_async_func_compatibility)
         register_iframe(views.ViewToComponentSyncClassCompatibility)

From b2967742c610b6f43e6db397c9dad4c3bc51e547 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 02:20:18 -0700
Subject: [PATCH 13/28] update component docs

---
 docs/python/hello_world_app_config_cbv.py | 11 ++++++
 docs/python/hello_world_app_config_fbv.py | 11 ++++++
 docs/python/hello_world_args_kwargs.py    |  4 +-
 docs/python/vtc-args.py                   |  4 +-
 docs/python/vti-args.py                   | 11 ++++--
 docs/python/vti-cbv.py                    |  4 +-
 docs/python/vti-extra-props.py            |  6 ++-
 docs/python/vti.py                        |  4 +-
 docs/src/reference/components.md          | 46 ++++++++++++++++++++---
 9 files changed, 84 insertions(+), 17 deletions(-)
 create mode 100644 docs/python/hello_world_app_config_cbv.py
 create mode 100644 docs/python/hello_world_app_config_fbv.py

diff --git a/docs/python/hello_world_app_config_cbv.py b/docs/python/hello_world_app_config_cbv.py
new file mode 100644
index 00000000..ec448117
--- /dev/null
+++ b/docs/python/hello_world_app_config_cbv.py
@@ -0,0 +1,11 @@
+from django.apps import AppConfig
+from reactpy_django.utils import register_iframe
+
+from . import views
+
+
+class ExampleAppConfig(AppConfig):
+    name = "example"
+
+    def ready(self):
+        register_iframe(views.HelloWorld)
diff --git a/docs/python/hello_world_app_config_fbv.py b/docs/python/hello_world_app_config_fbv.py
new file mode 100644
index 00000000..c23c6919
--- /dev/null
+++ b/docs/python/hello_world_app_config_fbv.py
@@ -0,0 +1,11 @@
+from django.apps import AppConfig
+from reactpy_django.utils import register_iframe
+
+from . import views
+
+
+class ExampleAppConfig(AppConfig):
+    name = "example"
+
+    def ready(self):
+        register_iframe(views.hello_world)
diff --git a/docs/python/hello_world_args_kwargs.py b/docs/python/hello_world_args_kwargs.py
index 890148dd..b30b8e2b 100644
--- a/docs/python/hello_world_args_kwargs.py
+++ b/docs/python/hello_world_args_kwargs.py
@@ -1,5 +1,5 @@
 from django.http import HttpResponse
 
 
-def hello_world(request, arg1, arg2, key1=None, key2=None):
-    return HttpResponse(f"Hello World! {arg1} {arg2} {key1} {key2}")
+def hello_world(request, arg1, arg2, kwarg1=None, kwarg2=None):
+    return HttpResponse(f"Hello World! {arg1} {arg2} {kwarg1} {kwarg2}")
diff --git a/docs/python/vtc-args.py b/docs/python/vtc-args.py
index 19783121..edc0fbb2 100644
--- a/docs/python/vtc-args.py
+++ b/docs/python/vtc-args.py
@@ -17,7 +17,7 @@ def my_component():
             request,  # This request object is optional.
             "value_1",
             "value_2",
-            key1="abc",
-            key2="123",
+            kwarg1="abc",
+            kwarg2="123",
         ),
     )
diff --git a/docs/python/vti-args.py b/docs/python/vti-args.py
index f9c20469..f5013ecd 100644
--- a/docs/python/vti-args.py
+++ b/docs/python/vti-args.py
@@ -3,15 +3,18 @@
 
 from . import views
 
+hello_world_iframe = view_to_iframe(
+    views.hello_world,
+)
+
 
 @component
 def my_component():
     return html.div(
-        view_to_iframe(
-            views.hello_world,
+        hello_world_iframe(
             "value_1",
             "value_2",
-            key1="abc",
-            key2="123",
+            kwarg1="abc",
+            kwarg2="123",
         ),
     )
diff --git a/docs/python/vti-cbv.py b/docs/python/vti-cbv.py
index 81909bb9..ff2ce963 100644
--- a/docs/python/vti-cbv.py
+++ b/docs/python/vti-cbv.py
@@ -3,9 +3,11 @@
 
 from . import views
 
+hello_world_iframe = view_to_iframe(views.HelloWorld)
+
 
 @component
 def my_component():
     return html.div(
-        view_to_iframe(views.HelloWorld),
+        hello_world_iframe(),
     )
diff --git a/docs/python/vti-extra-props.py b/docs/python/vti-extra-props.py
index bc2de6dd..655ad541 100644
--- a/docs/python/vti-extra-props.py
+++ b/docs/python/vti-extra-props.py
@@ -3,9 +3,13 @@
 
 from . import views
 
+hello_world_iframe = view_to_iframe(
+    views.hello_world, extra_props={"title": "Hello World!"}
+)
+
 
 @component
 def my_component():
     return html.div(
-        view_to_iframe(views.hello_world, extra_props={"title": "Hello World!"}),
+        hello_world_iframe(),
     )
diff --git a/docs/python/vti.py b/docs/python/vti.py
index ff5bd243..c8ff6796 100644
--- a/docs/python/vti.py
+++ b/docs/python/vti.py
@@ -3,9 +3,11 @@
 
 from . import views
 
+hello_world_iframe = view_to_iframe(views.hello_world)
+
 
 @component
 def my_component():
     return html.div(
-        view_to_iframe(views.hello_world),
+        hello_world_iframe(),
     )
diff --git a/docs/src/reference/components.md b/docs/src/reference/components.md
index 66e2867f..89dd12b5 100644
--- a/docs/src/reference/components.md
+++ b/docs/src/reference/components.md
@@ -34,7 +34,7 @@ Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/top
 
     | Name | Type | Description | Default |
     | --- | --- | --- | --- |
-    | `#!python view` | `#!python Callable | View` | The view function or class to convert. | N/A |
+    | `#!python view` | `#!python Callable | View | str` | The view to convert, or the view's dotted path as a string. | N/A |
     | `#!python transforms` | `#!python Sequence[Callable[[VdomDict], Any]]` | A list of functions that transforms the newly generated VDOM. The functions will be called on each VDOM node. | `#!python tuple` |
     | `#!python strict_parsing` | `#!python bool` | If `#!python True`, an exception will be generated if the HTML does not perfectly adhere to HTML5. | `#!python True` |
 
@@ -42,7 +42,7 @@ Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/top
 
     | Type | Description |
     | --- | --- |
-    | `#!python ViewToComponentConstructor` | A function that takes `#!python request, *args, key, **kwargs` and returns a ReactPy component. All parameters are directly provided to your view, besides `#!python key` which is used by ReactPy. |
+    | `#!python constructor` | A function that takes `#!python request, *args, key, **kwargs` and returns a ReactPy component. Note that `#!python *args` and `#!python **kwargs` are directly provided to your view. |
 
 ??? info "Existing limitations"
 
@@ -78,6 +78,12 @@ Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/top
         {% include "../../python/vtc-args.py" %}
         ```
 
+    === "views.py"
+
+        ```python
+        {% include "../../python/hello_world_args_kwargs.py" %}
+        ```
+
 ??? question "How do I customize this component's behavior?"
 
     This component accepts arguments that can be used to customize its behavior.
@@ -154,23 +160,27 @@ Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/top
     {% include "../../python/hello_world_fbv.py" %}
     ```
 
+=== "apps.py"
+
+    ```python
+    {% include "../../python/hello_world_app_config_fbv.py" %}
+    ```
+
 ??? example "See Interface"
 
     <font size="4">**Parameters**</font>
 
     | Name | Type | Description | Default |
     | --- | --- | --- | --- |
-    | `#!python view` | `#!python Callable | View` | The view function or class to convert. | N/A |
-    | `#!python *args` | `#!python Sequence[Any]` | A list of arguments to provide to your view. | N/A |
+    | `#!python view` | `#!python Callable | View | str` | The view function or class to convert. | N/A |
     | `#!python extra_props` | `#!python Mapping[str, Any] | None` | Additional properties to add to the `iframe` element. | `#!python None` |
-    | `#!python **kwargs` | `#!python dict[str, Any]` | A dictionary of keyword arguments to provide to your view. | N/A |
 
 
     <font size="4">**Returns**</font>
 
     | Type | Description |
     | --- | --- |
-    | `#!python ComponentType` | A ReactPy `iframe` component. |
+    | `#!python constructor` | A function that takes `#!python *args, key, **kwargs` and returns a ReactPy component. Note that `#!python *args` and `#!python **kwargs` are directly provided to your view. |
 
 ??? info "Existing limitations"
 
@@ -197,6 +207,12 @@ Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/top
         {% include "../../python/hello_world_cbv.py" %}
         ```
 
+    === "apps.py"
+
+        ```python
+        {% include "../../python/hello_world_app_config_cbv.py" %}
+        ```
+
 ??? question "How do I provide `#!python args` and `#!python kwargs` to a converted view?"
 
     This component accepts `#!python *args` and `#!python **kwargs` arguments, which are sent to your provided view.
@@ -215,6 +231,12 @@ Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/top
         {% include "../../python/hello_world_fbv.py" %}
         ```
 
+    === "apps.py"
+
+        ```python
+        {% include "../../python/hello_world_app_config_fbv.py" %}
+        ```
+
 ??? question "How do I customize this component's behavior?"
 
     This component accepts arguments that can be used to customize its behavior.
@@ -235,6 +257,18 @@ Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/top
         {% include "../../python/vti-extra-props.py" %}
         ```
 
+    === "views.py"
+
+        ```python
+        {% include "../../python/hello_world_fbv.py" %}
+        ```
+
+    === "apps.py"
+
+        ```python
+        {% include "../../python/hello_world_app_config_fbv.py" %}
+        ```
+
 ## Django CSS
 
 Allows you to defer loading a CSS stylesheet until a component begins rendering. This stylesheet must be stored within [Django's static files](https://docs.djangoproject.com/en/dev/howto/static-files/).

From e8e84558dae3ef830341c26bec8ee6f61a3bcf90 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 02:38:10 -0700
Subject: [PATCH 14/28] misc docs tweaks

---
 docs/src/reference/components.md |  6 ++++++
 docs/src/reference/hooks.md      | 10 ++++++++++
 docs/src/reference/settings.md   |  8 +++++---
 3 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/docs/src/reference/components.md b/docs/src/reference/components.md
index 89dd12b5..2d96d8d8 100644
--- a/docs/src/reference/components.md
+++ b/docs/src/reference/components.md
@@ -134,6 +134,8 @@ Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/top
         {% include "../../python/hello_world_fbv_with_id.py" %}
         ```
 
+---
+
 ## View To Iframe
 
 Automatically convert a Django view into an [`iframe` element](https://www.techtarget.com/whatis/definition/IFrame-Inline-Frame).
@@ -269,6 +271,8 @@ Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/top
         {% include "../../python/hello_world_app_config_fbv.py" %}
         ```
 
+---
+
 ## Django CSS
 
 Allows you to defer loading a CSS stylesheet until a component begins rendering. This stylesheet must be stored within [Django's static files](https://docs.djangoproject.com/en/dev/howto/static-files/).
@@ -320,6 +324,8 @@ Allows you to defer loading a CSS stylesheet until a component begins rendering.
 
     However, to help improve webpage load times you can use this `#!python django_css` component to defer loading your stylesheet until it is needed.
 
+---
+
 ## Django JS
 
 Allows you to defer loading JavaScript until a component begins rendering. This JavaScript must be stored within [Django's static files](https://docs.djangoproject.com/en/dev/howto/static-files/).
diff --git a/docs/src/reference/hooks.md b/docs/src/reference/hooks.md
index c9b3985d..0939d046 100644
--- a/docs/src/reference/hooks.md
+++ b/docs/src/reference/hooks.md
@@ -156,6 +156,8 @@ The [default postprocessor](../reference/utils.md#django-query-postprocessor) ex
 
     With the `#!python Model` or `#!python QuerySet` your function returns, this hook uses the [default postprocessor](../reference/utils.md#django-query-postprocessor) to ensure that all [deferred](https://docs.djangoproject.com/en/dev/ref/models/instances/#django.db.models.Model.get_deferred_fields) or [lazy](https://docs.djangoproject.com/en/dev/topics/db/queries/#querysets-are-lazy) fields are executed.
 
+---
+
 ## Use Mutation
 
 This hook is used to modify data in the background, typically to [create/update/delete](https://www.sumologic.com/glossary/crud/) data from the Django ORM.
@@ -261,6 +263,8 @@ Mutation functions can `#!python return False` to prevent executing your `#!pyth
         {% include "../../python/example/models.py" %}
         ```
 
+---
+
 ## Use Connection
 
 This hook is used to fetch the active connection, which is either a Django [WebSocket](https://channels.readthedocs.io/en/stable/topics/consumers.html#asyncjsonwebsocketconsumer) or a [HTTP Request](https://docs.djangoproject.com/en/4.2/ref/request-response/#django.http.HttpRequest).
@@ -283,6 +287,8 @@ This hook is used to fetch the active connection, which is either a Django [WebS
     | --- | --- |
     | `#!python Connection` | The component's `WebSocket` or `HttpRequest`. |
 
+---
+
 ## Use Scope
 
 This is a shortcut that returns the WebSocket or HTTP [scope](https://channels.readthedocs.io/en/stable/topics/consumers.html#scope).
@@ -305,6 +311,8 @@ This is a shortcut that returns the WebSocket or HTTP [scope](https://channels.r
     | --- | --- |
     | `#!python MutableMapping[str, Any]` | The WebSocket's `#!python scope`. |
 
+---
+
 ## Use Location
 
 This is a shortcut that returns the client's URL `#!python path`.
@@ -335,6 +343,8 @@ You can expect this hook to provide strings such as `/reactpy/my_path`.
 
     Check out [reactive-python/reactpy-django#147](https://github.com/reactive-python/reactpy-django/issues/147) for more information.
 
+---
+
 ## Use Origin
 
 This is a shortcut that returns the client's `#!python origin`.
diff --git a/docs/src/reference/settings.md b/docs/src/reference/settings.md
index 46ed7070..3a69840e 100644
--- a/docs/src/reference/settings.md
+++ b/docs/src/reference/settings.md
@@ -88,9 +88,9 @@ DATABASE_ROUTERS = ["reactpy_django.database.Router", ...]
 
 **Example Value(s):** `#!python "my-reactpy-cache"`
 
-Cache used by ReactPy, typically for file operations.
+Cache used by ReactPy, typically for caching disk operations.
 
-We recommend configuring [`redis`](https://docs.djangoproject.com/en/dev/topics/cache/#redis), [`python-diskcache`](https://grantjenks.com/docs/diskcache/tutorial.html#djangocache), or [`LocMemCache`](https://docs.djangoproject.com/en/dev/topics/cache/#local-memory-caching).
+We recommend using [`redis`](https://docs.djangoproject.com/en/dev/topics/cache/#redis), [`python-diskcache`](https://grantjenks.com/docs/diskcache/tutorial.html#djangocache), or [`LocMemCache`](https://docs.djangoproject.com/en/dev/topics/cache/#local-memory-caching).
 
 ---
 
@@ -102,7 +102,9 @@ We recommend configuring [`redis`](https://docs.djangoproject.com/en/dev/topics/
 
 Configures whether ReactPy components are rendered in a dedicated thread.
 
-This setting allows the web server to process other traffic during ReactPy rendering. Vastly improves throughput with web servers such as [`hypercorn`](https://pgjones.gitlab.io/hypercorn/) and [`uvicorn`](https://www.uvicorn.org/).
+This allows the web server to process other traffic during ReactPy rendering. Vastly improves throughput with web servers such as [`hypercorn`](https://pgjones.gitlab.io/hypercorn/) and [`uvicorn`](https://www.uvicorn.org/).
+
+This setting is incompatible with [`daphne`](https://github.com/django/daphne).
 
 ---
 

From 614b86309e72e7e6124b039347c7f783b2648048 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 02:44:22 -0700
Subject: [PATCH 15/28] add test for ComponentNotRegisteredError

---
 tests/test_app/components.py            | 9 +++++++++
 tests/test_app/templates/errors.html    | 3 +++
 tests/test_app/tests/test_components.py | 7 +++++++
 3 files changed, 19 insertions(+)

diff --git a/tests/test_app/components.py b/tests/test_app/components.py
index db118343..38f54bab 100644
--- a/tests/test_app/components.py
+++ b/tests/test_app/components.py
@@ -469,6 +469,7 @@ async def on_change(event):
     views.ViewToComponentTemplateViewClassCompatibility, compatibility=True
 )
 _view_to_iframe_args = view_to_iframe(views.view_to_iframe_args)
+_view_to_iframe_not_registered = view_to_iframe(views.view_to_component_sync_func)
 view_to_component_script = view_to_component(views.view_to_component_script)
 _view_to_component_request = view_to_component(views.view_to_component_request)
 _view_to_component_args = view_to_component(views.view_to_component_args)
@@ -523,6 +524,14 @@ def view_to_iframe_args():
     )
 
 
+@component
+def view_to_iframe_not_registered():
+    return html.div(
+        {"id": inspect.currentframe().f_code.co_name},  # type: ignore
+        _view_to_iframe_not_registered(),
+    )
+
+
 @component
 def view_to_component_request():
     request, set_request = hooks.use_state(None)
diff --git a/tests/test_app/templates/errors.html b/tests/test_app/templates/errors.html
index 43ed26cf..0f6db8db 100644
--- a/tests/test_app/templates/errors.html
+++ b/tests/test_app/templates/errors.html
@@ -23,6 +23,9 @@ <h1>ReactPy Errors Test Page</h1>
         {% component "test_app.components.broken_postprocessor_query" %}
     </div>
     <hr>
+    <div id="view_to_iframe_not_registered">
+        {% component "test_app.components.view_to_iframe_not_registered" %}
+    </div>
 </body>
 
 </html>
diff --git a/tests/test_app/tests/test_components.py b/tests/test_app/tests/test_components.py
index 6aeab1e3..6be62c84 100644
--- a/tests/test_app/tests/test_components.py
+++ b/tests/test_app/tests/test_components.py
@@ -418,5 +418,12 @@ def test_component_errors(self):
             broken_component = new_page.locator("#broken_postprocessor_query pre")
             broken_component.wait_for()
             self.assertIn("SynchronousOnlyOperation:", broken_component.text_content())
+
+            # ComponentNotRegisteredError
+            broken_component = new_page.locator("#view_to_iframe_not_registered pre")
+            broken_component.wait_for()
+            self.assertIn(
+                "ComponentNotRegisteredError:", broken_component.text_content()
+            )
         finally:
             new_page.close()

From b3f2548e5df86a823f8661578465c94389fe9177 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 02:53:01 -0700
Subject: [PATCH 16/28] misc doc tweaks

---
 docs/src/reference/decorators.md | 2 +-
 docs/src/reference/hooks.md      | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/src/reference/decorators.md b/docs/src/reference/decorators.md
index e5650648..f02a718a 100644
--- a/docs/src/reference/decorators.md
+++ b/docs/src/reference/decorators.md
@@ -14,7 +14,7 @@ You can limit component access to users with a specific `#!python auth_attribute
 
 By default, this decorator checks if the user is logged in and not deactivated (`#!python is_active`).
 
-This decorator is commonly used to selectively render a component only if a user [`#!python is_staff`](https://docs.djangoproject.com/en/dev/ref/contrib/auth/#django.contrib.auth.models.User.is_staff) or [`#!python is_superuser`](https://docs.djangoproject.com/en/dev/ref/contrib/auth/#django.contrib.auth.models.User.is_superuser).
+This decorator is commonly used to selectively render a component only if a user [`is_staff`](https://docs.djangoproject.com/en/dev/ref/contrib/auth/#django.contrib.auth.models.User.is_staff) or [`is_superuser`](https://docs.djangoproject.com/en/dev/ref/contrib/auth/#django.contrib.auth.models.User.is_superuser).
 
 === "components.py"
 
diff --git a/docs/src/reference/hooks.md b/docs/src/reference/hooks.md
index 0939d046..4a97cc89 100644
--- a/docs/src/reference/hooks.md
+++ b/docs/src/reference/hooks.md
@@ -69,7 +69,7 @@ The [default postprocessor](../reference/utils.md#django-query-postprocessor) ex
 
     <font size="4">**`#!python thread_sensitive`**</font>
 
-    Whether to run your synchronous query function in thread-sensitive mode. Thread-sensitive mode is turned on by default due to Django ORM limitations. See Django's [`#!python sync_to_async` docs](https://docs.djangoproject.com/en/dev/topics/async/#sync-to-async) docs for more information.
+    Whether to run your synchronous query function in thread-sensitive mode. Thread-sensitive mode is turned on by default due to Django ORM limitations. See Django's [`sync_to_async` docs](https://docs.djangoproject.com/en/dev/topics/async/#sync-to-async) docs for more information.
 
     This setting only applies to sync query functions, and will be ignored for async functions.
 
@@ -211,7 +211,7 @@ Mutation functions can `#!python return False` to prevent executing your `#!pyth
 
     <font size="4">**`#!python thread_sensitive`**</font>
 
-    Whether to run your synchronous mutation function in thread-sensitive mode. Thread-sensitive mode is turned on by default due to Django ORM limitations. See Django's [`#!python sync_to_async` docs](https://docs.djangoproject.com/en/dev/topics/async/#sync-to-async) docs for more information.
+    Whether to run your synchronous mutation function in thread-sensitive mode. Thread-sensitive mode is turned on by default due to Django ORM limitations. See Django's [`sync_to_async` docs](https://docs.djangoproject.com/en/dev/topics/async/#sync-to-async) docs for more information.
 
     This setting only applies to sync query functions, and will be ignored for async functions.
 

From 9bb8dda06f0f0615cebfcb5a4047cd435d156f4e Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 02:58:08 -0700
Subject: [PATCH 17/28] Register Iframe docs

---
 docs/src/reference/utils.md | 64 ++++++++++++++++++++++++-------------
 1 file changed, 42 insertions(+), 22 deletions(-)

diff --git a/docs/src/reference/utils.md b/docs/src/reference/utils.md
index d9b36462..131164bf 100644
--- a/docs/src/reference/utils.md
+++ b/docs/src/reference/utils.md
@@ -8,6 +8,48 @@ Utility functions provide various miscellaneous functionality. These are typical
 
 ---
 
+## Register Iframe
+
+This function is used register a view as an `#!python iframe` with ReactPy.
+
+It is mandatory to use this function if you are using `#!python view_to_iframe` within your application.
+
+=== "apps.py"
+
+    ```python
+    {% include "../../python/hello_world_app_config_fbv.py" %}
+    ```
+
+??? warning "Only use this within `#!python MyAppConfig.ready()`"
+
+    You should always call `#!python register_iframe` within a Django [`MyAppConfig.ready()` method](https://docs.djangoproject.com/en/dev/ref/applications/#django.apps.AppConfig.ready). This ensures you will retain multiprocessing compatibility, such as with ASGI web server workers.
+
+---
+
+## Register Component
+
+This function is used manually register a root component with ReactPy.
+
+=== "apps.py"
+
+    ```python
+    {% include "../../python/register-component.py" %}
+    ```
+
+??? warning "Only use this within `#!python MyAppConfig.ready()`"
+
+    You should always call `#!python register_component` within a Django [`MyAppConfig.ready()` method](https://docs.djangoproject.com/en/dev/ref/applications/#django.apps.AppConfig.ready). This ensures you will retain multiprocessing compatibility, such as with ASGI web server workers.
+
+??? question "Do I need to use this?"
+
+    You typically will not need to use this function.
+
+    For security reasons, ReactPy requires all root components to be registered. However, all components contained within Django templates are automatically registered.
+
+    This function is needed when you have configured your [`host`](../reference/template-tag.md#component) to a dedicated Django rendering application that doesn't have templates.
+
+---
+
 ## Django Query Postprocessor
 
 This is the default postprocessor for the `#!python use_query` hook.
@@ -41,25 +83,3 @@ This postprocessor is designed to avoid Django's `#!python SynchronousOnlyExcept
     | Type | Description |
     | --- | --- |
     | `#!python QuerySet | Model` | The `#!python Model` or `#!python QuerySet` with all fields fetched. |
-
-## Register Component
-
-This function is used manually register a root component with ReactPy.
-
-=== "apps.py"
-
-    ```python
-    {% include "../../python/register-component.py" %}
-    ```
-
-??? warning "Only use this within `#!python MyAppConfig.ready()`"
-
-    You should always call `#!python register_component` within a Django [`#!python MyAppConfig.ready()` method](https://docs.djangoproject.com/en/dev/ref/applications/#django.apps.AppConfig.ready). This ensures you will retain multiprocessing compatibility, such as with ASGI web server workers.
-
-??? question "Do I need to use this?"
-
-    You typically will not need to use this function.
-
-    For security reasons, ReactPy requires all root components to be registered. However, all components contained within Django templates are automatically registered.
-
-    This function is needed when you have configured your [`host`](../reference/template-tag.md#component) to a dedicated Django rendering application that doesn't have templates.

From c55ee3b9db11fa7826c1a52ecd17a26ed50e512c Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 03:19:41 -0700
Subject: [PATCH 18/28] add interface utils.md

---
 docs/src/reference/utils.md | 26 +++++++++++++++++++++++++-
 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/docs/src/reference/utils.md b/docs/src/reference/utils.md
index 131164bf..d9ca6409 100644
--- a/docs/src/reference/utils.md
+++ b/docs/src/reference/utils.md
@@ -12,7 +12,7 @@ Utility functions provide various miscellaneous functionality. These are typical
 
 This function is used register a view as an `#!python iframe` with ReactPy.
 
-It is mandatory to use this function if you are using `#!python view_to_iframe` within your application.
+It is mandatory to use this function alongside [`view_to_iframe`](../reference/components.md#view-to-iframe).
 
 === "apps.py"
 
@@ -20,6 +20,18 @@ It is mandatory to use this function if you are using `#!python view_to_iframe`
     {% include "../../python/hello_world_app_config_fbv.py" %}
     ```
 
+??? example "See Interface"
+
+    <font size="4">**Parameters**</font>
+
+    | Name | Type | Description | Default |
+    | --- | --- | --- | --- |
+    | `#!python view` | `#!python Callable | View | str` | The view to register. Can be a function or class based view, or a dotted path to a view. | N/A |
+
+    <font size="4">**Returns**</font>
+
+    `#!python None`
+
 ??? warning "Only use this within `#!python MyAppConfig.ready()`"
 
     You should always call `#!python register_iframe` within a Django [`MyAppConfig.ready()` method](https://docs.djangoproject.com/en/dev/ref/applications/#django.apps.AppConfig.ready). This ensures you will retain multiprocessing compatibility, such as with ASGI web server workers.
@@ -36,6 +48,18 @@ This function is used manually register a root component with ReactPy.
     {% include "../../python/register-component.py" %}
     ```
 
+??? example "See Interface"
+
+    <font size="4">**Parameters**</font>
+
+    | Name | Type | Description | Default |
+    | --- | --- | --- | --- |
+    | `#!python component` | `#!python ComponentConstructor | str` | The component to register. Can be a component function or dotted path to a component. | N/A |
+
+    <font size="4">**Returns**</font>
+
+    `#!python None`
+
 ??? warning "Only use this within `#!python MyAppConfig.ready()`"
 
     You should always call `#!python register_component` within a Django [`MyAppConfig.ready()` method](https://docs.djangoproject.com/en/dev/ref/applications/#django.apps.AppConfig.ready). This ensures you will retain multiprocessing compatibility, such as with ASGI web server workers.

From 63e6c982c395a57968c2fa356044842aec597e01 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 03:19:56 -0700
Subject: [PATCH 19/28] more obvious error

---
 tests/test_app/components.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/tests/test_app/components.py b/tests/test_app/components.py
index 38f54bab..473719b2 100644
--- a/tests/test_app/components.py
+++ b/tests/test_app/components.py
@@ -469,7 +469,7 @@ async def on_change(event):
     views.ViewToComponentTemplateViewClassCompatibility, compatibility=True
 )
 _view_to_iframe_args = view_to_iframe(views.view_to_iframe_args)
-_view_to_iframe_not_registered = view_to_iframe(views.view_to_component_sync_func)
+_view_to_iframe_not_registered = view_to_iframe("view_does_not_exist")
 view_to_component_script = view_to_component(views.view_to_component_script)
 _view_to_component_request = view_to_component(views.view_to_component_request)
 _view_to_component_args = view_to_component(views.view_to_component_args)

From 39171d063833af29ca0c0340dd78ac3b3a9f6c56 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 03:21:59 -0700
Subject: [PATCH 20/28] ViewNotRegisteredError and ViewDoesNotExistError

---
 src/reactpy_django/components.py        | 11 +++----
 src/reactpy_django/exceptions.py        |  6 +++-
 src/reactpy_django/utils.py             | 44 +++++++++++++++----------
 tests/test_app/tests/test_components.py |  6 ++--
 4 files changed, 38 insertions(+), 29 deletions(-)

diff --git a/src/reactpy_django/components.py b/src/reactpy_django/components.py
index af77507b..f01b1858 100644
--- a/src/reactpy_django/components.py
+++ b/src/reactpy_django/components.py
@@ -14,7 +14,7 @@
 from reactpy import component, hooks, html, utils
 from reactpy.types import Key, VdomDict
 
-from reactpy_django.exceptions import ComponentNotRegisteredError
+from reactpy_django.exceptions import ViewNotRegisteredError
 from reactpy_django.utils import generate_obj_name, import_module, render_view
 
 
@@ -220,15 +220,12 @@ def _view_to_iframe(
     """The actual component. Used to prevent pollution of acceptable kwargs keys."""
     from reactpy_django.config import REACTPY_REGISTERED_IFRAME_VIEWS
 
-    if isinstance(view, str):
-        dotted_path = view
-    else:
-        dotted_path = generate_obj_name(view).replace("<", "").replace(">", "")
+    dotted_path = view if isinstance(view, str) else generate_obj_name(view)
     registered_view = REACTPY_REGISTERED_IFRAME_VIEWS.get(dotted_path)
 
     if not registered_view:
-        raise ComponentNotRegisteredError(
-            f"'{dotted_path}' has not been registered as an iframe component! "
+        raise ViewNotRegisteredError(
+            f"'{dotted_path}' has not been registered as an iframe! "
             "Are you sure you called `register_iframe` within a Django `AppConfig.ready` method?"
         )
 
diff --git a/src/reactpy_django/exceptions.py b/src/reactpy_django/exceptions.py
index d2910ce8..116f2274 100644
--- a/src/reactpy_django/exceptions.py
+++ b/src/reactpy_django/exceptions.py
@@ -14,5 +14,9 @@ class ComponentCarrierError(ValueError):
     ...
 
 
-class ComponentNotRegisteredError(ComponentDoesNotExistError):
+class ViewNotRegisteredError(AttributeError):
+    ...
+
+
+class ViewDoesNotExistError(AttributeError):
     ...
diff --git a/src/reactpy_django/utils.py b/src/reactpy_django/utils.py
index 063716ff..e2f15af0 100644
--- a/src/reactpy_django/utils.py
+++ b/src/reactpy_django/utils.py
@@ -24,7 +24,11 @@
 from reactpy.core.layout import Layout
 from reactpy.types import ComponentConstructor
 
-from reactpy_django.exceptions import ComponentDoesNotExistError, ComponentParamError
+from reactpy_django.exceptions import (
+    ComponentDoesNotExistError,
+    ComponentParamError,
+    ViewDoesNotExistError,
+)
 
 _logger = logging.getLogger(__name__)
 _component_tag = r"(?P<tag>component)"
@@ -85,16 +89,21 @@ async def render_view(
     return response
 
 
-def register_component(dotted_path: str) -> ComponentConstructor:
-    """Adds a component to the list of known registered components."""
+def register_component(component: ComponentConstructor | str):
+    """Adds a component to the list of known registered components.
+
+    Args:
+        component: The component to register. Can be a component function or dotted path to a component.
+
+    """
     from reactpy_django.config import (
         REACTPY_FAILED_COMPONENTS,
         REACTPY_REGISTERED_COMPONENTS,
     )
 
-    if dotted_path in REACTPY_REGISTERED_COMPONENTS:
-        return REACTPY_REGISTERED_COMPONENTS[dotted_path]
-
+    dotted_path = (
+        component if isinstance(component, str) else generate_obj_name(component)
+    )
     try:
         REACTPY_REGISTERED_COMPONENTS[dotted_path] = import_dotted_path(dotted_path)
     except AttributeError as e:
@@ -102,22 +111,23 @@ def register_component(dotted_path: str) -> ComponentConstructor:
         raise ComponentDoesNotExistError(
             f"Error while fetching '{dotted_path}'. {(str(e).capitalize())}."
         ) from e
-    return REACTPY_REGISTERED_COMPONENTS[dotted_path]
 
 
 def register_iframe(view: Callable | View | str):
-    """Registers a view to be used as an iframe component."""
-    from reactpy_django.config import REACTPY_REGISTERED_IFRAME_VIEWS
+    """Registers a view to be used as an iframe component.
 
-    resolved_view: Callable | View
-    if isinstance(view, str):
-        resolved_view = import_dotted_path(view)
-        dotted_path = view
-    else:
-        resolved_view = view
-        dotted_path = generate_obj_name(view).replace("<", "").replace(">", "")
+    Args:
+        view: The view to register. Can be a function or class based view, or a dotted path to a view.
+    """
+    from reactpy_django.config import REACTPY_REGISTERED_IFRAME_VIEWS
 
-    REACTPY_REGISTERED_IFRAME_VIEWS[dotted_path] = resolved_view
+    dotted_path = view if isinstance(view, str) else generate_obj_name(view)
+    try:
+        REACTPY_REGISTERED_IFRAME_VIEWS[dotted_path] = import_dotted_path(dotted_path)
+    except AttributeError as e:
+        raise ViewDoesNotExistError(
+            f"Error while fetching '{dotted_path}'. {(str(e).capitalize())}."
+        ) from e
 
 
 def import_dotted_path(dotted_path: str) -> Callable:
diff --git a/tests/test_app/tests/test_components.py b/tests/test_app/tests/test_components.py
index 6be62c84..a5db4159 100644
--- a/tests/test_app/tests/test_components.py
+++ b/tests/test_app/tests/test_components.py
@@ -419,11 +419,9 @@ def test_component_errors(self):
             broken_component.wait_for()
             self.assertIn("SynchronousOnlyOperation:", broken_component.text_content())
 
-            # ComponentNotRegisteredError
+            # ViewNotRegisteredError
             broken_component = new_page.locator("#view_to_iframe_not_registered pre")
             broken_component.wait_for()
-            self.assertIn(
-                "ComponentNotRegisteredError:", broken_component.text_content()
-            )
+            self.assertIn("ViewNotRegisteredError:", broken_component.text_content())
         finally:
             new_page.close()

From 2b6615677bd921f77e6f647541fdc954ca56f586 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 03:22:08 -0700
Subject: [PATCH 21/28] clean up register component example

---
 docs/python/register-component.py | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/docs/python/register-component.py b/docs/python/register-component.py
index c8ad12e9..cbdbf789 100644
--- a/docs/python/register-component.py
+++ b/docs/python/register-component.py
@@ -2,7 +2,8 @@
 from reactpy_django.utils import register_component
 
 
-class ExampleConfig(AppConfig):
+class ExampleAppConfig(AppConfig):
+    name = "example"
+
     def ready(self):
-        # Add components to the ReactPy component registry when Django is ready
         register_component("example_project.my_app.components.hello_world")

From 376f7b787b54336e820a8d083bc663708f5c6821 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 03:37:56 -0700
Subject: [PATCH 22/28] remove dead types

---
 src/reactpy_django/types.py | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/reactpy_django/types.py b/src/reactpy_django/types.py
index 151b0709..0fc32544 100644
--- a/src/reactpy_django/types.py
+++ b/src/reactpy_django/types.py
@@ -17,7 +17,6 @@
 from django.db.models.base import Model
 from django.db.models.query import QuerySet
 from django.http import HttpRequest
-from reactpy.types import ComponentType, Key
 from reactpy.types import Connection as _Connection
 from typing_extensions import ParamSpec
 

From 0eb6e9033ac591add25f37e7d92a6eb085e00cdc Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 03:41:58 -0700
Subject: [PATCH 23/28] misc docs tweaks

---
 CHANGELOG.md                     | 2 +-
 docs/src/reference/components.md | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 75e872f4..5faf436f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -49,7 +49,7 @@ Using the following categories, list your changes in this order:
 ### Deprecated
 
 -   The `compatibility` argument on `reactpy_django.components.view_to_component` is deprecated. Use `reactpy_django.components.view_to_iframe` instead.
--   Using `reactpy_django.components.view_to_component` as a `#!python @decorator` is deprecated. Check the docs on the new suggested usage.
+-   Using `reactpy_django.components.view_to_component` as a decorator is deprecated. Check the docs on the new suggested usage.
 
 ## [3.5.1] - 2023-09-07
 
diff --git a/docs/src/reference/components.md b/docs/src/reference/components.md
index 2d96d8d8..ecdf540c 100644
--- a/docs/src/reference/components.md
+++ b/docs/src/reference/components.md
@@ -12,9 +12,9 @@ We supply some pre-designed that components can be used to help simplify develop
 
 Automatically convert a Django view into a component.
 
-At this time, this component works best with static views that do not rely on HTTP methods other than `GET`.
+At this time, this works best with static views that do not rely on HTTP methods other than `GET`.
 
-Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/topics/http/views/) and [Class Based Views](https://docs.djangoproject.com/en/dev/topics/class-based-views/). These views can be sync or async.
+Compatible with sync or async [Function Based Views](https://docs.djangoproject.com/en/dev/topics/http/views/) and [Class Based Views](https://docs.djangoproject.com/en/dev/topics/class-based-views/).
 
 === "components.py"
 
@@ -142,7 +142,7 @@ Automatically convert a Django view into an [`iframe` element](https://www.techt
 
 The contents of this `#!python iframe` is handled entirely by traditional Django view rendering. While this solution is compatible with more views than `#!python view_to_component`, it comes with different limitations.
 
-Compatible with [Function Based Views](https://docs.djangoproject.com/en/dev/topics/http/views/) and [Class Based Views](https://docs.djangoproject.com/en/dev/topics/class-based-views/). These views can be sync or async.
+Compatible with sync or async [Function Based Views](https://docs.djangoproject.com/en/dev/topics/http/views/) and [Class Based Views](https://docs.djangoproject.com/en/dev/topics/class-based-views/).
 
 !!! Warning "Pitfall"
 

From b52a40094877552594190835397b56b763daf3f0 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 04:30:44 -0700
Subject: [PATCH 24/28] remove thread sensitive

---
 src/reactpy_django/websocket/consumer.py | 4 +---
 tests/test_app/views.py                  | 6 +++---
 2 files changed, 4 insertions(+), 6 deletions(-)

diff --git a/src/reactpy_django/websocket/consumer.py b/src/reactpy_django/websocket/consumer.py
index c6a47c27..50b4b583 100644
--- a/src/reactpy_django/websocket/consumer.py
+++ b/src/reactpy_django/websocket/consumer.py
@@ -101,9 +101,7 @@ async def disconnect(self, code: int) -> None:
         if self.component_session:
             # Clean up expired component sessions
             try:
-                await database_sync_to_async(
-                    delete_expired_sessions, thread_sensitive=False
-                )()
+                await database_sync_to_async(delete_expired_sessions)()
             except Exception:
                 await asyncio.to_thread(
                     _logger.exception,
diff --git a/tests/test_app/views.py b/tests/test_app/views.py
index c31b9008..7af05f61 100644
--- a/tests/test_app/views.py
+++ b/tests/test_app/views.py
@@ -73,7 +73,7 @@ def get(self, request, *args, **kwargs):
 
 class ViewToComponentAsyncClass(View):
     async def get(self, request, *args, **kwargs):
-        return await database_sync_to_async(render, thread_sensitive=False)(
+        return await database_sync_to_async(render)(
             request,
             "view_to_component.html",
             {"test_name": self.__class__.__name__},
@@ -96,7 +96,7 @@ def view_to_component_sync_func_compatibility(request):
 
 
 async def view_to_component_async_func_compatibility(request):
-    return await database_sync_to_async(render, thread_sensitive=False)(
+    return await database_sync_to_async(render)(
         request,
         "view_to_component.html",
         {"test_name": inspect.currentframe().f_code.co_name},  # type:ignore
@@ -114,7 +114,7 @@ def get(self, request, *args, **kwargs):
 
 class ViewToComponentAsyncClassCompatibility(View):
     async def get(self, request, *args, **kwargs):
-        return await database_sync_to_async(render, thread_sensitive=False)(
+        return await database_sync_to_async(render)(
             request,
             "view_to_component.html",
             {"test_name": self.__class__.__name__},

From ea067e0f59466db288a0adb59559062880b6b077 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 05:10:59 -0700
Subject: [PATCH 25/28] Use .as_view() for CBVs

---
 docs/python/vtc-cbv.py           |  2 +-
 docs/python/vti-cbv.py           |  2 +-
 docs/src/reference/components.md |  8 +++-
 src/reactpy_django/components.py |  2 +
 src/reactpy_django/utils.py      | 64 +++++++++++++-------------------
 tests/test_app/components.py     | 16 +++++---
 6 files changed, 45 insertions(+), 49 deletions(-)

diff --git a/docs/python/vtc-cbv.py b/docs/python/vtc-cbv.py
index 244ad026..47509b75 100644
--- a/docs/python/vtc-cbv.py
+++ b/docs/python/vtc-cbv.py
@@ -3,7 +3,7 @@
 
 from . import views
 
-hello_world_component = view_to_component(views.HelloWorld)
+hello_world_component = view_to_component(views.HelloWorld.as_view())
 
 
 @component
diff --git a/docs/python/vti-cbv.py b/docs/python/vti-cbv.py
index ff2ce963..4e1f1b44 100644
--- a/docs/python/vti-cbv.py
+++ b/docs/python/vti-cbv.py
@@ -3,7 +3,7 @@
 
 from . import views
 
-hello_world_iframe = view_to_iframe(views.HelloWorld)
+hello_world_iframe = view_to_iframe(views.HelloWorld.as_view())
 
 
 @component
diff --git a/docs/src/reference/components.md b/docs/src/reference/components.md
index ecdf540c..65b94923 100644
--- a/docs/src/reference/components.md
+++ b/docs/src/reference/components.md
@@ -54,7 +54,9 @@ Compatible with sync or async [Function Based Views](https://docs.djangoproject.
 
 ??? question "How do I use this for Class Based Views?"
 
-    Class Based Views are accepted by `#!python view_to_component` as an argument. For example...
+    Class Based Views are accepted by `#!python view_to_component` as an argument.
+
+    Calling `#!python as_view()` is optional, but recommended.
 
     === "components.py"
 
@@ -195,7 +197,9 @@ Compatible with sync or async [Function Based Views](https://docs.djangoproject.
 
 ??? question "How do I use this for Class Based Views?"
 
-    Class Based Views are accepted by `#!python view_to_iframe` as an argument. For example...
+    Class Based Views are accepted by `#!python view_to_iframe` as an argument.
+
+    Calling `#!python as_view()` is optional, but recommended.
 
     === "components.py"
 
diff --git a/src/reactpy_django/components.py b/src/reactpy_django/components.py
index f01b1858..ab02e996 100644
--- a/src/reactpy_django/components.py
+++ b/src/reactpy_django/components.py
@@ -220,6 +220,8 @@ def _view_to_iframe(
     """The actual component. Used to prevent pollution of acceptable kwargs keys."""
     from reactpy_django.config import REACTPY_REGISTERED_IFRAME_VIEWS
 
+    if hasattr(view, "view_class"):
+        view = view.view_class
     dotted_path = view if isinstance(view, str) else generate_obj_name(view)
     registered_view = REACTPY_REGISTERED_IFRAME_VIEWS.get(dotted_path)
 
diff --git a/src/reactpy_django/utils.py b/src/reactpy_django/utils.py
index e2f15af0..922ce22a 100644
--- a/src/reactpy_django/utils.py
+++ b/src/reactpy_django/utils.py
@@ -5,10 +5,10 @@
 import logging
 import os
 import re
+from asyncio import iscoroutinefunction
 from datetime import timedelta
 from fnmatch import fnmatch
 from importlib import import_module
-from inspect import iscoroutinefunction
 from typing import Any, Callable, Sequence
 
 from asgiref.sync import async_to_sync
@@ -54,37 +54,21 @@ async def render_view(
     kwargs: dict,
 ) -> HttpResponse:
     """Ingests a Django view (class or function) and returns an HTTP response object."""
-    # Render Check 1: Async function view
-    if iscoroutinefunction(view) and callable(view):
+    # Convert class-based view to function-based view
+    if getattr(view, "as_view", None):
+        view = view.as_view()  # type: ignore[union-attr]
+
+    # Async function view
+    if iscoroutinefunction(view):
         response = await view(request, *args, **kwargs)
 
-    # Render Check 2: Async class view
-    elif getattr(view, "view_is_async", False):
-        # django-stubs does not support async views yet, so we have to ignore types here
-        view_or_template_view = await view.as_view()(request, *args, **kwargs)  # type: ignore
-        if getattr(view_or_template_view, "render", None):  # TemplateView
-            response = await view_or_template_view.render()
-        else:  # View
-            response = view_or_template_view
-
-    # Render Check 3: Sync class view
-    elif getattr(view, "as_view", None):
-        # MyPy does not know how to properly interpret this as a `View` type
-        # And `isinstance(view, View)` does not work due to some weird Django internal shenanigans
-        async_cbv = database_sync_to_async(view.as_view(), thread_sensitive=False)  # type: ignore
-        view_or_template_view = await async_cbv(request, *args, **kwargs)
-        if getattr(view_or_template_view, "render", None):  # TemplateView
-            response = await database_sync_to_async(
-                view_or_template_view.render, thread_sensitive=False
-            )()
-        else:  # View
-            response = view_or_template_view
-
-    # Render Check 4: Sync function view
+    # Sync function view
     else:
-        response = await database_sync_to_async(view, thread_sensitive=False)(
-            request, *args, **kwargs
-        )
+        response = await database_sync_to_async(view)(request, *args, **kwargs)
+
+    # TemplateView
+    if getattr(response, "render", None):
+        response = await database_sync_to_async(response.render)()
 
     return response
 
@@ -121,6 +105,8 @@ def register_iframe(view: Callable | View | str):
     """
     from reactpy_django.config import REACTPY_REGISTERED_IFRAME_VIEWS
 
+    if hasattr(view, "view_class"):
+        view = view.view_class
     dotted_path = view if isinstance(view, str) else generate_obj_name(view)
     try:
         REACTPY_REGISTERED_IFRAME_VIEWS[dotted_path] = import_dotted_path(dotted_path)
@@ -247,22 +233,22 @@ def register_components(self, components: set[str]) -> None:
                 )
 
 
-def generate_obj_name(object: Any) -> str:
+def generate_obj_name(obj: Any) -> str:
     """Makes a best effort to create a name for an object.
     Useful for JSON serialization of Python objects."""
 
-    # Attempt to use dunder methods to create a name
-    if hasattr(object, "__module__"):
-        if hasattr(object, "__name__"):
-            return f"{object.__module__}.{object.__name__}"
-        if hasattr(object, "__class__"):
-            return f"{object.__module__}.{object.__class__.__name__}"
+    # First attempt: Dunder methods
+    if hasattr(obj, "__module__"):
+        if hasattr(obj, "__name__"):
+            return f"{obj.__module__}.{obj.__name__}"
+        if hasattr(obj, "__class__") and hasattr(obj.__class__, "__name__"):
+            return f"{obj.__module__}.{obj.__class__.__name__}"
 
-    # First fallback: String representation
+    # Second attempt: String representation
     with contextlib.suppress(Exception):
-        return str(object)
+        return str(obj)
 
-    # Last fallback: Empty string
+    # Fallback: Empty string
     return ""
 
 
diff --git a/tests/test_app/components.py b/tests/test_app/components.py
index 473719b2..f7569307 100644
--- a/tests/test_app/components.py
+++ b/tests/test_app/components.py
@@ -448,10 +448,14 @@ async def on_change(event):
 
 view_to_component_sync_func = view_to_component(views.view_to_component_sync_func)
 view_to_component_async_func = view_to_component(views.view_to_component_async_func)
-view_to_component_sync_class = view_to_component(views.ViewToComponentSyncClass)
-view_to_component_async_class = view_to_component(views.ViewToComponentAsyncClass)
+view_to_component_sync_class = view_to_component(
+    views.ViewToComponentSyncClass.as_view()
+)
+view_to_component_async_class = view_to_component(
+    views.ViewToComponentAsyncClass.as_view()
+)
 view_to_component_template_view_class = view_to_component(
-    views.ViewToComponentTemplateViewClass
+    views.ViewToComponentTemplateViewClass.as_view()
 )
 _view_to_component_sync_func_compatibility = view_to_component(
     views.view_to_component_sync_func_compatibility, compatibility=True
@@ -460,13 +464,13 @@ async def on_change(event):
     views.view_to_component_async_func_compatibility, compatibility=True
 )
 _view_to_component_sync_class_compatibility = view_to_component(
-    views.ViewToComponentSyncClassCompatibility, compatibility=True
+    views.ViewToComponentSyncClassCompatibility.as_view(), compatibility=True
 )
 _view_to_component_async_class_compatibility = view_to_component(
-    views.ViewToComponentAsyncClassCompatibility, compatibility=True
+    views.ViewToComponentAsyncClassCompatibility.as_view(), compatibility=True
 )
 _view_to_component_template_view_class_compatibility = view_to_component(
-    views.ViewToComponentTemplateViewClassCompatibility, compatibility=True
+    views.ViewToComponentTemplateViewClassCompatibility.as_view(), compatibility=True
 )
 _view_to_iframe_args = view_to_iframe(views.view_to_iframe_args)
 _view_to_iframe_not_registered = view_to_iframe("view_does_not_exist")

From cad572081eda66347d497e6cc642921f0d1aefe4 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 06:00:52 -0700
Subject: [PATCH 26/28] update changelog

---
 CHANGELOG.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 5faf436f..cf739c05 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -45,6 +45,8 @@ Using the following categories, list your changes in this order:
 ### Changed
 
 -   Renamed undocumented utility function `reactpy_django.utils.ComponentPreloader` to `reactpy_django.utils.RootComponentFinder`.
+-   It is now recommended to call `as_view()` when using `view_to_component` or `view_to_iframe` with Class Based Views.
+-   Thread sensitivity has been enabled in all locations where ORM queries are possible.
 
 ### Deprecated
 

From b702eea429ce578df275403baec603c4ada467e1 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 17:54:56 -0700
Subject: [PATCH 27/28] fix broken example

---
 .github/workflows/test-docs.yml              | 4 +---
 docs/python/use-mutation-thread-sensitive.py | 2 +-
 2 files changed, 2 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/test-docs.yml b/.github/workflows/test-docs.yml
index 4793ef0e..9db27044 100644
--- a/.github/workflows/test-docs.yml
+++ b/.github/workflows/test-docs.yml
@@ -22,15 +22,13 @@ jobs:
                   python-version: 3.x
             - name: Check docs build
               run: |
-                  pip install -r requirements/build-docs.txt
+                  pip install -r requirements.txt
                   linkcheckMarkdown docs/ -v -r
                   linkcheckMarkdown README.md -v -r
                   linkcheckMarkdown CHANGELOG.md -v -r
                   mkdocs build --strict
             - name: Check docs examples
               run: |
-                  pip install -r requirements/check-types.txt
-                  pip install -r requirements/check-style.txt
                   mypy --show-error-codes docs/python/
                   black docs/python/ --check
                   ruff check docs/python/
diff --git a/docs/python/use-mutation-thread-sensitive.py b/docs/python/use-mutation-thread-sensitive.py
index ec07377e..d938c63d 100644
--- a/docs/python/use-mutation-thread-sensitive.py
+++ b/docs/python/use-mutation-thread-sensitive.py
@@ -3,7 +3,7 @@
 from reactpy_django.types import MutationOptions
 
 
-def execute_thread_safe_mutation():
+def execute_thread_safe_mutation(text):
     """This is an example mutation function that does some thread-safe operation."""
     pass
 

From bf768e05848923dc2d367a14661533cfe95dcee5 Mon Sep 17 00:00:00 2001
From: Archmonger <16909269+Archmonger@users.noreply.github.com>
Date: Sun, 24 Sep 2023 23:35:10 -0700
Subject: [PATCH 28/28] revert proper docs tests while `reactpy.html` type
 hints suck

---
 .github/workflows/test-docs.yml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/test-docs.yml b/.github/workflows/test-docs.yml
index 9db27044..4793ef0e 100644
--- a/.github/workflows/test-docs.yml
+++ b/.github/workflows/test-docs.yml
@@ -22,13 +22,15 @@ jobs:
                   python-version: 3.x
             - name: Check docs build
               run: |
-                  pip install -r requirements.txt
+                  pip install -r requirements/build-docs.txt
                   linkcheckMarkdown docs/ -v -r
                   linkcheckMarkdown README.md -v -r
                   linkcheckMarkdown CHANGELOG.md -v -r
                   mkdocs build --strict
             - name: Check docs examples
               run: |
+                  pip install -r requirements/check-types.txt
+                  pip install -r requirements/check-style.txt
                   mypy --show-error-codes docs/python/
                   black docs/python/ --check
                   ruff check docs/python/