This lesson is still being designed and assembled (Pre-Alpha version)

Intermediate Research Software Development in Python

This course is aimed at teaching a core set of established best practice software development skills for working as part of a team in a research environment (see detailed learning objectives below) using Python as an example programming language. The core set of skills we teach is not a comprehensive set of all-encompassing skills, but a selective set of tried-and-tested collaborative development skills that forms a firm foundation for continuing on your learning journey.

A typical learner for this course may be someone who is working in academic research and, needing to write some code, has gained basic software development skills either by self-learning or attending, e.g., a novice Software Carpentry Python course. They have been applying those skills in their domain of work by writing code for some time, e.g. half a year or more. However, their software development-related projects are now becoming larger and are involving more researchers and other stakeholders (e.g. users), for example:

They now need more intermediate software engineering skills to help them design more robust software code, automate the process of testing and verifying its correctness and support collaborations with others.

Target Audience

This course is for you if:

This course is not for you if:

Prerequisites

To attend this course you should meet the following criteria. You can also test your prerequisite knowledge by taking this short quiz.

Git

  • You are familiar with the concept of version control
  • You have experience configuring Git for the first time and creating a local repository
  • You have experience using Git to create and clone a repository and add/commit changes to it and to push to/pull from a remote repository
  • Optionally, you have experience comparing various versions of tracked files or ignoring specific files

Python

  • You have a basic knowledge of programming in Python (using variables, lists, conditional statements, functions and importing external libraries)
  • You have previously written Python scripts or iPython/Jupyter notebooks to accomplish tasks in your domain of work

Shell

  • You have experience using a command line interface, such as Bash, to navigate a UNIX-style file system and run commands with arguments
  • Optionally, you have experience redirecting inputs and outputs from a command

Learning Objectives

  • Set up and use a number of tools and own virtual environment to develop software collaboratively in a team
  • Use a test framework to verify the correct behaviour of code
  • Design robust, extensible software
  • Release your software for reuse by others

Schedule

Setup Download the software required for the lesson
Day 1 13:00 1. Setting the Scene What are we going to teach in this workshop?
What different software development tools will we be using?
13:30 2. Introduction to Software Design and Development Why is splitting an application into smaller functional units (modules) good when designing software?
What are programming interfaces in software design?
What is Model-View-Controller design architecture?
14:00 3. Integrated Software Development Environments What are Integrated Development Environments (IDEs)?
What are the advantages of using IDEs for software development?
14:30 4. Virtual Environments For Software Development What are virtual environments in software design?
What are the advantages of using virtual environments?
How to set up and manage a Python virtual environment?
How to install and manage Python third party packages?
15:00 5. Break Break
15:30 6. Python Coding Conventions Why should you follow software coding conventions?
Who is setting coding conventions?
What coding conventions exist for Python?
16:00 7. Collaborative Software Development Using Git and GitHub What are git branches and why are they useful?
What are best practices when developing software collaboratively using Git?
16:45 Finish
Day 2 13:00 8. Automatically Testing your Software Does the code we develop work the way it should do?
Can we (and others) verify these assertions for themselves?
To what extent are we confident of the accuracy of results that appear in publications?
13:50 9. Scaling Up Unit Testing How do we scale up the number of tests we want to run?
How can we know how much of our code is being tested?
14:05 10. Break Break
14:25 11. Continuous Integration for Automated Testing How can I apply automated repository testing to scale with development activity?
15:10 12. Diagnosing Issues and Improving Robustness Once we know our program has errors, how can we locate them in the code?
How can we make our programs more resilient to failure?
16:00 Finish
Day 3 13:00 13. Programming Paradigms How does the structure of a problem affect the structure of our code?
13:15 14. Object Oriented Programming How can we use code to describe the structure of data?
How should the relationships between structures be described?
14:05 15. Functional Programming What is a function really?
How can we be sure our code does the same thing every time?
What is the difference between data and code?
What do we need to do differently when working with Big Data?
14:45 16. Break Break
15:05 17. Software Design Where do we start when beginning a new software project?
How do people use software?
How can we make sure the components of our software are reusable?
What should we do when our requirements change?
15:40 18. Persistence How can we store and transfer structured data?
How can we make it easier to substitute new components into our software?
16:30 Finish
Day 4 13:00 19. Preparing Software for Reuse What can we do to make our programs reusable by others?
How should we document and license our code?
13:55 20. Break Break
14:15 21. Assessing Software for Suitability and Improvement What makes good code actually good?
What should we look for when selecting software to reuse?
15:00 22. Software Improvement Through Feedback How should we handle feedback on our software?
How, and to what extent, should we provide support to our users?
15:50 Finish

The actual schedule may vary slightly depending on the topics and exercises chosen by the instructor.