Skip to content

Commit 8a4cb5a

Browse files
committed
Shorten positron-ide README to the standard title-and-link form
1 parent d52462c commit 8a4cb5a

1 file changed

Lines changed: 1 addition & 35 deletions

File tree

positron-ide/README.md

Lines changed: 1 addition & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -1,37 +1,3 @@
11
# Positron IDE: A Hands-on Python Tutorial
22

3-
Sample code for the Real Python tutorial [Positron IDE: A Hands-on Python Tutorial](https://realpython.com/positron-ide/).
4-
5-
## Setup
6-
7-
Open this folder in Positron and run the following command in its terminal:
8-
9-
```console
10-
uv sync --locked
11-
```
12-
13-
Select the project's `.venv` for both the Python Console and the notebook kernel. The project uses Python 3.14 and pins its starting dependencies in `pyproject.toml` and `uv.lock`.
14-
15-
## Prepare and Analyze the Data
16-
17-
Run `src/prepare_sales.py` cell by cell in Positron, or run it from this folder:
18-
19-
```console
20-
uv run src/prepare_sales.py
21-
```
22-
23-
Positron's Console starts at the project root, so the scripts set `PROJECT_ROOT = Path.cwd()`. A notebook kernel starts in the notebook's own folder instead, so `notebooks/explore_sales.ipynb` uses `Path.cwd().parent`.
24-
25-
This creates `data/sales_clean.csv`. It checks for missing values, duplicates, and inconsistent totals, corrects a column name, parses dates, and normalizes category labels. It preserves all 5,130 source rows.
26-
27-
Next, run the cells in `src/analyze_sales.py` to inspect descriptive statistics, compare median order values between retail and wholesale orders, and view a Matplotlib chart. Use Positron's **Run Cell** controls to keep the resulting objects available in the Console and Variables pane.
28-
29-
## Run the Notebook
30-
31-
Open `notebooks/explore_sales.ipynb` and run its cells in order. The notebook covers the same ground as both scripts, from loading the raw CSV through cleaning, describing, grouping, and charting the data. It creates its own variables independently of the Console session, so you can run it without running the scripts first.
32-
33-
Posit Assistant is optional. It requires connecting a supported model provider, and no AI account is needed to run the examples.
34-
35-
## Dataset
36-
37-
The fictional sales data is reused from Real Python's [pandas pivot-table materials](https://github.com/realpython/materials/tree/master/pandas-pivot-table). See [data/README.md](data/README.md) for its original source and attribution and [data/LICENSE-2.0.txt](data/LICENSE-2.0.txt) for the Apache 2.0 license.
3+
This folder provides the code examples for the Real Python tutorial [Positron IDE: A Hands-on Python Tutorial](https://realpython.com/positron-ide/)

0 commit comments

Comments
 (0)