refast_grid 0.2.0__tar.gz

refast_grid-0.2.0/.gitignore

@@ -0,0 +1,92 @@
+# 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_grid/static/*.js
+src/refast_grid/static/*.css
+!src/refast_grid/static/.gitkeep
+
+# OS files
+.DS_Store
+Thumbs.db

refast_grid-0.2.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_grid-0.2.0/PKG-INFO

@@ -0,0 +1,139 @@
+Metadata-Version: 2.4
+Name: refast_grid
+Version: 0.2.0
+Summary: Spreadsheet component for refast
+Project-URL: Homepage, https://github.com/idling-mind/refast_grid
+Project-URL: Bug Tracker, https://github.com/idling-mind/refast_grid/issues
+Project-URL: Documentation, https://github.com/idling-mind/refast_grid#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.1
+Provides-Extra: dev
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: ty; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# refast_grid
+
+Spreadsheet component for refast
+
+A [Refast](https://github.com/idling-mind/refast) extension that provides the `RefastGrid` component.
+
+## Installation
+
+```bash
+pip install refast_grid
+```
+
+## 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, Button, Row
+from refast_grid import RefastGrid
+
+# Extension is auto-discovered, no need to manually register
+ui = RefastApp(title="RefastGrid Demo")
+
+
+@ui.page("/")
+def home(ctx: Context):
+    return Container(
+        children=[
+            RefastGrid(
+                id="my-component",
+                value="Hello, World!",
+            ),
+        ]
+    )
+
+
+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_grid import RefastGrid, RefastGridExtension
+
+ui = RefastApp(
+    title="RefastGrid Demo",
+    auto_discover_extensions=False,
+    extensions=[RefastGridExtension()],
+)
+```
+
+## Component Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `value` | str | "" | The value to display |
+| `on_change` | Callback | None | Called when the value changes |
+| `id` | str | None | Component ID |
+| `class_name` | str | "" | CSS classes to apply |
+
+## Development
+
+### Prerequisites
+
+- Python 3.11+
+- Node.js 18+
+- npm
+
+### Building the Frontend
+
+```bash
+cd frontend
+npm install
+npm run build
+```
+
+This builds the UMD bundle to `src/refast_grid/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_grid-0.2.0/README.md

@@ -0,0 +1,113 @@
+# refast_grid
+
+Spreadsheet component for refast
+
+A [Refast](https://github.com/idling-mind/refast) extension that provides the `RefastGrid` component.
+
+## Installation
+
+```bash
+pip install refast_grid
+```
+
+## 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, Button, Row
+from refast_grid import RefastGrid
+
+# Extension is auto-discovered, no need to manually register
+ui = RefastApp(title="RefastGrid Demo")
+
+
+@ui.page("/")
+def home(ctx: Context):
+    return Container(
+        children=[
+            RefastGrid(
+                id="my-component",
+                value="Hello, World!",
+            ),
+        ]
+    )
+
+
+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_grid import RefastGrid, RefastGridExtension
+
+ui = RefastApp(
+    title="RefastGrid Demo",
+    auto_discover_extensions=False,
+    extensions=[RefastGridExtension()],
+)
+```
+
+## Component Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `value` | str | "" | The value to display |
+| `on_change` | Callback | None | Called when the value changes |
+| `id` | str | None | Component ID |
+| `class_name` | str | "" | CSS classes to apply |
+
+## Development
+
+### Prerequisites
+
+- Python 3.11+
+- Node.js 18+
+- npm
+
+### Building the Frontend
+
+```bash
+cd frontend
+npm install
+npm run build
+```
+
+This builds the UMD bundle to `src/refast_grid/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.