refast-echarts 0.1.0__tar.gz

refast_echarts-0.1.0/.gitignore

@@ -0,0 +1,93 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# Node.js
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Frontend build artifacts (keep the static directory but not its contents except .gitkeep)
+# Note: Built assets are not committed, they're built during install via hatch hook
+src/refast_echarts/static/*.js
+src/refast_echarts/static/*.css
+!src/refast_echarts/static/.gitkeep
+
+# OS files
+.DS_Store
+Thumbs.db
+uv.lock

refast_echarts-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Najeem Muhammed
+
+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.
+

refast_echarts-0.1.0/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: refast-echarts
+Version: 0.1.0
+Summary: Refast extension for ECharts
+Project-URL: Homepage, https://github.com/idling-mind/refast-echarts
+Project-URL: Bug Tracker, https://github.com/idling-mind/refast-echarts/issues
+Project-URL: Documentation, https://github.com/idling-mind/refast-echarts#readme
+Author-email: Najeem Muhammed <najeem@gmail.com>
+License-File: LICENSE
+Classifier: Framework :: FastAPI
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Requires-Python: >=3.11
+Requires-Dist: refast>=0.0.8
+Description-Content-Type: text/markdown
+
+# refast-echarts
+
+Refast extension for ECharts
+
+A [Refast](https://github.com/idling-mind/refast) extension that provides the `Echarts` component.
+
+## Installation
+
+```bash
+pip install refast-echarts
+```
+
+## Usage
+
+### Option 1: Auto-Discovery (Recommended)
+
+When you install the package, Refast will automatically discover and load the extension:
+
+```python
+from fastapi import FastAPI
+from refast import RefastApp, Context
+from refast.components import Container
+from refast_echarts import ECharts
+
+ui = RefastApp(title="ECharts Demo")
+
+
+@ui.page("/")
+def home(ctx: Context):
+    option = {
+        "title": {"text": "Monthly Sales"},
+        "tooltip": {},
+        "xAxis": {
+            "data": ["Jan", "Feb", "Mar", "Apr", "May", "Jun"],
+        },
+        "yAxis": {},
+        "series": [
+            {
+                "name": "Sales",
+                "type": "bar",
+                "data": [120, 200, 150, 80, 70, 110],
+            }
+        ],
+    }
+    return Container(
+        children=[
+            ECharts(option=option, height="400px"),
+        ]
+    )
+
+
+app = FastAPI()
+app.include_router(ui.router)
+
+if __name__ == "__main__":
+    import uvicorn
+    uvicorn.run(app, host="0.0.0.0", port=8000)
+```
+
+### Option 2: Manual Registration
+
+If you want to disable auto-discovery and register extensions manually:
+
+```python
+from refast import RefastApp
+from refast_echarts import Echarts, EchartsExtension
+
+ui = RefastApp(
+    title="Echarts Demo",
+    auto_discover_extensions=False,
+    extensions=[EchartsExtension()],
+)
+```
+
+## Component Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `option` | dict | `{}` | ECharts option configuration object |
+| `theme` | str \| dict | `None` | Theme name (`"light"`, `"dark"`) or custom theme object |
+| `height` | str | `None` | Chart height (e.g. `"400px"`) |
+| `width` | str | `None` | Chart width (e.g. `"100%"`) |
+| `auto_resize` | bool | `True` | Auto-resize chart when container size changes |
+| `loading` | bool | `False` | Show loading animation |
+| `on_click` | Callback | `None` | Fired when clicking on a chart element |
+| `on_mouseover` | Callback | `None` | Fired when hovering over a chart element |
+| `id` | str | `None` | Component ID (required for `setOption` calls) |
+| `class_name` | str | `""` | CSS classes to apply to the container |
+
+## Development
+
+### Prerequisites
+
+- Python 3.10+
+- Node.js 18+
+- npm
+
+### Building the Frontend
+
+```bash
+cd frontend
+npm install
+npm run build
+```
+
+This builds the UMD bundle to `src/refast_echarts/static/`.
+
+### Installing Locally
+
+```bash
+# Install with automatic frontend build (via hatch hook)
+pip install -e .
+
+# Or build frontend first, then install
+cd frontend && npm install && npm run build && cd ..
+pip install -e .
+```
+
+### Running the Example
+
+```bash
+python usage.py
+```
+
+Then open http://localhost:8000 in your browser.
+
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

refast_echarts-0.1.0/README.md

@@ -0,0 +1,130 @@
+# refast-echarts
+
+Refast extension for ECharts
+
+A [Refast](https://github.com/idling-mind/refast) extension that provides the `Echarts` component.
+
+## Installation
+
+```bash
+pip install refast-echarts
+```
+
+## Usage
+
+### Option 1: Auto-Discovery (Recommended)
+
+When you install the package, Refast will automatically discover and load the extension:
+
+```python
+from fastapi import FastAPI
+from refast import RefastApp, Context
+from refast.components import Container
+from refast_echarts import ECharts
+
+ui = RefastApp(title="ECharts Demo")
+
+
+@ui.page("/")
+def home(ctx: Context):
+    option = {
+        "title": {"text": "Monthly Sales"},
+        "tooltip": {},
+        "xAxis": {
+            "data": ["Jan", "Feb", "Mar", "Apr", "May", "Jun"],
+        },
+        "yAxis": {},
+        "series": [
+            {
+                "name": "Sales",
+                "type": "bar",
+                "data": [120, 200, 150, 80, 70, 110],
+            }
+        ],
+    }
+    return Container(
+        children=[
+            ECharts(option=option, height="400px"),
+        ]
+    )
+
+
+app = FastAPI()
+app.include_router(ui.router)
+
+if __name__ == "__main__":
+    import uvicorn
+    uvicorn.run(app, host="0.0.0.0", port=8000)
+```
+
+### Option 2: Manual Registration
+
+If you want to disable auto-discovery and register extensions manually:
+
+```python
+from refast import RefastApp
+from refast_echarts import Echarts, EchartsExtension
+
+ui = RefastApp(
+    title="Echarts Demo",
+    auto_discover_extensions=False,
+    extensions=[EchartsExtension()],
+)
+```
+
+## Component Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `option` | dict | `{}` | ECharts option configuration object |
+| `theme` | str \| dict | `None` | Theme name (`"light"`, `"dark"`) or custom theme object |
+| `height` | str | `None` | Chart height (e.g. `"400px"`) |
+| `width` | str | `None` | Chart width (e.g. `"100%"`) |
+| `auto_resize` | bool | `True` | Auto-resize chart when container size changes |
+| `loading` | bool | `False` | Show loading animation |
+| `on_click` | Callback | `None` | Fired when clicking on a chart element |
+| `on_mouseover` | Callback | `None` | Fired when hovering over a chart element |
+| `id` | str | `None` | Component ID (required for `setOption` calls) |
+| `class_name` | str | `""` | CSS classes to apply to the container |
+
+## Development
+
+### Prerequisites
+
+- Python 3.10+
+- Node.js 18+
+- npm
+
+### Building the Frontend
+
+```bash
+cd frontend
+npm install
+npm run build
+```
+
+This builds the UMD bundle to `src/refast_echarts/static/`.
+
+### Installing Locally
+
+```bash
+# Install with automatic frontend build (via hatch hook)
+pip install -e .
+
+# Or build frontend first, then install
+cd frontend && npm install && npm run build && cd ..
+pip install -e .
+```
+
+### Running the Example
+
+```bash
+python usage.py
+```
+
+Then open http://localhost:8000 in your browser.
+
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.