Shinylive Fundamentos de Python - Folha de dicas

Shinylive Instalação e implantação do Python

Instalação a partir do PyPI

Instale a versão estável mais recente do Shinylive Python:

pip install shinylive

Instalação a partir do GitHub

Para instalar a versão de desenvolvimento:

pip install git+https://github.com/posit-dev/py-shinylive.git

Exportando e implantando seu aplicativo

Exportar seu aplicativo Shiny como uma página da Web estática:

shinylive export my_app_dir my_site_dir

Visualizar localmente:

python3 -m http.server --directory my_site_dir 8000

Acesso em: http://localhost:8000

Tutorial detalhado sobre instalação e implementação

Criação de aplicativos Python Shinylive básicos

Exemplo mínimo de aplicativo Shinylive

from shiny import App, ui, render

app_ui = ui.page_fluid(
    ui.input_slider("n", "N", 0, 100, 40),
    ui.output_text_verbatim("result")
)

def server(input, output, session):
    @output
    @render.text
    def result():
        return f"You selected {input.n()}"

app = App(app_ui, server)

Exportação e visualização

shinylive export my_app my_site
python3 -m http.server --directory my_site

Guia detalhado para a criação de um aplicativo básico

Dicas de integração da Quarto para aplicativos Python

Instalando a extensão Shinylive Quarto

A partir do terminal em seu projeto Quarto:

quarto add quarto-ext/shinylive

Configuração YAML para Shinylive

Em seu documento .qmd:

---
format: html
filters:
  - shinylive
---

Incorporação de aplicativos na Quarto

```{shinylive-python}
#| standalone: true
from shiny import App, render, ui

app_ui = ui.page_fluid(
    ui.input_slider("n", "Number", 0, 10, 5),
    ui.output_text("out")
)

def server(input, output, session):
    @output
    @render.text
    def out():
        return f"Square of {input.n()} is {input.n()**2}"

app = App(app_ui, server)
```

Guia detalhado de integração da Quarto

#| '!! shinylive warning !!': |
#|   shinylive does not work in self-contained HTML documents.
#|   Please set `embed-resources: false` in your metadata.
#| standalone: true
#| viewerHeight: 300
from shiny import App, render, ui

app_ui = ui.page_fluid(
    ui.input_slider("n", "Number", 0, 10, 5),
    ui.output_text("out")
)

def server(input, output, session):
    @output
    @render.text
    def out():
        return f"Square of {input.n()} is {input.n()**2}"

app = App(app_ui, server)

Solução de problemas comuns

O aplicativo não carrega

• Verifique se a extensão Shinylive e as dependências estão instaladas corretamente.
• Verifique o caminho de exportação e os ativos estáticos.

Pacote Python ausente

Se um pacote estiver faltando:

import micropip
await micropip.install("pandas")

Compatibilidade com o navegador

• Use um navegador moderno, como Chrome, Firefox ou Edge.
• Verifique os logs do console do navegador (F12) para obter mensagens de erro detalhadas.

Guia avançado de solução de problemas

Leitura adicional

• Introdução ao Shinylive para Python
• Personalização avançada e solução de problemas

---

Explore mais artigos

Nota

Aqui estão mais artigos da mesma categoria para ajudá-lo a se aprofundar no tópico.