Skip to main content

Utilities to parse Debian package, copyright and control files.

Project description

The Python package debian_inspector is a collection of utilities to parse various Debian package manifests, machine readable copyright and control files collectively known as the Debian 822 format (based on the RFC822 email format).

It was originally named “debut” as a portmanteau of DEBian and UTilities.

Origin

This library is based on a heavily modified and remixed combination of original code with code from other origins:

  • python-deb-pkg-tools from @xolox for its handling of Debian packages and the parsing of versions, dependencies and other package-to-package relationship fields and for its ability to process the syntax of Debian versions and compare them. See https://github.com/xolox/python-deb-pkg-tools

  • dlt (Debian license tools) from @agustinhenze for its check of the coverage of a license file Files sections and a lot of inspiration. See https://github.com/agustinhenze/dlt/

  • PGPy from @SecurityInnovation and @Commod0re for its ability to remove a PGP signature from an email. dsc (Debian Source Control) files are typically PGP-signed and are email-like. See https://github.com/SecurityInnovation/PGPy

  • python-dpkg by @TheClimateCorporation and @memory for its ability to process the syntax of Debian versions and to compare them according to the spec. See https://github.com/TheClimateCorporation/python-dpkg

Why?

Why create this seemingly redundant library? The official python-debian tools and several other utilities already provide similar capabilities!

On the surface this is correct, but there are several reasons for a new utility:

  • Existing tools parse control files strictly. This library tries to be more flexible. For instance it can recognize and fix some almost correct copyright files that are not fully “machine readable” but close enough to the spec to be worthy of recovery.

  • Several of these tools have to deal with legacy compatibility. We do not have such a need. For instance, the Python standard library email module and one line of code is enough to parse a Debian 822 file fields. I doubt that this feature was available in the standard library when python-debian was started but it is here now and this vastly simplifies the code.

  • The focus of this library is to parse and inspect control files, not to emit and create them, so the code and tests can be much simpler. For instance, rather than using more complex case-insensitive dictionary keys while preserving case for Deb822-like objects, this library uses lower case keys throughout.

  • The official python-debian library is GPL-licensed making it it hard to combine with Apache-licensed libraries. I tried to work out a licensing change for python-debian with all its authors such that it could be integrated in permissive-licensed Python tools. Even though most current maintainers and contributors were OK with that relicensing to a permissive or an LGPL license, I could not get a reply and agreement from some important legacy authors: therefore the relicensing was not possible.

License

SPDX-License-Identifier: Apache-2.0 AND BSD-3-Clause AND MIT

This software combines software from several origins with different licenses. All of these licenses apply as all original files have been refactored and remixed significantly:

Copyright (c) nexB Inc. and others.
Copyright (c) Peter Odding.
Copyright (c) The Climate Corporation (https://climate.com)
Copyright (c) Security Innovation, Inc
Copyright (c) Agustin Henze <tin@sluc.org.ar>

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

debian_inspector-21.5.25.tar.gz (117.4 kB view details)

Uploaded Source

Built Distribution

debian_inspector-21.5.25-py3-none-any.whl (45.2 kB view details)

Uploaded Python 3

File details

Details for the file debian_inspector-21.5.25.tar.gz.

File metadata

  • Download URL: debian_inspector-21.5.25.tar.gz
  • Upload date:
  • Size: 117.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.6.10

File hashes

Hashes for debian_inspector-21.5.25.tar.gz
Algorithm Hash digest
SHA256 5c619eaeb2ebb4b7010eda15141cf6738db3b0171527316d415b4d0038567db4
MD5 30441d06092d9aa6f604dced6614d895
BLAKE2b-256 c34438df9c8785ec118fb1e7a649081426c927b7c8ed0543c54748d1da1b4c89

See more details on using hashes here.

Provenance

File details

Details for the file debian_inspector-21.5.25-py3-none-any.whl.

File metadata

  • Download URL: debian_inspector-21.5.25-py3-none-any.whl
  • Upload date:
  • Size: 45.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.4.1 importlib_metadata/4.0.1 pkginfo/1.7.0 requests/2.25.1 requests-toolbelt/0.9.1 tqdm/4.61.0 CPython/3.6.10

File hashes

Hashes for debian_inspector-21.5.25-py3-none-any.whl
Algorithm Hash digest
SHA256 d5f5542e584e5f218903e14333112326e295a07bfb4e8cdfcdd2a51482610a4e
MD5 a12e9a1c36ceca3a7de3c06b4577fd45
BLAKE2b-256 abdcbc1700e17715554022247071fcd723e5e1e738c4126388bbbabf8d8b8e5f

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page