Skip to content

The Workshop

This material is designed to help you get started with packaging your code. It is designed to be a hands-on workshop, where you will be guided through the process of setting up a new project, and then packaging it for distribution.

Although the material is designed to be followed in order, you can jump to any section you like. We usually run this event over a day, with a mix of talks and practical sessions. Here is a rough outline of the day:

Time Content Slides Sections
9:00am - 9:30am Registration and welcome refreshments
9:30am - 10:00am Introduction
- Why is this important?
- The Accelerate Programme
- What does it mean to publish software?
Introduction
10:00am - 11:00am Version Control
- Overview of Git and GitHub
- Developing code
- Key files
Version control
11:00am - 11:30am Break
11:30am - 1:00pm Poetry
- Setting up Codespaces
- Overview of the project
- Using Poetry
- File structure
- Licensing
- CLI Entry points
Poetry Setting up
Project overview
Poetry
1:00pm - 2:00pm Lunch
2:00pm - 3:00pm Testing
- Testing scientific software
- Writing unit tests
Testing Testing
3:00pm - 3:30pm Publishing and documenting
- Typing and docstrings
- Publishing to PyPI
Documentation Publishing
Documentation
3:30pm - 4:00pm Break
4:00pm - 5:00pm Automating everything!
- Pre-commit hooks
- Testing
- Publishing
- Documentation
Pre-commits
Testing
Publishing
Documentation