dars-framework 1.2.3__py3-none-any.whl

dars/dars_tests/tests/test_advanced_components.py

@@ -0,0 +1,69 @@
+import importlib, inspect, sys, os
+from dars.core.component import Component
+from dars.components.basic.text import Text
+
+project_root = os.path.abspath(os.path.join(os.path.dirname(__file__), '..', 'dars'))
+if project_root not in sys.path:
+    sys.path.insert(0, project_root)
+
+failures = []
+
+def test_advanced_components():
+    base_pkg = 'dars.components.advanced'
+    try:
+        pkg = importlib.import_module(base_pkg)
+    except Exception as e:
+        raise AssertionError(f'Could not import {base_pkg}: {e}')
+    
+    pkg_path = os.path.dirname(pkg.__file__)
+    for fname in os.listdir(pkg_path):
+        if not fname.endswith('.py') or fname.startswith('__'):
+            continue
+        
+        modname = f"{base_pkg}.{fname[:-3]}"
+        try:
+            m = importlib.import_module(modname)
+        except Exception as e:
+            failures.append((modname, 'import', repr(e)))
+            continue
+        
+        for _name, obj in inspect.getmembers(m, inspect.isclass):
+            try:
+                if obj is Component: 
+                    continue
+                if issubclass(obj, Component):
+                    # Proporciona argumentos específicos para cada componente avanzado
+                    if _name == 'Accordion':
+                        instance = obj(sections=[{'title': 'Test', 'content': 'Content'}])
+                    elif _name == 'Table':
+                        instance = obj(columns=['Col1'], data=[['Data1']])
+                    elif _name == 'Tabs':
+                        instance = obj(tabs=['Tab1'], panels=[Text('Panel1')])
+                    elif _name == 'Card':
+                        instance = obj(title='Test Card')
+                    elif _name == 'Modal':
+                        instance = obj(title='Test Modal')
+                    elif _name == 'Navbar':
+                        instance = obj(brand='Test Navbar')
+                    else:
+                        # Intenta con argumentos mínimos para otros componentes
+                        try:
+                            instance = obj()
+                        except TypeError:
+                            instance = obj(id='test')
+                    
+                    # Verifica que la instancia se creó correctamente
+                    assert instance is not None, f"Failed to create instance of {_name}"
+                    
+            except Exception as e:
+                failures.append((f"{modname}.{_name}", 'init', repr(e)))
+    
+    assert not failures, failures
+
+if __name__ == '__main__':
+    try:
+        test_advanced_components()
+        print('test_advanced_components: OK')
+    except AssertionError as e:
+        print('test_advanced_components: FAIL', e)
+        sys.exit(1)

dars/dars_tests/tests/test_basic_components.py

