jx 0.2.0__tar.gz → 0.4.0__tar.gz

{jx-0.2.0/src/jx.egg-info → jx-0.4.0}/PKG-INFO

@@ -1,11 +1,10 @@
 Metadata-Version: 2.4
 Name: jx
-Version: 0.2.0
+Version: 0.4.0
 Summary: Replace your HTML templates with Python server-Side components
 Author-email: Juan Pablo Scaletti <juanpablo@jpscaletti.com>
-Project-URL: homepage, https://jx.scaletti.dev/
-Project-URL: repository, https://github.com/jpsca/jx
-Project-URL: documentation, https://jx.scaletti.dev/
+Project-URL: Code, https://github.com/jpsca/jx
+Project-URL: Documentation, https://jx.scaletti.dev/
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Web Environment
 Classifier: Intended Audience :: Developers
@@ -19,25 +18,22 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Software Development :: User Interfaces
 Classifier: Topic :: Text Processing :: Markup :: HTML
 Classifier: Typing :: Typed
-Requires-Python: <4,>=3.11
+Requires-Python: <4,>=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: jinja2>=3.0
-Requires-Dist: markupsafe>=2.0
-Requires-Dist: ty>=0.0.1a15
 Dynamic: license-file
 
-<h1>
-  <img src="https://github.com/jpsca/jx/raw/main/docs/logo-jx.png" height="100" align="top">
-</h1>
-
-Super components powers for your Jinja templates.
-
-<p>
-  <img alt="python: 3.11, 3.12, 3.13, 3.14" src="https://github.com/jpsca/jx/raw/main/docs/python.svg">
-  <img alt="license: MIT" src="https://github.com/jpsca/jx/raw/main/docs/license.svg">
+<div align="center">
+  <h1><img alt="Jx" src="https://raw.githubusercontent.com/jpsca/jx/main/docs/assets/images/logo-jx.png" height="100" align="top"></h1>
+</div>
+<p align="center">
+  <img alt="python: 3.12, 3.13, 3.14" src="https://raw.githubusercontent.com/jpsca/jx/main/docs/python.svg">
+  <img alt="license: MIT" src="https://raw.githubusercontent.com/jpsca/jx/main/docs/license.svg">
 </p>
 
+### Python server-side components
+
 From chaos to clarity: The power of components in your server-side-rendered Python web app.
 
 <!-- Documentation: https://jx.scaletti.dev/ -->

{jx-0.2.0 → jx-0.4.0}/README.md

@@ -1,14 +1,13 @@
-<h1>
-  <img src="https://github.com/jpsca/jx/raw/main/docs/logo-jx.png" height="100" align="top">
-</h1>
-
-Super components powers for your Jinja templates.
-
-<p>
-  <img alt="python: 3.11, 3.12, 3.13, 3.14" src="https://github.com/jpsca/jx/raw/main/docs/python.svg">
-  <img alt="license: MIT" src="https://github.com/jpsca/jx/raw/main/docs/license.svg">
+<div align="center">
+  <h1><img alt="Jx" src="https://raw.githubusercontent.com/jpsca/jx/main/docs/assets/images/logo-jx.png" height="100" align="top"></h1>
+</div>
+<p align="center">
+  <img alt="python: 3.12, 3.13, 3.14" src="https://raw.githubusercontent.com/jpsca/jx/main/docs/python.svg">
+  <img alt="license: MIT" src="https://raw.githubusercontent.com/jpsca/jx/main/docs/license.svg">
 </p>
 
+### Python server-side components
+
 From chaos to clarity: The power of components in your server-side-rendered Python web app.
 
 <!-- Documentation: https://jx.scaletti.dev/ -->

