nextpy-framework 1.0.0__py3-none-any.whl

nextpy/components/link.py

@@ -0,0 +1,132 @@
+"""
+NextPy Link Component - Client-side navigation with prefetching
+Similar to Next.js's next/link with HTMX integration
+"""
+
+from typing import Any, Optional
+from markupsafe import Markup
+
+
+class Link:
+    """
+    Link component for client-side navigation
+    Uses HTMX for SPA-like navigation without full page reloads
+    
+    Usage in templates:
+        {{ Link("/about", "About Us", prefetch=True) }}
+        {{ Link("/blog/" + post.slug, post.title, class_="text-blue-500") }}
+    
+    In Python:
+        link = Link("/about", "About")
+        print(link.render())
+    """
+    
+    def __init__(
+        self,
+        href: str,
+        text: Optional[str] = None,
+        prefetch: bool = True,
+        replace: bool = False,
+        scroll: bool = True,
+        class_: Optional[str] = None,
+        target: Optional[str] = None,
+        use_htmx: bool = True,
+        **kwargs: Any,
+    ):
+        self.href = href
+        self.text = text
+        self.prefetch = prefetch
+        self.replace = replace
+        self.scroll = scroll
+        self.class_ = class_
+        self.target = target
+        self.use_htmx = use_htmx
+        self.extra_attrs = kwargs
+        
+    def render(self, children: Optional[str] = None) -> str:
+        """Render the link as an HTML anchor tag"""
+        content = children or self.text or self.href
+        
+        attrs = [f'href="{self._escape(self.href)}"']
+        
+        if self.class_:
+            attrs.append(f'class="{self._escape(self.class_)}"')
+            
+        if self.target:
+            attrs.append(f'target="{self._escape(self.target)}"')
+            
+        if self.use_htmx and not self.target:
+            attrs.append(f'hx-get="{self._escape(self.href)}"')
+            attrs.append('hx-target="#main-content"')
+            attrs.append('hx-swap="innerHTML"')
+            attrs.append('hx-push-url="true"')
+            
+            if self.prefetch:
+                attrs.append('hx-trigger="mouseenter, click"')
+                attrs.append('preload="true"')
+                
+        elif self.prefetch:
+            attrs.append('data-prefetch="true"')
+            
+        if self.replace:
+            attrs.append('data-replace="true"')
+            
+        if not self.scroll:
+            attrs.append('data-scroll="false"')
+            
+        for key, value in self.extra_attrs.items():
+            attr_name = key.replace("_", "-")
+            if value is True:
+                attrs.append(attr_name)
+            elif value is not False and value is not None:
+                attrs.append(f'{attr_name}="{self._escape(str(value))}"')
+                
+        attrs_str = " ".join(attrs)
+        return f"<a {attrs_str}>{content}</a>"
+        
+    def __html__(self) -> str:
+        """Make the component work with Jinja2's autoescape"""
+        return self.render()
+        
+    def __str__(self) -> str:
+        return self.render()
+        
+    def __call__(
+        self, 
+        href: Optional[str] = None, 
+        text: Optional[str] = None,
+        **kwargs: Any
+    ) -> Markup:
+        """Allow calling Link() in templates with arguments"""
+        if href:
+            self.href = href
+        if text:
+            self.text = text
+        for key, value in kwargs.items():
+            if hasattr(self, key):
+                setattr(self, key, value)
+            else:
+                self.extra_attrs[key] = value
+        return Markup(self.render())
+        
+    @staticmethod
+    def _escape(value: str) -> str:
+        """Escape HTML special characters"""
+        return (
+            str(value)
+            .replace("&", "&amp;")
+            .replace("<", "&lt;")
+            .replace(">", "&gt;")
+            .replace('"', "&quot;")
+            .replace("'", "&#x27;")
+        )
+
+
+def link(href: str, text: Optional[str] = None, **kwargs: Any) -> Markup:
+    """
+    Functional helper to create a Link
+    
+    Usage in templates:
+        {{ link("/about", "About Us") }}
+    """
+    return Markup(Link(href, text, **kwargs).render())

