# streamlit-plugins
Components and Frameworks to give new features to streamlit
![Demo Multipage with Navbar](https://raw.githubusercontent.com/quiradev/streamlit-plugins/main/resources/demo1.gif)
## Component
The Navbar and Loader component are inherited from Hydralit components, only to give support to the multilit framework.
But this version has improve the interface and loaders to be more user-friendly.
### Navbar (Inherit from Hydralit Components)
Component to use when you want to have a navbar in your streamlit app.
It can be used with native multipage streamlit, or use the multilit framework.
If you want to use the native multipage streamlit, you can use the `st_navbar` function to create the navbar.
This component it returns the id of the defined menu that has to run the page.
This is an example of multipage with native streamlit
```python
import streamlit as st
if "logged_in" not in st.session_state:
st.session_state.logged_in = False
def login():
if st.button("Log in"):
st.session_state.logged_in = True
st.rerun()
def logout():
if st.button("Log out"):
st.session_state.logged_in = False
st.rerun()
login_page = st.Page(login, title="Log in", icon=":material/login:")
logout_page = st.Page(logout, title="Log out", icon=":material/logout:")
dashboard = st.Page(
"reports/dashboard.py", title="Dashboard", icon=":material/dashboard:", default=True
)
bugs = st.Page("reports/bugs.py", title="Bug reports", icon=":material/bug_report:")
alerts = st.Page(
"reports/alerts.py", title="System alerts", icon=":material/notification_important:"
)
search = st.Page("tools/search.py", title="Search", icon=":material/search:")
history = st.Page("tools/history.py", title="History", icon=":material/history:")
if st.session_state.logged_in:
pg = st.navigation(
{
"Account": [logout_page],
"Reports": [dashboard, bugs, alerts],
"Tools": [search, history],
}
)
else:
pg = st.navigation([login_page])
pg.run()
```
And if you want to use streamlit Navbar, it has to be addapted to this code:
```python
import streamlit as st
st.set_page_config(layout="wide")
if "logged_in" not in st.session_state:
st.session_state.logged_in = False
if "app_id" not in st.session_state:
st.session_state.app_id = None
def login():
if st.button("Log in"):
st.session_state.logged_in = True
st.session_state.app_id = "app_default"
st.rerun()
def logout():
if st.button("Log out"):
st.session_state.logged_in = False
st.session_state.app_id = None
st.rerun()
login_page = st.Page(login, title="Log in", icon=":material/login:")
logout_page = st.Page(logout, title="Log out", icon=":material/logout:")
dashboard = st.Page(
"reports/dashboard.py", title="Dashboard", icon=":material/dashboard:", default=True
)
bugs = st.Page("reports/bugs.py", title="Bug reports", icon=":material/bug_report:")
alerts = st.Page(
"reports/alerts.py", title="System alerts", icon=":material/notification_important:"
)
search = st.Page("tools/search.py", title="Search", icon=":material/search:")
history = st.Page("tools/history.py", title="History", icon=":material/history:")
# HERE IS THE CHANGE
from streamlit_plugins.components.navbar import st_navbar, build_menu_from_st_pages
menu_data, app_map = build_menu_from_st_pages(
{"Reports": [dashboard, bugs, alerts]}, {"Tools": [search, history]},
login_app=login_page,
logout_app=logout_page,
)
app_id = st_navbar(
menu_definition=menu_data if st.session_state.logged_in else [],
login_name=logout_page.title if st.session_state.logged_in else login_page.title,
hide_streamlit_markers=False,
override_app_selected_id=st.session_state.app_id,
sticky_nav=True, # at the top or not
sticky_mode='pinned', # sticky or pinned
)
if app_id == "app_login":
if st.session_state.logged_in:
app_id = "app_logout"
st.session_state.app_id = None # Added to fix login/logout issue
app_map[app_id]._can_be_called = True
app_map[app_id].run()
# if st.session_state.logged_in:
# pg = st.navigation(
# {
# "Account": [logout_page],
# "Reports": [dashboard, bugs, alerts],
# "Tools": [search, history],
# },
# position="hidden"
# )
#
# else:
# pg = st.navigation([login_page], position="hidden")
#
#
# pg.run()
```
Raw data
{
"_id": null,
"home_page": "https://github.com/quiradev/streamlit-plugins",
"name": "streamlit-component-navbar",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "streamlit, plugins, components, navbar",
"author": "Victor Quilon Ranera",
"author_email": "v.quilonr@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/36/f2/acf0944b330704bab0a40947b751745b31246581207febd9c76d7145f6b8/streamlit_component_navbar-0.3.2.tar.gz",
"platform": null,
"description": "# streamlit-plugins\nComponents and Frameworks to give new features to streamlit\n\n![Demo Multipage with Navbar](https://raw.githubusercontent.com/quiradev/streamlit-plugins/main/resources/demo1.gif)\n\n## Component\nThe Navbar and Loader component are inherited from Hydralit components, only to give support to the multilit framework.\nBut this version has improve the interface and loaders to be more user-friendly.\n\n### Navbar (Inherit from Hydralit Components)\nComponent to use when you want to have a navbar in your streamlit app.\nIt can be used with native multipage streamlit, or use the multilit framework.\n\nIf you want to use the native multipage streamlit, you can use the `st_navbar` function to create the navbar.\n\nThis component it returns the id of the defined menu that has to run the page.\n\nThis is an example of multipage with native streamlit\n```python\nimport streamlit as st\n\nif \"logged_in\" not in st.session_state:\n st.session_state.logged_in = False\n\ndef login():\n if st.button(\"Log in\"):\n st.session_state.logged_in = True\n st.rerun()\n\ndef logout():\n if st.button(\"Log out\"):\n st.session_state.logged_in = False\n st.rerun()\n\nlogin_page = st.Page(login, title=\"Log in\", icon=\":material/login:\")\nlogout_page = st.Page(logout, title=\"Log out\", icon=\":material/logout:\")\n\ndashboard = st.Page(\n \"reports/dashboard.py\", title=\"Dashboard\", icon=\":material/dashboard:\", default=True\n)\nbugs = st.Page(\"reports/bugs.py\", title=\"Bug reports\", icon=\":material/bug_report:\")\nalerts = st.Page(\n \"reports/alerts.py\", title=\"System alerts\", icon=\":material/notification_important:\"\n)\n\nsearch = st.Page(\"tools/search.py\", title=\"Search\", icon=\":material/search:\")\nhistory = st.Page(\"tools/history.py\", title=\"History\", icon=\":material/history:\")\n\nif st.session_state.logged_in:\n pg = st.navigation(\n {\n \"Account\": [logout_page],\n \"Reports\": [dashboard, bugs, alerts],\n \"Tools\": [search, history],\n }\n )\nelse:\n pg = st.navigation([login_page])\n\npg.run()\n```\n\nAnd if you want to use streamlit Navbar, it has to be addapted to this code:\n```python\nimport streamlit as st\n\nst.set_page_config(layout=\"wide\")\n\nif \"logged_in\" not in st.session_state:\n st.session_state.logged_in = False\n\nif \"app_id\" not in st.session_state:\n st.session_state.app_id = None\n\ndef login():\n if st.button(\"Log in\"):\n st.session_state.logged_in = True\n st.session_state.app_id = \"app_default\"\n st.rerun()\n\ndef logout():\n if st.button(\"Log out\"):\n st.session_state.logged_in = False\n st.session_state.app_id = None\n st.rerun()\n\n\nlogin_page = st.Page(login, title=\"Log in\", icon=\":material/login:\")\nlogout_page = st.Page(logout, title=\"Log out\", icon=\":material/logout:\")\n\ndashboard = st.Page(\n \"reports/dashboard.py\", title=\"Dashboard\", icon=\":material/dashboard:\", default=True\n)\nbugs = st.Page(\"reports/bugs.py\", title=\"Bug reports\", icon=\":material/bug_report:\")\nalerts = st.Page(\n \"reports/alerts.py\", title=\"System alerts\", icon=\":material/notification_important:\"\n)\n\nsearch = st.Page(\"tools/search.py\", title=\"Search\", icon=\":material/search:\")\nhistory = st.Page(\"tools/history.py\", title=\"History\", icon=\":material/history:\")\n\n# HERE IS THE CHANGE\nfrom streamlit_plugins.components.navbar import st_navbar, build_menu_from_st_pages\n\nmenu_data, app_map = build_menu_from_st_pages(\n {\"Reports\": [dashboard, bugs, alerts]}, {\"Tools\": [search, history]},\n login_app=login_page,\n logout_app=logout_page,\n)\n\napp_id = st_navbar(\n menu_definition=menu_data if st.session_state.logged_in else [],\n login_name=logout_page.title if st.session_state.logged_in else login_page.title,\n hide_streamlit_markers=False,\n override_app_selected_id=st.session_state.app_id,\n sticky_nav=True, # at the top or not\n sticky_mode='pinned', # sticky or pinned\n)\nif app_id == \"app_login\":\n if st.session_state.logged_in:\n app_id = \"app_logout\"\n\nst.session_state.app_id = None # Added to fix login/logout issue\napp_map[app_id]._can_be_called = True\napp_map[app_id].run()\n\n\n# if st.session_state.logged_in:\n# pg = st.navigation(\n# {\n# \"Account\": [logout_page],\n# \"Reports\": [dashboard, bugs, alerts],\n# \"Tools\": [search, history],\n# },\n# position=\"hidden\"\n# )\n#\n# else:\n# pg = st.navigation([login_page], position=\"hidden\")\n#\n#\n# pg.run()\n```\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Components and Frameworks to give new features to streamlit",
"version": "0.3.2",
"project_urls": {
"Homepage": "https://github.com/quiradev/streamlit-plugins"
},
"split_keywords": [
"streamlit",
" plugins",
" components",
" navbar"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "5d2aa46552d0a8f5aa1e5e20e6c28b97226264e7c8bd78ef1251b1edca130a41",
"md5": "e1e638d002fb606220d4b575b0109aeb",
"sha256": "4c248225aa45ac44d65d5340eb71ce7b1f11d608416f5562cd5db927a0d52d73"
},
"downloads": -1,
"filename": "streamlit_component_navbar-0.3.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "e1e638d002fb606220d4b575b0109aeb",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 5112595,
"upload_time": "2024-11-08T10:59:27",
"upload_time_iso_8601": "2024-11-08T10:59:27.272753Z",
"url": "https://files.pythonhosted.org/packages/5d/2a/a46552d0a8f5aa1e5e20e6c28b97226264e7c8bd78ef1251b1edca130a41/streamlit_component_navbar-0.3.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "36f2acf0944b330704bab0a40947b751745b31246581207febd9c76d7145f6b8",
"md5": "ae1f599db714e478a8ecc949de11f9c7",
"sha256": "452d79c0e27f3d2a7b34247588271a44a79ba992f38dd864eaca0f7d79318dab"
},
"downloads": -1,
"filename": "streamlit_component_navbar-0.3.2.tar.gz",
"has_sig": false,
"md5_digest": "ae1f599db714e478a8ecc949de11f9c7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 5110917,
"upload_time": "2024-11-08T10:59:29",
"upload_time_iso_8601": "2024-11-08T10:59:29.530146Z",
"url": "https://files.pythonhosted.org/packages/36/f2/acf0944b330704bab0a40947b751745b31246581207febd9c76d7145f6b8/streamlit_component_navbar-0.3.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-08 10:59:29",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "quiradev",
"github_project": "streamlit-plugins",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "streamlit-component-navbar"
}