@@ -0,0 +1,88 @@
+import importlib, inspect, sys, os
+from dars.core.component import Component
+
+project_root = os.path.abspath(os.path.join(os.path.dirname(__file__), '..', 'dars'))
+if project_root not in sys.path:
+    sys.path.insert(0, project_root)
+
+failures = []
+
+def test_basic_components():
+    base_pkg = 'dars.components.basic'
+    try:
+        pkg = importlib.import_module(base_pkg)
+    except Exception as e:
+        failures.append((base_pkg, 'import', repr(e)))
+        return
+    
+    pkg_path = os.path.dirname(pkg.__file__)
+    for fname in os.listdir(pkg_path):
+        if not fname.endswith('.py') or fname.startswith('__'):
+            continue
+        
+        modname = f"{base_pkg}.{fname[:-3]}"
+        try:
+            m = importlib.import_module(modname)
+        except Exception as e:
+            failures.append((modname, 'import', repr(e)))
+            continue
+        
+        for _name, obj in inspect.getmembers(m, inspect.isclass):
+            try:
+                if obj is Component: 
+                    continue
+                if issubclass(obj, Component):
+                    # Proporciona argumentos específicos para cada componente
+                    if _name == 'Image':
+                        instance = obj(src='test.png')
+                    elif _name == 'Link':
+                        instance = obj(text='Test', href='#')
+                    elif _name == 'Markdown':
+                        instance = obj(content='# Test')
+                    elif _name == 'ProgressBar':
+                        instance = obj(value=50)
+                    elif _name == 'Tooltip':
+                        from dars.components.basic.text import Text
+                        instance = obj(text='Tip', child=Text('Hover me'))
+                    elif _name == 'Button':
+                        instance = obj(text='Test Button')
+                    elif _name == 'Input':
+                        instance = obj()
+                    elif _name == 'Textarea':
+                        instance = obj()
+                    elif _name == 'Checkbox':
+                        instance = obj(label='Test Checkbox')
+                    elif _name == 'RadioButton':
+                        instance = obj(label='Test Radio', name='test_radio')
+                    elif _name == 'Select':
+                        instance = obj(options=[{'value': 'test', 'label': 'Test'}])
+                    elif _name == 'Slider':
+                        instance = obj()
+                    elif _name == 'DatePicker':
+                        instance = obj()
+                    elif _name == 'Container':
+                        instance = obj()
+                    elif _name == 'Text':
+                        instance = obj(text='Test Text')
+                    else:
+                        # Intenta con argumentos mínimos para otros componentes
+                        try:
+                            instance = obj()
+                        except TypeError:
+                            instance = obj(id='test', class_name='c', style={})
+                    
+                    # Verifica que la instancia se creó correctamente
+                    assert instance is not None, f"Failed to create instance of {_name}"
+                    
+            except Exception as e:
+                failures.append((f"{modname}.{_name}", 'init', repr(e)))
+    
+    assert not failures, failures
+
+if __name__ == '__main__':
+    try:
+        test_basic_components()
+        print('test_basic_components: OK')
+    except AssertionError as e:
+        print('test_basic_components: FAIL', e)
+        sys.exit(1)

dars/dars_tests/tests/test_core_and_cli.py

@@ -0,0 +1,17 @@
+import importlib, sys, os
+project_root = os.path.abspath(os.path.join(os.path.dirname(__file__), '..', 'dars'))
+if project_root not in sys.path:
+    sys.path.insert(0, project_root)
+
+def test_core_imports():
+    import dars.core.app as app
+    import dars.core.component as component
+    import dars.cli.main as cli_main
+    # smoke tests: ensure some expected names exist
+    assert hasattr(app, 'App') or hasattr(app, 'Page'), 'app module missing App/Page'
+    assert hasattr(component, 'Component'), 'component missing Component'
+    assert hasattr(cli_main, 'main') or hasattr(cli_main, 'run'), 'cli main missing entrypoint'
+    print('core_and_cli: OK')
+
+if __name__ == '__main__':
+    test_core_imports()

dars/dars_tests/tests/test_layout_components.py

@@ -0,0 +1,58 @@
+import importlib, inspect, sys, os
+from dars.core.component import Component
+
+project_root = os.path.abspath(os.path.join(os.path.dirname(__file__), '..', 'dars'))
+if project_root not in sys.path:
+    sys.path.insert(0, project_root)
+
+failures = []
+
+def test_layout_components():
+    base_pkg = 'dars.components.layout'
+    try:
+        pkg = importlib.import_module(base_pkg)
+    except Exception as e:
+        raise AssertionError(f'Could not import {base_pkg}: {e}')
+    
+    pkg_path = os.path.dirname(pkg.__file__)
+    for fname in os.listdir(pkg_path):
+        if not fname.endswith('.py') or fname.startswith('__'):
+            continue
+        
+        modname = f"{base_pkg}.{fname[:-3]}"
+        try:
+            m = importlib.import_module(modname)
+        except Exception as e:
+            failures.append((modname, 'import', repr(e)))
+            continue
+        
+        for _name, obj in inspect.getmembers(m, inspect.isclass):
+            try:
+                if obj is Component: 
+                    continue
+                if issubclass(obj, Component):
+                    # Intenta crear una instancia con argumentos mínimos
+                    try:
+                        instance = obj()
+                    except TypeError:
+                        try:
+                            instance = obj(id='test')
+                        except Exception as e:
+                            failures.append((f"{modname}.{_name}", 'init', repr(e)))
+                    
+                    # Verifica que la instancia se creó correctamente
+                    if 'instance' in locals():
+                        assert instance is not None, f"Failed to create instance of {_name}"
+                    
+            except Exception as e:
+                failures.append((f"{modname}.{_name}", 'inspect', repr(e)))
+    
+    assert not failures, failures
+
+if __name__ == '__main__':
+    try:
+        test_layout_components()
+        print('test_layout_components: OK')
+    except AssertionError as e:
+        print('test_layout_components: FAIL', e)
+        sys.exit(1)