nextpy/components/loader.py

@@ -0,0 +1,65 @@
+"""
+Loader/Spinner Components
+Various loading indicators
+"""
+
+
+def spinner(size: str = "md", color: str = "blue") -> str:
+    """Generate spinner HTML"""
+    sizes = {"sm": "w-4 h-4", "md": "w-8 h-8", "lg": "w-12 h-12"}
+    colors = {
+        "blue": "border-blue-500",
+        "red": "border-red-500",
+        "green": "border-green-500",
+        "purple": "border-purple-500"
+    }
+    
+    return f'''
+    <div class="flex justify-center">
+        <div class="{sizes.get(size, sizes['md'])} border-4 border-gray-200 {colors.get(color, colors['blue'])} border-t-transparent rounded-full animate-spin"></div>
+    </div>
+    '''
+
+
+def skeleton(lines: int = 3, width: str = "full") -> str:
+    """Generate skeleton loader (content placeholder)"""
+    skeleton_lines = "\n".join([
+        f'<div class="h-4 bg-gray-200 rounded mb-2 animate-pulse"></div>'
+        for _ in range(lines)
+    ])
+    
+    return f'''
+    <div class="w-{width}">
+        {skeleton_lines}
+    </div>
+    '''
+
+
+def progress_bar(value: int = 50, max_value: int = 100, color: str = "blue") -> str:
+    """Generate progress bar"""
+    percentage = (value / max_value) * 100
+    colors = {
+        "blue": "bg-blue-500",
+        "red": "bg-red-500",
+        "green": "bg-green-500",
+        "purple": "bg-purple-500"
+    }
+    
+    return f'''
+    <div class="w-full bg-gray-200 rounded-full h-2">
+        <div class="{colors.get(color, colors['blue'])} h-2 rounded-full" style="width: {percentage}%"></div>
+    </div>
+    <p class="text-sm text-gray-600 mt-1">{value}/{max_value}</p>
+    '''
+
+
+def loading_screen(message: str = "Loading...") -> str:
+    """Full screen loading overlay"""
+    return f'''
+    <div class="fixed inset-0 bg-white bg-opacity-90 flex items-center justify-center z-50">
+        <div class="text-center">
+            <div class="w-12 h-12 border-4 border-gray-200 border-t-blue-500 rounded-full animate-spin mx-auto mb-4"></div>
+            <p class="text-lg text-gray-700">{message}</p>
+        </div>
+    </div>
+    '''

nextpy/components/toast.py

@@ -0,0 +1,101 @@
+"""
+Toast Notification Component
+Display temporary alerts/notifications
+"""
+
+from typing import Literal
+
+
+class Toast:
+    """Toast notification system"""
+    
+    def __init__(self):
+        self.toasts = []
+    
+    def add(self, message: str, type: Literal["success", "error", "info", "warning"] = "info", duration: int = 3000):
+        """Add a toast notification"""
+        toast_id = len(self.toasts)
+        self.toasts.append({
+            "id": toast_id,
+            "message": message,
+            "type": type,
+            "duration": duration
+        })
+        return toast_id
+    
+    def remove(self, toast_id: int):
+        """Remove a toast"""
+        self.toasts = [t for t in self.toasts if t["id"] != toast_id]
+    
+    def clear_all(self):
+        """Clear all toasts"""
+        self.toasts = []
+
+
+def toast_html() -> str:
+    """Generate toast container HTML"""
+    return '''
+    <div id="toast-container" class="fixed top-4 right-4 z-50 space-y-2" hx-ext="sse" sse-connect="/api/toasts">
+        <div hx-target="#toast-container" hx-swap="beforeend"></div>
+    </div>
+    
+    <style>
+        .toast {
+            animation: slideInRight 0.3s ease-out, slideOutRight 0.3s ease-in 3s forwards;
+            padding: 16px;
+            border-radius: 8px;
+            box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
+            font-weight: 500;
+        }
+        
+        .toast.success {
+            background-color: #10b981;
+            color: white;
+        }
+        
+        .toast.error {
+            background-color: #ef4444;
+            color: white;
+        }
+        
+        .toast.info {
+            background-color: #3b82f6;
+            color: white;
+        }
+        
+        .toast.warning {
+            background-color: #f59e0b;
+            color: white;
+        }
+        
+        @keyframes slideInRight {
+            from {
+                transform: translateX(400px);
+                opacity: 0;
+            }
+            to {
+                transform: translateX(0);
+                opacity: 1;
+            }
+        }
+        
+        @keyframes slideOutRight {
+            from {
+                transform: translateX(0);
+                opacity: 1;
+            }
+            to {
+                transform: translateX(400px);
+                opacity: 0;
+            }
+        }
+    </style>
+    '''
+
+
+# Global toast instance
+_toast = Toast()
+
+def get_toast() -> Toast:
+    """Get global toast instance"""
+    return _toast

