Python package development 2025

This repo contains slides used in the course "Python package development".

The whole course distilled into one page of rules — every rule has its own link, so you can point someone at exactly the thing you mean.

https://dhi.github.io/python-package-development/standards.html

…/standards.html#mutable-default-arguments
…/standards.html#composition-over-inheritance
…/standards.html#libraries-loose-applications-pinned

Source: standards.md.

.claude/skills/review-python-package/ is a Claude Code skill that audits a package repository against these standards — layout, pyproject.toml, dependencies, tests, code smells, docs, CI and release setup — and reports findings linked to the rule each one breaks.

Copy the folder into ~/.claude/skills/ (or your project's .claude/skills/), then:

> review this package against the DHI standards

Python is the language of choice for data science, scientific computing and AI.

Are you ready to take your Python skills to the next level and develop your own Python package that can benefit your department, GBU, or all of DHI?

This course is ideal for those who have an idea for a Python package they want to develop, and who already have much of the code but need assistance in structuring, refactoring, and packaging it. Participants can apply individually or in small teams of 2-3 people. See below for how to apply.

The course comprises these seven modules:

• Git, Pull Requests, and code reviews
• Python functions, classes, and modules
• Testing and auto-formatting
• Dependencies and GitHub actions
• Object oriented design in Python
• Documentation
• Distributing your package

https://dhi.github.io/python-package-development

Made with Quarto and hosted by GitHub Pages

Prerequisites: Python 3.13, Quarto

pip install -r requirements.txt

Preview locally: quarto preview

Render site: quarto render

CI/CD via GitHub Actions (.github/workflows/publish.yml) renders and publishes to gh-pages on push to main.

• standards.md — The course distilled into linkable rules (published as standards.html)
• .claude/skills/review-python-package/ — Claude Code skill that audits a package against standards.md
• *.qmd — Course modules (00-07), each a Quarto reveal.js slide deck
• _quarto.yml — Quarto site configuration
• projects/data_cleaning/ — Capstone homework project (progressive weekly assignments)
• group_work/ — Group discussion prompts per module
• examples/ — Code examples organized by module (03_oop, 04_testing, 06_documentation)