dars/dars_tests/tests/test_version_check.py

@@ -0,0 +1,21 @@
+import importlib, sys, os
+project_root = os.path.abspath(os.path.join(os.path.dirname(__file__), '..', 'dars'))
+if project_root not in sys.path:
+    sys.path.insert(0, project_root)
+import dars.version as ver
+
+# Latest version observed on PyPI / mirrors during analysis: 1.1.3
+LATEST_KNOWN = '1.1.3'
+
+def test_version_comparison():
+    local = getattr(ver, '__version__', None)
+    assert local is not None, 'local version not found in dars.version'
+    print(f'local_version={local}; latest_known={LATEST_KNOWN}')
+    # The test will not fail if local is newer (dev), but will warn via printing when local differs.
+    if local != LATEST_KNOWN:
+        print('WARNING: local package version differs from LATEST_KNOWN (see test output).')
+    else:
+        print('version_check: OK')
+
+if __name__ == '__main__':
+    test_version_comparison()

dars/docs/app.md

@@ -0,0 +1,290 @@
+# App Class and PWA Features in Dars Framework
+
+## Overview
+
+The `App` class is the core of any Dars Framework application. It represents the complete application and manages all configuration, components, pages, and functionalities, including Progressive Web App (PWA) support.
+
+## Basic Structure
+
+```python
+class App:
+    def __init__(
+        self, 
+        title: str = "Dars App",
+        description: str = "",
+        author: str = "",
+        keywords: List[str] = None,
+        language: str = "en",
+        favicon: str = "",
+        icon: str = "",
+        apple_touch_icon: str = "",
+        manifest: str = "",
+        theme_color: str = "#000000",
+        background_color: str = "#ffffff",
+        service_worker_path: str = "",
+        service_worker_enabled: bool = False,
+        **config
+    ):
+```
+
+## Global Styles Management
+
+### Enhanced add_global_style() Method
+
+The `App` class now includes an enhanced `add_global_style()` method that supports both inline style definitions and external CSS file imports.
+
+
+#### Usage Examples
+
+**1. Inline Style Definition (Traditional)**
+```python
+app.add_global_style(
+    selector=".my-button",
+    styles={
+        "background-color": "#4CAF50",
+        "color": "white",
+        "padding": "10px 20px",
+        "border-radius": "5px"
+    }
+)
+```
+
+**2. External CSS File Import (New in v1.1.2)**
+```python
+app.add_global_style(file_path="styles.css")
+```
+
+**3. Combined Usage**
+```python
+# Add inline styles
+app.add_global_style(
+    selector=".primary-btn",
+    styles={
+        "background-color": "#007bff",
+        "color": "white"
+    }
+)
+
+# Import external CSS file
+app.add_global_style(file_path="components.css")
+```
+
+#### Practical Example with External CSS
+
+**main.py:**
+```python
+from dars.all import *
+
+app = App(title="Dars Styling Test")
+
+index = Page(
+    Container(
+        Button("Styled Button", class_name="button-styling-test"),
+        id="page_sub_container"
+    )
+)
+
+app.add_page(name="index", root=index, title="index", index=True)
+app.add_global_style(file_path="styles.css")
+
+if __name__ == "__main__":
+    app.rTimeCompile(add_file_types=".py, .css")
+```
+
+**styles.css:**
+```css
+.button-styling-test {
+    background-color: rgb(51, 255, 0);
+    padding: 15px 30px;
+    border-radius: 8px;
+    border: none;
+    font-weight: bold;
+    cursor: pointer;
+}
+
+.button-styling-test:hover {
+    background-color: rgb(30, 200, 0);
+    transform: scale(1.05);
+}
+
+#page_sub_container {
+    padding: 20px;
+    background-color: #f5f5f5;
+    min-height: 100vh;
+}
+```
+
+### Hot Reload for CSS Files
+
+When using `app.rTimeCompile()` with the `add_file_types=".css"` parameter, the development server automatically watches for changes in CSS files and reloads the application when modifications are detected.
+
+```python
+# Watch for both Python and CSS file changes
+app.rTimeCompile(add_file_types=".py, .css")
+
+# Or watch for CSS files only
+app.rTimeCompile(add_file_types=".css")
+```
+
+### Benefits of External CSS Import
+
+1. **Separation of Concerns**: Keep styles separate from application logic
+2. **Better Organization**: Maintain complex stylesheets in dedicated files
+3. **Team Collaboration**: Designers and developers can work simultaneously
+4. **CSS Preprocessors**: Use SASS, LESS, or other preprocessors
+5. **Performance**: Browser caching for external CSS files
+
+### Backward Compatibility
+
+The enhanced method maintains full backward compatibility - existing code using `add_global_style(selector, styles)` will continue to work without modification.
+
+
+## PWA Configuration Properties
+
+The App class includes these PWA-specific properties:
+
+```python
+# Icons and visual resources
+self.favicon = favicon  # Path to traditional favicon
+self.icon = icon  # Main icon for PWA (multiple sizes)
+self.apple_touch_icon = apple_touch_icon  # Icon for Apple devices
+self.manifest = manifest  # Path to manifest.json file
+
+# Colors and theme
+self.theme_color = theme_color  # Theme color (#RRGGBB)
+self.background_color = background_color  # Background color for splash screens
+
+# Service Worker
+self.service_worker_path = service_worker_path  # Path to service worker file
+self.service_worker_enabled = service_worker_enabled  # Enable/disable
+
+# Additional PWA configuration
+self.pwa_enabled = config.get('pwa_enabled', False)
+self.pwa_name = config.get('pwa_name', title)
+self.pwa_short_name = config.get('pwa_short_name', title[:12])
+self.pwa_display = config.get('pwa_display', 'standalone')
+self.pwa_orientation = config.get('pwa_orientation', 'portrait')
+```
+
+## Meta Tag Generation for PWA
+
+The App class provides methods to generate PWA meta tags:
+
+```python
+def get_meta_tags(self) -> Dict[str, str]:
+    """Returns all meta tags as a dictionary"""
+    meta_tags = {}
+    
+    # Viewport configured for responsiveness
+    viewport_parts = []
+    for key, value in self.config['viewport'].items():
+        if key == 'initial_scale':
+            viewport_parts.append(f'initial-scale={value}')
+        elif key == 'user_scalable':
+            viewport_parts.append(f'user-scalable={value}')
+        else:
+            viewport_parts.append(f'{key.replace("_", "-")}={value}')
+    meta_tags['viewport'] = ', '.join(viewport_parts)
+    
+    # Specific tags for PWA
+    meta_tags['theme-color'] = self.theme_color
+    if self.pwa_enabled:
+        meta_tags['mobile-web-app-capable'] = 'yes'
+        meta_tags['apple-mobile-web-app-capable'] = 'yes'
+        meta_tags['apple-mobile-web-app-status-bar-style'] = 'default'
+        meta_tags['apple-mobile-web-app-title'] = self.pwa_short_name
+    
+    return meta_tags
+```
+
+## Integration with HTML/CSS/JS Exporter
+
+The `HTMLCSSJSExporter` uses the PWA configuration from the App class to generate:
+
+1. **manifest.json file** - Progressive web app configuration
+2. **Meta tags** - To indicate PWA capabilities in different browsers
+3. **Icon references** - For multiple devices and sizes
+4. **Service Worker registration** - For offline functionality
+
+### Example of Generated Manifest.json
+
+```json
+{
+  "name": "App Name",
+  "short_name": "Short Name",
+  "description": "Application description",
+  "start_url": "/",
+  "display": "standalone",
+  "background_color": "#ffffff",
+  "theme_color": "#000000",
+  "orientation": "portrait",
+  "icons": [
+    {
+      "src": "icon-192x192.png",
+      "sizes": "192x192",
+      "type": "image/png"
+    },
+    {
+      "src": "icon-512x512.png",
+      "sizes": "512x512",
+      "type": "image/png"
+    }
+  ]
+}
+```
+
+### Service Worker Registration Script
+
+The exporter automatically generates code to register the service worker:
+
+```javascript
+if ('serviceWorker' in navigator && '{service_worker_path}') {
+  window.addEventListener('load', function() {
+    navigator.serviceWorker.register('{service_worker_path}')
+      .then(function(registration) {
+        console.log('ServiceWorker registration successful');
+      })
+      .catch(function(error) {
+        console.log('ServiceWorker registration failed: ', error);
+      });
+  });
+}
+```
+
+## Complete PWA App Configuration Example
+
+```python
+# Create a complete PWA application
+app = App(
+    title="My PWA App",
+    description="An amazing progressive application",
+    author="My Company",
+    keywords=["pwa", "webapp", "productivity"],
+    language="en",
+    favicon="assets/favicon.ico",
+    icon="assets/icon-192x192.png",
+    apple_touch_icon="assets/apple-touch-icon.png",
+    theme_color="#4A90E2",
+    background_color="#FFFFFF",
+    service_worker_path="sw.js",
+    service_worker_enabled=True,
+    pwa_enabled=True,
+    pwa_name="My App",
+    pwa_short_name="MyApp",
+    pwa_display="standalone"
+)
+
+# Add pages and components
+app.add_page("home", HomeComponent(), title="Home", index=True)
+app.add_page("about", AboutComponent(), title="About")
+```
+
+## Implementation Considerations
+
+### Browser Compatibility
+
+Dars Framework's PWA implementation is compatible with:
+- Chrome/Chromium (full support)
+- Firefox (basic support)
+- Safari (limited support on iOS)
+- Edge (full support)

