WIP

README.md

@@ -84,11 +84,11 @@ and then editing the results to include your name, email, and various configurat
 
 First, get Cookiecutter. Trust me, it's awesome:
 
-    $ pip install "cookiecutter>=1.7.0"
+    $ uv tool install "cookiecutter>=1.7.0"
 
 Now run it against this repo:
 
-    $ cookiecutter https://github.com/cookiecutter/cookiecutter-django
+    $ uvx cookiecutter https://github.com/cookiecutter/cookiecutter-django
 
 You'll be prompted for some values. Provide them, then a Django project will be created for you.
 

docs/2-local-development/developing-locally-docker.rst

@@ -154,10 +154,10 @@ This tells our computer that all future commands are specifically for the dev1 m
 Add 3rd party python packages
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-To install a new 3rd party python package, you cannot use ``pip install <package_name>``, that would only add the package to the container. The container is ephemeral, so that new library won't be persisted if you run another container. Instead, you should modify the Docker image:
+To install a new 3rd party python package, you cannot use ``uv add <package_name>``, that would only add the package to the container. The container is ephemeral, so that new library won't be persisted if you run another container. Instead, you should modify the Docker image:
-You have to modify the relevant requirement file: base, local or production by adding: ::
+You have to modify pyproject.toml and either add it to project.dependencies or to tool.uv.dev-dependencies by adding: ::
 
-    <package_name>==<package_version>
+    "<package_name>==<package_version>"
 
 To get this change picked up, you'll need to rebuild the image(s) and restart the running container: ::
 

docs/2-local-development/developing-locally.rst

@@ -1,7 +1,7 @@
 Getting Up and Running Locally
 ==============================
 
-.. index:: pip, virtualenv, PostgreSQL
+.. index:: PostgreSQL
 
 
 Setting Up Development Environment
@@ -9,7 +9,7 @@ Setting Up Development Environment
 
 Make sure to have the following on your host:
 
-* Python 3.12
+* uv https://docs.astral.sh/uv/getting-started/installation/
 * PostgreSQL_.
 * Redis_, if using Celery
 * Cookiecutter_
@@ -29,7 +29,7 @@ First things first.
 #. Install development requirements: ::
 
     $ cd <what you have entered as the project_slug at setup stage>
-    $ pip install -r requirements/local.txt
+    $ uv sync
     $ git init # A git repo is required for pre-commit to install
     $ pre-commit install
 

tests/test_bare.sh

@@ -18,13 +18,13 @@ cd my_awesome_project
 sudo utility/install_os_dependencies.sh install
 
 # Install Python deps
-pip install -r requirements/local.txt
+uv sync --frozen
 
 # run the project's tests
-pytest
+uv run pytest
 
 # Make sure the check doesn't raise any warnings
-python manage.py check --fail-level WARNING
+uv run python manage.py check --fail-level WARNING
 
 # Run npm build script if package.json is present
 if [ -f "package.json" ]

{{cookiecutter.project_slug}}/.drone.yml

@@ -13,7 +13,7 @@ environment:
 steps:
 - name: lint
   pull: if-not-exists
-  image: python:3.12
+  image: ghcr.io/astral-sh/uv:python3.12
   environment:
     PRE_COMMIT_HOME: ${CI_PROJECT_DIR}/.cache/pre-commit
   volumes:
@@ -21,8 +21,8 @@ steps:
     path: ${PRE_COMMIT_HOME}
   commands:
   - export PRE_COMMIT_HOME=$CI_PROJECT_DIR/.cache/pre-commit
-  - pip install -q pre-commit
+  - uv pip install -q pre-commit pre-commit-uv
-  - pre-commit run --show-diff-on-failure --color=always --all-files
+  - uv run pre-commit run --show-diff-on-failure --color=always --all-files
 
 - name: test
   pull: if-not-exists
@@ -37,10 +37,10 @@ steps:
   - docker-compose -f docker-compose.local.yml up -d
   - docker-compose -f docker-compose.local.yml run django pytest
   {%- else %}
-  image: python:3.12
+  image: ghcr.io/astral-sh/uv:python3.12
   commands:
-  - pip install -r requirements/local.txt
+  - uv sync --frozen
-  - pytest
+  - uv run pytest
   {%- endif%}
 
 volumes:

{{cookiecutter.project_slug}}/.github/workflows/ci.yml

@@ -87,26 +87,20 @@ jobs:
         run: docker compose -f docker-compose.local.yml down
       {%- else %}
 
-      - name: Set up Python
+      - uses: actions/checkout@v4
-        uses: actions/setup-python@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v2
         with:
-          python-version: '3.12'
+          enable-cache: "true"
-          cache: pip
+      - name: Install dependencies
-          cache-dependency-path: |
+        run: uv sync
-            requirements/base.txt
-            requirements/local.txt
-
-      - name: Install Dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -r requirements/local.txt
 
       - name: Check DB Migrations
