Streamlit基础教程
streamlit是什么
streamlit
是一个开源的python
库,它能够快速的帮助我们创建定制化的web
应用,而且还非常便于和他人分享,特别是在机器学习和数据科学领域。整个过程不需要你了解任何前端的知识,包括html
、css
、javascript
等,对非前端开发人员非常的友好。
streamlit安装
streamlit
要求python
版本大于等于3.6,可以直接使用pip
进行安装
pip install streamlit
安装成功后,使用其内置的hello app
测试,执行命令
streamlit hello
服务启动后,它会自动帮我们打开页面,地址是 http://localhost:8501
可以看到,streamlit
默认使用端口8501
除此之外,streamlit
官方还提供了一个稍复杂的应用,它结合了yolov3
的目标检测算法,仓库地址:https://github.com/streamlit/demo-self-driving,感兴趣的可以去研究研究,代码简短,但功能完整
那么,针对我们自己写的源码文件,该怎么运行呢?其实也非常简单,比如源码文件是app.py
,那么可以执行
streamlit run app.py
这里再说2个常用的命令
streamlit docs 查看文档
streamlit cache clear 清缓存
streamlit常用组件
按钮
import streamlit as stbutton = st.button('按钮')
文本输入框
import streamlit as stst.text_input('请输入最喜欢的编程语言', key="name")
文本显示
import streamlit as stst.write('Hello streamlit.')
streamlit
完美支持markdown
语法,可以直接使用write
方法,来看示例
import streamlit as stst.write("""# 一级标题## 二级标题### 三级标题**强调**>这是引用. python . java . c/c++ . rust
""")
除了write
方法,streamlit
还提供了text
方法,同样可以显示文本信息
import streamlit as stst.text('Hello streamlit.')
标题
import streamlit as stst.title('title')
除了title
,streamlit
还提供了header
和subheader
import streamlit as stst.header('header')
st.subheader('subheader')
滑动条
import streamlit as stnumber = st.slider('Pick a number', 0, 100)
选择框
import streamlit as stflag = st.checkbox('Yes')
单选按钮
import streamlit as stlanguages = ['python', 'c', 'rust', 'c++']st.radio('Pick a language', languages)
下拉选择框
import streamlit as stst.selectbox('用过哪几种编程语言?', ('python', 'c', 'java', 'rust'))
日期选择器
import streamlit as stdate = st.date_input('Pick a date')
颜色选择器
import streamlit as stcolor = st.color_picker('Pick a color')
文件选择器
import streamlit as stfile = st.file_uploader('Pick a file')
streamlit的其它功能
显示json
import streamlit as stst.json({"code": 0,"data": {"sex": "female","age": 18,"score": 100}
})
显示代码
from numpy.core.arrayprint import _leading_trailing
import streamlit as stcode = """def func():print('Hello streamlit.')
"""
st.code(code, language='python')
显示pandas中的dataframe
from numpy.core.arrayprint import _leading_trailing
import streamlit as st
import pandas as pd
import numpy as npdf = pd.DataFrame(np.random.randn(50, 5), columns=('col %d' % i for i in range(5)))
st.dataframe(df)
最后一句中的st.dataframe(df)
可以用st.write(df)
来代替,效果一样
显示表格
import streamlit as st
import pandas as pd
import numpy as npdf = pd.DataFrame(np.random.randn(50, 5), columns=('col %d' % i for i in range(5)))
st.table(df)
与上边的dataframe
不同的是,表格会将所有数据都显示出来,而没有了滚动条
指标性数据显示
这里还需要安装另一个库streamlit-metrics
,执行安装命令pip install streamlit-metrics
即可
import streamlit as st
from streamlit_metrics import metric_rowst.write("一周数据统计")
metric_row({"关注人数": 100,"点赞人数": 200,"在看人数": 300,"分享人数": 400}
)
streamlit的会话状态和回调
会话状态session state
在浏览器中打开新的页面,就创建了一个会话(session
)。会话状态是页面rerun
(并非类似F5
的页面刷新)时数据交互的一种方式。
看个计数的示例
import streamlit as stst.title('Hello streamlit.')
counter = 0increment = st.button('Increment')
if increment:counter += 1st.write('Count= ', counter)
可以看到只有第一次点击按钮时,Count
增加了1,后面的点击,counter
都不会改变,这显然跟我们的预期是不一样的。
我们修改下上面的代码
from typing import Counter
import streamlit as stst.title('Hello streamlit.')
if 'counter' not in st.session_state:st.session_state.counter = 0increment = st.button('Increment')
if increment:st.session_state.counter += 1st.write('Count= ', st.session_state.counter)
这样功能就正常了,每点击一次按钮,Count
就加1
回调callbacks
回调(callbacks
)是一个python
函数,它在输入组件更改时被调用,比如按钮被点击、滑动条被拉拽等。
针对上边的示例,使用callbacks
修改一下
from typing import Counter
import streamlit as st# callbacks
def increment_counter():st.session_state.counter += 1st.title('Callbacks')
if 'counter' not in st.session_state:st.session_state.counter = 0st.button('Increment', on_click=increment_counter)
st.write('Count= ', st.session_state.counter)
代码执行的效果是一样的。这是无需传参的示例,如果需要数据交互,可以使用args
或kwargs
,看下面的示例
import streamlit as stst.title('Callbacks with args')
if 'counter' not in st.session_state:st.session_state.counter = 0increment_value = st.number_input('Enter a value', value=0, step=1)def increment_counter(increment_value):st.session_state.counter += increment_valueincrement = st.button('Increment', on_click=increment_counter,args=(increment_value, ))st.write('Count = ', st.session_state.counter)
下面看看kwargs
的用法,它接收的是命名参数
import streamlit as stst.title('Callbacks with kwargs')
if 'counter' not in st.session_state:st.session_state.counter = 0def increment_counter(increment_value=0):st.session_state.counter += increment_valuedef decrement_counter(decrement_value=0):st.session_state.counter -= decrement_valuest.button('Increment', on_click=increment_counter,kwargs=dict(increment_value=5))st.button('Decrement', on_click=decrement_counter,kwargs=dict(decrement_value=1))st.write('Count = ', st.session_state.counter)
点击Increment
按钮,Count
就加5,点击Decrement
按钮,Count
就减1
会话状态的注意事项
关于会话状态,有两点需要注意,分别是
只要页面打开并连接到
streamlit
服务器,会话状态就会一直存在。一旦关闭选项卡,会话状态中存储的所有内容都会丢失会话状态不会持久化。如果
streamlit
服务器崩溃,那么存储在会话状态中的所有内容都会被删除