{jx-0.2.0 → jx-0.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ requires = ["setuptools"]
 
 [project]
 name = "jx"
-version = "0.2.0"
+version = "0.4.0"
 description = "Replace your HTML templates with Python server-Side components"
 authors = [
     {name = "Juan Pablo Scaletti", email = "juanpablo@jpscaletti.com"},
@@ -26,25 +26,24 @@ classifiers = [
     "Topic :: Text Processing :: Markup :: HTML",
     "Typing :: Typed",
 ]
-requires-python = ">=3.11,<4"
+requires-python = ">=3.12,<4"
 dependencies = [
     "jinja2 >= 3.0",
-    "markupsafe >= 2.0",
-    "ty>=0.0.1a15",
 ]
 
 [project.urls]
-homepage = "https://jx.scaletti.dev/"
-repository = "https://github.com/jpsca/jx"
-documentation = "https://jx.scaletti.dev/"
+Code = "https://github.com/jpsca/jx"
+Documentation = "https://jx.scaletti.dev/"
 
 [dependency-groups]
 dev = [
-    "ipdb >= 0.13",
+    "ipdb",
     "pre-commit",
-    "ruff >= 0.2.0",
     "tox-uv",
-    "ty>=0.0.1a15",
+    "ty",
+]
+docs = [
+    "writeadoc>=0.7.0",
 ]
 test = [
     "pytest >= 7.2",
@@ -56,6 +55,13 @@ test = [
 [tool.setuptools.packages.find]
 where = ["src"]
 
+
+[tool.ty.src]
+exclude = [
+    "docs",
+]
+
+
 [tool.coverage.run]
 branch = true
 
@@ -82,7 +88,6 @@ addopts = "--doctest-modules"
 legacy_tox_ini = """
 [tox]
 env_list =
-    3.11
     3.12
     3.13
     3.14
@@ -100,7 +105,7 @@ commands =
 [tool.ruff]
 line-length = 90
 indent-width = 4
-target-version = "py311"
+target-version = "py312"
 exclude = [
   ".*",
   "_build",

{jx-0.2.0 → jx-0.4.0}/src/jx/__init__.py

@@ -1,5 +1,6 @@
 """
-Jx | Copyright (c) Juan-Pablo Scaletti <juanpablo@jpscaletti.com>
+Jx | Copyright (c) Juan-Pablo Scaletti
 """
+
 from .catalog import CData, Catalog  # noqa
 from .exceptions import *  # noqa

{jx-0.2.0 → jx-0.4.0}/src/jx/attrs.py

@@ -1,7 +1,7 @@
 """
-Jx | Copyright (c) Juan-Pablo Scaletti <juanpablo@jpscaletti.com>
+Jx | Copyright (c) Juan-Pablo Scaletti
 """
-import re
+
 import typing as t
 from collections import UserString
 from functools import cached_property
@@ -14,10 +14,6 @@ CLASS_ALT_KEY = "classes"
 CLASS_KEYS = (CLASS_KEY, CLASS_ALT_KEY)
 
 
-def split(ssl: str) -> list[str]:
-    return re.split(r"\s+", ssl.strip())
-
-
 def quote(text: str) -> str:
     if '"' in text:
         if "'" in text:
@@ -45,6 +41,10 @@ class LazyString(UserString):
 
 
 class Attrs:
+    __classes: tuple[str, ...]
+    __attributes: dict[str, str | LazyString]
+    __properties: set[str]
+
     def __init__(self, attrs: "dict[str, t.Any| LazyString]") -> None:
         """
         Contains all the HTML attributes/properties (a property is an
@@ -62,11 +62,15 @@ class Attrs:
         attributes: "dict[str, str | LazyString]" = {}
         properties: set[str] = set()
 
-        class_names = split(" ".join([
+        class_names = (" ".join([
             str(attrs.pop(CLASS_KEY, "")),
             str(attrs.get(CLASS_ALT_KEY, "")),
-        ]))
-        self.__classes = {name for name in class_names if name}
+        ])).strip().split()
+        classes = []
+        for name in class_names:
+            if name and name not in classes:
+                classes.append(name)
+        self.__classes = tuple(classes)
 
         for name, value in attrs.items():
             if name.startswith("_"):
@@ -83,7 +87,7 @@ class Attrs:
     @property
     def classes(self) -> str:
         """
-        All the HTML classes alphabetically sorted and separated by a space.
+        All the HTML classes separated by a space.
 
         Example:
 
@@ -91,11 +95,11 @@ class Attrs:
             attrs = Attrs({"class": "italic bold bg-blue wide abcde"})
             attrs.set(class="bold text-white")
             print(attrs.classes)
-            abcde bg-blue bold italic text-white wide
+            italic bold bg-blue wide abcde text-white
             ```
 
         """
-        return " ".join(sorted((self.__classes)))
+        return " ".join(self.__classes)
 
     @property
     def as_dict(self) -> dict[str, t.Any]:
@@ -116,7 +120,7 @@ class Attrs:
             attrs.as_dict
             {
                 "aria_label": "hello",
-                "class": "ipsum lorem",
+                "class": "lorem ipsum",
                 "id": "world",
                 "data_test": True,
                 "hidden": True
@@ -155,8 +159,6 @@ class Attrs:
         - The underscores in the names will be translated automatically to dashes,
           so `aria_selected` becomes the attribute `aria-selected`.
 
-        TODO: vue-style
-
         Example:
 
             ```python
@@ -172,7 +174,7 @@ class Attrs:
             attrs = Attrs({"class": "b c a"})
             attrs.set(class="c b f d e")
             attrs.as_dict
-            {"class": "a b c d e f"}
+            {"class": "b c a f d e"}
             ```
 
         """
@@ -212,7 +214,9 @@ class Attrs:
                 continue
 
             if name in CLASS_KEYS:
-                self.add_class(value)
+                if not self.__classes:
+                    self.add_class(value)
+                continue
 
             name = name.replace("_", "-")
             if name not in self.__attributes:
@@ -220,10 +224,10 @@ class Attrs:
 
     def add_class(self, *values: str) -> None:
         """
-        Adds one or more classes to the list of classes, if not already present.
+        Adds one or more classes to the end of the list of classes,
+        if not already present.
 
         Arguments:
-
             values:
                 One or more class names to add, separated by spaces.
 
@@ -231,15 +235,44 @@ class Attrs:
 
             ```python
             attrs = Attrs({"class": "a b c"})
-            attrs.add_class("c", "d")
+            attrs.add_class("c d")
             attrs.as_dict
             {"class": "a b c d"}
             ```
 
         """
         for names in values:
-            for name in split(names):
-                self.__classes.add(name)
+            for name in names.strip().split():
+                if name not in self.__classes:
+                    self.__classes += (name,)
+
+    def prepend_class(self, *values: str) -> None:
+        """
+        Adds one or more classes to the beginning of the list of classes,
+        if not already present.
+
+        Arguments:
+            values:
+                One or more class names to add, separated by spaces.
+
+        Example:
+
+            ```python
+            attrs = Attrs({"class": "a b c"})
+            attrs.add_class("c d |")
+            attrs.as_dict
+            {"class": "d | a b c"}
+            ```
+
+        """
+        new_classes = [
+            name
+            for names in values
+            for name in names.strip().split()
+            if name not in self.__classes
+        ]
+
+        self.__classes = tuple(new_classes) + self.__classes
 
     def remove_class(self, *names: str) -> None:
         """
@@ -255,8 +288,7 @@ class Attrs:
             ```
 
         """
-        for name in names:
-            self.__classes.remove(name)
+        self.__classes = tuple(c for c in self.__classes if c not in names)
 
     def get(self, name: str, default: t.Any = None) -> t.Any:
         """
@@ -358,7 +390,7 @@ class Attrs:
         Removes an attribute or property.
         """
         if name in CLASS_KEYS:
-            self.__classes = set()
+            self.__classes = ()
         if name in self.__attributes:
             del self.__attributes[name]
         if name in self.__properties:

{jx-0.2.0 → jx-0.4.0}/src/jx/catalog.py

@@ -1,6 +1,7 @@
 """
-Jx | Copyright (c) Juan-Pablo Scaletti <juanpablo@jpscaletti.com>
+Jx | Copyright (c) Juan-Pablo Scaletti
 """
+
 import typing as t
 from dataclasses import dataclass, field
 from pathlib import Path
@@ -23,7 +24,7 @@ class CData:
     mtime: float
     code: CodeType | None = None
     required: tuple[str, ...] = ()
-    optional: dict[str, t.Any] = field(default_factory=dict) # { attr: default_value }
+    optional: dict[str, t.Any] = field(default_factory=dict)  # { attr: default_value }
     imports: dict[str, str] = field(default_factory=dict)  # { name: relpath }
     css: tuple[str, ...] = ()
     js: tuple[str, ...] = ()
@@ -31,8 +32,9 @@ class CData:
 
 
 class Catalog:
+
     # IDEA: This dict could be replaced by a dict-like object
-    # that usesa LRU cache (to limit the memory used)
+    # that uses a LRU cache (to limit the memory used)
     # or even a shared Redis/Memcache cache.
     components: dict[str, CData]
 
@@ -40,11 +42,11 @@ class Catalog:
         self,
         folder: str | Path | None = None,
         *,
-        auto_reload: bool = True,
         jinja_env: jinja2.Environment | None = None,
+        extensions: list | None = None,
         filters: dict[str, t.Any] | None = None,
         tests: dict[str, t.Any] | None = None,
-        extensions: list | None = None,
+        auto_reload: bool = True,
         **globals: t.Any,
     ) -> None:
         """
@@ -54,19 +56,19 @@ class Catalog:
             folder:
                 Optional folder path to scan for components. It's a shortcut to
                 calling `add_folder` when only one is used.
-            auto_reload:
-                Whether to check the last-modified time of the components files and
-                automatically re-process them if they change. The performance impact of
-                leaving it on is minimal, but *might* be noticeable when rendering a page
-                that uses a large number of different components.
             jinja_env:
                 Optional Jinja2 environment to use for rendering.
-            filters:
-                Optional extra Jinja2 filters to add to the environment.
             extensions:
                 Optional extra Jinja2 extensions to add to the environment.
+            filters:
+                Optional extra Jinja2 filters to add to the environment.
             tests:
                 Optional extra Jinja2 tests to add to the environment.
+            auto_reload:
+                Whether to check the last-modified time of the components files and
+                automatically re-process them if they change. The performance impact of
+                leaving it on is minimal, but *might* be noticeable when rendering a
+                component that uses a large number of child components.
             **globals:
                 Variables to make available to all components by default.
 
@@ -84,11 +86,7 @@ class Catalog:
             self.add_folder(folder)
 
     def add_folder(
-        self,
-        path: str | Path,
-        *,
-        prefix: str = "",
-        preload: bool = True
+        self, path: str | Path, *, prefix: str = "", preload: bool = True
     ) -> None:
         """
         Add a folder path from which to search for components, optionally under a prefix.
@@ -141,9 +139,7 @@ class Catalog:
                 logger.debug(f"Component already exists: {relpath}")
                 continue
             cdata = CData(
-                base_path=base_path,
-                path=filepath,
-                mtime=filepath.stat().st_mtime
+                base_path=base_path, path=filepath, mtime=filepath.stat().st_mtime
             )
             self.components[relpath] = cdata
 
@@ -151,7 +147,9 @@ class Catalog:
             for relpath in self.components:
                 self.components[relpath] = self.get_component_data(relpath)
 
-    def render(self, relpath: str, globals: dict[str, t.Any] | None = None, **kwargs) -> str:
+    def render(
+        self, relpath: str, globals: dict[str, t.Any] | None = None, **kwargs
+    ) -> str:
         """
         Render a component with the given relative path and context.
 
@@ -173,6 +171,64 @@ class Catalog:
         relpath = relpath.replace("\\", "/").strip("/")
         co = self.get_component(relpath)
 
+        globals = globals or {}
+        globals.update(
+            {
+                "assets": {
+                    "css": co.collect_css,
+                    "js": co.collect_js,
+                    "render_css": co.render_css,
+                    "render_js": co.render_js,
+                    "render": co.render_assets,
+                },
+            }
+        )
+        co.globals = globals
+
+        return co.render(**kwargs)
+
+    def render_string(
+        self, source: str, globals: dict[str, t.Any] | None = None, **kwargs
+    ) -> str:
+        """
+        Render a component from a string source.
+        Works like `render`, but the component is not cached and cannot do relative imports.
+
+        Arguments:
+            source:
+                The Jinja2 source code of the component to render.
+            globals:
+                Optional global variables to make available to the component and all its
+                imported components.
+            **kwargs:
+                Keyword arguments to pass to the component.
+                They will be available in the component's context but not to its imported components.
+
+        Returns:
+            The rendered component as a string.
+
+        """
+        meta = extract_metadata(source, base_path=Path(), fullpath=Path())
+        name = "<string>"
+
+        parser = JxParser(name=name, source=source, components=list(meta.imports.keys()))
+        parsed_source, slots = parser.parse()
+
+        code = self.jinja_env.compile(source=parsed_source, name=name, filename=name)
+        tmpl = jinja2.Template.from_code(self.jinja_env, code, self.jinja_env.globals)
+
+        co = Component(
+            relpath=name,
+            tmpl=tmpl,
+            get_component=self.get_component,
+            required=meta.required,
+            optional=meta.optional,
+            imports=meta.imports,
+            css=meta.css,
+            js=meta.js,
+            slots=slots,
+        )
+
         globals = globals or {}
         globals.update({
             "assets": {
@@ -181,7 +237,7 @@ class Catalog:
                 "render_css": co.render_css,
                 "render_js": co.render_js,
                 "render": co.render_assets,
-            },
+            }
         })
         co.globals = globals
 
@@ -189,8 +245,8 @@ class Catalog:
 
     def get_component_data(self, relpath: str) -> CData:
         """
-        Get the component data from the cache, or load it from the file system
-        if needed.
+        Get the component data from the cache.
+        If the file has been updated, the component is re-processed.
 
         Arguments:
             relpath:
@@ -214,15 +270,11 @@ class Catalog:
         meta = extract_metadata(source, base_path=cdata.base_path, fullpath=cdata.path)
 
         parser = JxParser(
-            name=relpath,
-            source=source,
-            components=list(meta.imports.keys())
+            name=relpath, source=source, components=list(meta.imports.keys())
         )
         parsed_source, slots = parser.parse()
         code = self.jinja_env.compile(
-            source=parsed_source,
-            name=relpath,
-            filename=cdata.path.as_posix()
+            source=parsed_source, name=relpath, filename=cdata.path.as_posix()
         )
 
         cdata.code = code
@@ -247,9 +299,7 @@ class Catalog:
         cdata = self.get_component_data(relpath)
         assert cdata.code is not None
         tmpl = jinja2.Template.from_code(
-            self.jinja_env,
-            cdata.code,
-            self.jinja_env.globals
+            self.jinja_env, cdata.code, self.jinja_env.globals
         )
 
         co = Component(
@@ -279,9 +329,6 @@ class Catalog:
         """
         Create a new Jinja2 environment with the specified settings.
 
-        If an existing environment is provided, an "overlay" of it will
-        be created and used.
-
         Arguments:
             jinja_env:
                 Optional Jinja2 environment to use as a base.
@@ -297,16 +344,21 @@ class Catalog:
         """
         jinja_env = jinja_env or getattr(self, "jinja_env", None)
         if jinja_env:
-            env = jinja_env.overlay()
+            # It could be `jinja_env.overlay()` instead, but that might
+            # might lead to confusion if the user expects changes
+            # to the original environment to be reflected here.
+            env = jinja_env
         else:
             env = jinja2.Environment()
 
         globals = globals or {}
-        globals.update({
-            # A unique ID generator for HTML elements, see `utils.get_random_id`
-            # docstring for more information.
-            "_get_random_id": utils.get_random_id,
-        })
+        globals.update(
+            {
+                # A unique ID generator for HTML elements, see `utils.get_random_id`
+                # docstring for more information.
+                "_get_random_id": utils.get_random_id,
+            }
+        )
         env.globals.update(globals)
 
         filters = filters or {}

{jx-0.2.0 → jx-0.4.0}/src/jx/component.py

@@ -1,7 +1,7 @@
 """
-Jx | Copyright (c) Juan-Pablo Scaletti <juanpablo@jpscaletti.com>
+Jx | Copyright (c) Juan-Pablo Scaletti
 """
-import re
+
 import typing as t
 from collections.abc import Callable
 
@@ -12,9 +12,6 @@ from .attrs import Attrs
 from .exceptions import MissingRequiredArgument
 
 
-rx_external_url = re.compile(r"^[a-z]+://", re.IGNORECASE)
-
-
 class Component:
     __slots__ = (
         "relpath",
@@ -85,7 +82,7 @@ class Component:
         content: str | None = None,
         attrs: Attrs | dict[str, t.Any] | None = None,
         caller: Callable[[str], str] | None = None,
-        **params: t.Any
+        **params: t.Any,
     ) -> Markup:
         content = content if content is not None else caller("") if caller else ""
         attrs = attrs.as_dict if isinstance(attrs, Attrs) else attrs or {}

{jx-0.2.0 → jx-0.4.0}/src/jx/exceptions.py

@@ -1,7 +1,8 @@
 """
-Jx | Copyright (c) Juan-Pablo Scaletti <juanpablo@jpscaletti.com>
+Jx | Copyright (c) Juan-Pablo Scaletti
 """
 
+
 class JxException(Exception):
     """Base class for all Jx exceptions."""
 
@@ -18,6 +19,7 @@ class ImportError(JxException):
     Raised when an import fails.
     This is usually caused by a missing or inaccessible component.
     """
+
     def __init__(self, relpath: str, **kw) -> None:
         msg = f"Component not found: {relpath}"
         super().__init__(msg, **kw)

{jx-0.2.0 → jx-0.4.0}/src/jx/meta.py

@@ -1,6 +1,7 @@
 """
-Jx | Copyright (c) Juan-Pablo Scaletti <juanpablo@jpscaletti.com>
+Jx | Copyright (c) Juan-Pablo Scaletti
 """
+
 import ast
 import re
 import typing as t
@@ -56,9 +57,9 @@ def extract_metadata(source: str, base_path: Path, fullpath: Path) -> Meta:
         source:
             The template source code.
         base_path:
-            Absolute base path for all the template files
+            Absolute base path for all the template files, for relative imports.
         fullpath:
-            The absolute full path of the current template.
+            The absolute full path of the current template, for relative imports.
 
     Returns:
         A `Meta` object containing the extracted metadata.

{jx-0.2.0 → jx-0.4.0}/src/jx/parser.py

@@ -1,5 +1,5 @@
 """
-Jx | Copyright (c) Juan-Pablo Scaletti <juanpablo@jpscaletti.com>
+Jx | Copyright (c) Juan-Pablo Scaletti
 """
 
 import re
@@ -24,7 +24,7 @@ RX_TAG_NAME = re.compile(rf"<(?P<tag>{re_tag_name})(\s|\n|/|>)")
 re_attr_name = r""
 re_equal = r""
 re_attr = r"""
-(?P<name>[:a-zA-Z@$_][a-zA-Z@:$_0-9-]*)
+(?P<name>[:a-zA-Z@$_][a-zA-Z@:$_0-9-\.]*)
 (?:
     \s*=\s*
     (?P<value>".*?"|'.*?'|\{\{.*?\}\})

{jx-0.2.0 → jx-0.4.0}/src/jx/utils.py

@@ -1,6 +1,7 @@
 """
-Jx | Copyright (c) Juan-Pablo Scaletti <juanpablo@jpscaletti.com>
+Jx | Copyright (c) Juan-Pablo Scaletti
 """
+
 import logging
 import uuid
 

{jx-0.2.0 → jx-0.4.0/src/jx.egg-info}/PKG-INFO

@@ -1,11 +1,10 @@
 Metadata-Version: 2.4
 Name: jx
-Version: 0.2.0
+Version: 0.4.0
 Summary: Replace your HTML templates with Python server-Side components
 Author-email: Juan Pablo Scaletti <juanpablo@jpscaletti.com>
-Project-URL: homepage, https://jx.scaletti.dev/
-Project-URL: repository, https://github.com/jpsca/jx
-Project-URL: documentation, https://jx.scaletti.dev/
+Project-URL: Code, https://github.com/jpsca/jx
+Project-URL: Documentation, https://jx.scaletti.dev/
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Web Environment
 Classifier: Intended Audience :: Developers
@@ -19,25 +18,22 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Software Development :: User Interfaces
 Classifier: Topic :: Text Processing :: Markup :: HTML
 Classifier: Typing :: Typed
-Requires-Python: <4,>=3.11
+Requires-Python: <4,>=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: jinja2>=3.0
-Requires-Dist: markupsafe>=2.0
-Requires-Dist: ty>=0.0.1a15
 Dynamic: license-file
 
-<h1>
-  <img src="https://github.com/jpsca/jx/raw/main/docs/logo-jx.png" height="100" align="top">
-</h1>
-
-Super components powers for your Jinja templates.
-
-<p>
-  <img alt="python: 3.11, 3.12, 3.13, 3.14" src="https://github.com/jpsca/jx/raw/main/docs/python.svg">
-  <img alt="license: MIT" src="https://github.com/jpsca/jx/raw/main/docs/license.svg">
+<div align="center">
+  <h1><img alt="Jx" src="https://raw.githubusercontent.com/jpsca/jx/main/docs/assets/images/logo-jx.png" height="100" align="top"></h1>
+</div>
+<p align="center">
+  <img alt="python: 3.12, 3.13, 3.14" src="https://raw.githubusercontent.com/jpsca/jx/main/docs/python.svg">
+  <img alt="license: MIT" src="https://raw.githubusercontent.com/jpsca/jx/main/docs/license.svg">
 </p>
 
+### Python server-side components
+
 From chaos to clarity: The power of components in your server-side-rendered Python web app.
 
 <!-- Documentation: https://jx.scaletti.dev/ -->

jx-0.4.0/src/jx.egg-info/requires.txt

@@ -0,0 +1 @@
+jinja2>=3.0

{jx-0.2.0 → jx-0.4.0}/tests/test_attrs.py

@@ -1,6 +1,7 @@
 """
-Jx | Copyright (c) Juan-Pablo Scaletti <juanpablo@jpscaletti.com>
+Jx | Copyright (c) Juan-Pablo Scaletti
 """
+
 import pytest
 
 from jx.attrs import Attrs
@@ -19,8 +20,8 @@ def test_parse_initial_attrs():
             "_content": "content",
         }
     )
-    assert attrs.classes == "a1 b2 c3 z4"
-    assert attrs.get("class") == "a1 b2 c3 z4"
+    assert attrs.classes == "z4 c3 a1 b2"
+    assert attrs.get("class") == "z4 c3 a1 b2"
     assert attrs.get("data-position") == "top"
     assert attrs.get("data_position") == "top"
     assert attrs.get("title") == "hi"
@@ -37,6 +38,7 @@ def test_parse_initial_attrs():
     assert attrs.get("data-position") is None
     assert attrs.get("data_position") is None
 
+
 def test_getattr():
     attrs = Attrs(
         {
@@ -45,7 +47,7 @@ def test_getattr():
             "open": True,
         }
     )
-    assert attrs["class"] == "a1 b2 c3 z4"
+    assert attrs["class"] == "z4 c3 a1 b2"
     assert attrs["title"] == "hi"
     assert attrs["open"] is True
     assert attrs["lorem"] is None
@@ -59,7 +61,7 @@ def test_deltattr():
             "open": True,
         }
     )
-    assert attrs["class"] == "a1 b2 c3 z4"
+    assert attrs["class"] == "z4 c3 a1 b2"
     del attrs["title"]
     assert attrs["title"] is None
 
@@ -74,7 +76,7 @@ def test_render():
             "disabled": False,
         }
     )
-    assert 'class="a1 b2 c3 z4" data-position="top" title="hi" open' == attrs.render()
+    assert 'class="z4 c3 a1 b2" data-position="top" title="hi" open' == attrs.render()
 
 
 def test_set():
@@ -90,15 +92,18 @@ def test_set():
 def test_class_management():
     attrs = Attrs(
         {
-            "class": "z4 c3 a1 z4 b2",
+            "class": "z4 c3  a1  z4  b2",
         }
     )
     attrs.set(classes="lorem bipsum lorem a1")
 
-    assert attrs.classes == "a1 b2 bipsum c3 lorem z4"
+    assert attrs.classes == "z4 c3 a1 b2 lorem bipsum"
 
-    attrs.remove_class("bipsum")
-    assert attrs.classes == "a1 b2 c3 lorem z4"
+    attrs.remove_class("lorem")
+    assert attrs.classes == "z4 c3 a1 b2 bipsum"
+
+    attrs.prepend_class("button |", "wat")
+    assert attrs.classes == "button | wat z4 c3 a1 b2 bipsum"
 
     attrs.set(classes=None)
     attrs.set(classes="meh")
@@ -121,11 +126,11 @@ def test_setdefault():
 
 
 def test_setdefault_classes():
-    attrs = Attrs(
-        {
-            "class": "a",
-        }
-    )
+    attrs = Attrs({"class": "a"})
+    attrs.setdefault(classes="a b c")
+    assert 'class="a"' == attrs.render()
+
+    attrs = Attrs({})
     attrs.setdefault(classes="a b c")
     assert 'class="a b c"' == attrs.render()
 
@@ -141,7 +146,7 @@ def test_as_dict():
         }
     )
     assert attrs.as_dict == {
-        "class": "a1 b2 c3 z4",
+        "class": "z4 c3 a1 b2",
         "data-position": "top",
         "title": "hi",
         "open": True,
@@ -165,7 +170,7 @@ def test_as_dict_no_classes():
 
 def test_render_attrs_lik_set():
     attrs = Attrs({"class": "lorem"})
-    expected = 'class="ipsum lorem" data-position="top" title="hi" open'
+    expected = 'class="lorem ipsum" data-position="top" title="hi" open'
     result = attrs.render(
         title="hi",
         data_position="top",
@@ -178,7 +183,7 @@ def test_render_attrs_lik_set():
 
 def test_do_not_escape_tailwind_syntax():
     attrs = Attrs({"class": "lorem [&_a]:flex"})
-    expected = 'class="[&_a]:flex ipsum lorem" title="Hi&Stuff"'
+    expected = 'class="lorem [&_a]:flex ipsum" title="Hi&Stuff"'
     result = attrs.render(
         **{
             "title": "Hi&Stuff",

{jx-0.2.0 → jx-0.4.0}/tests/test_catalog.py

@@ -1,6 +1,7 @@
 """
-Jx | Copyright (c) Juan-Pablo Scaletti <juanpablo@jpscaletti.com>
+Jx | Copyright (c) Juan-Pablo Scaletti
 """
+
 import jinja2
 import pytest
 
@@ -27,6 +28,27 @@ def test_add_folder(folder):
     assert catalog.components["b.jinja"].code is not None
 
 
+def test_add_folder_no_preload(folder):
+    (folder / "a.jinja").write_text("AAAAA")
+    (folder / "b.jinja").write_text("BBBBB")
+
+    catalog = Catalog()
+    catalog.add_folder(folder, preload=False)
+
+    assert "a.jinja" in catalog.components
+    assert "b.jinja" in catalog.components
+
+    assert catalog.components["a.jinja"].base_path == folder
+    assert catalog.components["a.jinja"].path == folder / "a.jinja"
+    assert catalog.components["a.jinja"].mtime > 0
+    assert catalog.components["a.jinja"].code is None
+
+    assert catalog.components["b.jinja"].base_path == folder
+    assert catalog.components["b.jinja"].path == folder / "b.jinja"
+    assert catalog.components["b.jinja"].mtime > 0
+    assert catalog.components["b.jinja"].code is None
+
+
 def test_add_folder_nested(tmp_path):
     folder = tmp_path / "views"
     nested = folder / "a" / "b" / "c"

{jx-0.2.0 → jx-0.4.0}/tests/test_component.py

@@ -1,6 +1,7 @@
 """
-Jx | Copyright (c) Juan-Pablo Scaletti <juanpablo@jpscaletti.com>
+Jx | Copyright (c) Juan-Pablo Scaletti
 """
+
 import pytest
 
 from jx import Catalog, MissingRequiredArgument, TemplateSyntaxError
@@ -17,6 +18,17 @@ def test_render_simple(folder):
     assert html.strip() == '<button id="btn1">Submit</button>'
 
 
+def test_render_simple_from_string():
+    source = """
+{# def bid, text="Click me!" #}
+<button id="{{ bid }}">{{ text }}</button>
+"""
+
+    cat = Catalog()
+    html = cat.render_string(source, bid="btn1", text="Submit")
+    assert html.strip() == '<button id="btn1">Submit</button>'
+
+
 def test_render_content(folder):
     (folder / "child.jinja").write_text("""
 <span>{{ content }}</span>
@@ -32,6 +44,19 @@ def test_render_content(folder):
     assert html.strip() == "<div><span>Hello</span></div>"
 
 
+def test_render_content_from_string(folder):
+    (folder / "child.jinja").write_text("""
+<span>{{ content }}</span>
+""")
+    source = """
+{# import "child.jinja" as Child #}
+<div><Child>Hello</Child></div>
+"""
+    cat = Catalog(folder)
+    html = cat.render_string(source)
+    assert html.strip() == "<div><span>Hello</span></div>"
+
+
 def test_render_custom_content(folder):
     (folder / "child.jinja").write_text("""
 <span>{{ content }}</span>
@@ -142,6 +167,21 @@ def test_render_globals(folder):
     assert cat.render("page.jinja") == '<div class="ipsum"><p>ipsum</p></div>'
 
 
+def test_render_globals_from_string(folder):
+    (folder / "child.jinja").write_text("""<p>{{ lorem }}</p>""")
+
+    (folder / "layout.jinja").write_text("""<div class="{{ lorem }}">{{ content }}</div>""")
+
+    source = """
+{# import "layout.jinja" as Layout #}
+{# import "child.jinja" as Child #}
+<Layout><Child /></Layout>
+"""
+
+    cat = Catalog(folder, lorem="ipsum")
+    assert cat.render_string(source) == '<div class="ipsum"><p>ipsum</p></div>'
+
+
 def test_collect_assets(folder):
     (folder / "child.jinja").write_text("""
 {# css "child.css", "/static/common/parent.css" #}
@@ -433,3 +473,30 @@ AFTER
 <link rel="stylesheet" href="before.css">
 BEFORE
 """.strip()
+
+
+def test_alpine_sintax(folder):
+    (folder / "greeting.jinja").write_text("""
+{#def message #}
+<button @click.prevent="alert('{{ message }}')">Say Hi</button>""")
+    cat = Catalog(folder, auto_reload=False)
+
+    html = cat.render("greeting.jinja", message="Hello world!")
+    print(html)
+    assert html == """<button @click.prevent="alert('Hello world!')">Say Hi</button>"""
+
+
+def test_alpine_sintax_in_component(folder):
+    (folder / "button.jinja").write_text(
+        """<button {{ attrs.render() }}>{{ content }}</button>"""
+    )
+
+    (folder / "greeting.jinja").write_text("""
+{# import "button.jinja" as Button #}
+<Button @click.prevent="alert('Hello world!')">Say Hi</Button>
+""")
+    cat = Catalog(folder, auto_reload=False)
+
+    html = cat.render("greeting.jinja")
+    print(html)
+    assert html == """<button @click.prevent="alert('Hello world!')">Say Hi</button>"""

{jx-0.2.0 → jx-0.4.0}/tests/test_meta.py

@@ -1,6 +1,7 @@
 """
-Jx | Copyright (c) Juan-Pablo Scaletti <juanpablo@jpscaletti.com>
+Jx | Copyright (c) Juan-Pablo Scaletti
 """
+
 from pathlib import Path
 
 import pytest

{jx-0.2.0 → jx-0.4.0}/tests/test_parser.py

@@ -1,6 +1,7 @@
 """
-Jx | Copyright (c) Juan-Pablo Scaletti <juanpablo@jpscaletti.com>
+Jx | Copyright (c) Juan-Pablo Scaletti
 """
+
 import pytest
 
 from jx import TemplateSyntaxError

{jx-0.2.0 → jx-0.4.0}/tests/test_slots.py

@@ -1,6 +1,7 @@
 """
-Jx | Copyright (c) Juan-Pablo Scaletti <juanpablo@jpscaletti.com>
+Jx | Copyright (c) Juan-Pablo Scaletti
 """
+
 from jx import Catalog
 
 

{jx-0.2.0 → jx-0.4.0}/tests/test_thread_safety.py

@@ -1,6 +1,7 @@
 """
-Jx | Copyright (c) Juan-Pablo Scaletti <juanpablo@jpscaletti.com>
+Jx | Copyright (c) Juan-Pablo Scaletti
 """
+
 from threading import Thread
 
 from jx import Catalog

jx-0.2.0/src/jx.egg-info/requires.txt

@@ -1,3 +0,0 @@
-jinja2>=3.0
-markupsafe>=2.0
-ty>=0.0.1a15