nextpy/components/visual.py

@@ -0,0 +1,185 @@
+"""
+Visual Components for NextPy
+Tabs, Accordion, Dropdown, Modal, Card variations
+"""
+
+
+def Tabs(tabs: list, active_index: int = 0) -> str:
+    """
+    Tabs component
+    tabs: [{"label": "Tab 1", "content": "<p>Content 1</p>"}, ...]
+    """
+    tab_buttons_list = []
+    for i, tab in enumerate(tabs):
+        active_class = "border-blue-600 text-blue-600 font-bold" if i == active_index else "border-gray-300 text-gray-600"
+        tab_buttons_list.append(f'<button class="px-4 py-2 border-b-2 {active_class}" onclick="switchTab({i})">\n            {tab["label"]}\n        </button>')
+    tab_buttons = "\n".join(tab_buttons_list)
+    
+    tab_contents_list = []
+    for i, tab in enumerate(tabs):
+        display_class = "block" if i == active_index else "hidden"
+        tab_contents_list.append(f'<div id="tab-content-{i}" class="{display_class} py-4">\n            {tab["content"]}\n        </div>')
+    tab_contents = "\n".join(tab_contents_list)
+    
+    return f'''
+    <div class="space-y-4">
+        <div class="flex border-b border-gray-200">
+            {tab_buttons}
+        </div>
+        <div>
+            {tab_contents}
+        </div>
+    </div>
+    <script>
+        function switchTab(index) {{
+            document.querySelectorAll('[id^="tab-content-"]').forEach(el => el.classList.add('hidden'));
+            document.getElementById('tab-content-' + index).classList.remove('hidden');
+            document.querySelectorAll('button').forEach((btn, i) => {{
+                btn.classList.toggle('border-blue-600', i === index);
+                btn.classList.toggle('text-blue-600', i === index);
+                btn.classList.toggle('font-bold', i === index);
+                btn.classList.toggle('border-gray-300', i !== index);
+                btn.classList.toggle('text-gray-600', i !== index);
+            }});
+        }}
+    </script>
+    '''
+
+
+def Accordion(items: list) -> str:
+    """
+    Accordion component
+    items: [{"title": "Section 1", "content": "<p>Content 1</p>"}, ...]
+    """
+    accordion_items = []
+    for i, item in enumerate(items):
+        accordion_items.append(f'''
+        <div class="border border-gray-300 mb-2 rounded-lg overflow-hidden">
+            <button onclick="toggleAccordion({i})" class="w-full text-left px-4 py-3 bg-gray-100 hover:bg-gray-200 font-semibold flex justify-between items-center">
+                {item["title"]}
+                <span id="accordion-icon-{i}">▼</span>
+            </button>
+            <div id="accordion-content-{i}" class="hidden px-4 py-3 bg-white text-gray-700">
+                {item["content"]}
+            </div>
+        </div>
+        ''')
+    accordion_html = "\n".join(accordion_items)
+    
+    return f'''
+    <div class="space-y-2">
+        {accordion_html}
+    </div>
+    <script>
+        function toggleAccordion(index) {{
+            const content = document.getElementById('accordion-content-' + index);
+            const icon = document.getElementById('accordion-icon-' + index);
+            content.classList.toggle('hidden');
+            icon.textContent = content.classList.contains('hidden') ? '▼' : '▲';
+        }}
+    </script>
+    '''
+
+
+def Dropdown(label: str, items: list, position: str = "left") -> str:
+    """
+    Dropdown component
+    items: [{"label": "Option 1", "href": "/path"}, ...]
+    """
+    position_class = "right-0" if position == "right" else "left-0"
+    items_html = "\n".join([
+        f'<a href="{item.get("href", "#")}" class="block px-4 py-2 text-gray-700 hover:bg-gray-100">{item["label"]}</a>'
+        for item in items
+    ])
+    
+    return f'''
+    <div class="relative inline-block">
+        <button onclick="toggleDropdown()" class="px-4 py-2 bg-blue-600 text-white rounded-lg hover:bg-blue-700">
+            {label}
+        </button>
+        <div id="dropdown-menu" class="hidden absolute {position_class} mt-2 bg-white border border-gray-300 rounded-lg shadow-lg z-10">
+            {items_html}
+        </div>
+    </div>
+    <script>
+        function toggleDropdown() {{
+            const menu = document.getElementById('dropdown-menu');
+            menu.classList.toggle('hidden');
+        }}
+        document.addEventListener('click', function(event) {{
+            const menu = document.getElementById('dropdown-menu');
+            if (!menu.parentElement.contains(event.target)) menu.classList.add('hidden');
+        }});
+    </script>
+    '''
+
+
+def Modal(title: str, content: str, footer: str = "", show: bool = False) -> str:
+    """Modal component"""
+    display = "flex" if show else "hidden"
+    footer_html = f'<div class="px-6 py-4 border-t border-gray-200 flex justify-end gap-2">{footer}</div>' if footer else ''
+    return f'''
+    <div id="modal-overlay" class="{display} fixed inset-0 bg-black bg-opacity-50 justify-center items-center z-50">
+        <div class="bg-white rounded-lg shadow-xl max-w-md w-full mx-4">
+            <div class="px-6 py-4 border-b border-gray-200 flex justify-between items-center">
+                <h2 class="text-xl font-bold">{title}</h2>
+                <button onclick="closeModal()" class="text-gray-500 hover:text-gray-700 text-2xl">&times;</button>
+            </div>
+            <div class="px-6 py-4">
+                {content}
+            </div>
+            {footer_html}
+        </div>
+    </div>
+    <script>
+        function openModal() {{
+            document.getElementById('modal-overlay').classList.remove('hidden');
+            document.getElementById('modal-overlay').classList.add('flex');
+        }}
+        function closeModal() {{
+            document.getElementById('modal-overlay').classList.add('hidden');
+            document.getElementById('modal-overlay').classList.remove('flex');
+        }}
+    </script>
+    '''
+
+
+def Card(title: str, content: str, image: str = "", footer: str = "") -> str:
+    """Enhanced Card component"""
+    image_html = f'<img src="{image}" class="w-full h-48 object-cover rounded-t-lg"/>' if image else ""
+    footer_html = f'<div class="px-6 py-3 bg-gray-50 border-t border-gray-200 text-sm text-gray-600">{footer}</div>' if footer else ""
+    
+    return f'''
+    <div class="bg-white rounded-lg shadow-md overflow-hidden hover:shadow-lg transition">
+        {image_html}
+        <div class="px-6 py-4">
+            <h3 class="font-bold text-lg mb-2">{title}</h3>
+            <p class="text-gray-600">{content}</p>
+        </div>
+        {footer_html}
+    </div>
+    '''
+
+
+def Breadcrumb(items: list) -> str:
+    """Breadcrumb navigation"""
+    breadcrumb_parts = []
+    for item in items:
+        if item.get("href"):
+            breadcrumb_parts.append(f'<a href="{item.get("href")}" class="text-blue-600 hover:underline">{item["label"]}</a>')
+        else:
+            breadcrumb_parts.append(f'<span class="text-gray-700">{item["label"]}</span>')
+    breadcrumb_html = " / ".join(breadcrumb_parts)
+    return f'<nav class="text-sm text-gray-600 mb-4">{breadcrumb_html}</nav>'
+
+
+def Pagination(current: int = 1, total: int = 10, base_url: str = "") -> str:
+    """Pagination component"""
+    pages = []
+    for i in range(1, total + 1):
+        if i == current:
+            pages.append(f'<span class="px-3 py-1 bg-blue-600 text-white rounded">{i}</span>')
+        else:
+            pages.append(f'<a href="{base_url}?page={i}" class="px-3 py-1 border border-gray-300 rounded hover:bg-gray-100">{i}</a>')
+    
+    return f'<div class="flex gap-2">{" ".join(pages)}</div>'

