Add zsh completion
authorFelipe Sateler <fsateler@debian.org>
Wed, 30 Oct 2013 20:25:22 +0000 (17:25 -0300)
committerGuido Günther <agx@sigxcpu.org>
Thu, 31 Oct 2013 18:33:27 +0000 (19:33 +0100)
Closes; #717002

debian/git-buildpackage.zsh-completion [new file with mode: 0644]
debian/rules

diff --git a/debian/git-buildpackage.zsh-completion b/debian/git-buildpackage.zsh-completion
new file mode 100644 (file)
index 0000000..3ff1e7e
--- /dev/null
@@ -0,0 +1,488 @@
+#compdef gbp
+#description build debian packages from a git repository
+
+__gbp_common_options() {
+       local prefix="$1"
+       # these can't be prefixed
+       _arguments '--help[Show help]' \
+               '--version[Show version information]'
+
+       _arguments "--${prefix}verbose[Verbose execution]" \
+               "--${prefix}color=-[Use colored output]:color:(on auto off)"
+
+}
+
+__gbp_branch_options() {
+       local prefix="$1"
+       _arguments \
+               "--${prefix}debian-branch=-[The branch the Debian package is being developed on]" \
+               "--${prefix}upstream-branch=-[The branch the upstream  sources  are  put onto]" \
+               "--${prefix}pristine-tar[Track pristine tar branch]"
+}
+
+__gbp_tag_format_options() {
+       local prefix="$1"
+       _arguments \
+               "--${prefix}debian-tag=-[format string for debian tags]" \
+               "--${prefix}upstream-tag=-[format string for upstream tags]"
+}
+
+__gbp_tag_sign_options() {
+       local prefix="$1"
+       _arguments \
+               "(--${prefix}sign-tags --${prefix}no-sign-tags)--${prefix}sign-tags[GPG sign all generated tags]" \
+               "(--${prefix}sign-tags --${prefix}no-sign-tags)--${prefix}no-sign-tags[Do not GPG sign generated tags]" \
+               "--${prefix}keyid=-[GPG keyid to sign tags with]:GPG key:"
+}
+
+_gbp() {
+       local curcontext="$curcontext" state line
+       typeset -A opt_args
+       _arguments -C \
+               ':command:->command' \
+               '*::options:->options' \
+
+       case $state in
+       (command)
+               #breaks if defined outside the func
+               local -a subcommands
+               subcommands=(
+                       'buildpackage:Build a Debian package'
+                       'clone:Clone  a  Git  repository from a remote and set up the necessary branch tracking.'
+                       'create-remote-repo:Create a remote Git repository'
+                       'dch:Generate the debian/changelog from  Git commit history'
+                       'import-dsc:Import a single Debian source package'
+                       'import-dscs:Import multiple Debian source packages'
+                       'import-orig:Import a new upstream tarball'
+                       'pq:Manage debian/patches using Git rebase'
+                       'pull:Update a Git repository from a remote'
+               )
+
+               _describe -t commands gbp subcommands
+       ;;
+       (options)
+               local funcname
+               funcname=_gbp-$line[1]
+               if type $funcname | grep -q "shell function" ; then
+                       $funcname
+               fi
+       ;;
+       esac
+}
+
+_gbp-buildpackage() {
+       __gbp_common_options git-
+       __gbp_branch_options git-
+       __gbp_tag_format_options git-
+       __gbp_tag_sign_options git-
+       _arguments \
+         '--git-ignore-new[build with uncommited changes in the source tree]' \
+         '--git-no-ignore-new[negates --git-ignore-new]' \
+         '--git-tag[create a tag after a successful build]' \
+         '--git-tag-only[do not build, only tag and run the posttag hook]' \
+         '--git-retag[do not fail if the tag already exists]' \
+         '--git-force-create[force creation of orig.tar.gz]' \
+         '--git-no-create-orig[do not create orig.tar.gz]' \
+         '--git-tarball-dir=-[location to look for external tarballs]:tarball directory:_files -/' \
+         '--git-compression=-[compression type]:compression:(auto gzip bzip2 lzma xz)' \
+         '--git-compression-level=-[set compression level]:level:(1 2 3 4 5 6 7 8 9)' \
+         '--git-ignore-branch[build although debian-branch != current branch]' \
+         '--git-no-ignore-branch[negates --git-ignore-branch]' \
+         '--git-builder=-[command to build the Debian package]:command:' \
+         '--git-cleaner=-[command to clean the working copy]:command:' \
+         '--git-prebuild=-[command to run before a build]:command:' \
+         '--git-postbuild=-[hook run after a successful build]:command:' \
+         '--git-posttag=-[hook run after a successful tag operation]:command:' \
+         '--git-pbuilder[invoke git-pbuilder for building]' \
+         '--git-no-pbuilder[negates --git-pbuilder]' \
+         '--git-dist=-[build for this distribution when using git-pbuilder]:distribution:' \
+         '--git-arch=-[build for this architecture when using git-pbuilder]:architecture:' \
+         '--git-export-dir=-[before building the package export the source into this directory]:directory:_files -/' \
+         '--git-export=-[export treeish object instead of HEAD]:treeish:' \
+         '--git-dont-purge[retain exported package build directory]' \
+         '--git-overlay[extract orig tarball when using export-dir option]' \
+         '--git-no-overlay[negates --git-overlay]' \
+         '--git-notify=-[Send a desktop notification after build]:notify:(on auto off)' \
+         '*:Other options:_dpkg-buildpackage'
+}
+
+_gbp-clone() {
+       __gbp_common_options
+       __gbp_branch_options
+       _arguments \
+               '--all[Track all branches, not only debian and upstream]'
+}
+
+_gbp-create-remote-repo() {
+       __gbp_common_options
+       _arguments \
+               '--remote-url-pattern=-[Where to create remote repository]' \
+               '--remote-name=-[What  name  git  will use when refering to that repository]' \
+               '--template-dir=-[Template dir to pass to git init]' \
+               '--remote-config=-[Name of config file section to specify params]' \
+               '(--track --no-track)--track[Set up branch tracking]' \
+               '(--track --no-track)--no-track[Do not set up branch tracking]'
+
+}
+
+_gbp-dch () {
+       __gbp_common_options
+       __gbp_branch_options
+       __gbp_tag_format_options
+
+       _arguments \
+               '--git-ignore-branch[build although debian-branch != current branch]' \
+               '--since=-[Start point for reading commits]:commitish:' \
+               '--auto[Guess the last commit documented in the changelog]' \
+               '(--meta --no-meta)--meta[Parse meta tags]' \
+               '(--meta --no-meta)--no-meta[Do not parse meta tags]' \
+               '--meta-closes=-[What meta tags to look for  to  generate  bug-closing  changelog entries]' \
+               '(--full --no-full)--full[Include the full commit message]' \
+               '(--full --no-full)--no-full[Do not include the full commit message]' \
+               '(--snapshot -S)'{-S,--snapshot}'[Create a snapshot release entry]' \
+               '--snapshot-number=-[Python expression that gets eval()ed to the new snapshot number]' \
+               '(--release -R)'{-R,--release}'[Remove any snapshot release banners]' \
+               '(--new-version -N)'{-R,--release}'=[Specify changelog version]' \
+               '--team[Create a team upload entry]' \
+               '--bpo[Increment the release number for a backports upload]' \
+               '--nmu[Increment the release number for a NMU upload]' \
+               '--qa[Increment the release number for a QA upload]' \
+               '--distribution=-[Set the distribution field]' \
+               '--force-distribution[Force distribution]' \
+               '--urgency=-[Set the upload urgency]' \
+               '--git-log=-[Options passed to git log]' \
+               '--id-length=-[Number of commit id digits to include]' \
+               '--ignore-regex=-[Ignore matching commit lines]' \
+               '--git-author[Use git name configuration for changelog signature]' \
+               '(--multimaint-merge --no-multimaint-merge)--multimaint-merge[Merge commits by maintainer]' \
+               '(--multimaint-merge --no-multimaint-merge)--multimaint-merge[Do not merge commits by maintainer]' \
+               '--spawn-editor=[Spawn an editor]:when:(always snapshot release)' \
+               '--commit-msg=[Commit message format string]' \
+               '--commit[Commit the generated changelog]' \
+               '*:Paths:_files -/'
+}
+
+_gbp-import-dsc() {
+       __gbp_common_options
+       __gbp_branch_options
+       __gbp_tag_format_options
+       __gbp_tag_sign_options
+       _arguments \
+               '--filter=-[Filter out files]' \
+               '--download=-[Download the source package]' \
+               '--allow-unauthenticated[Skip signature verification on downloads]' \
+               '--allow-same-version[Import a package with the same debian version]' \
+               '--author-is-committer[Use the author identity as committer identity]' \
+               '--author-date-is-committer-date[Use author date as commit date]' \
+               '*:package:_files -g "*.dsc"'
+       # TODO: complete source package names
+       # TODO: pass only one tarball/source package name
+}
+
+_gbp-import-dscs() {
+       # same options
+       _gbp-import_dsc
+       _arguments \
+               '--debsnap[Fetch snapshots from snapshots.debian.org]' \
+               '--ignore-repo-config[Ignore options in gbp.conf]'
+       # TODO: multiple dscs or one source package name + debsnap
+}
+
+_gbp-import-orig() {
+       __gbp_common_options
+       __gbp_branch_options
+       __gbp_tag_format_options
+       __gbp_tag_sign_options
+       _arguments \
+               '(--upstream-version -u)'{--upstream-version,-u}'=[The upstream version number]' \
+               '--merge[Merge the upstream branch into the debian branch]' \
+               '--upstream-vcs-tag=-[Add a tag as an additional parent to the upstream tarball commit]' \
+               '--import-msg=-[Commit message format string]' \
+               '--filter=-[Filter out files]' \
+               '--filter-pristine-tar[When filtering also filter out of pristine-tar tarballs]' \
+               '(--symlink-orig --no-symlink-orig)--symlink-orig=[Create a symlink with a debian-compliant name]' \
+               '(--symlink-orig --no-symlink-orig)--no-symlink-orig=[Do not create a symlink with a debian-compliant name]' \
+               '--postimport=-[Run a command after import]' \
+               '--uscan[Use uscan to fetch the new upstream version]' \
+               '*:file:_files'
+
+       # TODO: pass only one tarball
+       # TODO: Do not complete files when uscan option is enabled
+}
+
+_gbp-pq() {
+       __gbp_common_options
+       _arguments \
+               '(--patch-numbers --no-patch-numbers)--patch-numbers[Add numbers to patch files]' \
+               '(--patch-numbers --no-patch-numbers)--no-patch-numbers[Do not add numbers to patch files]' \
+               '--topic=-[Topic to use when importing a single patch]' \
+               '--time-machine=-[Go back N commits trying to apply patch queue]'
+
+       local -a pqcommands
+       pqcommands=(
+               'import:Create   a   patch   queue   branch'
+               'export:Export the patches on the patch-queue branch'
+               'rebase:Rebase the  patch-queue  branch against the current branch'
+               'drop:Drop the patch queue'
+               'apply:Add  a  single patch to the patch-queue'
+               'switch:Switch to the patch-queue branch if on the base branch and viceversa'
+       )
+       # TODO: only display these commands once
+       _describe -t pqcommands gbp-pq pqcommands
+}
+
+_gbp-pull() {
+       __gbp_common_options
+       __gbp_branch_options
+       _arguments \
+               '--force[Update even non fast-forward]' \
+               '--redo-pq[Rebuild the patch queue]' \
+               '--ignore-branch[Dont care if on a detached state]' \
+               '--depth=-[Depth for deepening shallow clones]'
+}
+
+_gbp "$@"
+
+
+
+__gbp_common_options() {
+       local prefix="$1"
+       # these can't be prefixed
+       _arguments '--help[Show help]' \
+               '--version[Show version information]'
+
+       _arguments "--${prefix}verbose[Verbose execution]" \
+               "--${prefix}color=-[Use colored output]:color:(on auto off)"
+
+}
+
+__gbp_branch_options() {
+       local prefix="$1"
+       _arguments \
+               "--${prefix}debian-branch=-[The branch the Debian package is being developed on]" \
+               "--${prefix}upstream-branch=-[The branch the upstream  sources  are  put onto]" \
+               "--${prefix}pristine-tar[Track pristine tar branch]"
+}
+
+__gbp_tag_format_options() {
+       local prefix="$1"
+       _arguments \
+               "--${prefix}debian-tag=-[format string for debian tags]" \
+               "--${prefix}upstream-tag=-[format string for upstream tags]"
+}
+
+__gbp_tag_sign_options() {
+       local prefix="$1"
+       _arguments \
+               "(--${prefix}sign-tags --${prefix}no-sign-tags)--${prefix}sign-tags[GPG sign all generated tags]" \
+               "(--${prefix}sign-tags --${prefix}no-sign-tags)--${prefix}no-sign-tags[Do not GPG sign generated tags]" \
+               "--${prefix}keyid=-[GPG keyid to sign tags with]:GPG key:"
+}
+
+_gbp() {
+       local curcontext="$curcontext" state line
+       typeset -A opt_args
+       _arguments -C \
+               ':command:->command' \
+               '*::options:->options' \
+
+       case $state in
+       (command)
+               #breaks if defined outside the func
+               local -a subcommands
+               subcommands=(
+                       'buildpackage:Build a Debian package'
+                       'clone:Clone  a  Git  repository from a remote and set up the necessary branch tracking.'
+                       'create-remote-repo:Create a remote Git repository'
+                       'dch:Generate the debian/changelog from  Git commit history'
+                       'import-dsc:Import a single Debian source package'
+                       'import-dscs:Import multiple Debian source packages'
+                       'import-orig:Import a new upstream tarball'
+                       'pq:Manage debian/patches using Git rebase'
+                       'pull:Update a Git repository from a remote'
+               )
+
+               _describe -t commands gbp subcommands
+       ;;
+       (options)
+               local funcname
+               funcname=_gbp-$line[1]
+               if type $funcname | grep -q "shell function" ; then
+                       $funcname
+               fi
+       ;;
+       esac
+}
+
+_gbp-buildpackage() {
+       __gbp_common_options git-
+       __gbp_branch_options git-
+       __gbp_tag_format_options git-
+       __gbp_tag_sign_options git-
+       _arguments \
+         '--git-ignore-new[build with uncommited changes in the source tree]' \
+         '--git-no-ignore-new[negates --git-ignore-new]' \
+         '--git-tag[create a tag after a successful build]' \
+         '--git-tag-only[do not build, only tag and run the posttag hook]' \
+         '--git-retag[do not fail if the tag already exists]' \
+         '--git-force-create[force creation of orig.tar.gz]' \
+         '--git-no-create-orig[do not create orig.tar.gz]' \
+         '--git-tarball-dir=-[location to look for external tarballs]:tarball directory:_files -/' \
+         '--git-compression=-[compression type]:compression:(auto gzip bzip2 lzma xz)' \
+         '--git-compression-level=-[set compression level]:level:(1 2 3 4 5 6 7 8 9)' \
+         '--git-ignore-branch[build although debian-branch != current branch]' \
+         '--git-no-ignore-branch[negates --git-ignore-branch]' \
+         '--git-builder=-[command to build the Debian package]:command:' \
+         '--git-cleaner=-[command to clean the working copy]:command:' \
+         '--git-prebuild=-[command to run before a build]:command:' \
+         '--git-postbuild=-[hook run after a successful build]:command:' \
+         '--git-posttag=-[hook run after a successful tag operation]:command:' \
+         '--git-pbuilder[invoke git-pbuilder for building]' \
+         '--git-no-pbuilder[negates --git-pbuilder]' \
+         '--git-dist=-[build for this distribution when using git-pbuilder]:distribution:' \
+         '--git-arch=-[build for this architecture when using git-pbuilder]:architecture:' \
+         '--git-export-dir=-[before building the package export the source into this directory]:directory:_files -/' \
+         '--git-export=-[export treeish object instead of HEAD]:treeish:' \
+         '--git-dont-purge[retain exported package build directory]' \
+         '--git-overlay[extract orig tarball when using export-dir option]' \
+         '--git-no-overlay[negates --git-overlay]' \
+         '--git-notify=-[Send a desktop notification after build]:notify:(on auto off)' \
+         '*:Other options:_dpkg-buildpackage'
+}
+
+_gbp-clone() {
+       __gbp_common_options
+       __gbp_branch_options
+       _arguments \
+               '--all[Track all branches, not only debian and upstream]'
+}
+
+_gbp-create-remote-repo() {
+       __gbp_common_options
+       _arguments \
+               '--remote-url-pattern=-[Where to create remote repository]' \
+               '--remote-name=-[What  name  git  will use when refering to that repository]' \
+               '--template-dir=-[Template dir to pass to git init]' \
+               '--remote-config=-[Name of config file section to specify params]' \
+               '(--track --no-track)--track[Set up branch tracking]' \
+               '(--track --no-track)--no-track[Do not set up branch tracking]'
+
+}
+
+_gbp-dch () {
+       __gbp_common_options
+       __gbp_branch_options
+       __gbp_tag_format_options
+
+       _arguments \
+               '--git-ignore-branch[build although debian-branch != current branch]' \
+               '--since=-[Start point for reading commits]:commitish:' \
+               '--auto[Guess the last commit documented in the changelog]' \
+               '(--meta --no-meta)--meta[Parse meta tags]' \
+               '(--meta --no-meta)--no-meta[Do not parse meta tags]' \
+               '--meta-closes=-[What meta tags to look for  to  generate  bug-closing  changelog entries]' \
+               '(--full --no-full)--full[Include the full commit message]' \
+               '(--full --no-full)--no-full[Do not include the full commit message]' \
+               '(--snapshot -S)'{-S,--snapshot}'[Create a snapshot release entry]' \
+               '--snapshot-number=-[Python expression that gets eval()ed to the new snapshot number]' \
+               '(--release -R)'{-R,--release}'[Remove any snapshot release banners]' \
+               '(--new-version -N)'{-R,--release}'=[Specify changelog version]' \
+               '--team[Create a team upload entry]' \
+               '--bpo[Increment the release number for a backports upload]' \
+               '--nmu[Increment the release number for a NMU upload]' \
+               '--qa[Increment the release number for a QA upload]' \
+               '--distribution=-[Set the distribution field]' \
+               '--force-distribution[Force distribution]' \
+               '--urgency=-[Set the upload urgency]' \
+               '--git-log=-[Options passed to git log]' \
+               '--id-length=-[Number of commit id digits to include]' \
+               '--ignore-regex=-[Ignore matching commit lines]' \
+               '--git-author[Use git name configuration for changelog signature]' \
+               '(--multimaint-merge --no-multimaint-merge)--multimaint-merge[Merge commits by maintainer]' \
+               '(--multimaint-merge --no-multimaint-merge)--multimaint-merge[Do not merge commits by maintainer]' \
+               '--spawn-editor=[Spawn an editor]:when:(always snapshot release)' \
+               '--commit-msg=[Commit message format string]' \
+               '--commit[Commit the generated changelog]' \
+               '*:Paths:_files -/'
+}
+
+_gbp-import-dsc() {
+       __gbp_common_options
+       __gbp_branch_options
+       __gbp_tag_format_options
+       __gbp_tag_sign_options
+       _arguments \
+               '--filter=-[Filter out files]' \
+               '--download=-[Download the source package]' \
+               '--allow-unauthenticated[Skip signature verification on downloads]' \
+               '--allow-same-version[Import a package with the same debian version]' \
+               '--author-is-committer[Use the author identity as committer identity]' \
+               '--author-date-is-committer-date[Use author date as commit date]' \
+               '*:package:_files -g "*.dsc"'
+       # TODO: complete source package names
+       # TODO: pass only one tarball/source package name
+}
+
+_gbp-import-dscs() {
+       # same options
+       _gbp-import_dsc
+       _arguments \
+               '--debsnap[Fetch snapshots from snapshots.debian.org]' \
+               '--ignore-repo-config[Ignore options in gbp.conf]'
+       # TODO: multiple dscs or one source package name + debsnap
+}
+
+_gbp-import-orig() {
+       __gbp_common_options
+       __gbp_branch_options
+       __gbp_tag_format_options
+       __gbp_tag_sign_options
+       _arguments \
+               '(--upstream-version -u)'{--upstream-version,-u}'=[The upstream version number]' \
+               '--merge[Merge the upstream branch into the debian branch]' \
+               '--upstream-vcs-tag=-[Add a tag as an additional parent to the upstream tarball commit]' \
+               '--import-msg=-[Commit message format string]' \
+               '--filter=-[Filter out files]' \
+               '--filter-pristine-tar[When filtering also filter out of pristine-tar tarballs]' \
+               '(--symlink-orig --no-symlink-orig)--symlink-orig=[Create a symlink with a debian-compliant name]' \
+               '(--symlink-orig --no-symlink-orig)--no-symlink-orig=[Do not create a symlink with a debian-compliant name]' \
+               '--postimport=-[Run a command after import]' \
+               '--uscan[Use uscan to fetch the new upstream version]' \
+               '*:file:_files'
+
+       # TODO: pass only one tarball
+       # TODO: Do not complete files when uscan option is enabled
+}
+
+_gbp-pq() {
+       __gbp_common_options
+       _arguments \
+               '(--patch-numbers --no-patch-numbers)--patch-numbers[Add numbers to patch files]' \
+               '(--patch-numbers --no-patch-numbers)--no-patch-numbers[Do not add numbers to patch files]' \
+               '--topic=-[Topic to use when importing a single patch]' \
+               '--time-machine=-[Go back N commits trying to apply patch queue]'
+
+       local -a pqcommands
+       pqcommands=(
+               'import:Create   a   patch   queue   branch'
+               'export:Export the patches on the patch-queue branch'
+               'rebase:Rebase the  patch-queue  branch against the current branch'
+               'drop:Drop the patch queue'
+               'apply:Add  a  single patch to the patch-queue'
+               'switch:Switch to the patch-queue branch if on the base branch and viceversa'
+       )
+       # TODO: only display these commands once
+       _describe -t pqcommands gbp-pq pqcommands
+}
+
+_gbp-pull() {
+       __gbp_common_options
+       __gbp_branch_options
+       _arguments \
+               '--force[Update even non fast-forward]' \
+               '--redo-pq[Rebuild the patch queue]' \
+               '--ignore-branch[Dont care if on a detached state]' \
+               '--depth=-[Depth for deepening shallow clones]'
+}
+
+_gbp "$@"
index 2c40bef..a80bd52 100755 (executable)
@@ -9,6 +9,8 @@ EXAMPLE_SCRIPTS=\
 
 DEB_COMPRESS_EXCLUDE=$(EXAMPLE_SCRIPTS)
 
+ZSH_COMPDIR = /usr/share/zsh/vendor-completions/
+
 PYCHECKER_ARGS=-boptparse --no-override --no-shadowbuiltin
 
 %:
@@ -38,6 +40,9 @@ override_dh_auto_build:
 override_dh_auto_install:
        dh_auto_install
        dh_bash-completion
+       mkdir -p debian/git-buildpackage/$(ZSH_COMPDIR)
+       install -m644 debian/git-buildpackage.zsh-completion \
+               debian/git-buildpackage/$(ZSH_COMPDIR)/_gbp
 
 override_dh_auto_clean:
        dh_auto_clean