dars-framework 1.0.62__tar.gz → 1.2.7__tar.gz

dars_framework-1.2.7/MANIFEST.in

@@ -0,0 +1,7 @@
+include README.md
+include LICENSE
+recursive-include dars/templates *
+recursive-include dars/docs *
+recursive-include dars *.json
+recursive-include dars *.md
+exclude LandingPage

dars_framework-1.2.7/PKG-INFO

@@ -0,0 +1,245 @@
+Metadata-Version: 2.4
+Name: dars_framework
+Version: 1.2.7
+Summary: Dars is a Python UI framework for building modern, interactive web apps with only Python code. Write your interface in Python, export it to static HTML/CSS/JS, and deploy anywhere.
+Author-email: ztamdev <ztadevs@gmail.com>
+License-Expression: MIT
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich==14.2.0
+Requires-Dist: bs4==0.0.2
+Requires-Dist: uvicorn==0.35.0
+Requires-Dist: fastapi==0.116.1
+Requires-Dist: markdown2==2.5.4
+Requires-Dist: requests==2.32.5
+Requires-Dist: rjsmin==1.2.5
+Dynamic: license-file
+
+<h1 align="center">Dars Framework</h1>
+ 
+<p align="center">
+  <img src="./Dars-logo.png" alt="Dars Framework Logo" width="200" />
+</p>
+
+<p align="center">
+  <em>Dars is a Python UI framework for building modern, interactive web apps with Python code. Write your interface in Python, export it to static HTML/CSS/JS, and deploy anywhere.</em>
+</p>
+
+```bash
+pip install dars-framework
+```
+
+> Some Javascript or frontend stack required.
+
+Try dars without installing nothing just visit the [Dars Playground](https://dars-playground.vercel.app/)
+
+## How It Works
+- Build your UI using Python classes and components (like Text, Button, Container, Page, etc).
+- Preview instantly with hot-reload using `app.rTimeCompile()`.
+- Export your app to static web files with a single CLI command.
+- Use multipage, layouts, scripts, and more—see docs for advanced features.
+- For more information visit the [Documentation](https://ztamdev.github.io/Dars-Framework/documentation.html)
+
+## Quick Example: Your First App
+```python
+from dars.all import *
+
+app = App(title="Hello World", theme="dark")
+# Crear componentes
+index = Page(
+     Text(
+        text="Hello World",
+        style={
+            'font-size': '48px',
+            'color': '#2c3e50',
+            'margin-bottom': '20px',
+            'font-weight': 'bold',
+            'text-align': 'center'
+        }
+    ),
+    Text(
+        text="Hello World",
+        style={
+            'font-size': '20px',
+            'color': '#7f8c8d',
+            'margin-bottom': '40px',
+            'text-align': 'center'
+        }
+    ),
+
+    Button(
+        text="Click Me!",
+        on_click= dScript("alert('Hello World')"),
+        on_mouse_enter=dScript("this.style.backgroundColor = '#2980b9';"),
+        on_mouse_leave=dScript("this.style.backgroundColor = '#3498db';"),
+        style={
+            'background-color': '#3498db',
+            'color': 'white',
+            'padding': '15px 30px',
+            'border': 'none',
+            'border-radius': '8px',
+            'font-size': '18px',
+            'cursor': 'pointer',
+            'transition': 'background-color 0.3s'
+        }
+    ),
+    style={
+        'display': 'flex',
+        'flex-direction': 'column',
+        'align-items': 'center',
+        'justify-content': 'center',
+        'min-height': '100vh',
+        'background-color': '#f0f2f5',
+        'font-family': 'Arial, sans-serif'
+    }
+) 
+index.attr()
+app.add_page("index", index, title="Hello World", index=True)
+
+if __name__ == "__main__":
+    app.rTimeCompile()
+
+```
+
+---
+
+## Reactivity and State System
+
+**Dars Framework** includes a built-in **reactive state system** (`dState` / `cState`) that allows dynamic and modular DOM updates directly from Python.
+It enables fully event-driven interfaces without requiring manual JavaScript.
+
+### Key Concepts
+
+* **`dState(name, component, states)`**
+  Creates a reactive state controller bound to a specific component and a list of possible states.
+
+* **`cState(idx, mods=[...])`**
+  Defines rules (modifications) that are automatically applied when entering a specific state.
+
+* **`Mod` Helpers**
+  A compact way to modify DOM elements on state changes: `inc`, `dec`, `set`, `toggle_class`, `append_text`, `prepend_text`, `goto`, and more.
+
+* **Deferred Mutations**
+  Using `component.attr(..., defer=True)` or `component.mod(...)` inside a `cComp=True` state defers HTML updates until an event occurs, preventing authoring-time mutations.
+
+### Example Template
+
+A complete example demonstrating `dState`, `cState`, `Mod`, and deferred updates is available [here](https://github.com/ZtaMDev/Dars-Framework/blob/CrystalMain/dars/templates/examples/advanced/dState/state_mods_demo.py)
+
+<img width="384" height="187" alt="imagen" src="https://github.com/user-attachments/assets/7750ee7f-768f-48da-94df-2fa00339a99c" /> <img width="361" height="215" alt="imagen" src="https://github.com/user-attachments/assets/9b8a3e67-2424-49b4-aee0-9f1c0f747d66" />
+
+
+
+### Features
+
+* Reactive Mod system with compact `Mod` helpers
+* Unified event model — any component can use `on_*` props (`on_click`, `on_input`, `on_change`, etc.)
+* Deferred rendering for safer, predictable state transitions (`cComp=True`)
+* Navigation between states using `goto`, including relative moves (`'+1'`, `'-1'`)
+* Consistent, event-time mutation flow for reliable behavior
+* Secure minification for production bundles (strong JS/CSS minifier integrated into the build pipeline)
+
+---
+
+## CLI Usage
+| Command                                 | What it does                               |
+|-----------------------------------------|--------------------------------------------|
+| `dars export my_app.py --format html`   | Export app to HTML/CSS/JS in `./my_app_web` |
+| `dars preview ./my_app_web`             | Preview exported app locally                |
+| `dars init my_project`                  | Create a new Dars project (also creates dars.config.json) |
+| `dars init --update`                    | Create/Update dars.config.json in current dir |
+| `dars build`                            | Build using dars.config.json (entry/outdir/format) |
+| `dars config validate`                  | Validate dars.config.json and print report   |
+| `dars info my_app.py`                   | Show info about your app                    |
+| `dars formats`                          | List supported export formats               |
+| `dars --help`                           | Show help and all CLI options               |
+
+Tip: use `dars doctor` to review optional tooling that can enhance bundling/minification.
+
+## More
+
+- Visit dars [official website](https://ztamdev.github.io/Dars-Framework/)
+- Visit the dars official [Documentation](https://ztamdev.github.io/Dars-Framework/documentation.html) now on separate website.
+- Try dars without installing nothing just visit the [Dars Playground](https://dars-playground.vercel.app/)
+
+## Local Execution and Live Preview
+
+To test your app locally before exporting, use the hot-reload preview from any Python file that defines your app:
+
+```python
+if __name__ == "__main__":
+    app.rTimeCompile()
+```
+
+Then run your file directly:
+
+```bash
+python my_app.py
+```
+
+This will start a local server at http://localhost:8000 so you can view your app in the browser—no manual export needed. You can change the port with:
+
+```bash
+python my_app.py --port 8088
+```
+
+---
+
+You can also use the CLI preview command on an exported app:
+
+```bash
+dars preview ./my_exported_app
+```
+
+This will start a local server at http://localhost:8000 to view your exported app in the browser.
+
+---
+
+## Project Configuration (dars.config.json)
+
+Dars can read build/export settings from a `dars.config.json` at your project root. It is created automatically by `dars init`, and you can add it to existing projects with `dars init --update`.
+
+Example default:
+
+```json
+{
+  "entry": "main.py",
+  "format": "html",
+  "outdir": "dist",
+  "publicDir": null,
+  "include": [],
+  "exclude": ["**/__pycache__", ".git", ".venv", "node_modules"],
+  "bundle": true,
+  "viteMinify": true
+}
+```
+
+- `entry`: Python entry file. Used by `dars build` and `dars export config`.
+- `format`: Export format. Currently only `html` is supported.
+- `outdir`: Output directory. Used by `dars build` and default for `dars export` when not overridden.
+- `publicDir`: Folder (e.g., `public/` or `assets/`) copied into the output. If null, it is autodetected.
+- `include`/`exclude`: Basic filters for copying from `publicDir`.
+- `bundle`: Reserved for future use. CLI exports and build already bundle appropriately.
+- `viteMinify`: Toggle the Vite-based minifier for JS. When `false`, the build uses esbuild-based minification. If neither is available, a conservative Python fallback is used.
+
+Validate your config:
+
+```bash
+dars config validate
+```
+
+Build using config:
+
+```bash
+dars build
+```
+
+Export using the config entry and outdir:
+
+```bash
+dars export config --format html
+```
+
+---
+
+See LandingPage docs for details: state_management.md, events.md, scripts.md.

dars_framework-1.2.7/README.md

@@ -0,0 +1,228 @@
+<h1 align="center">Dars Framework</h1>
+ 
+<p align="center">
+  <img src="./Dars-logo.png" alt="Dars Framework Logo" width="200" />
+</p>
+
+<p align="center">
+  <em>Dars is a Python UI framework for building modern, interactive web apps with Python code. Write your interface in Python, export it to static HTML/CSS/JS, and deploy anywhere.</em>
+</p>
+
+```bash
+pip install dars-framework
+```
+
+> Some Javascript or frontend stack required.
+
+Try dars without installing nothing just visit the [Dars Playground](https://dars-playground.vercel.app/)
+
+## How It Works
+- Build your UI using Python classes and components (like Text, Button, Container, Page, etc).
+- Preview instantly with hot-reload using `app.rTimeCompile()`.
+- Export your app to static web files with a single CLI command.
+- Use multipage, layouts, scripts, and more—see docs for advanced features.
+- For more information visit the [Documentation](https://ztamdev.github.io/Dars-Framework/documentation.html)
+
+## Quick Example: Your First App
+```python
+from dars.all import *
+
+app = App(title="Hello World", theme="dark")
+# Crear componentes
+index = Page(
+     Text(
+        text="Hello World",
+        style={
+            'font-size': '48px',
+            'color': '#2c3e50',
+            'margin-bottom': '20px',
+            'font-weight': 'bold',
+            'text-align': 'center'
+        }
+    ),
+    Text(
+        text="Hello World",
+        style={
+            'font-size': '20px',
+            'color': '#7f8c8d',
+            'margin-bottom': '40px',
+            'text-align': 'center'
+        }
+    ),
+
+    Button(
+        text="Click Me!",
+        on_click= dScript("alert('Hello World')"),
+        on_mouse_enter=dScript("this.style.backgroundColor = '#2980b9';"),
+        on_mouse_leave=dScript("this.style.backgroundColor = '#3498db';"),
+        style={
+            'background-color': '#3498db',
+            'color': 'white',
+            'padding': '15px 30px',
+            'border': 'none',
+            'border-radius': '8px',
+            'font-size': '18px',
+            'cursor': 'pointer',
+            'transition': 'background-color 0.3s'
+        }
+    ),
+    style={
+        'display': 'flex',
+        'flex-direction': 'column',
+        'align-items': 'center',
+        'justify-content': 'center',
+        'min-height': '100vh',
+        'background-color': '#f0f2f5',
+        'font-family': 'Arial, sans-serif'
+    }
+) 
+index.attr()
+app.add_page("index", index, title="Hello World", index=True)
+
+if __name__ == "__main__":
+    app.rTimeCompile()
+
+```
+
+---
+
+## Reactivity and State System
+
+**Dars Framework** includes a built-in **reactive state system** (`dState` / `cState`) that allows dynamic and modular DOM updates directly from Python.
+It enables fully event-driven interfaces without requiring manual JavaScript.
+
+### Key Concepts
+
+* **`dState(name, component, states)`**
+  Creates a reactive state controller bound to a specific component and a list of possible states.
+
+* **`cState(idx, mods=[...])`**
+  Defines rules (modifications) that are automatically applied when entering a specific state.
+
+* **`Mod` Helpers**
+  A compact way to modify DOM elements on state changes: `inc`, `dec`, `set`, `toggle_class`, `append_text`, `prepend_text`, `goto`, and more.
+
+* **Deferred Mutations**
+  Using `component.attr(..., defer=True)` or `component.mod(...)` inside a `cComp=True` state defers HTML updates until an event occurs, preventing authoring-time mutations.
+
+### Example Template
+
+A complete example demonstrating `dState`, `cState`, `Mod`, and deferred updates is available [here](https://github.com/ZtaMDev/Dars-Framework/blob/CrystalMain/dars/templates/examples/advanced/dState/state_mods_demo.py)
+
+<img width="384" height="187" alt="imagen" src="https://github.com/user-attachments/assets/7750ee7f-768f-48da-94df-2fa00339a99c" /> <img width="361" height="215" alt="imagen" src="https://github.com/user-attachments/assets/9b8a3e67-2424-49b4-aee0-9f1c0f747d66" />
+
+
+
+### Features
+
+* Reactive Mod system with compact `Mod` helpers
+* Unified event model — any component can use `on_*` props (`on_click`, `on_input`, `on_change`, etc.)
+* Deferred rendering for safer, predictable state transitions (`cComp=True`)
+* Navigation between states using `goto`, including relative moves (`'+1'`, `'-1'`)
+* Consistent, event-time mutation flow for reliable behavior
+* Secure minification for production bundles (strong JS/CSS minifier integrated into the build pipeline)
+
+---
+
+## CLI Usage
+| Command                                 | What it does                               |
+|-----------------------------------------|--------------------------------------------|
+| `dars export my_app.py --format html`   | Export app to HTML/CSS/JS in `./my_app_web` |
+| `dars preview ./my_app_web`             | Preview exported app locally                |
+| `dars init my_project`                  | Create a new Dars project (also creates dars.config.json) |
+| `dars init --update`                    | Create/Update dars.config.json in current dir |
+| `dars build`                            | Build using dars.config.json (entry/outdir/format) |
+| `dars config validate`                  | Validate dars.config.json and print report   |
+| `dars info my_app.py`                   | Show info about your app                    |
+| `dars formats`                          | List supported export formats               |
+| `dars --help`                           | Show help and all CLI options               |
+
+Tip: use `dars doctor` to review optional tooling that can enhance bundling/minification.
+
+## More
+
+- Visit dars [official website](https://ztamdev.github.io/Dars-Framework/)
+- Visit the dars official [Documentation](https://ztamdev.github.io/Dars-Framework/documentation.html) now on separate website.
+- Try dars without installing nothing just visit the [Dars Playground](https://dars-playground.vercel.app/)
+
+## Local Execution and Live Preview
+
+To test your app locally before exporting, use the hot-reload preview from any Python file that defines your app:
+
+```python
+if __name__ == "__main__":
+    app.rTimeCompile()
+```
+
+Then run your file directly:
+
+```bash
+python my_app.py
+```
+
+This will start a local server at http://localhost:8000 so you can view your app in the browser—no manual export needed. You can change the port with:
+
+```bash
+python my_app.py --port 8088
+```
+
+---
+
+You can also use the CLI preview command on an exported app:
+
+```bash
+dars preview ./my_exported_app
+```
+
+This will start a local server at http://localhost:8000 to view your exported app in the browser.
+
+---
+
+## Project Configuration (dars.config.json)
+
+Dars can read build/export settings from a `dars.config.json` at your project root. It is created automatically by `dars init`, and you can add it to existing projects with `dars init --update`.
+
+Example default:
+
+```json
+{
+  "entry": "main.py",
+  "format": "html",
+  "outdir": "dist",
+  "publicDir": null,
+  "include": [],
+  "exclude": ["**/__pycache__", ".git", ".venv", "node_modules"],
+  "bundle": true,
+  "viteMinify": true
+}
+```
+
+- `entry`: Python entry file. Used by `dars build` and `dars export config`.
+- `format`: Export format. Currently only `html` is supported.
+- `outdir`: Output directory. Used by `dars build` and default for `dars export` when not overridden.
+- `publicDir`: Folder (e.g., `public/` or `assets/`) copied into the output. If null, it is autodetected.
+- `include`/`exclude`: Basic filters for copying from `publicDir`.
+- `bundle`: Reserved for future use. CLI exports and build already bundle appropriately.
+- `viteMinify`: Toggle the Vite-based minifier for JS. When `false`, the build uses esbuild-based minification. If neither is available, a conservative Python fallback is used.
+
+Validate your config:
+
+```bash
+dars config validate
+```
+
+Build using config:
+
+```bash
+dars build
+```
+
+Export using the config entry and outdir:
+
+```bash
+dars export config --format html
+```
+
+---
+
+See LandingPage docs for details: state_management.md, events.md, scripts.md.

{dars_framework-1.0.62 → dars_framework-1.2.7}/dars/all.py

@@ -24,6 +24,7 @@ from dars.components.basic.spinner import Spinner
 from dars.components.basic.text import Text
 from dars.components.basic.textarea import Textarea
 from dars.components.basic.tooltip import Tooltip
+from dars.components.basic.markdown import Markdown
 
 # Advanced Components
 from dars.components.advanced.accordion import Accordion
@@ -33,6 +34,7 @@ from dars.components.advanced.navbar import Navbar
 from dars.components.advanced.table import Table
 from dars.components.advanced.tabs import Tabs
 
+
 # Layout
 from dars.components.layout.grid import GridLayout, LayoutBase
 from dars.components.layout.flex import FlexLayout
@@ -42,10 +44,16 @@ from dars.scripts.script import *
 from dars.scripts.dscript import dScript
 
 # Exporters (optional, for direct use)
-# from dars.exporters.web.html_css_js import HTMLCSSJSExporter
+from dars.exporters.web.html_css_js import HTMLCSSJSExporter
+from dars.core.events import EventTypes
+from dars.core.events import EventHandler,  EventEmitter,  EventManager
 
+from dars.version import __version__
+from dars.dars_tests import *
+from dars.dars_tests.run_tests import run_app_tests, run_unit_tests, main
 # CLI (optional, for advanced usage)
 # from dars.cli.main import main as dars_cli_main
+from dars.core.state import dState, Mod
 
 __all__ = [
     'App', 'Component', 'EventManager',
@@ -53,5 +61,9 @@ __all__ = [
     'RadioButton', 'Select', 'Slider', 'Spinner', 'Text', 'Textarea', 'Tooltip',
     'Accordion', 'Card', 'Modal', 'Navbar', 'Table', 'Tabs',
     'GridLayout', 'FlexLayout', 'LayoutBase', 'AnchorPoint',
-    'InlineScript', 'FileScript', 'dScript',
+    'InlineScript', 'FileScript', 'dScript', 'HTMLCSSJSExporter',
+    'EventTypes', 'EventHandler', 'EventEmitter', 'EventManager', 'Markdown',
+    '__version__',
+    'run_app_tests', 'run_unit_tests', 'main',
+    'dState', 'Mod',
 ]

dars_framework-1.2.7/dars/cli/doctor/__init__.py

@@ -0,0 +1 @@
+# dars.cli.doctor package

dars_framework-1.2.7/dars/cli/doctor/detect.py

@@ -0,0 +1,154 @@
+import os, subprocess, sys, re
+from typing import Tuple, Optional, List, Dict
+from dars.core.js_bridge import has_bun, has_node, _run as js_run
+
+SEMVER_RE = re.compile(r"v?(\d+)\.(\d+)\.(\d+)")
+
+
+def _run(cmd: List[str]) -> Tuple[int, str, str]:
+    try:
+        p = subprocess.run(cmd, capture_output=True, text=True, shell=False)
+        return p.returncode, p.stdout.strip(), p.stderr.strip()
+    except Exception as e:
+        return 1, "", str(e)
+
+
+def which(bin_name: str) -> Optional[str]:
+    if os.name == 'nt':
+        code, out, _ = _run(["where", bin_name])
+    else:
+        code, out, _ = _run(["which", bin_name])
+    if code == 0 and out:
+        return out.splitlines()[0].strip()
+    return None
+
+
+def parse_semver(s: str) -> Optional[str]:
+    m = SEMVER_RE.search(s or "")
+    if not m:
+        return None
+    return f"{m.group(1)}.{m.group(2)}.{m.group(3)}"
+
+
+def detect_node() -> Dict[str, Optional[str]]:
+    path = which("node")
+    if not path:
+        return {"ok": False, "version": None, "path": None}
+    code, out, _ = _run([path, "--version"])  # prints like v18.19.1
+    ver = parse_semver(out)
+    return {"ok": bool(ver), "version": ver, "path": path}
+
+
+def detect_esbuild() -> Dict[str, Optional[str]]:
+    # Prefer bun x esbuild --version
+    if has_bun():
+        code, out, err = js_run(["bun", "x", "esbuild", "--version"])  # type: ignore
+        if code == 0:
+            return {"ok": True, "version": out.strip() or "unknown", "path": "bun x esbuild"}
+    # Node fallback
+    if has_node():
+        code, out, err = js_run(["npx", "--yes", "esbuild", "--version"])  # type: ignore
+        if code == 0:
+            return {"ok": True, "version": out.strip() or "unknown", "path": "npx esbuild"}
+    return {"ok": False, "version": None, "path": None}
+
+
+def detect_vite() -> Dict[str, Optional[str]]:
+    # Prefer bun x vite --version
+    if has_bun():
+        code, out, err = js_run(["bun", "x", "vite", "--version"])  # type: ignore
+        if code == 0:
+            return {"ok": True, "version": out.strip() or "unknown", "path": "bun x vite"}
+    if has_node():
+        code, out, err = js_run(["npx", "--yes", "vite", "--version"])  # type: ignore
+        if code == 0:
+            return {"ok": True, "version": out.strip() or "unknown", "path": "npx vite"}
+    return {"ok": False, "version": None, "path": None}
+
+
+def detect_bun() -> Dict[str, Optional[str]]:
+    path = which("bun")
+    if not path:
+        return {"ok": False, "version": None, "path": None}
+    code, out, _ = _run([path, "--version"])  # prints like 1.1.24
+    ver = parse_semver(out) or out.strip()
+    return {"ok": bool(ver), "version": ver, "path": path}
+
+
+def read_pyproject_deps(pyproject_path: Optional[str] = None) -> List[str]:
+    """Extract [project].dependencies items as a list of requirement strings.
+    Avoids pulling unrelated keys (e.g., license).
+    """
+    path = pyproject_path or os.path.join(os.getcwd(), "pyproject.toml")
+    if not os.path.isfile(path):
+        return []
+    try:
+        with open(path, 'r', encoding='utf-8') as f:
+            lines = f.readlines()
+        reqs: List[str] = []
+        in_project = False
+        in_array = False
+        buf: List[str] = []
+        for raw in lines:
+            l = raw.strip()
+            # Track project table
+            if l.startswith('['):
+                in_project = (l == '[project]')
+                # leaving dependencies array if we hit a new table
+                if l != '[project]':
+                    in_array = False
+                continue
+            if not in_project:
+                continue
+            # Find dependencies array start
+            if not in_array and l.startswith('dependencies') and '=' in l:
+                # Could be inline or multiline
+                # Normalize to everything after '='
+                after = l.split('=', 1)[1].strip()
+                if after.startswith('[') and after.endswith(']'):
+                    # Inline array
+                    buf = [after]
+                    in_array = False
+                elif after.startswith('['):
+                    buf = [after]
+                    in_array = True
+                else:
+                    # Malformed; skip
+                    buf = []
+                    in_array = False
+                # If inline, fall-through to extraction below
+            elif in_array:
+                buf.append(l)
+                if ']' in l:
+                    in_array = False
+            # When we have a complete buffer (inline or closed multiline), extract
+            if buf and not in_array:
+                content = ' '.join(buf)
+                # Extract quoted items within brackets
+                m = re.findall(r'"([^"\\]*(?:\\.[^"\\]*)*)"', content)
+                for item in m:
+                    if item:
+                        reqs.append(item)
+                buf = []
+        return reqs
+    except Exception:
+        return []
+
+
+def check_python_deps(requirements: List[str]) -> Dict[str, List[str]]:
+    missing: List[str] = []
+    try:
+        try:
+            import importlib.metadata as md  # py3.8+
+        except Exception:
+            import importlib_metadata as md  # type: ignore
+        for spec in requirements:
+            name = spec.split("==")[0].split(">=")[0].split("<=")[0]
+            try:
+                md.version(name)
+            except Exception:
+                missing.append(spec)
+    except Exception:
+        # if detection fails, don't block
+        pass
+    return {"missing": missing}