nextpy/config.py

@@ -0,0 +1,75 @@
+"""
+NextPy Configuration Manager
+Environment variables, settings, and configuration
+"""
+
+import os
+from typing import Optional, Any
+from dotenv import load_dotenv
+from pydantic_settings import BaseSettings
+
+# Load .env file
+load_dotenv()
+
+
+class Settings(BaseSettings):
+    """Application settings from environment variables"""
+    
+    # App
+    app_name: str = "NextPy App"
+    debug: bool = os.getenv("DEBUG", "true").lower() == "true"
+    secret_key: str = os.getenv("SECRET_KEY", "change-me-in-production")
+    domain: str = os.getenv("DOMAIN", "localhost:5000")
+    
+    # Database
+    database_url: str = os.getenv("DATABASE_URL", "sqlite:///./nextpy.db")
+    db_echo: bool = os.getenv("DB_ECHO", "false").lower() == "true"
+    
+    # Auth
+    jwt_secret: str = os.getenv("JWT_SECRET", "change-me")
+    jwt_algorithm: str = "HS256"
+    jwt_expiration_hours: int = 24
+    session_secret: str = os.getenv("SESSION_SECRET", "change-me")
+    
+    # Email
+    mail_server: str = os.getenv("MAIL_SERVER", "smtp.gmail.com")
+    mail_port: int = int(os.getenv("MAIL_PORT", "587"))
+    mail_username: str = os.getenv("MAIL_USERNAME", "")
+    mail_password: str = os.getenv("MAIL_PASSWORD", "")
+    
+    # API Keys
+    api_key: Optional[str] = os.getenv("API_KEY")
+    stripe_key: Optional[str] = os.getenv("STRIPE_KEY")
+    openai_api_key: Optional[str] = os.getenv("OPENAI_API_KEY")
+    
+    # URLs
+    frontend_url: str = os.getenv("FRONTEND_URL", "http://localhost:5000")
+    backend_url: str = os.getenv("BACKEND_URL", "http://localhost:5000")
+    
+    class Config:
+        env_file = ".env"
+        case_sensitive = False
+
+
+# Global settings instance
+settings = Settings()
+
+
+def get_setting(key: str, default: Any = None) -> Any:
+    """Get setting by key"""
+    return getattr(settings, key, default)
+
+
+def get_env(key: str, default: Any = None) -> Any:
+    """Get environment variable"""
+    return os.getenv(key, default)
+
+
+def is_production() -> bool:
+    """Check if running in production"""
+    return not settings.debug
+
+
+def is_development() -> bool:
+    """Check if running in development"""
+    return settings.debug

nextpy/core/__init__.py

@@ -0,0 +1,21 @@
+"""NextPy Core Module - Routing, Rendering, and Data Fetching"""
+
+from nextpy.core.router import Router, Route, DynamicRoute
+from nextpy.core.renderer import Renderer
+from nextpy.core.data_fetching import (
+    get_server_side_props,
+    get_static_props,
+    get_static_paths,
+)
+from nextpy.core.builder import Builder
+
+__all__ = [
+    "Router",
+    "Route",
+    "DynamicRoute", 
+    "Renderer",
+    "get_server_side_props",
+    "get_static_props",
+    "get_static_paths",
+    "Builder",
+]