Skip to content

Commit f68cf7c

Browse files
authored
Release 1.56.0 (#1453)
* Update devcontainer * Update docstrings * Api reference for 1.56.0
1 parent c3314a6 commit f68cf7c

File tree

20 files changed

+14640
-48
lines changed

20 files changed

+14640
-48
lines changed

.devcontainer/Dockerfile

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
# See here for image contents: https://github.com/microsoft/vscode-dev-containers/tree/v0.209.6/containers/python-3/.devcontainer/base.Dockerfile
1+
# See here for image contents: https://github.com/devcontainers/images/tree/main/src/python
22

3-
# [Choice] Python version (use -bullseye variants on local arm64/Apple Silicon): 3, 3.10, 3.9, 3.8, 3.7, 3.6, 3-bullseye, 3.10-bullseye, 3.9-bullseye, 3.8-bullseye, 3.7-bullseye, 3.6-bullseye, 3-buster, 3.10-buster, 3.9-buster, 3.8-buster, 3.7-buster, 3.6-buster
4-
ARG VARIANT="3.10-bullseye"
5-
FROM mcr.microsoft.com/vscode/devcontainers/python:0-${VARIANT}
3+
# [Choice] Python version: 3.10-bookworm, 3.11-bookworm, 3.12-bookworm, 3.13-bookworm
4+
ARG VARIANT="3.13-bookworm"
5+
FROM mcr.microsoft.com/devcontainers/python:1-${VARIANT}
66

7-
# [Choice] Node.js version: none, lts/*, 16, 14, 12, 10
7+
# [Choice] Node.js version: none, 20, 22, lts/*
88
ARG NODE_VERSION="none"
99
RUN if [ "${NODE_VERSION}" != "none" ]; then su vscode -c "umask 0002 && . /usr/local/share/nvm/nvm.sh && nvm install ${NODE_VERSION} 2>&1"; fi
1010

.devcontainer/devcontainer.json

Lines changed: 33 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,41 +1,36 @@
1-
// For format details, see https://aka.ms/devcontainer.json. For config options, see the README at:
2-
// https://github.com/microsoft/vscode-dev-containers/tree/v0.209.6/containers/python-3
1+
// For format details, see https://containers.dev/implementors/json_reference/
32
{
4-
"name": "Python 3",
5-
"build": {
6-
"dockerfile": "Dockerfile",
7-
"context": "..",
8-
"args": {
9-
// Update 'VARIANT' to pick a Python version: 3, 3.10, 3.9, 3.8, 3.7, 3.6
10-
// Append -bullseye or -buster to pin to an OS version.
11-
// Use -bullseye variants on local on arm64/Apple Silicon.
12-
"VARIANT": "3.7",
13-
// Options
14-
"NODE_VERSION": "lts/*"
15-
}
16-
},
17-
// Set *default* container specific settings.json values on container create.
18-
"settings": {
19-
"python.defaultInterpreterPath": "/usr/local/bin/python",
20-
},
21-
// Add the IDs of extensions you want installed when the container is created.
22-
"extensions": [
23-
"ms-python.python",
24-
"ms-python.vscode-pylance"
25-
],
26-
// Use 'forwardPorts' to make a list of ports inside the container available locally.
27-
"forwardPorts": [
28-
3000
29-
],
30-
// Use 'postCreateCommand' to run commands after the container is created.
31-
// Install NPM dependencies.
32-
"postCreateCommand": "make",
3+
"name": "streamlit-docs",
4+
"build": {
5+
"dockerfile": "Dockerfile",
6+
"context": "..",
7+
"args": {
8+
// Streamlit currently supports Python 3.10 through 3.13.
9+
// Valid devcontainer variants here are 3.10-bookworm through 3.13-bookworm.
10+
"VARIANT": "3.13-bookworm",
11+
// Keep Node aligned with package.json.
12+
"NODE_VERSION": "20"
13+
}
14+
},
15+
"customizations": {
16+
"vscode": {
17+
"settings": {
18+
"python.defaultInterpreterPath": "/usr/local/bin/python"
19+
},
20+
"extensions": ["ms-python.python", "ms-python.vscode-pylance"]
21+
}
22+
},
23+
// Use 'forwardPorts' to make a list of ports inside the container available locally.
24+
"forwardPorts": [3000],
25+
// Use 'postCreateCommand' to run commands after the container is created.
26+
// Install NPM dependencies.
27+
"postCreateCommand": "make",
3328
// Use 'postStartCommand' to run 'make up' every time the container is started.
34-
"postStartCommand": "make up",
35-
// Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root.
36-
"remoteUser": "vscode",
37-
"features": {
38-
"git": "latest",
39-
"github-cli": "latest"
40-
}
29+
"postStartCommand": "make up",
30+
// Comment out connect as root instead. More info: https://aka.ms/vscode-remote/containers/non-root.
31+
"remoteUser": "vscode",
32+
"features": {
33+
"ghcr.io/devcontainers/features/git:1": {},
34+
"ghcr.io/devcontainers/features/github-cli:1": {}
35+
}
4136
}

content/develop/api-reference/_index.md

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -233,6 +233,19 @@ Renders HTML strings to your app.
233233
st.html("<p>Foo bar.</p>")
234234
```
235235

236+
</RefCard>
237+
<RefCard href="/develop/api-reference/text/st.iframe">
238+
239+
<h4>Iframe</h4>
240+
241+
Display content in an iframe
242+
243+
```python
244+
st.iframe("https://docs.streamlit.io")
245+
st.iframe("<p>Streamlit is cool.</p>")
246+
st.iframe("my_content.html")
247+
```
248+
236249
</RefCard>
237250
</TileContainer>
238251

@@ -831,6 +844,20 @@ Display a link button.
831844
st.link_button("Go to gallery", url)
832845
```
833846

847+
</RefCard>
848+
849+
<RefCard href="/develop/api-reference/widgets/st.menu_button">
850+
851+
<Image pure alt="screenshot" src="/images/api/menu_button.jpg" />
852+
853+
<h4>Menu button</h4>
854+
855+
Display a menu button.
856+
857+
```python
858+
st.menu_button("Export", options=["CSV", "JSON", "PDF"])
859+
```
860+
834861
</RefCard>
835862
<RefCard href="/develop/api-reference/widgets/st.page_link">
836863

content/develop/api-reference/custom-components/componentrenderer.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,4 +7,4 @@ keywords: bidicomponentcallable, bidirectional, custom components v2, interface,
77

88
<Autofunction function="ComponentRenderer" oldName="BidiComponentCallable" />
99

10-
<Autofunction function="BidiComponentResult" />
10+
<Autofunction function="ComponentResult" oldName="BidiComponentResult" />

content/develop/api-reference/custom-components/html.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,4 +5,4 @@ description: st.components.v1.html displays an HTML string in an iframe within y
55
keywords: html, iframe, custom component, html string, display, frontend, web content, components v1
66
---
77

8-
<Autofunction function="streamlit.components.v1.html" />
8+
<Autofunction function="streamlit.components.v1.html" deprecated={true} deprecatedText="<code>st.components.v1.html</code> was deprecated in version 1.56.0 and will be removed in a later version. Use <a href='/develop/api-reference/text/st.html'><code>st.html</code></a> instead."/>

content/develop/api-reference/custom-components/iframe.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,4 +5,4 @@ description: st.components.v1.iframe embeds web content in an iframe.
55
keywords: st.components.v1.iframe, iframe, embed html, external content, web content, streamlit components, html embedding, custom components, streamlit iframe
66
---
77

8-
<Autofunction function="streamlit.components.v1.iframe" />
8+
<Autofunction function="streamlit.components.v1.iframe" deprecated={true} deprecatedText="<code>st.components.v1.iframe</code> was deprecated in version 1.56.0 and will be removed in a later version. Use <a href='/develop/api-reference/text/st.iframe'><code>st.iframe</code></a> instead."/>

content/develop/api-reference/data/column_config/_index.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -178,6 +178,32 @@ ImageColumn("Preview Image", help="The preview screenshots")
178178

179179
</RefCard>
180180

181+
<RefCard href="/develop/api-reference/data/st.column_config/st.column_config.audiocolumn">
182+
<Image pure alt="screenshot" src="/images/api/column_config.audiocolumn.jpg" />
183+
184+
<h4>Audio column</h4>
185+
186+
Configure an audio column.
187+
188+
```python
189+
AudioColumn("Sound effect", help="Double click to play.")
190+
```
191+
192+
</RefCard>
193+
194+
<RefCard href="/develop/api-reference/data/st.column_config/st.column_config.videocolumn">
195+
<Image pure alt="screenshot" src="/images/api/column_config.videocolumn.jpg" />
196+
197+
<h4>Video column</h4>
198+
199+
Configure a video column.
200+
201+
```python
202+
VideoColumn("Highlight clip", help="Double click to play.")
203+
```
204+
205+
</RefCard>
206+
181207
<RefCard href="/develop/api-reference/data/st.column_config/st.column_config.areachartcolumn">
182208
<Image pure alt="screenshot" src="/images/api/column_config.areachartcolumn.jpg" />
183209

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
title: st.column_config.AudioColumn
3+
slug: /develop/api-reference/data/st.column_config/st.column_config.audiocolumn
4+
description: st.column_config.AudioColumn configures audio columns for playing audio directly within dataframe cells from URLs or file paths.
5+
keywords: st.column_config.AudioColumn, audio column, play audio, audio urls, audio dataframe, inline audio, dataframe audio
6+
---
7+
8+
<Autofunction function="streamlit.column_config.AudioColumn" />
Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
---
2+
title: st.column_config.VideoColumn
3+
slug: /develop/api-reference/data/st.column_config/st.column_config.videocolumn
4+
description: st.column_config.VideoColumn configures video columns for displaying videos directly within dataframe cells from URLs or file paths.
5+
keywords: st.column_config.VideoColumn, video column, display videos, video urls, video dataframe, inline videos, video display, dataframe videos
6+
---
7+
8+
<Autofunction function="streamlit.column_config.VideoColumn" />

content/develop/api-reference/testing/st.testing.v1.AppTest.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,8 @@ Note that you can also retrieve elements within a specific container in the same
6161

6262
<Autofunction function="AppTest.expander" />
6363

64+
<Autofunction function="AppTest.file_uploader" />
65+
6466
<Autofunction function="AppTest.header" />
6567

6668
<Autofunction function="AppTest.info" />

0 commit comments

Comments
 (0)