-        run: python manage.py makemigrations --check
+        run: uv run python manage.py makemigrations --check
 
       - name: Run DB Migrations
-        run: python manage.py migrate
+        run: uv run python manage.py migrate
 
       - name: Test with pytest
-        run: pytest
+        run: uv run pytest
       {%- endif %}

{{cookiecutter.project_slug}}/.gitlab-ci.yml

@@ -13,16 +13,16 @@ variables:
 
 precommit:
   stage: lint
-  image: python:3.12
+  image: ghcr.io/astral-sh/uv:python3.12
   variables:
     PRE_COMMIT_HOME: ${CI_PROJECT_DIR}/.cache/pre-commit
   cache:
     paths:
       - ${PRE_COMMIT_HOME}
   before_script:
-    - pip install -q pre-commit
+    - uv pip install -q pre-commit pre-commit-uv
   script:
-    - pre-commit run --show-diff-on-failure --color=always --all-files
+    - uv run pre-commit run --show-diff-on-failure --color=always --all-files
 
 pytest:
   stage: test
@@ -39,13 +39,13 @@ pytest:
   script:
     - docker compose -f docker-compose.local.yml run django pytest
   {%- else %}
-  image: python:3.12
+  image: ghcr.io/astral-sh/uv:python3.12
   services:
     - postgres:{{ cookiecutter.postgresql_version }}
   variables:
     DATABASE_URL: pgsql://$POSTGRES_USER:$POSTGRES_PASSWORD@postgres/$POSTGRES_DB
   before_script:
-    - pip install -r requirements/local.txt
+    - uv sync --frozen
   script:
-    - pytest
+    - uv run pytest
   {%- endif %}

{{cookiecutter.project_slug}}/compose/local/django/Dockerfile

@@ -1,8 +1,6 @@
-# define an alias for the specific python version used in this file.
-FROM docker.io/python:3.12.7-slim-bookworm AS python
-
 # Python build stage
-FROM python AS python-build-stage
+FROM ghcr.io/astral-sh/uv:python3.12-bookworm-slim AS python-build-stage
+ENV UV_COMPILE_BYTECODE=1 UV_LINK_MODE=copy
 
 ARG BUILD_ENVIRONMENT=local
 
@@ -14,15 +12,17 @@ RUN apt-get update && apt-get install --no-install-recommends -y \
   libpq-dev
 
 # Requirements are installed here to ensure they will be cached.
-COPY ./requirements .
+RUN --mount=type=cache,target=/root/.cache/uv \
-
+    --mount=type=bind,source=uv.lock,target=uv.lock \
-# Create Python Dependency and Sub-Dependency Wheels.
+    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
-RUN pip wheel --wheel-dir /usr/src/app/wheels  \
+    uv sync --frozen --no-install-project --no-dev \
-  -r ${BUILD_ENVIRONMENT}.txt
 
+ADD . /app
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --frozen --no-dev
 
 # Python 'run' stage
-FROM python AS python-run-stage
+FROM docker.io/python:3.12.7-slim-bookworm AS python-run-stage
 
 ARG BUILD_ENVIRONMENT=local
 ARG APP_HOME=/app
@@ -58,11 +58,7 @@ RUN apt-get update && apt-get install --no-install-recommends -y \
 
 # All absolute dir copies ignore workdir instruction. All relative dir copies are wrt to the workdir instruction
 # copy python dependency wheels from python-build-stage
