python2mobile 1.0.1__tar.gz

python2mobile-1.0.1/PKG-INFO

@@ -0,0 +1,238 @@
+Metadata-Version: 2.4
+Name: python2mobile
+Version: 1.0.1
+Summary: Python to Mobile - Write mobile apps in pure Python with DSL
+Author-email: P2M Team <team@python2mobile.dev>
+License-Expression: MIT
+Keywords: mobile,python,dsl,flutter,react-native,llm,ai
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.1.0
+Requires-Dist: fastapi>=0.104.0
+Requires-Dist: uvicorn>=0.24.0
+Requires-Dist: watchdog>=3.0.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: python-dotenv>=1.0.0
+Requires-Dist: requests>=2.31.0
+Requires-Dist: openai>=1.3.0
+Requires-Dist: anthropic>=0.7.0
+Requires-Dist: toml>=0.10.0
+Requires-Dist: websockets>=12.0
+Requires-Dist: agno>=2.1.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.5.0; extra == "dev"
+
+# Python2Mobile (P2M)
+
+Write mobile apps in **pure Python** with a declarative DSL. P2M generates or runs native/hybrid apps for Android, iOS, and Web.
+
+## Features
+
+- **Python DSL** - Write UI and logic in familiar Python syntax
+- **Tailwind-like Styling** - Use CSS class names for mobile styling
+- **Hot Reload** - See changes instantly during development
+- **Multi-LLM Support** - OpenAI, Claude, Ollama, or any OpenAI-compatible API
+- **Multiple Targets** - Generate React Native or Flutter code
+- **DevServer** - Preview apps in browser before building
+
+## Quick Start
+
+```bash
+pip install python2mobile
+
+# Create a new app
+p2m new myapp
+cd myapp
+
+# Run in development mode (hot reload)
+p2m run
+
+# Build for production
+p2m build --target android
+p2m build --target ios
+p2m build --target web
+```
+
+## Example App
+
+```python
+from p2m.core import Render
+from p2m.ui import Container, Text, Button
+
+def click_button():
+    print("Button clicked!")
+
+def create_view():
+    container = Container(class_="bg-gray-100 min-h-screen flex items-center justify-center")
+    inner = Container(class_="text-center space-y-6 p-8 bg-white rounded-2xl shadow-lg")
+    
+    text = Text("Welcome to P2M", class_="text-gray-800 text-2xl font-bold")
+    button = Button(
+        "Click Me",
+        class_="bg-blue-600 text-white font-semibold py-3 px-8 rounded-xl hover:bg-blue-700",
+        on_click=click_button
+    )
+    
+    inner.add(text).add(button)
+    container.add(inner)
+    return container.build()
+
+def main():
+    Render.execute(create_view)
+
+if __name__ == "__main__":
+    main()
+```
+
+## Configuration
+
+Create a `p2m.toml` file:
+
+```toml
+[project]
+name = "MyApp"
+version = "0.1.0"
+entry = "main.py"
+
+[build]
+target = ["android", "ios", "web"]
+generator = "flutter"  # or "react-native"
+llm_provider = "openai"  # openai | anthropic | ollama | openai-compatible
+llm_model = "gpt-4o"
+output_dir = "./build"
+cache = true
+
+[devserver]
+port = 3000
+hot_reload = true
+mobile_frame = true
+
+[style]
+system = "tailwind"
+```
+
+## LLM Configuration
+
+### OpenAI
+```toml
+[llm.openai]
+api_key = "sk-..."
+model = "gpt-4o"
+```
+
+### Claude (Anthropic)
+```toml
+[llm.anthropic]
+api_key = "sk-ant-..."
+model = "claude-3-opus-20240229"
+```
+
+### Ollama (Local)
+```toml
+[llm.ollama]
+base_url = "http://localhost:11434"
+model = "llama2"
+```
+
+### OpenAI Compatible
+```toml
+[llm.custom]
+base_url = "https://api.example.com/v1"
+api_key = "your-api-key"
+model = "your-model-name"
+x_api_key = "optional-header"
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────┐
+│                   DEVELOPER                         │
+│              writes in Python P2M                   │
+└──────────────────────┬──────────────────────────────┘
+                       │
+          ┌────────────▼────────────┐
+          │      p2m CLI            │
+          │  (p2m run / p2m build)  │
+          └────────────┬────────────┘
+                       │
+         ┌─────────────┴──────────────┐
+         │                            │
+    ┌────▼────┐                 ┌─────▼──────┐
+    │ p2m run │                 │ p2m build  │
+    │ (dev)   │                 │ (prod)     │
+    └────┬────┘                 └─────┬──────┘
+         │                            │
+    ┌────▼────────────┐        ┌──────▼───────────┐
+    │ P2M Runtime     │        │  AI Code Generator│
+    │ - AST Parser    │        │  - LLM Integration│
+    │ - Safe Eval     │        │  - React Native   │
+    │ - HTML Renderer │        │  - Flutter        │
+    │ - Hot Reload    │        │  - Web            │
+    └────┬────────────┘        └──────┬───────────┘
+         │                            │
+    ┌────▼────────────┐        ┌──────▼───────────┐
+    │ Web Visualizer  │        │ /build/           │
+    │ localhost:3000  │        │  android/         │
+    │ Mobile Preview  │        │  ios/             │
+    └─────────────────┘        │  web/             │
+                               └──────────────────┘
+```
+
+## Project Structure
+
+```
+p2m/
+├── __init__.py
+├── cli.py                    # CLI entry point
+├── config.py                 # Configuration management
+├── core/
+│   ├── __init__.py
+│   ├── runtime.py           # Python runtime engine
+│   ├── ast_walker.py        # AST analysis
+│   ├── render_engine.py     # Component tree → HTML
+│   ├── hot_reload.py        # File watcher
+│   └── event_bridge.py      # JS ↔ Python bridge
+├── ui/
+│   ├── __init__.py
+│   ├── components.py        # Base components
+│   ├── layouts.py           # Layout components
+│   └── styles.py            # Style system
+├── devserver/
+│   ├── __init__.py
+│   ├── server.py            # FastAPI server
+│   ├── templates.py         # Jinja2 templates
+│   └── websocket_handler.py # WebSocket bridge
+├── llm/
+│   ├── __init__.py
+│   ├── base.py              # Base LLM interface
+│   ├── openai_provider.py   # OpenAI integration
+│   ├── anthropic_provider.py # Claude integration
+│   ├── ollama_provider.py   # Ollama integration
+│   └── factory.py           # LLM factory
+├── build/
+│   ├── __init__.py
+│   ├── generator.py         # Code generator
+│   ├── react_native.py      # React Native templates
+│   ├── flutter.py           # Flutter templates
+│   └── cache.py             # Build cache
+└── utils/
+    ├── __init__.py
+    ├── logger.py            # Logging
+    └── validators.py        # Validation
+```
+
+## License
+
+MIT

