Public Access
46 lines
1.2 KiB
Markdown
46 lines
1.2 KiB
Markdown
# 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:
|
|
|
|
```bash
|
|
# 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:
|
|
```bash
|
|
dch -v 0.25-1 --distribution unstable "Development version"
|
|
```
|
|
|
|
Remember to install devscripts if needed:
|
|
```bash
|
|
sudo apt-get install devscripts
|
|
```
|