Skip to content

Commit 17dd086

Browse files
committed
🔧 chore: standardize on uv for dependency management
Update all documentation and scripts to use `uv` instead of `pip` for installing dependencies. This provides significant performance improvements and better dependency resolution. Changes: - Update CLAUDE.md local development setup instructions - Update README.md installation steps - Update DEVELOPMENT.md dependency installation - Update CONTRIBUTING.md setup instructions - Update vagrant/provision.sh to use uv - Add uv 0.9.18 to .tool-versions Note: Dockerfile and GitHub Actions workflows already use uv. Refs #171
1 parent 25078af commit 17dd086

File tree

6 files changed

+12
-7
lines changed

6 files changed

+12
-7
lines changed

.tool-versions

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,3 @@
11
python 3.13.9
22
task 3.37.2
3+
uv 0.9.18

CLAUDE.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -57,7 +57,8 @@ Always specify settings module: `--settings=pythonie.settings.dev` (or `tests`,
5757
# Setup
5858
python3 -m venv pythonie-venv
5959
source pythonie-venv/bin/activate
60-
pip install -r requirements.txt
60+
pip install uv
61+
uv pip install -r requirements.txt
6162

6263
# Database
6364
python pythonie/manage.py migrate --settings=pythonie.settings.dev

CONTRIBUTING.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,8 @@ python3.13 -m venv pythonie-venv
8585
source pythonie-venv/bin/activate
8686

8787
# Install dependencies
88-
pip install -r requirements/dev.txt
88+
pip install uv
89+
uv pip install -r requirements/dev.txt
8990

9091
# Run migrations
9192
python pythonie/manage.py migrate --settings=pythonie.settings.dev

DEVELOPMENT.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -168,7 +168,8 @@ python3.13 -m venv pythonie-venv
168168
source pythonie-venv/bin/activate
169169

170170
# 2. Install dependencies
171-
pip install -r requirements/dev.txt
171+
pip install uv
172+
uv pip install -r requirements/dev.txt
172173

173174
# 3. Migrate database
174175
python pythonie/manage.py migrate --settings=pythonie.settings.dev
@@ -685,7 +686,7 @@ echo "django-debug-toolbar" >> requirements/main.in
685686
uv pip compile requirements/main.in -o requirements/main.txt
686687

687688
# Install
688-
pip install -r requirements/dev.txt
689+
uv pip install -r requirements/dev.txt
689690
```
690691

691692
### Database Migrations

README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ If you prefer to develop without Docker:
5656
3. Ensure you are running Python 3.13: `python -V` should output `Python 3.13.x`
5757
4. Create a virtualenv: `python3 -m venv pythonie-venv`
5858
5. Activate the virtualenv: `source pythonie-venv/bin/activate`
59-
6. Install dependencies: `pip install -r requirements.txt` (or `uv pip install -r requirements.txt`)
59+
6. Install uv and dependencies: `pip install uv && uv pip install -r requirements.txt`
6060
7. Set up the database: `python pythonie/manage.py migrate --settings=pythonie.settings.dev`
6161
8. Generate sample data: `python pythonie/manage.py generate_sample_data --settings=pythonie.settings.dev`
6262
9. Create a superuser: `python pythonie/manage.py createsuperuser --settings=pythonie.settings.dev`
@@ -259,7 +259,7 @@ This project uses several tools to streamline development:
259259

260260
### Import Errors or Module Not Found
261261
- Rebuild Docker image: `task docker:build`
262-
- Reinstall dependencies: `pip install -r requirements.txt`
262+
- Reinstall dependencies: `uv pip install -r requirements.txt`
263263

264264
## Contributing
265265

pythonie/vagrant/provision.sh

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,8 @@ PIP=$VIRTUALENV_DIR/bin/pip
1212
# Virtualenv setup for project
1313
su - vagrant -c "/usr/local/bin/virtualenv --system-site-packages $VIRTUALENV_DIR && \
1414
echo $PROJECT_DIR > $VIRTUALENV_DIR/.project && \
15-
PIP_DOWNLOAD_CACHE=/home/vagrant/.pip_download_cache $PIP install -r $PROJECT_DIR/requirements.txt"
15+
$PIP install uv && \
16+
PIP_DOWNLOAD_CACHE=/home/vagrant/.pip_download_cache $VIRTUALENV_DIR/bin/uv pip install -r $PROJECT_DIR/requirements.txt"
1617

1718
echo "workon $PROJECT_NAME" >> /home/vagrant/.bashrc
1819

0 commit comments

Comments
 (0)