Metadata-Version: 2.1
Name: sherpa-streamlit
Version: 0.2.23
Summary: Kairntech Sherpa building blocks for Streamlit apps
Home-page: https://github.com/oterrier/sherpa_streamlit/
Keywords: 
Author: Olivier Terrier
Author-email: oterrier@gmail.com
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3.7
Requires-Dist: pandas==1.2.3
Requires-Dist: openpyxl==3.0.7
Requires-Dist: streamlit~=1.2.0
Requires-Dist: st-annotated-text>=3.0.0
Requires-Dist: sherpa-client==0.9.25
Requires-Dist: collections-extended>=1.0.2
Requires-Dist: python-multipart
Requires-Dist: Pillow
Requires-Dist: plac
Requires-Dist: bs4
Requires-Dist: methodtools
Requires-Dist: shortuuid==1.0.8
Requires-Dist: flit ; extra == "dev"
Requires-Dist: pre-commit ; extra == "dev"
Requires-Dist: bump2version ; extra == "dev"
Requires-Dist: sphinx ; extra == "docs"
Requires-Dist: sphinx-rtd-theme ; extra == "docs"
Requires-Dist: m2r2 ; extra == "docs"
Requires-Dist: sphinxcontrib.apidoc ; extra == "docs"
Requires-Dist: jupyter_sphinx ; extra == "docs"
Requires-Dist: pytest ; extra == "test"
Requires-Dist: pytest-cov ; extra == "test"
Requires-Dist: pytest-flake8 ; extra == "test"
Requires-Dist: types-requests ; extra == "test"
Requires-Dist: flake8==3.9.2 ; extra == "test"
Requires-Dist: pytest-mypy ; extra == "test"
Requires-Dist: pytest-black ; extra == "test"
Requires-Dist: tox ; extra == "test"
Provides-Extra: dev
Provides-Extra: docs
Provides-Extra: test

# sherpa_streamlit

[![license](https://img.shields.io/github/license/oterrier/sherpa_streamlit)](https://github.com/oterrier/sherpa_streamlit/blob/master/LICENSE)
[![tests](https://github.com/oterrier/sherpa_streamlit/workflows/tests/badge.svg)](https://github.com/oterrier/sherpa_streamlit/actions?query=workflow%3Atests)
[![codecov](https://img.shields.io/codecov/c/github/oterrier/sherpa_streamlit)](https://codecov.io/gh/oterrier/sherpa_streamlit)
[![docs](https://img.shields.io/readthedocs/sherpa_streamlit)](https://sherpa_streamlit.readthedocs.io)
[![version](https://img.shields.io/pypi/v/sherpa_streamlit)](https://pypi.org/project/sherpa_streamlit/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/sherpa_streamlit)](https://pypi.org/project/sherpa_streamlit/)

Kairntech Sherpa building blocks for Streamlit apps

This package contains utilities for visualizing and building interactive [Kairntech](https://kairntech.com) Sherpa-powered apps with
[Streamlit](https://streamlit.io). It includes various building blocks you can
use in your own Streamlit app, like visualizers for **named entities**, **text classification**, and more.

## Installation

You can simply `pip install sherpa-streamlit`.

## Quickstart

The package includes building blocks that call into Streamlit and set up all the required elements for you. You can either use the individual components directly and combine them with other elements in your app, or call the visualize function to embed the whole visualizer.

Put the following example code in a file.
```
# streamlit_app.py
import sherpa_streamlit

default_text = "Sundar Pichai is the CEO of Google."
sherpa_streamlit.visualize(default_text)
```
You can then run your app with `streamlit run streamlit_app.py`. The app should pop up in your web browser.

## Developing

### Pre-requesites

You will need to install `flit` (for building the package) and `tox` (for orchestrating testing and documentation building):

```
python3 -m pip install flit tox
```

Clone the repository:

```
git clone https://github.com/oterrier/sherpa_streamlit
```

### Running the test suite

You can run the full test suite against all supported versions of Python (3.8) with:

```
tox
```

### Building the documentation

You can build the HTML documentation with:

```
tox -e docs
```

The built documentation is available at `docs/_build/index.html.

