python3-damaris/DEVELOPER.md

Developing

Version bump

Version is changed in src/damaris/__init__.py

Process

1. Update the version in src/damaris/__init__.py
2. Add a new changelog entry in debian/changelog using the dch (debchange) tool

Using dch tool

The dch tool (from the devscripts package) is the standard way to maintain debian changelog files. Example workflow:

# Update version in Python package
sed -i 's/__version__ = "0.24"/__version__ = "0.25"/' src/damaris/__init__.py

# Add changelog entry with dch
dch --newversion 0.25

# This opens your editor to add the changes for this version
# Or use batch mode with message:
dch -v 0.25 "New features and bug fixes"

# Verify the changelog
tail -20 debian/changelog

The dch command will:

• Create a new entry with the specified version
• Set the distribution to "stable" (or "unstable" for development versions)
• Use the maintainer name and email from the previous entry or environment variables
• Open your editor to add the change descriptions

For development versions, use:

dch -v 0.25-1 --distribution unstable "Development version"

Remember to install devscripts if needed:

sudo apt-get install devscripts