streamlit-sortable-multiselect 0.1.1__tar.gz

streamlit_sortable_multiselect-0.1.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Developer
+
+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_sortable_multiselect-0.1.1/MANIFEST.in

@@ -0,0 +1,9 @@
+include README.md
+include LICENSE
+recursive-include streamlit_sortable_multiselect/frontend/build *
+prune streamlit_sortable_multiselect/frontend/node_modules
+prune streamlit_sortable_multiselect/frontend/src
+exclude streamlit_sortable_multiselect/frontend/package-lock.json
+exclude streamlit_sortable_multiselect/frontend/package.json
+exclude streamlit_sortable_multiselect/frontend/tsconfig.json
+exclude streamlit_sortable_multiselect/frontend/vite.config.ts

streamlit_sortable_multiselect-0.1.1/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.4
+Name: streamlit-sortable-multiselect
+Version: 0.1.1
+Summary: A Streamlit custom component for selecting and reordering multiple string values.
+Author: Developer
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/KentaroAOKI/streamlit-sortable-multiselect
+Project-URL: Repository, https://github.com/KentaroAOKI/streamlit-sortable-multiselect
+Project-URL: Issues, https://github.com/KentaroAOKI/streamlit-sortable-multiselect/issues
+Keywords: streamlit,component,multiselect,sortable,drag-and-drop
+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
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: streamlit>=1.30
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: pytest>=8; extra == "dev"
+Requires-Dist: twine>=6; extra == "dev"
+Dynamic: license-file
+
+# streamlit-sortable-multiselect
+
+A Streamlit custom component for selecting multiple string values and changing the selected order.
+
+## Install
+
+```bash
+python -m pip install streamlit-sortable-multiselect
+```
+
+For local development:
+
+```bash
+python -m pip install -e ".[dev]"
+```
+
+For frontend development:
+
+```bash
+cd streamlit_sortable_multiselect/frontend
+npm install
+npm run dev
+```
+
+## Usage
+
+```python
+import streamlit as st
+from streamlit_sortable_multiselect import sortable_multiselect
+
+selected = sortable_multiselect(
+    "Favorite frameworks",
+    options=["Streamlit", "FastAPI", "Django", "Flask"],
+    default=["Streamlit"],
+)
+
+st.write(selected)
+```
+
+Build the frontend before packaging or using release mode:
+
+```bash
+cd streamlit_sortable_multiselect/frontend
+npm run build
+```
+
+Run the example app:
+
+```bash
+streamlit run examples/basic.py
+```
+
+## Release
+
+Build and check the distribution files:
+
+```bash
+cd streamlit_sortable_multiselect/frontend
+npm install
+npm run build
+cd ../..
+python -m pip install -e ".[dev]"
+python -m build
+python -m twine check dist/*
+```
+
+Upload to PyPI with an API token:
+
+```bash
+python -m twine upload dist/*
+```

streamlit_sortable_multiselect-0.1.1/README.md

@@ -0,0 +1,71 @@
+# streamlit-sortable-multiselect
+
+A Streamlit custom component for selecting multiple string values and changing the selected order.
+
+## Install
+
+```bash
+python -m pip install streamlit-sortable-multiselect
+```
+
+For local development:
+
+```bash
+python -m pip install -e ".[dev]"
+```
+
+For frontend development:
+
+```bash
+cd streamlit_sortable_multiselect/frontend
+npm install
+npm run dev
+```
+
+## Usage
+
+```python
+import streamlit as st
+from streamlit_sortable_multiselect import sortable_multiselect
+
+selected = sortable_multiselect(
+    "Favorite frameworks",
+    options=["Streamlit", "FastAPI", "Django", "Flask"],
+    default=["Streamlit"],
+)
+
+st.write(selected)
+```
+
+Build the frontend before packaging or using release mode:
+
+```bash
+cd streamlit_sortable_multiselect/frontend
+npm run build
+```
+
+Run the example app:
+
+```bash
+streamlit run examples/basic.py
+```
+
+## Release
+
+Build and check the distribution files:
+
+```bash
+cd streamlit_sortable_multiselect/frontend
+npm install
+npm run build
+cd ../..
+python -m pip install -e ".[dev]"
+python -m build
+python -m twine check dist/*
+```
+
+Upload to PyPI with an API token:
+
+```bash
+python -m twine upload dist/*
+```

