Streamlit 多页面应用设计指南：构建模块化数据分析平台

Streamlit 多页面应用设计指南：构建模块化数据分析平台

引用

CSDN

1.

https://blog.csdn.net/weixin_42984235/article/details/140330029

在开发数据分析网页应用时，如何优雅地管理多个子应用并保持代码的可读性和维护性是一个常见挑战。Streamlit作为一款强大的Web应用框架，提供了灵活的解决方案，使得开发者能够构建多页面、模块化的应用。本文将详细介绍如何通过模块化设计来构建复杂的数据分析平台，包括具体的实现策略和代码示例。

困扰与需求

在制作数据分析网页的过程中，开发者常常会遇到以下困扰：

• 页面限制与逻辑关联：为了提高用户体验，需要将功能相关的部分组织在一起，形成逻辑清晰的多个页面。
• 代码管理难题：将所有功能塞入一个文件会导致代码冗长，降低开发效率和代码质量。
• IDE性能问题：大型文件在VSCode等编辑器中加载和代码分析时，可能会遭遇卡顿问题。

基于以上困扰，我们的目标是：

1. 实现多应用展示：利用Streamlit构建具有多个界面的网页应用，每个界面专注于不同的数据分析任务。
2. 子应用独立开发：确保每个子应用的代码逻辑清晰，独立于其他应用，便于开发和后续维护。
3. 算法与框架分离：将算法实现和框架结构分开存储，以促进代码的复用和扩展性。

设计与实施策略

为了达成上述目标，可以采取以下设计策略：

模块化编码

• 建立子应用模块：为每个子应用创建独立的.py文件，如weather_city.py和weather_country.py，每个文件专注于一个特定的分析任务。
• 定义app()函数：在每个子应用模块中，定义一个app()函数，该函数封装了整个子应用的逻辑流程和Streamlit界面元素。

构建页面路由

• 使用字典映射：创建一个字典PAGES，其键是页面名称，值是对应子应用模块的引用。
• 实现页面选择：在主应用文件中，使用Streamlit的sidebar和selectbox组件，让用户选择要查看的页面。

分离算法与框架

• 算法与业务逻辑分离：将复杂的算法和数据处理逻辑封装在单独的模块或类中，与Streamlit的UI逻辑解耦。
• 框架结构清晰：保持主应用文件简洁，仅负责页面路由和基本的布局设置，具体功能实现在子应用模块中。

应用框架

框架包括一个主程序和很多子程序，子程序用__init__.py作为一个包，让主程序能够很好地调用。

代码示例

main_weathers

主程序，这里用的下拉框来选择，也可以用radio方法。

import streamlit as st
from pages import weather_city, weather_country

# 创建一个字典来映射页面标题到页面函数
PAGES = {
    "公共雨量站": weather_city,
    "区内气象站": weather_country,
}

def main():
    st.sidebar.title('导航') 
    selected_page = st.sidebar.selectbox("选择页面", list(PAGES.keys()))
    # 根据用户选择的页面调用相应的函数
    page = PAGES[selected_page]  
    page.app() 

if __name__ == "__main__":
    main()

weather_country

相当于page 1，注意子程序所在的pages文件夹需要有__init__.py文件。

# pages/weather_country.py
import streamlit as st

def app():
    st.title('区内气象站')
    # 页面的具体内容
    st.header('这是页面2的内容')
    st.text('这是页面2的示例文本。')
    st.checkbox('这是一个复选框')

if __name__ == "__main__":
    app()

weather_city

相当于page 2

# pages/weather_city.py
import streamlit as st

def app():
    st.title('公共雨量站')
    # 页面的具体内容
    st.header('这是页面1的内容')
    st.text('这是一个示例文本，用于演示页面1的功能。')
    st.button('点击我！')     

if __name__ == "__main__":
    app()

注意子程序所在的pages文件夹需要有__init__.py文件，让所有的子程序被视为一个包，这样主程序才能import。该文件可以为空，也可以增加一些属性。示例如下。

"""
This is the package documentation string.
It describes what the package does and how to use it.
"""
__author__ = "Your Name"
__version__ = "1.0"

结果预览

运行结果如下。

结论

通过采用模块化的设计思路，我们可以有效地管理和扩展Streamlit应用，使其既能满足复杂的数据分析需求，又能保持代码的整洁与高效。这种策略不仅提升了开发体验，还为未来的功能迭代奠定了坚实的基础。