dars-framework 1.1.0__tar.gz → 1.1.2__tar.gz

dars_framework-1.1.2/MANIFEST.in

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

{dars_framework-1.1.0/dars_framework.egg-info → dars_framework-1.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dars-framework
-Version: 1.1.0
+Version: 1.1.2
 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 <zondax2009@gmail.com>
 License: MIT License
@@ -31,18 +31,21 @@ Requires-Dist: rich
 Requires-Dist: bs4
 Requires-Dist: uvicorn
 Requires-Dist: fastapi
+Requires-Dist: markdown2
 Dynamic: license-file
 
 # Dars Framework
 
 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.
 
-> Some Javascript or frontend stack required.
-
 ```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()`.
@@ -51,6 +54,7 @@ pip install dars-framework
 - For mor information visit the [Documentation](dars/docs/index.md)
 
 ## Quick Example: Your First App
+> Note: this is an single page example but you can build multipage apps with Page component see the [Components Documentation](dars/docs/components.md) to know more.
 
 ```python
 from dars import App, Container, Text, Button, InlineScript
@@ -107,6 +111,7 @@ if __name__ == "__main__":
 ## More
 - [Project Roadmap](ROADMAP.md)
 - [Getting Started](dars/docs/getting_started.md)
+- [App Class and PWA](dars/docs/app.md)
 - [Components Documentation](dars/docs/components.md)
 - [Custom Components](dars/docs/custom_components.md)
 - [Event Handling](dars/docs/events.md)

{dars_framework-1.1.0 → dars_framework-1.1.2}/README.md

@@ -2,12 +2,14 @@
 
 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.
 
-> Some Javascript or frontend stack required.
-
 ```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()`.
@@ -16,6 +18,7 @@ pip install dars-framework
 - For mor information visit the [Documentation](dars/docs/index.md)
 
 ## Quick Example: Your First App
+> Note: this is an single page example but you can build multipage apps with Page component see the [Components Documentation](dars/docs/components.md) to know more.
 
 ```python
 from dars import App, Container, Text, Button, InlineScript
@@ -72,6 +75,7 @@ if __name__ == "__main__":
 ## More
 - [Project Roadmap](ROADMAP.md)
 - [Getting Started](dars/docs/getting_started.md)
+- [App Class and PWA](dars/docs/app.md)
 - [Components Documentation](dars/docs/components.md)
 - [Custom Components](dars/docs/custom_components.md)
 - [Event Handling](dars/docs/events.md)

{dars_framework-1.1.0 → dars_framework-1.1.2}/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
@@ -55,5 +57,5 @@ __all__ = [
     'Accordion', 'Card', 'Modal', 'Navbar', 'Table', 'Tabs',
     'GridLayout', 'FlexLayout', 'LayoutBase', 'AnchorPoint',
     'InlineScript', 'FileScript', 'dScript', 'HTMLCSSJSExporter',
-    'EventTypes', 'EventHandler', 'EventEmitter', 'EventManager'
+    'EventTypes', 'EventHandler', 'EventEmitter', 'EventManager', 'Markdown'
 ]

{dars_framework-1.1.0 → dars_framework-1.1.2}/dars/cli/main.py

@@ -390,8 +390,46 @@ class DarsExporter:
     
 
     def init_project(self, name: str, template: Optional[str] = None):
-        # 2. Create main.py with example
-        HELLO_WORLD_CODE = """
+        """Initializes a base Dars project, optionally using a template"""
+        if os.path.exists(name):
+            console.print(f"[red]❌ {translator.get('directory_exists').format(name=name)}[/red]")
+            return
+
+        # Create project directory
+        os.makedirs(name)
+        console.print(f"[green]✔ {translator.get('directory_created').format(name=name)}[/green]")
+
+        if template:
+            # Get template information
+            templates = list_templates()
+            if template not in templates:
+                console.print(f"[red]❌ {translator.get('template_not_found').format(template=template)}[/red]")
+                return
+                
+            template_info = templates[template]
+            template_dir = template_info['template_dir']
+            extra_files = template_info['extra_files']
+
+            if not extra_files:
+                console.print(f"[yellow]⚠ {translator.get('template_empty').format(template=template)}[/yellow]")
+                return
+
+            # Copy ALL files (no main_file anymore)
+            for extra_file in extra_files:
+                src_file = template_dir / extra_file
+                dest_file = os.path.join(name, extra_file)
+                
+                # Create directories if needed
+                os.makedirs(os.path.dirname(dest_file), exist_ok=True)
+                
+                if src_file.exists():
+                    shutil.copy2(src_file, dest_file)
+                    console.print(f"[green]✔ {translator.get('extra_file_copied').format(file=extra_file)}[/green]")
+
+            console.print(f"[green]✔ {translator.get('template_copied').format(template=template)}[/green]")
+        else:
+            # Default hello world code (sin template)
+            HELLO_WORLD_CODE = """
 from dars.core.app import App
 from dars.components.basic.text import Text
 from dars.components.basic.button import Button
@@ -429,36 +467,17 @@ app.add_script(script)
 if __name__ == '__main__':
     app.rTimeCompile()
 """
-        """Initializes a base Dars project, optionally using a template"""
-        if os.path.exists(name):
-            console.print(f"[red]❌ {translator.get('directory_exists').format(name=name)}[/red]")
-            return
-
-        # 1. Create project directory
-        os.makedirs(name)
-        console.print(f"[green]✔ {translator.get('directory_created').format(name=name)}[/green]")
-
-
-        # 4. Generate main.py
-        main_py = Path(name) / "main.py"
-        if template:
-            templates = list_templates()
-            src = templates[template]
-            shutil.copy(src, main_py)
-            console.print(f"[green]✔ {translator.get('template_copied').format(template=template)}[/green]")
-        else:
-            # embedded hello world code...
-            main_py.write_text(HELLO_WORLD_CODE, encoding="utf-8")
+            main_py = Path(name) / "main.py"
+            main_py.write_text(HELLO_WORLD_CODE.strip(), encoding="utf-8")
             console.print(f"[green]✔ {translator.get('main_py_created')}[/green]")
 
-        # 5. Final instructions
+        # Final instructions
         console.print(f"\n[bold cyan]🎉 {translator.get('project_initialized')}[/bold cyan]")
         console.print(Syntax(f"cd {name}", "bash"))
         console.print(Syntax(f"\n{translator.get('export_command')}:", "bash"))
-        console.print(Syntax(f"dars export main.py --format html --output build", "bash"))
+        console.print(Syntax(f"dars export (python file) --format html --output build", "bash"))
         console.print(Syntax(f"\n{translator.get('preview_command')}:", "bash"))
-        console.print(Syntax(f"dars preview build", "bash")) 
-    
+        console.print(Syntax(f"python (python file)", "bash"))
 
 def print_version_info():
     import importlib.util
@@ -493,13 +512,25 @@ def create_parser() -> argparse.ArgumentParser:
     # Export command
     export_parser = subparsers.add_parser('export', help=translator.get('export_help'))
     export_parser.add_argument('file', help=translator.get('file_help'))
-    export_parser.add_argument('--format', '-f', required=True, 
-                              choices=["html"],
-                              help=translator.get('format_help'))
-    export_parser.add_argument('--output', '-o', required=True,
-                              help=translator.get('output_help'))
+
+    # --format opcional (default: html)
+    export_parser.add_argument(
+        '--format', '-f',
+        choices=["html"],
+        default="html",
+        help=translator.get('format_help') + " (default: html)"
+    )
+
+    # --output opcional (default: ./dist)
+    export_parser.add_argument(
+        '--output', '-o',
+        default="./dist",
+        help=translator.get('output_help') + " (default: ./dist)"
+    )
+
     export_parser.add_argument('--preview', '-p', action='store_true',
-                              help=translator.get('preview_help'))
+                            help=translator.get('preview_help'))
+
     
     # Info command
     info_parser = subparsers.add_parser('info', help=translator.get('info_help'))
@@ -511,14 +542,16 @@ def create_parser() -> argparse.ArgumentParser:
     # Preview command
     preview_parser = subparsers.add_parser('preview', help=translator.get('preview_cmd_help'))
     preview_parser.add_argument('path', help=translator.get('path_help'))
-
-    # Init command
+    
     init_parser = subparsers.add_parser('init', help=translator.get('init_help'))
-    init_parser.add_argument('name', help=translator.get('name_help'))
-    tmpl_choices = list_templates().keys()
+    init_parser.add_argument('name', nargs='?', help=translator.get('name_help'))
+    init_parser.add_argument(
+        '--list-templates', '-L',  # Cambia -l por -L
+        action='store_true',
+        help=translator.get('list_templates_help')
+    )
     init_parser.add_argument(
-        '-t', '--template',
-        choices=tmpl_choices,
+        '--template', '-t',
         help=translator.get('template_help')
     )
     # Add language option to all subparsers
@@ -527,19 +560,123 @@ def create_parser() -> argparse.ArgumentParser:
                               help=translator.get('lang_help'))
     
     return parser
-def list_templates() -> Dict[str, Path]:
-        """
-        Busca carpetas dentro de dars/templates/examples y devuelve un dict
-        { "basic/hello_world.py": Path(...), ... }
-        """
-        tmpl_root = Path(resources.files("dars.templates") / "examples")
-        templates = {}
-        for category in tmpl_root.iterdir():
-            if category.is_dir():
-                for py in category.glob("*.py"):
-                    key = f"{category.name}/{py.stem}"
-                    templates[key] = py
-        return templates
+
+from pathlib import Path
+from typing import Dict
+
+from pathlib import Path
+from typing import Dict
+
+from pathlib import Path
+from typing import Dict
+
+from pathlib import Path
+from typing import Dict
+
+from pathlib import Path
+from typing import Dict
+
+from pathlib import Path
+from typing import Dict
+
+def list_templates(debug: bool = False) -> Dict[str, Dict]:
+    """
+    Descubre templates:
+    - ignora dirs en IGNORED_DIRS (ej: __pycache__, .git, node_modules)
+    - ignora extensiones compiladas ('.pyc', '.pyo', '.pyd')
+    - ignora solo archivos ocultos que empiezan con '.' (ej: .env)
+    - incluye TODOS los demás archivos ('.py', '.md', '.png', '.json', etc.)
+    - salida determinista (ordenada)
+    """
+    current_file = Path(__file__).resolve()
+    templates_base = current_file.parent.parent / "templates" / "examples"
+
+    if not templates_base.exists():
+        # usa console.print si tienes rich.console; aquí dejo print para compatibilidad
+        print(f"[red]Error: Template directory not found: {templates_base}[/red]")
+        return {}
+
+    IGNORED_DIRS = {'__pycache__', '.git', '.venv', 'node_modules', '.pytest_cache'}
+    IGNORE_EXTS = {'.pyc', '.pyo', '.pyd'}
+
+    templates: Dict[str, Dict] = {}
+
+    for category_dir in sorted(templates_base.iterdir()):
+        if not (category_dir.is_dir() and not category_dir.name.startswith('__')):
+            continue
+
+        for template_dir in sorted(category_dir.iterdir()):
+            if not (template_dir.is_dir() and not template_dir.name.startswith('__')):
+                continue
+
+            found_files = []
+            for file_path in sorted(template_dir.rglob('*')):
+                # 1) archivo
+                if not file_path.is_file():
+                    if debug: print(f"SKIP (not file): {file_path}")
+                    continue
+
+                # 2) si alguna parte del path es una carpeta ignorada
+                intersect = set(file_path.parts) & IGNORED_DIRS
+                if intersect:
+                    if debug: print(f"SKIP (ignored dir {intersect}): {file_path}")
+                    continue
+
+                # 3) extensiones compiladas
+                if file_path.suffix.lower() in IGNORE_EXTS:
+                    if debug: print(f"SKIP (ignored ext): {file_path}")
+                    continue
+
+                # 4) solo ocultos que empiezan con '.' (por ejemplo .gitignore, .env)
+                if file_path.name.startswith('.'):
+                    if debug: print(f"SKIP (hidden file): {file_path}")
+                    continue
+
+                # si pasó todos los filtros, lo guardamos (ruta relativa al template)
+                rel = str(file_path.relative_to(template_dir))
+                if debug: print(f"INCLUDE: {rel}")
+                found_files.append(rel)
+
+            found_files = sorted(found_files)
+
+            template_key = f"{category_dir.name}/{template_dir.name}"
+            templates[template_key] = {
+                'main_file': None,            # ya no usamos main_file
+                'extra_files': found_files,
+                'category': category_dir.name,
+                'template_dir': template_dir,
+                'all_files': found_files
+            }
+
+    return templates
+
+
+
+                    
+def list_templates_detailed():
+    """Muestra información detallada de los templates disponibles"""
+    templates = list_templates()
+    
+    if not templates:
+        console.print("[yellow]No templates found[/yellow]")
+        return
+    
+    table = Table(title="Available Templates")
+    table.add_column("Template", style="cyan")
+    table.add_column("Category", style="green")
+    table.add_column("Extra Files", style="white")
+    table.add_column("Description", style="dim")
+    
+    for template_name, template_info in templates.items():
+        extra_files = ", ".join(template_info['extra_files']) if template_info['extra_files'] else "None"
+        table.add_row(
+            template_name,
+            template_info['category'],
+            extra_files,
+            f"Template with {len(template_info['extra_files'])} extra files"
+        )
+    
+    console.print(table)
 def main():
     """Main CLI function"""
     # Check for language parameter before parsing arguments
@@ -624,7 +761,13 @@ def main():
         exporter.show_supported_formats()
     
     elif args.command == 'init':
-        exporter.init_project(args.name, template=args.template)
+        if args.list_templates:
+            list_templates_detailed()
+        elif not args.name:
+            console.print("[red]Error: Project name is required[/red]")
+            parser.parse_args(['init', '--help'])
+        else:
+            exporter.init_project(args.name, template=args.template)
 
         
     elif args.command == 'preview':

{dars_framework-1.1.0 → dars_framework-1.1.2}/dars/cli/translations.py

@@ -19,7 +19,9 @@ translations = {
         'preview_help': "Preview information",
         'preview_cmd_help': "Preview exported application",
         'init_help': "Create a Dars project",
-        
+        'template_not_found': "Template '{template}' not found",
+        'extra_file_copied': "Extra file '{file}' copied",
+                
         # Export command
         'file_help': "Python file with Dars application",
         'format_help': "Export format",
@@ -158,6 +160,8 @@ translations = {
         'cli_description': "Dars Exporter - Exporta aplicaciones Dars a Web",
         'cli_subtitle': "Framework de UI multiplataforma en Python",
         'main_description': "Dars Exporter - Exporta aplicaciones Dars a Web",
+        'template_not_found': "Template '{template}' not found",
+        'extra_file_copied': "Extra file '{file}' copied",
         
         # Commands
         'available_commands': "Comandos disponibles",

dars_framework-1.1.2/dars/components/basic/markdown.py

@@ -0,0 +1,86 @@
+from typing import Optional, Dict, Any, Callable, Union
+import os
+from dars.core.component import Component
+
+class Markdown(Component):
+    def __init__(
+        self,
+        content: Optional[str] = None,
+        file_path: Optional[str] = None,
+        id: Optional[str] = None,
+        class_name: Optional[str] = None,
+        style: Optional[Dict[str, Any]] = None,
+        dark_theme: bool = False,
+        **kwargs
+    ):
+        """
+        Markdown component that converts markdown content to HTML.
+        
+        Args:
+            content: String with markdown content
+            file_path: Path to a .md file to load content from
+            id: Component ID
+            class_name: CSS class name
+            style: CSS styles
+            dark_theme: Enable dark theme styling
+        """
+        super().__init__(id=id, class_name=class_name, style=style, **kwargs)
+        
+        if content and file_path:
+            raise ValueError("Only content or file_path can be specified, not both")
+        
+        if not content and not file_path:
+            raise ValueError("Either content or file_path must be specified")
+        
+        self.content = content
+        self.file_path = file_path
+        self.dark_theme = dark_theme
+        self.rendered_html = ""
+        
+        # Load and process markdown content
+        self._load_and_process_content()
+    
+    def _load_and_process_content(self):
+        """Load and process markdown content."""
+        if self.file_path:
+            if not os.path.exists(self.file_path):
+                raise FileNotFoundError(f"File {self.file_path} does not exist")
+            
+            if not self.file_path.endswith('.md'):
+                raise ValueError("File must have .md extension")
+            
+            with open(self.file_path, 'r', encoding='utf-8') as f:
+                self.content = f.read()
+    
+    def update_content(self, new_content: Optional[str] = None, new_file_path: Optional[str] = None):
+        """
+        Update the markdown content of the component.
+        
+        Args:
+            new_content: New markdown content as string
+            new_file_path: New markdown file path
+        """
+        if new_content and new_file_path:
+            raise ValueError("Only new_content or new_file_path can be specified, not both")
+        
+        if new_content:
+            self.content = new_content
+            self.file_path = None
+        elif new_file_path:
+            self.file_path = new_file_path
+            self.content = None
+        
+        self._load_and_process_content()
+    
+    def set_dark_theme(self, enabled: bool = True):
+        """Enable or disable dark theme"""
+        self.dark_theme = enabled
+        # Add dark theme class dynamically
+        if enabled:
+            self.class_name = f"{self.class_name or ''} dars-markdown-dark"
+        else:
+            self.class_name = self.class_name.replace("dars-markdown-dark", "") if self.class_name else ""
+    
+    def render(self, exporter: Any) -> str:
+        # El método render será implementado por cada exportador
+        raise NotImplementedError("El método render debe ser implementado por el exportador")

{dars_framework-1.1.0 → dars_framework-1.1.2}/dars/core/app.py

@@ -127,7 +127,7 @@ class Page:
 class App:
     """Main class that represents a Dars application"""
 
-    def rTimeCompile(self, exporter=None, port=None, add_file_types=None):
+    def rTimeCompile(self, exporter=None, port=None, add_file_types=".py, .js, .css"):
         """
         Generates a quick preview of the app on a local server using an exporter  
         (default: HTMLCSSJSExporter) and serving the files from a temporary directory.  
@@ -368,7 +368,7 @@ class App:
                                             pass
 
                                 if not new_app:
-                                    (console.print("[red]No App instance found after reload.[/red]")
+                                    (console.print("[red]No App instance found after reload.")
                                     if console else print("[Dars] No App instance found after reload."))
                                     return
 
@@ -480,7 +480,7 @@ class App:
 
     
     def __init__(
-        self, 
+        self,
         title: str = "Dars App",
         description: str = "",
         author: str = "",
@@ -554,6 +554,7 @@ class App:
         self._index_page: str = None           # Nombre de la página principal (si existe)
         self.scripts: List['Script'] = []
         self.global_styles: Dict[str, Any] = {}
+        self.global_style_files: List[str] = []
         self.event_manager = EventManager()
         self.config = config
         
@@ -618,9 +619,26 @@ class App:
         """Adds a script to the app"""
         self.scripts.append(script)
         
-    def add_global_style(self, selector: str, styles: Dict[str, Any]):
-        """Adds a global style to the app"""
+    def add_global_style(self, selector: str = None, styles: Dict[str, Any] = None, file_path: str = None):
+        """
+        Adds a global style to the app.
+        
+        - If file_path is provided, the CSS file is read and stored.
+        - If selector and styles are provided, they are stored as inline CSS rules.
+        - It is invalid to mix file_path with selector/styles.
+        """
+        if file_path:
+            if selector or styles:
+                raise ValueError("Cannot use selector/styles when file_path is provided.")
+            if file_path not in self.global_style_files:
+                self.global_style_files.append(file_path)
+            return self
+
+        if not selector or not styles:
+            raise ValueError("Must provide selector and styles when file_path is not used.")
+        
         self.global_styles[selector] = styles
+        return self
         
     def set_theme(self, theme: str):
         """Set the theme for the app"""