Pr 919 - Bootstrap5 migration

.dockerignore

@@ -0,0 +1,31 @@
+**/.DS_Store
+**/__pycache__
+**/.venv
+**/.classpath
+**/.dockerignore
+**/.env
+**/.git
+**/.gitignore
+**/.project
+**/.settings
+**/.toolstarget
+**/.vs
+**/.vscode
+**/*.*proj.user
+**/*.dbmdl
+**/*.jfm
+**/bin
+**/charts
+**/docker-compose*
+**/compose.y*ml
+**/Dockerfile*
+**/node_modules
+**/npm-debug.log
+**/obj
+**/secrets.dev.yaml
+**/values.dev.yaml
+*/.*_cache
+**/.github
+*/docs
+.readthedocs.y*ml
+**/*.db

.github/ISSUE_TEMPLATE/bug-fix.yml

@@ -11,18 +11,12 @@ body:
       value: "A bug happened!"
     validations:
       required: true
-  - type: dropdown
+  - type: input
     id: version
     attributes:
       label: Version
       description: What version of our software are you running?
-      options:
-        - 1.1.5
-        - 1.1.4
-        - 1.1.3
-        - 1.1.2
-        - 1.1.1
-        - 1.1.0 or before
+      placeholder: 1.X.X
   - type: dropdown
     id: component
     attributes:

.github/workflows/ci.yml

@@ -0,0 +1,68 @@
+name: CI
+
+on:
+  workflow_dispatch:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+        node-version: ["24.x"]
+    env:
+      PLUGIN_API: true
+      DJANGO_VITE_DEV_MODE: true
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv and set the python version
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Install the project
+        run: uv sync --locked --dev
+
+      - name: Install frontend packages
+        run: npm --prefix coldfront/static install
+
+      - name: Check for lint violations
+        run: uv run ruff check
+
+      - name: Check formatting
+        run: uv run ruff format --check
+
+      - name: Check frontend with eslint and prettier
+        run: npm --prefix coldfront/static run check
+
+      - name: Compile and bundle frontend static assets
+        run: npm --prefix coldfront/static run build
+
+      - name: Check bundled frontend static assets have been commited
+        run: |
+          if [[ `git status --porcelain` ]]; then
+            echo "Error: pre-compiled bundled frontend static assets have not been committed"
+            git status
+            exit 1
+          else
+            echo "Bundled frontend static assets check passed."
+          fi
+
+      - name: Check licence with reuse
+        run: uv run reuse lint
+
+      - name: Run tests
+        run: uv run coldfront test
+
+      - name: Check for migrations
+        run: uv run coldfront makemigrations --check

.gitignore

@@ -3,6 +3,7 @@
 coldfront.egg-info
 dist
 build
+.zed/
 *._*
 *.DS_Store
 *.swp
@@ -21,3 +22,4 @@ db.json
 .env
 .devcontainer/*
 .bin/*
+node_modules

.python-version

@@ -0,0 +1 @@
+3.12

.readthedocs.yaml

@@ -7,17 +7,20 @@ version: 2
 
 # Set the version of Python and other tools you might need
 build:
-  os: ubuntu-22.04
+  os: ubuntu-24.04
   tools:
-    python: "3.9"
+    python: "3.12"
 
-# Build documentation with MkDocs
-mkdocs:
-  configuration: docs/mkdocs.yml
-
-# Optionally set the version of Python and requirements required to build your docs
-python:
-  install:
-    - requirements: docs/requirements.txt
-    - method: pip
-      path: .
+  jobs:
+    # See: https://docs.readthedocs.io/en/stable/build-customization.html#install-dependencies-with-uv
+    pre_create_environment:
+      - asdf plugin add uv
+      - asdf install uv latest
+      - asdf global uv latest
+    create_environment:
+      - uv venv
+    install:
+      - uv sync --group docs
+    build:
+      html:
+        - NO_COLOR=1 uv run mkdocs build --clean --config-file docs/mkdocs.yml --site-dir $READTHEDOCS_OUTPUT/html

AUTHORS.md

@@ -31,3 +31,7 @@
 - Cecilia Lau
 - Ria Gupta
 - Shreyas Sridhar
+- David Simpson
+- Eric Butcher
+- Matthew Kusz
+- John LaGrone

CONTRIBUTING.md

@@ -0,0 +1,67 @@
+# Contributing to ColdFront
+
+Before we start, thank you for considering contributing to ColdFront!
+
+Every contribution no matter how small is welcome here! Whether you are adding a whole new feature, improving the aesthetics of the webpage, adding some tests cases, or just fixing a typo your contributions are appreciated.
+
+In this document you will find a set a guidelines for contributing to the ColdFront project, not hard rules. However, sticking to the advice contained in this document will help you to make better contributions, save time, and increase the chances of your contributions getting accepted.
+
+This project abides by a [Code of Conduct](CODE_OF_CONDUCT.md) that all contributors are required to uphold. Please read this document before interacting with the project.
+
+In addition, you must sign off on all commits using `git commit -s`, acknowledging you agree to the Developer Certificate of Origin.
+
+## Contributor's Agreement
+
+You are under no obligation whatsoever to provide any bug fixes, patches, or upgrades to the features, functionality or performance of the source code ("Enhancements") to anyone; however, if you choose to make your Enhancements available either publicly, or directly to the project, without imposing a separate written license agreement for such Enhancements, then you hereby grant the following license: a non-exclusive, royalty-free perpetual license to install, use, modify, prepare derivative works, incorporate into other computer software, distribute, and sublicense such enhancements or derivative works thereof, in binary and source code form.
+
+## Contribution Workflow
+
+For most contributions, you will start by opening up an issue, discussing changes with maintainers and the community, and then opening a pull request. It is perfectly acceptable to provide a pull request without opening an issue first. However, we recommend you open an issue if the changes you suggest are significant to ensure your changes can be successfully merged.
+
+### Issues
+
+We track requested changes using GitHub issues. These include bugs, feature requests, and general concerns.
+
+Before making an issue, please look at current and previous issues to make sure that your concern has not already been raised by someone else. It is also advised to read through the [current documentation](https://coldfront.readthedocs.io/en/stable/). If an issue with your concern is already opened you are encouraged to comment further on it. The `Search Issues` feature is great to check to see if someone has already raised your issue before.
+
+If, after searching pre-existing issues, your concern has not been raised (or you are unsure if a previous issue covers your concern) please open a new issue with any labels you believe are relevant. Please include any relevant images, links, and syntax-highlighted text snippets to help maintainers understand your concerns better. It is also helpful to include any debugging steps you have attempted or ideas on how to fix your issue.
+
+### Pull Requests
+
+To create a pull request:
+
+1. Fork this repository.
+2. Create a branch off the `main` branch.
+3. Make commits to your branch. Make sure your additions include [testing](#testing) for any new functionality. Make sure that you run the full test suite on your PR before submitting. If your changes necessitate removing or changing previous tests, please state this explicitly in your PR. Also ensure that your changes pass the [linter and formatter](#formatting-and-linting).
+4. Create a pull request back to this main repository.
+5. Wait for a maintainer to review your code and request any changes. Don't worry if the maintainer asks for changes! This feedback is perfectly normal and ensures a more maintainable project for everyone.
+
+## Conventions and Style Guide
+
+#### Spelling and Naming
+
+Please use a spell-checker when modifying the codebase to reduce the prevalence of typos. You should avoid writing names in code that use jargon or abbreviations that are not directly relevant to ColdFront or tools used in its development.
+
+#### Annotations
+
+You are encouraged to use Python's type annotations to improve code readability and maintainability. Whenever possible, use the most recent annotation syntax available for the minimum version of Python supported by ColdFront.
+
+> The minimum Python version supported can be found in the `pyproject.toml` file.
+
+#### Testing
+
+All new and changed features must include unit tests to verify that they work correctly. Every non-trivial function should have at least as many test cases as its cyclomatic complexity to verify all independent code paths in the function operate correctly.
+
+When using [uv](https://docs.astral.sh/uv/), the full test suite can be run using the command `uv run coldfront test`.
+
+#### Formatting and Linting
+
+This project is formatted and linted using [ruff](https://docs.astral.sh/ruff/).
+
+You can use Ruff to check for any linting errors in proposed Python code using `uv run ruff check`. Ruff can also fix many linting errors automatically with `uv run ruff check --fix` when using [uv](https://docs.astral.sh/uv/).
+
+If your code is failing linting checks but you you have a valid reason to leave it unchanged, you can suppress warnings using a `# noqa: <warning-error-code>` comment on the line(s) in question
+
+You can also use Ruff to check formatting using `uv run ruff format --check` and automatically fix formatting errors with `uv run ruff format`.
+
+If your code is failing formatting checks but you have a valid reason to leave it unchanged, you can suppress warnings for a specific block of code by enclosing it with the comments `# fmt: off` and `# fmt: on`. These comments work at the statement level so placing them inside of expressions will not have any effect.

Dockerfile

@@ -1,18 +1,74 @@
-FROM python:3.8
+FROM ubuntu:24.04 AS base
 
-RUN apt-get update \
-    && apt-get install -y --no-install-recommends \
-    && rm -rf /var/lib/apt/lists/*
+FROM base AS cfimage
 
-WORKDIR /usr/src/app
-COPY requirements.txt ./
-RUN pip3 install -r requirements.txt
-COPY . .
+RUN apt update && DEBIAN_FRONTEND=noninteractive apt install -y --no-install-recommends \
+        sqlite3 \
+        freeipa-client \
+        mariadb-client \
+        postgresql-client
 
-RUN python3 ./manage.py initial_setup
-RUN python3 ./manage.py load_test_data
+FROM cfimage AS builder
 
-ENV DEBUG=True
+RUN DEBIAN_FRONTEND=noninteractive apt install -y \
+        gcc \
+        cmake \
+        pkg-config \
+        build-essential \
+        libmariadb-dev \
+        libpq-dev \
+        libssl-dev \
+        libdbus-1-dev \
+        libldap2-dev \
+        libkrb5-dev \
+        libglib2.0-dev \
+        libsasl2-dev
 
+COPY --from=ghcr.io/astral-sh/uv:0.7 /uv /bin/uv
+ENV UV_COMPILE_BYTECODE=1
+ENV UV_LINK_MODE=copy
+ENV UV_PYTHON_INSTALL_DIR=/python
+ENV UV_PYTHON_PREFERENCE=only-managed
+
+WORKDIR /app
+
+# Install Python before the project for caching
+RUN --mount=type=bind,source=.python-version,target=.python-version \
+  uv python install
+
+RUN --mount=type=cache,target=/root/.cache/uv \
+    --mount=type=bind,source=uv.lock,target=uv.lock \
+    --mount=type=bind,source=.python-version,target=.python-version \
+    --mount=type=bind,source=pyproject.toml,target=pyproject.toml \
+  uv sync \
+        --locked \
+        --no-install-project \
+        --no-dev \
+        --extra ldap \
+        --extra freeipa \
+        --extra iquota \
+        --extra oidc \
+        --extra mysql \
+        --extra pg
+COPY . /app
+RUN --mount=type=cache,target=/root/.cache/uv \
+  uv sync \
+        --locked \
+        --no-dev \
+        --extra ldap \ 
+        --extra freeipa \
+        --extra iquota \
+        --extra oidc \
+        --extra mysql \
+        --extra pg 
+
+
+FROM cfimage
+
+RUN  apt-get clean && rm -rf /var/lib/apt/lists/*
+RUN groupadd -r python && useradd -r -g python python
+COPY --from=builder --chown=python:python /python /python
+COPY --from=builder /app /app
+ENV PATH="/app/.venv/bin:$PATH"
 EXPOSE 8000
-CMD ["python", "manage.py", "runserver", "0.0.0.0:8000"]
+CMD ["gunicorn", "--workers", "3", "--bind", ":8000", "coldfront.config.wsgi"]