summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJulian Andres Klode <julian.klode@canonical.com>2021-04-23 10:36:18 +0200
committerJulian Andres Klode <julian.klode@canonical.com>2021-04-23 12:26:46 +0200
commitdc11a4422d99cb49817c827b9f827617b5880600 (patch)
treed0aace43cbc022e674e6101bb7262b53a4924244 /doc
parentde86a4b076a37db2f70ee5fbfbb295cc71c344df (diff)
json: Add `package-list` and `statistics` install hooks
This enables hooks to output additional information.
Diffstat (limited to 'doc')
-rw-r--r--doc/json-hooks-protocol.md8
1 files changed, 7 insertions, 1 deletions
diff --git a/doc/json-hooks-protocol.md b/doc/json-hooks-protocol.md
index 489b04843..3c7f6e4f2 100644
--- a/doc/json-hooks-protocol.md
+++ b/doc/json-hooks-protocol.md
@@ -57,7 +57,9 @@ method `org.debian.apt.hooks.bye`.
The following methods are supported:
-1. `org.debian.apt.hooks.install.pre-prompt` - Run before the y/n prompt
+1. `org.debian.apt.hooks.install.pre-prompt` - Run before the package list and y/n prompt
+1. `org.debian.apt.hooks.install.package-list` - (optional in 0.1) Run after the package list. You could display additional lists of packages here
+1. `org.debian.apt.hooks.install.statistics` - (optional in 0.1) Run after the package list. You could display additional lists of packages here
1. `org.debian.apt.hooks.install.post` - Run after success
1. `org.debian.apt.hooks.install.fail` - Run after failed install
1. `org.debian.apt.hooks.search.pre` - Run before search
@@ -93,6 +95,10 @@ install. Each package has the following attributes:
- *mode*: One of `install`, `deinstall`, `purge`, or `keep`. `keep`
is not exposed in 0.1. To determine an upgrade, check
that a current version is installed.
+- One of the following optional fields may be set to true to indicate a change relative to an installed version:
+ - *downgrade*: true if downgrading
+ - *upgrade*: true if upgrading
+ - *reinstall*: true if reinstall flag is set
- *automatic*: Whether the package is/will be automatically installed
- *versions*: An array with up to 3 fields: