Skip to content

Commit

Permalink
Update shiny-vscode extension link and name (#58)
Browse files Browse the repository at this point in the history
  • Loading branch information
gadenbuie authored Jul 9, 2024
1 parent 63cbd08 commit 76dab34
Showing 1 changed file with 10 additions and 10 deletions.
20 changes: 10 additions & 10 deletions index.qmd
Original file line number Diff line number Diff line change
Expand Up @@ -8,11 +8,11 @@ This website is under active development and will be unstable.

# Background

This workshop is aimed at people who are somewhat familiar with doing data analysis in Python, but do not have much of a background in Shiny. If you are brand new to Python we recommend spending a bit of time familiarizing yourself with the following topics before the workshop:
This workshop is aimed at people who are somewhat familiar with doing data analysis in Python, but do not have much of a background in Shiny. If you are brand new to Python we recommend spending a bit of time familiarizing yourself with the following topics before the workshop:

- How to install Python packages in a virtual environment
- How to do basic data manipulation with pandas or polars
- How to draw plots
- How to install Python packages in a virtual environment
- How to do basic data manipulation with pandas or polars
- How to draw plots
- How to clone a repository with git

# Setup
Expand All @@ -21,24 +21,24 @@ There are two ways to work through the examples and exercises in this workshop.

## 1) In your web browser with Shinylive

Shinylive allows you to run full-featured shiny apps in your browser, and includes a basic editor which is good enough to run examples.
Shinylive allows you to run full-featured shiny apps in your browser, and includes a basic editor which is good enough to run examples.
As a result you should be able to work through all of the examples in the workshop using just the browser without installing anything locally.

## 2) Locally with VS Code

While Shinylive is great, it likely isn't the environment you'll use to develop Shiny apps, and so it makes sense to set up VS Code and run the examples locally. To do this follow these steps before the workshop:

1) Install [VS Code](https://code.visualstudio.com/)
2) Install the Shiny for Python [VS Code extension](https://marketplace.visualstudio.com/items?itemName=posit.shiny-python)
2) Install the [Shiny extension for VS Code](https://marketplace.visualstudio.com/items?itemName=posit.shiny)
3) Clone the repository with `git clone https://github.com/rstudio/shiny-python-workshop-2023.git`, or alternately download the repository as a zip file: \
![](images/git-download-button.png){width="287"}
4) Navigate to the project directory and create a new virtual environment with `python3 -m venv .venv`
5) Set your python interpreter to the virtual environment with `CMD + SHIFT + P` \> `Select Interpreter`
6) Open a new terminal prompt, which should switch to `(.venv)`
7) Install the relevant packages with `pip install -r requirements.txt`

All of the example apps are stored in the `/apps` directory.
The examples are in `apps/examples` and the problem sets are in `apps/problem-sets`.
If you've installed the Shiny for Python VS Code extension, you can run any of the apps by opening the `app.py` file and clicking the play button in the top right. ([See screenshot](https://camo.githubusercontent.com/5d947e6dff7d74fd1cf221e79583105c42e4986ae673ce79733ce5edbfdcdda5/68747470733a2f2f7368696e792e7273747564696f2e636f6d2f70792f646f63732f6173736574732f7673636f64652e706e67))
All of the example apps are stored in the `/apps` directory.
The examples are in `apps/examples` and the problem sets are in `apps/problem-sets`.
If you've installed the Shiny extension for VS Code, you can run any of the apps by opening the `app.py` file and clicking the play button in the top right. ([See screenshot](https://camo.githubusercontent.com/5d947e6dff7d74fd1cf221e79583105c42e4986ae673ce79733ce5edbfdcdda5/68747470733a2f2f7368696e792e7273747564696f2e636f6d2f70792f646f63732f6173736574732f7673636f64652e706e67))

Alternatively, run them from the command line with `shiny run <path-to-app.py> --reload`.
Alternatively, run them from the command line with `shiny run <path-to-app.py> --reload`.

0 comments on commit 76dab34

Please sign in to comment.