dars/docs/cli.md

@@ -0,0 +1,80 @@
+# Dars CLI Reference
+
+The Dars Command Line Interface (CLI) lets you manage your projects, export apps, and preview results quickly from the terminal.
+
+## How to Use the CLI
+
+Open your terminal in your project directory and use any of the following commands:
+
+```bash
+# Show information about your app
+ dars info my_app.py
+
+# Export to different formats
+ dars export my_app.py --format html --output ./output
+
+# List supported export formats
+ dars formats
+
+# Initialize a new project
+ dars init my_new_project
+
+# Initialize a project with a specific template
+ dars init my_new_project -t demo/complete_app
+
+# Preview an exported app
+ dars preview ./output_directory
+
+# Help
+ dars --help
+
+# Version
+ dars -v
+```
+
+## Main Commands Table
+| 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               |
+
+## Using Official Templates
+
+Dars provides official templates to help you start new projects quickly. Templates include ready-to-use apps for forms, layouts, dashboards, multipage, and more.
+
+### How to Use a Template
+
+1. **Initialize a new project with a template:**
+   ```bash
+   dars init my_new_project -t basic/HelloWorld
+   # ...and more (see below)
+   ```
+
+You can see the templates available with
+
+```bash
+dars init --list-templates
+dars init  -L
+```
+
+2. **Export the template to HTML/CSS/JS:**
+   ```bash
+   dars export main.py --format html --output ./hello_output
+   dars export main.py --format html --output ./dashboard_output
+   # ...etc
+   ```
+3. **Preview the exported app:**
+   ```bash
+   dars preview ./hello_output
+   ```
+
+## Tips
+- Use `dars --help` for a full list of commands and options.
+- You can preview apps either live (with `app.rTimeCompile()`) or from exported files with `dars preview`.
+- Templates are available for quick project setup: use `dars init my_project -t <template>`.
+
+For more, see the [Getting Started](getting_started.md) guide and the main documentation index.