dars-framework 1.0.1__tar.gz → 1.0.4__tar.gz

{dars_framework-1.0.1/dars_framework.egg-info → dars_framework-1.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dars-framework
-Version: 1.0.1
+Version: 1.0.4
 Summary: Dars Framework build applications with Python and export to web
 Author-email: ztamdev <zondax2009@gmail.com>
 License: MIT License
@@ -33,7 +33,11 @@ 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.
+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 some Javascript or frontend stack required.
+
+```bash
+pip install dars-framework
+```
 
 ## How It Works
 - Build your UI using Python classes and components (like Text, Button, Container, Page, etc).
@@ -105,7 +109,7 @@ if __name__ == "__main__":
 ## More
 - [Project Roadmap](ROADMAP.md)
 - [Getting Started](dars/docs/getting_started.md)
-- [Components Reference](dars/docs/components.md)
+- [Components Documentation](dars/docs/components.md)
 - [Exporters](dars/docs/exporters.md)
 - [Scripts System](dars/docs/scripts.md)
 - [CLI usage and commands](dars/docs/cli.md)

{dars_framework-1.0.1 → dars_framework-1.0.4}/README.md

@@ -1,113 +1,117 @@
-# 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
+
+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 some Javascript or frontend stack required.
+
+```bash
+pip install dars-framework
+```
+
+## 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 Documentation](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.1 → dars_framework-1.0.4}/dars/all.py

@@ -5,6 +5,7 @@
 from dars.core.app import App
 from dars.core.component import Component
 from dars.core.events import EventManager
+from dars.core.properties import *
 
 # Basic Components
 from dars.components.basic.button import Button

{dars_framework-1.0.1 → dars_framework-1.0.4}/dars/cli/main.py

@@ -215,6 +215,11 @@ class DarsExporter:
                 console.print(f"[red]{translator.get('error_file_not_exists')} {file_path}[/red]")
                 return None
                 
+            # Add the application's root directory to sys.path
+            file_dir = os.path.dirname(os.path.abspath(file_path))
+            if file_dir not in sys.path:
+                sys.path.insert(0, file_dir)
+                
             # Load the module dynamically
             spec = importlib.util.spec_from_file_location("user_app", file_path)
             if spec is None or spec.loader is None:
@@ -222,11 +227,6 @@ class DarsExporter:
                 return None
                 
             module = importlib.util.module_from_spec(spec)
-            
-            # Add the file directory to the path for relative imports
-            file_dir = os.path.dirname(os.path.abspath(file_path))
-
-                
             spec.loader.exec_module(module)
             
             # Look for the 'app' variable in the module

{dars_framework-1.0.1 → dars_framework-1.0.4}/dars/components/basic/container.py

@@ -4,17 +4,22 @@ from typing import Optional, Union, Dict, Any, List
 
 class Container(Component):
     def __init__(
-        self, 
+        self,
+        *children: Component,
         id: Optional[str] = None, 
         class_name: Optional[str] = None, 
         style: Optional[Dict[str, Any]] = None,
-        children: Optional[List[Component]] = None
+        additional_children: Optional[List[Component]] = None
     ):
         super().__init__(id=id, class_name=class_name, style=style)
         
-        # Agregar hijos si se proporcionan
-        if children:
-            for child in children:
+        # Agregar hijos pasados como argumentos posicionales
+        for child in children:
+            self.add_child(child)
+            
+        # Agregar hijos adicionales si se proporcionan
+        if additional_children:
+            for child in additional_children:
                 self.add_child(child)
 
     def render(self, exporter: Any) -> str:

dars_framework-1.0.4/dars/core/component.py

@@ -0,0 +1,140 @@
+from typing import Dict, Any, List, Optional, Callable, Union, Type
+from abc import ABC, abstractmethod
+
+class ComponentQuery:
+    def __init__(self, components: List['Component']):
+        self.components = components
+
+    def find(self, 
+             id: Optional[str] = None,
+             class_name: Optional[str] = None,
+             type: Optional[Union[Type['Component'], str]] = None,
+             predicate: Optional[Callable[['Component'], bool]] = None) -> 'ComponentQuery':
+        """
+        Busca componentes dentro de los componentes actualmente seleccionados
+        """
+        results: List['Component'] = []
+        
+        def match_component(comp: Component) -> bool:
+            if id is not None and comp.id != id:
+                return False
+            if class_name is not None and comp.class_name != class_name:
+                return False
+            if type is not None:
+                if isinstance(type, str):
+                    if comp.__class__.__name__ != type:
+                        return False
+                elif not isinstance(comp, type):
+                    return False
+            if predicate is not None and not predicate(comp):
+                return False
+            return True
+        
+        # Buscar en los hijos de todos los componentes actuales
+        for component in self.components:
+            for child in component.children:
+                if match_component(child):
+                    results.append(child)
+                # Buscar recursivamente en los hijos del hijo
+                for descendant in ComponentQuery([child]).find().get():
+                    if match_component(descendant):
+                        results.append(descendant)
+        
+        return ComponentQuery(results)
+
+    def attr(self, **attrs) -> 'ComponentQuery':
+        """Modifica los atributos de todos los componentes encontrados"""
+        for component in self.components:
+            for key, value in attrs.items():
+                # Manejo especial para atributos comunes
+                if key == 'style':
+                    component.style.update(value)
+                    continue
+                elif key == 'class_name':
+                    component.class_name = value
+                    continue
+                elif key == 'events':
+                    component.events.update(value)
+                    continue
+                
+                # Intenta establecer el atributo directamente si existe
+                if hasattr(component, key):
+                    setattr(component, key, value)
+                # Si no existe como atributo directo, guárdalo en props
+                else:
+                    component.props[key] = value
+        return self
+
+    def get(self) -> List['Component']:
+        """Devuelve la lista de componentes encontrados"""
+        return self.components
+
+    def first(self) -> Optional['Component']:
+        """Devuelve el primer componente encontrado o None si no hay ninguno"""
+        return self.components[0] if self.components else None
+
+class Component(ABC):
+    def __init__(self, **props):
+        self.props = props
+        self.children: List[Component] = []
+        self.parent: Optional[Component] = None
+        self.id: Optional[str] = props.get('id')
+        self.class_name: Optional[str] = props.get('class_name')
+        self.style: Dict[str, Any] = props.get('style', {})
+        self.events: Dict[str, Callable] = {}
+        
+    def add_child(self, child: 'Component'):
+        child.parent = self
+        self.children.append(child)
+        
+    def set_event(self, event_name: str, handler: Callable):
+        self.events[event_name] = handler
+        
+    def find(self, 
+             id: Optional[str] = None,
+             class_name: Optional[str] = None,
+             type: Optional[Union[Type['Component'], str]] = None,
+             predicate: Optional[Callable[['Component'], bool]] = None) -> ComponentQuery:
+        """
+        Busca componentes que coincidan con los criterios especificados.
+        
+        Args:
+            id: Buscar por ID del componente
+            class_name: Buscar por nombre de clase CSS
+            type: Buscar por tipo de componente (clase o nombre de clase)
+            predicate: Función personalizada de filtrado que toma un componente y devuelve bool
+            
+        Returns:
+            ComponentQuery que permite encadenar operaciones y modificar atributos
+        """
+        results: List[Component] = []
+        
+        def match_component(comp: Component) -> bool:
+            if id is not None and comp.id != id:
+                return False
+            if class_name is not None and comp.class_name != class_name:
+                return False
+            if type is not None:
+                if isinstance(type, str):
+                    if comp.__class__.__name__ != type:
+                        return False
+                elif not isinstance(comp, type):
+                    return False
+            if predicate is not None and not predicate(comp):
+                return False
+            return True
+        
+        def search_recursive(component: Component):
+            if match_component(component):
+                results.append(component)
+            for child in component.children:
+                search_recursive(child)
+        
+        search_recursive(self)
+        return ComponentQuery(results)
+
+    @abstractmethod
+    def render(self, exporter: 'Exporter') -> str:
+        pass
+
+