Changes File Implementation¶
This module contains code to aid in processing .changes files. Most of this code has been yanked from Jonny Lamb. Thanks, Jonny.
Facade¶
-
dput.changes.
parse_changes_file
(filename, directory=None)¶ Parse a .changes file and return a dput.changes.Change instance with parsed changes file data. The optional directory argument refers to the base directory where the referred files from the changes file are expected to be located.
Abstraction¶
-
class
dput.changes.
Changes
(filename=None, string=None)¶ Changes object to help process and store information regarding Debian .changes files, used in the upload process.
-
_parse_section
(section)¶ Works out the component and section from the “Section” field. Sections like python or libdevel are in main. Sections with a prefix, separated with a forward-slash also show the component. It returns a list of strings in the form [component, section].
For example, non-free/python has component non-free and section python.
section
Section name to parse.
-
get
(key, default=None)¶ Returns the value of the rfc822 key specified, but defaults to a specific value if not found in the rfc822 file.
key
- Key of data to request.
default
- Default return value if
key
does not exist.
-
get_changes_file
()¶ Return the full, absolute path to the changes file. For just the filename, please see
get_filename()
.
-
get_component
()¶ Returns the component of the package.
-
get_diff
()¶ Returns the name of the .diff.gz file if there is one, otherwise None.
-
get_dsc
()¶ Returns the name of the .dsc file.
-
get_filename
()¶ Returns the filename from which the changes file was generated from. Please do note this is just the basename, not the entire full path, or even a relative path. For the absolute path to the changes file, please see
get_changes_file()
.
-
get_files
()¶ Returns a list of files referenced in the changes file, such as the .dsc, .deb(s), .orig.tar.gz, and .diff.gz or .debian.tar.gz. All strings in the array will be absolute paths to the files.
-
get_package_name
()¶ Returns the source package name
-
get_pool_path
()¶ Returns the path the changes file would be
-
get_priority
()¶ Returns the priority of the package.
-
get_section
()¶ Returns the section of the package.
-
validate
(check_hash='sha1', check_signature=True)¶ See
validate_checksums()
forcheck_hash
, andvalidate_signature()
ifcheck_signature
is True.
-
validate_checksums
(check_hash='sha1')¶ Validate checksums for a package, using
check_hack
‘s type to validate the package.Valid
check_hash
types:- sha1
- sha256
- md5
- md5sum
-
validate_signature
(check_signature=True)¶ Validate the GPG signature of a .changes file.
Throws a
dput.exceptions.ChangesFileException
if there’s an issue with the GPG signature. Returns the GPG key ID.
-