streamlit_sortable_multiselect-0.1.1/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "streamlit-sortable-multiselect"
+version = "0.1.1"
+description = "A Streamlit custom component for selecting and reordering multiple string values."
+readme = "README.md"
+requires-python = ">=3.9"
+authors = [
+  { name = "Developer" },
+]
+license = "MIT"
+keywords = ["streamlit", "component", "multiselect", "sortable", "drag-and-drop"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+  "streamlit>=1.30",
+]
+
+[project.urls]
+Homepage = "https://github.com/KentaroAOKI/streamlit-sortable-multiselect"
+Repository = "https://github.com/KentaroAOKI/streamlit-sortable-multiselect"
+Issues = "https://github.com/KentaroAOKI/streamlit-sortable-multiselect/issues"
+
+[project.optional-dependencies]
+dev = [
+  "build>=1.2",
+  "pytest>=8",
+  "twine>=6",
+]
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+include = ["streamlit_sortable_multiselect*"]
+
+[tool.setuptools.package-data]
+streamlit_sortable_multiselect = [
+  "frontend/build/**/*",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "-q"

streamlit_sortable_multiselect-0.1.1/setup.cfg

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

streamlit_sortable_multiselect-0.1.1/streamlit_sortable_multiselect/__init__.py

@@ -0,0 +1,102 @@
+"""Streamlit sortable multiselect component."""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+from typing import Iterable, Sequence, cast
+
+import streamlit.components.v1 as components
+
+__version__ = "0.1.1"
+__all__ = ["sortable_multiselect"]
+
+_COMPONENT_NAME = "streamlit_sortable_multiselect"
+_DEV_SERVER_URL = "http://localhost:5173"
+_RELEASE = os.environ.get("STREAMLIT_SORTABLE_MULTISELECT_DEV") != "1"
+
+
+def _declare_component():
+    if _RELEASE:
+        build_dir = Path(__file__).parent / "frontend" / "build"
+        return components.declare_component(_COMPONENT_NAME, path=str(build_dir))
+    return components.declare_component(_COMPONENT_NAME, url=_DEV_SERVER_URL)
+
+
+_component_func = _declare_component()
+
+
+def _validate_string_sequence(name: str, values: Sequence[str] | None) -> list[str]:
+    if values is None:
+        return []
+    if isinstance(values, str) or not isinstance(values, Iterable):
+        raise TypeError(f"{name} must be a sequence of strings.")
+
+    result = list(values)
+    invalid = [value for value in result if not isinstance(value, str)]
+    if invalid:
+        raise TypeError(f"{name} must contain only strings.")
+    return result
+
+
+def sortable_multiselect(
+    label: str,
+    options: Sequence[str],
+    default: Sequence[str] | None = None,
+    placeholder: str = "Select...",
+    disabled: bool = False,
+    key: str | None = None,
+) -> list[str]:
+    """Select multiple string values and return them in user-defined order.
+
+    Parameters
+    ----------
+    label:
+        Text label rendered above the component.
+    options:
+        Available string values.
+    default:
+        Initially selected values, in the desired initial order.
+    placeholder:
+        Placeholder text shown in the add-item select control.
+    disabled:
+        Disable selection and ordering controls.
+    key:
+        Optional Streamlit component key.
+    """
+    if not isinstance(label, str):
+        raise TypeError("label must be a string.")
+    if not isinstance(placeholder, str):
+        raise TypeError("placeholder must be a string.")
+    if not isinstance(disabled, bool):
+        raise TypeError("disabled must be a bool.")
+
+    option_values = _validate_string_sequence("options", options)
+    default_values = _validate_string_sequence("default", default)
+
+    duplicate_options = sorted({value for value in option_values if option_values.count(value) > 1})
+    if duplicate_options:
+        raise ValueError("options must not contain duplicate values.")
+
+    missing_defaults = [value for value in default_values if value not in option_values]
+    if missing_defaults:
+        missing = ", ".join(repr(value) for value in missing_defaults)
+        raise ValueError(f"default contains values not present in options: {missing}.")
+
+    duplicate_defaults = sorted({value for value in default_values if default_values.count(value) > 1})
+    if duplicate_defaults:
+        raise ValueError("default must not contain duplicate values.")
+
+    component_value = _component_func(
+        label=label,
+        options=option_values,
+        default_selected=default_values,
+        placeholder=placeholder,
+        disabled=disabled,
+        key=key,
+        default=default_values,
+    )
+
+    if component_value is None:
+        return default_values
+    return cast(list[str], component_value)