Update app.py

app.py

@@ -1,9 +1,23 @@
 """
 Streamlit Cheat Sheet
-App to summarise streamlit docs v0.81.0 for quick reference
-There is also an accompanying png version
+
+App to summarise streamlit docs v1.0.0
+
+There is also an accompanying png and pdf version
+
 https://github.com/daniellewisDL/streamlit-cheat-sheet
-v0.71.0 November 2020 Daniel Lewis and Austin Chen
+
+v1.0.0 October 2021
+
+Author:
+    @daniellewisDL : https://github.com/daniellewisDL
+
+Contributors:
+    arnaudmiribel : https://github.com/arnaudmiribel
+    akrolsmir : https://github.com/akrolsmir
+    nathancarter : https://github.com/nathancarter
+    epogrebnyak : https://github.com/epogrebnyak
+
 """
 
 import streamlit as st
@@ -35,10 +49,11 @@ def img_to_bytes(img_path):
 
 def cs_sidebar():
 
-    st.sidebar.header('Streamlit cheat sheet FTW')
+    st.sidebar.markdown('''[<img src='data:image/png;base64,{}' class='img-fluid' width=32 height=32>](https://streamlit.io/)'''.format(img_to_bytes("logomark_website.png")), unsafe_allow_html=True)
+    st.sidebar.header('Streamlit cheat sheet')
 
     st.sidebar.markdown('''
-<small>Summary of the [docs](https://docs.streamlit.io/en/stable/api.html), as of [Streamlit v0.81.0](https://www.streamlit.io/).</small>
+<small>Summary of the [docs](https://docs.streamlit.io/en/stable/api.html), as of [Streamlit v1.0.0](https://www.streamlit.io/).</small>
     ''', unsafe_allow_html=True)
 
     st.sidebar.markdown('__How to install and import__')
@@ -51,7 +66,7 @@ def cs_sidebar():
     st.sidebar.markdown('__Add widgets to sidebar__')
     st.sidebar.code('''
 st.sidebar.<widget>
->>> a = st.sidebar.radio(\\'R:\\',[1,2])
+>>> a = st.sidebar.radio(\'R:\',[1,2])
     ''')
 
     st.sidebar.markdown('__Command line__')
