Skip to content

Commit

Permalink
Revert "Docs for ExtendedTask feature"
Browse files Browse the repository at this point in the history
  • Loading branch information
gadenbuie authored Jan 26, 2024
1 parent 64e1589 commit 1d27c41
Show file tree
Hide file tree
Showing 370 changed files with 9,494 additions and 29,486 deletions.
5 changes: 1 addition & 4 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -7,12 +7,9 @@
.DS_Store

/.luarc.json
__pycache__/
/__pycache__/
.Rproj.user
.Rhistory

/_inv/
/objects.json

.venv/
__pycache__/
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
local PATTERN = "# ?<<$"
local PATTERN = "#<<$"

local function ensureHtmlDeps()
quarto.doc.add_html_dependency({
Expand Down
161 changes: 82 additions & 79 deletions _quarto.yml
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@ project:
- display-messages
- layouts
- docs
- in-depth
- development
- gallery
- api
Expand Down Expand Up @@ -64,7 +65,9 @@ website:
search: true
left:
- text: "Learn"
file: docs/quick-start.qmd
file: docs/overview.qmd
- text: "Install"
href: docs/install.qmd
- text: "Deploy"
menu:
- docs/deploy-cloud.qmd
Expand All @@ -81,13 +84,15 @@ website:
target: _blank
- text: "Reference"
href: api/index.qmd
right:
- text: "Help"
href: docs/help.qmd
tools:
- icon: discord
href: https://discord.gg/yMGCamUMnS
aria-label: Shiny Discord
text: Shiny Discord
- icon: github
href: https://github.com/posit-dev/py-shiny/
aria-label: Shiny for Python Github
text: Shiny for Python Github

page-footer:
left: 'Proudly supported by <a href="https://www.posit.co/" class="no-icon"><img src="/images/posit-logo-black.svg" alt="Posit" width="80" style="padding-left: 3px;vertical-align:text-top;"></a>'
Expand All @@ -113,43 +118,43 @@ website:
href: components/
- section: "![](/images/sliders.svg){.sidebar-icon .sidebar-subtitle}__Inputs__"
contents:
- components/inputs/action-button/index.qmd
- components/inputs/action-link/index.qmd
- components/inputs/checkbox/index.qmd
- components/inputs/checkbox-group/index.qmd
- components/inputs/date-range-selector/index.qmd
- components/inputs/date-selector/index.qmd
- components/inputs/numeric-input/index.qmd
- components/inputs/password-field/index.qmd
- components/inputs/radio-buttons/index.qmd
- components/inputs/select-single/index.qmd
- components/inputs/select-multiple/index.qmd
- components/inputs/selectize-single/index.qmd
- components/inputs/selectize-multiple/index.qmd
- components/inputs/slider/index.qmd
- components/inputs/slider-range/index.qmd
- components/inputs/switch/index.qmd
- components/inputs/text-area/index.qmd
- components/inputs/text-box/index.qmd
- components/inputs/action-button.qmd
- components/inputs/action-link.qmd
- components/inputs/checkbox.qmd
- components/inputs/checkbox-group.qmd
- components/inputs/date-range-selector.qmd
- components/inputs/date-selector.qmd
- components/inputs/numeric-input.qmd
- components/inputs/password-field.qmd
- components/inputs/radio-buttons.qmd
- components/inputs/select-single.qmd
- components/inputs/select-multiple.qmd
- components/inputs/selectize-single.qmd
- components/inputs/selectize-multiple.qmd
- components/inputs/slider.qmd
- components/inputs/slider-range.qmd
- components/inputs/switch.qmd
- components/inputs/text-area.qmd
- components/inputs/text-box.qmd
- section: "![](/images/bar-chart-line-fill.svg){.sidebar-icon .sidebar-subtitle}__Outputs__"
contents:
- components/outputs/data-grid/index.qmd
- components/outputs/datatable/index.qmd
- components/outputs/image/index.qmd
- components/outputs/map-ipyleaflet/index.qmd
- components/outputs/plot-matplotlib/index.qmd
- components/outputs/plot-plotly/index.qmd
- components/outputs/plot-seaborn/index.qmd
- components/outputs/text/index.qmd
- components/outputs/ui/index.qmd
- components/outputs/value-box/index.qmd
- components/outputs/verbatim-text/index.qmd
- components/outputs/data-grid.qmd
- components/outputs/datatable.qmd
- components/outputs/image.qmd
- components/outputs/map-ipyleaflet.qmd
- components/outputs/plot-matplotlib.qmd
- components/outputs/plot-plotly.qmd
- components/outputs/plot-seaborn.qmd
- components/outputs/text.qmd
- components/outputs/ui.qmd
- components/outputs/value-box.qmd
- components/outputs/verbatim-text.qmd
- section: "![](/images/chat-dots-fill.svg){.sidebar-icon .sidebar-subtitle}__Display Messages__"
contents:
- components/display-messages/modal/index.qmd
- components/display-messages/notifications/index.qmd
- components/display-messages/progress-bar/index.qmd
- components/display-messages/tooltips/index.qmd
- components/display-messages/modal.qmd
- components/display-messages/notifications.qmd
- components/display-messages/progress-bar.qmd
- components/display-messages/tooltips.qmd

- id: layouts
collapse-level: 2
Expand All @@ -159,82 +164,84 @@ website:
- section: "![](/images/navbars-blue.svg){.sidebar-icon .sidebar-subtitle}__Navbars__"
contents:
- text: "Navbar at Top"
href: "/layouts/navbars/index.html#navbar-at-top"
href: "/layouts/navbars.html#navbar-at-top"
- text: "Navbar at Bottom"
href: "/layouts/navbars/index.html#navbar-at-bottom"
href: "/layouts/navbars.html#navbar-at-bottom"
- section: "![](/images/sidebars-blue.svg){.sidebar-icon .sidebar-subtitle}__Sidebars__"
contents:
- text: "Sidebar on Left"
href: "/layouts/sidebars/index.html#sidebar-on-the-left"
href: "/layouts/sidebars.html#sidebar-on-the-left"
- text: "Sidebar on Right"
href: "/layouts/sidebars/index.html#sidebar-on-the-right"
href: "/layouts/sidebars.html#sidebar-on-the-right"
- text: "Sidebar Within a Card"
href: "/layouts/sidebars/index.html#sidebar-within-a-card"
href: "/layouts/sidebars.html#sidebar-within-a-card"
- text: "Collapsed Sidebar"
href: "/layouts/sidebars/index.html#collapsed-sidebar"
href: "/layouts/sidebars.html#collapsed-sidebar"
- section: "![](/images/tabs-blue.svg){.sidebar-icon .sidebar-subtitle}__Tabs__"
contents:
- text: "Tabset with Pill Navigation"
href: "/layouts/tabs/index.html#tabset-with-pill-navigation"
href: "/layouts/tabs.html#tabset-with-pill-navigation"
- text: "Tabset with Pill List Navigation"
href: "/layouts/tabs/index.html#tabset-with-pill-list-navigation"
href: "/layouts/tabs.html#tabset-with-pill-list-navigation"
- text: "Tabset with Tab Navigation"
href: "/layouts/tabs/index.html#tabset-with-tab-navigation"
href: "/layouts/tabs.html#tabset-with-tab-navigation"
- text: "Card with a Tabbed Tabset"
href: "/layouts/tabs/index.html#card-with-a-tabbed-tabset"
href: "/layouts/tabs.html#card-with-a-tabbed-tabset"
- text: "Card with a Pill Tabset"
href: "/layouts/tabs/index.html#card-with-a-pill-tabset"
href: "/layouts/tabs.html#card-with-a-pill-tabset"
- text: "Vertically Collapsing Accordions"
href: "/layouts/tabs/index.html#vertically-collapsing-accordion-panels"
href: "/layouts/tabs.html#vertically-collapsing-accordion-panels"
- section: "![](/images/cards-blue.svg){.sidebar-icon .sidebar-subtitle}__Panels & Cards__"
contents:
- text: "Main Image w/ Floating Panel"
href: "/layouts/panels-cards/index.html#main-image-with-panel-floating-above"
href: "/layouts/panels-cards.html#main-image-with-panel-floating-above"
- text: "Content Divided by Cards"
href: "/layouts/panels-cards/index.html#content-divided-by-cards"
href: "/layouts/panels-cards.html#content-divided-by-cards"
- section: "![](/images/arrange-blue.svg){.sidebar-icon .sidebar-subtitle}__Arrange Elements__"
contents:
- text: "Grid Layouts"
href: "/layouts/arrange/index.html#grid-layouts"
href: "/layouts/arrange.html#grid-layouts"
- text: "Column Nesting"
href: "/layouts/arrange/index.html#column-nesting"
href: "/layouts/arrange.html#column-nesting"
- text: "Controlling for Page Size"
href: "/layouts/arrange/index.html#controlling-for-page-width-and-height"
href: "/layouts/arrange.html#controlling-for-page-width-and-height"

- id: docs
style: "floating"
collapse-level: 2
align: left
contents:
- section: "Get Started"
contents:
- docs/quick-start.qmd
- docs/dashboards.qmd
- docs/jupyter-widgets.qmd
- section: "Workflow"
- section: "Essentials"
contents:
- docs/install-create-run.qmd
- docs/debug.qmd
- docs/overview.qmd
- docs/inputs.qmd
- docs/outputs.qmd
- docs/server.qmd
- section: "Reactivity"
contents:
- docs/reactive-foundations.qmd
- docs/reactive-patterns.qmd
- docs/reactive-programming.qmd
- docs/reactive-calculations.qmd
- docs/reactive-events.qmd
- docs/reactive-values.qmd
- docs/reactive-mutable.qmd
- section: "User interfaces"
- section: "Page Layout and Style"
contents:
- docs/ui-components.qmd
- docs/ui-page-layouts.qmd
- docs/ui-styling.qmd
- docs/ui-navigation.qmd
- docs/ui-dynamic.qmd
- docs/ui-html.qmd
- docs/ui-customize.qmd
- section: "Express vs Core"
- docs/ui-feedback.qmd
- docs/ui-static.qmd
- section: "Workflow"
contents:
- docs/express-introduction.qmd
- docs/express-in-depth.qmd
- docs/express-to-core.qmd
- section: "Modules"
- docs/workflow-modules.qmd
- docs/workflow-module-communication.qmd
- docs/running-debugging.qmd
- section: "In Depth"
contents:
- docs/modules.qmd
- docs/module-communication.qmd
- docs/ipywidgets.qmd
- docs/ui-html.qmd
- docs/workflow-server.qmd
- section: "Extending"
contents:
- docs/custom-component-one-off.qmd
Expand All @@ -243,10 +250,6 @@ website:
contents:
- docs/comp-streamlit.qmd
- docs/comp-r-shiny.qmd
- section: "Miscellaneous"
contents:
- docs/nonblocking.qmd
- docs/routing.qmd
# TODO: if the sidebar only has 1 entry, then it displays for the entire site...
# added entry below to prevent this.
- id: deploy
Expand Down
51 changes: 23 additions & 28 deletions api/index.qmd
Original file line number Diff line number Diff line change
@@ -1,51 +1,46 @@
# API Reference Intro

This page details the Shiny's full API.
New users are encouraged to start from the [Quick Start tutorial](../docs/quick-start.qmd), and then come back here when you're ready to learn more.
We recommend newcomers start with [Shiny Express](../docs/express-introduction.qmd) instead of the more structured Shiny Core API.
This website documents the public API of Shiny for Python. See the [Getting Started tutorial](/docs/get-started.qmd) for a more approachable introduction to the API.
The left-hand sidebar gives quick access to the full public API, and the table of contents below shows the same entries plus a brief summary for each.
Most of the reference pages include a live example app at the bottom, or at least mention another page with a relevant example.

::: {.panel-tabset .panel-underline .border-0 .p-0 .justify-content-center}
We've intentionally designed Shiny's API so that you can `from shiny import *` to get access to most of what you need for most apps without introducing an excessive amount of namespace pollution.
Namely, it gives you:

### Express
* User interface (UI/HTML) helpers, available via the `ui` subpackage.

```{shinylive-python}
#| standalone: true
#| components: [editor, viewer]
#| layout: vertical
#| viewerHeight: 150
* To avoid clashing with this `ui` namespace when you do `from shiny import *`, you'll want to name you UI object something else, like `app_ui`.

from shiny.express import input, render, ui
* Reactive programming utilities, available via the `reactive` subpackage.
* Decorators for rendering `output`, available via the `render` subpackage.

ui.input_slider("val", "Slider label", min=0, max=100, value=50)
* 3rd party packages that want to implement their own rendering functions are encouraged to use a `@render_foo()` naming convention so users may import with `from mypkg import render_foo`.

@render.text
def slider_val():
return f"Slider value: {input.val()}"
```
* A handful of other things you'll want for most apps (e.g., `App`, `Module`, etc).
* If you're using type checking, you'll also want to use the `Inputs`, `Outputs`, and `Session` Classes
to type the instances supplied to your server function, for example:

### Core

```{shinylive-python}
#| standalone: true
#| components: [editor, viewer]
#| layout: vertical
#| viewerHeight: 150
from shiny import App, render, ui
#| viewerHeight: 400
## file: app.py
from shiny import *
app_ui = ui.page_fixed(
ui.input_slider("val", "Slider label", min=0, max=100, value=50),
ui.output_text_verbatim("slider_val")
app_ui = ui.page_fluid(
ui.input_slider("n", "Value of n", min=1, max=10, value=5),
ui.output_text("n2")
)
def server(input, output, session):
def server(input: Inputs, output: Outputs, session: Session) -> None:
@output
@render.text
def slider_val():
return f"Slider value: {input.val()}"
def n2():
return f"The value of n*2 is {input.n() * 2}"
app = App(app_ui, server)
```

:::

{{< include _api_index.qmd >}}
6 changes: 3 additions & 3 deletions components/_metadata.yml
Original file line number Diff line number Diff line change
@@ -1,12 +1,12 @@
sidebar: components
sidebar: components
format:
html:
css: _partials/components.css
toc: false
code-line-numbers: true
code-overflow: scroll
include-after-body: _partials/componentsjs.html
filters:
- quarto
- line-highlight
- shinylive
- shinylive

2 changes: 0 additions & 2 deletions components/_partials/components-detail-example.ejs

This file was deleted.

19 changes: 0 additions & 19 deletions components/_partials/components-detail-relevant-functions.ejs

This file was deleted.

Loading

0 comments on commit 1d27c41

Please sign in to comment.