Prerelease 1.26.0 (#780)

sfc-gh-dmatthews · web-flow · commit b2877f0f413c · 2023-08-18T00:03:48.000-07:00
* Update generate.py

Update generate.py to parse StatusContainer.

* Update st.markdown example app

* Add interactive markdown example

* Add st.toggle embedded app source

* Add embedded app source for chart color parameter

* Switch to nightly for prerelease

* Spacing/formatting in app source

* Embedded app source formatting

* Use type parameter in st.button example

* Typesetting consistency

* Revert st.button example app

Moved change to release branch

* Update title, header, subheader example apps

* Add app source for st.status examples
diff --git 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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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 &mdash;\
+            :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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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 = {}
