summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--debian/changelog1148
-rw-r--r--debian/control62
-rw-r--r--debian/copyright49
-rw-r--r--debian/debputy.manifest7
-rw-r--r--debian/gbp.conf6
-rwxr-xr-xdebian/rules11
-rw-r--r--debian/source/format1
-rw-r--r--debian/tests/control19
-rwxr-xr-xdebian/tests/debputy-cli49
-rwxr-xr-xdebian/tests/debputy-cli-lint-lsp6
-rwxr-xr-xdebian/tests/debputy-py.test33
11 files changed, 1391 insertions, 0 deletions
diff --git a/debian/changelog b/debian/changelog
new file mode 100644
index 0000000..7c26793
--- /dev/null
+++ b/debian/changelog
@@ -0,0 +1,1148 @@
+debputy (0.1.21) unstable; urgency=medium
+
+ * Plugin API:
+ - VirtualPath API: The `lookup` method now resolves symlinks if
+ necessary
+ - VirtualPath API: Provide `interpreter` method to resolve the
+ interpreter of a file (based on the `#!`-line).
+
+ * migrate-from-dh:
+ - Support different integration levels using the new --migration-target
+ option with defaults derived from existing packaging where possible.
+
+ * debputy: Code better with faulty optional plugins (Closes: debputy#73)
+ * README.md: Document communication channels
+ * debputy: Accept usr/lib/MA/Package as private python dir
+ * debputy: Provide `plugin {list,show} type-mappings` subcommand
+ * debputy: Preserve name of mapped type in most cases for plugin show p-m-r
+ * d/changelog: Typo fixes and re-align some entries that were "too long".
+ * Preserve mtime from ref_path where possible
+ * Fix bug where `binary-version` from the manifest was not used
+ * Add minimal `R³ dh` integration mode for `util-linux` and other packages
+ that want to migrate away from `fakeroot`. Use
+ `debputy migrate-from-dh --migration-target dh-sequence-zz-debputy-rrr`
+ to get migration aid for this integration mode.
+ * debputy: Make `mtime` resolution more robust (Closes: debputy#75)
+ * Auto-correct common interpreters
+ * Update handling of `t64:Provides` to match debhelper
+ * debputy: Fix crash bug when packages did not use debhelper
+ * debputy: Avoid passing the substvars file to dh_gencontrol for -dbgsym
+ packages
+ * debputy: Automatically apply relationship substvars. See
+ https://lists.debian.org/debian-devel/2024/03/msg00030.html for
+ details.
+ * debputy: Use `shlibs:Pre-Depends` by default for essential packages
+ * Implement initial Language Server based on `pygls` and linter. With this
+ comes the following new subcommands:
+ - `debputy lsp server` starts the language server to support editors
+ with Debian packaging files.
+ - `debputy lsp editor-config NAME` provides config snippets for
+ known editors.
+ - `debputy lsp features` provides a human readable list of features
+ and language IDs currently supported. Mostly useful for people
+ trying to determine what to put in their editor config where
+ `debputy lsp editor-config` cannot help them.
+ - `debputy lint` provides a "batch" (non-interactive) version of
+ the diagnostics that `debputy lsp server` provides for the case
+ where you want these without an editor as intermediate (or
+ where you editor does not support LSP).
+
+ Most of these features will require optional dependencies. Check the
+ Recommends and Suggests for packages that may be relevant for you.
+ The `debputy` manpage has a section on how `debputy lint` relates
+ to other tools such as `debputy lsp` and `lintian`.
+
+ * Vendor a copy of the `python-debian` RTS parser until the relevant
+ features are merged into `python-debian`.
+
+ -- Niels Thykier <niels@thykier.net> Sun, 24 Mar 2024 11:29:19 +0100
+
+debputy (0.1.20) unstable; urgency=medium
+
+ * Plugin API:
+ - Support cross package content checks in metadata detectors.
+ The feature prevents the metadata detector from "unsafe"
+ access to other packages. As an example, arch:any packages
+ can never see the content for arch:all packages (since
+ they are not always built together).
+
+ * migrate-from-dh:
+ - Add migration support for the `sodeps` sequence along with its
+ related `so:Depends` substvar.
+
+ * debputy: Support the `X-Time64-Compat` field as used by `debhelper`
+ * debputy: Tweak wording of automatic-discard-rules examples in
+ the output of `debputy plugin show a-d-r ...`.
+ * debputy: Accessibility related changes:
+ - Add CSV output for *human* consumption on many of the plugin
+ list commands. This enables easier consumption for screen
+ readers when the user wants structured data. Note the CSV
+ is *not* guaranteed to remain stable for scripting purposes.
+ - Do not describe the table for screen readers. Instead,
+ generate the ASCII table again but without the divider
+ lines, which would just be line noise.
+ - Revert on URL rewriting of manpages for screen readers. For now
+ also disable creating urls when the link text is not equal to
+ the url as it is not clear how the screen reader reacts to the
+ hyperlinks.
+ * debputy: Fix automatic pager feature not working as intended.
+ This was a regression in the previous release.
+ * debputy.pod: Improve `debputy` manpage. Among other,
+ document more subcommands. Example, `migrate-from-dh` was
+ not documented previously.
+ * debputy: Provide a better error message for
+ `--plugin ./fake/debputy.json`. It never worked and now you
+ just get a better error message than `debputy` saying that
+ `debputy` was already loaded.
+ * debputy: Support bug#950723 style pkgfiles when `dh_assistant`
+ announces it for `annotate-debian-directory`.
+ * debputy: Fallbackless only applies to files without an explicit
+ package. Unclear whether it could be abused or cause issues.
+ * debputy: Make ASCII list headers bold face for terminal output.
+ * debputy: Generate `libfooX (= ${binary:Version})` `misc:Depends`
+ via libfoo.so symlink. This largely replaces `dh_sodeps.
+ * d/changelog: Fix typo in a previous entry.
+
+ -- Niels Thykier <niels@thykier.net> Wed, 31 Jan 2024 21:14:21 +0100
+
+debputy (0.1.19) unstable; urgency=medium
+
+ * Plugin API:
+ - Breaking change (JSON-only): Group reference documentation
+ attributes for packager provided files under the new
+ `reference-documentation` attribute.
+
+ * debputy: Fix double inverted boolean
+ * debputy: Improve the command output in multiple ways
+ - When users set `OPTIMIZE_FOR_SCREEN_READER=1`, `debputy` now
+ prints less visualization. Notably, ASCII formatting such as
+ underlying is removed. Some commands now also uses a more
+ textual description rather than a visual output. As the
+ poster example, compare `debputy plugin show a-d-r la-files`
+ with and without this option.
+ - Documentation URLs are now rendered as clickable links for
+ terminal emulators that support the relevant ANSI escape
+ sequence. When optimizing output for screen readers,
+ `man:name(section)` URIs are unconditionally written to
+ their `https://manpages.debian.org/name.section` as manpages
+ are generally not working very well with screen readers
+ unlike HTML based documentation.
+ - With `python3-colors`, output now uses a bit more
+ formatting such as boldface text when outputting to a
+ terminal.
+ * debputy: Fix crash when doing `annotate-debian-directory` on a
+ `debputy`-based package
+ * d/changelog: Document plugin API change in 0.1.18
+ * Move `lua` plugin into a separate folder to avoid failing in
+ autopkgtests.
+ * d/tests/debputy-cli: Fix invalid usage of a subcommand that
+ failed the test.
+
+ -- Niels Thykier <niels@thykier.net> Sun, 28 Jan 2024 16:12:42 +0100
+
+debputy (0.1.18) unstable; urgency=medium
+
+ * Plugin API:
+ - Packager Provided Files can now reference documentation
+ in the form of a generic description and URIs documenting
+ the file format.
+
+ * Plugins:
+ - Add `perl-openssl` plugin to mirror `dh-perl-openssl`.
+
+ * debputy: Refactor to make root level partly introspectable
+ * migrate-from-dh: Avoid asking users to remove Build-Depends
+ on dh sequences that are replaced. This is because they often
+ also provide relevant dependencies that the `debputy` plugin
+ dependency cannot provide (as long as the plugin is provided
+ by `dh-debputy`).
+ * Added partial migration of the `dh-lua` sequence. It is not
+ installed because the `lua` debhelper build system uses
+ build-time `d/pkg.install` files, which are not supported
+ by `debputy`. Omitted the migration code for `lua` as it
+ would just lead to false-hopes and broken hearts!
+ * debputy: Provide a `show` for packager provided files
+ * debputy: Provide a `used-packager-provided-files` list topic
+ * debputy: Add new `tool-support` command with the following
+ subcommands:
+ - annotate-debian-directory: Will scan the `debian` directory
+ for known packager files and annotate with hints and
+ documentation URIs. Data partly sourced from plugins and
+ from `dh_assistant`. Output is always JSON.
+ - export-reference-data: Provides access to reference data
+ used in other commands. Outputs text by default, but
+ supports `--output-format=json` for json exports.
+ - supports-tool-command: Test whether a particular
+ `tool-support` command is supported (without having to
+ parse `--help` output).
+ * debputy: Avoid printing `Loading plugin` in all sub commands
+ * Support nested `TypedDict`s in the declarative parsers
+
+ -- Niels Thykier <niels@thykier.net> Sat, 27 Jan 2024 20:54:33 +0100
+
+debputy (0.1.17) unstable; urgency=medium
+
+ * Plugin API:
+ - VirtualPath: Introduce `size` attribute to simplify some code
+
+ * debputy: Auto-detect and provide maintscripts for pam-config files.
+ Specifically, add the `pam-auth-update` call to relevant
+ maintscripts.
+ * MANIFEST-FORMAT.md: Clarify conflict resolution description
+ * debputy: Tweak the wording of the reference documentation placeholder
+ for when a plugin does not provide any (online) documentation.
+ * debputy: Refactored some internals to add a (non-public) plugin
+ infrastructure for adding parsing hooks to `packages.<PKG>`.
+ As a side-effect:
+ - `debputy plugin list/show p-m-r` can now access and describe these
+ hooks.
+ - The `show` output for these rules that reference certain other
+ rules now report them by their type name. As an example,
+ `when` is now described as a `ManifestCondition` rather than
+ `string or mapping`. This provides better traceability between
+ the rules.
+ * debputy: Fix bug in generated scripts for `clean-after-removal`
+ where a start quote (`"`) was missing.
+ * debputy: Fix bug where Installed-Size was wrong for -dbgsym packages
+ (it incorrectly excluded the size for anything in the data.tar).
+ * debputy: Fix online description for `not`, which was a copy-waste
+ from another rule.
+
+ -- Niels Thykier <niels@thykier.net> Sat, 20 Jan 2024 11:18:45 +0100
+
+debputy (0.1.16) unstable; urgency=medium
+
+ * migrate-from-dh:
+ - Remove `d/tmp` from sources in d/install files. Having
+ `d/tmp` in the paths would not work the same without an
+ explicit `as` or `dest-dir`.
+
+ * debputy: Fix crash when showing certain plugable-manifest-rules
+ * d/changelog: Avoid using `install-{,-doc}-as` like it is an install
+ rule. It was used as a short-hand for `install` (or `install-doc`)
+ with the `as` attribute but implied you could write `install-as`
+ in the manifest.
+ * docs: Correct the description of `required-when` for `discard`
+ * debputy: Fix source date epoch for strip-nondeterminism with
+ binNMU builds.
+ * Test API: Provide features to validate/test manifest variables
+ * d/tests/debputy-cli: Add tests for recent broken doc
+ * test: Add negative test for automatic discard rule example checks
+ * d/control: Add dependency on `man-db` needed to run `man-recode`.
+ Previously, we relied on the `debhelper` to pull this dependency.
+ * THANKS.md: Acknowledge Paul Gevers for his early adoption and
+ testing.
+ * debputy: Incomplete support for `dh_installdebconf`. Any debconf
+ templates (such as `debian/templates`) will now be processed and
+ lead to a `DEBIAN/templates` file in the resulting deb and the
+ `postrm` will run `db_purge` on `purge`. However, it is not possible
+ to provide a `DEBIAN/config` or custom `postinst` snippets leveraging
+ the debconf templates. Accordingly, the migration tool still flags
+ `templates` files as unsupported for now.
+ * debputy.pod: Provide manpage for `debputy` itself.
+
+ -- Niels Thykier <niels@thykier.net> Mon, 08 Jan 2024 15:44:03 +0100
+
+debputy (0.1.15) unstable; urgency=medium
+
+ * manifest:
+ - Support `capabilities` via `path-metadata` (Closes: debputy#62)
+
+ * debputy: Fix regression where maintscripts would not be generated.
+ * debputy: Fix a bug where `systemctl daemon-reload` would always
+ be added to postrm.
+
+ -- Niels Thykier <niels@thykier.net> Fri, 29 Dec 2023 17:30:54 +0100
+
+debputy (0.1.14) unstable; urgency=medium
+
+ * manifest:
+ - Breaking change: The `discard` rule must now match at least one
+ path by default when it applies to at least one existing
+ search directory.
+ - Breaking change: Renamed `when` to `required-when` for `discard`
+ rules. The name better reflects that the `discard` rule is
+ always applied. The conditional decides whether it is an error
+ for a path to match nothing
+ - Support `**/non-glob` as a basename match. This form must use
+ the leading `**/` part to be a basename match. Without the leading
+ `**/`, the pattern would be interpreted as an exact path match
+ for a top-level file/directory.
+
+ * migrate-from-dh:
+ - List `dh_install` as replaced which ensures `debputy` will
+ detect overrides/hook targets for `dh_install`.
+
+ * debputy: Align md5sums order with `dh_md5sums` to reduce the diffs
+ between a `debhelper` and a `debputy` produced `.deb`.
+ * debputy: Support processing files with `strip-nondeterminism` to
+ reduce the amount of non-deterministic content in a package.
+
+ -- Niels Thykier <niels@thykier.net> Thu, 28 Dec 2023 17:39:07 +0100
+
+debputy (0.1.13) unstable; urgency=medium
+
+ * Manifest:
+ - Support per-package installation search directories via the new
+ `installation-search-dirs` attribute (under `packages.*`) .
+ - The `discard` install rule now accepts a `search-dir`/`search-dirs`
+ attribute, which can be used to restrict which search directories
+ the discarding applies too.
+ - Added new `multi-dest-install` rule for the rare case where a
+ package needs to install the same source *twice*. This was needed
+ for `kafs-client`. (Closes: debputy#66)
+ - Any `udeb` packages are ignored when install-doc (etc.) evaluates
+ default for `into`. This means if a source package only builds a
+ single `deb` plus one or more `udeb`s, then `into` is now optional
+ for all documentation related `install-X` rules.
+
+ * migrate-from-dh:
+ - Support migrating multi-dest sources in d/install.
+
+ * Plugin API:
+ - VirtualPath API: Use of `path.replace_fs_path_content` no longer
+ detaches the path
+
+ * debputy: Fix `FileNotFoundError` when building `udeb` packages
+ * debputy: Fix bug where install rules with multiple `into` did not
+ always work correctly
+ * debputy: Fix online documentation for `into` in most install rules
+ * debputy: Fix bug where `shlibs` where not generated when it should
+ have been. This was a regression introduced in 0.1.10.
+ * debputy: Let dpkg-shlibdeps see SONAMEs from other packages. This
+ was necessary for `kafs-client`. (Closes: debputy#66)
+ * debputy: Fix bug where plugin provided triggers were silently
+ discarded.
+
+ -- Niels Thykier <niels@thykier.net> Mon, 25 Dec 2023 22:41:13 +0100
+
+debputy (0.1.12) unstable; urgency=medium
+
+ * Plugin API:
+ - Test API: Breaking change. Make metadata related tests stateless
+ - `VirtualPath` API: Add an `is_executable` property
+
+ * migrate-from-dh:
+ - Assume minimum compat of 12 for all packages now to match the
+ `dh_installinit` mechanics that `debputy` now perform when an
+ `init` script is present.
+
+ * d/control: Use `Debian-based` in the description to appease lintian
+ * d/control: Canonicalize the URL in the Vcs-Browser field
+ * d/control: Use `debputy@packages.debian.org` as maintainer address
+ * debputy: Tweak wording for several error messages
+ * Add initial support for service management. It covers the default
+ flow of `dh_installinit` and `dh_installsystemd`. Notably, the
+ `dh_installsystemduser` is *not* covered.
+ * Fix bug in `install-man` rule that made it unusable
+ * Internal refactoring (notably of the installation rules code).
+
+ -- Niels Thykier <niels@thykier.net> Sun, 17 Dec 2023 18:08:13 +0000
+
+debputy (0.1.11) unstable; urgency=medium
+
+ * Manifest:
+ - Breaking change: Correct spelling of `build-profiles-matches`
+ so it now matches the documentation.
+ - The `install-docs` rule now supports `dest-dir` and `as`. Its
+ default `dest-dir` remains the same.
+ - Provide `path:GNU_INFO_DIR` manifest variable that represents
+ the directory where GNU info files should be installed into.
+
+ * Plugin API:
+ - VirtualPath now supports `open` with buffering.
+ - When declaring manifest snippets, automatically pick up
+ `FileSystemMatchRule` (and subclasses) up as `path hints` (used
+ to provide context for error messages)
+
+ * migrate-from-dh:
+ - Improve some error messages to provide the actual file path
+ instead on an internal object name/id.
+ - Fix detection of `dh-exec` conditionals that could cause the
+ conditions to be interpreted as literal values rather than
+ conditionals.
+ - Support `dh-exec` conditionals in `d/install`.
+ - Provide more support for dh-exec features in d/manpages. Notably,
+ `SOURCE => DEST` is now rewritten into an `install-doc` (with `as`)
+ rule and conditionals are now supported.
+ - Multiple conditions in `d/links` files are now supported
+ and will be translated into an `all-of`.
+ - Avoid single-item `sources` for migrated bash-completions.
+ (Style-only change)
+ - Create a placeholder variable for unknown manifest variables.
+ Previously, it would result in a hard error as the resulting
+ manifest could not be parsed. (Closes: debian/debputy#65)
+ - Support migrating `d/info` files
+
+ * debputy: Convert transformation and install rules to using
+ `FileSystemMatchRule`s for paths. This unifies parsing of globs for
+ all rules except `clean-after-removal` (which still uses shell glob
+ semantics).
+ * online doc for path-metadata: Fix copy-paste mistake
+ * Fix crash bug where `d/tmp` is not a directory but an install rule is
+ used (unclear if this was reproducible in older versions).
+ * debputy: Fix internal error by `debputy` setting wrong "CoW"-flag on
+ some paths
+ * d/changelog: Clarify wording of a previous entry and fix a few typos.
+ * debputy: Correct two error messages that should have shown valid attribute
+ names when incorrect values were provided.
+ * debputy: Fix bug in parsing of `all-of` and `any-of` manifest conditions
+ that made it impossible to use these manifest conditions.
+ * tests: Provide initial tests of basic install rules. Required some
+ refactoring related to the virtual file system to support these
+ tests.
+
+ -- Niels Thykier <niels@thykier.net> Sun, 10 Dec 2023 14:40:05 +0000
+
+debputy (0.1.10) unstable; urgency=medium
+
+ * Manifest changes:
+ - Support `clean-after-removal` feature, where you can ask
+ `debputy` to remove files when the package has been removed
+ or is being purged. This feature is similar in spirit to
+ `rpm`'s `%ghost` files. (Closes: debputy#35)
+
+
+ * plugin API: Fix bug where `path.chmod("symbolic-mode")` would
+ raise an exception
+ * debputy: Defer error'ing out when dpkg-gensymbols returns with a non-zero
+ exit code until all packages have been processed
+ * debputy: Optimize materialization to require less copying via
+ the following features:
+ - Properly implement lazy copy-on-write actions to avoid
+ copying a file into the scratch directory only to copy it
+ to the materialization directory later. Now, the case
+ only performs one copy (directly from the source to the
+ materialization directory).
+ - When a file has already been copied into the scratch
+ directory because `debputy` needed to mutate the file,
+ use a `mv` rather than a `cp` to move the file to its
+ final destination.
+
+ -- Niels Thykier <niels@thykier.net> Sun, 03 Dec 2023 16:01:57 +0100
+
+debputy (0.1.9.3) unstable; urgency=medium
+
+ * migrate-from-dh:
+ - Support full migration of `dh-sequence-numpy3`. Though, there
+ is still no `dh-sequence-python3` migration support, which
+ may make this less useful at the moment.
+ * tests: Fix bug where `debputy` provided plugins fails in
+ installed mode causing `debputy` autopkgtests to fail.
+ * tests: Improve test coverage for gnome plugin.
+
+ -- Niels Thykier <niels@thykier.net> Wed, 29 Nov 2023 21:24:15 +0100
+
+debputy (0.1.9.2) unstable; urgency=medium
+
+ * gnome plugin: Fix broken version in substvars and add a basic
+ regression test.
+ * debputy: Some internal refactoring.
+
+ -- Niels Thykier <niels@thykier.net> Tue, 28 Nov 2023 19:23:53 +0100
+
+debputy (0.1.9.1) unstable; urgency=medium
+
+ * plugin test API: Enable the test API to validate ADR examples
+ * debputy: Skip compression of .html/.htm files.
+ Thanks to Sven Joachim <svenjoac@gmx.de> (Closes: #1057001)
+ * debputy: Special-case doc-base files to minimize delta between
+ `debputy` and debhelper.
+
+ -- Niels Thykier <niels@thykier.net> Mon, 27 Nov 2023 22:01:14 +0100
+
+debputy (0.1.9) unstable; urgency=medium
+
+ * Plugin changes:
+ - Breaking change: The features of the `bash-completion`
+ plugin has been embedded into the `debputy` plugin. The
+ `bash-completion` plugin has been removed without a
+ backwards compatibility feature.
+ - Breaking change (test-api): The `virtual_path` function
+ got renamed to `virtual_path_def` and got promoted to
+ the non-test API.
+ - Add more features to the `VirtualPath` API. Notably some
+ mutations are now supported when the file system is in
+ read-write mode.
+ - InstallRule's no longer accept an explicit search dir.
+ Search dir handling is now done differently and plugins
+ are not involved in that process.
+
+ * migrate-from-dh:
+ - Support full migration of `dh-sequence-bash-completion`.
+ - Support partial migration of `dh-sequence-gnome`. The
+ `dh_gnome` side will be migrated, but `dh_gnome_clean`
+ will still be done via the `dh-sequence-gnome`.
+ - List which `dh-sequence-X` Build-Dependencies should be
+ removed. These are listed as manual migrations.
+ - Migration now detects *simple* cases of `dh` addons
+ loaded via `--with` in `debian/rules`.
+
+ * Let `debputy` handle loading of additional variables
+ * d/changelog: Reformat line in the 0.1.8 entry
+ * MANIFEST-FORMAT.md: Correct name of two example manifest variables
+ * MANIFEST-FORMAT.md: Improve documentation related to manifest variables
+ * Add private plugin api for package processors and migrate some
+ `debputy` code to use this feature.
+ * debputy: Provide a `clean .la files` feature by default based on a
+ similar feature from `dh_gnome`.
+ * debputy: Filter out doxygen related cruft (replacing `dh_doxygen`)
+ * Make discard rules a plugin provided feature (currently private)
+ and provide (validated) examples for automatic discard rules.
+ These can be seen via the example command:
+ `debputy plugin list a-d-r doxygen-cruft-files`
+ * debputy: Show which paths have been matched by an automatic discard
+ rule in the build out along with how to override them.
+
+ -- Niels Thykier <niels@thykier.net> Sun, 26 Nov 2023 15:20:44 +0100
+
+debputy (0.1.8) unstable; urgency=medium
+
+ * Manifest changes:
+ - Breaking change: Rename some manifest variables like `{{TAB}}`
+ `{{token:TAB}}`. This change only affects manifest variables
+ intended to provide textual tokens that might be hard to write
+ literally or to avoid triggering substitution of another manifest
+ variable.
+ - Split `arch-matches` condition into three. The `arch-matches`
+ is still preferred. The other two variants are for special-cases
+ related to cross-building. As a side-effect of this change,
+ `arch-matches` can now be used in source context.
+ - Support manifest declared variables. A new `definitions.variables`
+ key is defined where variables can be declared. See
+ MANIFEST-FORMAT.md for the details. (Closes: debputy#58)
+ - It is now possible to use substitution variables in package names
+ in the manifest. This enables the use of `libfoo{{SONAME}}` instead
+ of hard-coding the value.
+
+ * Plugin changes:
+ - Breaking change: Remove the previously required plugin-version
+ attribute.
+ - Streamline installation process for "simple" `debputy` plugins by
+ providing a debhelper tool and by having `debputy` take
+ responsibility for the Python byte-compilation requirement for
+ `debputy` plugins. Additionally, support for running plugin tests
+ have been added too (both as build-time and as installed tests).
+ - Breaking (test-only) change: The test API for loading plugins have
+ been renamed and should no longer be passed a JSON descriptor file.
+ Instead, the test framework will attempt to find the JSON descriptor
+ file on its own. With this method, the test does not have to
+ distinguish between install-time and build-time test runs.
+ - A metadata detector can now request the binary package version
+ of a package via the context parameter.
+ - Plugins can now provide literal manifest variables like `path:FOO_DIR`.
+
+ * debputy: Provide online documentation for most manifest rules
+ * debputy: Correct detection of required/conditional fields in
+ `plugin show pmr`
+ * debputy: Provide "on-line" documentation of manifest conditions
+ * MANIFEST-FORMAT.md: Correct some anchors that would cause broken links
+ in HTML rendered versions of the file.
+ * MANIFEST-FORMAT.md: Clarify `replacement-rule` for `create-symlink` only
+ applies if the declared symlink path exists. If it does not exist and
+ cannot be because it would require a non-directory to become a directory,
+ then `replace-rule` cannot be used.
+ * plugin changes: Make single-file Python module easier to provide
+ * debputy: Add `--plugin` parameter to load plugins for most commands.
+ * debputy: Fix bug where some common args were ignored depending on argument
+ order.
+ * dh_installdebputy: New helper to install `debputy` plugins from
+ debhelper packages.
+ * d/control: Have `dh-debputy` provide `dh-sequence-installdebputy`.
+ * dh-sequence-debputy: Restore `dh_installdir` command. This enables packages
+ to still use the `dh_installdir` helper to work around upstreams that does
+ assumes install directories exist (such as `DEST_DIR`).
+ * debputy: Support d/alternatives files like `dh_installalternatives`.
+ * Provide basic plugin to support d/bash-completion files. The feature is
+ deliberately written as a stand-alone plugin, so it is easier to migrate
+ to the `bash-completion` package later if that is relevant.
+ * GETTING-STARTED-WITH-dh-debputy.md: List `dh_installalternatives` as a
+ replaced command. It has been replaced for quite a while and the omission
+ in the docs was unintentional.
+ * Provide basic bash-completion plugin and provide migrations for the
+ users of `dh-sequence-bash-completion`.
+ * d/tests/control: Add explicit test dependency on python3-all
+ (Closes: #1056240)
+ * debputy: Provide a `plugin list manifest-variables` subcommand that will
+ list known variables. Default special-case and token manifest variables
+ are hidden and have to be requested explicitly.
+ * debputy: Provide a `plugin show manifest-variables VAR` subcommand that
+ will show information about a given manifest variable.
+ * Breaking change: Plugins can now provide manifest variables
+ * d/changelog: Bump snapshot version
+
+ -- Niels Thykier <niels@thykier.net> Sun, 19 Nov 2023 19:00:00 +0100
+
+debputy (0.1.7.8) unstable; urgency=medium
+
+ * Manifest changes:
+ - Breaking change: The `remove` transformation now prunes empty
+ dirs by default. The previous behaviour can be restored with
+ an explicit `keep-empty-parent-dirs: true`.
+
+ * d/tests/debputy-py.test: Fix bugs in autopkgtest
+ * debputy: Provide new `plugable-manifest-rules` topic for `plugin list`.
+ This subcommand enables the user to get a list of all rules available
+ under `installations` or `packages.{{PACKAGE}}.transformations`, etc.
+ * debputy: Provide a `plugin show plugable-manifest-rules` command that
+ can provide some details about each rule (such as `install`).
+ * MANIFEST-FORMAT.md: Clarify some of the "shell"-like examples.
+ * MANIFEST-FORMAT.md: Clarify that "install" (with `as`) behaves like
+ `foo => bar`. Previously, the documentation said `=>` which could also
+ cover the `=> bar` feature from `dh-exec`. However, that feature is
+ handled by the `installations` itself rather than "install" (with
+ `as`).
+ * d/tests/control: Add superficial test of `debputy` command line
+
+ -- Niels Thykier <niels@thykier.net> Sat, 28 Oct 2023 17:15:55 +0200
+
+debputy (0.1.7.7) unstable; urgency=medium
+
+ * debputy: Mention `yamllint` in YAML-level parse errors
+ * debputy: Avoid crashing on usr/share/doc/foo symlinks for non-native
+ packages. Thanks to Paul Gevers <elbrus@debian.org> (Closes: debputy#49)
+ * debputy: Fix crash on octal mode being specified as an int.
+ Thanks to Paul Gevers <elbrus@debian.org> (Closes: debputy#54)
+ * debputy: Ensure dh-integration based scratch (temp) dir is used when called
+ from dh_debputy. This ensures that `dh_clean` will always clean up after
+ `debputy` when `debputy` is used with `debhelper`.
+ * debputy: Resolve variables when processing `as` in `install` rules.
+ Thanks to Paul Gevers <elbrus@debian.org>. It resolves debputy#57, but a
+ regression test has not been added yet.
+ * debputy: Provide contextual error message when using `{{PACKAGE}}` variable
+ when it is not available
+ * debputy: Fix multiple bugs related to installing upstream changelogs
+ * debputy: Unlink empty `conffiles` in the control.tar
+ * d/control: Version the Provides for `dh-sequence-*`
+ Thanks to Paul Gevers <elbrus@debian.org> for the suggestion.
+ * packaging: Add initial autopkgtests
+
+ -- Niels Thykier <niels@thykier.net> Fri, 27 Oct 2023 16:19:48 +0200
+
+debputy (0.1.7.6) unstable; urgency=medium
+
+ * Manifest changes:
+ - Implement substitution in symlink target. Thanks to Paul Gevers
+ for reporting the issue. (Closes: debputy#56)
+ - Add `replacement-rule` parameter to `create-symlink`. With the
+ `replacement-rule` parameter, you can control how `debputy`
+ should react to the `path` of a symlink clashing with an
+ existing file system object. The default behavior remains
+ unchanged.
+
+ * migrate-from-dh:
+ - Merge more `debian/install` rules. Most install rules from
+ `dh_install` will now be grouped by `dest-dir`. There are a few
+ special-cases, where merging is not applied (`=> usr/bin/foo`)
+ and probably will not be.
+
+ [ Paul Gevers ]
+ * MANIFEST-FORMAT.md: Make the difference between the YAML version and the
+ `debputy` manifest-version more explicit. (Closes: debputy#51)
+
+ [ Niels Thykier ]
+ * debputy. Improve error handling of some transformation rules for dir vs.
+ non-dir clashes
+ * debputy: Avoid crashing on an attempt to replace a symlink with a non-empty
+ dir. (Closes: debputy#48)
+ * MANIFEST-FORMAT.md: Remove references to aliases that are not applicable
+ * Declarative parser: Support `Literal` values as type. It is basically
+ interpreted as an enum-like input.
+ * debputy: Fix exception on `remove` rules that used globs (Closes: debputy#52)
+
+ -- Niels Thykier <niels@thykier.net> Sun, 22 Oct 2023 19:08:55 +0200
+
+debputy (0.1.7.5) unstable; urgency=medium
+
+ * migrate-from-dh:
+ - migrate-from-dh: Provide better error message for unresolvable
+ subst vars
+ - migrate-from-dh: Support DEB_VERSION-related substvars.
+ Thanks to Paul Gevers <elbrus@debian.org>. (Closes: debputy#53)
+
+ [ Paul Gevers ]
+ * MANIFEST-FORMAT.md: Multiple improvements to the wording and
+ correction of several examples.
+ * README.md: remove double 'better support'
+ * d/control: same as previous README fix
+
+ [ Niels Thykier ]
+ * GETTING-STARTED-WITH-dh-debputy.md: Correct example
+ * Makefile: Correct name of dh_debputy.1 manpage
+ * debputy: Provide better error messages for invalid YAML.
+ Thanks to Paul Gevers <elbrus@debian.org> (Closes: debputy#47)
+ * debputy: Fix crash on relative symlinks when compressing files.
+ Thanks to Paul Gevers <elbrus@debian.org> (Closes: debputy#50)
+
+ -- Niels Thykier <niels@thykier.net> Fri, 20 Oct 2023 18:12:52 +0200
+
+debputy (0.1.7.4) unstable; urgency=medium
+
+ [ Andres Salomon ]
+ * Fix typo in GETTING-STARTED-WITH-dh-debputy.md
+
+ [ Niels Thykier ]
+ * debputy: Insert explicit shebang line + `set -e` (Closes: debputy#46)
+ * Makefile: Provide and install a manpage for dh_debputy
+ * debputy: Use `dpkg-parsechangelog` to determine version during self-hosted
+ clean chroot builds.
+
+ -- Niels Thykier <niels@thykier.net> Sun, 15 Oct 2023 15:59:28 +0200
+
+debputy (0.1.7.3) unstable; urgency=medium
+
+ * Correct copy-paste mistake in a warning
+ * migrate-from-dh: Avoid internal error with d/package.foo being a directory
+ * Support `open` on symlink for `FSROOverlay` as OS can resolve the symlink.
+
+ -- Niels Thykier <niels@thykier.net> Tue, 10 Oct 2023 19:59:18 +0200
+
+debputy (0.1.7.2) unstable; urgency=medium
+
+ * Changes related to `migrate-from-dh`:
+ - Merge multiple d/install lines when no dest-dir is provided
+ - Group d/manpages lines by language
+ * debputy: Fix internal error triggered while building src:remind.
+ Thanks to Jochen Sprickerhof <jspricke@debian.org>
+ * debputy: Include document references in some parse errors (when available)
+
+ -- Niels Thykier <niels@thykier.net> Mon, 09 Oct 2023 18:24:49 +0200
+
+debputy (0.1.7.1) unstable; urgency=medium
+
+ * migrate-from-dh: Correct some messages to provide the proper path name
+ * debputy: Fix internal error caused by some manifest errors
+
+ -- Niels Thykier <niels@thykier.net> Sun, 08 Oct 2023 18:10:47 +0200
+
+debputy (0.1.7) unstable; urgency=low
+
+ * Upload to unstable.
+
+ * Manifest changes:
+ - Breaking change: `path-metadata` rules never match symlinks.
+ Previously, you could match symlinks when ownership information
+ was changed. However, there is no known case in Debian where this
+ feature would be useful. To keep the logic and documentation simple,
+ symlinks are now no longer matched.
+
+ * Plugin API changes:
+ - Breaking change: Rewrite the API declaring packager provided files to
+ use a full path format rather than dir + basename.
+ - Breaking change: The directory `/usr/share/debputy/debputy/plugins` is
+ now the official plugin directory. Previously, it was not explicitly
+ defined (but ended up being `/usr/share/dh-debputy/plugins`).
+ - It is now possible declare packager provided files in the plugin json
+ file (that is, without needing any python code at all).
+
+ * Changes related to `migrate-from-dh`:
+ - Remove the `systemd` dh addon from the list of supported add-on. The
+ addon implies compat 10 and `debputy` assumes compat 11 at least.
+ Users are better off migrating to compat 11 and then to `debputy`.
+ - When generating an updated manifest, the migration will now verify
+ that the generated manifest can be parsed. If not, `debputy` will
+ raise an internal error promoting the user to file a bug.
+
+ * Parse plugin json via the declarative parser
+ * debputy: Avoid stacktrace if run outside package root
+ * debputy: Support running some subcommands outside of source roots
+ * IMPLEMENTATION-DECISIONS.md: Document some decisions behind plugin integration
+ * debputy: Package builds and `check-manifest` now only loads explicitly
+ requested plugins to ensure deterministic behaviour. Other commands (notably
+ the `plugin`) still loads all plugins that `debputy` can find. Plugins are
+ "explicitly requested" when the package has a `Build-Depends` on
+ `debputy-plugin-X` where `X` is the name of the plugin.
+ * MIGRATING-A-DH-PLUGIN.md: Advice against providing Python-based plugins for
+ now as the logistics are not fully prepared.
+ * debputy: Pipe to pager for some subcommands (such as
+ `debputy plugin list ppf`), if `DEBPUTY_PAGER` or `PAGER` is set, or if `less`
+ is available in `PATH`. The `LESS` variable is set to `-FRSXMQ` if not set.
+ * debputy: Show where the plugin is installed when listing plugins
+ (`debputy plugin list`)
+ * debputy: Provide more details in `debputy plugin list ppf`
+ * debputy: Restore ability to build packages with non-root static ownership.
+ There was a regression in a recent release that made `debputy` not realize
+ it would need to account for `(fake)root`.
+ * debputy: Provide better error message when plugin JSON is invalid.
+ Previously, you would just get a stack trace.
+ * Support sub-second mtime in the intermediate manifest
+ * debputy: Preserve `mtime` for compressed files like `gzip` does.
+ * debputy: Reduce the number of `stat`s when performing installations.
+ * debputy: Align changelog trimming closer with `debhelper` to minimize any
+ diffs between a `debhelper` produced deb and a `debputy` produced deb.
+ * debputy: Fix a cache retention issue that caused `Installed-Size` to be
+ wrong some cases.
+
+ -- Niels Thykier <niels@thykier.net> Sun, 08 Oct 2023 13:38:22 +0200
+
+debputy (0.1.6) experimental; urgency=medium
+
+ * Manifest changes:
+ - Breaking change: Replace `exclude` with `discard` and remove inline
+ `exclude` rule
+ - Breaking change: Rename `exclude` (transformation) to `remove`
+ - Breaking change: Symlink creation is now a transformation rule
+ - Breaking change: Empty directory creation is now a transformation rule
+ - Permit str/list forms of current install rules
+ - Support `install-man` rule similar to `dh_installman`. Note that
+ `install-man` does *not* automatically fallback to guessing the
+ language from the basename like `dh_installman`. The feature is
+ supported but requires explicit opt-in.
+
+ * Changes related to `migrate-from-dh`:
+ - Fix invalid error message on `${env:FOO}` variables
+ - The migration tool is now more clear on "unsupported" vs. "supported but
+ there is no automatic migration feature". The former will require an
+ explicit "I know and I am ignoring it" parameter, whereas the latter
+ gets a "manual migration" warning.
+ - Automatic migration from `d/manpages` to the new `install-man` rule. Be
+ sure to double-check the `language` attribute (of lack thereof). You may
+ need to add `language: derive-from-basename` in some cases.
+ - Automatic migration to translate `debian/not-installed` into `discard`
+ rules.
+ - The migration tool now detects unsupported dh sequence add-ons used.
+ - The migration tool now detects missing `dh-sequence-debputy` (or the `-zz-`
+ variant) in the Builds-Depends and provides you with a warning.
+
+ * Plugin API changes:
+ - `VirtualPath` now has a new `open` method.
+
+ * d/changelog: Correct a `Closes` to specific it was a gitlab issue
+ * IMPLEMENTATION-DECISIONS.md: New file that document some implementation
+ decisions in a new document.
+ * MANIFEST-FORMAT.md: Tweak some wording and remove an invalid exclude example
+ * MANIFEST-FORMAT.md: Clarify that conditions may partially evaluate rules
+ * Parse transformation rules via declarative parsers. Same behaviour, just
+ with better error messages.
+ * Set `DPKG_NLS=0` when calling `dpkg-architecture`
+ * FSPath: Support tracking ownership and rewrite mode tracking
+ * Remove internal `show-manifest-rules` command
+ * Avoid crash if two ELF binaries have the same build-id
+ * Support running `dwz` for ELF binaries
+ * GETTING-STARTED-WITH-dh-debputy.md: Improve migration section
+ * Correct python public directory detection. Previously, if the debug
+ version of the directory was available, only that was checked for
+ python scripts. Now `debputy` checks both directories when they are
+ both present.
+ * Remove shlibs + symbols migration code it is no longer necessary.
+ * migration: Fix `min` that should have been `max` causing it to use the
+ min dh-compat level rather than the max compat level required by
+ migrations.
+ * migrate-from-dh: Detect unsupported dh-addons and missing debputy B-D
+ * debputy: Clarify that `plugin list --help` will list topics
+ * Remove support for `menutest` and `isinstallable` scripts for now.
+ There is no support for the deb maintscripts. It seems weird to have
+ support for the udeb ones.
+ * Generate the control root in a tempdir to reset state between runs.
+ * shlibs.py: Fix crash when no `shlibs` and `symbols` files were provided
+ * Generate temp names with `__` separating the original basename for making
+ the original basename a little easier to spot.
+ * Fix bug where perl shebang lines were always rewritten
+ * debputy: Provide better contextual error messages
+ * Default most scripts with shebang lines to 755 if no other rule matches it.
+ This applies to any file having /usr/bin, /usr/sbin, /bin, or /sbin
+ in its #!-line, where a more specific rule does not apply.
+ (Closes: debputy#36)
+
+ -- Niels Thykier <niels@thykier.net> Sun, 01 Oct 2023 22:21:03 +0200
+
+debputy (0.1.5) experimental; urgency=medium
+
+ * New migration features:
+ - Lower the min dh compat to 11 for the simplest cases. Some cases
+ will require higher compat levels (notably, any arch:any packages bumps
+ the minimum to compat 12).
+
+ * debputy: Breaking change: Detect missing installation rules for `debian/tmp`
+ similar to `dh_missing`. The `debputy` detects completely directories as
+ possible integration points and provides a bit of context to what kind of
+ path entry the missing file system object is. The new install-time `exclude`
+ rule can be used to deliberately ignore uninteresting path objects that is
+ this feature detects.
+
+ * Manifest changes:
+ - Breaking change: Make `all-of` and `any-of` consistent (case-wise) with
+ other conditions.
+ - The `into` key on installation rules are now optional for single binary
+ packages.
+ - Fix bug where `dest-dir`, `as` and `when` was ignored for `install` (etc.)
+ - Support symbolic mode for mode attributes in additional to octal modes.
+ - Support `exclude` as an install rule (under `installations`) as an
+ experimental feature.
+ - Support `exclude` as an inline attribute in some `install` rules.
+
+ * Fix error in built-in permission normalization rule that broke directory modes
+ in some cases.
+ * Support main-doc package in install rules and apply_compression
+ * Remove support for debian/udev as it involves `/lib` and `debputy` should not
+ be involved in the `/usr-merge` transition.
+ * util.py: Fix bug in detect_fakeroot that would neuter the check
+ * util.py: Implement an xargs-like interface
+ * highlevel_manifest_parser.py: Prettify the definition reference
+ * highlevel_manifest_parser.py: Detect typos if python3-levenshtein is installed
+ * Remove debug symbols from static libraries (Closes: debputy#32)
+ * Remove remaining code for supporting "install"- and "mtree"-like formats.
+ * Provide a new declarative parser and migrate installation rules to use it.
+ * Replace internal attribute path tracking strings with the new AttributePath
+ class.
+ * Improve handling of installation rules that are disabled by conditionals.
+ * Ensure binNMU changelogs are split out of the main changelog
+ (Closes: debputy#34)
+ * Use declarative parser as a subparser for more parts of the manifest
+ * MANIFEST-FORMAT.md: Installations is now its own top level section
+ * Generate `${t64:Provides}` for the t64 migration (Closes: debputy#37)
+ * Fix invalid root dir for multi-binary packages
+ * MANIFEST-FORMAT.md: Write a conflict rule to apply to `installations` too.
+ * Avoid assertion error when `owning-package` was used without
+ `prior-to-version`.
+ * Support bash-completion via python3-argcomplete. For now, this must be
+ activated manually via `eval "$(register-python-argcomplete debputy)"`. It is
+ a bit slow due to start up times not being optimized for this case.
+ * Breaking change: Rewrite command line handling to remove special case options
+ (such as `-p`) from the root level. On the other hand, the new logic supports
+ providing default options on all subparsers, enabling default options such as
+ `--debug` to appear in all subparsers.
+ * Make symbols + shlibs "discoverable" by pretending they are packager provided
+ files. Reuse the detection logic from provider provided files rather than
+ "hand-rolling" a similar logic.
+
+ -- Niels Thykier <niels@thykier.net> Tue, 12 Sep 2023 20:43:15 +0200
+
+debputy (0.1.4) experimental; urgency=medium
+
+ * debputy.pm: Breaking change: The debputy dh sequence now removes the
+ following debhelper tools from the sequence:
+
+ - dh_installdirs
+ - dh_install
+ - dh_installdocs
+ - dh_installchangelogs
+ - dh_installexamples
+ - dh_installman
+ - dh_installcatalogs (!)
+ - dh_installdebconf (!)
+ - dh_installemacsen (!)
+ - dh_installinfo
+ - dh_installinit (!)
+ - dh_installsysusers
+ - dh_installsystemd (!)
+ - dh_installsystemduser (!)
+ - dh_installmenu (!)
+ - dh_ucf (!)
+ - dh_perl
+ - dh_usrlocal (!)
+ - dh_installwm (!)
+ - dh_strip_nondeterminism (!)
+ - dh_dwz (!)
+ - dh_strip
+ - dh_missing (!)
+
+ At this point, basically any command *after* dh_auto_install (plus
+ dh_installdirs, which runs before dh_auto_install) has been removed.
+ As a consequence, the `debputy.pm` sequence no longer interacts very
+ well with most debhelper sequence addons. Basically any command
+ relying on content in `debian/<pkg>` will no longer work with
+ `dh-debputy`.
+
+ Commands marked with (!) has no or almost no replacement support.
+ If a package rely on these commands, odds are debputy will be
+ unlikely to support that package. Other commands will have
+ support for common cases (similar to debhelper's default behavior).
+
+ * debputy.py: Breaking change: Remove support for services, debhelper
+ provided maintscripts and triggers.
+
+ * New migration features:
+ - Auto-migrate `debian/tmpfile` to `debian/tmpfiles`
+ - Auto-migrate `debian/README.debian` to `debian/README.Debian`.
+ (debhelper allowed both, debputy only supports the latter, which
+ is the more common variant).
+ - Auto-migrate `debian/doc-base.<suffix>` to
+ `debian/<pkg>.<suffix>.doc-base`. Note that debhelper and debputy
+ are not aligned on the naming scheme here. Applying this migration
+ causes debhelper to no longer see the doc-base files.
+ - Auto-migrate common `debian/install`, `debian/docs` and
+ `debian/examples` into the `installations` feature (see
+ "manifest changes" below). Some (but not 100%) dh-exec support
+ provided as well.
+ - Detect `debian/<foo>` files for unsupported debhelper tools or
+ where no migration has been written yet and warn about their usage
+ affecting the migration.
+ - Migration now works with debhelper compat 13 rather than compat 14
+ in most cases. Notable exception being packages that have a
+ `debian/pam`, which will still trigger a min compat of 14.
+
+ * manifest changes:
+ - Implement `installations` to replace `dh_install`, `dh_installdocs`
+ and `dh_installexamples`. Please see the `Installations` section
+ in `MANIFEST-FORMAT.md` for how to use it. Note that `debputy`
+ installations work differently than debhelper when multiple
+ patterns match the same path.
+
+ * debputy plugin API: Important changes:
+ - Detached paths are now less volatile. Notably, the `path`
+ attribute will now always work for plugins. The `parent_dir`
+ attribute should still be avoided however. Additionally, the
+ `.lookup` method will now always trigger an exception for a
+ detached path (previously, it would "sometimes" trigger the
+ exception depending on the path being resolved).
+ - Plugins can now choose whether a Packager Provided File (PPF)
+ should have name segments or have architecture specific
+ segments. Additionally, the plugin can request that
+ `debian/foo` is considered a fallback for all packages for
+ a given file.
+ - The `BinaryPackagePath` type has been renamed to
+ `VirtualPath`.
+
+ * Improve wording in documentation and fix typos various places.
+ * Remove `> /dev/null` for `systemd-tmpfiles`.
+ * Add support for systemd's sysusers file.
+ * Provide standard excludes for commonly unwanted things
+ * Support pruning changelog files. When pruning NEWS, keep only entries listed
+ in the Debian changelog.
+ * Ensure man, info pages, changelog files and Debian.NEWS files are always
+ compressed. Previously, these would only be compressed if they had a
+ certain size. This change makes `debputy` match `dh_compress` better.
+ * migration: Renames count as successful changes. Previously, the migration
+ tool would say it could do renames and then claim nothing could be done
+ followed by not doing anything at the end.
+ * Fix bug where mode was used as mtime for symlinks.
+ * manifest/parser: Recognise -dbgsym packages. The package names
+ are now known and will not trigger an "unknown" package
+ exception when used. However, currently no directives are allowed
+ for dbgsym packages so the net result of specifying them is still
+ an error.
+ * Migrate to the python logging. Along with a dependency on colorlogs,
+ this means that output will have some color support. This changes means
+ more "info" level messages now have basic colors.
+ * util.py: Fix double quote handling when doing shell escapes.
+ * debputy.py: Improve error reporting a bit. Notably, previously
+ some exceptions that should have been caught and rendered in a
+ user-friendly way now are as intended. Additionally, the debputy
+ frontend now catches a common cause of exceptions (`RuntimeError`)
+ and classifies them as "Unexpected exceptions" along with a note
+ recommending filing a bug for debputy.
+ * debputy.py: Hide unstable/internal commands. Most of the frontend
+ commands are now hidden behind an `internal-command` subcommand.
+ this means that the default help output now only uses 1-2 lines on
+ the internal or unstable subcommands.
+ * debputy.py: Provide a `check-manifest` command to parse the manifest
+ and check for obvious errors without having to build debs.
+ * Do not mandate dpkg archs to be known. Previously, debputy
+ would trigger an error if the manifest in the `arch-matches`
+ condition listed an unknown dpkg arch. This error has been
+ removed as it is common practice to list new architectures
+ long before dpkg in stable/oldstable knows the architecture.
+ * Tweak the auto-generated maintscripts. Notably, indentation
+ is now two spaces and applied better to avoid weird hanging
+ lines. Additionally, the first line of a snippet is no longer
+ accidentally merged into the condition line, which could
+ cause syntax errors if the fixed line did not have
+ indentation.
+ * Detect and register python byte compilation for public
+ dist-packages dirs and default "package private" dirs
+ similar to `dh_python3`. This is done because `debputy`
+ cannot rely on `dh_python3` when it is self-hosting.
+ Other `dh_python3` are not ported.
+ * Move all of dh-debputy's files from `usr/share/debputy`
+ to `usr/share/dh-debputy`. In tandem with the previous
+ change, this causes debputy now to properly integrate with
+ the python byte compilation system.
+ * Correct the "inner" snippet order of generated maintscripts.
+ All postrm and prerm snippets are supposed in reverse order
+ and previously some snippets were not reordered correctly.
+ * migrate-from-dh: Reduce the output to make warnings less likely
+ to drown in other output.
+ * migrate-from-dh: Better error reporting on failed executable
+ dh config emulation.
+ * migrate-from-dh: Require an explicit --apply-changes for
+ migrations to performed.
+
+ -- Niels Thykier <niels@thykier.net> Thu, 24 Aug 2023 19:14:48 +0200
+
+debputy (0.1.3) experimental; urgency=medium
+
+ * debputy.pm: Breaking change: The debputy dh sequence now removes the
+ following debhelper tools from the sequence:
+ - dh_lintian
+ - dh_bugfiles
+ - dh_compress (note: hardlinks are not supported correctly)
+ * Create a basic plugin API infrastructure and move some of the
+ debputy into a plugin. Plugins can currently register packager
+ provided files (`d/pkg.foo -> usr/.../pkg[.conf]`) and detection
+ (and generation) of maintscript snippets, substvars and triggers.
+ However, plugins cannot alter the contents of the data.tar.
+ Additionally, the plugins are not loaded deterministically during
+ builds (unclean chroot can load too many plugins), so they are not
+ ready for prime time yet.
+ * Fixed a bug in debputy's handling of icon-cache generation
+ (dh_icons).
+ * Detect kernel modules under /usr in addition to /lib.
+ * debputy.py: When migrating from dh, detect use of `=>` in
+ debhelper config files and report it as unsupported. The migrator
+ would not generate the correct code for these lines. Currently,
+ none of the debhelper tools where you can use `=>` would be migrated,
+ so this is just future proofing.
+ * debputy.py: Provide a `plugin` subcommand to interact with the
+ plugins. Currently, it can only list plugins and a bit of the
+ content they provide.
+ * all frontends: Show colorized error and warning messages similar to
+ debhelper.
+ * all frontends: Provide a `--version` that prints the version of
+ debputy.
+ * debputy.py: Detect `/usr/local` paths and abort as they are unhandled.
+ Note that `dh_usrlocal` would normally be run and clean up these
+ directories, so this is only an issue if you bypass `dh_usrlocal` or
+ ask debputy to create content in `/usr/local`.
+
+ -- Niels Thykier <niels@thykier.net> Sun, 23 Jul 2023 07:52:46 +0000
+
+debputy (0.1.2) experimental; urgency=medium
+
+ * debputy.pm: Breaking change: The debputy dh sequence now removes the
+ following debhelper tools from the sequence:
+ - dh_installudev
+ - dh_installgsettings
+ - dh_makeshlibs
+ * debputy.py: Breaking change: The manifest use `{{X}}` rather than
+ `${X}` for substitution and remove support for environment variables
+ in substitutions.
+ * deb_packer.py: Support most of the dpkg-deb environment variables for
+ compress settings (etc.). Only known omission is thread count, which
+ despite having a `--threads-max` option, `deb_packer.py` ignores the
+ value in the name of compatibility.
+ * deb_packer.py: Reset the `mtime` of control.tar members according
+ to the SOURCE_DATE_EPOCH rules (clamping). Previously, the `mtime`
+ was unconditionally reset. Most control.tar members are
+ generated at runtime, so it only mattered when the control file
+ is not generated.
+ * deb_materialization.py: New internal command for materializing the
+ data.tar part of the deb before assembly (or debugging). The
+ command can also be used to assembling the materialized deb by
+ using dpkg-deb or deb_packer.py (referred to as `debputy`).
+ * debputy.py: Default to using `deb_materialization.py` to
+ materialize the package and then assemble it with dpkg-deb where
+ possible. However, automatically fallback to the internal assembly
+ method when (fake)root is required and `Rules-Requires-Root` is
+ `no`.
+ * debputy.py: When using the `migrate-from-dh` subcommand, use
+ `dh_assistant` to detect override targets that might cause issues
+ with the migration.
+ * debputy.py: Rename `show-manifest-changes` to `show-manifest-rules`
+ and `--show-implicit-changes` to `--show-implicit-rules`.
+ * builtin_manifest_rules.py: Correct permission for two bugreport
+ builtin rules when matching a directory. Previously, the
+ directories would keep their file system mode. Now they are
+ correctly normalized to 0755 as other directories would have been.
+ * manifest_conditions.py: Fix a bug where the description of build
+ profile conditionals where rendered poorly.
+ * packages.py: Prevent assertion error when user provides a typo'ed
+ package name for `-p`.
+
+ -- Niels Thykier <niels@thykier.net> Sun, 18 Jun 2023 14:30:41 +0000
+
+debputy (0.1.1) experimental; urgency=medium
+
+ * Initial release. (Closes: #1029645)
+
+ -- Niels Thykier <niels@thykier.net> Sun, 05 Feb 2023 18:27:25 +0000
diff --git a/debian/control b/debian/control
new file mode 100644
index 0000000..b393718
--- /dev/null
+++ b/debian/control
@@ -0,0 +1,62 @@
+Source: debputy
+Section: devel
+Priority: optional
+Maintainer: Debputy Maintainers <debputy@packages.debian.org>
+Uploaders: Niels Thykier <niels@thykier.net>,
+Build-Depends: debhelper-compat (= 13),
+# man-db <pkg.debputy.ci>,
+ hunspell-en-us <!nocheck>,
+ python3:any,
+ python3-colorlog <!pkg.debputy.minimal>,
+ python3-colored <!pkg.debputy.minimal>,
+ python3-debian,
+ python3-hunspell <!nocheck>,
+ python3-pytest <!nocheck>,
+ python3-lsprotocol <!nocheck>,
+ python3-ruamel.yaml,
+ dh-sequence-single-binary,
+# debputy-plugin-foo,
+ strip-nondeterminism <!nocheck>,
+Rules-Requires-Root: no
+Standards-Version: 4.6.2
+Homepage: https://salsa.debian.org/debian/debputy
+Vcs-Git: https://salsa.debian.org/debian/debputy.git
+Vcs-Browser: https://salsa.debian.org/debian/debputy
+
+Package: dh-debputy
+Architecture: all
+Depends: debhelper,
+ man-db <!pkg.debputy.minimal>,
+ python3,
+# The colors dependencies are not necessary for debputy to work.
+# However, to have coloring work, we need to use Depends because
+# Recommends/Suggests are not resolved for builds and this should
+# "just work" for users.
+ python3-colorlog <!pkg.debputy.no-color>,
+ python3-colored <!pkg.debputy.no-color>,
+ python3-debian,
+ python3-ruamel.yaml,
+ strip-nondeterminism,
+Recommends: python3-argcomplete,
+Suggests: hunspell-en-us,
+ python3-pygls,
+ python3-lsprotocol,
+ python3-hunspell,
+Provides: dh-sequence-debputy (= ${binary:Version}),
+ dh-sequence-installdebputy (= ${binary:Version}),
+ dh-sequence-zz-debputy (= ${binary:Version}),
+ dh-sequence-zz-debputy-rrr (= ${binary:Version}),
+ debputy-plugin-gnome,
+ debputy-plugin-numpy3,
+ debputy-plugin-perl-openssl,
+Multi-Arch: foreign
+Description: Manifest style Debian-based package builder (debhelper integration)
+ Package builder that provides a declarative manifest for building Debian-based
+ packages.
+ .
+ This version integrates with the debhelper sequencer dh and will replace
+ several of debhelper's tools that are covered by debputy.
+ .
+ The debputy package builder aims to reduce cognitive load for the packager
+ and provide better introspection to packagers, linters and the Debian
+ janitor.
diff --git a/debian/copyright b/debian/copyright
new file mode 100644
index 0000000..7523343
--- /dev/null
+++ b/debian/copyright
@@ -0,0 +1,49 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+
+Files: *
+Copyright: 2022 Niels Thykier <niels@thykier.net>
+License: GPL-2+
+
+Files: deb_packer.py
+Copyright: 2022 Niels Thykier <niels@thykier.net>
+ 2022 Chris Hofstaedtler <zeha@debian.org>
+License: GPL-2+
+
+Files: src/debputy/lsp/text_edit.py
+Copyright: Copyright 2017-2020 Palantir Technologies, Inc.
+ Copyright 2021- Python Language Server Contributors.
+License: Expat
+ Permission is hereby granted, free of charge, to any person obtaining
+ a copy of this software and associated documentation files (the "Software"),
+ to deal in the Software without restriction, including without limitation the
+ rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+ sell copies of the Software, and to permit persons to whom the Software is
+ furnished to do so, subject to the following conditions:
+ .
+ The above copyright notice and this permission notice shall be included in all
+ copies or substantial portions of the Software.
+ .
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED,
+ INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+ PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+ HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
+ CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE
+ OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+Files: tests/*
+Copyright: 2022 Niels Thykier <niels@thykier.net>
+ 2022 Chris Hofstaedtler <zeha@debian.org>
+License: GPL-2+
+
+Files: dh_debputy
+Copyright: 1997-2011 Joey Hess <joeyh@debian.org>
+ 2015-2022 Niels Thykier <niels@thykier.net>
+Comment: It is 95% copy-paste of dh_builddeb
+License: GPL-2+
+
+Files: src/debputy/lsp/vendoring/_deb822_repro/*
+Copyright:
+ 2021 Niels Thykier <niels@thykier.net>
+License: GPL-2+
+Comment: Embedded copy of part of `python-debian` with patches. The patches are pending
+ review at https://salsa.debian.org/python-debian-team/python-debian/-/merge_requests/130
diff --git a/debian/debputy.manifest b/debian/debputy.manifest
new file mode 100644
index 0000000..2f04a6f
--- /dev/null
+++ b/debian/debputy.manifest
@@ -0,0 +1,7 @@
+manifest-version: '0.1'
+installations:
+- install-docs:
+ sources:
+ - GETTING-STARTED-WITH-dh-debputy.md
+ - MANIFEST-FORMAT.md
+ - MIGRATING-A-DH-PLUGIN.md
diff --git a/debian/gbp.conf b/debian/gbp.conf
new file mode 100644
index 0000000..703e45f
--- /dev/null
+++ b/debian/gbp.conf
@@ -0,0 +1,6 @@
+[DEFAULT]
+debian-branch = main
+
+[dch]
+multimaint-merge = true
+ignore-regex = (Signed-off|Acked|Tested|Reviewed)-by:|Fix-For:|Fixes:
diff --git a/debian/rules b/debian/rules
new file mode 100755
index 0000000..1221eb2
--- /dev/null
+++ b/debian/rules
@@ -0,0 +1,11 @@
+#!/usr/bin/make -f
+
+export PERL5LIB=$(CURDIR)/lib
+export PATH:=$(CURDIR):$(PATH)
+export DEBPUTY_CMD=$(CURDIR)/debputy.sh
+
+%:
+ dh $@ --with debputy
+
+override_dh_debputy:
+ dh_debputy --plugin self-hosting-plugins/debputy-self-hosting.json
diff --git a/debian/source/format b/debian/source/format
new file mode 100644
index 0000000..89ae9db
--- /dev/null
+++ b/debian/source/format
@@ -0,0 +1 @@
+3.0 (native)
diff --git a/debian/tests/control b/debian/tests/control
new file mode 100644
index 0000000..642bb5c
--- /dev/null
+++ b/debian/tests/control
@@ -0,0 +1,19 @@
+Tests: debputy-py.test
+Restrictions: allow-stderr
+Depends:
+ @,
+ python3-pytest,
+ python3-lsprotocol,
+ python3-all,
+# debputy loads the library directly for one of the tests.
+ libcap2,
+
+Tests: debputy-cli
+Restrictions: allow-stderr, superficial
+Depends: @
+
+Tests: debputy-cli-lint-lsp
+Restrictions: allow-stderr, superficial
+Depends:
+ @,
+ python3-lsprotocol,
diff --git a/debian/tests/debputy-cli b/debian/tests/debputy-cli
new file mode 100755
index 0000000..cf52f7d
--- /dev/null
+++ b/debian/tests/debputy-cli
@@ -0,0 +1,49 @@
+#!/bin/sh
+set -e -u -x
+
+debputy --no-pager --help
+debputy --no-pager check-manifest
+
+debputy --no-pager plugin --help
+debputy --no-pager plugin list --help
+
+debputy --no-pager plugin list
+debputy --no-pager plugin list plugins
+debputy --no-pager plugin list ppf
+debputy --no-pager plugin list uppf
+debputy --no-pager plugin list manifest-variables
+debputy --no-pager plugin list manifest-variables --show-all-variables
+debputy --no-pager plugin list pmr
+debputy --no-pager plugin list automatic-discard-rules
+debputy --no-pager plugin list a-d-r
+
+
+debputy --no-pager plugin show ppf changelog
+debputy --no-pager plugin show ppf debian/changelog
+debputy --no-pager plugin show ppf service
+
+debputy --no-pager plugin show pmr --help
+
+echo "Checking installations manifest rules"
+for rule in install install-docs install-man discard ; do
+ debputy --no-pager plugin show pmr "${rule}"
+done
+
+echo "Checking binary package transformations manifest rules"
+for rule in TransformationRule::remove move create-symlink path-metadata create-directories \
+ run-build-time-tests arch-matches not build-profiles-matches cross-compiling \
+ binary-version definitions variables ::definitions definitions::variables ::; do
+ debputy --no-pager plugin show pmr "${rule}"
+done
+
+for variable in DEB_SOURCE token:TAB DEB_HOST_ARCH DEB_BUILD_ARCH; do
+ debputy --no-pager plugin show manifest-variables "${variable}"
+done
+
+for rule in python-cache-files la-files backup-files version-control-paths gnu-info-dir-file debian-dir doxygen-cruft-files; do
+ debputy --no-pager plugin show automatic-discard-rules "${rule}"
+done
+
+debputy --no-pager tool-support annotate-debian-directory
+debputy --no-pager tool-support export-reference-data --output-format=json
+debputy --no-pager tool-support export-reference-data file-categories
diff --git a/debian/tests/debputy-cli-lint-lsp b/debian/tests/debputy-cli-lint-lsp
new file mode 100755
index 0000000..c808abe
--- /dev/null
+++ b/debian/tests/debputy-cli-lint-lsp
@@ -0,0 +1,6 @@
+#!/bin/sh
+set -e -u -x
+
+debputy lint --no-linter-exit-code
+debputy lsp editor-config emacs
+debputy lsp editor-config vim
diff --git a/debian/tests/debputy-py.test b/debian/tests/debputy-py.test
new file mode 100755
index 0000000..640e84b
--- /dev/null
+++ b/debian/tests/debputy-py.test
@@ -0,0 +1,33 @@
+#!/bin/sh
+set -e -u -x
+mkdir "${AUTOPKGTEST_TMP}/debian"
+cp -r pyproject.toml tests/ "${AUTOPKGTEST_TMP}"
+cp -a debian/control "${AUTOPKGTEST_TMP}/debian"
+export PYTHONWARNINGS=d
+# This is a lie, but the debputy test framework will restrict certain
+# plugin loading methods otherwise and that will neuter our ability to
+# test the plugin test framework itself. To avoid issues, we do the
+# dance below to ensure that py.test will not see the source version
+# of debputy (and accordingly cannot use the uninstalled version by
+# mistake).
+export DEBPUTY_TEST_AGAINST_INSTALLED_PLUGINS=uninstalled
+DEBPUTY_PYTHONPATH=/usr/share/dh-debputy
+PYTHOHPATH=${PYTHOHPATH:-}
+if [ "${PYTHOHPATH:-}" ]; then
+ PYTHOHPATH="${DEBPUTY_PYTHONPATH}:${PYTHOHPATH}"
+else
+ PYTHOHPATH="${DEBPUTY_PYTHONPATH}"
+fi
+
+export DEBPUTY_REQUIRE_LIBCAP=1
+
+cd "${AUTOPKGTEST_TMP}/"
+
+for py in $(py3versions -s); do
+ echo "----------------------------------------------"
+ echo "Testing with $py"
+ echo "----------------------------------------------"
+ # text mode file opening is locale dependent so try both ASCII and UTF-8
+ PYTHONPATH="${PYTHOHPATH}" LC_ALL=C $py -m pytest
+ PYTHONPATH="${PYTHOHPATH}" LC_ALL=C.UTF-8 $py -m pytest
+done