hyperlink-button 0.1.0__tar.gz

hyperlink_button-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maxim Saplin
+
+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.

hyperlink_button-0.1.0/MANIFEST.in

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

hyperlink_button-0.1.0/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.2
+Name: hyperlink_button
+Version: 0.1.0
+Summary: Streamlit custom component: hyperlink-like button with stock button API
+Author: OpenCode
+License: MIT
+Project-URL: Homepage, https://github.com/your-org/hyperlink_button
+Project-URL: Source, https://github.com/your-org/hyperlink_button
+Project-URL: Issues, https://github.com/your-org/hyperlink_button/issues
+Keywords: streamlit,component,ui,web,python
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: streamlit
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-xdist; extra == "dev"
+Requires-Dist: requests; extra == "dev"
+Requires-Dist: playwright; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+
+# hyperlink_button
+
+`hyperlink_button` is a Streamlit custom component that looks like a hoverable text link, but behaves like `st.button`.
+
+<img width="650" alt="image" src="https://github.com/user-attachments/assets/32e07e55-a575-4c6d-aa87-30da35915d11" />
+
+## Install
+
+From source (dev):
+
+```bash
+python -m pip install -e ".[dev]"
+```
+
+## Usage
+
+```python
+import streamlit as st
+from hyperlink_button import hyperlink_button
+
+clicked = hyperlink_button(
+    "Open details",
+    help="Does a normal Streamlit rerun",
+    type="secondary",
+)
+
+st.write("clicked", clicked)
+```
+
+## Development
+
+- Build frontend: `cd hyperlink_button/frontend && npm install && npm run build`
+- Run demo: `streamlit run examples/demo_app.py`
+
+Streamlit reference docs are available via the local `st_docs/` symlink.

hyperlink_button-0.1.0/README.md

@@ -0,0 +1,35 @@
+# hyperlink_button
+
+`hyperlink_button` is a Streamlit custom component that looks like a hoverable text link, but behaves like `st.button`.
+
+<img width="650" alt="image" src="https://github.com/user-attachments/assets/32e07e55-a575-4c6d-aa87-30da35915d11" />
+
+## Install
+
+From source (dev):
+
+```bash
+python -m pip install -e ".[dev]"
+```
+
+## Usage
+
+```python
+import streamlit as st
+from hyperlink_button import hyperlink_button
+
+clicked = hyperlink_button(
+    "Open details",
+    help="Does a normal Streamlit rerun",
+    type="secondary",
+)
+
+st.write("clicked", clicked)
+```
+
+## Development
+
+- Build frontend: `cd hyperlink_button/frontend && npm install && npm run build`
+- Run demo: `streamlit run examples/demo_app.py`
+
+Streamlit reference docs are available via the local `st_docs/` symlink.

hyperlink_button-0.1.0/hyperlink_button/__init__.py

@@ -0,0 +1,5 @@
+"""Public API for hyperlink_button Streamlit component."""
+
+from ._component import hyperlink_button
+
+__all__ = ["hyperlink_button"]

hyperlink_button-0.1.0/hyperlink_button/_component.py

@@ -0,0 +1,106 @@
+from __future__ import annotations
+
+import hashlib
+import inspect
+import os
+import re
+
+import streamlit as st
+import streamlit.components.v1 as components
+
+
+_BUILD_DIR = os.path.join(os.path.dirname(__file__), "frontend", "build")
+_DEV_URL = os.environ.get("HYPERLINK_BUTTON_DEV_SERVER_URL")
+
+
+def _declare_component():
+    # components.declare_component expects exactly one of url/path.
+    if _DEV_URL:
+        return components.declare_component("hyperlink_button", url=_DEV_URL)
+    return components.declare_component("hyperlink_button", path=_BUILD_DIR)
+
+
+_HB_COMPONENT = _declare_component()
+
+
+def _safe_id(value: str) -> str:
+    # For DOM/test ids.
+    value = re.sub(r"[^a-zA-Z0-9_-]+", "_", value)
+    return value[:64] if value else "anon"
+
+
+def _instance_id(label: str, user_key: str | None) -> str:
+    # If user provided an explicit key, Streamlit already enforces uniqueness;
+    # use it to make Playwright selectors stable.
+    if user_key:
+        return _safe_id(user_key)
+
+    # Otherwise derive a stable id for a given callsite + label.
+    # stack[0] = _instance_id, stack[1] = hyperlink_button, stack[2] = caller
+    frame = inspect.stack()[2]
+    payload = f"{frame.filename}:{frame.lineno}:{frame.function}:{label}"
+    return hashlib.sha256(payload.encode("utf-8")).hexdigest()[:16]
+
+
+def hyperlink_button(
+    label: str,
+    key: str | None = None,
+    help: str | None = None,
+    on_click=None,
+    args=None,
+    kwargs=None,
+    *,
+    type: str = "secondary",
+    icon: str | None = None,
+    icon_position: str = "left",
+    disabled: bool = False,
+    use_container_width: bool | None = None,
+    width="content",
+    shortcut: str | None = None,
+) -> bool:
+    """Hyperlink-styled Streamlit button.
+
+    Mirrors the current `st.button` API but renders as hyperlink-like text.
+    """
+
+    instance_id = _instance_id(label, key)
+    component_key = (
+        f"_hyperlink_button:{key}" if key else f"_hyperlink_button:{instance_id}"
+    )
+    state_key = f"_hyperlink_button_last_click:{component_key}"
+    last_seen = int(st.session_state.get(state_key, 0) or 0)
+
+    click_count = _HB_COMPONENT(
+        key=component_key,
+        label=label,
+        instance_id=instance_id,
+        testid=f"hyperlink-button-{instance_id}",
+        help=help,
+        disabled=disabled,
+        type=type,
+        icon=icon,
+        icon_position=icon_position,
+        use_container_width=use_container_width,
+        width=width,
+        shortcut=shortcut,
+        default=0,
+    )
+
+    # Component returns an int counter; convert to ephemeral bool.
+    try:
+        click_count_int = int(click_count or 0)
+    except Exception:
+        click_count_int = 0
+
+    clicked = click_count_int > last_seen
+    # Mirror st.button's "trigger-like" behavior for users who rely on session_state.
+    if key:
+        st.session_state[key] = clicked
+
+    if clicked:
+        st.session_state[state_key] = click_count_int
+        if on_click is not None:
+            cb_args = args or ()
+            cb_kwargs = kwargs or {}
+            on_click(*cb_args, **cb_kwargs)
+    return clicked

hyperlink_button-0.1.0/hyperlink_button/frontend/build/assets/index-Cg1LCKIs.css

@@ -0,0 +1 @@
+:root{color-scheme:light}.hb-root{display:inline-flex;align-items:center;justify-content:flex-start}.hb-button{font-family:"Source Serif 4",Georgia,Times New Roman,serif;font-size:.98rem;color:var(--hb-color, #1a73e8);background:transparent;border:none;padding:0;margin:0;cursor:pointer;text-decoration:none;display:inline-flex;align-items:center;gap:.35rem}.hb-button:hover{text-decoration:underline}.hb-button:focus-visible{outline:2px solid color-mix(in srgb,var(--hb-color, #1a73e8) 70%,transparent);outline-offset:2px;border-radius:2px}.hb-button:disabled{color:#7a7a7a;cursor:not-allowed;text-decoration:none}.hb-button:disabled .hb-label{text-decoration:line-through}.hb-icon{font-size:.95em;line-height:1}.hb-label{line-height:1.2}