python2mobile-1.0.1/README.md

@@ -0,0 +1,203 @@
+# Python2Mobile (P2M)
+
+Write mobile apps in **pure Python** with a declarative DSL. P2M generates or runs native/hybrid apps for Android, iOS, and Web.
+
+## Features
+
+- **Python DSL** - Write UI and logic in familiar Python syntax
+- **Tailwind-like Styling** - Use CSS class names for mobile styling
+- **Hot Reload** - See changes instantly during development
+- **Multi-LLM Support** - OpenAI, Claude, Ollama, or any OpenAI-compatible API
+- **Multiple Targets** - Generate React Native or Flutter code
+- **DevServer** - Preview apps in browser before building
+
+## Quick Start
+
+```bash
+pip install python2mobile
+
+# Create a new app
+p2m new myapp
+cd myapp
+
+# Run in development mode (hot reload)
+p2m run
+
+# Build for production
+p2m build --target android
+p2m build --target ios
+p2m build --target web
+```
+
+## Example App
+
+```python
+from p2m.core import Render
+from p2m.ui import Container, Text, Button
+
+def click_button():
+    print("Button clicked!")
+
+def create_view():
+    container = Container(class_="bg-gray-100 min-h-screen flex items-center justify-center")
+    inner = Container(class_="text-center space-y-6 p-8 bg-white rounded-2xl shadow-lg")
+    
+    text = Text("Welcome to P2M", class_="text-gray-800 text-2xl font-bold")
+    button = Button(
+        "Click Me",
+        class_="bg-blue-600 text-white font-semibold py-3 px-8 rounded-xl hover:bg-blue-700",
+        on_click=click_button
+    )
+    
+    inner.add(text).add(button)
+    container.add(inner)
+    return container.build()
+
+def main():
+    Render.execute(create_view)
+
+if __name__ == "__main__":
+    main()
+```
+
+## Configuration
+
+Create a `p2m.toml` file:
+
+```toml
+[project]
+name = "MyApp"
+version = "0.1.0"
+entry = "main.py"
+
+[build]
+target = ["android", "ios", "web"]
+generator = "flutter"  # or "react-native"
+llm_provider = "openai"  # openai | anthropic | ollama | openai-compatible
+llm_model = "gpt-4o"
+output_dir = "./build"
+cache = true
+
+[devserver]
+port = 3000
+hot_reload = true
+mobile_frame = true
+
+[style]
+system = "tailwind"
+```
+
+## LLM Configuration
+
+### OpenAI
+```toml
+[llm.openai]
+api_key = "sk-..."
+model = "gpt-4o"
+```
+
+### Claude (Anthropic)
+```toml
+[llm.anthropic]
+api_key = "sk-ant-..."
+model = "claude-3-opus-20240229"
+```
+
+### Ollama (Local)
+```toml
+[llm.ollama]
+base_url = "http://localhost:11434"
+model = "llama2"
+```
+
+### OpenAI Compatible
+```toml
+[llm.custom]
+base_url = "https://api.example.com/v1"
+api_key = "your-api-key"
+model = "your-model-name"
+x_api_key = "optional-header"
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────┐
+│                   DEVELOPER                         │
+│              writes in Python P2M                   │
+└──────────────────────┬──────────────────────────────┘
+                       │
+          ┌────────────▼────────────┐
+          │      p2m CLI            │
+          │  (p2m run / p2m build)  │
+          └────────────┬────────────┘
+                       │
+         ┌─────────────┴──────────────┐
+         │                            │
+    ┌────▼────┐                 ┌─────▼──────┐
+    │ p2m run │                 │ p2m build  │
+    │ (dev)   │                 │ (prod)     │
+    └────┬────┘                 └─────┬──────┘
+         │                            │
+    ┌────▼────────────┐        ┌──────▼───────────┐
+    │ P2M Runtime     │        │  AI Code Generator│
+    │ - AST Parser    │        │  - LLM Integration│
+    │ - Safe Eval     │        │  - React Native   │
+    │ - HTML Renderer │        │  - Flutter        │
+    │ - Hot Reload    │        │  - Web            │
+    └────┬────────────┘        └──────┬───────────┘
+         │                            │
+    ┌────▼────────────┐        ┌──────▼───────────┐
+    │ Web Visualizer  │        │ /build/           │
+    │ localhost:3000  │        │  android/         │
+    │ Mobile Preview  │        │  ios/             │
+    └─────────────────┘        │  web/             │
+                               └──────────────────┘
+```
+
+## Project Structure
+
+```
+p2m/
+├── __init__.py
+├── cli.py                    # CLI entry point
+├── config.py                 # Configuration management
+├── core/
+│   ├── __init__.py
+│   ├── runtime.py           # Python runtime engine
+│   ├── ast_walker.py        # AST analysis
+│   ├── render_engine.py     # Component tree → HTML
+│   ├── hot_reload.py        # File watcher
+│   └── event_bridge.py      # JS ↔ Python bridge
+├── ui/
+│   ├── __init__.py
+│   ├── components.py        # Base components
+│   ├── layouts.py           # Layout components
+│   └── styles.py            # Style system
+├── devserver/
+│   ├── __init__.py
+│   ├── server.py            # FastAPI server
+│   ├── templates.py         # Jinja2 templates
+│   └── websocket_handler.py # WebSocket bridge
+├── llm/
+│   ├── __init__.py
+│   ├── base.py              # Base LLM interface
+│   ├── openai_provider.py   # OpenAI integration
+│   ├── anthropic_provider.py # Claude integration
+│   ├── ollama_provider.py   # Ollama integration
+│   └── factory.py           # LLM factory
+├── build/
+│   ├── __init__.py
+│   ├── generator.py         # Code generator
+│   ├── react_native.py      # React Native templates
+│   ├── flutter.py           # Flutter templates
+│   └── cache.py             # Build cache
+└── utils/
+    ├── __init__.py
+    ├── logger.py            # Logging
+    └── validators.py        # Validation
+```
+
+## License
+
+MIT

