Skip to content

Commit 2abd435

Browse files
Release 1.26.0 (#791)
* Add documentation for `st.status` (#783) * Create st.status page * Update API cards & docstrings * Update st.status API card summary * Add st.status to chat elements in API index * Add st.toggle documentation (#784) * Add st.toggle documentation Add page, API card, and navigation for st.toggle * Update streamlit.json --------- Co-authored-by: snehankekre <[email protected]> * Feature/enable deploy button (#787) * Add deployment button gif * Move deploy button in app menu docs * Update image borders in app-menu.md * Sync streamlit.json with release branch --------- Co-authored-by: snehankekre <[email protected]> * Release 1.26 (#785) * Add captions and markdown to st.radio example * Update streamlit.json * Remove static images for title, header, subheader * Update markdown.md Add interactive embedded app * Update changelog for 1.26.0 * Update embedded apps to 1.26.0 * Use relative internal links in changelog for performance reasons * Fix Markdown issue in download button point * Move incorrect PR about number input into notable changes * Don't reference PR 7154 in other changes * Change impact label and add PR 7143 to other changes * Update cheatsheet and configuration.md * Update What's new --------- Co-authored-by: snehankekre <[email protected]> * Update streamlit.json (#790) * Update streamlit.json * Update widget.button.py --------- Co-authored-by: snehankekre <[email protected]>
1 parent bd8e8a3 commit 2abd435

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

46 files changed

+12468
-611
lines changed

content/library/advanced-features/app-menu.md

Lines changed: 20 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ title: ⋮ App menu
33
slug: /library/advanced-features/app-menu
44
---
55

6-
# App menu
6+
# <i style={{ verticalAlign: "-.25em", fontSize: "1em" }} className={{ class: "material-icons-sharp" }}>more_vert</i> App menu
77

88
Streamlit provides a configurable menu within your app to access convenient tools for developers and viewers. By default, you can access developer options from the app menu when viewing an app locally or on Streamlit Community Cloud while logged into an account with administrative access. While viewing an app, click the icon in the upper-right corner to access the menu.
99

@@ -123,10 +123,26 @@ Reset your app's cache by clicking "**Clear cache**" from the app's menu or by p
123123

124124
### Deploy this app
125125

126-
If you are running an app locally from within a git repo, you can deploy your app to Streamlit Community Cloud in a few easy clicks! Make sure your work has been pushed to your online GitHub repository before beginning. For the greatest convenience, make sure you have already created your [Community Cloud account](/streamlit-community-cloud/get-started/create-your-account) and are signed in. Click "**Deploy this app**" to be taken directly to Community Cloud's "Deploy an app" page. Your app's repository, branch, and file name will be prefilled to match your current app! Learn more about [deploying an app](/streamlit-community-cloud/deploy-your-app) on Streamlit Community Cloud.
126+
If you are running an app locally from within a git repo, you can deploy your app to Streamlit Community Cloud in a few easy clicks! Make sure your work has been pushed to your online GitHub repository before beginning. For the greatest convenience, make sure you have already created your [Community Cloud account](/streamlit-community-cloud/get-started/create-your-account) and are signed in.
127127

128-
<div style={{ maxWidth: '30%', margin: 'auto' }}>
129-
<Image src="/images/app-menu/app-menu-deploy-XL.png" alt="Rerun" clean />
128+
1. Click "**Deploy**" next to the app menu icon (<i style={{ verticalAlign: "-.25em" }} className={{ class: "material-icons-sharp" }}>more_vert</i>).
129+
130+
<div style={{ maxWidth: '90%', margin: '0 2em 0 2em' }}>
131+
<Image src="/images/app-menu/app-menu-deploy.png" alt="Settings" />
132+
</div>
133+
134+
2. Click "**Deploy now**".
135+
136+
<div style={{ maxWidth: '90%', margin: '0 2em 0 2em' }}>
137+
<Image src="/images/app-menu/app-menu-deploy-1.png" alt="Settings" />
138+
</div>
139+
140+
3. You will be taken to Community Cloud's "Deploy an app" page. Your app's repository, branch, and file name will be prefilled to match your current app! Learn more about [deploying an app](/streamlit-community-cloud/deploy-your-app) on Streamlit Community Cloud.
141+
142+
The whole process looks like this:
143+
144+
<div style={{ maxWidth: '90%', margin: '0 2em 0 2em' }}>
145+
<Image src="/images/app-menu/deploy-from-local.gif" alt="Settings" />
130146
</div>
131147

132148
## Customize the menu

content/library/advanced-features/configuration.md

Lines changed: 0 additions & 348 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,6 @@ If changes to `.streamlit/config.toml` are made _while_ the app is running, the
3636
streamlit run your_script.py --server.port 80
3737
```
3838

39-
4039
## Telemetry
4140

4241
As mentioned during the installation process, Streamlit collects usage statistics. You can find out
@@ -441,350 +440,3 @@ showPyplotGlobalUse = true
441440
# "serif", or "monospace".
442441
# font =
443442
```
444-
445-
<Collapse title="View entire file" expanded={false} >
446-
447-
This is the entire `config.toml` file with all the options for version 1.25.0:
448-
449-
```toml
450-
[global]
451-
452-
# By default, Streamlit checks if the Python watchdog module is available
453-
# and, if not, prints a warning asking for you to install it. The watchdog
454-
# module is not required, but highly recommended. It improves Streamlit's
455-
# ability to detect changes to files in your filesystem.
456-
457-
# If you'd like to turn off this warning, set this to True.
458-
459-
# Default: false
460-
disableWatchdogWarning = false
461-
462-
# By default, Streamlit displays a warning when a user sets both a widget
463-
# default value in the function defining the widget and a widget value via
464-
# the widget's key in `st.session_state`.
465-
466-
# If you'd like to turn off this warning, set this to True.
467-
468-
# Default: false
469-
disableWidgetStateDuplicationWarning = false
470-
471-
# If True, will show a warning when you run a Streamlit-enabled script
472-
# via "python my_script.py".
473-
474-
# Default: true
475-
showWarningOnDirectExecution = true
476-
477-
# DataFrame serialization.
478-
479-
# Acceptable values:
480-
# - 'legacy' : Serialize DataFrames using Streamlit's custom format. Slow
481-
# but battle-tested.
482-
# - 'arrow' : Serialize DataFrames using Apache Arrow. Much faster and
483-
# versatile.
484-
485-
# Default: "arrow"
486-
dataFrameSerialization = "arrow"
487-
488-
[logger]
489-
490-
# Level of logging: 'error', 'warning', 'info', or 'debug'.
491-
492-
# Default: 'info'
493-
level = "info"
494-
495-
# String format for logging messages. If logger.datetimeFormat is set,
496-
# logger messages will default to `%(asctime)s.%(msecs)03d %(message)s`. See
497-
# Python's documentation for available attributes:
498-
# https://docs.python.org/2.6/library/logging.html#formatter-objects
499-
500-
# Default: "%(asctime)s %(message)s"
501-
messageFormat = "%(asctime)s %(message)s"
502-
503-
[client]
504-
505-
# Whether to enable st.cache. This does not affect st.cache_data or
506-
# st.cache_resource.
507-
508-
# Default: true
509-
caching = true
510-
511-
# If false, makes your Streamlit script not draw to a
512-
# Streamlit app.
513-
514-
# Default: true
515-
displayEnabled = true
516-
517-
# Controls whether uncaught app exceptions and deprecation warnings
518-
# are displayed in the browser. By default, this is set to True and
519-
# Streamlit displays app exceptions and associated tracebacks, and
520-
# deprecation warnings, in the browser.
521-
522-
# If set to False, deprecation warnings and full exception messages
523-
# will print to the console only. Exceptions will still display in the
524-
# browser with a generic error message. For now, the exception type and
525-
# traceback show in the browser also, but they will be removed in the
526-
# future.
527-
528-
# Default: true
529-
showErrorDetails = true
530-
531-
# Change the visibility of items in the toolbar, options menu,
532-
# and settings dialog (top right of the app).
533-
534-
# Allowed values:
535-
# * "auto" : Show the developer options if the app is accessed through
536-
# localhost or through Streamlit Community Cloud as a developer.
537-
# Hide them otherwise.
538-
# * "developer" : Show the developer options.
539-
# * "viewer" : Hide the developer options.
540-
# * "minimal" : Show only options set externally (e.g. through
541-
# Streamlit Community Cloud) or through st.set_page_config.
542-
# If there are no options left, hide the menu.
543-
544-
# Default: "auto"
545-
toolbarMode = "auto"
546-
547-
[runner]
548-
549-
# Allows you to type a variable or string by itself in a single line of
550-
# Python code to write it to the app.
551-
552-
# Default: true
553-
magicEnabled = true
554-
555-
# Install a Python tracer to allow you to stop or pause your script at
556-
# any point and introspect it. As a side-effect, this slows down your
557-
# script's execution.
558-
559-
# Default: false
560-
installTracer = false
561-
562-
# Sets the MPLBACKEND environment variable to Agg inside Streamlit to
563-
# prevent Python crashing.
564-
565-
# Default: true
566-
fixMatplotlib = true
567-
568-
# Run the Python Garbage Collector after each script execution. This
569-
# can help avoid excess memory use in Streamlit apps, but could
570-
# introduce delay in rerunning the app script for high-memory-use
571-
# applications.
572-
573-
# Default: true
574-
postScriptGC = true
575-
576-
# Handle script rerun requests immediately, rather than waiting for script
577-
# execution to reach a yield point. This makes Streamlit much more
578-
# responsive to user interaction, but it can lead to race conditions in
579-
# apps that mutate session_state data outside of explicit session_state
580-
# assignment statements.
581-
582-
# Default: true
583-
fastReruns = true
584-
585-
# Raise an exception after adding unserializable data to Session State.
586-
# Some execution environments may require serializing all data in Session
587-
# State, so it may be useful to detect incompatibility during development,
588-
# or when the execution environment will stop supporting it in the future.
589-
590-
# Default: false
591-
enforceSerializableSessionState = false
592-
593-
[server]
594-
595-
# List of folders that should not be watched for changes. This
596-
# impacts both "Run on Save" and @st.cache.
597-
598-
# Relative paths will be taken as relative to the current working directory.
599-
600-
# Example: ['/home/user1/env', 'relative/path/to/folder']
601-
602-
# Default: []
603-
folderWatchBlacklist = []
604-
605-
# Change the type of file watcher used by Streamlit, or turn it off
606-
# completely.
607-
608-
# Allowed values:
609-
# * "auto" : Streamlit will attempt to use the watchdog module, and
610-
# falls back to polling if watchdog is not available.
611-
# * "watchdog" : Force Streamlit to use the watchdog module.
612-
# * "poll" : Force Streamlit to always use polling.
613-
# * "none" : Streamlit will not watch files.
614-
615-
# Default: "auto"
616-
fileWatcherType = "auto"
617-
618-
# Symmetric key used to produce signed cookies. If deploying on multiple
619-
# replicas, this should be set to the same value across all replicas to ensure
620-
# they all share the same secret.
621-
622-
# Default: randomly generated secret key.
623-
cookieSecret = "a-random-key-appears-here"
624-
625-
# If false, will attempt to open a browser window on start.
626-
627-
# Default: false unless (1) we are on a Linux box where DISPLAY is unset, or
628-
# (2) we are running in the Streamlit Atom plugin.
629-
# headless = false
630-
631-
# Automatically rerun script when the file is modified on disk.
632-
633-
# Default: false
634-
runOnSave = false
635-
636-
# The address where the server will listen for client and browser
637-
# connections. Use this if you want to bind the server to a specific address.
638-
# If set, the server will only be accessible from this address, and not from
639-
# any aliases (like localhost).
640-
641-
# Default: (unset)
642-
# address =
643-
644-
# The port where the server will listen for browser connections.
645-
646-
# Default: 8501
647-
port = 8501
648-
649-
# The base path for the URL where Streamlit should be served from.
650-
651-
# Default: ""
652-
baseUrlPath = ""
653-
654-
# Enables support for Cross-Origin Resource Sharing (CORS) protection, for
655-
# added security.
656-
657-
# Due to conflicts between CORS and XSRF, if `server.enableXsrfProtection` is
658-
# on and `server.enableCORS` is off at the same time, we will prioritize
659-
# `server.enableXsrfProtection`.
660-
661-
# Default: true
662-
enableCORS = true
663-
664-
# Enables support for Cross-Site Request Forgery (XSRF) protection, for added
665-
# security.
666-
667-
# Due to conflicts between CORS and XSRF, if `server.enableXsrfProtection` is
668-
# on and `server.enableCORS` is off at the same time, we will prioritize
669-
# `server.enableXsrfProtection`.
670-
671-
# Default: true
672-
enableXsrfProtection = true
673-
674-
# Max size, in megabytes, for files uploaded with the file_uploader.
675-
676-
# Default: 200
677-
maxUploadSize = 200
678-
679-
# Max size, in megabytes, of messages that can be sent via the WebSocket
680-
# connection.
681-
682-
# Default: 200
683-
maxMessageSize = 200
684-
685-
# Enables support for websocket compression.
686-
687-
# Default: false
688-
enableWebsocketCompression = false
689-
690-
# Enable serving files from a `static` directory in the running app's
691-
# directory.
692-
693-
# Default: false
694-
enableStaticServing = false
695-
696-
# Server certificate file for connecting via HTTPS.
697-
# Must be set at the same time as "server.sslKeyFile".
698-
699-
# ['DO NOT USE THIS OPTION IN A PRODUCTION ENVIRONMENT. It has not gone through
700-
# security audits or performance tests. For the production environment, we
701-
# recommend performing SSL termination by the load balancer or the reverse
702-
# proxy.']
703-
# sslCertFile =
704-
705-
# Cryptographic key file for connecting via HTTPS.
706-
# Must be set at the same time as "server.sslCertFile".
707-
708-
# ['DO NOT USE THIS OPTION IN A PRODUCTION ENVIRONMENT. It has not gone through
709-
# security audits or performance tests. For the production environment, we
710-
# recommend performing SSL termination by the load balancer or the reverse
711-
# proxy.']
712-
# sslKeyFile =
713-
714-
[browser]
715-
716-
# Internet address where users should point their browsers in order to
717-
# connect to the app. Can be IP address or DNS name and path.
718-
719-
# This is used to:
720-
# - Set the correct URL for CORS and XSRF protection purposes.
721-
# - Show the URL on the terminal
722-
# - Open the browser
723-
724-
# Default: "localhost"
725-
serverAddress = "localhost"
726-
727-
# Whether to send usage statistics to Streamlit.
728-
729-
# Default: true
730-
gatherUsageStats = true
731-
732-
# Port where users should point their browsers in order to connect to the
733-
# app.
734-
735-
# This is used to:
736-
# - Set the correct URL for CORS and XSRF protection purposes.
737-
# - Show the URL on the terminal
738-
# - Open the browser
739-
740-
# Default: whatever value is set in server.port.
741-
serverPort = 8501
742-
743-
[mapbox]
744-
745-
# Configure Streamlit to use a custom Mapbox
746-
# token for elements like st.pydeck_chart and st.map.
747-
# To get a token for yourself, create an account at
748-
# https://mapbox.com. It's free (for moderate usage levels)!
749-
750-
# Default: ""
751-
token = ""
752-
753-
[deprecation]
754-
755-
# Set to false to disable the deprecation warning for the file uploader
756-
# encoding.
757-
758-
# Default: true
759-
showfileUploaderEncoding = true
760-
761-
# Set to false to disable the deprecation warning for using the global pyplot
762-
# instance.
763-
764-
# Default: true
765-
showPyplotGlobalUse = true
766-
767-
[theme]
768-
769-
# The preset Streamlit theme that your custom theme inherits from.
770-
# One of "light" or "dark".
771-
# base =
772-
773-
# Primary accent color for interactive elements.
774-
# primaryColor =
775-
776-
# Background color for the main content area.
777-
# backgroundColor =
778-
779-
# Background color used for the sidebar and most interactive widgets.
780-
# secondaryBackgroundColor =
781-
782-
# Color used for almost all text.
783-
# textColor =
784-
785-
# Font family for all text in the app, except code blocks. One of "sans serif",
786-
# "serif", or "monospace".
787-
# font =
788-
```
789-
790-
</Collapse>

0 commit comments

Comments
 (0)