eidosui 0.4.0__tar.gz → 0.5.0__tar.gz

eidosui-0.5.0/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: eidosui
+Version: 0.5.0
+Summary: A modern, Tailwind CSS-based UI library for air development
+Project-URL: Homepage, https://github.com/isaac-flath/EidosUI
+Project-URL: Repository, https://github.com/isaac-flath/EidosUI
+Project-URL: Issues, https://github.com/isaac-flath/EidosUI/issues
+Project-URL: Documentation, https://github.com/isaac-flath/EidosUI#readme
+Author: Isaac Flath
+License-Expression: MIT
+License-File: LICENSE
+Keywords: air,components,css,fastapi,tailwind,ui,web
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: air>=0.12
+Requires-Dist: fastapi[standard]
+Requires-Dist: uvicorn
+Provides-Extra: dev
+Requires-Dist: black; extra == 'dev'
+Requires-Dist: isort; extra == 'dev'
+Requires-Dist: mypy; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Provides-Extra: markdown
+Requires-Dist: markdown>=3.4; extra == 'markdown'
+Description-Content-Type: text/markdown
+
+# EidosUI
+
+Modern UI library for Python web frameworks. Built on Air and Tailwind CSS.
+
+> [!CAUTION]
+> This library is in alpha, and may have semi-frequent breaking changes.  I'd love for you to try it an contribute feedback or PRs!
+
+## Installation
+
+```bash
+pip install eidosui
+```
+
+## Quick Start
+
+```python
+from eidos import *
+import air
+
+app = air.Air()
+
+@app.get("/")
+def home():
+    return Html(
+        Head(
+            Title("My App"),
+            *EidosHeaders()  # Required CSS/JS
+        ),
+        Body(
+            H1("Welcome"),
+            P("Build modern web apps with Python."),
+            DataTable.from_lists(
+                [["Alice", "30"], ["Bob", "25"]], 
+                headers=["Name", "Age"]
+            )
+        )
+    )
+
+app.run()
+```
+
+## Features
+
+- **Styled HTML tags** - Pre-styled versions of all HTML elements
+- **Components** - DataTable, NavBar, and more  
+- **Themes** - Light/dark themes via CSS variables
+- **Type hints** - Full type annotations
+- **Air integration** - Works seamlessly with Air framework
+
+## Plugins
+
+### Markdown
+
+```bash
+pip install "eidosui[markdown]"
+```
+
+```python
+from eidos.plugins.markdown import Markdown, MarkdownCSS
+
+Head(
+    *EidosHeaders(),
+    MarkdownCSS()  # Add markdown styles
+)
+
+Body(
+    Markdown("# Hello\n\nSupports **GitHub Flavored Markdown**")
+)
+```
+
+## Documentation
+
+Full documentation: https://eidosui.readthedocs.io
+
+## License
+
+MIT

eidosui-0.5.0/README.md

@@ -0,0 +1,77 @@
+# EidosUI
+
+Modern UI library for Python web frameworks. Built on Air and Tailwind CSS.
+
+> [!CAUTION]
+> This library is in alpha, and may have semi-frequent breaking changes.  I'd love for you to try it an contribute feedback or PRs!
+
+## Installation
+
+```bash
+pip install eidosui
+```
+
+## Quick Start
+
+```python
+from eidos import *
+import air
+
+app = air.Air()
+
+@app.get("/")
+def home():
+    return Html(
+        Head(
+            Title("My App"),
+            *EidosHeaders()  # Required CSS/JS
+        ),
+        Body(
+            H1("Welcome"),
+            P("Build modern web apps with Python."),
+            DataTable.from_lists(
+                [["Alice", "30"], ["Bob", "25"]], 
+                headers=["Name", "Age"]
+            )
+        )
+    )
+
+app.run()
+```
+
+## Features
+
+- **Styled HTML tags** - Pre-styled versions of all HTML elements
+- **Components** - DataTable, NavBar, and more  
+- **Themes** - Light/dark themes via CSS variables
+- **Type hints** - Full type annotations
+- **Air integration** - Works seamlessly with Air framework
+
+## Plugins
+
+### Markdown
+
+```bash
+pip install "eidosui[markdown]"
+```
+
+```python
+from eidos.plugins.markdown import Markdown, MarkdownCSS
+
+Head(
+    *EidosHeaders(),
+    MarkdownCSS()  # Add markdown styles
+)
+
+Body(
+    Markdown("# Hello\n\nSupports **GitHub Flavored Markdown**")
+)
+```
+
+## Documentation
+
+Full documentation: https://eidosui.readthedocs.io
+
+## License
+
+MIT

