diff --git a/python/api-examples-source/charts.area_chart.py b/python/api-examples-source/charts.area_chart.py index ed4558fb7..0eed64286 100644 --- a/python/api-examples-source/charts.area_chart.py +++ b/python/api-examples-source/charts.area_chart.py @@ -5,7 +5,9 @@ @st.cache_data def load_data(): - df = pd.DataFrame(np.random.randn(20, 3), columns=["a", "b", "c"]) + df = pd.DataFrame( + np.random.randn(20, 3), + columns = ['a', 'b', 'c']) return df diff --git a/python/api-examples-source/charts.area_chart1.py b/python/api-examples-source/charts.area_chart1.py new file mode 100644 index 000000000..c33c9730e --- /dev/null +++ b/python/api-examples-source/charts.area_chart1.py @@ -0,0 +1,23 @@ +import numpy as np +import pandas as pd +import streamlit as st + + +@st.cache_data +def load_data(): + df = pd.DataFrame({ + 'col1' : np.random.randn(20), + 'col2' : np.random.randn(20), + 'col3' : np.random.choice(['A','B','C'], 20) + }) + return df + + +chart_data = load_data() + +st.area_chart( + chart_data, + x = 'col1', + y = 'col2', + color = 'col3' +) diff --git a/python/api-examples-source/charts.area_chart2.py b/python/api-examples-source/charts.area_chart2.py new file mode 100644 index 000000000..507deb396 --- /dev/null +++ b/python/api-examples-source/charts.area_chart2.py @@ -0,0 +1,21 @@ +import numpy as np +import pandas as pd +import streamlit as st + + +@st.cache_data +def load_data(): + df = pd.DataFrame( + np.random.randn(20, 3), + columns = ['col1', 'col2', 'col3']) + return df + + +chart_data = load_data() + +st.area_chart( + chart_data, + x = 'col1', + y = ['col2', 'col3'], + color = ['#FF0000', '#0000FF'] # Optional +) diff --git a/python/api-examples-source/charts.bar_chart.py b/python/api-examples-source/charts.bar_chart.py index 5f82a6a0d..07dfd2592 100644 --- a/python/api-examples-source/charts.bar_chart.py +++ b/python/api-examples-source/charts.bar_chart.py @@ -5,7 +5,9 @@ @st.cache_data def load_data(): - df = pd.DataFrame(np.random.randn(50, 3), columns=["a", "b", "c"]) + df = pd.DataFrame( + np.random.randn(50, 3), + columns = ["a", "b", "c"]) return df diff --git a/python/api-examples-source/charts.bar_chart1.py b/python/api-examples-source/charts.bar_chart1.py new file mode 100644 index 000000000..0807cfe41 --- /dev/null +++ b/python/api-examples-source/charts.bar_chart1.py @@ -0,0 +1,23 @@ +import numpy as np +import pandas as pd +import streamlit as st + + +@st.cache_data +def load_data(): + df = pd.DataFrame({ + 'col1' : list(range(20))*3, + 'col2' : np.random.randn(60), + 'col3' : ['A']*20 + ['B']*20 + ['C']*20 + }) + return df + + +chart_data = load_data() + +st.bar_chart( + chart_data, + x = 'col1', + y = 'col2', + color = 'col3' +) diff --git a/python/api-examples-source/charts.bar_chart2.py b/python/api-examples-source/charts.bar_chart2.py new file mode 100644 index 000000000..c56585305 --- /dev/null +++ b/python/api-examples-source/charts.bar_chart2.py @@ -0,0 +1,23 @@ +import numpy as np +import pandas as pd +import streamlit as st + + +@st.cache_data +def load_data(): + df = pd.DataFrame({ + 'col1' : list(range(20)), + 'col2' : np.random.randn(20), + 'col3' : np.random.randn(20) + }) + return df + + +chart_data = load_data() + +st.bar_chart( + chart_data, + x = 'col1', + y = ['col2', 'col3'], + color = ['#FF0000', '#0000FF'] # Optional +) diff --git a/python/api-examples-source/charts.line_chart.py b/python/api-examples-source/charts.line_chart.py index 387b77374..07dfd8c76 100644 --- a/python/api-examples-source/charts.line_chart.py +++ b/python/api-examples-source/charts.line_chart.py @@ -5,7 +5,9 @@ @st.cache_data def load_data(): - df = pd.DataFrame(np.random.randn(20, 3), columns=["a", "b", "c"]) + df = pd.DataFrame( + np.random.randn(20, 3), + columns = ['a', 'b', 'c']) return df diff --git a/python/api-examples-source/charts.line_chart1.py b/python/api-examples-source/charts.line_chart1.py new file mode 100644 index 000000000..073a5f3b3 --- /dev/null +++ b/python/api-examples-source/charts.line_chart1.py @@ -0,0 +1,23 @@ +import numpy as np +import pandas as pd +import streamlit as st + + +@st.cache_data +def load_data(): + df = pd.DataFrame({ + 'col1' : np.random.randn(20), + 'col2' : np.random.randn(20), + 'col3' : np.random.choice(['A','B','C'], 20) + }) + return df + + +chart_data = load_data() + +st.line_chart( + chart_data, + x = 'col1', + y = 'col2', + color = 'col3' +) diff --git a/python/api-examples-source/charts.line_chart2.py b/python/api-examples-source/charts.line_chart2.py new file mode 100644 index 000000000..09f7ac51d --- /dev/null +++ b/python/api-examples-source/charts.line_chart2.py @@ -0,0 +1,21 @@ +import numpy as np +import pandas as pd +import streamlit as st + + +@st.cache_data +def load_data(): + df = pd.DataFrame( + np.random.randn(20, 3), + columns = ['col1', 'col2', 'col3']) + return df + + +chart_data = load_data() + +st.line_chart( + chart_data, + x = 'col1', + y = ['col2', 'col3'], + color = ['#FF0000', '#0000FF'] # Optional +) diff --git a/python/api-examples-source/requirements.txt b/python/api-examples-source/requirements.txt index c14db3b8a..d53f70e3c 100644 --- a/python/api-examples-source/requirements.txt +++ b/python/api-examples-source/requirements.txt @@ -10,4 +10,4 @@ altair==4.2.0 pydeck==0.8.0 Faker==19.1.0 openai==0.27.8 -streamlit==1.25.0 +streamlit-nightly diff --git a/python/api-examples-source/status.status.py b/python/api-examples-source/status.status.py new file mode 100644 index 000000000..8126b284b --- /dev/null +++ b/python/api-examples-source/status.status.py @@ -0,0 +1,10 @@ +import time +import streamlit as st + +with st.status("Downloading data..."): + st.write("Searching for data...") + time.sleep(2) + st.write("Found URL.") + time.sleep(1) + st.write("Downloading data...") + time.sleep(1) diff --git a/python/api-examples-source/status.status1.py b/python/api-examples-source/status.status1.py new file mode 100644 index 000000000..945ed840a --- /dev/null +++ b/python/api-examples-source/status.status1.py @@ -0,0 +1,11 @@ +import time +import streamlit as st + +with st.status("Downloading data...", expanded=True) as status: + st.write("Searching for data...") + time.sleep(2) + st.write("Found URL.") + time.sleep(1) + st.write("Downloading data...") + time.sleep(1) + status.update(label="Download complete!", state="complete", expanded=False) diff --git a/python/api-examples-source/text.header.py b/python/api-examples-source/text.header.py index ad87d1884..9b65a92fd 100644 --- a/python/api-examples-source/text.header.py +++ b/python/api-examples-source/text.header.py @@ -1,3 +1,4 @@ import streamlit as st -st.header("This is a header") +st.header('This is a header with a divider', divider='rainbow') +st.header('_Streamlit_ is :blue[cool] :sunglasses:') diff --git a/python/api-examples-source/text.markdown.py b/python/api-examples-source/text.markdown.py index b883b0bba..1c8dfd45e 100644 --- a/python/api-examples-source/text.markdown.py +++ b/python/api-examples-source/text.markdown.py @@ -1,3 +1,15 @@ import streamlit as st -st.markdown("Streamlit is **_really_ cool**.") +st.markdown("*Streamlit* is **really** ***cool***.") +st.markdown(""" + :red[Streamlit] :orange[can] :green[write] :blue[text] :violet[in] + :gray[pretty] :rainbow[colors].""") +st.markdown("Here's a bouquet —\ + :tulip::cherry_blossom::rose::hibiscus::sunflower::blossom:") + +multi = '''If you end a line with two spaces, +a soft return is used for the next line. + +Two (or more) newline characters in a row will result in a hard return. +''' +st.markdown(multi) diff --git a/python/api-examples-source/text.markdown1.py b/python/api-examples-source/text.markdown1.py new file mode 100644 index 000000000..cce5a43fa --- /dev/null +++ b/python/api-examples-source/text.markdown1.py @@ -0,0 +1,12 @@ +import streamlit as st + +md = st.text_area('Type in your markdown string (without outer quotes)', + "Happy Streamlit-ing! :balloon:") + +st.code(f""" +import streamlit as st + +st.markdown('''{md}''') +""") + +st.markdown(md) diff --git a/python/api-examples-source/text.subheader.py b/python/api-examples-source/text.subheader.py index 1bec0b1c2..8c86dc882 100644 --- a/python/api-examples-source/text.subheader.py +++ b/python/api-examples-source/text.subheader.py @@ -1,3 +1,4 @@ import streamlit as st -st.subheader("This is a subheader") +st.subheader('This is a subheader with a divider', divider='rainbow') +st.subheader('_Streamlit_ is :blue[cool] :sunglasses:') diff --git a/python/api-examples-source/text.title.py b/python/api-examples-source/text.title.py index 38586b146..73772765f 100644 --- a/python/api-examples-source/text.title.py +++ b/python/api-examples-source/text.title.py @@ -1,3 +1,4 @@ import streamlit as st -st.title("This is a title") +st.title('This is a title') +st.title('_Streamlit_ is :blue[cool] :sunglasses:') diff --git a/python/api-examples-source/widget.toggle.py b/python/api-examples-source/widget.toggle.py new file mode 100644 index 000000000..7ee2a4e45 --- /dev/null +++ b/python/api-examples-source/widget.toggle.py @@ -0,0 +1,6 @@ +import streamlit as st + +on = st.toggle('Activate feature') + +if on: + st.write('Feature activated!') diff --git a/python/generate.py b/python/generate.py index 204ee8477..35003f285 100644 --- a/python/generate.py +++ b/python/generate.py @@ -11,6 +11,7 @@ import docstring_parser import streamlit import streamlit.components.v1 as components +from streamlit.elements.lib.mutable_status_container import StatusContainer from docutils.core import publish_parts from docutils.parsers.rst import directives from numpydoc.docscrape import NumpyDocString @@ -489,6 +490,7 @@ def get_streamlit_docstring_dict(): ], components: ["streamlit.components.v1", "st.components.v1"], streamlit._DeltaGenerator: ["DeltaGenerator", "element"], + StatusContainer: ["StatusContainer", "StatusContainer"] } module_docstring_dict = {}