streamlit-kanban 0.1.0__tar.gz

streamlit_kanban-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Your Name
+
+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.

streamlit_kanban-0.1.0/MANIFEST.in

@@ -0,0 +1 @@
+recursive-include streamlit_kanban/frontend/build *

streamlit_kanban-0.1.0/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.4
+Name: streamlit-kanban
+Version: 0.1.0
+Summary: A drag-and-drop Kanban board component for Streamlit
+Home-page: https://github.com/RhythrosaLabs/streamlit-kanban
+Author: Your Name
+Author-email: you@example.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: streamlit>=1.28.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# streamlit-kanban
+
+A drag-and-drop Kanban board component for Streamlit. Move cards between columns, add and edit cards with tags and priority levels, and get the full board state back as JSON.
+
+![Kanban screenshot](https://raw.githubusercontent.com/RhythrosaLabs/streamlit-kanban/main/docs/screenshot.png)
+
+## Features
+
+- Drag-and-drop cards between columns (native HTML5, no external DnD lib)
+- Click any card to edit title, tag, and priority
+- Add cards to any column
+- Color-coded tag and priority badges
+- Progress bar tracking Done / Total
+- Export board state as JSON
+- Zero runtime dependencies beyond Streamlit
+
+## Installation
+
+```bash
+pip install streamlit-kanban
+```
+
+## Quickstart
+
+```python
+import streamlit as st
+from streamlit_kanban import st_kanban
+
+columns = [
+    {
+        "id": "todo",
+        "title": "To Do",
+        "color": "#6366f1",
+        "cards": [
+            {"id": "c1", "title": "Write tests",    "tag": "Dev",    "priority": "high"},
+            {"id": "c2", "title": "Update docs",    "tag": "Docs",   "priority": "low"},
+        ],
+    },
+    {
+        "id": "in-progress",
+        "title": "In Progress",
+        "color": "#f59e0b",
+        "cards": [
+            {"id": "c3", "title": "Build auth flow", "tag": "Dev", "priority": "high"},
+        ],
+    },
+    {
+        "id": "done",
+        "title": "Done",
+        "color": "#10b981",
+        "cards": [],
+    },
+]
+
+st.title("My Project Board")
+
+if "board" not in st.session_state:
+    st.session_state.board = columns
+
+result = st_kanban(st.session_state.board, key="kanban")
+
+if result:
+    st.session_state.board = result
+```
+
+## API
+
+```python
+st_kanban(columns, key=None)
+```
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `columns` | `list[dict]` | Column definitions (see schema below) |
+| `key` | `str` | Streamlit widget key |
+
+**Returns:** Updated `columns` list on any interaction, `None` on first render.
+
+### Column schema
+
+```python
+{
+    "id":    str,          # unique identifier
+    "title": str,          # display name
+    "color": str,          # hex accent color for the column dot
+    "cards": [
+        {
+            "id":       str,   # unique card id
+            "title":    str,   # card text
+            "tag":      str,   # e.g. "Dev", "Design", "Bug"
+            "priority": str,   # "high" | "medium" | "low"
+        }
+    ]
+}
+```
+
+## Development
+
+```bash
+git clone https://github.com/RhythrosaLabs/streamlit-kanban
+cd streamlit-kanban
+
+# Frontend
+cd streamlit_kanban/frontend
+npm install
+npm start          # dev server on :3001
+
+# Python (separate terminal)
+cd ../..
+pip install -e .
+# In streamlit_kanban/__init__.py, set _RELEASE = False
+streamlit run example.py
+```
+
+## License
+
+MIT

streamlit_kanban-0.1.0/README.md

@@ -0,0 +1,117 @@
+# streamlit-kanban
+
+A drag-and-drop Kanban board component for Streamlit. Move cards between columns, add and edit cards with tags and priority levels, and get the full board state back as JSON.
+
+![Kanban screenshot](https://raw.githubusercontent.com/RhythrosaLabs/streamlit-kanban/main/docs/screenshot.png)
+
+## Features
+
+- Drag-and-drop cards between columns (native HTML5, no external DnD lib)
+- Click any card to edit title, tag, and priority
+- Add cards to any column
+- Color-coded tag and priority badges
+- Progress bar tracking Done / Total
+- Export board state as JSON
+- Zero runtime dependencies beyond Streamlit
+
+## Installation
+
+```bash
+pip install streamlit-kanban
+```
+
+## Quickstart
+
+```python
+import streamlit as st
+from streamlit_kanban import st_kanban
+
+columns = [
+    {
+        "id": "todo",
+        "title": "To Do",
+        "color": "#6366f1",
+        "cards": [
+            {"id": "c1", "title": "Write tests",    "tag": "Dev",    "priority": "high"},
+            {"id": "c2", "title": "Update docs",    "tag": "Docs",   "priority": "low"},
+        ],
+    },
+    {
+        "id": "in-progress",
+        "title": "In Progress",
+        "color": "#f59e0b",
+        "cards": [
+            {"id": "c3", "title": "Build auth flow", "tag": "Dev", "priority": "high"},
+        ],
+    },
+    {
+        "id": "done",
+        "title": "Done",
+        "color": "#10b981",
+        "cards": [],
+    },
+]
+
+st.title("My Project Board")
+
+if "board" not in st.session_state:
+    st.session_state.board = columns
+
+result = st_kanban(st.session_state.board, key="kanban")
+
+if result:
+    st.session_state.board = result
+```
+
+## API
+
+```python
+st_kanban(columns, key=None)
+```
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `columns` | `list[dict]` | Column definitions (see schema below) |
+| `key` | `str` | Streamlit widget key |
+
+**Returns:** Updated `columns` list on any interaction, `None` on first render.
+
+### Column schema
+
+```python
+{
+    "id":    str,          # unique identifier
+    "title": str,          # display name
+    "color": str,          # hex accent color for the column dot
+    "cards": [
+        {
+            "id":       str,   # unique card id
+            "title":    str,   # card text
+            "tag":      str,   # e.g. "Dev", "Design", "Bug"
+            "priority": str,   # "high" | "medium" | "low"
+        }
+    ]
+}
+```
+
+## Development
+
+```bash
+git clone https://github.com/RhythrosaLabs/streamlit-kanban
+cd streamlit-kanban
+
+# Frontend
+cd streamlit_kanban/frontend
+npm install
+npm start          # dev server on :3001
+
+# Python (separate terminal)
+cd ../..
+pip install -e .
+# In streamlit_kanban/__init__.py, set _RELEASE = False
+streamlit run example.py
+```
+
+## License
+
+MIT

streamlit_kanban-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

streamlit_kanban-0.1.0/setup.py

@@ -0,0 +1,21 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="streamlit-kanban",
+    version="0.1.0",
+    author="Your Name",
+    author_email="you@example.com",
+    description="A drag-and-drop Kanban board component for Streamlit",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    url="https://github.com/RhythrosaLabs/streamlit-kanban",
+    packages=find_packages(),
+    include_package_data=True,
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.8",
+    install_requires=["streamlit>=1.28.0"],
+)

streamlit_kanban-0.1.0/streamlit_kanban/__init__.py

@@ -0,0 +1,49 @@
+import os
+import streamlit.components.v1 as components
+
+_RELEASE = True
+
+if _RELEASE:
+    _component_func = components.declare_component(
+        "streamlit_kanban",
+        path=os.path.join(os.path.dirname(__file__), "frontend/build"),
+    )
+else:
+    _component_func = components.declare_component(
+        "streamlit_kanban",
+        url="http://localhost:3001",
+    )
+
+
+def st_kanban(columns, key=None):
+    """
+    Render an interactive Kanban board.
+
+    Parameters
+    ----------
+    columns : list[dict]
+        List of column definitions. Each dict has:
+          - id (str): unique column identifier
+          - title (str): display name
+          - color (str): hex accent color
+          - cards (list[dict]): each card has id, title, tag, priority
+    key : str, optional
+        Streamlit widget key for state isolation.
+
+    Returns
+    -------
+    list[dict] | None
+        Updated columns structure after user interaction, or None on first render.
+
+    Example
+    -------
+    >>> columns = [
+    ...     {"id": "todo", "title": "To Do", "color": "#6366f1",
+    ...      "cards": [{"id": "c1", "title": "Fix bug", "tag": "Dev", "priority": "high"}]},
+    ...     {"id": "done", "title": "Done",  "color": "#10b981", "cards": []},
+    ... ]
+    >>> result = st_kanban(columns, key="board")
+    >>> if result:
+    ...     st.write(result)  # updated board state
+    """
+    return _component_func(columns=columns, key=key, default=None)

streamlit_kanban-0.1.0/streamlit_kanban/frontend/build/asset-manifest.json

@@ -0,0 +1,10 @@
+{
+  "files": {
+    "main.js": "./static/js/main.c0d76036.js",
+    "index.html": "./index.html",
+    "main.c0d76036.js.map": "./static/js/main.c0d76036.js.map"
+  },
+  "entrypoints": [
+    "static/js/main.c0d76036.js"
+  ]
+}

streamlit_kanban-0.1.0/streamlit_kanban/frontend/build/index.html

@@ -0,0 +1 @@
+<!doctype html><html lang="en"><head><meta charset="utf-8"/><meta name="viewport" content="width=device-width,initial-scale=1"/><title>Streamlit Kanban</title><script defer="defer" src="./static/js/main.c0d76036.js"></script></head><body><noscript>You need to enable JavaScript to run this app.</noscript><div id="root"></div></body></html>