python2mobile-1.0.1/examples/example_ecommerce_app.py

@@ -0,0 +1,189 @@
+"""
+Example: E-commerce App - Real-world P2M application
+"""
+
+from p2m.core import Render
+from p2m.ui import Container, Text, Button, Input, Image, Row, Column, Card, Badge
+
+
+# Mock product data
+products = [
+    {
+        "id": 1,
+        "name": "Wireless Headphones",
+        "price": 79.99,
+        "rating": 4.5,
+        "image": "https://via.placeholder.com/200x200?text=Headphones",
+        "in_stock": True,
+    },
+    {
+        "id": 2,
+        "name": "Smart Watch",
+        "price": 199.99,
+        "rating": 4.8,
+        "image": "https://via.placeholder.com/200x200?text=SmartWatch",
+        "in_stock": True,
+    },
+    {
+        "id": 3,
+        "name": "USB-C Cable",
+        "price": 12.99,
+        "rating": 4.2,
+        "image": "https://via.placeholder.com/200x200?text=Cable",
+        "in_stock": False,
+    },
+]
+
+# Shopping cart
+cart = []
+
+
+def add_to_cart(product_id: int):
+    """Add product to cart"""
+    product = next((p for p in products if p["id"] == product_id), None)
+    if product:
+        cart.append(product)
+        print(f"Added {product['name']} to cart")
+
+
+def remove_from_cart(product_id: int):
+    """Remove product from cart"""
+    global cart
+    cart = [p for p in cart if p["id"] != product_id]
+    print(f"Removed product {product_id} from cart")
+
+
+def render_product_card(product: dict):
+    """Render a product card"""
+    card = Card(class_="bg-white rounded-lg shadow-md overflow-hidden hover:shadow-lg transition-shadow")
+    
+    # Product image
+    image = Image(
+        src=product["image"],
+        alt=product["name"],
+        class_="w-full h-48 object-cover"
+    )
+    card.add(image)
+    
+    # Product info
+    info = Container(class_="p-4")
+    
+    # Name
+    name = Text(product["name"], class_="text-lg font-semibold text-gray-800 mb-2")
+    info.add(name)
+    
+    # Rating and price row
+    rating_price = Row(class_="flex justify-between items-center mb-3")
+    
+    rating = Badge(
+        label=f"⭐ {product['rating']}",
+        class_="bg-yellow-100 text-yellow-800 px-2 py-1 rounded text-sm"
+    )
+    rating_price.add(rating)
+    
+    price = Text(f"${product['price']}", class_="text-xl font-bold text-blue-600")
+    rating_price.add(price)
+    
+    info.add(rating_price)
+    
+    # Stock status
+    stock_class = "bg-green-100 text-green-800" if product["in_stock"] else "bg-red-100 text-red-800"
+    stock_text = "In Stock" if product["in_stock"] else "Out of Stock"
+    stock = Badge(
+        label=stock_text,
+        class_=f"{stock_class} px-2 py-1 rounded text-xs font-semibold"
+    )
+    info.add(stock)
+    
+    # Add to cart button
+    btn_class = "bg-blue-600 hover:bg-blue-700 text-white" if product["in_stock"] else "bg-gray-400 text-gray-600 cursor-not-allowed"
+    add_btn = Button(
+        "Add to Cart",
+        class_=f"{btn_class} w-full mt-4 px-4 py-2 rounded font-semibold",
+        on_click=lambda: add_to_cart(product["id"]) if product["in_stock"] else None
+    )
+    info.add(add_btn)
+    
+    card.add(info)
+    return card
+
+
+def create_view():
+    """Create the e-commerce app view"""
+    
+    # Main container
+    main = Container(class_="bg-gray-50 min-h-screen")
+    
+    # Header
+    header = Container(class_="bg-blue-600 text-white p-4 shadow-md")
+    
+    title = Text("TechStore", class_="text-2xl font-bold mb-2")
+    header.add(title)
+    
+    subtitle = Text("Your favorite tech products", class_="text-blue-100")
+    header.add(subtitle)
+    
+    main.add(header)
+    
+    # Search bar
+    search_section = Container(class_="bg-white p-4 border-b border-gray-200")
+    search_input = Input(
+        placeholder="Search products...",
+        class_="w-full px-4 py-2 border border-gray-300 rounded-lg focus:outline-none focus:ring-2 focus:ring-blue-500"
+    )
+    search_section.add(search_input)
+    main.add(search_section)
+    
+    # Products section
+    products_section = Container(class_="p-4")
+    
+    section_title = Text("Featured Products", class_="text-xl font-bold text-gray-800 mb-4")
+    products_section.add(section_title)
+    
+    # Products grid
+    products_grid = Container(class_="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4")
+    
+    for product in products:
+        product_card = render_product_card(product)
+        products_grid.add(product_card)
+    
+    products_section.add(products_grid)
+    main.add(products_section)
+    
+    # Cart summary
+    cart_section = Container(class_="bg-white p-4 border-t border-gray-200 sticky bottom-0")
+    
+    cart_row = Row(class_="flex justify-between items-center")
+    
+    cart_info = Column()
+    cart_label = Text("Shopping Cart", class_="font-semibold text-gray-800")
+    cart_info.add(cart_label)
+    
+    cart_count = Text(
+        f"{len(cart)} items • ${sum(p['price'] for p in cart):.2f}",
+        class_="text-sm text-gray-600"
+    )
+    cart_info.add(cart_count)
+    
+    cart_row.add(cart_info)
+    
+    checkout_btn = Button(
+        "Checkout",
+        class_="bg-green-600 hover:bg-green-700 text-white px-6 py-2 rounded font-semibold",
+        on_click=lambda: print("Checkout clicked")
+    )
+    cart_row.add(checkout_btn)
+    
+    cart_section.add(cart_row)
+    main.add(cart_section)
+    
+    return main.build()
+
+
+def main():
+    """Main entry point"""
+    Render.execute(create_view)
+
+
+if __name__ == "__main__":
+    main()