-COPY --from=python-build-stage /usr/src/app/wheels  /wheels/
+COPY --from=builder --chown=app:app ${APP_HOME}  ${APP_HOME}
-
-# use wheels to install python dependencies
-RUN pip install --no-cache-dir --no-index --find-links=/wheels/ /wheels/* \
-  && rm -rf /wheels/
 
 COPY ./compose/production/django/entrypoint /entrypoint
 RUN sed -i 's/\r$//g' /entrypoint
@@ -86,7 +82,6 @@ RUN sed -i 's/\r$//g' /start-flower
 RUN chmod +x /start-flower
 {% endif %}
 
-# copy application code to WORKDIR
+ENV PATH="/app/.venv/bin:$PATH"
-COPY . ${APP_HOME}
 
 ENTRYPOINT ["/entrypoint"]

{{cookiecutter.project_slug}}/compose/local/docs/Dockerfile

@@ -1,7 +1,3 @@
-# define an alias for the specific python version used in this file.
-FROM docker.io/python:3.12.7-slim-bookworm AS python
-
-
 # Python build stage
 FROM python AS python-build-stage
 
@@ -17,16 +13,17 @@ RUN apt-get update && apt-get install --no-install-recommends -y \
   && rm -rf /var/lib/apt/lists/*
 
 # Requirements are installed here to ensure they will be cached.
-COPY ./requirements /requirements
+RUN --mount=type=cache,target=/root/.cache/uv \
-
+    --mount=type=bind,source=uv.lock,target=uv.lock \
-# create python dependency wheels
+    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
-RUN pip wheel --no-cache-dir --wheel-dir /usr/src/app/wheels  \
+    uv sync --frozen --no-install-project --no-dev
-  -r /requirements/local.txt -r /requirements/production.txt \
+ADD . /app
-  && rm -rf /requirements
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --frozen --no-dev
 
 
 # Python 'run' stage
-FROM python AS python-run-stage
+FROM docker.io/python:3.12.7-slim-bookworm AS python-run-stage
 
 ARG BUILD_ENVIRONMENT
 ENV PYTHONUNBUFFERED=1
@@ -49,14 +46,12 @@ RUN apt-get update && apt-get install --no-install-recommends -y \
   && rm -rf /var/lib/apt/lists/*
 
 # copy python dependency wheels from python-build-stage
-COPY --from=python-build-stage /usr/src/app/wheels /wheels
+COPY --from=builder --chown=app:app /app /app
-
-# use wheels to install python dependencies
-RUN pip install --no-cache /wheels/* \
-  && rm -rf /wheels
 
 COPY ./compose/local/docs/start /start-docs
 RUN sed -i 's/\r$//g' /start-docs
 RUN chmod +x /start-docs
 
+ENV PATH="/app/.venv/bin:$PATH"
+
 WORKDIR /docs

{{cookiecutter.project_slug}}/compose/production/django/Dockerfile

@@ -24,11 +24,9 @@ ENV DJANGO_AZURE_ACCOUNT_NAME=${DJANGO_AZURE_ACCOUNT_NAME}
 RUN npm run build
 
 {%- endif %}
-# define an alias for the specific python version used in this file.
-FROM docker.io/python:3.12.7-slim-bookworm AS python
 
-# Python build stage
+FROM ghcr.io/astral-sh/uv:python3.12-bookworm-slim AS python-build-stage
-FROM python AS python-build-stage
+ENV UV_COMPILE_BYTECODE=1 UV_LINK_MODE=copy
 
 ARG BUILD_ENVIRONMENT=production
 
@@ -41,15 +39,17 @@ RUN apt-get update && apt-get install --no-install-recommends -y \
 
 
 # Requirements are installed here to ensure they will be cached.
-COPY ./requirements .
+RUN --mount=type=cache,target=/root/.cache/uv \
-
+    --mount=type=bind,source=uv.lock,target=uv.lock \
-# Create Python Dependency and Sub-Dependency Wheels.
+    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
-RUN pip wheel --wheel-dir /usr/src/app/wheels  \
+    uv sync --frozen --no-install-project --no-dev
-  -r ${BUILD_ENVIRONMENT}.txt
+ADD . /app
+RUN --mount=type=cache,target=/root/.cache/uv \
+    uv sync --frozen --no-dev
 
 
 # Python 'run' stage
-FROM python AS python-run-stage
+FROM docker.io/python:3.12.7-slim-bookworm AS python-run-stage
 
 ARG BUILD_ENVIRONMENT=production
 ARG APP_HOME=/app
@@ -76,14 +76,11 @@ RUN apt-get update && apt-get install --no-install-recommends -y \
   && apt-get purge -y --auto-remove -o APT::AutoRemove::RecommendsImportant=false \
   && rm -rf /var/lib/apt/lists/*
 
-# All absolute dir copies ignore workdir instruction. All relative dir copies are wrt to the workdir instruction
+# Copy the application from the builder
-# copy python dependency wheels from python-build-stage
+COPY --from=builder --chown=app:app /app /app
-COPY --from=python-build-stage /usr/src/app/wheels  /wheels/
-
-# use wheels to install python dependencies
-RUN pip install --no-cache-dir --no-index --find-links=/wheels/ /wheels/* \
-  && rm -rf /wheels/
 
+# Place executables in the environment at the front of the path
+ENV PATH="/app/.venv/bin:$PATH"
 
 COPY --chown=django:django ./compose/production/django/entrypoint /entrypoint
 RUN sed -i 's/\r$//g' /entrypoint

{{cookiecutter.project_slug}}/utility/install_python_dependencies.sh

@@ -33,7 +33,7 @@ if [ -z "$VIRTUAL_ENV" ]; then
     echo >&2 -e "\n"
     exit 1;
 else
-    pip install -r $PROJECT_DIR/requirements/local.txt
+    uv sync --frozen
     {%- if cookiecutter.use_heroku == "y" -%}
     pip install -r $PROJECT_DIR/requirements.txt
     {%- endif %}