eidosui-0.5.0/eidos/__init__.py

@@ -0,0 +1,270 @@
+"""EidosUI - A modern, flexible Tailwind CSS-based UI library for Python web frameworks.
+
+Quick start:
+    >>> from eidos import *
+    >>> DataTable.from_lists([["A", "B"], ["C", "D"]], headers=["Col1", "Col2"])
+
+Or use explicit imports:
+    >>> from eidos import DataTable, Button, H1, Table
+    >>> from eidos import styles
+"""
+
+# Import all styled HTML tags
+# Import style namespaces
+from . import styles
+
+# Import components
+from .components import DataTable, EidosHeaders, NavBar
+from .styles import buttons, semantic, tables, typography
+from .tags import (
+    # Headings
+    H1,
+    H2,
+    H3,
+    H4,
+    H5,
+    H6,
+    # Pass-through HTML tags
+    A,
+    Abbr,
+    Address,
+    Area,
+    Article,
+    Aside,
+    Audio,
+    B,
+    Base,
+    Bdi,
+    Bdo,
+    Blockquote,
+    # Body
+    Body,
+    Br,
+    # Buttons
+    Button,
+    Canvas,
+    Caption,
+    Cite,
+    Code,
+    Col,
+    Colgroup,
+    Data,
+    Datalist,
+    Dd,
+    Del,
+    Details,
+    Dfn,
+    Dialog,
+    Div,
+    Dl,
+    Dt,
+    Em,
+    Embed,
+    Fieldset,
+    Figcaption,
+    Figure,
+    Footer,
+    Form,
+    Head,
+    Header,
+    Hgroup,
+    Hr,
+    Html,
+    I,
+    Iframe,
+    Img,
+    Input,
+    Ins,
+    Kbd,
+    Label,
+    Legend,
+    Li,
+    Link,
+    Main,
+    Map,
+    Mark,
+    Menu,
+    Meta,
+    Meter,
+    Nav,
+    Noscript,
+    Object,
+    Ol,
+    Optgroup,
+    Option,
+    Output,
+    P,
+    Param,
+    Picture,
+    Pre,
+    Progress,
+    Q,
+    Rp,
+    Rt,
+    Ruby,
+    S,
+    Samp,
+    Script,
+    Search,
+    Section,
+    Select,
+    Small,
+    Source,
+    Span,
+    # Semantic typography
+    Strong,
+    Style,
+    Sub,
+    Summary,
+    Sup,
+    # Table elements
+    Table,
+    Tbody,
+    Td,
+    Template,
+    Textarea,
+    Tfoot,
+    Th,
+    Thead,
+    Time,
+    Title,
+    Tr,
+    Track,
+    U,
+    Ul,
+    Var,
+    Video,
+    Wbr,
+)
+
+# Version info
+__version__ = "0.4.0"
+
+# Define what's available with "from eidos import *"
+__all__ = [
+    # Version
+    "__version__",
+    # Style namespaces
+    "styles",
+    "buttons",
+    "typography",
+    "semantic",
+    "tables",
+    # Components
+    "DataTable",
+    "NavBar",
+    "EidosHeaders",
+    # HTML Tags
+    "H1",
+    "H2",
+    "H3",
+    "H4",
+    "H5",
+    "H6",
+    "Body",
+    "Button",
+    "Strong",
+    "I",
+    "Small",
+    "Del",
+    "Abbr",
+    "Var",
+    "Mark",
+    "Time",
+    "Code",
+    "Pre",
+    "Kbd",
+    "Samp",
+    "Blockquote",
+    "Cite",
+    "Address",
+    "Hr",
+    "Details",
+    "Summary",
+    "Dl",
+    "Dt",
+    "Dd",
+    "Figure",
+    "Figcaption",
+    "Table",
+    "Thead",
+    "Tbody",
+    "Tfoot",
+    "Tr",
+    "Th",
+    "Td",
+    "A",
+    "Area",
+    "Article",
+    "Aside",
+    "Audio",
+    "B",
+    "Base",
+    "Bdi",
+    "Bdo",
+    "Br",
+    "Canvas",
+    "Caption",
+    "Col",
+    "Colgroup",
+    "Data",
+    "Datalist",
+    "Dfn",
+    "Dialog",
+    "Div",
+    "Em",
+    "Embed",
+    "Fieldset",
+    "Footer",
+    "Form",
+    "Head",
+    "Header",
+    "Hgroup",
+    "Html",
+    "Iframe",
+    "Img",
+    "Input",
+    "Ins",
+    "Label",
+    "Legend",
+    "Li",
+    "Link",
+    "Main",
+    "Map",
+    "Menu",
+    "Meta",
+    "Meter",
+    "Nav",
+    "Noscript",
+    "Object",
+    "Ol",
+    "Optgroup",
+    "Option",
+    "Output",
+    "P",
+    "Param",
+    "Picture",
+    "Progress",
+    "Q",
+    "Rp",
+    "Rt",
+    "Ruby",
+    "S",
+    "Script",
+    "Search",
+    "Section",
+    "Select",
+    "Source",
+    "Span",
+    "Style",
+    "Sub",
+    "Sup",
+    "Template",
+    "Textarea",
+    "Title",
+    "Track",
+    "U",
+    "Ul",
+    "Video",
+    "Wbr",
+]

