# `gbp.dch` module documentation

Part of `gbp`

provides git-dch helpers

Variable | MAX_CHANGELOG_LINE_LENGTH | Undocumented
Function | extract_git_dch_cmds | No summary
Function | filter_ignore_rx_matches | Filter any lines that match options.ignore_regex (i.e. --ignore-regex).
Function | extract_bts_cmds | No summary
Function | extract_thanks_info | Return a list of all of the Thanks: entries, and a list of all of the lines that do not contain Thanks: entries.
Function | terminate_first_line_if_needed | Terminate the first line of lines with a '.' if multi-line.
Function | format_changelog_entry | No summary
Function | _ispunct | Undocumented

MAX_CHANGELOG_LINE_LENGTH =
Undocumented
(type: `int`)
def extract_git_dch_cmds(lines, options):

Return a dictionary of all Git-Dch: commands found in lines. The command keys will be lowercased, i.e. {'ignore' : True, 'short': True}. For now, all the options are binary. Also return all of the lines that do not contain Git-Dch: commands.

def filter_ignore_rx_matches(lines, options):

Filter any lines that match options.ignore_regex (i.e. --ignore-regex).

def extract_bts_cmds(lines, opts):

Return a dictionary of the bug tracking system commands contained in the the given lines. i.e. {'closed' : [1], 'fixed': [3, 4]}. Right now, this will only notice a single directive clause on a line. Also return all of the lines that do not contain bug tracking system commands.

def extract_thanks_info(lines, options):

Return a list of all of the Thanks: entries, and a list of all of the lines that do not contain Thanks: entries.

def _ispunct(ch):
Undocumented
def terminate_first_line_if_needed(lines):

Terminate the first line of lines with a '.' if multi-line.

def format_changelog_entry(commit_info, options, last_commit=(False)):

Return a list of lines (without newlines) as the changelog entry for commit_info (generated by GitRepository.get_commit_info()). If last_commit is not False, then this entry is the last one in the series.