diff options
| author | CoprDistGit <infra@openeuler.org> | 2023-05-31 04:08:51 +0000 |
|---|---|---|
| committer | CoprDistGit <infra@openeuler.org> | 2023-05-31 04:08:51 +0000 |
| commit | da9b9bde364da7b13a9f773c3242e065a69068f7 (patch) | |
| tree | 3f137668b033865486c863e5c77084213c76d415 | |
| parent | 3e632b40df7f45e1d8d47aa44ebe10af28e26ca7 (diff) | |
automatic import of python-spacy-streamlit
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-spacy-streamlit.spec | 936 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 938 insertions, 0 deletions
@@ -0,0 +1 @@ +/spacy_streamlit-1.0.6.tar.gz diff --git a/python-spacy-streamlit.spec b/python-spacy-streamlit.spec new file mode 100644 index 0000000..cd523b2 --- /dev/null +++ b/python-spacy-streamlit.spec @@ -0,0 +1,936 @@ +%global _empty_manifest_terminate_build 0 +Name: python-spacy-streamlit +Version: 1.0.6 +Release: 1 +Summary: Visualize spaCy with streamlit +License: MIT +URL: https://github.com/explosion/spacy-streamlit +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/78/91/72a4817b31db40b5346d3246464743b6e7bbe2ea75f4693a6affd3c11166/spacy_streamlit-1.0.6.tar.gz +BuildArch: noarch + +Requires: python3-streamlit +Requires: python3-spacy +Requires: python3-pandas + +%description +<a href="https://explosion.ai"><img src="https://explosion.ai/assets/img/logo.svg" width="125" height="125" align="right" /></a> + +# spacy-streamlit: spaCy building blocks for Streamlit apps + +This package contains utilities for visualizing [spaCy](https://spacy.io) models +and building interactive spaCy-powered apps with +[Streamlit](https://streamlit.io). It includes various building blocks you can +use in your own Streamlit app, like visualizers for **syntactic dependencies**, +**named entities**, **text classification**, **semantic similarity** via word +vectors, token attributes, and more. + +[](https://github.com/explosion/spacy-streamlit/releases) +[](https://pypi.org/project/spacy-streamlit/) + +<img width="50%" align="right" src="https://user-images.githubusercontent.com/13643239/85388081-f2da8700-b545-11ea-9bd4-e303d3c5763c.png"> + +## 🚀 Quickstart + +You can install `spacy-streamlit` from pip: + +```bash +pip install spacy-streamlit +``` + +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. + +Download the English model from spaCy to get started. + +```bash +python -m spacy download en_core_web_sm +``` + +Then put the following example code in a file. + +```python +# streamlit_app.py +import spacy_streamlit + +models = ["en_core_web_sm", "en_core_web_md"] +default_text = "Sundar Pichai is the CEO of Google." +spacy_streamlit.visualize(models, default_text) +``` + +You can then run your app with `streamlit run streamlit_app.py`. The app should +pop up in your web browser. 😀 + +#### 📦 Example: [`01_out-of-the-box.py`](examples/01_out-of-the-box.py) + +Use the embedded visualizer with custom settings out-of-the-box. + +```bash +streamlit run https://raw.githubusercontent.com/explosion/spacy-streamlit/master/examples/01_out-of-the-box.py +``` + +#### 👑 Example: [`02_custom.py`](examples/02_custom.py) + +Use individual components in your existing app. + +```bash +streamlit run https://raw.githubusercontent.com/explosion/spacy-streamlit/master/examples/02_custom.py +``` + +## 🎛 API + +### Visualizer components + +These functions can be used in your Streamlit app. They call into `streamlit` +under the hood and set up the required elements. + +#### <kbd>function</kbd> `visualize` + +Embed the full visualizer with selected components. + +```python +import spacy_streamlit + +models = ["en_core_web_sm", "/path/to/model"] +default_text = "Sundar Pichai is the CEO of Google." +visualizers = ["ner", "textcat"] +spacy_streamlit.visualize(models, default_text, visualizers) +``` + +| Argument | Type | Description | +| ------------------------ | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `models` | List[str] / Dict[str, str] | Names of loadable spaCy models (paths or package names). The models become selectable via a dropdown. Can either be a list of names or the names mapped to descriptions to display in the dropdown. | +| `default_text` | str | Default text to analyze on load. Defaults to `""`. | +| `default_model` | Optional[str] | Optional name of default model. If not set, the first model in the list of `models` is used. | +| `visualizers` | List[str] | Names of visualizers to show. Defaults to `["parser", "ner", "textcat", "similarity", "tokens"]`. | +| `ner_labels` | Optional[List[str]] | NER labels to include. If not set, all labels present in the `"ner"` pipeline component will be used. | +| `ner_attrs` | List[str] | Span attributes shown in table of named entities. See [`visualizer.py`](spacy_streamlit/visualizer.py) for defaults. | +| `token_attrs` | List[str] | Token attributes to show in token visualizer. See [`visualizer.py`](spacy_streamlit/visualizer.py) for defaults. | +| `similarity_texts` | Tuple[str, str] | The default texts to compare in the similarity visualizer. Defaults to `("apple", "orange")`. | +| `show_json_doc` | bool | Show button to toggle JSON representation of the `Doc`. Defaults to `True`. | +| `show_meta` | bool | Show button to toggle `meta.json` of the current pipeline. Defaults to `True`. | +| `show_config` | bool | Show button to toggle `config.cfg` of the current pipeline. Defaults to `True`. | +| `show_visualizer_select` | bool | Show sidebar dropdown to select visualizers to display (based on enabled visualizers). Defaults to `False`. | +| `sidebar_title` | Optional[str] | Title shown in the sidebar. Defaults to `None`. | +| `sidebar_description` | Optional[str] | Description shown in the sidebar. Accepts Markdown-formatted text. | +| `show_logo` | bool | Show the spaCy logo in the sidebar. Defaults to `True`. | +| `color` | Optional[str] | Experimental: Primary color to use for some of the main UI elements (`None` to disable hack). Defaults to `"#09A3D5"`. | +| `get_default_text` | Callable[[Language], str] | Optional callable that takes the currently loaded `nlp` object and returns the default text. Can be used to provide language-specific default texts. If the function returns `None`, the value of `default_text` is used, if available. Defaults to `None`. | + +#### <kbd>function</kbd> `visualize_parser` + +Visualize the dependency parse and part-of-speech tags using spaCy's +[`displacy` visualizer](https://spacy.io/usage/visualizers). + +```python +import spacy +from spacy_streamlit import visualize_parser + +nlp = spacy.load("en_core_web_sm") +doc = nlp("This is a text") +visualize_parser(doc) +``` + +| Argument | Type | Description | +| ------------------ | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `doc` | `Doc` | The spaCy `Doc` object to visualize. | +| _keyword-only_ | | | +| `title` | Optional[str] | Title of the visualizer block. | +| `key` | Optional[str] | Key used for the streamlit component for selecting labels. | +| `manual` | bool | Flag signifying whether the doc argument is a Doc object or a List of Dicts containing parse information. | +| `displacy_optoins` | Optional[Dict] | Dictionary of options to be passed to the displacy render method for generating the HTML to be rendered. See: https://spacy.io/api/top-level#options-dep | + +#### <kbd>function</kbd> `visualize_ner` + +Visualize the named entities in a `Doc` using spaCy's +[`displacy` visualizer](https://spacy.io/usage/visualizers). + +```python +import spacy +from spacy_streamlit import visualize_ner + +nlp = spacy.load("en_core_web_sm") +doc = nlp("Sundar Pichai is the CEO of Google.") +visualize_ner(doc, labels=nlp.get_pipe("ner").labels) +``` + +| Argument | Type | Description | +| ------------------ | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `doc` | `Doc` | The spaCy `Doc` object to visualize. | +| _keyword-only_ | | | +| `labels` | Sequence[str] | The labels to show in the labels dropdown. | +| `attrs` | List[str] | The span attributes to show in entity table. | +| `show_table` | bool | Whether to show a table of entities and their attributes. Defaults to `True`. | +| `title` | Optional[str] | Title of the visualizer block. | +| `colors` | Dict[str,str] | Dictionary of colors for the entity spans to visualize, with keys as labels and corresponding colors as the values. This argument will be deprecated soon. In future the colors arg need to be passed in the `displacy_options` arg with the key "colors".) | +| `key` | Optional[str] | Key used for the streamlit component for selecting labels. | +| `manual` | bool | Flag signifying whether the doc argument is a Doc object or a List of Dicts containing entity span | +| information. | +| `displacy_options` | Optional[Dict] | Dictionary of options to be passed to the displacy render method for generating the HTML to be rendered. See https://spacy.io/api/top-level#displacy_options-ent. | + + +#### <kbd>function</kbd> `visualize_spans` + +Visualize spans in a `Doc` using spaCy's +[`displacy` visualizer](https://spacy.io/usage/visualizers). + +```python +import spacy +from spacy_streamlit import visualize_spans + +nlp = spacy.load("en_core_web_sm") +doc = nlp("Sundar Pichai is the CEO of Google.") +span = doc[4:7] # CEO of Google +span.label_ = "CEO" +doc.spans["job_role"] = [span] +visualize_spans(doc, spans_key="job_role", displacy_options={"colors": {"CEO": "#09a3d5"}}) +``` + +| Argument | Type | Description | +| ------------------ | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `doc` | `Doc` | The spaCy `Doc` object to visualize. | +| _keyword-only_ | | | +| `spans_key` | Sequence[str] | Which spans key to render spans from. Default is "sc". | +| `attrs` | List[str] | The attributes on the entity Span to be labeled. Attributes are displayed only when the `show_table` argument is True. | +| `show_table` | bool | Whether to show a table of spans and their attributes. Defaults to `True`. | +| `title` | Optional[str] | Title of the visualizer block. | +| `manual` | bool | Flag signifying whether the doc argument is a Doc object or a List of Dicts containing entity span information. | +| `displacy_options` | Optional[Dict] | Dictionary of options to be passed to the displacy render method for generating the HTML to be rendered. See https://spacy.io/api/top-level#displacy_options-span. | + + +#### <kbd>function</kbd> `visualize_textcat` + +Visualize text categories predicted by a trained text classifier. + +```python +import spacy +from spacy_streamlit import visualize_textcat + +nlp = spacy.load("./my_textcat_model") +doc = nlp("This is a text about a topic") +visualize_textcat(doc) +``` + +| Argument | Type | Description | +| -------------- | ------------- | ------------------------------------ | +| `doc` | `Doc` | The spaCy `Doc` object to visualize. | +| _keyword-only_ | | | +| `title` | Optional[str] | Title of the visualizer block. | + +#### `visualize_similarity` + +Visualize semantic similarity using the model's word vectors. Will show a +warning if no vectors are present in the model. + +```python +import spacy +from spacy_streamlit import visualize_similarity + +nlp = spacy.load("en_core_web_lg") +visualize_similarity(nlp, ("pizza", "fries")) +``` + +| Argument | Type | Description | +| --------------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | +| `nlp` | `Language` | The loaded `nlp` object with vectors. | +| `default_texts` | Tuple[str, str] | The default texts to compare on load. Defaults to `("apple", "orange")`. | +| _keyword-only_ | | | +| `threshold` | float | Threshold for what's considered "similar". If the similarity score is greater than the threshold, the result is shown as similar. Defaults to `0.5`. | +| `title` | Optional[str] | Title of the visualizer block. | + +#### <kbd>function</kbd> `visualize_tokens` + +Visualize the tokens in a `Doc` and their attributes. + +```python +import spacy +from spacy_streamlit import visualize_tokens + +nlp = spacy.load("en_core_web_sm") +doc = nlp("This is a text") +visualize_tokens(doc, attrs=["text", "pos_", "dep_", "ent_type_"]) +``` + +| Argument | Type | Description | +| -------------- | ------------- | -------------------------------------------------------------------------------------------------------- | +| `doc` | `Doc` | The spaCy `Doc` object to visualize. | +| _keyword-only_ | | | +| `attrs` | List[str] | The names of token attributes to use. See [`visualizer.py`](spacy_streamlit/visualizer.py) for defaults. | +| `title` | Optional[str] | Title of the visualizer block. | + +### Cached helpers + +These helpers attempt to cache loaded models and created `Doc` objects. + +#### <kbd>function</kbd> `process_text` + +Process a text with a model of a given name and create a `Doc` object. Calls +into the `load_model` helper to load the model. + +```python +import streamlit as st +from spacy_streamlit import process_text + +spacy_model = st.sidebar.selectbox("Model name", ["en_core_web_sm", "en_core_web_md"]) +text = st.text_area("Text to analyze", "This is a text") +doc = process_text(spacy_model, text) +``` + +| Argument | Type | Description | +| ------------ | ----- | ------------------------------------------------------- | +| `model_name` | str | Loadable spaCy model name. Can be path or package name. | +| `text` | str | The text to process. | +| **RETURNS** | `Doc` | The processed document. | + +#### <kbd>function</kbd> `load_model` + +Load a spaCy model from a path or installed package and return a loaded `nlp` +object. + +```python +import streamlit as st +from spacy_streamlit import load_model + +spacy_model = st.sidebar.selectbox("Model name", ["en_core_web_sm", "en_core_web_md"]) +nlp = load_model(spacy_model) +``` + +| Argument | Type | Description | +| ----------- | ---------- | ------------------------------------------------------- | +| `name` | str | Loadable spaCy model name. Can be path or package name. | +| **RETURNS** | `Language` | The loaded `nlp` object. | + + +%package -n python3-spacy-streamlit +Summary: Visualize spaCy with streamlit +Provides: python-spacy-streamlit +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-spacy-streamlit +<a href="https://explosion.ai"><img src="https://explosion.ai/assets/img/logo.svg" width="125" height="125" align="right" /></a> + +# spacy-streamlit: spaCy building blocks for Streamlit apps + +This package contains utilities for visualizing [spaCy](https://spacy.io) models +and building interactive spaCy-powered apps with +[Streamlit](https://streamlit.io). It includes various building blocks you can +use in your own Streamlit app, like visualizers for **syntactic dependencies**, +**named entities**, **text classification**, **semantic similarity** via word +vectors, token attributes, and more. + +[](https://github.com/explosion/spacy-streamlit/releases) +[](https://pypi.org/project/spacy-streamlit/) + +<img width="50%" align="right" src="https://user-images.githubusercontent.com/13643239/85388081-f2da8700-b545-11ea-9bd4-e303d3c5763c.png"> + +## 🚀 Quickstart + +You can install `spacy-streamlit` from pip: + +```bash +pip install spacy-streamlit +``` + +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. + +Download the English model from spaCy to get started. + +```bash +python -m spacy download en_core_web_sm +``` + +Then put the following example code in a file. + +```python +# streamlit_app.py +import spacy_streamlit + +models = ["en_core_web_sm", "en_core_web_md"] +default_text = "Sundar Pichai is the CEO of Google." +spacy_streamlit.visualize(models, default_text) +``` + +You can then run your app with `streamlit run streamlit_app.py`. The app should +pop up in your web browser. 😀 + +#### 📦 Example: [`01_out-of-the-box.py`](examples/01_out-of-the-box.py) + +Use the embedded visualizer with custom settings out-of-the-box. + +```bash +streamlit run https://raw.githubusercontent.com/explosion/spacy-streamlit/master/examples/01_out-of-the-box.py +``` + +#### 👑 Example: [`02_custom.py`](examples/02_custom.py) + +Use individual components in your existing app. + +```bash +streamlit run https://raw.githubusercontent.com/explosion/spacy-streamlit/master/examples/02_custom.py +``` + +## 🎛 API + +### Visualizer components + +These functions can be used in your Streamlit app. They call into `streamlit` +under the hood and set up the required elements. + +#### <kbd>function</kbd> `visualize` + +Embed the full visualizer with selected components. + +```python +import spacy_streamlit + +models = ["en_core_web_sm", "/path/to/model"] +default_text = "Sundar Pichai is the CEO of Google." +visualizers = ["ner", "textcat"] +spacy_streamlit.visualize(models, default_text, visualizers) +``` + +| Argument | Type | Description | +| ------------------------ | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `models` | List[str] / Dict[str, str] | Names of loadable spaCy models (paths or package names). The models become selectable via a dropdown. Can either be a list of names or the names mapped to descriptions to display in the dropdown. | +| `default_text` | str | Default text to analyze on load. Defaults to `""`. | +| `default_model` | Optional[str] | Optional name of default model. If not set, the first model in the list of `models` is used. | +| `visualizers` | List[str] | Names of visualizers to show. Defaults to `["parser", "ner", "textcat", "similarity", "tokens"]`. | +| `ner_labels` | Optional[List[str]] | NER labels to include. If not set, all labels present in the `"ner"` pipeline component will be used. | +| `ner_attrs` | List[str] | Span attributes shown in table of named entities. See [`visualizer.py`](spacy_streamlit/visualizer.py) for defaults. | +| `token_attrs` | List[str] | Token attributes to show in token visualizer. See [`visualizer.py`](spacy_streamlit/visualizer.py) for defaults. | +| `similarity_texts` | Tuple[str, str] | The default texts to compare in the similarity visualizer. Defaults to `("apple", "orange")`. | +| `show_json_doc` | bool | Show button to toggle JSON representation of the `Doc`. Defaults to `True`. | +| `show_meta` | bool | Show button to toggle `meta.json` of the current pipeline. Defaults to `True`. | +| `show_config` | bool | Show button to toggle `config.cfg` of the current pipeline. Defaults to `True`. | +| `show_visualizer_select` | bool | Show sidebar dropdown to select visualizers to display (based on enabled visualizers). Defaults to `False`. | +| `sidebar_title` | Optional[str] | Title shown in the sidebar. Defaults to `None`. | +| `sidebar_description` | Optional[str] | Description shown in the sidebar. Accepts Markdown-formatted text. | +| `show_logo` | bool | Show the spaCy logo in the sidebar. Defaults to `True`. | +| `color` | Optional[str] | Experimental: Primary color to use for some of the main UI elements (`None` to disable hack). Defaults to `"#09A3D5"`. | +| `get_default_text` | Callable[[Language], str] | Optional callable that takes the currently loaded `nlp` object and returns the default text. Can be used to provide language-specific default texts. If the function returns `None`, the value of `default_text` is used, if available. Defaults to `None`. | + +#### <kbd>function</kbd> `visualize_parser` + +Visualize the dependency parse and part-of-speech tags using spaCy's +[`displacy` visualizer](https://spacy.io/usage/visualizers). + +```python +import spacy +from spacy_streamlit import visualize_parser + +nlp = spacy.load("en_core_web_sm") +doc = nlp("This is a text") +visualize_parser(doc) +``` + +| Argument | Type | Description | +| ------------------ | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `doc` | `Doc` | The spaCy `Doc` object to visualize. | +| _keyword-only_ | | | +| `title` | Optional[str] | Title of the visualizer block. | +| `key` | Optional[str] | Key used for the streamlit component for selecting labels. | +| `manual` | bool | Flag signifying whether the doc argument is a Doc object or a List of Dicts containing parse information. | +| `displacy_optoins` | Optional[Dict] | Dictionary of options to be passed to the displacy render method for generating the HTML to be rendered. See: https://spacy.io/api/top-level#options-dep | + +#### <kbd>function</kbd> `visualize_ner` + +Visualize the named entities in a `Doc` using spaCy's +[`displacy` visualizer](https://spacy.io/usage/visualizers). + +```python +import spacy +from spacy_streamlit import visualize_ner + +nlp = spacy.load("en_core_web_sm") +doc = nlp("Sundar Pichai is the CEO of Google.") +visualize_ner(doc, labels=nlp.get_pipe("ner").labels) +``` + +| Argument | Type | Description | +| ------------------ | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `doc` | `Doc` | The spaCy `Doc` object to visualize. | +| _keyword-only_ | | | +| `labels` | Sequence[str] | The labels to show in the labels dropdown. | +| `attrs` | List[str] | The span attributes to show in entity table. | +| `show_table` | bool | Whether to show a table of entities and their attributes. Defaults to `True`. | +| `title` | Optional[str] | Title of the visualizer block. | +| `colors` | Dict[str,str] | Dictionary of colors for the entity spans to visualize, with keys as labels and corresponding colors as the values. This argument will be deprecated soon. In future the colors arg need to be passed in the `displacy_options` arg with the key "colors".) | +| `key` | Optional[str] | Key used for the streamlit component for selecting labels. | +| `manual` | bool | Flag signifying whether the doc argument is a Doc object or a List of Dicts containing entity span | +| information. | +| `displacy_options` | Optional[Dict] | Dictionary of options to be passed to the displacy render method for generating the HTML to be rendered. See https://spacy.io/api/top-level#displacy_options-ent. | + + +#### <kbd>function</kbd> `visualize_spans` + +Visualize spans in a `Doc` using spaCy's +[`displacy` visualizer](https://spacy.io/usage/visualizers). + +```python +import spacy +from spacy_streamlit import visualize_spans + +nlp = spacy.load("en_core_web_sm") +doc = nlp("Sundar Pichai is the CEO of Google.") +span = doc[4:7] # CEO of Google +span.label_ = "CEO" +doc.spans["job_role"] = [span] +visualize_spans(doc, spans_key="job_role", displacy_options={"colors": {"CEO": "#09a3d5"}}) +``` + +| Argument | Type | Description | +| ------------------ | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `doc` | `Doc` | The spaCy `Doc` object to visualize. | +| _keyword-only_ | | | +| `spans_key` | Sequence[str] | Which spans key to render spans from. Default is "sc". | +| `attrs` | List[str] | The attributes on the entity Span to be labeled. Attributes are displayed only when the `show_table` argument is True. | +| `show_table` | bool | Whether to show a table of spans and their attributes. Defaults to `True`. | +| `title` | Optional[str] | Title of the visualizer block. | +| `manual` | bool | Flag signifying whether the doc argument is a Doc object or a List of Dicts containing entity span information. | +| `displacy_options` | Optional[Dict] | Dictionary of options to be passed to the displacy render method for generating the HTML to be rendered. See https://spacy.io/api/top-level#displacy_options-span. | + + +#### <kbd>function</kbd> `visualize_textcat` + +Visualize text categories predicted by a trained text classifier. + +```python +import spacy +from spacy_streamlit import visualize_textcat + +nlp = spacy.load("./my_textcat_model") +doc = nlp("This is a text about a topic") +visualize_textcat(doc) +``` + +| Argument | Type | Description | +| -------------- | ------------- | ------------------------------------ | +| `doc` | `Doc` | The spaCy `Doc` object to visualize. | +| _keyword-only_ | | | +| `title` | Optional[str] | Title of the visualizer block. | + +#### `visualize_similarity` + +Visualize semantic similarity using the model's word vectors. Will show a +warning if no vectors are present in the model. + +```python +import spacy +from spacy_streamlit import visualize_similarity + +nlp = spacy.load("en_core_web_lg") +visualize_similarity(nlp, ("pizza", "fries")) +``` + +| Argument | Type | Description | +| --------------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | +| `nlp` | `Language` | The loaded `nlp` object with vectors. | +| `default_texts` | Tuple[str, str] | The default texts to compare on load. Defaults to `("apple", "orange")`. | +| _keyword-only_ | | | +| `threshold` | float | Threshold for what's considered "similar". If the similarity score is greater than the threshold, the result is shown as similar. Defaults to `0.5`. | +| `title` | Optional[str] | Title of the visualizer block. | + +#### <kbd>function</kbd> `visualize_tokens` + +Visualize the tokens in a `Doc` and their attributes. + +```python +import spacy +from spacy_streamlit import visualize_tokens + +nlp = spacy.load("en_core_web_sm") +doc = nlp("This is a text") +visualize_tokens(doc, attrs=["text", "pos_", "dep_", "ent_type_"]) +``` + +| Argument | Type | Description | +| -------------- | ------------- | -------------------------------------------------------------------------------------------------------- | +| `doc` | `Doc` | The spaCy `Doc` object to visualize. | +| _keyword-only_ | | | +| `attrs` | List[str] | The names of token attributes to use. See [`visualizer.py`](spacy_streamlit/visualizer.py) for defaults. | +| `title` | Optional[str] | Title of the visualizer block. | + +### Cached helpers + +These helpers attempt to cache loaded models and created `Doc` objects. + +#### <kbd>function</kbd> `process_text` + +Process a text with a model of a given name and create a `Doc` object. Calls +into the `load_model` helper to load the model. + +```python +import streamlit as st +from spacy_streamlit import process_text + +spacy_model = st.sidebar.selectbox("Model name", ["en_core_web_sm", "en_core_web_md"]) +text = st.text_area("Text to analyze", "This is a text") +doc = process_text(spacy_model, text) +``` + +| Argument | Type | Description | +| ------------ | ----- | ------------------------------------------------------- | +| `model_name` | str | Loadable spaCy model name. Can be path or package name. | +| `text` | str | The text to process. | +| **RETURNS** | `Doc` | The processed document. | + +#### <kbd>function</kbd> `load_model` + +Load a spaCy model from a path or installed package and return a loaded `nlp` +object. + +```python +import streamlit as st +from spacy_streamlit import load_model + +spacy_model = st.sidebar.selectbox("Model name", ["en_core_web_sm", "en_core_web_md"]) +nlp = load_model(spacy_model) +``` + +| Argument | Type | Description | +| ----------- | ---------- | ------------------------------------------------------- | +| `name` | str | Loadable spaCy model name. Can be path or package name. | +| **RETURNS** | `Language` | The loaded `nlp` object. | + + +%package help +Summary: Development documents and examples for spacy-streamlit +Provides: python3-spacy-streamlit-doc +%description help +<a href="https://explosion.ai"><img src="https://explosion.ai/assets/img/logo.svg" width="125" height="125" align="right" /></a> + +# spacy-streamlit: spaCy building blocks for Streamlit apps + +This package contains utilities for visualizing [spaCy](https://spacy.io) models +and building interactive spaCy-powered apps with +[Streamlit](https://streamlit.io). It includes various building blocks you can +use in your own Streamlit app, like visualizers for **syntactic dependencies**, +**named entities**, **text classification**, **semantic similarity** via word +vectors, token attributes, and more. + +[](https://github.com/explosion/spacy-streamlit/releases) +[](https://pypi.org/project/spacy-streamlit/) + +<img width="50%" align="right" src="https://user-images.githubusercontent.com/13643239/85388081-f2da8700-b545-11ea-9bd4-e303d3c5763c.png"> + +## 🚀 Quickstart + +You can install `spacy-streamlit` from pip: + +```bash +pip install spacy-streamlit +``` + +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. + +Download the English model from spaCy to get started. + +```bash +python -m spacy download en_core_web_sm +``` + +Then put the following example code in a file. + +```python +# streamlit_app.py +import spacy_streamlit + +models = ["en_core_web_sm", "en_core_web_md"] +default_text = "Sundar Pichai is the CEO of Google." +spacy_streamlit.visualize(models, default_text) +``` + +You can then run your app with `streamlit run streamlit_app.py`. The app should +pop up in your web browser. 😀 + +#### 📦 Example: [`01_out-of-the-box.py`](examples/01_out-of-the-box.py) + +Use the embedded visualizer with custom settings out-of-the-box. + +```bash +streamlit run https://raw.githubusercontent.com/explosion/spacy-streamlit/master/examples/01_out-of-the-box.py +``` + +#### 👑 Example: [`02_custom.py`](examples/02_custom.py) + +Use individual components in your existing app. + +```bash +streamlit run https://raw.githubusercontent.com/explosion/spacy-streamlit/master/examples/02_custom.py +``` + +## 🎛 API + +### Visualizer components + +These functions can be used in your Streamlit app. They call into `streamlit` +under the hood and set up the required elements. + +#### <kbd>function</kbd> `visualize` + +Embed the full visualizer with selected components. + +```python +import spacy_streamlit + +models = ["en_core_web_sm", "/path/to/model"] +default_text = "Sundar Pichai is the CEO of Google." +visualizers = ["ner", "textcat"] +spacy_streamlit.visualize(models, default_text, visualizers) +``` + +| Argument | Type | Description | +| ------------------------ | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `models` | List[str] / Dict[str, str] | Names of loadable spaCy models (paths or package names). The models become selectable via a dropdown. Can either be a list of names or the names mapped to descriptions to display in the dropdown. | +| `default_text` | str | Default text to analyze on load. Defaults to `""`. | +| `default_model` | Optional[str] | Optional name of default model. If not set, the first model in the list of `models` is used. | +| `visualizers` | List[str] | Names of visualizers to show. Defaults to `["parser", "ner", "textcat", "similarity", "tokens"]`. | +| `ner_labels` | Optional[List[str]] | NER labels to include. If not set, all labels present in the `"ner"` pipeline component will be used. | +| `ner_attrs` | List[str] | Span attributes shown in table of named entities. See [`visualizer.py`](spacy_streamlit/visualizer.py) for defaults. | +| `token_attrs` | List[str] | Token attributes to show in token visualizer. See [`visualizer.py`](spacy_streamlit/visualizer.py) for defaults. | +| `similarity_texts` | Tuple[str, str] | The default texts to compare in the similarity visualizer. Defaults to `("apple", "orange")`. | +| `show_json_doc` | bool | Show button to toggle JSON representation of the `Doc`. Defaults to `True`. | +| `show_meta` | bool | Show button to toggle `meta.json` of the current pipeline. Defaults to `True`. | +| `show_config` | bool | Show button to toggle `config.cfg` of the current pipeline. Defaults to `True`. | +| `show_visualizer_select` | bool | Show sidebar dropdown to select visualizers to display (based on enabled visualizers). Defaults to `False`. | +| `sidebar_title` | Optional[str] | Title shown in the sidebar. Defaults to `None`. | +| `sidebar_description` | Optional[str] | Description shown in the sidebar. Accepts Markdown-formatted text. | +| `show_logo` | bool | Show the spaCy logo in the sidebar. Defaults to `True`. | +| `color` | Optional[str] | Experimental: Primary color to use for some of the main UI elements (`None` to disable hack). Defaults to `"#09A3D5"`. | +| `get_default_text` | Callable[[Language], str] | Optional callable that takes the currently loaded `nlp` object and returns the default text. Can be used to provide language-specific default texts. If the function returns `None`, the value of `default_text` is used, if available. Defaults to `None`. | + +#### <kbd>function</kbd> `visualize_parser` + +Visualize the dependency parse and part-of-speech tags using spaCy's +[`displacy` visualizer](https://spacy.io/usage/visualizers). + +```python +import spacy +from spacy_streamlit import visualize_parser + +nlp = spacy.load("en_core_web_sm") +doc = nlp("This is a text") +visualize_parser(doc) +``` + +| Argument | Type | Description | +| ------------------ | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `doc` | `Doc` | The spaCy `Doc` object to visualize. | +| _keyword-only_ | | | +| `title` | Optional[str] | Title of the visualizer block. | +| `key` | Optional[str] | Key used for the streamlit component for selecting labels. | +| `manual` | bool | Flag signifying whether the doc argument is a Doc object or a List of Dicts containing parse information. | +| `displacy_optoins` | Optional[Dict] | Dictionary of options to be passed to the displacy render method for generating the HTML to be rendered. See: https://spacy.io/api/top-level#options-dep | + +#### <kbd>function</kbd> `visualize_ner` + +Visualize the named entities in a `Doc` using spaCy's +[`displacy` visualizer](https://spacy.io/usage/visualizers). + +```python +import spacy +from spacy_streamlit import visualize_ner + +nlp = spacy.load("en_core_web_sm") +doc = nlp("Sundar Pichai is the CEO of Google.") +visualize_ner(doc, labels=nlp.get_pipe("ner").labels) +``` + +| Argument | Type | Description | +| ------------------ | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | +| `doc` | `Doc` | The spaCy `Doc` object to visualize. | +| _keyword-only_ | | | +| `labels` | Sequence[str] | The labels to show in the labels dropdown. | +| `attrs` | List[str] | The span attributes to show in entity table. | +| `show_table` | bool | Whether to show a table of entities and their attributes. Defaults to `True`. | +| `title` | Optional[str] | Title of the visualizer block. | +| `colors` | Dict[str,str] | Dictionary of colors for the entity spans to visualize, with keys as labels and corresponding colors as the values. This argument will be deprecated soon. In future the colors arg need to be passed in the `displacy_options` arg with the key "colors".) | +| `key` | Optional[str] | Key used for the streamlit component for selecting labels. | +| `manual` | bool | Flag signifying whether the doc argument is a Doc object or a List of Dicts containing entity span | +| information. | +| `displacy_options` | Optional[Dict] | Dictionary of options to be passed to the displacy render method for generating the HTML to be rendered. See https://spacy.io/api/top-level#displacy_options-ent. | + + +#### <kbd>function</kbd> `visualize_spans` + +Visualize spans in a `Doc` using spaCy's +[`displacy` visualizer](https://spacy.io/usage/visualizers). + +```python +import spacy +from spacy_streamlit import visualize_spans + +nlp = spacy.load("en_core_web_sm") +doc = nlp("Sundar Pichai is the CEO of Google.") +span = doc[4:7] # CEO of Google +span.label_ = "CEO" +doc.spans["job_role"] = [span] +visualize_spans(doc, spans_key="job_role", displacy_options={"colors": {"CEO": "#09a3d5"}}) +``` + +| Argument | Type | Description | +| ------------------ | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | +| `doc` | `Doc` | The spaCy `Doc` object to visualize. | +| _keyword-only_ | | | +| `spans_key` | Sequence[str] | Which spans key to render spans from. Default is "sc". | +| `attrs` | List[str] | The attributes on the entity Span to be labeled. Attributes are displayed only when the `show_table` argument is True. | +| `show_table` | bool | Whether to show a table of spans and their attributes. Defaults to `True`. | +| `title` | Optional[str] | Title of the visualizer block. | +| `manual` | bool | Flag signifying whether the doc argument is a Doc object or a List of Dicts containing entity span information. | +| `displacy_options` | Optional[Dict] | Dictionary of options to be passed to the displacy render method for generating the HTML to be rendered. See https://spacy.io/api/top-level#displacy_options-span. | + + +#### <kbd>function</kbd> `visualize_textcat` + +Visualize text categories predicted by a trained text classifier. + +```python +import spacy +from spacy_streamlit import visualize_textcat + +nlp = spacy.load("./my_textcat_model") +doc = nlp("This is a text about a topic") +visualize_textcat(doc) +``` + +| Argument | Type | Description | +| -------------- | ------------- | ------------------------------------ | +| `doc` | `Doc` | The spaCy `Doc` object to visualize. | +| _keyword-only_ | | | +| `title` | Optional[str] | Title of the visualizer block. | + +#### `visualize_similarity` + +Visualize semantic similarity using the model's word vectors. Will show a +warning if no vectors are present in the model. + +```python +import spacy +from spacy_streamlit import visualize_similarity + +nlp = spacy.load("en_core_web_lg") +visualize_similarity(nlp, ("pizza", "fries")) +``` + +| Argument | Type | Description | +| --------------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- | +| `nlp` | `Language` | The loaded `nlp` object with vectors. | +| `default_texts` | Tuple[str, str] | The default texts to compare on load. Defaults to `("apple", "orange")`. | +| _keyword-only_ | | | +| `threshold` | float | Threshold for what's considered "similar". If the similarity score is greater than the threshold, the result is shown as similar. Defaults to `0.5`. | +| `title` | Optional[str] | Title of the visualizer block. | + +#### <kbd>function</kbd> `visualize_tokens` + +Visualize the tokens in a `Doc` and their attributes. + +```python +import spacy +from spacy_streamlit import visualize_tokens + +nlp = spacy.load("en_core_web_sm") +doc = nlp("This is a text") +visualize_tokens(doc, attrs=["text", "pos_", "dep_", "ent_type_"]) +``` + +| Argument | Type | Description | +| -------------- | ------------- | -------------------------------------------------------------------------------------------------------- | +| `doc` | `Doc` | The spaCy `Doc` object to visualize. | +| _keyword-only_ | | | +| `attrs` | List[str] | The names of token attributes to use. See [`visualizer.py`](spacy_streamlit/visualizer.py) for defaults. | +| `title` | Optional[str] | Title of the visualizer block. | + +### Cached helpers + +These helpers attempt to cache loaded models and created `Doc` objects. + +#### <kbd>function</kbd> `process_text` + +Process a text with a model of a given name and create a `Doc` object. Calls +into the `load_model` helper to load the model. + +```python +import streamlit as st +from spacy_streamlit import process_text + +spacy_model = st.sidebar.selectbox("Model name", ["en_core_web_sm", "en_core_web_md"]) +text = st.text_area("Text to analyze", "This is a text") +doc = process_text(spacy_model, text) +``` + +| Argument | Type | Description | +| ------------ | ----- | ------------------------------------------------------- | +| `model_name` | str | Loadable spaCy model name. Can be path or package name. | +| `text` | str | The text to process. | +| **RETURNS** | `Doc` | The processed document. | + +#### <kbd>function</kbd> `load_model` + +Load a spaCy model from a path or installed package and return a loaded `nlp` +object. + +```python +import streamlit as st +from spacy_streamlit import load_model + +spacy_model = st.sidebar.selectbox("Model name", ["en_core_web_sm", "en_core_web_md"]) +nlp = load_model(spacy_model) +``` + +| Argument | Type | Description | +| ----------- | ---------- | ------------------------------------------------------- | +| `name` | str | Loadable spaCy model name. Can be path or package name. | +| **RETURNS** | `Language` | The loaded `nlp` object. | + + +%prep +%autosetup -n spacy-streamlit-1.0.6 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-spacy-streamlit -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Wed May 31 2023 Python_Bot <Python_Bot@openeuler.org> - 1.0.6-1 +- Package Spec generated @@ -0,0 +1 @@ +ccfebd9ada8c12e875e48733d56f709f spacy_streamlit-1.0.6.tar.gz |