28.03.2023 HeFDI Code School 'Sustainable Research Software' (EN)
HeFDI Code School 'Sustainable Research Software'
Program
Important information: All workshops are held online and in English.
Date | Topic |
---|---|
12 May 2023, 9h-13h | Scientific Software Development is not a Jenga game! |
26 May 2023, 9h-13h | Clean Code and Refactoring |
23 June 2023, 9h-13h | Introduction to Software Testing |
7 July 2023, 9h-13h | Continuous Integration and Test Driven Development |
Workshop - May 12 - Scientific Software Development is not a Jenga game!
Scientific software is often hard to maintain and reuse. A major reason for the instability of software is that it is subject to continuous change. This is especially true for software in the scientific context, since the scientific discourse is open-ended. Change has caused difficulties for scientific software developers from the very beginning, and it continues to do so. In parallel, the software engineering community has produced numerous developments that we as research software developers can take advantage of to significantly support our work. This workshop is an introduction on how to bridge the gap between both worlds and introduces practices, methods and principles to develop maintainable software and to make the software development process sustainable.
Agenda:
- Motivation for sustainable software design
- Basic concepts for organizing complexity
- Refresher: Object Orientation
- Design principles: SOLID & Co. with application examples
Please note the information on preparation and prior knowledge.
Workshop - May 26 - Clean Code and Refactoring
In the scientific environment with ever-changing requirements, it is important to produce source code that can be read, understood and modified by ourselves or others. This workshop will teach you how to apply clean code principles and refactoring techniques to produce high quality, maintainable code.
Agenda:
- Motivation
- Clean Code and Refactoring with interactive hands-on examples
- Tipps for working with Python
Please note the information on preparation and prior knowledge.
Workshop - June 23 - Introduction to Software Testing
Software testing ensures the proper functioning of a constantly evolving software and helps to quickly identify faults in a software code. This workshop introduces the first steps toward writing various types of software tests for scientific codes along with hands-on sessions.
Agenda:
- Fundamentals and motivation for software testing in scientific codes
- Hands-On Sessions:
- Writing unit tests
- Writing acceptance tests
- Incorporating and managing code quality tests
- Test process automation
- Demonstration of an in-house code testing environment
Please note the information on preparation and prior knowledge.
Workshop - July 07 - Continuous Integration and Test Driven Development
Continuous Integration (CI) and Test-driven development (TDD) are two software development practices that complement each other and can be used together to improve the quality and efficiency of software development.
CI is a development practice that emphasizes integrating and testing code changes frequently in a shared repository. The goal is to catch bugs and issues early in the development process, before they become more difficult and expensive to fix.
TDD, on the other hand, is a development approach that emphasizes writing automated tests before writing the code. The developer writes a failing test, then writes the code to make the test pass, and finally refactors the code to improve its quality. This cycle is repeated for each new feature or change to the code.
When used together, CI and TDD can help to ensure that the code is always in a functional and deployable state, and that any issues or bugs are caught early in the development process.
Agenda
- Introduction to Continuous Integration (CI)
- Practical Example with GitHub CI
- Introduction to Test Driven Development
- Collaborative TDD Kata (example application)
Please note the information on preparation and prior knowledge.
Preparation
Over the course of the workshop series, we will work collaboratively using Visual Studio Code, which can be used in the browser without any further installation. However, we recommend that you install the following software in order to be able to code yourself and/or to reproduce later:
- Visual Studio Code
- free and open source powerful editor
- available for Windows, macOS and Linux
- Download
- further introductions on VS Code
- Please install the following extensions within Visual Studio Code
- Live Share
- Python
- further instructions on how to install an extensions
To join a collaborative session within Visual Studio Code using Live
Share, you need to have a GitHub (or Microsoft) account.
- You can register for a GitHub account on github.com
- See how to join a collaboration session
Prior Knowledge
We assume some basic knowledge of the python programming language and the version management system git. At least, you should be able to read and understand python. In general, the concepts we address are programming language agnostic. Hence, you should be able to easily use them with your favorite programming language.
As we will use a collaborative session in VS Code you don’t necessarily need to have Python installed on your local machine. But, in order to work on your own machine, you can download and install Python from python.org.