https://github.com/appsilon/shinygathering-tapyr
https://github.com/appsilon/shinygathering-tapyr
Last synced: 4 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/appsilon/shinygathering-tapyr
- Owner: Appsilon
- License: mit
- Archived: true
- Created: 2024-05-28T16:07:16.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-29T00:13:32.000Z (7 months ago)
- Last Synced: 2025-07-19T13:50:02.599Z (6 months ago)
- Language: Python
- Size: 140 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Tapyr - Shiny for Python Application Template
> Create and deploy enterprise-ready PyShiny dashboards with ease.
## Introduction
Tapyr is designed for data scientists and developers seeking a seamless transition from development to deployment, this template uses `poetry` for dependency management and `pytest`/`playwright` for comprehensive app validation/testing/quality assurance.
Ideal for projects aiming for high-quality code and efficient deployment on Posit Connect.
## Events
### Upcoming
Would you like to learn about Tapyr? Join our events!
* [**Open Source Spotlight: Tapyr - Shiny for Python Framework**](https://go.appsilon.com/tapyr-webinar-may2024?utm_source=community&utm_medium=github&utm_campaign=shinygathering)
2024-05-28 at 18:00 (UTC+1)
Shiny Gathering led by [Piotr Storożenko](https://www.linkedin.com/in/piotr-pasza-storo%C5%BCenko/)
## Docs
For comprehensive documentation, please visit our [documentation](https://connect.appsilon.com/tapyr-docs/).
## Getting Started
Check out our get started with `tapyr` [blog post](www.appsilon.com/post/introducing-tapyr).
### Using Devcontainer
To ensure a consistent development experience across all environments, we recommend using the [devcontainer](https://code.visualstudio.com/docs/remote/containers) configuration with Visual Studio Code or DevPod for container-based development.
1. **Start the Devcontainer**: Open the project in VS Code and select "Reopen in Container" when prompted, or use the Command Palette (`Ctrl+Shift+P`) and choose "Remote-Containers: Reopen in Container". Alternatively, use [DevPod](https://devpod.sh/) following their instructions.
2. **Activate the virtual environment**:
```sh
poetry shell
```
3. **Run the application**:
```sh
shiny run app.py --reload
```
4. **Execute tests**:
```sh
poetry run pytest
```
*Note*: The Devcontainer might limit some `playwright` features, such as `codegen`. For full functionality, consider a local setup.
### Setting Up Locally with Poetry
For developers preferring a local setup without Devcontainer:
1. **Install pipx**: Ensure pipx is installed for managing isolated CLI apps.
2. **Install Poetry**:
```sh
pipx install poetry
```
3. **Clone the repository** and navigate to it.
4. **Install dependencies**:
```sh
poetry install
playwright install
```
*Attention*: Follow any additional steps prompted by `playwright install`.
### Deployment on Posit Connect
Deploy your application to Posit Connect by:
1. **Exporting your API Key**:
```sh
export CONNECT_API_KEY="your_api_key_here"
```
2. **Configuring Posit Connect**:
```sh
rsconnect add \
--api-key $CONNECT_API_KEY \
--server \
--name
```
3. **Deploying**:
```sh
rsconnect deploy shiny -t "Tapyr App" .
```
Replace placeholders with your server URL, server name, and API key. Verify the deployment on Posit Connect for successful upload.
## :star2: Stay Updated
Don't miss out on important updates and exclusive content about Tapyr and PyShiny → [Subscribe to our newsletter](https://go.appsilon.com/shiny-weekly?utm_source=community&utm_medium=github&utm_content=tapyr).
Have questions or want to contribute? Engage with Appsilon's developers and the data science community on our [Shiny 4 All](https://go.appsilon.com/shiny4allcommunity).
---
Developed with :heart: at [Appsilon](https://appsilon.com).
Get in touch: .
Want to stay up to date with Tapyr and other packages? Join 4,2k explorers and get the [📧 Shiny Weekly Newsletter](https://go.appsilon.com/shiny-weekly?utm_source=community&utm_medium=github&utm_content=tapyr) into your mailbox and check our [Slack community](https://go.appsilon.com/shiny4allcommunity).
Explore the [Rhinoverse](https://rhinoverse.dev) - a family of R packages built around [Rhino](https://appsilon.github.io/rhino/)!
Appsilon is a
[**Posit (formerly RStudio) Full Service Certified Partner**](https://www.rstudio.com/certified-partners/).
