ability to specify react version in template

Author: rmorshea

docs/source/guides/escape-hatches/_examples/material_ui_button_no_action.py

@@ -1,11 +1,17 @@
-import idom
+from idom import component, run, web
 
 
-mui = idom.web.module_from_template("react", "@material-ui/core@^5.0", fallback="⌛")
-Button = idom.web.export(mui, "Button")
-
-idom.run(
-    idom.component(
-        lambda: Button({"color": "primary", "variant": "contained"}, "Hello World!")
-    )
+mui = web.module_from_template(
+    "react@^17.0.0",
+    "@material-ui/[email protected]",
+    fallback="⌛",
 )
+Button = web.export(mui, "Button")
+
+
+@component
+def HelloWorld():
+    return Button({"color": "primary", "variant": "contained"}, "Hello World!")
+
+
+run(HelloWorld)

docs/source/guides/escape-hatches/_examples/material_ui_button_on_click.py

@@ -3,7 +3,11 @@
 import idom
 
 
-mui = idom.web.module_from_template("react", "@material-ui/core@^5.0", fallback="⌛")
+mui = idom.web.module_from_template(
+    "react@^17.0.0",
+    "@material-ui/[email protected]",
+    fallback="⌛",
+)
 Button = idom.web.export(mui, "Button")
 
 

src/idom/web/module.py

@@ -122,6 +122,10 @@ def module_from_template(
             Using this option has negative performance consequences since all DOM
             elements must be changed on each render. See :issue:`461` for more info.
     """
+    template_name, _, template_version = template.partition("@")
+    if template_version:
+        template_version = "@" + template_version
+
     # We do this since the package may be any valid URL path. Thus we may need to strip
     # object parameters or query information so we save the resulting template under the
     # correct file name.
@@ -131,7 +135,7 @@ def module_from_template(
     cdn = cdn.rstrip("/")
 
     template_file_name = (
-        template
+        template_name
         + (".default" if exports_default else "")
         + module_name_suffix(package_name)
     )
@@ -140,7 +144,7 @@ def module_from_template(
     if not template_file.exists():
         raise ValueError(f"No template for {template_file_name!r} exists")
 
-    variables = {"PACKAGE": package, "CDN": cdn}
+    variables = {"PACKAGE": package, "CDN": cdn, "VERSION": template_version}
     content = Template(template_file.read_text()).substitute(variables)
 
     return module_from_string(

src/idom/web/templates/react.js

@@ -1,7 +1,7 @@
 export * from "$CDN/$PACKAGE";
 
-import * as React from "$CDN/react";
-import * as ReactDOM from "$CDN/react-dom";
+import * as React from "$CDN/react$VERSION";
+import * as ReactDOM from "$CDN/react-dom$VERSION";
 
 export function bind(node, config) {
   return {