pyreact-framework 1.0.1__tar.gz → 1.0.2__tar.gz

{pyreact_framework-1.0.1 → pyreact_framework-1.0.2}/PKG-INFO

@@ -1,13 +1,14 @@
 Metadata-Version: 2.4
 Name: pyreact-framework
-Version: 1.0.1
+Version: 1.0.2
 Summary: Framework web declarativo inspirado no React, construído nativamente para Python
 Author-email: wanbnn <wanbnn@users.noreply.github.com>
 License: MIT
 Project-URL: Homepage, https://github.com/wanbnn/pyreact
-Project-URL: Documentation, https://pyreact.readthedocs.io
+Project-URL: Documentation, https://pyreact-framework.readthedocs.io
 Project-URL: Repository, https://github.com/wanbnn/pyreact
 Project-URL: Issues, https://github.com/wanbnn/pyreact/issues
+Project-URL: Changelog, https://pyreact-framework.readthedocs.io/en/latest/resources/changelog.html
 Keywords: react,ui,frontend,declarative,components,virtual-dom,web,framework
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -159,6 +160,38 @@ def MyComponent(props):
 
 ## 📖 Documentação
 
+### 📚 Documentação Completa
+
+A documentação completa está disponível no **Read the Docs**:
+
+🔗 **https://pyreact-framework.readthedocs.io/**
+
+#### Conteúdo da Documentação:
+
+- **Getting Started**
+  - Installation
+  - Quick Start
+  - Tutorial (Todo App)
+  
+- **Core Concepts**
+  - Components
+  - Props
+  - State
+  - Events
+  - Lifecycle
+  
+- **Advanced**
+  - Server-Side Rendering (SSR)
+  - Routing
+  - Styling
+  - Testing
+  
+- **API Reference**
+  - Element API
+  - Component API
+  - Hooks API
+  - CLI API
+
 ### CLI Commands
 
 ```bash

{pyreact_framework-1.0.1 → pyreact_framework-1.0.2}/README.md

@@ -123,6 +123,38 @@ def MyComponent(props):
 
 ## 📖 Documentação
 
+### 📚 Documentação Completa
+
+A documentação completa está disponível no **Read the Docs**:
+
+🔗 **https://pyreact-framework.readthedocs.io/**
+
+#### Conteúdo da Documentação:
+
+- **Getting Started**
+  - Installation
+  - Quick Start
+  - Tutorial (Todo App)
+  
+- **Core Concepts**
+  - Components
+  - Props
+  - State
+  - Events
+  - Lifecycle
+  
+- **Advanced**
+  - Server-Side Rendering (SSR)
+  - Routing
+  - Styling
+  - Testing
+  
+- **API Reference**
+  - Element API
+  - Component API
+  - Hooks API
+  - CLI API
+
 ### CLI Commands
 
 ```bash

