daklib.checks

module provided pre-acceptance tests

Please read the documentation for the Check class for the interface.

Functions

check_fields_for_valid_utf8(filename, control)	Check all fields of a control file for valid UTF-8
check_signature_timestamp(prefix, signed_file)

Classes

ACLCheck()	Check the uploader is allowed to upload the packages in .changes
ArchAllBinNMUCheck()	Check for arch:all binNMUs
BinaryCheck()	Check binary packages for syntax errors.
BinaryMembersCheck()	check members of .deb file
BinaryTimestampCheck()	check timestamps of files in binary packages
ChangesCheck()	Check changes file for syntax errors.
Check()	base class for checks
ExternalHashesCheck()	Checks hashes in .changes and .dsc against an external database.
LintianCheck()	Check package using lintian
NewOverrideCheck()	Override NEW requirement
NoSourceOnlyCheck()
SignatureAndHashesCheck()	Check signature of changes and dsc file (if included in upload)
SignatureTimestampCheck()	Check timestamp of .changes signature
SingleDistributionCheck()	Check that the .changes targets only a single distribution.
SourceCheck()	Check source package for syntax errors.
SourceFormatCheck()	Check source format is allowed in the target suite
SuiteArchitectureCheck()
SuiteCheck()
TransitionCheck()	check for a transition
VersionCheck()	Check version constraints
WeakSignatureCheck()	Check that .changes and .dsc are not signed using a weak algorithm

Exceptions

Reject	exception raised by failing checks
RejectACL(acl, reason)	exception raise by failing ACL checks
RejectExternalFilesMismatch	exception raised by failing the external hashes check

class daklib.checks.ACLCheck

Check the uploader is allowed to upload the packages in .changes

_check_acl(session, upload, acl)

_does_hijack(session, upload, suite)

check(upload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

per_suite_check(upload, suite)

do per-suite checks

Parameters:

• upload – upload to check

• suite – suite to check

Raises:

Reject – upload should be rejected

class daklib.checks.ArchAllBinNMUCheck

Check for arch:all binNMUs

check(upload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

class daklib.checks.BinaryCheck

Check binary packages for syntax errors.

check(upload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

check_binary(upload, binary)

class daklib.checks.BinaryMembersCheck

check members of .deb file

_check_binary(filename: str, path: str) → None

check(upload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

class daklib.checks.BinaryTimestampCheck

check timestamps of files in binary packages

Files in the near future cause ugly warnings and extreme time travel can cause errors on extraction.

check(upload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

class daklib.checks.ChangesCheck

Check changes file for syntax errors.

check(upload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

class daklib.checks.Check

base class for checks

checks are called by daklib.archive.ArchiveUpload. Failing tests should raise a daklib.checks.Reject exception including a human-readable description why the upload should be rejected.

check(upload: ArchiveUpload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

property forcable: bool

allow to force ignore failing test

True if it is acceptable to force ignoring a failing test, False otherwise

per_suite_check(upload: ArchiveUpload, suite: Suite)

do per-suite checks

Parameters:

• upload – upload to check

• suite – suite to check

Raises:

Reject – upload should be rejected

class daklib.checks.ExternalHashesCheck

Checks hashes in .changes and .dsc against an external database.

check(upload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

check_single(session, f)

class daklib.checks.LintianCheck

Check package using lintian

check(upload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

class daklib.checks.NewOverrideCheck

Override NEW requirement

check(upload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

class daklib.checks.NoSourceOnlyCheck

check(upload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

is_source_only_upload(upload) → bool

exception daklib.checks.Reject

exception raised by failing checks

exception daklib.checks.RejectACL(acl, reason)

exception raise by failing ACL checks

exception daklib.checks.RejectExternalFilesMismatch

exception raised by failing the external hashes check

class daklib.checks.SignatureAndHashesCheck

Check signature of changes and dsc file (if included in upload)

Make sure the signature is valid and done by a known user.

_check_hashes(upload: ArchiveUpload, filename: str, files: Iterable[HashedFile])

Make sure hashes match existing files

Parameters:

• upload – upload we are processing

• filename – name of the file the expected hash values are taken from

• files – files to check the hashes for

check(upload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

check_replay(upload) → bool

class daklib.checks.SignatureTimestampCheck

Check timestamp of .changes signature

check(upload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

class daklib.checks.SingleDistributionCheck

Check that the .changes targets only a single distribution.

check(upload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

class daklib.checks.SourceCheck

Check source package for syntax errors.

check(upload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

check_filename(control, filename, regex: Pattern) → None

class daklib.checks.SourceFormatCheck

Check source format is allowed in the target suite

per_suite_check(upload, suite)

do per-suite checks

Parameters:

• upload – upload to check

• suite – suite to check

Raises:

Reject – upload should be rejected

class daklib.checks.SuiteArchitectureCheck

per_suite_check(upload, suite)

do per-suite checks

Parameters:

• upload – upload to check

• suite – suite to check

Raises:

Reject – upload should be rejected

class daklib.checks.SuiteCheck

per_suite_check(upload, suite)

do per-suite checks

Parameters:

• upload – upload to check

• suite – suite to check

Raises:

Reject – upload should be rejected

class daklib.checks.TransitionCheck

check for a transition

check(upload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

get_transitions()

class daklib.checks.VersionCheck

Check version constraints

_highest_binary_version(session, binary_name, suite, architecture)

_highest_source_version(session, source_name, suite)

_version_checks(upload, suite, other_suite, op, op_name)

property forcable: bool

allow to force ignore failing test

True if it is acceptable to force ignoring a failing test, False otherwise

per_suite_check(upload, suite)

do per-suite checks

Parameters:

• upload – upload to check

• suite – suite to check

Raises:

Reject – upload should be rejected

class daklib.checks.WeakSignatureCheck

Check that .changes and .dsc are not signed using a weak algorithm

check(upload)

do checks

Parameters:

upload – upload to check

Raises:

Reject – upload should be rejected

daklib.checks.check_fields_for_valid_utf8(filename, control)

Check all fields of a control file for valid UTF-8

daklib.checks.check_signature_timestamp(prefix: str, signed_file: SignedFile) → bool