Skip to main content

Utilities to parse Debian package, copyright and control files.

Project description

The Python package debut 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).

Why the name debut? That’s a portmanteau of DEBian and UTilities!

Origin

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

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 differences and reasons listed here:

  • Existing tools are parsing control files rather 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 a lot of legacy compatibility. We do not have such 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 thatthis feature was available in the standard library when python-debian was started but it is here now and this vastly simplifies the code.

  • This library focus is to parse and inspect control files and much less so to emit and create them, so the code and tests can be much simpler. For instance, rather than using somewhat 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 went through efforts to work out a relicensing of 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 could not happen.

License

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

This software combines several origins each with their own license. All these licenses apply as all original files have been refactored and remixed significantly:

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

Note that the tests/ may also contain files using other FOSS licenses.

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

debut-0.9.1.tar.gz (348.6 kB view hashes)

Uploaded Source

Built Distribution

debut-0.9.1-py2.py3-none-any.whl (180.1 kB view hashes)

Uploaded Python 2 Python 3

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