{pyreact_framework-1.0.1 → pyreact_framework-1.0.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pyreact-framework"
-version = "1.0.1"
+version = "1.0.2"
 description = "Framework web declarativo inspirado no React, construído nativamente para Python"
 readme = "README.md"
 license = {text = "MIT"}
@@ -51,9 +51,10 @@ dev = [
 
 [project.urls]
 Homepage = "https://github.com/wanbnn/pyreact"
-Documentation = "https://pyreact.readthedocs.io"
+Documentation = "https://pyreact-framework.readthedocs.io"
 Repository = "https://github.com/wanbnn/pyreact"
 Issues = "https://github.com/wanbnn/pyreact/issues"
+Changelog = "https://pyreact-framework.readthedocs.io/en/latest/resources/changelog.html"
 
 [project.scripts]
 pyreact-framework = "pyreact.cli.main:main"

{pyreact_framework-1.0.1 → pyreact_framework-1.0.2}/pyreact/__init__.py

@@ -8,25 +8,25 @@ componentizadas e modernas, sem precisar aprender JavaScript/TypeScript.
 
 Quick Start:
     from pyreact import h, render, use_state
-    
+
     def Counter(props):
         count, set_count = use_state(0)
         return h('div', {'className': 'counter'},
             h('span', None, f"Count: {count}"),
             h('button', {'onClick': lambda _: set_count(count + 1)}, '+')
         )
-    
+
     render(h(Counter, None), document.getElementById('root'))
 
 Princípios:
-    - Declaratividade: A UI é uma função do estado
-    - Componentização: Tudo é um componente
-    - Reatividade: Mudanças de estado disparam re-renderizações
-    - Isomorfismo: Suporte a Server-Side Rendering
+- Declaratividade: A UI é uma função do estado
+- Componentização: Tudo é um componente
+- Reatividade: Mudanças de estado disparam re-renderizações
+- Isomorfismo: Suporte a Server-Side Rendering
 """
 
-__version__ = '1.0.0'
-__author__ = 'PyReact Team'
+__version__ = '1.0.2'
+__author__ = 'wanbnn'
 
 # Core
 from .core.element import VNode, h, create_element, is_valid_element, clone_element
@@ -66,6 +66,13 @@ from .core.memo import memo, lazy
 # Error Boundary
 from .core.error_boundary import ErrorBoundary
 
+# Router
+from .core.router import Router, Route, Link, Redirect, Switch
+from .core.router import useParams, useLocation, useHistory
+
+# Theme
+from .core.theme import ThemeProvider, ThemeContext, use_theme
+
 # Scheduler
 from .core.scheduler import Scheduler, Priority
 
@@ -78,10 +85,11 @@ from .server.ssr import render_to_string, render_to_static_markup
 # DOM
 from .dom.dom_operations import document
 
+
 __all__ = [
     # Version
     '__version__',
-    
+
     # Core
     'VNode',
     'h',
@@ -94,7 +102,7 @@ __all__ = [
     'hydrate',
     'create_root',
     'Reconciler',
-    
+
     # Hooks
     'use_state',
     'use_reducer',
@@ -109,36 +117,51 @@ __all__ = [
     'use_id',
     'use_transition',
     'use_deferred_value',
-    
+
     # Context
     'create_context',
-    
+
     # Refs
     'create_ref',
     'forward_ref',
-    
+
     # Portal
     'create_portal',
-    
+
     # Memo
     'memo',
     'lazy',
-    
+
     # Error Boundary
     'ErrorBoundary',
-    
+
+    # Router
+    'Router',
+    'Route',
+    'Link',
+    'Redirect',
+    'Switch',
+    'useParams',
+    'useLocation',
+    'useHistory',
+
+    # Theme
+    'ThemeProvider',
+    'ThemeContext',
+    'use_theme',
+
     # Scheduler
     'Scheduler',
     'Priority',
-    
+
     # Styles
     'styled',
     'css_module',
-    
+
     # Server
     'render_to_string',
     'render_to_static_markup',
-    
+
     # DOM
     'document',
 ]

{pyreact_framework-1.0.1 → pyreact_framework-1.0.2}/pyreact/cli/main.py

@@ -453,17 +453,63 @@ def build_project() -> None:
 def run_tests() -> None:
     """Run tests"""
     import subprocess
-    
     print("Running tests...")
     result = subprocess.run(['pytest', 'tests/', '-v'])
     sys.exit(result.returncode)
 
+def serve_build(port: int = 5000, directory: str = 'dist') -> None:
+    """Serve production build"""
+    import http.server
+    import socketserver
+    
+    # Check if directory exists
+    if not Path(directory).exists():
+        print(f"Error: Directory '{directory}' not found")
+        print("Run 'pyreact build' first")
+        sys.exit(1)
+    
+    # Change to directory
+    original_dir = os.getcwd()
+    os.chdir(directory)
+    
+    # Create handler
+    class Handler(http.server.SimpleHTTPRequestHandler):
+        def log_message(self, format, *args):
+            print(f"[{self.log_date_time_string()}] {format % args}")
+    
+    try:
+        socketserver.TCPServer.allow_reuse_address = True
+        with socketserver.TCPServer(("", port), Handler) as httpd:
+            url = f"http://localhost:{port}"
+            print(f"[OK] Serving production build at {url}")
+            print(f"Directory: {directory}")
+            print(f"\nPress Ctrl+C to stop")
+            httpd.serve_forever()
+    except OSError as e:
+        os.chdir(original_dir)
+        if 'Address already in use' in str(e) or e.errno == 10048:
+            print(f"Error: Port {port} is already in use")
+            print(f"Try: pyreact serve --port {port + 1}")
+        else:
+            print(f"Error: {e}")
+        sys.exit(1)
+    except KeyboardInterrupt:
+        print("\n\n[OK] Server stopped")
+    finally:
+        os.chdir(original_dir)
+
+
+def show_version():
+    """Display PyReact version"""
+    print("PyReact Framework v1.0.2")
+
 
 def main():
     """Main CLI entry point"""
     parser = argparse.ArgumentParser(
         description='PyReact - Framework Web Declarativo para Python'
     )
+    parser.add_argument('-v', '--version', action='store_true', help='Show version')
     
     subparsers = parser.add_subparsers(dest='command', help='Available commands')
     
@@ -481,6 +527,11 @@ def main():
     # Test command
     subparsers.add_parser('test', help='Run tests')
     
+    # Serve command
+    serve_parser = subparsers.add_parser('serve', help='Serve production build')
+    serve_parser.add_argument('--port', type=int, default=5000, help='Port number')
+    serve_parser.add_argument('--dir', default='dist', help='Directory to serve')
+    
     # Generate command
     gen_parser = subparsers.add_parser('generate', help='Generate component or hook')
     gen_parser.add_argument('type', choices=['component', 'hook'], help='Type to generate')
@@ -490,6 +541,11 @@ def main():
     
     args = parser.parse_args()
     
+    # Handle --version flag
+    if hasattr(args, 'version') and args.version:
+        show_version()
+        return
+    
     if args.command == 'create':
         create_project(args.name)
     elif args.command == 'dev':
@@ -498,15 +554,22 @@ def main():
         build_project()
     elif args.command == 'test':
         run_tests()
+    elif args.command == 'serve':
+        serve_build(args.port, args.dir)
     elif args.command == 'generate':
         if args.type == 'component':
             component_type = 'class' if args.class_type else 'functional'
             generate_component(args.name, component_type)
         elif args.type == 'hook':
             generate_hook(args.name)
+        else:
+            parser.print_help()
     else:
         parser.print_help()
 
 
+
+
+
 if __name__ == '__main__':
     main()

pyreact_framework-1.0.2/pyreact/core/router.py

@@ -0,0 +1,258 @@
+"""
+Router Module
+=============
+
+Declarative routing for Single Page Applications.
+"""
+
+from typing import Any, Callable, Dict, List, Optional, Union
+from .element import VNode, h
+from .component import Component
+
+
+class Router(Component):
+    """
+    Main router component that manages navigation state.
+    
+    Usage:
+        element(Router, {},
+            element(Route, {'path': '/', 'component': Home}),
+            element(Route, {'path': '/about', 'component': About})
+        )
+    """
+    
+    def __init__(self, props: Dict[str, Any]):
+        super().__init__(props)
+        self.state = {
+            'path': self._get_current_path()
+        }
+        self._setup_listeners()
+    
+    def _get_current_path(self) -> str:
+        """Get current path from window location"""
+        # In browser environment, get from window.location
+        # For SSR, get from props or default to '/'
+        return self.props.get('initialPath', '/')
+    
+    def _setup_listeners(self):
+        """Setup popstate listener for browser navigation"""
+        # In browser, would add event listener
+        # For now, this is a placeholder
+        pass
+    
+    def navigate(self, path: str):
+        """Navigate to a new path"""
+        self.setState({'path': path})
+    
+    def get_context_value(self) -> Dict[str, Any]:
+        """Get router context value"""
+        return {
+            'path': self.state['path'],
+            'navigate': self.navigate,
+            'params': {},
+            'query': {}
+        }
+    
+    def render(self) -> VNode:
+        """Render router and children"""
+        children = self.props.get('children', [])
+        
+        # Find matching route
+        for child in children:
+            if hasattr(child, 'props') and child.props.get('path') == self.state['path']:
+                component = child.props.get('component')
+                if component:
+                    if callable(component):
+                        return component()
+                    else:
+                        return h(component, {})
+        
+        # No matching route, render 404 or nothing
+        return h('div', {}, '404 - Page Not Found')
+
+
+class Route(Component):
+    """
+    Route component that defines a path and its component.
+    
+    Usage:
+        element(Route, {'path': '/', 'component': Home})
+    """
+    
+    def render(self) -> VNode:
+        """Route doesn't render directly, it's used by Router"""
+        # This is a declarative component, Router handles rendering
+        return None
+
+
+class Link(Component):
+    """
+    Navigation link component.
+    
+    Usage:
+        element(Link, {'to': '/about'}, 'About Page')
+    """
+    
+    def __init__(self, props: Dict[str, Any]):
+        super().__init__(props)
+        self.handleClick = self._handle_click
+    
+    def _handle_click(self, event):
+        """Handle click event"""
+        # Prevent default link behavior
+        if hasattr(event, 'preventDefault'):
+            event.preventDefault()
+        
+        # Navigate to new path
+        to = self.props.get('to', '/')
+        
+        # In browser, would use history.pushState
+        # For now, just update state
+        print(f"Navigate to: {to}")
+    
+    def render(self) -> VNode:
+        """Render link element"""
+        to = self.props.get('to', '/')
+        children = self.props.get('children', [])
+        
+        return h('a', {
+            'href': to,
+            'onClick': self.handleClick,
+            'style': {'cursor': 'pointer'}
+        }, *children)
+
+
+class Redirect(Component):
+    """
+    Redirect component that navigates to a new path.
+    
+    Usage:
+        element(Redirect, {'to': '/login'})
+    """
+    
+    def component_did_mount(self):
+        """Redirect when mounted"""
+        to = self.props.get('to', '/')
+        # In browser, would use history.replaceState
+        print(f"Redirect to: {to}")
+    
+    def render(self) -> VNode:
+        """Redirect doesn't render anything"""
+        return None
+
+
+class Switch(Component):
+    """
+    Switch component that renders the first matching Route.
+    
+    Usage:
+        element(Switch, {},
+            element(Route, {'path': '/', 'component': Home}),
+            element(Route, {'path': '/about', 'component': About}),
+            element(Route, {'component': NotFound})  # 404 fallback
+        )
+    """
+    
+    def render(self) -> VNode:
+        """Render first matching route"""
+        children = self.props.get('children', [])
+        
+        for child in children:
+            if hasattr(child, 'props'):
+                path = child.props.get('path')
+                component = child.props.get('component')
+                
+                # If no path, it's a fallback (404)
+                if path is None:
+                    if component:
+                        if callable(component):
+                            return component()
+                        else:
+                            return h(component, {})
+                
+                # Check if path matches
+                # TODO: Implement proper path matching with params
+                if path == self._get_current_path():
+                    if component:
+                        if callable(component):
+                            return component()
+                        else:
+                            return h(component, {})
+        
+        return None
+    
+    def _get_current_path(self) -> str:
+        """Get current path"""
+        # TODO: Get from Router context
+        return '/'
+
+
+# Hook functions for functional components
+
+def useParams() -> Dict[str, str]:
+    """
+    Get route parameters.
+    
+    Usage:
+        params = useParams()
+        user_id = params['id']
+    """
+    # TODO: Implement with context
+    return {}
+
+
+def useLocation() -> Dict[str, Any]:
+    """
+    Get current location information.
+    
+    Usage:
+        location = useLocation()
+        query = location.get('query', '')
+    """
+    # TODO: Implement with context
+    return {
+        'pathname': '/',
+        'search': '',
+        'hash': ''
+    }
+
+
+def useHistory():
+    """
+    Get history object for programmatic navigation.
+    
+    Usage:
+        history = useHistory()
+        history.push('/new-path')
+    """
+    class History:
+        def push(self, path: str):
+            """Navigate to new path"""
+            print(f"Navigate to: {path}")
+        
+        def replace(self, path: str):
+            """Replace current path"""
+            print(f"Replace with: {path}")
+        
+        def go_back(self):
+            """Go back in history"""
+            print("Go back")
+        
+        def go_forward(self):
+            """Go forward in history"""
+            print("Go forward")
+    
+    return History()
+
+
+# Export router components
+__all__ = [
+    'Router',
+    'Route',
+    'Link',
+    'Redirect',
+    'Switch',
+    'useParams',
+    'useLocation',
+    'useHistory',
+]

pyreact_framework-1.0.2/pyreact/core/theme.py

@@ -0,0 +1,107 @@
+"""
+Theme Provider
+==============
+
+Context-based theming system for PyReact applications.
+"""
+
+from typing import Any, Dict, Optional
+from .context import Context, create_context
+
+
+# Create theme context
+ThemeContext = create_context({})
+
+
+class ThemeProvider:
+    """
+    Theme provider component that makes theme available to all descendants.
+    
+    Usage:
+        element(ThemeProvider, {'theme': {'primary': '#007bff'}},
+            element(App, {})
+        )
+    """
+    
+    def __init__(self, props: Dict[str, Any]):
+        self.props = props
+        self.theme = props.get('theme', {})
+    
+    def render(self):
+        """Render with theme context"""
+        from .element import element
+        
+        children = self.props.get('children', [])
+        
+        return element(ThemeContext.Provider, {
+            'value': self.theme
+        }, *children)
+    
+    def get_child_context(self) -> Dict[str, Any]:
+        """Get context for children"""
+        return {
+            'theme': self.theme
+        }
+
+
+def use_theme() -> Dict[str, Any]:
+    """
+    Hook to access current theme.
+    
+    Usage:
+        theme = use_theme()
+        color = theme['primary']
+    
+    Returns:
+        Current theme object
+    """
+    # This would use useContext in a real implementation
+    # For now, return default theme
+    return {
+        'primary': '#007bff',
+        'secondary': '#6c757d',
+        'success': '#28a745',
+        'danger': '#dc3545',
+        'warning': '#ffc107',
+        'info': '#17a2b8',
+        'light': '#f8f9fa',
+        'dark': '#343a40'
+    }
+
+
+# Default theme
+DEFAULT_THEME = {
+    'primary': '#007bff',
+    'secondary': '#6c757d',
+    'success': '#28a745',
+    'danger': '#dc3545',
+    'warning': '#ffc107',
+    'info': '#17a2b8',
+    'light': '#f8f9fa',
+    'dark': '#343a40',
+    'fontFamily': '-apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif',
+    'fontSize': '16px',
+    'borderRadius': '4px',
+    'spacing': {
+        'xs': '4px',
+        'sm': '8px',
+        'md': '16px',
+        'lg': '24px',
+        'xl': '32px'
+    },
+    'breakpoints': {
+        'sm': '576px',
+        'md': '768px',
+        'lg': '992px',
+        'xl': '1200px'
+    }
+}
+
+
+# Export
+__all__ = [
+    'ThemeProvider',
+    'ThemeContext',
+    'use_theme',
+    'DEFAULT_THEME',
+]

{pyreact_framework-1.0.1 → pyreact_framework-1.0.2}/pyreact_framework.egg-info/PKG-INFO

@@ -1,13 +1,14 @@
 Metadata-Version: 2.4
 Name: pyreact-framework
-Version: 1.0.1
+Version: 1.0.2
 Summary: Framework web declarativo inspirado no React, construído nativamente para Python
 Author-email: wanbnn <wanbnn@users.noreply.github.com>
 License: MIT
 Project-URL: Homepage, https://github.com/wanbnn/pyreact
-Project-URL: Documentation, https://pyreact.readthedocs.io
+Project-URL: Documentation, https://pyreact-framework.readthedocs.io
 Project-URL: Repository, https://github.com/wanbnn/pyreact
 Project-URL: Issues, https://github.com/wanbnn/pyreact/issues
+Project-URL: Changelog, https://pyreact-framework.readthedocs.io/en/latest/resources/changelog.html
 Keywords: react,ui,frontend,declarative,components,virtual-dom,web,framework
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
@@ -159,6 +160,38 @@ def MyComponent(props):
 
 ## 📖 Documentação
 
+### 📚 Documentação Completa
+
+A documentação completa está disponível no **Read the Docs**:
+
+🔗 **https://pyreact-framework.readthedocs.io/**
+
+#### Conteúdo da Documentação:
+
+- **Getting Started**
+  - Installation
+  - Quick Start
+  - Tutorial (Todo App)
+  
+- **Core Concepts**
+  - Components
+  - Props
+  - State
+  - Events
+  - Lifecycle
+  
+- **Advanced**
+  - Server-Side Rendering (SSR)
+  - Routing
+  - Styling
+  - Testing
+  
+- **API Reference**
+  - Element API
+  - Component API
+  - Hooks API
+  - CLI API
+
 ### CLI Commands
 
 ```bash

{pyreact_framework-1.0.1 → pyreact_framework-1.0.2}/pyreact_framework.egg-info/SOURCES.txt

@@ -15,7 +15,9 @@ pyreact/core/portal.py
 pyreact/core/reconciler.py
 pyreact/core/refs.py
 pyreact/core/renderer.py
+pyreact/core/router.py
 pyreact/core/scheduler.py
+pyreact/core/theme.py
 pyreact/devtools/__init__.py
 pyreact/devtools/debugger.py
 pyreact/devtools/profiler.py