eidosui-0.5.0/eidos/components/__init__.py

@@ -0,0 +1,10 @@
+"""EidosUI Components Package
+
+Higher-level components built on top of the base tags.
+"""
+
+from .headers import EidosHeaders
+from .navigation import NavBar
+from .table import DataTable
+
+__all__ = ["DataTable", "NavBar", "EidosHeaders"]

{eidosui-0.4.0 → eidosui-0.5.0}/eidos/components/headers.py

@@ -1,16 +1,18 @@
-from air import Meta, Script, Link
-from ..tags import Body
 from typing import Literal
 
+from air import Link, Meta, Script
+
+
 def get_css_urls():
     """Return list of CSS URLs for EidosUI."""
     return [
         "/eidos/css/styles.css",
-        "/eidos/css/themes/eidos-variables.css", 
+        "/eidos/css/themes/eidos-variables.css",
         "/eidos/css/themes/light.css",
-        "/eidos/css/themes/dark.css"
+        "/eidos/css/themes/dark.css",
     ]
 
+
 def EidosHeaders(
     include_tailwind: bool = True,
     include_lucide: bool = True,
@@ -18,7 +20,7 @@ def EidosHeaders(
     theme: Literal["light", "dark"] = "light",
 ):
     """Complete EidosUI headers with EidosUI JavaScript support.
-    
+
     Args:
         include_tailwind: Include Tailwind CSS CDN
         include_lucide: Include Lucide Icons CDN
@@ -29,28 +31,28 @@ def EidosHeaders(
         Meta(charset="UTF-8"),
         Meta(name="viewport", content="width=device-width, initial-scale=1.0"),
     ]
-    
+
     # Core libraries
     if include_tailwind:
         headers.append(Script(src="https://cdn.tailwindcss.com"))
-    
+
     if include_lucide:
         headers.append(Script(src="https://unpkg.com/lucide@latest/dist/umd/lucide.js"))
-    
+
     # EidosUI CSS
     for css_url in get_css_urls():
         headers.append(Link(rel="stylesheet", href=css_url))
-    
+
     # EidosUI JavaScript
     if include_eidos_js:
         headers.append(Script(src="/eidos/js/eidos.js", defer=True))
-    
+
     # Initialization script
     init_script = f"""
         // Set theme
         document.documentElement.setAttribute('data-theme', '{theme}');
     """
-    
+
     if include_lucide:
         init_script += """
         // Initialize Lucide icons
@@ -62,7 +64,7 @@ def EidosHeaders(
             if (window.lucide) lucide.createIcons();
         }
     """
-    
+
     headers.append(Script(init_script))
-    
-    return headers
+
+    return headers

eidosui-0.5.0/eidos/components/navigation.py

@@ -0,0 +1,87 @@
+from typing import Any, Final
+from uuid import uuid4
+
+from air import A, Div, I, Tag
+
+from ..tags import *
+from ..utils import stringify
+
+
+class ScrollspyT:
+    underline: Final[str] = "navbar-underline"
+    bold: Final[str] = "navbar-bold"
+
+
+def NavBar(
+    *c: Any,
+    lcontents: Tag | None = None,
+    right_cls: str = "items-center space-x-4",
+    mobile_cls: str = "",
+    sticky: bool = False,
+    scrollspy: bool = False,
+    cls: str = "p-4",
+    scrollspy_cls: str = ScrollspyT.underline,
+    menu_id: str | None = None,
+) -> Tag:
+    """Pure Tailwind responsive navigation bar with optional scrollspy.
+
+    Mobile menu uses best practice dropdown with:
+    - Centered text links
+    - Large touch targets
+    - Auto-close on selection
+    - Smooth animations
+    """
+    if lcontents is None:
+        lcontents = Div()
+
+    if menu_id is None:
+        menu_id = f"menu-{uuid4().hex[:8]}"
+
+    sticky_cls = "sticky top-0 eidos-navbar-sticky z-50" if sticky else ""
+
+    # Mobile toggle button with hamburger/close icon
+    mobile_icon = A(
+        I(data_lucide="menu", class_="w-6 h-6", data_menu_icon="open"),
+        I(data_lucide="x", class_="w-6 h-6 hidden", data_menu_icon="close"),
+        class_="md:hidden cursor-pointer p-2 eidos-navbar-toggle rounded-lg transition-colors",
+        data_toggle=f"#{menu_id}",
+        role="button",
+        aria_label="Toggle navigation",
+        aria_expanded="false",
+    )
+
+    # Desktop navigation
+    desktop_nav = Div(
+        *c,
+        class_=stringify(right_cls, "hidden md:flex"),
+        data_scrollspy="true" if scrollspy else None,
+    )
+
+    # Mobile navigation
+    mobile_nav = Div(
+        *c,
+        class_=stringify(
+            mobile_cls,
+            "hidden md:hidden absolute top-full left-0 right-0 eidos-navbar-mobile shadow-lg border-t",
+            "flex flex-col eidos-navbar-mobile-divider" if not mobile_cls else "",
+            scrollspy_cls,
+        ),
+        id=menu_id,
+        data_scrollspy="true" if scrollspy else None,
+        data_mobile_menu="true",
+    )
+
+    return Div(
+        # Main navbar container with relative positioning for mobile dropdown
+        Div(
+            Div(
+                lcontents,
+                mobile_icon,
+                desktop_nav,
+                class_="flex items-center justify-between",
+            ),
+            mobile_nav,
+            class_=stringify("eidos-navbar relative", cls, scrollspy_cls),
+        ),
+        class_=sticky_cls,
+    )

eidosui-0.5.0/eidos/components/table.py

@@ -0,0 +1,84 @@
+from typing import Any
+
+from ..tags import Table as BaseTable
+from ..tags import Tbody, Td, Th, Thead, Tr
+
+
+class DataTable:
+    """DataTable component that provides convenient methods for creating tables from data."""
+
+    @classmethod
+    def from_lists(
+        cls,
+        data: list[list],
+        headers: list[str] | None = None,
+        class_: str | list[str] | None = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Create table from list of lists.
+
+        Args:
+            data: List of lists where each inner list is a row
+            headers: Optional list of header strings
+            class_: Optional CSS classes to add to the table
+            **kwargs: Additional attributes to pass to the table element
+
+        Returns:
+            A rendered table element
+
+        Example:
+            Table.from_lists([["A", "B"], ["C", "D"]], headers=["Col1", "Col2"])
+        """
+        content = []
+
+        if headers:
+            thead = Thead(Tr(*[Th(header) for header in headers]))
+            content.append(thead)
+
+        tbody_rows = []
+        for row_data in data:
+            tbody_rows.append(Tr(*[Td(cell) for cell in row_data]))
+        tbody = Tbody(*tbody_rows)
+        content.append(tbody)
+
+        return BaseTable(*content, class_=class_, **kwargs)
+
+    @classmethod
+    def from_dicts(
+        cls,
+        data: list[dict],
+        headers: list[str] | None = None,
+        class_: str | list[str] | None = None,
+        **kwargs: Any,
+    ) -> Any:
+        """Create table from list of dictionaries.
+
+        Args:
+            data: List of dictionaries where each dict is a row
+            headers: Optional list of header strings. If not provided, uses keys from first dict
+            class_: Optional CSS classes to add to the table
+            **kwargs: Additional attributes to pass to the table element
+
+        Returns:
+            A rendered table element
+
+        Example:
+            Table.from_dicts([{"name": "John", "age": 25}], headers=["name", "age"])
+        """
+        if headers is None and data:
+            headers = list(data[0].keys())
+
+        content = []
+
+        if headers:
+            thead = Thead(Tr(*[Th(header) for header in headers]))
+            content.append(thead)
+
+        tbody_rows = []
+        if data and headers:
+            for row in data:
+                tbody_rows.append(Tr(*[Td(row.get(key, "")) for key in headers]))
+        tbody = Tbody(*tbody_rows)
+        content.append(tbody)
+
+        return BaseTable(*content, class_=class_, **kwargs)