YAML2ST automates streamlit input widgets from an uploaded YAML or JSON file. All key value pairs will be displayed as streamlit input widgets. You can then export the data changes via YAML or share a URL that contains the YAML file.
In a python environment:
pip install YAML2ST
In a python file:
import streamlit as st
import YAML2ST as y2s
Use an UploadedFile type, e.g. a file from st.file_uploader(), and the Streamlit instance in the location you would like the input widgets displayed, e.g. st.sidebar, with the YAML2ST build() method:
df = y2s.build(uploadedFile, st.sidebar)
build() will return a pandas DataFrame in which you can capture and display all input widget changes.
To export with ease, use: the original UploadedFile, the changes made in the DataFrame, an instance of Streamlit for where you want the export features drawn, and the domain of the URL that we can add a parameter to.
y2s.export(uploadedFile, df, st.sidebar, "http://localhost:9097/")
export() will draw 2 widgets at the Streamlit instance, a download button and a code box with the share link.
If you do not want these widgets drawn on Streamlit, you can use exportRaw() to capture the data:
file, file_name, sharelink = exportRaw(uploadedFile, df, URL)
The demo file dubbed main().py is on GitHub.
streamlit run app/main.py --server.port 9097
Upload a YAML file.
The Streamlit input widgets are dynamically manifested using the following conditional order.
| Widget | Value Input |
|---|---|
checkbox |
Any value that is 'True' or 'False' |
number_input (integer) |
Any value that can be cast to an int. Step defaults to +1/-1. |
number_input (decimal) |
Any value that can be cast to a float. Step defaults to the smallest digit in the value. |
date_input |
Any value that is ISO-8601 standard. E.g.: "2010-02-11" |
datetime_input |
A YAML2ST custom widget to support date and time. E.g.: "2015-06-17 14:03:40" |
color_picker |
Any value that matches hexadecimal with #. E.g.: "#0EE2D7" |
text_area |
Any value that contains a new line \n |
multiselect |
Any value that is a list e.g. starts with [ |
text_input |
All other data |
int: 1
YAML2ST will decide that the best way to display this will be with a Streamlit "number_input" and will draw a number_input with a title of "int" and a value of 1 on the Streamit instance provided.
string: "Dynamic"
YAML2ST will decide that the best way to display this will be with a Streamlit "text_input" and will draw a text_input with a title of "string" and a value of "Dynamic" on the Streamit instance provided.
Should you wish to display the value of the parameter with a specific input widget, we have made that easy with the use of #FORCE: next to the YAML parameter in the YAML file. You may also separate each #FORCE: option with | (including the space before and after the pipe). This capability extends to all of the Streamlit input widget options as your options are taken literally if not recognized by YAML2ST.
| Option | Action |
|---|---|
hide=True |
Will ignore the YAML parameter. |
type=int |
Will force the data type. |
int: 1 #FORCE: w=number_input | min_value=0 | max_value=10
The YAML parameter "int: 1" will be read by YAML2ST as a Streamlit number_input. However, it is best practice to declare the "number_input" Streamlit input widget if there will be literal input widget options such as "min_value" and "max_value".
list1: [ "one", "two", "three", "four" ] #FORCE: w=selectbox | index=2
block_shape5: [ "five", "three", "four"] #FORCE: w=selectbox | options=[ "six", "one", "two"] | index=2
hidden_param: "zero" #FORCE: hide=True
- The YAML key hierarchy must be unique.
colors:
color: Red
color: Green
color: Blue# this will override the breadcrumb "colors->color" so only "color: Blue" will exist - No blank lines (comments are fine).
- For now, it only supports single line data.
You may share a YAML file as a URL. During export() a special URL will be encoded. The domain of the URL, in the code, may need to be updated. YAML2URL uses a single URL parameter dubbed 'YAML2URL' to share all contents of a YAML, including comments and the Y2S #FORCE feature.