dars-framework 1.0.0__tar.gz

dars_framework-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 ZtaDev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

dars_framework-1.0.0/PKG-INFO

@@ -0,0 +1,146 @@
+Metadata-Version: 2.4
+Name: dars-framework
+Version: 1.0.0
+Summary: Dars Framework build applications with Python and export to web
+Author-email: ztamdev <zondax2009@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2025 ZtaDev
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+        
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich
+Requires-Dist: bs4
+Dynamic: license-file
+
+# Dars Framework
+
+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—no Javascript or frontend stack required.
+
+## 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.
+
+## Quick Example: Your First App
+
+```python
+#!/usr/bin/env python3
+from dars.core.app import App
+from dars.components.basic.text import Text
+from dars.components.basic.button import Button
+from dars.components.basic.container import Container
+from dars.scripts.script import InlineScript
+
+# Crear aplicación
+app = App(title="Mi Primera App")
+
+# Crear componentes
+container = Container(style={
+    'display': 'flex',
+    'flex-direction': 'column',
+    'align-items': 'center',
+    'padding': '40px'
+})
+
+titulo = Text(
+    text="Hola Dars",
+    style={'font-size': '32px', 'color': '#333'}
+)
+
+boton = Button(
+    text="Hacer clic",
+    style={'background-color': '#007bff', 'color': 'white'}
+)
+
+# Script para interactividad
+script = InlineScript("""
+document.addEventListener('DOMContentLoaded', function() {
+    const boton = document.querySelector('button');
+    boton.addEventListener('click', function() {
+        alert('Hola desde Dars.');
+    });
+});
+""")
+
+# Ensamblar aplicación
+container.add_child(titulo)
+container.add_child(boton)
+app.set_root(container)
+app.add_script(script)
+
+if __name__ == "__main__":
+    app.rTimeCompile() # Live preview at http://localhost:8000
+```
+
+## 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                   |
+| `dars info my_app.py`                   | Show info about your app                    |
+| `dars formats`                          | List supported export formats               |
+| `dars --help`                           | Show help and all CLI options               |
+
+## More
+- [Project Roadmap](ROADMAP.md)
+- [Getting Started](dars/docs/getting_started.md)
+- [Components Reference](dars/docs/components.md)
+- [Exporters](dars/docs/exporters.md)
+- [Scripts System](dars/docs/scripts.md)
+- [CLI usage and commands](dars/docs/cli.md)
+- [Project Structure](STRUCTURE.md)
+- [Architecture](DARS_ARCHITECTURE.md)
+- [Installation Guide](INSTALL.md)
+
+## 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.
+

dars_framework-1.0.0/README.md

@@ -0,0 +1,113 @@
+# Dars Framework
+
+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—no Javascript or frontend stack required.
+
+## 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.
+
+## Quick Example: Your First App
+
+```python
+#!/usr/bin/env python3
+from dars.core.app import App
+from dars.components.basic.text import Text
+from dars.components.basic.button import Button
+from dars.components.basic.container import Container
+from dars.scripts.script import InlineScript
+
+# Crear aplicación
+app = App(title="Mi Primera App")
+
+# Crear componentes
+container = Container(style={
+    'display': 'flex',
+    'flex-direction': 'column',
+    'align-items': 'center',
+    'padding': '40px'
+})
+
+titulo = Text(
+    text="Hola Dars",
+    style={'font-size': '32px', 'color': '#333'}
+)
+
+boton = Button(
+    text="Hacer clic",
+    style={'background-color': '#007bff', 'color': 'white'}
+)
+
+# Script para interactividad
+script = InlineScript("""
+document.addEventListener('DOMContentLoaded', function() {
+    const boton = document.querySelector('button');
+    boton.addEventListener('click', function() {
+        alert('Hola desde Dars.');
+    });
+});
+""")
+
+# Ensamblar aplicación
+container.add_child(titulo)
+container.add_child(boton)
+app.set_root(container)
+app.add_script(script)
+
+if __name__ == "__main__":
+    app.rTimeCompile() # Live preview at http://localhost:8000
+```
+
+## 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                   |
+| `dars info my_app.py`                   | Show info about your app                    |
+| `dars formats`                          | List supported export formats               |
+| `dars --help`                           | Show help and all CLI options               |
+
+## More
+- [Project Roadmap](ROADMAP.md)
+- [Getting Started](dars/docs/getting_started.md)
+- [Components Reference](dars/docs/components.md)
+- [Exporters](dars/docs/exporters.md)
+- [Scripts System](dars/docs/scripts.md)
+- [CLI usage and commands](dars/docs/cli.md)
+- [Project Structure](STRUCTURE.md)
+- [Architecture](DARS_ARCHITECTURE.md)
+- [Installation Guide](INSTALL.md)
+
+## 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.
+

dars_framework-1.0.0/dars/all.py

@@ -0,0 +1,52 @@
+# Barrel import for all Dars components and core modules
+# Usage: from dars.all import *
+
+# Core
+from dars.core.app import App
+from dars.core.component import Component
+from dars.core.events import EventManager
+
+# Basic Components
+from dars.components.basic.button import Button
+from dars.components.basic.checkbox import Checkbox
+from dars.components.basic.container import Container
+from dars.components.basic.datepicker import DatePicker
+from dars.components.basic.image import Image
+from dars.components.basic.input import Input
+from dars.components.basic.link import Link
+from dars.components.basic.page import Page
+from dars.components.basic.progressbar import ProgressBar
+from dars.components.basic.radiobutton import RadioButton
+from dars.components.basic.select import Select
+from dars.components.basic.slider import Slider
+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
+
+# Advanced Components
+from dars.components.advanced.accordion import Accordion
+from dars.components.advanced.card import Card
+from dars.components.advanced.modal import Modal
+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
+from dars.components.layout.anchor import AnchorPoint
+
+# Exporters (optional, for direct use)
+# from dars.exporters.web.html_css_js import HTMLCSSJSExporter
+
+# CLI (optional, for advanced usage)
+# from dars.cli.main import main as dars_cli_main
+
+__all__ = [
+    'App', 'Component', 'EventManager',
+    'Button', 'Checkbox', 'Container', 'DatePicker', 'Image', 'Input', 'Link', 'Page', 'ProgressBar',
+    'RadioButton', 'Select', 'Slider', 'Spinner', 'Text', 'Textarea', 'Tooltip',
+    'Accordion', 'Card', 'Modal', 'Navbar', 'Table', 'Tabs',
+    'GridLayout', 'FlexLayout', 'LayoutBase', 'AnchorPoint',
+]

dars_framework-1.0.0/dars/cli/hot_reload.py

@@ -0,0 +1,33 @@
+import os
+import time
+import threading
+import importlib
+
+class FileWatcher:
+    """Watches a file for changes and triggers a callback when it changes."""
+    def __init__(self, path, on_change, poll_interval=0.5):
+        self.path = path
+        self.on_change = on_change
+        self.poll_interval = poll_interval
+        self._last_mtime = None
+        self._stop_event = threading.Event()
+        self._thread = threading.Thread(target=self._watch, daemon=True)
+
+    def start(self):
+        self._last_mtime = os.path.getmtime(self.path)
+        self._thread.start()
+
+    def stop(self):
+        self._stop_event.set()
+        self._thread.join()
+
+    def _watch(self):
+        while not self._stop_event.is_set():
+            try:
+                mtime = os.path.getmtime(self.path)
+                if mtime != self._last_mtime:
+                    self._last_mtime = mtime
+                    self.on_change()
+            except Exception:
+                pass
+            time.sleep(self.poll_interval)