Change Log for Shiny (for Python)

All notable changes to Shiny for Python will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[UNRELEASED]

New features

• session.destroy() now accepts an optional module id. The parent that inserted a module's UI under an id can tear down that module's scope with session.destroy(id), without the module having to hand back a cleanup handle. (#2264)

Bug fixes

• Fixed ui.input_submit_textarea() failing inside module namespaces. The internal submit button's ID was built from the already-resolved (namespaced) textarea ID, causing a double-namespace when input_task_button resolved it again. (#2262)

[1.6.2] - 2026-05-21

Bug fixes

• Adapted py-shiny to the htmltools 0.7.0 sibling-classes refactor. No runtime behavior change. (#2244)

• Bumped lodash/lodash-es to 4.18.1 in the js-react template lockfile for CVE-2025-13465. (#2233)

• Fixed render.DataGrid() column headers and hovered rows not adapting to dark mode when ui.input_dark_mode() is enabled. The data grid now uses Bootstrap 5.3 mode-aware color tokens (--bs-tertiary-bg, --bs-primary-bg-subtle, --bs-emphasis-color, --bs-secondary-color), with the legacy values preserved as fallbacks. (#1635)

[1.6.1] - 2026-05-01

New features

• Added session.destroy() and session.on_destroy() for cleaning up reactive objects (effects, calcs, values) when dynamically inserted module UI is removed. Calling session.destroy() on a module's session fires all registered destroy callbacks, which stop effects, invalidate calcs and values, and remove namespaced inputs and outputs from the reactive graph. Reactive objects automatically register weak destroy callbacks so they can be garbage collected when no longer referenced, even before session end. (#2209)

Improvements

• @reactive.calc, @reactive.effect, and render decorators (e.g. @render.text) now raise a TypeError if the decorated function has required parameters, since Shiny never supplies arguments to these functions. Functions with default parameter values emit a warning, as the defaults will always be used. (Thanks, @mvanhorn!) (#2200)

• Output resize/visibility detection now uses native browser observers (ResizeObserver, IntersectionObserver) instead of relying on jQuery shown/hidden events and window.resize. This makes Shiny's client-side output-info pipeline (image/plot sizing, hidden-state tracking, theme reporting) work automatically in any layout — including CSS-only show/hide, third-party tab components, and non-Bootstrap frameworks — without requiring custom event hooks. This also introduces a shiny:themechange event for code that needs to trigger theme clientdata refreshes after changing surrounding visual theme context. (rstudio/shiny#3682)

• panel_conditional() no longer briefly flashes its contents on app start when the condition is initially False. (rstudio/shiny#3505)

Bug fixes

• Fixed server-side input deduplication so that all values received from the client always trigger reactive invalidation. (#1600, #2219)

• Fixed a caret drift issue in ui.input_code_editor() where the cursor would appear to the right of the actual text insertion point when certain themes or on some operating systems. (#2223)

• Fixed OpenTelemetry name inference for reactive.Value to handle type-annotated assignments (e.g., counter: reactive.Value[int] = reactive.Value(0)), generic subscript calls (e.g., reactive.Value[int](0)), and multiline assignments where the Value() call is on a continuation line (e.g., assignments split across lines with parentheses or multiline type annotations). This fixes anonymous OTel labels for packages like shinychat that use multiline reactive.Value assignments. (#2205)

[1.6.0] - 2026-03-20

OpenTelemetry

• Added the SHINY_OTEL_COLLECT environment variable to set the default collection level globally. Available levels: (#2143)

  • "none" - Disables all Shiny-specific telemetry collection. Use this for sensitive operations where you don't want Shiny to emit any spans or logs.
  • "session" - Captures session lifecycle spans that track when user sessions are starting and ending. This provides basic visibility into session activity without detailed reactive execution information.
  • "reactive_update" - Captures everything from "session" plus reactive flush cycle spans that show when reactive invalidation and re-execution occurs. This helps identify performance bottlenecks in reactive updates without the overhead of per-reactive-component instrumentation.
  • "reactivity" - Captures everything from "reactive_update" plus individual reactive execution spans (reactive.calc, reactive.effect, extended_task), info-level logs for reactive value updates (including source file, line number, and column position), and debug-level logs for extended task queue operations. This provides comprehensive visibility into reactive execution flow and timing.
  • "all" [Default] - Currently equivalent to "reactivity" and represents the most comprehensive telemetry available. This is the default collection level when SHINY_OTEL_COLLECT is not set (or is explicitly set to all).

• Added otel.suppress and otel.collect to control Shiny's internal OpenTelemetry instrumentation per-function or per-block. Use @otel.suppress / @otel.collect (no-parens decorators) to stamp a single function, or with otel.suppress(): / with otel.collect(): (context managers) to control telemetry during reactive object creation. otel.suppress disables Shiny's internal reactivity telemetry; otel.collect re-enables reactivity telemetry when the global default has been lowered. Both only affect Shiny's internal spans — user-defined OpenTelemetry spans are unaffected. (#2143)

• Added OpenTelemetry example application (examples/open-telemetry/) demonstrating console exporter, collection control with @otel.suppress and @otel.collect, and side-by-side comparison of normal, suppressed, and force-enabled telemetry. The OpenTelemetry SDK is available via the optional [otel] dependency group: pip install shiny[otel]. Note: If you're already using an observability package with OpenTelemetry integration (e.g., logfire), it likely already includes opentelemetry-sdk, so you may not need to explicitly install the [otel] group. (#2143)

New features

• Added toolbar component with ui.toolbar(), ui.toolbar_input_button(), ui.toolbar_input_select(), ui.toolbar_divider(), ui.toolbar_spacer(), ui.update_toolbar_input_button(), and ui.update_toolbar_input_select(). Toolbars are compact UI containers designed for small form elements suitable for card headers, footers, and other constrained spaces. They support flexible alignment (left/right), custom spacing and width, icon-only or labeled buttons with optional tooltips, select inputs with grouped choices, visual dividers for separating elements, and flexible spacers for split layouts. Server-side updates allow dynamic modification of button and select properties. (#2155)

• Added a new ui.input_code_editor() element that allows for light-weight code editing with syntax highlighting, using the prism-code-editor library. The editor supports 20+ languages, more than a dozen themes, and automatic light/dark mode switching. (#2128)

Improvements

• Reduced installed package size by ~400KB by excluding api-examples/ directories from wheel and source distributions. These examples are only needed when building documentation from the source repository. (#2126)

• Improved reactive value name inference to support all import styles: reactive.Value(), reactive.value(), Value(), and value() now all correctly infer variable names for better OpenTelemetry log messages. (#2178)

• Enhanced OpenTelemetry source reference attributes by adding code.column.number to track the column position of reactive value updates alongside existing file path, line number, and function name. (#2178)

• Improved OpenTelemetry collection level handling: reactive values now capture the collection level at initialization time (matching behavior of Calc and Effect), ensuring consistent telemetry behavior throughout the value's lifetime. (#2178)

Other changes

• Updated palmerpenguins dependency to version >=0.1.5 to include type stubs, removing the need for type ignore comments in tests. (#2157)

[1.5.1] - 2025-12-08

New features

• Added toast notification system with ui.toast(), ui.toast_header(), ui.show_toast(), and ui.hide_toast(). Toast notifications are temporary, non-intrusive messages that support multiple semantic types (success, warning, error, etc.), flexible positioning (9 positions: top/middle/bottom × left/center/right), auto-hide with configurable duration, optional headers with icons, and programmatic control. (#2111)

• Added a new input_submit_textarea() input element, which is similar to input_text_area(), but includes a submit button to only submit the text changes to the server on click. This is especially useful when the input text change triggers a long-running operation and/or the user wants to type longer-form input and review it before submitting it. (#2099)

Bug fixes

• Fixed ui.tooltip()'s options parameter to properly pass Bootstrap tooltip options to the underlying web component. (#2101)

• Fixed an issue where session.bookmark() would error when non-existent input values are read. (#2117)

• Revised accordion()'s open logic to close all panels when an empty list is passed. (#2109)

[1.5.0] - 2025-09-11

New features

• Added AI-powered test generator for Shiny applications. Use shiny add test to automatically generate comprehensive Playwright tests for your apps using AI models from Anthropic or OpenAI. (#2041)

• ui.sidebar() is now interactively resizable. (#2020)

• ui.sidebar() gains a fillable argument to support vertical fill behavior in sidebars. (#2077)

• Added ui.insert_nav_panel(), ui.remove_nav_panel(), and ui.update_nav_panel() to support dynamic navigation. (#90)

• navset_card_*() now gains a full_screen option. (#1451)

• ui.update_*() functions now accept ui.TagChild (i.e., HTML) as input to the label and icon arguments. (#2020)

• The .output_*() methods of the ClientData class (e.g., session.clientdata.output_height()) can now be called without an id when called inside a @render function. (#1978)

• playwright.controller.InputActionButton gains a expect_icon() method. As a result, the already existing expect_label() no longer includes the icon. (#2020)

Breaking changes

• The ui.Chat and ui.MarkdownStream components are now imported from the new shinychat library. Future versions of shinychat will likely deprecate and remove some features from Chat. If you still want to use those features with the latest Shiny, we suggest pinning shinychat to it's initial release (v0.1.0). (#2051)

• express.ui.insert_accordion_panel()'s function signature has changed to be more ergonomic. Now you can pass the panel_title and panel_contents directly instead of ui.hold()ing the ui.accordion_panel() context manager. (#2042)

Improvements

• Improved the styling and readability of markdown tables rendered by ui.Chat() and ui.MarkdownStream(). (#1973)

• input_date(), input_date_range(), update_date(), and update_date_range() now support "" for values, mins, and maxes. In this case, no date will be specified on the client. (#1713) (#1689)

• Restricted the allowable types of the choices parameter of input_select(), input_selectize(), update_select(), and update_selectize() to actual set of allowable types (previously, the type was suggesting HTML-like values were supported). (#2048)

• Added module support for session.clientdata methods. This allows you to access client data values in Shiny modules without needing to namespace the keys explicitly. (#1978)

• Added timeout_secs parameter to create_app_fixture to allow testing apps with longer startup times. (#2033)

• Add support for selecting menu items in Navset controllers to improve dropdown navigation test coverage. (#2066)

• Python 3.13 is now offically supported and tested. (#1711)

Bug fixes

• Fixed issue where apps run in Workbench were unexpectedly crashing. Apps running in Workbench will now have ws_per_message_deflate=False enforced. (#2005)

• include_js() and include_css() now work as expected in multi-user settings and also when multiple files from the same directory are included. (#2061, #2069)

• Fixed numerous issues related to programmatically updating selectize options. (#2053)

  • update_selectize(options=...) no longer gets ignored when server=False (the default).
  • update_selectize(options=...) now works as expected in a module.

• Fixed an issue with update_selectize(server=True) not properly displaying labels with HTML reserved characters like "&" (#1330)

• Fixed an issue with ui.Chat() sometimes wanting to scroll a parent element. (#1996)

• Fix several issues with bookmarking error reporting and documentation. (#2076, #1984, #1983)

• input_date() and input_date_range() once again use the client's (not the server) current date as the default value. (#2060)

• Fixed false positive warning in layout_columns() about number of widths vs elements. (#1704)

• Fixed set() method of the InputSelectize test controller so it clears existing selections before applying new values. (#2024)

Deprecations

• ui.update_navs() is deprecated in favor of ui.update_navset(). (#2047)

• ui.panel_well() is deprecated in favor of ui.card(). (#2038)

• selectize, remove_button, and options parameters of ui.input_select() have been deprecated; use ui.input_selectize() instead. (Thanks, @ErdaradunGaztea!) (#1947)

[1.4.0] - 2025-04-08

New features

• Added support for bookmarking Shiny applications. Bookmarking allows users to save the current state of an application and return to it later. This feature is available in both Shiny Core and Shiny Express. (#1870, #1915, #1919, #1920, #1922, #1934, #1938, #1945, #1955)

  • To enable bookmarking in Express mode, set shiny.express.app_opts(bookmark_store=) during the app's initial construction.
  • To enable bookmarking in Core mode, set shiny.App(bookmark_store=) when constructing the app object.

• Added a new .enable_bookmarking(client) method to ui.Chat(). This method will attach bookmark hooks to save and restore the chat's messages and client state. (#1951, #1954)

• Both ui.Chat() and ui.MarkdownStream() now support the inclusion of Shiny UI elements inside of messages. This allows for gathering input from the user (e.g., ui.input_select()), displaying of rich output (e.g., render.DataGrid()), and more. (#1868)

• Added a new .message_stream_context() method to ui.Chat(). This context manager is a useful alternative to .append_message_stream() when you want to: (1) Nest a stream within another and/or (2) Overwrite/replace streaming content. (#1906)

Changes

• Express mode's app_opts() requires all arguments to be keyword-only. If you are using positional arguments, you will need to update your code. (#1895)

• The .get_latest_stream_result() method on ui.MarkdownStream() was deprecated in favor of the new .latest_stream property. Call .result() on the property to get the latest result, .status to check the status, and .cancel() to cancel the stream.

• MarkdownStream() now has a default maximum width of 680px for better readability. Also, similar to Chat(), it now also horizontally centers itself. (#1944)

• ui.page_navbar() and ui.navset_bar() now correctly apply theme and additional attributes from navbar_options created with ui.navbar_options(). (#1942)

Bug fixes

• Fixed an issue where the <main> areas of ui.page_sidebar() and ui.page_navbar() (with a sidebar) were made to be a fillable containers even when fillable=False. (#1816)

• Fixed an issue where the .update_user_input() method on ui.Chat() isn't working in shinylive. (#1891)

• Fixed an issue where width and height on MarkdownStream() were not working as intended. (#1944)

• Fixed an issue with the .click() method on InputActionButton controllers in shiny.playwright.controllers where the method would not work as expected. (#1886)

[1.3.0] - 2025-03-03

New features

• Added a new ui.MarkdownStream() component for performantly streaming in chunks of markdown/html strings into the UI. This component is primarily useful for text-based generative AI where responses are received incrementally. (#1782)

• The ui.Chat() component now supports input suggestion links. This feature is useful for providing users with clickable suggestions that can be used to quickly input text into the chat. This can be done in 2 different ways (see #1845 for more details):

  • By adding a .suggestion CSS class to an HTML element (e.g., <span class="suggestion">A suggestion</span>)
  • Add a data-suggestion attribute to an HTML element, and set the value to the input suggestion text (e.g., <span data-suggestion="Suggestion value">Suggestion link</span>)
  • To auto-submit the suggestion when clicked by the user, include the .submit class or the data-suggestion-submit="true" attribute on the HTML element. Alternatively, use Cmd/Ctrl + click to auto-submit any suggestion or Alt/Opt + click to apply any suggestion to the chat input without submitting.

• The ui.Chat() component also gains the following:

  • The .on_user_submit() decorator method now passes the user input to the decorated function. This makes it a bit easier to access the user input. See the new templates (mentioned below) for examples. (#1801)
  • The assistant icon is now configurable via ui.chat_ui() (or the ui.Chat.ui() method in Shiny Express) or for individual messages in the .append_message() and .append_message_stream() methods of ui.Chat(). (#1853)
  • A new latest_message_stream property was added for an easy way to reactively read the stream's status, result, and also cancel an in progress stream. (#1846)
  • The .append_message_stream() method now returns the reactive.extended_task instance that it launches. (#1846)
  • The ui.Chat() component's .update_user_input() method gains submit and focus options that allow you to submit the input on behalf of the user and to choose whether the input receives focus after the update. (#1851)

• shiny create includes new and improved ui.Chat() template options. Most of these templates leverage the new {chatlas} package, our opinionated approach to interfacing with various LLM. (#1806)

• Client data values (e.g., url info, output sizes/styles, etc.) can now be accessed in the server-side Python code via session.clientdata. For example, session.clientdata.url_search() reactively reads the URL search parameters. (#1832)

• Available input ids can now be listed via dir(input). This also works on the new session.clientdata object. (#1832)

• ui.input_text(), ui.input_text_area(), ui.input_numeric() and ui.input_password() all gain an update_on option. update_on="change" is the default and previous behavior, where the input value updates immediately whenever the value changes. With update_on="blur", the input value will update only when the text input loses focus or when the user presses Enter (or Cmd/Ctrl + Enter for ui.input_text_area()). (#1874)

• Added a new .add_sass_layer_file() method to ui.Theme that supports reading a Sass file with layer boundary comments, e.g. /*-- scss:defaults --*/. This format is supported by Quarto and makes it easier to store Sass rules and declarations that need to be woven into Shiny's Sass Bootstrap files. (#1790)

• Added a new expect_max_height() method to the Valuebox controllers to check the maximum height of a value box (#1816)

• shiny.pytest.create_app_fixture(app) gained support for multiple app file paths when creating your test fixture. If multiple file paths are given, it will behave as a parameterized fixture value and execute the test for each app path. (#1869)

Breaking changes

• The navbar-related style options of ui.page_navbar() and ui.navset_bar() have been consolidated into a single navbar_options argument that pairs with a new ui.navbar_options() helper. Using the direct position, bg, inverse, collapsible, and underline arguments will continue to work with a deprecation message. (#1822)

  Related to this change, ui.navset_bar() now defaults to using underline=True so that it uses the same set of default ui.navbar_options() as the page variant. In ui.navbar_options(), inverse is replaced by theme, which takes values "light" (dark text on a light background), "dark" (light text on a dark background), or "auto" (follow page settings).

• The Shiny Core component shiny.ui.Chat() no longer has a .ui() method. This method was never intended to be used in Shiny Core (in that case, use shiny.ui.chat_ui()) to create the UI element. Note that the shiny.express.ui.Chat() class still has a .ui() method. (#1840)

Bug fixes

• ui.Chat() now correctly handles new ollama.chat() return value introduced in ollama v0.4. (#1787)

• Updated expect_height() for Valuebox controllers to check the height property instead of max-height. (#1816)

[1.2.1] - 2024-11-14

Bug fixes

• Branded theming via ui.Theme.from_brand() now correctly applies monospace inline and block font family choices. (#1762)

• Compatibility with websockets>=14.0, which has changed its public APIs. Shiny now requires websockets 13 or later. (#1769)

[1.2.0] - 2024-10-29

Breaking changes

• .expect_inverse() for Navset controllers in shiny.playwright.controllers now requires a bool value. To keep behavior the same, use .expect_inverse(False). (#1668)

• .expect_layout() for Navset controllers in shiny.playwright.controllers is now renamed to .expect_fluid() and requires a bool value. To keep behavior the same, use .expect_fluid(True). (#1668)

• .expect_icon() for Accordion controllers in shiny.playwright.controllers now requires a bool value instead of a str. (#1710)

New features

• New features for @render.data_frame:

  • Added narwhals support for @render.data_frame. This allows for any eager data frame supported by narwhals to be returned from a @render.data_frame output method. All internal methods and helper methods now leverage the narwhals API to be data frame agnostic. (#1570)

  • Added .data_patched() reactive calculation that applies all .cell_patches() to .data(). (#1719)

  • Added .update_cell_value() method to programmatically update the contents of a data frame cell. (#1719)

  • Added .update_data() method to update the rendered data without resetting any user sort or filter. Note, all user edits will be forgotten. (#1719)

• Added narwhals support for @render.table. This allows for any eager data frame supported by narwhals to be returned from a @render.table output method. (#1570)

• Shiny now supports theming via brand.yml with a single _brand.yml file. Call ui.Theme.from_brand() with __file__ or the path to a _brand.yml file and pass the resulting theme to the theme argument of express.ui.page_opts() (Shiny Express) or ui.page_*() functions (Shiny Core) to apply the brand theme to the entire app. (#1743)

• chat_ui() and Chat.ui() gain a messages parameter for providing starting messages. (#1736)

Other changes

• Incorporated orjson for faster data serialization in @render.data_frame outputs. (#1570)

• Added PageNavbar class to the list of shiny.playwright.controllers for testing ui.page_navbar(). (#1668)

• Added .expect_widths() to NavsetPillList in shiny.playwright.controllers for testing ui.navset_pill_list(widths=). (#1668)

• Added .expect_title() for Popover in shiny.playwright.controllers (#1683)

• Added .expect_disabled() for InputActionButton in shiny.playwright.controllers (#1705)

• Small improvements to the default pulse busy indicator to better blend with any background. It's also now slightly smaller by default.(#1707)

• Added .expect_class(), .expect_gap(), .expect_bg_color(), .expect_desktop_state(), .expect_mobile_state(), .expect_mobile_max_height(), .expect_title(), and .expect_padding() for Sidebar in shiny.playwright.controllers (#1715)

• Modified .expect_text() for Sidebar in shiny.playwright.controllers to use .loc_content instead of loc for text. Also modified .expect_width() to check the .loc_container's style instead of the .loc element. (#1715)

• Modified .expect_text() and .expect_width() for Sidebar in shiny.playwright.controllers to use loc_content instead of loc for text. (#1715)

• Added .expect_class() and .expect_multiple() for Accordion in shiny.playwright.controllers (#1710)

Bug fixes

• A few fixes for ui.Chat(), including:

  • Fixed a bug with Chat() sometimes silently dropping errors. (#1672)
  • Fixed a bug with Chat() sometimes not removing it's loading icon (on error or a None transform). (#1679)
  • .messages(format="anthropic") correctly removes non-user starting messages (once again). (#1685)

• shiny create now uses the template id rather than the directory name as the default directory. (#1666)

• ui.Theme() now works correctly on Windows when the theme requires Sass compilation. (Thanks, @yuuuxt!) (#1684)

• Fixed multiple input controllers (InputSlider, InputDate, InputDateRange, InputCheckbox, and InputCheckboxGroup) in shiny.playwright.controller to check the width property within the style attribute. (#1691, #1696, #1702)

• Fixed multiple input controllers (InputSwitch, InputRadioButtons, InputNumeric, InputText, InputTextArea, InputPassword, InputActionButton, and InputActionLink) in shiny.playwright.controller to correctly validate the width style property in `.expect_width(). (#1705)

• Fixed input controller InputTextArea in shiny.playwright.controller to correctly validate the resize style property in .expect_resize(). (#1705)

• Fixed a bug in ui.conditional_panel() that would cause the panel to repeatedly show/hide itself when the provided condition did not evaluate to a boolean value. (#1707)

• Fixed a bug with ui.input_slider() when used as a range slider that made it impossible to change the slider value when both handles were at the maximum value. (#1707)

• Fixed bug in @render.data_frame where bool or object columns were not being rendered. (#1570)

• Fixed output controller OutputDataFrame in shiny.playwright.controller to correctly assert the number of rows in .expect_nrow() as the total number of virtual rows, not the number of currently displaying rows. (#1719)

• Fixed issue where @render.download did not respect the module namespacing. (Thanks, @nsiicm0!) (#1732)

• Added workaround in Accordion in shiny.playwright.controller where .expect_open() and .expect_panels() would hang while resolving a playwright locator. (Thanks, @joesho112358!) (#1165)

[1.1.0] - 2024-09-03

New features

• ui.Chat() gains a new .update_user_input() method, which adds the ability to update the input placeholder message. As a result, .set_user_message() is now deprecated (since the new method can also be used to update the message). (#1594)

• shiny create now supports a succinct format for specifying the GitHub repository via the --github flag, e.g. --github posit-dev/py-shiny-templates. You can now also use --github and --template together, in which case --github should point to a repository containing a directory matching the name provided in --template. (#1623)

• shiny create now identifies templates in external repositories using a _template.json metadata file. This file should contain at an "id" and optionally a "title" and "description". When shiny create is called with the --github flag but without a --template flag, it will offer a menu listing all available templates in the repository. (#1631)

Other changes

• A few changes for ui.Chat(), including:
  • The .messages() method no longer trims messages by default (i.e., the default value of token_limits is now None instead of the overly generic and conservative value of (4096, 1000)). See the new generative AI in production templates (via shiny create) for examples of setting token_limits based on the model being used. (#1657)
  • User input that contains markdown now renders the expected HTML. (#1607)
  • Busy indication is now visible/apparent during the entire lifecycle of response generation. (#1607)

Bug fixes

• A few fixes for ui.Chat(), including:

  • A fix for use inside Shiny modules. (#1582)
  • .messages(format="google") now returns the correct role. (#1622)
  • transform_assistant_response can now return None and correctly handles change of content on the last chunk. (#1641)

• An empty ui.input_date() value no longer crashes Shiny. (#1528)

• Fixed bug where calling .update_filter(None) on a data frame renderer did not visually reset non-numeric column filters. (It did reset the column's filtering, just not the label). Now it resets filter's label. (#1557)

• Require shinyswatch >= 0.7.0 and updated examples accordingly. (#1558)

• ui.input_text_area(autoresize=True) now resizes properly even when it's not visible when initially rendered (e.g. in a closed accordion or a hidden tab). (#1560)

• ui.notification_show(duration=None) now persists the notification until the app user closes it. (#1577)

• Some copies of Windows 10 have registry entries mapping .js files to content type "text/plain", which was causing all sorts of problems for browsers. (#1624)

• Added missing support for express.ui.navset_card_pill(placement:). (#1602)

• Added .expect_sidebar() and .expect_title() methods for NavsetCardTab, NavsetCardPill, NavsetCardUnderline, and NavsetBar. (#1602)

• Added .expect_placement() method for NavsetCardPill and NavsetCardUnderline. (#1602)

Deprecations

[1.0.0] - 2024-07-18

New features

• Added a new shiny.ui.Chat class for building conversational interfaces with fully customizable and performant response generation. (#1453)

• Expose shiny.playwright, shiny.run, and shiny.pytest modules that allow users to testing their Shiny apps. (#1448, #1456, #1481)

  • shiny.playwright contains controller and expect submodules. controller will contain many classes to interact with (and verify!) your Shiny app using Playwright. expect contains expectation functions that enhance standard Playwright expectation methods.
  • shiny.run contains the run_shiny_app command and the return type ShinyAppProc. ShinyAppProc can be used to type the Shiny app pytest fixtures.
  • shiny.pytest contains pytest test fixtures. The local_app pytest fixture is automatically available and runs a sibling app.py file. Where as create_app_fixture(PATH_TO_APP) allows for a relative path to a Shiny app to be instantiated from a different folder.

• Added CLI command shiny add test to add a test file to an existing Shiny app. (#1461)

• @render.data_frame, render.DataGrid, and render.DataTable now support polars data frames (#1474).

• @render.data_frame, render.DataGrid, and render.DataTable are now type aware. This means that the data frame renderer object's .data() and .data_view() methods will return the same type of data given the the renderer. E.g. If a DataGrid wrapping a polars data frame is returned to the renderer function, .data_view() will return polars data. (#1502)

• @render.data_frame's render.DataGrid and render.DataTable added support for cell styling with the new styles= parameter. This parameter can receive a style info object (or a list of style info objects), or a function that accepts a data frame and returns a list of style info objects. Each style info object can contain the rows and cols locations where the inline style and/or CSS class should be applied. (#1475)

• @render.data_frame has added a few new methods:

  • .data_view_rows() is a reactive value representing the sorted and filtered row numbers. This value wraps input.<ID>_data_view_rows()(#1374)
  • .sort() is a reactive value representing the sorted column information (dictionaries containing col: int and desc: bool). This value wraps input.<ID>_sort(). (#1374)
  • .filter() is a reactive value representing the filtered column information (dictionaries containing col: int and value which is either a string or a length 2 array of at least one non-None number). This value wraps input.<ID>_filter(). (#1374)
  • .update_sort(sort=) allows app authors to programmatically update the sorting of the data frame. (#1374)
  • .update_filter(filter=) allows app authors to programmatically update the filtering of the data frame. (#1374)

• @render.data_frame now accepts both a non-"none" selection_mode value and editable=True. (#1454, #1534)

• @render.data_frame's <ID>.cell_selection() no longer returns a None value and now always returns a dictionary containing both the rows and cols keys. This is done to achieve more consistent author code when working with cell selection. When the value's type="none", both rows and cols are empty tuples. When type="row", cols represents all column numbers of the data. In the future, when type="col", rows will represent all row numbers of the data. These extra values are not available in input.<ID>_cell_selection() as they are independent of cells being selected and are removed to reduce information being sent to and from the browser. (#1376)

• Relative imports, like from . import utils, now can be used in Shiny Express apps. (#1464)

• ui.Theme allows you to create custom themes for your Shiny app by recompiling Bootstrap and Shiny's Sass files with your own customizations. Themes created with ui.Theme can be passed directly to the theme argument of express.ui.page_opts() (Shiny Express) or ui.page_*() functions (Shiny Core) to apply the theme to the entire app. This feature requires the libsass package which can be installed with pip install libsass. (#1358)

• ui.card_body() can be used to wrap the contents of elements in ui.card(), allowing you to change parameters like fillable or padding and gap for groups of elements in the card. (#1506)

Other changes

• ui.input_action_button() and ui.update_action_button() gain a disabled argument. When the button is disabled, it appears grayed out and cannot be clicked. (#1465)

• The main content area of ui.page_sidebar() and ui.page_navbar() with a page-level sidebar now have a minimum height and width to avoid squashed content in fillable layouts. The minimum height and width are controllable via --bslib-page-main-min-{width,height} CSS variables. (#1436)

• Added a new option to place an always-open sidebar above the main content on mobile screens by providing open={"mobile": "always-above"} to ui.sidebar(). (#1436)

Bug fixes

• Fixed #1440: When a Shiny Express app with a www/ subdirectory was deployed to shinyapps.io or a Connect server, it would not start correctly. (#1442)

• Fixed #1498: Update table related TypeScript dependencies to their latest versions. This fixed an issue where the Row Virtualizer would scroll to the end when hidden. This would cause the DOM to update numerous times, locking up the browser tab for multiple seconds. (#1524, #1550)

• The return type for the data frame patch function now returns a list of render.CellPatch objects (which support htmltools.TagNode for the value attribute). These values will be set inside the data frame's .data_view() result. This also means that .cell_patches() will be a list of render.CellPatch objects. (#1526)

• Made sure all @render.data_frame cells that have been edited are now restored back to ready state to handle the off chance that the returned patches are at different locations the the original edit patches. (#1529)

• remove_all_fill(tag) no longer modifies the original tag input and instead returns a modified copy of tag. (#1538)

Deprecations

• The following deprecated functions have now been removed (#1546):

  • shiny.ui.panel_sidebar() was deprecated in v0.6.0; use shiny.ui.sidebar() instead.
  • shiny.ui.panel_main() was deprecated in v0.6.0; instead pass items directly to shiny.ui.layout_sidebar().
  • shiny.ui.navset_pill_card() was deprecated in v0.6.0; use shiny.ui.navset_card_pill() instead.
  • shiny.ui.navset_tab_card() was deprecated in v0.6.0; use shiny.ui.navset_card_tab() instead.
  • shiny.ui.nav() was deprecated in v0.6.1; use shiny.ui.nav_panel() instead.

• @render.data_frame, render.DataGrid, and render.DataTable have deprecated support for data frame types that are pandas compatible. Please call .to_pandas() on your data before it is returned to the renderer (#1502). Currently, both polars and pandas data frames are supported (#1474). If you'd like to add support for a new data frame type, please open an issue or a pull request.

• @render.data_frame's .cell_selection() will no longer return None when the selection mode is "none". In addition, missing rows or cols information will be populated with appropiate values. This allows for consistent handling of the cell selection object. (#1374)

• @render.data_frame's input value input.<ID>_data_view_indices() has been deprecated. Please use <ID>.data_view_rows() to retrieve the same information. (#1377)

• @render.data_frame's input value input.<ID>_column_sort() has been deprecated. Please use <ID>.sort() to retrieve the same information. (#1374)

• @render.data_frame's input value input.<ID>_column_filter() has been deprecated. Please use <ID>.filter() to retrieve the same information. (#1374)

• Deprecated functions in shiny.experimental have been removed. By and large, these functions are now available in the main shiny namespace. (#1540)

• We've deprecated several card-related shiny.experimental.ui functions that were moved to the main shiny.ui namespace in v0.6.0. Both card() and card_body() are no longer experimental and can be called via shiny.ui.card() and shiny.ui.card_body() directly. shiny.experimental.ui.card_title() is now deprecated, but can be replaced with shiny.ui.tags.h5() or shiny.ui.card_header(). (#1543)

[0.10.2] - 2024-05-28

Bug fixes

• Fixed an issue with output spinners only showing for a split second. (#1429)

[0.10.1] - 2024-05-23

Bug fixes

• Fixed an issue with opacity dimming occurring too often/quickly when outputs are recalculating. (#1415)

[0.10.0] - 2024-05-23

Deprecations

• Restored @render.data_frame's (prematurely removed in v0.9.0) input value input.<ID>_selected_rows(). Please use <ID>.cell_selection()["rows"] and consider input.<ID>_selected_rows() deprecated. (#1345, #1377)

• @render.data_frame's method .input_cell_selection() has been renamed to .cell_selection(). Please use .cell_selection() and consider .input_cell_selection() deprecated. (#1407)

New features

• Added busy indicators to provide users with a visual cue when the server is busy calculating outputs or otherwise serving requests to the client. More specifically, a spinner is shown on each calculating/recalculating output, and a pulsing banner is shown at the top of the page when the app is otherwise busy. Use the new ui.busy_indicator.options() function to customize the appearance of the busy indicators and ui.busy_indicator.use() to disable/enable them. (#918)

• Added support for creating modules using Shiny Express syntax, and using modules in Shiny Express apps. (#1220)

• ui.page_*() functions gain a theme argument that allows you to replace the Bootstrap CSS file with a new CSS file. theme can be a local CSS file, a URL, or a shinyswatch theme. In Shiny Express apps, theme can be set via express.ui.page_opts(). (#1334)

Bug fixes

• Fixed an issue that prevented Shiny from serving the font.css file referenced in Shiny's Bootstrap CSS file. (#1342)

• Removed temporary state where a data frame renderer would try to subset to selected rows that did not exist. (#1351, #1377)

• Fix an issue in the data frame output which caused the table to freeze when filters removed previously selected cells. (#1412)

Other changes

• Session is now an abstract base class, and AppSession is a concrete subclass of it. Also, ExpressMockSession has been renamed ExpressStubSession and is a concrete subclass of Session. (#1331)

• The Session class now has a method is_stub_session(). For ExpressStubSession, this method returns True for , and AppSession objects it returns False. (#1331)

• Closed #1293: The error console would display error messages if an app was disconnected and the user changed an input. (#1339)

• Fixed an issue where some CSS files were larger than necessary because they had source maps embedded in them. (#1339)

[0.9.0] - 2024-04-16

Breaking Changes

• @render.data_frame return values of DataTable and DataGrid had their parameter of row_selection: Literal["single", "multiple"] become deprecated. Please use selection_mode="row" or selection_mode="rows" instead. (#1198)

• The col_widths argument of ui.layout_columns() now sets the sm breakpoint by default, rather than the md breakpoint. For example, col_widths=(12, 6, 6) is now equivalent to {"sm": (12, 6, 6)} rather than {"md": (12, 6, 6)}. (#1222)

New features

• Session objects now have a set_message_handler(name, fn) method that allows you to register a message handler function that will be called when a request message with the given name is received from the client (via Shiny.shinyapp.makeRequest() (JS)). (#1253)

• Experimental: @render.data_frame return values of DataTable and DataGrid support editable=True to enable editing of the data table cells. (#1198)

• ui.card() and ui.value_box() now take an id argument that, when provided, is used to report the full screen state of the card or value box to the server. For example, when using ui.card(id = "my_card", full_screen = TRUE) you can determine if the card is currently in full screen mode by reading the boolean value of input.my_card_full_screen(). (#1215, #1266)

• Added support for using shiny.express in Quarto Dashboards. (#1217)

• ui.value_box(), ui.layout_columns() and ui.layout_column_wrap() now all have min_height and max_height arguments. These are useful in filling layouts, like ui.page_fillable(), ui.page_sidebar(fillable=True) or ui.page_navbar(fillable=True). For example, you can use ui.layout_columns(min_height=300, max_height=500) to ensure that a set of items (likely arranged in a row of columns) are always between 300 and 500 pixels tall. (#1223)

• Added an error console which displays errors in the browser's UI. This is enabled by default when running applications locally, and can be disabled with shiny run --no-dev-mode. It is not enabled for applications that are deployed to a server. (#1060)

• shiny create was updated to include some additional templates as well as an option to choose from the new templates website. (#1273, #1277, #1274)

• shiny.express.ui.page_opts() now accepts additional keyword arguments that are passed to the underlying page layout chosen by shiny.ui.page_auto(). (#1314)

Bug fixes

• On Windows, Shiny Express app files are now read in as UTF-8. (#1203)

• input_dark_mode() now accepts a style argument that can be used to customize the appearance and position of the dark mode toggle switch. (#1207)

• Calling ui.update_selectize() with choices and selected now clears the current selection before updating the choices and selected value. (#1221)

• Fixed an issue that could happen with a ui.card() or ui.value_box() that is rendered dynamically via @render.ui when an updated card replaces a card that the user has expanded into full screen mode. Now the full screen state is reset for the new card or value box. If you want to update a card without potentially exiting the full-screen mode, update specific parts of the card using ui.output_ui() or ui.output_text(). (#1221)

• ui.layout_columns() now correctly applies the row_heights at the xs breakpoint, if supplied. (#1222)

• ui.panel_conditional() now adds the .shiny-panel-conditional class to the <div> element wrapping the conditional panel contents. (#1257)

• ui.panel_conditional() no longer results in unwanted double padding when the parent container uses gap for spacing multiple elements (e.g., when used in ui.layout_columns(), ui.page_fillable(), etc). (#1266)

• Error messages now use var(--bs-danger) instead of var(--bs-danger-text-emphasis) for the text color. (#1266)

Other changes

• The fill CSS used by fillable containers (i.e. when fillable=True) now uses a CSS cascade layer named htmltools to reduce the precedence order of the fill CSS. (#1228)

[0.8.1] - 2024-03-06

Breaking Changes

• ui.page_sidebar() now places the title element in a .navbar container that matches the structure of page_navbar(). This ensures that the title elements of page_sidebar() and page_navbar() have consistent appearance. (#1176)

Bug fixes

• Shiny now compiles the Bootstrap 5-based stylesheets for component styles imported from https://github.com/rstudio/shiny. (#1191)

• Fixed the CSS for ui.output_ui() to avoid unwanted double padding when its parent container uses gap for spacing multiple elements (e.g., ui.layout_columns(), ui.page_fillable(), etc). (#1176)

Other changes

• Closed #1178: Removed run-time dependency on asgiref. (#1183)

• The uvicorn and click packages are no longer needed when running on Emscripten. (#1187)

• We adjusted the shadows used for cards and popovers. Cards now use a slightly smaller shadow and the same shadow style is also now used by popovers. (#1176)

• We increased the spacing between elements just slightly. This change is most noticeable in the layout_columns() or layout_column_wrap() component. In these and other components, you can use gap and padding arguments to choose your own values, or you can set the $bslib-spacer (Sass) or --bslib-spacer (CSS) variable. (#1176)

[0.8.0] - 2024-03-04

Breaking Changes

• Page-level sidebars used in ui.page_sidebar() and ui.page_navbar() will now default to being initially open but collapsible on desktop devices and always open on mobile devices. You can adjust this default choice by setting ui.sidebar(open=). (#1129)

• ui.sidebar() is now a thin wrapper for the internal ui.Sidebar class. The ui.Sidebar class has been updated to store the sidebar's contents and settings and to delay rendering until the sidebar HTML is actually used. Because most users call ui.sidebar() instead of using the class directly, this change is not expected to affect many apps. (#1129)

New features

• Added ui.input_dark_mode(), a toggle switch that allows users to switch between light and dark mode. By default, when ui.input_dark_mode() is added to an app, the app's color mode follows the users's system preferences, unless the app author sets the mode argument. When ui.input_dark_mode(id=) is set, the color mode is reported to the server, and server-side color mode updating is possible using ui.update_dark_mode(). (#1149)

• ui.sidebar(open=) now accepts a dictionary with keys desktop and mobile, allowing you to independently control the initial state of the sidebar at desktop and mobile screen sizes. (#1129)

• Closed #984: In Shiny Express apps, if there is a "www" subdirectory in the app's directory, Shiny will serve the files in that directory as static assets, mounted at /. (#1170)

• For Shiny Express apps, added express.app_opts(), which allows setting application-level options, like static_assets and debug. (#1170)

• Closed #1079: For Shiny Express apps, automatically run a globals.py file in the same directory as the app file, if it exists. The code in globals.py will be run with the session context set to None. (#1172)

Bug fixes

• Fixed input_task_button not working in a Shiny module. (#1108)

• Fixed several issues with page_navbar() styling. (#1124)

• Fixed Renderer.output_id to not contain the module namespace prefix, only the output id. (#1130)

• Fixed gap-driven spacing between children in fillable nav_panel() containers. (#1152)

• Fixed #1138: An empty value in a date or date range input would cause an error; now it is treated as None. (#1139)

Other changes

• @render.data_frame now properly fills its container by default. (#1126)

• We improved the accessibility of the full screen toggle button in cards created with ui.card(full_screen=True). Full-screen cards are now also supported on mobile devices. (#1129)

• When entering and exiting full-screen card mode, Shiny now emits a client-side custom bslib.card event that JavaScript-oriented users can use to react to the full screen state change. (#1129)

• The sidebar's collapse toggle now has a high z-index value to ensure it always appears above elements in the main content area of ui.layout_sidebar(). The sidebar overlay also now receives the same high z-index on mobile layouts. (#1129)

• Updated example apps to use lower-case versions of reactive.Calc->reactive.calc, reactive.Effect->reactive.effect, and reactive.Value->reactive.value. (#1164)

• Closed #1081: The @expressify() function now has an option has_docstring. This allows the decorator to be used with functions that contain a docstring. (#1163)

• Replaced use of sys.stderr.write() with print(file=sys.stderr), because on some platforms sys.stderr can be None. (#1131)

• Replaced soon-to-be deprecated datetime method calls when handling shiny.datetime inputs. (#1146)

[0.7.1] - 2024-02-05

Bug fixes

• Fixed render.download not working in Express. (#1085)

• express.ui.hold() can now accept any type of object, instead of just TagChild objects. (#1089)

• Fixed an issue where input_selectize would not initialize correctly when created within a Shiny module. (#1091)

[0.7.0] - 2024-01-25

Breaking Changes

• Closed #938: page_sidebar() and page_navbar() now use fillable=False by default. (#990)

New features

• Added shiny.ui.input_task_button() for creating buttons that launch longer-running tasks than shiny.ui.input_action_button() was designed for. Task buttons give visual feedback that the task is running, and cannot be clicked again until the task is complete. (#907)

• Added @extended_task decorator for creating long-running tasks that can be cancelled. (#907)

• Added @render.download as a replacement for @session.download, which is now deprecated. (#977)

• Added ui.output_code(), which is currently an alias for ui.output_text_verbatim(). (#997)

• Added @render.code, which is an alias for @render.text, but in Express mode, it displays the result using ui.output_code(). (#997)

• Added App.on_shutdown method for registering a callback to be called when the app is shutting down. (#907)

• You can now pass options to ui.input_selectize see the selectize.js docs for available options. (#914, #158)

• ui.input_selectize gains the remove_button argument which allows you to control the visibility of the remove button.

Bug fixes

• CLI command shiny create... (#965)

  • has added a -d/--dir flag for saving to a specific output directory
  • will raise an error if if will overwrite existing files
  • prompt users to install requirements.txt

• Fixed js-react template build error. (#965)

• Fixed #1007: Plot interaction with plotnine provided incorrect values. (#999)

Developer features

• Output renderers should now be created with the shiny.render.renderer.Renderer class. This class should contain either a .transform(self, value) method (common) or a .render(self) (rare). These two methods should return something can be converted to JSON. In addition, .default_ui(self, id) should be implemented by returning htmltools.Tag-like content for use within Shiny Express. To make your own output renderer, please inherit from the Renderer[IT] class where IT is the type (excluding None) required to be returned from the App author. (#964)
  • Legacy renderers that will be removed in the near future:
    • shiny.render.RenderFunction
    • shiny.render.RenderFunctionAsync
    • shiny.render.transformer.OutputRenderer
    • shiny.render.transformer.OutputRendererSync
    • shiny.render.transformer.OutputRendererAsync

Other changes

• Pinned Starlette to version <0.35.0; versions 0.35.0 and 0.35.1 caused problems when deploying on Posit Connect. (#1009 )

[0.6.1.1] - 2023-12-22

Bug fixes

• Fixed #935: shiny create required the requests package, but it was not listed as a dependency. It now uses urllib instead, which is part of the Python standard library. (#940)

[0.6.1] - 2023-12-18

New features

• shiny create now allows you to select from a list of template apps.

• shiny create provides templates which help you build your own custom JavaScript components.

• Closed #814: The functions reactive.Calc and reactive.Effect have been changed to have lowercase names: reactive.calc, and reactive.effect. The old capitalized names are now aliases to the new lowercase names, so existing code will continue to work. Similarly, the class reactive.Value has a new alias, reactive.value, but in this case, since the original was a class, it keeps the original capitalized name as the primary name. The examples have not been changed yet, but will be changed in a future release. (#822)

• Added ui.layout_columns() for creating responsive column-forward layouts based on Bootstrap's 12-column CSS Grid. (#856)

• Added support for Shiny Express apps, which has a simpler, easier-to-use API than the existing API (Shiny Core). Please note that this API is still experimental and may change. (#767)

Bug fixes

• Fix support for shiny.ui.accordion(multiple=) (#799).

Other changes

• Closed #492: shiny.ui.nav() is now deprecated in favor of the more aptly named shiny.ui.nav_panel() (#876).

• Update penguins example to credit Allison Horst and drop usage of shiny.experimental (#798).

• as_fillable_container() and as_fill_item() no longer mutate the Tag object that was passed in. Instead, it returns a new Tag object. Also closed #856: these functions now put the html-fill-container and html-fill-item CSS classes last, instead of first. (#862)

• App() now accepts a server function with a single input parameter, or a server function with parameters input, output and session. Server functions with two or more than three parameters now raise an exception. (#920)

[0.6.0] - 2023-10-30

Breaking Changes

• shiny.run only allows positional arguments for app, host, and port, all other arguments must be specified with keywords.

New features

• shiny run now takes reload-includes and reload-excludes to allow you to define which files trigger a reload (#780).

• shiny.run now passes keyword arguments to uvicorn.run (#780).

• The @output decorator is no longer required for rendering functions; @render.xxx decorators now register themselves automatically. You can still use @output explicitly if you need to set specific output options (#747, #790).

• Added support for integration with Quarto (#746).

• Added shiny.render.renderer_components decorator to help create new output renderers (#621).

• Added shiny.experimental.ui.popover(), update_popover(), and toggle_popover() for easy creation (and server-side updating) of Bootstrap popovers. Popovers are similar to tooltips, but are more persistent, and should primarily be used with button-like UI elements (e.g. input_action_button() or icons) (#680).

• Added CSS classes to UI input methods (#680) .

• Session objects can now accept an asynchronous (or synchronous) function for .on_flush(fn=), .on_flushed(fn=), and .on_ended(fn=) (#686).

• App() now allows static_assets to represent multiple paths. To do this, pass in a dictionary instead of a string (#763).

• The showcase_layout argument of value_box() now accepts one of three character values: "left center", "top right", "bottom". (#772)

• value_box() now supports many new themes and styles, or fully customizable themes using the new value_box_theme() function. To reflect the new capabilities, we've replaced theme_color with a new theme argument. The previous argument will continue work as expected, but with a deprecation warning. (#772)

  In addition to the Bootstrap theme names (primary ,secondary, etc.), you can now use the main Boostrap colors (purple, blue, red, etc.). You can also choose to apply the color to the background or foreground by prepending a bg- or text- prefix to the theme or color name. Finally, we've also added new gradient themes allowing you to pair any two color names as bg-gradient-{from}-{to} (e.g., bg-gradient-purple-blue).

  These named color themes aren't limited to value boxes: because they're powered by small utility classes, you can use them anywhere within your bslib-powered UI.

• Added shiny.ui.showcase_bottom(), a new shiny.ui.value_box() layout that places the showcase below the value box title and value, perfect for a full-bleed plot. (#772)

Bug fixes

• shiny run now respects the user provided reload-dir argument (#765).

• Fixed #646: Wrap bare value box value in <p /> tags. (#668)

• Fixed #676: The render.data_frame selection feature was underdocumented and buggy (sometimes returning None as a row identifier if the pandas data frame's index had gaps in it). With this release, the selection is consistently a tuple of the 0-based row numbers of the selected rows--or None if no rows are selected. (#677)

• Added tests to verify that ui input methods, ui labels, ui update (value) methods, and ui output methods work within modules (#696).

• Adjusted the @render.plot input type to be object to allow for any object (if any) to be returned (#712).

• In layout_column_wrap(), when width is a CSS unit -- e.g. width = "400px" or width = "25%" -- and fixed_width = FALSE, layout_column_wrap() will ensure that the columns are at least width wide, unless the parent container is narrower than width. (#772)

Other changes

• input_action_button() now defaults to having whitespace around it. (#758)

• layout_sidebar() now uses an <aside> element for the sidebar's container and a <header> element for the sidebar title. The classes of each element remain the same, but the semantic meaning of the elements is now better reflected in the HTML markup. (#772)

• layout_sidebar() no longer gives the sidebar main content area the role="main" attribute. (#772)

• Improved the style and appearance of the button to enter full screen in card()s and value_box()es to better adapt to Bootstrap's dark mode. (#772)

API changes

• Added shiny.ui.navset_underline() and shiny.ui.navset_card_underline() whose navigation container is similar to shiny.ui.navset_tab() and shiny.ui.navset_card_tab() respectively, but its active/focused navigation links are styled with an underline. (#772)

• shiny.ui.layout_column_wrap(width, *args) was rearranged to shiny.ui.layout_column_wrap(*args, width). Now, width will default to 200px is no value is provided. (#772)

• shiny.ui.showcase_left_center() and shiny.ui.showcase_top_right() no longer take two values for the width argument. Instead, they now take a single value (e.g., width = "30%") representing the width of the showcase are in the value box. Furthermore, they've both gained width_full_screen arguments that determine the width of the showcase area when the value box is expanded to fill the screen. (#772)

• shiny.ui.panel_main() and shiny.ui.panel_sidebar() are deprecated in favor of new API for shiny.ui.layout_sidebar(). Please use shiny.ui.sidebar() to construct a sidebar= and supply it to shiny.ui.layout_sidebar(sidebar, *args, **kwargs). (#788)

• shiny.experimental.ui.toggle_sidebar() has been renamed to shiny.ui.update_sidebar(). It's open value now only supports bool values. (#788)

API relocations

• shiny.ui's navset_pill_card() and navset_tab_card() have been renamed to navset_card_pill() and navset_card_tab() respectively (#492).

The following methods have been moved from shiny.experimental.ui and integrated into shiny.ui (final locations under shiny.ui are displayed) (#680):

• Sidebar - Sidebar layout or manipulation

  • sidebar(), page_sidebar(), update_sidebar(), layout_sidebar(), Sidebar

• Filling layout - Allow UI components to expand into the parent container and/or allow its content to expand

  • page_fillable(), fill.as_fillable_container(), fill.as_fill_item(), fill.remove_all_fill()
  • output_plot(fill=), output_image(fill=), output_ui(fill=, fillable=)

• CSS units - CSS units and padding

  • css.as_css_unit(), css.as_css_padding(), css.CssUnit

• Tooltip - Hover-based context UI element

  • tooltip(), update_tooltip()

• Popover - Click-based context UI element

  • popover(), update_popover()

• Accordion - Vertically collapsible UI element

  • accordion(), accordion_panel(), insert_accordion_panel(), remove_accordion_panel(), update_accordion(), update_accordion_panel(), Accordion, AccordionPanel

• Card - A general purpose container for grouping related UI elements together

  • card(), card_header(), card_footer(), CardItem

• Valuebox - Opinionated container for displaying a value and title

  • valuebox()
  • showcase_left_center()
  • showcase_top_right()

• Navs - Navigation within a page

  • navset_bar(), navset_tab_card(), navset_pill_card()
  • page_navbar(sidebar=, fillable=, fillable_mobile=, gap=, padding=), navset_card_tab(sidebar=), navset_card_pill(sidebar=), navset_bar(sidebar=, fillable=, gap=, padding=)

• Layout - Layout of UI elements

  • layout_column_wrap()

• Inputs - UI elements for user input

  • input_text_area(autoresize=)

If a ported method is called from shiny.experimental.ui, a deprecation warning will be displayed.

Methods still under consideration in shiny.experimental.ui:

• card(wrapper=): A function (which returns a UI element) to call on unnamed arguments in card(*args) which are not already shiny.ui.CardItem objects.

• card_body(): A container for grouping related UI elements together

• card_image(): A general container for an image within a shiny.ui.card.

• card_title(): A general container for the "title" of a shiny.ui.card.

API removals

• shiny.experimental.ui.FillingLayout has been removed. (#481)

• shiny.experimental.ui.toggle_switch() has been made defunct. Please remove it from your code and use shiny.ui.update_switch() instead. (#772)

• shiny.experimental.ui.as_width_unit() has been made defunct. Please remove it from your code. (#772)

• shiny.experimental.ui' as_fill_carrier(), is_fill_carrier(), is_fillable_container(), and is_fill_item() have been made defunct. Remove them from your code. (#680, #788)

• Support for min_height=, max_height=, and gap= in shiny.experimental.ui.as_fillable_container() and as_fill_item() has been removed. (#481)

• shiny.experimental.ui.TagCallable has been made defunct. Please use its type is equivalent to htmltools.TagFunction. (#680)

[0.5.1] - 2023-08-08

Bug fixes

• Fixed #666: Added missing sidebar stylesheet dependency. (#667)

[0.5.0] - 2023-08-01

New features

• The new fast-scrolling data table/grid feature (ui.output_data_frame/render.data_frame) now has a filtering feature. To enable, pass the argument filters=True to the render.DataTable or render.DataGrid constructors. (#592)

• shiny run now takes a --reload-dir <DIR> argument that indicates a directory --reload should (recursively) monitor for changes, in addition to the app's parent directory. Can be used more than once. (#353)

• The default theme has been updated to use Bootstrap 5 with custom Shiny style enhancements. (#624)

• Added experimental UI tooltip(), update_tooltip(), and toggle_tooltip() for easy creation (and server-side updating) of Bootstrap tooltips (a way to display additional information when focusing (or hovering over) a UI element). (#629)

Bug fixes

• Using update_slider to update a slider's value to a datetime object or other non-numeric value would result in an error. (#649)

Other changes

• Documentation updates. (#591)

• Removed Python 3.7 support. (#590)

[0.4.0] - 2023-06-26

New features

• Added new fast-scrolling data table and data grid outputs. (#538)

• Added include_js() and include_css(), for easily including JS and CSS files in an application. (#127)

• Added sidebar, card, value box, and accordion methods into shiny.experimental.ui. (#481)

• Added fill and fillable methods into shiny.experimental.ui. If fill is True, then the UI component is allowed to expand into the parent container. If fillable is True, then the UI component will allow its content to expand. Both fill on the child component and fillable on the parent component must be True for the child component to expand. (#481)

• Added sidebar methods into shiny.experimental.ui. shiny.experimental.ui.layout_sidebar() does not require ui.panel_main() and ui.panel_sidebar(). These two methods have been deprecated. x.ui.page_navbar(), x.ui.navset_bar(), x.navset_tab_card(), and x.navset.pill_card() added sidebar= support. (#481)

• feat(sidebar): ui.layout_sidebar() internally uses x.ui.layout_sidebar(), enabling filling layout features. (#568)

Bug fixes

• Fixed #496: Previously, when shiny run --reload was used, the app would only reload when a .py file changed. Now it will reload when .py, .css, .js, and .html files change. (#505)

• Closed #535: Added a meta viewport tag, so that page layout will adapt to mobile device screens. (#540)

[0.3.3] - 2023-04-26

New features

• Added shiny.experimental as a place to put experimental features. When using Shiny's experimental features, we recommend importing them by calling import shiny.experimental as x, so that all local function calls must start with x (e.g. x.ui.card()) to signify the method may be changed/removed without warning or future support. (#462)

• Added penguins example. (#462)

• The bootstrap HTMLDependency is now created using the dev version of {bslib} to get the latest features. (#462)

• Added shiny.experimental.ui.input_text_area(), which supports auto-resizing height to fit the content when autoresize=True. (#463)

Other changes

• shiny.reactive.lock is now exported. (#458)

[0.3.2] - 2023-04-19

Bug fixes

• Fixed #456: plot interaction with datetimes raised errors on 32-bit platforms. (#457)

Other changes

• When pyright creates type stubs for shiny, it now will include types imported in _typing_extensions.py.

[0.3.1] - 2023-04-18

Bug fixes

• Fixed #443: Errors in streaming downloads previously resulted in a partially downloaded file; now Shiny responds with a Transfer-Encoding: chunked header, which allows the browser to detect the error and abort the download. (#447)

Other changes

• page_navbar now accepts shinyswatch themes. (#455)

[0.3.0] - 2023-04-03

New features

• Added support for URL based HTMLDependencies. {htmltools} (v0.1.5.9001) added support for URL based HTMLDependencies in posit-dev/py-htmltools#53. (#437)

[0.2.10] - 2023-03-11

New features

• Added support for interacting with plots made with matplotlib, seaborn, and plotnine. (#392)

• The req() function now returns its first argument (assuming none of its arguments are falsey). This lets you perform validation on expressions as you assign, return, or pass them, without needing to introduce a separate statement just to call req().

• Added Input.__contains__ method, so that (for example) one could write an expression like if "x" in inputs. (#402)

Bug fixes

• The width parameters for input_select and input_slider now work properly. (Thanks, @bartverweire!) (#386)

• When input_select or input_selectize were not given an explicit select argument, they always chose the first item, which is correct when multiple=False, but not when multiple=True. Now when multiple=True, the first item is no longer automatically selected. (#396)

Other changes

• Switched to new types from htmltools 0.1.5. (#416)

[0.2.9] - 2022-11-03

Bug fixes

• Closed #240, #330: Fixed live examples with additional files. (#340)

• Fixed shiny run handling on Windows of absolute paths with drive letter, as in shiny run c:/myapp/app.py. (#370)

[0.2.8] - 2022-10-20

Bug fixes

• panel_conditional now works correctly inside of Shiny modules. (Thanks, @gcaligari!) (#336)

• Fix compatibility with Uvicorn 0.19.0 (#357)

[0.2.7] - 2022-09-27

New features

• shiny run now takes a --launch-browser argument that causes the default web browser to be launched after the app is successfully loaded. Also, the --port argument now interprets a value of 0 as "listen on a random port". (#329)

Other changes

• Updated API document generation with updated paths to work with new version of Shinylive. (#331)

[0.2.6] - 2022-09-02

New features

• Closed #312: Matplotlib plots in a @render.plot can now use the global figure, instead of returning a figure object. (#314)

• Disabled shiny static command, in favor of shinylive export from the shinylive package. (#326)

[0.2.5] - 2022-08-12

New features

• Closed #269: The UI for a shiny.App object can now be provided as a function. (#299)

• When a Shinylive deployment is made with shiny static, it the deployment code is now delegated to Shinylive. (#310)

Bug fixes

• Fixed #279: When a Shiny application is mounted to a Starlette route, reactivity did not work. (#294)

• Fixed #290: @render.plot now works as intended inside @module.server. (#292)

• Fixed #289: input_selectize() now resolves the input id before using for other id-like attributes (#291)

[0.2.4] - 2022-08-01

Bug fixes

• Fixed #287: Running shiny static on Windows failed with PermissionError. (#288)

[0.2.3] - 2022-07-28

Bug fixes

• Fixed #281: Directory creation for Shinylive assets could fail if the parent directory did not exist. (#283)

[0.2.2] - 2022-07-27

Initial release of Shiny for Python https://shiny.posit.co/py/