Metadata-Version: 2.4
Name: streamlit-extras
Version: 0.7.8
Summary: A library to discover, try, install and share Streamlit extras
Project-URL: Homepage, https://github.com/arnaudmiribel/streamlit-extras
Project-URL: Bug Tracker, https://github.com/arnaudmiribel/streamlit-extras/issues
Author-email: Arnaud Miribel <arnaudmiribel@gmail.com>, Zachary Blackwood <zachary@streamlit.io>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: data,python,streamlit,ui
Requires-Python: <3.14,>=3.9
Requires-Dist: altex>=0.2.0
Requires-Dist: entrypoints>=0.4
Requires-Dist: htbuilder>=0.6.2
Requires-Dist: markdownlit>=0.0.7
Requires-Dist: plotly>=5.23.0
Requires-Dist: prometheus-client>=0.20.0
Requires-Dist: protobuf>=5.27.3
Requires-Dist: snowflake-snowpark-python[pandas]>=1.30.0; sys_platform != 'emscripten'
Requires-Dist: st-annotated-text>=4.0.1
Requires-Dist: st-theme>=1.2.3
Requires-Dist: streamlit-avatar>=0.1.3
Requires-Dist: streamlit-camera-input-live>=0.2.0
Requires-Dist: streamlit-card>=1.0.2
Requires-Dist: streamlit-embedcode>=0.1.2
Requires-Dist: streamlit-faker>=0.0.3
Requires-Dist: streamlit-image-coordinates>=0.1.9
Requires-Dist: streamlit-keyup>=0.2.4
Requires-Dist: streamlit-notify>=0.3.1
Requires-Dist: streamlit-toggle-switch>=1.0.2
Requires-Dist: streamlit-vertical-slider>=2.5.5
Requires-Dist: streamlit>=1.37.0
Requires-Dist: validators>=0.33.0
Description-Content-Type: text/markdown

<a href="https://extras.streamlitapp.com" title="Python Version"><img src="https://static.streamlit.io/badges/streamlit_badge_black_white.svg"></a><br>
<a href="https://github.com/arnaudmiribel/streamlit-extras/" title="Python Version"><img src="https://img.shields.io/badge/Python-3.9%2B-blue&style=flat"></a>
<a href="https://badge.fury.io/py/streamlit-extras"><img src="https://badge.fury.io/py/streamlit-extras.svg" alt="PyPI version" height="18"></a>
<a href="https://hits.seeyoufarm.com"><img src="https://hits.seeyoufarm.com/api/count/incr/badge.svg?url=https%3A%2F%2Fgithub.com%2Farnaudmiribel%2Fstreamlit-extras&count_bg=%2379C83D&title_bg=%23555555&icon=&icon_color=%23E7E7E7&title=visits&edge_flat=false"/></a>


# 🪢 streamlit-extras


<strong>A Python library with useful Streamlit extras</strong>

`streamlit-extras` is a Python library putting together useful Streamlit bits of code (<b><i>extras</i></b>).

![CleanShot 2023-10-18 at 14 56 43](https://github.com/arnaudmiribel/streamlit-extras/assets/7164864/14f20cf6-033c-4143-9f29-d0e95bf7dca1)


## Highlights

- 📙&nbsp; <b>Discover:</b> Visit our <a href="https://arnaudmiribel.github.io/streamlit-extras/">documentation</a> to discover all extras.
- ⬇️&nbsp; <b>Install:</b> `streamlit-extras` is a PyPI package with all extras included. Get them all using pip!
- 🫴&nbsp; <b>Share:</b> Go ahead and share your own extras, it's just [a PR away](https://arnaudmiribel.github.io/streamlit-extras/contributing/)!

## Getting Started

### Installation

```bash
pip install streamlit-extras
```

Or with [uv](https://docs.astral.sh/uv/):

```bash
uv add streamlit-extras
```

### Usage

Here's an example with one of the easiest extras around, <a href="https://arnaudmiribel.github.io/streamlit-extras/extras/stoggle/">stoggle</a>
```python
from streamlit_extras.stoggle import stoggle

stoggle(
    "Click me!",
    """🥷 Surprise! Here's some additional content""",
)
```

<img src="https://user-images.githubusercontent.com/16867691/192553812-f91c801b-e820-470b-84c6-4563504c6ce5.gif"></img>

## Development

This project uses [uv](https://docs.astral.sh/uv/) for dependency management.

```bash
# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone and setup
git clone https://github.com/arnaudmiribel/streamlit-extras.git
cd streamlit-extras
uv sync

# Run tests
uv run pytest

# Run the gallery
uv run streamlit run gallery/streamlit_app.py
```

## Documentation

Visit <a href="https://arnaudmiribel.github.io/streamlit-extras/">https://arnaudmiribel.github.io/streamlit-extras</a>

## Contribution

PRs are welcome! Guidelines <a href="https://arnaudmiribel.github.io/streamlit-extras/contributing/">here</a>

<sup>README template taken from <a href="https://github.com/LukasMasuch/streamlit-pydantic">LukasMasuch/streamlit-pydantic</a></sup>
