chore: update devcontainer to python 3.13, ubuntu 24, and add fish shell

[thephez]

Summary

• configure the devcontainer's Python feature to provision version 3.13 so the Codespace matches the documented build environment
• fix the postCreate script shebang, add basic safety flags, and install requirements with python3.13 before building the docs

Testing

• Not run (not requested)

---

Codex Task

Summary by CodeRabbit

• New Features

  • Added Fish shell support in the development environment.
  • Added Python 3.13 support in the development environment.

• Chores

  • Updated the development container base image to a newer release.
  • Fixed the container initialization script (shebang and stricter error handling) and updated Python package installation to use python3 -m pip.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

[coderabbitai]

Walkthrough

Devcontainer config switched base image from jammy to noble, upgraded the Python feature to version 3.13, and added a new local Fish shell feature (manifest + installer). The post-create script shebang and strict flags were fixed and pip install was changed to python3 -m pip install -r requirements.txt.

Changes

Cohort / File(s)	Summary
Dev container configuration ./.devcontainer/devcontainer.json, ./.devcontainer/postCreateCommands.sh	Base image changed from mcr.microsoft.com/devcontainers/base:jammy to mcr.microsoft.com/devcontainers/base:noble. ghcr.io/devcontainers/features/python:1 set to { "version": "3.13" }. New feature reference ./features/fish: {} added. Post-create script shebang fixed to #!/bin/sh, set -eu added, and pip invocation updated to python3 -m pip install -r requirements.txt.
Fish shell feature ./.devcontainer/features/fish/devcontainer-feature.json, ./.devcontainer/features/fish/install.sh	New devcontainer feature manifest for fish (id, version 1.0.0, name, description, installsAfter: ["ghcr.io/devcontainers/features/common-utils"]) and an install.sh that installs fish via apt-get with DEBIAN_FRONTEND=noninteractive, cleanup, and an error path when apt-get is unavailable.

Sequence Diagram(s)

sequenceDiagram
    autonumber
    participant DevHost as Developer Host
    participant DevContainer as Dev Container engine
    participant Features as Features (python, github-cli, fish)
    participant PostCreate as Post-create script

    rect rgb(235,245,255)
    DevHost->>DevContainer: Start container using `devcontainer.json`
    DevContainer->>Features: Pull & apply features\n(`github-cli`, `python:3.13`, `./features/fish`)
    note right of Features `#eef8ff`: Fish feature runs `install.sh` which invokes apt-get
    Features-->>DevContainer: Feature layers applied
    end

    rect rgb(245,255,235)
    DevContainer->>PostCreate: Run `.devcontainer/postCreateCommands.sh`
    PostCreate->>DevContainer: `python3 -m pip install -r requirements.txt` \nthen `make html`
    end

Loading

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

• Pay attention to: ./.devcontainer/devcontainer.json feature syntax and image tag correctness.
• Review ./.devcontainer/features/fish/install.sh for apt behavior, error messages, and idempotence.
• Verify postCreateCommands.sh uses the intended Python interpreter and environment (venv/system).

Pre-merge checks

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately describes the main changes: updating devcontainer with Python 3.13, Ubuntu 24 (noble), and adding Fish shell support.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

---

📜 Recent review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between e679ad6 and 5f998ff.

📒 Files selected for processing (1)

• .devcontainer/postCreateCommands.sh (1 hunks)

🔇 Additional comments (2)

.devcontainer/postCreateCommands.sh (2)

1-3: Shell script hardening looks good.

The shebang fix to #!/bin/sh and addition of set -eu flags are solid defensive practices. The strict error handling (-e) and undefined-variable checks (-u) will catch issues early during devcontainer setup.

---

11-11: Python module invocation is correct.

Using python3 -m pip install (rather than a direct pip binary or python3.13) is the right choice here. It aligns with the devcontainer's Python feature configuration, which provisions python3 on PATH, and follows modern pip best practices. This resolves the prior critical feedback about python3.13 not being available.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

📜 Review details

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 6a7e804 and e679ad6.

📒 Files selected for processing (4)

• .devcontainer/devcontainer.json (1 hunks)
• .devcontainer/features/fish/devcontainer-feature.json (1 hunks)
• .devcontainer/features/fish/install.sh (1 hunks)
• .devcontainer/postCreateCommands.sh (1 hunks)

🔇 Additional comments (6)

.devcontainer/postCreateCommands.sh (1)

1-3: ✓ Shebang and safety flags are correct.

The shebang fix to #!/bin/sh and the addition of set -eu align with the PR objectives. The POSIX-compliant safety flags are appropriate for a post-create script: set -e exits on error and set -u errors on unset variables.

.devcontainer/features/fish/install.sh (1)

1-13: ✓ Fish shell installation script is well-structured.

The script uses proper bash-specific safety flags (set -euo pipefail), includes robust apt-get detection, and applies installation best practices (noninteractive mode, minimal package footprint, cleanup). Error handling is clear with appropriate exit codes.

.devcontainer/features/fish/devcontainer-feature.json (1)

1-10: ✓ Feature manifest is correctly structured.

The Fish shell feature manifest conforms to the devcontainer specification. The installsAfter dependency on common-utils is appropriate, and the minimal configuration (empty options) is suitable for a straightforward package installation.

.devcontainer/devcontainer.json (3)

10-12: ✓ Python 3.13 feature configuration aligns with postCreateCommands.sh.

The Python feature is explicitly pinned to version 3.13, which matches the python3.13 -m pip invocation in postCreateCommands.sh. This ensures consistency between the feature provisioning and the post-create script.

---

13-13: ✓ Fish shell feature correctly integrated.

The new Fish shell feature is properly referenced as a local feature path (./features/fish) with an empty options object, which is appropriate. It will be installed after common-utils per the feature manifest dependency.

---

6-6: Confirmed: Base image upgrade from jammy to noble involves significant version changes that require verification.

The upgrade introduces substantial changes across multiple components:

• Kernel (5.15 → 6.8) with frame-pointers enabled and cgroups v2 behavior changes
• glibc 2.35 → 2.39 affecting binary compatibility and system toolchains (Python 3.10 → 3.12, updated Rust, Go, OpenJDK)
• Container runtime updates (containerd 1.7+) changing image/build API behavior
• Service restart behavior changes in non-interactive apt operations

Before merging, verify:

• Project dependencies (native binaries, prebuilt libs, glibc-dependent code) work with noble's toolchain versions
• CI/build pipelines and any scripts relying on system Python or container runtimes still function
• Docker/container image builds succeed with newer containerd versions in the devcontainer environment