fymo 0.1.0__tar.gz

fymo-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+virtualenv/
+.idea/
+__pycache__/
+node_modules/
+dist/
+!fymo/bundler/js/dist/
+venv/
+.venv/
+.worktrees/
+.fymo/
+.playwright-mcp/
+*.egg-info/
+build/

fymo-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bishwas Bhandari and Fymo contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fymo-0.1.0/PKG-INFO

@@ -0,0 +1,181 @@
+Metadata-Version: 2.4
+Name: fymo
+Version: 0.1.0
+Summary: Python SSR framework for Svelte 5 — esbuild pipeline, Node sidecar, SvelteKit-style remote functions
+Project-URL: Homepage, https://github.com/Bishwas-py/fymo
+Project-URL: Repository, https://github.com/Bishwas-py/fymo
+Project-URL: Issues, https://github.com/Bishwas-py/fymo/issues
+Author-email: Bishwas Bhandari <bishwasbh@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: esbuild,framework,python,ssr,svelte,wsgi
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP :: WSGI :: Application
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.11
+Requires-Dist: click>=8.0.0
+Requires-Dist: gunicorn>=23.0.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: pydantic
+Requires-Dist: pydantic>=2.5; extra == 'pydantic'
+Description-Content-Type: text/markdown
+
+# Fymo Framework
+
+<div align="center">
+  <h3>Production-ready Python SSR Framework for Svelte 5</h3>
+  <p>Build modern web applications with Python backend and Svelte 5 frontend</p>
+</div>
+
+## Features
+
+- **Build-time esbuild pipeline** — components compiled to hashed `dist/client/*.js` once, served as cacheable static assets.
+- **Cross-route shared chunks** — packages imported by multiple pages (e.g. `date-fns`) are bundled once and shared.
+- **Persistent Node sidecar SSR** — Python WSGI app talks to a long-lived Node process over stdio JSON; the sidecar imports prebuilt SSR modules and renders per request in microseconds.
+- **Minimal HTML response** — typical page is < 10 KB; bundles loaded via `<link rel="modulepreload">` + `<script type="module" src=...>`.
+- **`fymo dev` watcher** — incremental rebuilds on save with SSE-driven browser reload.
+- **Any npm library** — Node SSR has full Node API surface (`fs`, `fetch`, `Buffer`, streams).
+- **Svelte 5 runes** — full `$state`, `$derived`, `$effect`, `$props` support.
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install fymo
+```
+
+### Create a New Project
+
+```bash
+fymo new my-app
+cd my-app
+```
+
+### Install Dependencies
+
+```bash
+pip install -r requirements.txt
+npm install
+```
+
+### Build and Serve
+
+```bash
+fymo build      # produces dist/ with hashed JS/CSS bundles
+fymo serve      # production-style WSGI server
+
+# or, for development:
+fymo dev        # incremental rebuild + browser auto-reload
+```
+
+Visit `http://127.0.0.1:8000`.
+
+## Project Structure
+
+```
+my-app/
+├── app/
+│   ├── controllers/     # Python controllers
+│   ├── templates/       # Svelte components
+│   ├── models/         # Data models
+│   └── static/         # Static assets
+├── dist/               # Built output (generated by fymo build)
+├── config/             # Configuration
+├── fymo.yml           # Project configuration
+├── server.py          # Entry point
+└── requirements.txt   # Python dependencies
+```
+
+## Example Component
+
+```svelte
+<!-- app/templates/home/index.svelte -->
+<script>
+  let { title, message } = $props();
+  let count = $state(0);
+  
+  function increment() {
+    count++;
+  }
+</script>
+
+<div>
+  <h1>{title}</h1>
+  <p>{message}</p>
+  <button onclick={increment}>
+    Count: {count}
+  </button>
+</div>
+```
+
+```python
+# app/controllers/home.py
+def getContext():
+    return {
+        'title': 'Welcome to Fymo',
+        'message': 'Build amazing apps with Python and Svelte 5!'
+    }
+```
+
+## CLI Commands
+
+- `fymo new <project>` — Create a new project
+- `fymo build` — Build for production (produces `dist/`)
+- `fymo serve` — Serve a built project
+- `fymo dev` — Dev server with file watcher and live reload
+- `fymo generate <type> <name>` — Generate components/controllers
+
+## Configuration
+
+Configure your project in `fymo.yml`:
+
+```yaml
+name: my-app
+version: 1.0.0
+
+routes:
+  root: home.index
+  resources:
+    - posts
+    - users
+
+server:
+  host: 127.0.0.1
+  port: 8000
+  reload: true
+```
+
+## Architecture
+
+Fymo combines:
+- **Python** for server-side logic and routing (WSGI)
+- **Svelte 5** for reactive UI components
+- **esbuild** for fast, incremental JS/CSS bundling at build time
+- **Node.js sidecar** for server-side rendering via stdio JSON protocol
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Acknowledgments
+
+- Built with [Svelte 5](https://svelte.dev)
+- Bundled with [esbuild](https://esbuild.github.io)
+- Inspired by modern web frameworks
+
+---
+
+<div align="center">
+  <strong>Built with love by the Fymo Team</strong>
+</div>

fymo-0.1.0/README.md

@@ -0,0 +1,153 @@
+# Fymo Framework
+
+<div align="center">
+  <h3>Production-ready Python SSR Framework for Svelte 5</h3>
+  <p>Build modern web applications with Python backend and Svelte 5 frontend</p>
+</div>
+
+## Features
+
+- **Build-time esbuild pipeline** — components compiled to hashed `dist/client/*.js` once, served as cacheable static assets.
+- **Cross-route shared chunks** — packages imported by multiple pages (e.g. `date-fns`) are bundled once and shared.
+- **Persistent Node sidecar SSR** — Python WSGI app talks to a long-lived Node process over stdio JSON; the sidecar imports prebuilt SSR modules and renders per request in microseconds.
+- **Minimal HTML response** — typical page is < 10 KB; bundles loaded via `<link rel="modulepreload">` + `<script type="module" src=...>`.
+- **`fymo dev` watcher** — incremental rebuilds on save with SSE-driven browser reload.
+- **Any npm library** — Node SSR has full Node API surface (`fs`, `fetch`, `Buffer`, streams).
+- **Svelte 5 runes** — full `$state`, `$derived`, `$effect`, `$props` support.
+
+## Quick Start
+
+### Installation
+
+```bash
+pip install fymo
+```
+
+### Create a New Project
+
+```bash
+fymo new my-app
+cd my-app
+```
+
+### Install Dependencies
+
+```bash
+pip install -r requirements.txt
+npm install
+```
+
+### Build and Serve
+
+```bash
+fymo build      # produces dist/ with hashed JS/CSS bundles
+fymo serve      # production-style WSGI server
+
+# or, for development:
+fymo dev        # incremental rebuild + browser auto-reload
+```
+
+Visit `http://127.0.0.1:8000`.
+
+## Project Structure
+
+```
+my-app/
+├── app/
+│   ├── controllers/     # Python controllers
+│   ├── templates/       # Svelte components
+│   ├── models/         # Data models
+│   └── static/         # Static assets
+├── dist/               # Built output (generated by fymo build)
+├── config/             # Configuration
+├── fymo.yml           # Project configuration
+├── server.py          # Entry point
+└── requirements.txt   # Python dependencies
+```
+
+## Example Component
+
+```svelte
+<!-- app/templates/home/index.svelte -->
+<script>
+  let { title, message } = $props();
+  let count = $state(0);
+  
+  function increment() {
+    count++;
+  }
+</script>
+
+<div>
+  <h1>{title}</h1>
+  <p>{message}</p>
+  <button onclick={increment}>
+    Count: {count}
+  </button>
+</div>
+```
+
+```python
+# app/controllers/home.py
+def getContext():
+    return {
+        'title': 'Welcome to Fymo',
+        'message': 'Build amazing apps with Python and Svelte 5!'
+    }
+```
+
+## CLI Commands
+
+- `fymo new <project>` — Create a new project
+- `fymo build` — Build for production (produces `dist/`)
+- `fymo serve` — Serve a built project
+- `fymo dev` — Dev server with file watcher and live reload
+- `fymo generate <type> <name>` — Generate components/controllers
+
+## Configuration
+
+Configure your project in `fymo.yml`:
+
+```yaml
+name: my-app
+version: 1.0.0
+
+routes:
+  root: home.index
+  resources:
+    - posts
+    - users
+
+server:
+  host: 127.0.0.1
+  port: 8000
+  reload: true
+```
+
+## Architecture
+
+Fymo combines:
+- **Python** for server-side logic and routing (WSGI)
+- **Svelte 5** for reactive UI components
+- **esbuild** for fast, incremental JS/CSS bundling at build time
+- **Node.js sidecar** for server-side rendering via stdio JSON protocol
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see LICENSE file for details
+
+## Acknowledgments
+
+- Built with [Svelte 5](https://svelte.dev)
+- Bundled with [esbuild](https://esbuild.github.io)
+- Inspired by modern web frameworks
+
+---
+
+<div align="center">
+  <strong>Built with love by the Fymo Team</strong>
+</div>

fymo-0.1.0/examples/todo_app/README.md

@@ -0,0 +1,135 @@
+# Todo App - Fymo Example
+
+A fully functional todo application built with Fymo framework, demonstrating Python SSR with Svelte 5.
+
+## Features
+
+- Add, complete, and delete todos
+- Filter todos (All, Active, Completed)
+- Server-side rendering with Python
+- Client-side reactivity with Svelte 5 runes
+- Beautiful UI inspired by TodoMVC
+
+## Tech Stack
+
+- **Backend**: Python with Fymo framework
+- **Frontend**: Svelte 5 with runes (`$state`, `$derived`)
+- **SSR**: Persistent Node sidecar over stdio JSON
+- **Bundler**: esbuild (hashed JS/CSS bundles in `dist/`)
+
+## Quick Start
+
+### 1. Install Dependencies
+
+```bash
+pip install -r requirements.txt
+npm install
+```
+
+### 2. Build
+
+```bash
+fymo build
+```
+
+### 3. Serve
+
+```bash
+fymo serve     # production-like, port 8000
+```
+
+Or, for development with auto-rebuild and browser reload:
+
+```bash
+fymo dev
+```
+
+Visit `http://127.0.0.1:8000` to see the app.
+
+## Project Structure
+
+```
+todo_app/
+├── app/
+│   ├── controllers/
+│   │   └── todos.py        # Todo controller with initial data
+│   ├── templates/
+│   │   └── todos/
+│   │       └── index.svelte # Todo app component
+│   └── static/             # Static assets
+├── dist/                   # Built output (generated by fymo build)
+├── config/
+│   └── routes.py          # Route configuration
+├── fymo.yml              # Project configuration
+└── server.py             # Entry point
+```
+
+## How It Works
+
+1. **Build**: `fymo build` compiles Svelte components with esbuild into hashed bundles in `dist/`
+2. **Server-Side Rendering**: Python WSGI app sends render requests to a long-lived Node sidecar over stdio JSON; SSR output arrives in microseconds
+3. **Hydration**: The prebuilt client bundle hydrates the SSR'd HTML in the browser
+4. **Reactivity**: Uses Svelte 5's runes for reactive state management
+
+## Key Code Examples
+
+### Svelte 5 Runes in Action
+
+```svelte
+<script>
+  // Props from server
+  let { todos: initialTodos = [] } = $props();
+  
+  // Reactive state
+  let todos = $state([...initialTodos]);
+  let filter = $state('all');
+  
+  // Derived state
+  let filteredTodos = $derived(() => {
+    switch(filter) {
+      case 'active':
+        return todos.filter(t => !t.completed);
+      case 'completed':
+        return todos.filter(t => t.completed);
+      default:
+        return todos;
+    }
+  });
+</script>
+```
+
+### Python Controller
+
+```python
+# app/controllers/todos.py
+def getContext():
+    return {
+        'todos': [
+            {'id': 1, 'text': 'Learn Fymo', 'completed': True},
+            {'id': 2, 'text': 'Build awesome apps', 'completed': False}
+        ]
+    }
+```
+
+## Features Demonstrated
+
+- **Svelte 5 Runes**: `$state`, `$derived`, `$props`
+- **Event Handling**: Click, keyboard events
+- **Conditional Rendering**: Dynamic UI based on state
+- **List Rendering**: Efficient keyed each blocks
+- **Component Styling**: Scoped and global styles
+- **Server Data**: Initial data from Python backend
+
+## Extending the App
+
+To persist todos, you could:
+
+1. Add a database (SQLite, PostgreSQL)
+2. Create API endpoints for CRUD operations
+3. Use Svelte stores for global state
+4. Add user authentication
+5. Implement localStorage for offline support
+
+## License
+
+MIT - Part of the Fymo framework examples

fymo-0.1.0/fymo/__init__.py

@@ -0,0 +1,18 @@
+"""
+Fymo - Production-ready Python SSR Framework for Svelte 5
+
+A modern web framework that brings the power of Svelte 5 to Python backends,
+enabling server-side rendering with full client-side hydration.
+"""
+
+from fymo.core.server import create_app, FymoApp
+
+__version__ = "0.1.0"
+__author__ = "Fymo Contributors"
+__license__ = "MIT"
+
+__all__ = [
+    "create_app",
+    "FymoApp",
+    "__version__"
+]

fymo-0.1.0/fymo/__version__.py

@@ -0,0 +1,5 @@
+"""Version information for Fymo"""
+
+__version__ = "0.1.0"
+__version_info__ = (0, 1, 0)
+

fymo-0.1.0/fymo/bundler/js/dist/runtime-metadata.json

@@ -0,0 +1,5 @@
+{
+  "runtime_path": "/Users/bishwasbhandari/Projects/fymo/fymo/bundler/js/dist/svelte-runtime.js",
+  "bundle_size": 1085790,
+  "build_time": "2026-04-28T07:57:26.377Z"
+}