@@ -66,13 +81,13 @@ $ streamlit --version
     ''')
 
     st.sidebar.markdown('__Pre-release features__')
-    st.sidebar.markdown('[Beta and experimental features](https://docs.streamlit.io/en/0.70.0/api.html#beta-and-experimental-features)')
+    st.sidebar.markdown('[Beta and experimental features](https://docs.streamlit.io/en/stable/api.html#beta-and-experimental-features)')
     st.sidebar.code('''
 pip uninstall streamlit
 pip install streamlit-nightly --upgrade
     ''')
 
-    st.sidebar.markdown('''[<img src='data:image/png;base64,{}' class='img-fluid' width=32 height=32>](https://github.com/daniellewisDL/streamlit-cheat-sheet) <small>st.cheat_sheet v0.81.0 | May 2021</small>'''.format(img_to_bytes("brain.png")), unsafe_allow_html=True)
+    st.sidebar.markdown('''<small>[st.cheat_sheet v1.0.0](https://github.com/daniellewisDL/streamlit-cheat-sheet)  | Oct 2021</small>''', unsafe_allow_html=True)
 
     return None
 
@@ -83,11 +98,11 @@ pip install streamlit-nightly --upgrade
 def cs_body():
     # Magic commands
 
-    col1, col2, col3 = st.beta_columns(3)
+    col1, col2, col3 = st.columns(3)
 
     col1.subheader('Magic commands')
     col1.code('''# Magic commands implicitly `st.write()`
-\\'\\'\\' _This_ is some __Markdown__ \\'\\'\\'
+\'\'\' _This_ is some __Markdown__ \'\'\'
 a=3
 'dataframe:', data
     ''')
@@ -98,14 +113,17 @@ a=3
     col1.code('''
 st.text('Fixed width text')
 st.markdown('_Markdown_') # see *
-st.latex(r\\'\\'\\' e^{i\\pi} + 1 = 0 \\'\\'\\')
+st.caption('Balloons. Hundreds of them...')
+st.latex(r\'\'\' e^{i\pi} + 1 = 0 \'\'\')
 st.write('Most objects') # df, err, func, keras!
 st.write(['st', 'is <', 3]) # see *
 st.title('My title')
 st.header('My header')
 st.subheader('My sub')
 st.code('for i in range(8): foo()')
+
 * optional kwarg unsafe_allow_html = True
+
     ''')
 
     # Display data
@@ -115,6 +133,7 @@ st.code('for i in range(8): foo()')
 st.dataframe(my_dataframe)
 st.table(data.iloc[0:10])
 st.json({'foo':'bar','fu':'ba'})
+st.metric(label="Temp", value="273 K", delta="1.2 K")
     ''')
 
     # Display charts
@@ -149,6 +168,7 @@ st.video(data)
     col2.subheader('Display interactive widgets')
     col2.code('''
 st.button('Hit me')
+st.download_button('On the dl', data)
 st.checkbox('Check me out')
 st.radio('Radio', [1,2,3])
 st.selectbox('Select', [1,2,3])
@@ -163,7 +183,7 @@ st.time_input('Time entry')
 st.file_uploader('File uploader')
 st.color_picker('Pick a color')
     ''')
-    col2.write('Use widgets\\' returned values in variables:')
+    col2.write('Use widgets\' returned values in variables:')
     col2.code('''
 >>> for i in range(int(st.number_input('Num:'))): foo()
 >>> if st.sidebar.selectbox('I:',['f']) == 'f': b()
@@ -182,15 +202,23 @@ st.stop()
 
     col2.subheader('Lay out your app')
     col2.code('''
-st.beta_container()
-st.beta_columns(spec)
->>> col1, col2 = st.beta_columns(2)
+st.form('my_form_identifier')
+st.form_submit_button('Submit to me')
+st.container()
+st.columns(spec)
+>>> col1, col2 = st.columns(2)
 >>> col1.subheader('Columnisation')
-st.beta_expander('Expander')
->>> with st.beta_expander('Expand'):
+st.expander('Expander')
+>>> with st.expander('Expand'):
 >>>     st.write('Juicy deets')
     ''')
 
+    col2.write('Batch widgets together in a form:')
+    col2.code('''
+>>> with st.form(key='my_form'):
+>>> 	text_input = st.text_input(label='Enter some text')
+>>> 	submit_button = st.form_submit_button(label='Submit')
+    ''')
 
     # Display code
 
@@ -248,17 +276,26 @@ DeltaGenerator.add_rows(data)
     col3.code('''
 @st.cache
 >>> @st.cache
-... def foo(bar):
-...     # Mutate bar
+... def fetch_and_clean_data(url):
+...     # Mutate data at url
 ...     return data
 >>> # Executes d1 as first time
->>> d1 = foo(ref1)
+>>> d1 = fetch_and_clean_data(ref1)
 >>> # Does not execute d1; returns cached value, d1==d2
->>> d2 = foo(ref1)
+>>> d2 = fetch_and_clean_data(ref1)
 >>> # Different arg, so function d1 executes
->>> d3 = foo(ref2)
+>>> d3 = fetch_and_clean_data(ref2)
+
     ''')
 
+    col3.subheader('Other key parts of the API')
+    col3.markdown('''
+<small>[State API](https://docs.streamlit.io/en/stable/session_state_api.html)</small><br>
+<small>[Theme option reference](https://docs.streamlit.io/en/stable/theme_options.html)</small><br>
+<small>[Components API reference](https://docs.streamlit.io/en/stable/develop_streamlit_components.html)</small><br>
+<small>[API cheat sheet](https://share.streamlit.io/daniellewisdl/streamlit-cheat-sheet/app.py)</small><br>
+''', unsafe_allow_html=True)
+
     return None
 
 # Run main()