dev-setup

name	dev-setup
description	Environment setup and dependency installation for gistblog

Dev Setup

Environment Setup

Virtual Environment

The project uses uv for dependency management.

uv venv
source .venv/bin/activate

Dependency Installation

uv sync --all-extras
uv pip install -e .

Alternative (Make)

make install

Verify Installation

make build

Common Issues

• If Gist fetching fails: Check .env contains valid GitHub credentials
• If Pelican fails to build: Ensure content/ has valid RST files
• If Sphinx docs fail: Run make build-docs to diagnose

Recovery

To reset environment:

rm -rf .venv
make install