mirror of
				https://gitlab.archlinux.org/archlinux/devtools.git
				synced 2025-10-31 07:44:43 +01:00 
			
		
		
		
	Compare commits
	
		
			1 Commits
		
	
	
		
			bertptrs/z
			...
			unstable
		
	
	| Author | SHA1 | Date | |
|---|---|---|---|
|   | d7c7074457 | 
| @@ -1,15 +0,0 @@ | ||||
| # EditorConfig configuration for devtools | ||||
| # https://editorconfig.org | ||||
|  | ||||
| # Top-most EditorConfig file | ||||
| root = true | ||||
|  | ||||
| # Unix-style newlines without trailing whitespaces, but with a newline | ||||
| # ending every file, utf-8 charset, set indent to tabs | ||||
| [*] | ||||
| end_of_line = lf | ||||
| insert_final_newline = true | ||||
| trim_trailing_whitespace = true | ||||
| charset = utf-8 | ||||
| indent_style = tab | ||||
| tab_width = 4 | ||||
| @@ -8,37 +8,14 @@ build: | ||||
|   stage: build | ||||
|   needs: [] | ||||
|   script: | ||||
|     - pacman -Syu --noconfirm m4 make openssh subversion rsync arch-install-scripts git bzr mercurial diffutils asciidoctor | ||||
|     - pacman -Syu --noconfirm m4 make openssh subversion rsync arch-install-scripts git bzr mercurial diffutils asciidoc | ||||
|     - make PREFIX=/usr | ||||
|     - make PREFIX=/usr DESTDIR=build install | ||||
|  | ||||
| lint: | ||||
| check: | ||||
|   stage: test | ||||
|   needs: [] | ||||
|   script: | ||||
|     - pacman -Syu --noconfirm m4 make openssh subversion rsync arch-install-scripts git bzr mercurial diffutils asciidoctor shellcheck | ||||
|     - pacman -Syu --noconfirm m4 make openssh subversion rsync arch-install-scripts git bzr mercurial diffutils asciidoc shellcheck | ||||
|     - make check || true | ||||
|     - SHELLCHECK_OPTS="-S error" make check | ||||
|  | ||||
| test: | ||||
|   stage: test | ||||
|   needs: [] | ||||
|   script: | ||||
|     - pacman -Syu --noconfirm m4 make openssh subversion rsync arch-install-scripts git bzr mercurial diffutils coreutils asciidoctor shellcheck nvchecker bats | ||||
|     - make test BATS_EXTRA_ARGS='--formatter junit' | ||||
|   artifacts: | ||||
|     reports: | ||||
|       junit: build/coverage/bats-report.xml | ||||
|  | ||||
| coverage: | ||||
|   stage: test | ||||
|   needs: [] | ||||
|   script: | ||||
|     - pacman -Syu --noconfirm m4 make openssh subversion rsync arch-install-scripts git bzr mercurial diffutils coreutils asciidoctor shellcheck nvchecker bats kcov jq | ||||
|     - make coverage | ||||
|   coverage: '/Percent covered\s+\d+\.\d+/' | ||||
|   artifacts: | ||||
|     reports: | ||||
|       coverage_report: | ||||
|         coverage_format: cobertura | ||||
|         path: build/coverage/bats.*/cobertura.xml | ||||
|   | ||||
							
								
								
									
										39
									
								
								Makefile
									
									
									
									
									
								
							
							
						
						
									
										39
									
								
								Makefile
									
									
									
									
									
								
							| @@ -1,6 +1,6 @@ | ||||
| SHELL=/bin/bash -o pipefail | ||||
| SHELL=/bin/bash | ||||
|  | ||||
| V=1.3.1 | ||||
| V=1.0.3 | ||||
| BUILDTOOLVER ?= $(V) | ||||
|  | ||||
| PREFIX = /usr/local | ||||
| @@ -16,7 +16,6 @@ LIBRARY_SRC = $(call rwildcard,src/lib,*.sh) | ||||
| LIBRARY = $(addprefix $(BUILDDIR)/,$(patsubst src/%,%,$(patsubst %.in,%,$(LIBRARY_SRC)))) | ||||
| MAKEPKG_CONFIGS=$(wildcard config/makepkg/*) | ||||
| PACMAN_CONFIGS=$(wildcard config/pacman/*) | ||||
| GIT_CONFIGS = $(wildcard config/git/*) | ||||
| SETARCH_ALIASES = $(wildcard config/setarch-aliases.d/*) | ||||
| MANS = $(addprefix $(BUILDDIR)/,$(patsubst %.asciidoc,%,$(wildcard doc/man/*.asciidoc))) | ||||
|  | ||||
| @@ -52,13 +51,6 @@ ARCHBUILD_LINKS = \ | ||||
| COMPLETIONS = $(addprefix $(BUILDDIR)/,$(patsubst %.in,%,$(wildcard contrib/completion/*/*))) | ||||
|  | ||||
|  | ||||
| CASES ?= test/case | ||||
| JOBS ?= $(shell nproc) | ||||
| BATS_EXTRA_ARGS ?= | ||||
| BATS_ARGS ?= --jobs $(JOBS) $(BATS_EXTRA_ARGS) --verbose-run | ||||
| COVERAGE_DIR ?= $(BUILDDIR)/coverage | ||||
|  | ||||
|  | ||||
| all: binprogs library conf completion man | ||||
| binprogs: $(BINPROGS) | ||||
| library: $(LIBRARY) | ||||
| @@ -99,18 +91,15 @@ $(eval $(call buildInScript,build/bin,src/,.in,755)) | ||||
| $(eval $(call buildInScript,build/lib,src/lib/,,644)) | ||||
| $(foreach completion,$(wildcard contrib/completion/*),$(eval $(call buildInScript,build/$(completion),$(completion)/,.in,444))) | ||||
|  | ||||
| $(BUILDDIR)/doc/man/%: doc/man/%.asciidoc doc/man/include/footer.asciidoc | ||||
| $(BUILDDIR)/doc/man/%: doc/man/%.asciidoc doc/asciidoc.conf doc/man/include/footer.asciidoc | ||||
| 	$(GEN_MSG) | ||||
| 	@mkdir -p $(BUILDDIR)/doc/man | ||||
| 	@asciidoctor --backend=manpage --destination-dir=$(BUILDDIR)/doc/man --attribute pkgdatadir=$(DATADIR) $< | ||||
| 	@a2x --no-xmllint --asciidoc-opts="-f doc/asciidoc.conf" -d manpage -f manpage --destination-dir=$(BUILDDIR)/doc/man -a pkgdatadir=$(DATADIR) $< | ||||
|  | ||||
| conf: | ||||
| 	@install -d $(BUILDDIR)/makepkg.conf.d | ||||
| 	@install -d $(BUILDDIR)/makepkg.conf.d $(BUILDDIR)/pacman.conf.d | ||||
| 	@cp -a $(MAKEPKG_CONFIGS) $(BUILDDIR)/makepkg.conf.d | ||||
| 	@install -d $(BUILDDIR)/pacman.conf.d | ||||
| 	@cp -a $(PACMAN_CONFIGS) $(BUILDDIR)/pacman.conf.d | ||||
| 	@install -d $(BUILDDIR)/git.conf.d | ||||
| 	@cp -a $(GIT_CONFIGS) $(BUILDDIR)/git.conf.d | ||||
|  | ||||
| clean: | ||||
| 	rm -rf $(BUILDDIR) | ||||
| @@ -123,7 +112,6 @@ install: all | ||||
| 	install -m0755 ${BINPROGS} $(DESTDIR)$(PREFIX)/bin | ||||
| 	install -dm0755 $(DESTDIR)$(DATADIR)/lib | ||||
| 	cp -ra $(BUILDDIR)/lib/* $(DESTDIR)$(DATADIR)/lib | ||||
| 	cp -a $(BUILDDIR)/git.conf.d -t $(DESTDIR)$(DATADIR) | ||||
| 	for conf in $(notdir $(MAKEPKG_CONFIGS)); do install -Dm0644 $(BUILDDIR)/makepkg.conf.d/$$conf $(DESTDIR)$(DATADIR)/makepkg.conf.d/$${conf##*/}; done | ||||
| 	for conf in $(notdir $(PACMAN_CONFIGS)); do install -Dm0644 $(BUILDDIR)/pacman.conf.d/$$conf $(DESTDIR)$(DATADIR)/pacman.conf.d/$${conf##*/}; done | ||||
| 	for a in ${SETARCH_ALIASES}; do install -m0644 $$a -t $(DESTDIR)$(DATADIR)/setarch-aliases.d; done | ||||
| @@ -141,7 +129,6 @@ uninstall: | ||||
| 	for f in $(notdir $(BINPROGS)); do rm -f $(DESTDIR)$(PREFIX)/bin/$$f; done | ||||
| 	for f in $(notdir $(LIBRARY)); do rm -f $(DESTDIR)$(DATADIR)/lib/$$f; done | ||||
| 	rm -rf $(DESTDIR)$(DATADIR)/lib | ||||
| 	rm -rf $(DESTDIR)$(DATADIR)/git.conf.d | ||||
| 	for conf in $(notdir $(MAKEPKG_CONFIGS)); do rm -f $(DESTDIR)$(DATADIR)/makepkg.conf.d/$${conf##*/}; done | ||||
| 	for conf in $(notdir $(PACMAN_CONFIGS)); do rm -f $(DESTDIR)$(DATADIR)/pacman.conf.d/$${conf##*/}; done | ||||
| 	for f in $(notdir $(SETARCH_ALIASES)); do rm -f $(DESTDIR)$(DATADIR)/setarch-aliases.d/$$f; done | ||||
| @@ -159,7 +146,6 @@ uninstall: | ||||
| 		$(DESTDIR)$(DATADIR) | ||||
|  | ||||
| tag: | ||||
| 	git cliff --strip=all --unreleased | ||||
| 	@echo "current version: v$(V)" | ||||
| 	@read -r -p "tag version: v" VERSION && \ | ||||
| 	sed -E "s|^V=.+|V=$$VERSION|" -i Makefile && \ | ||||
| @@ -167,25 +153,14 @@ tag: | ||||
| 	git tag --sign --message "Version v$$VERSION" v$$VERSION | ||||
|  | ||||
| release: dist | ||||
| 	git push --tags origin master | ||||
| 	git cliff --version >/dev/null | ||||
| 	GITLAB_HOST=gitlab.archlinux.org glab release create v$(V) devtools-$(V).tar.gz* --milestone v$(V) --notes-file <(git cliff --strip=all --latest) | ||||
| 	glab release create v$(V) devtools-$(V).tar.gz* | ||||
|  | ||||
| dist: | ||||
| 	git archive --format=tar --prefix=devtools-$(V)/ v$(V) | gzip > devtools-$(V).tar.gz | ||||
| 	gpg --detach-sign --use-agent devtools-$(V).tar.gz | ||||
|  | ||||
| test: binprogs library conf completion man | ||||
| 	@mkdir -p $(COVERAGE_DIR) | ||||
| 	bats $(BATS_ARGS) $(CASES) | tee $(COVERAGE_DIR)/bats-report.xml | ||||
|  | ||||
| coverage: binprogs library conf completion man | ||||
| 	kcov --include-path=src $(COVERAGE_DIR) bats $(BATS_ARGS) $(CASES) | ||||
| 	jq -r '. | ["Percent covered", .percent_covered], ["Covered lines", .covered_lines], ["Total lines", .total_lines], ["Percent low", .percent_low], ["Percent high", .percent_high] | @tsv' \ | ||||
| 		$(COVERAGE_DIR)/bats.*/coverage.json | ||||
|  | ||||
| check: $(BINPROGS_SRC) $(LIBRARY_SRC) contrib/completion/bash/devtools.in config/makepkg/x86_64.conf contrib/makepkg/PKGBUILD.proto | ||||
| 	shellcheck $^ | ||||
|  | ||||
| .PHONY: all binprogs library completion conf man clean install uninstall tag dist upload test coverage check | ||||
| .PHONY: all binprogs library completion conf man clean install uninstall tag dist upload check | ||||
| .DELETE_ON_ERROR: | ||||
|   | ||||
							
								
								
									
										40
									
								
								README.md
									
									
									
									
									
								
							
							
						
						
									
										40
									
								
								README.md
									
									
									
									
									
								
							| @@ -23,34 +23,6 @@ will automatically build the project and proxy all calls to the local build dire | ||||
| ./test/bin/pkgctl --help | ||||
| ``` | ||||
|  | ||||
| ### Commit messages | ||||
|  | ||||
| All commits must follow [conventional commits](https://www.conventionalcommits.org). | ||||
|  | ||||
| The following groups are allowed: | ||||
|  | ||||
| - chore | ||||
| - feat | ||||
| - fix | ||||
| - doc | ||||
| - perf | ||||
| - test | ||||
|  | ||||
| To override the scope for the changelog entry use the `Component:` trailer. | ||||
|  | ||||
| Example: | ||||
|  | ||||
| ``` | ||||
| feat(db): yay mega cool feature | ||||
|  | ||||
| Very long and useful description. | ||||
|  | ||||
| Fixes #1 | ||||
| Fixes #2 | ||||
|  | ||||
| Component: pkgctl db remove | ||||
| ``` | ||||
|  | ||||
| ## Releasing | ||||
|  | ||||
| 1. bump the version in the Makefile | ||||
| @@ -69,14 +41,10 @@ Component: pkgctl db remove | ||||
| - bash | ||||
| - binutils | ||||
| - coreutils | ||||
| - curl | ||||
| - diffutils | ||||
| - expac | ||||
| - fakeroot | ||||
| - findutils | ||||
| - glow | ||||
| - grep | ||||
| - gum | ||||
| - jq | ||||
| - ncurses | ||||
| - openssh | ||||
| @@ -90,17 +58,11 @@ Component: pkgctl db remove | ||||
| - mercurial | ||||
| - subversion | ||||
|  | ||||
| ### Optional Dependencies | ||||
|  | ||||
| - bat (pretty printing) | ||||
| - nvchecker (version checking) | ||||
|  | ||||
| ### Development Dependencies | ||||
|  | ||||
| - asciidoctor | ||||
| - asciidoc | ||||
| - make | ||||
| - shellcheck | ||||
| - bats | ||||
|  | ||||
| ## License | ||||
|  | ||||
|   | ||||
							
								
								
									
										45
									
								
								cliff.toml
									
									
									
									
									
								
							
							
						
						
									
										45
									
								
								cliff.toml
									
									
									
									
									
								
							| @@ -1,45 +0,0 @@ | ||||
| [changelog] | ||||
| header = "# Changelog\n\n" | ||||
| body = """ | ||||
| {%- if version -%} | ||||
|     ## [{{ version | trim_start_matches(pat="v") }}] - {{ timestamp | date(format="%Y-%m-%d") }} | ||||
| {%- else -%} | ||||
|     ## [unreleased] | ||||
| {%- endif %} | ||||
| {% for group, commits in commits | group_by(attribute="group") %} | ||||
|     ### {{ group | upper_first }} | ||||
|     {% for commit in commits | sort(attribute="message") %} | ||||
| 		- {% set component = commit.footers | filter(attribute="token", value="Component") | map(attribute="value") | join(sep=", ") %} | ||||
| 		{%- if component %}{{ component }}: {% elif commit.scope %}{{ commit.scope }}: {% endif %} | ||||
| 		{{- commit.message | upper_first }} | ||||
| 		{%- if commit.breaking %} (breaking){% endif %} | ||||
| 		{%- set fixes = commit.footers | filter(attribute="token", value="Fixes") %} | ||||
| 		{%- for fix in fixes %}{% if fix.separator|trim == '#' %}{{ fix.separator }}{{ fix.value }}{% endif %}{% endfor %} | ||||
|     {%- endfor %} | ||||
| {% endfor %} | ||||
|  | ||||
| """ | ||||
| footer = "" | ||||
|  | ||||
| # remove the leading and trailing whitespaces from the template | ||||
| trim = true | ||||
|  | ||||
| [git] | ||||
| # allow only conventional commits | ||||
| # https://www.conventionalcommits.org | ||||
| conventional_commits = true | ||||
| # regex for parsing and grouping commits | ||||
| commit_parsers = [ | ||||
|     { message = "^chore\\(release\\): version", skip = true}, | ||||
|     { message = "^feat", group = "Features"}, | ||||
|     { message = "^fix", group = "Bug Fixes"}, | ||||
|     { message = "^doc", group = "Documentation"}, | ||||
|     { message = "^perf", group = "Performance"}, | ||||
|     { message = "^test", group = "Testing"}, | ||||
|     { message = "^chore", group = "Miscellaneous Tasks"}, | ||||
|     { body = ".*security", group = "Security"}, | ||||
| ] | ||||
| # filter out the commits that are not matched by commit parsers | ||||
| filter_commits = false | ||||
| # regex for matching git tags | ||||
| tag_pattern = "^v[0-9]+\\.[0-9]+\\.[0-9]+.*" | ||||
| @@ -1 +0,0 @@ | ||||
| #!/bin/sh | ||||
| @@ -1 +0,0 @@ | ||||
| #!/bin/sh | ||||
| @@ -1 +0,0 @@ | ||||
| #!/bin/sh | ||||
| @@ -1 +0,0 @@ | ||||
| #!/bin/sh | ||||
| @@ -1 +0,0 @@ | ||||
| #!/bin/sh | ||||
| @@ -1 +0,0 @@ | ||||
| #!/bin/sh | ||||
| @@ -1 +0,0 @@ | ||||
| #!/bin/sh | ||||
| @@ -1 +0,0 @@ | ||||
| #!/bin/sh | ||||
| @@ -1 +0,0 @@ | ||||
| #!/bin/sh | ||||
| @@ -1 +0,0 @@ | ||||
| #!/bin/sh | ||||
| @@ -1 +0,0 @@ | ||||
| #!/bin/sh | ||||
| @@ -1 +0,0 @@ | ||||
| #!/bin/sh | ||||
| @@ -1,28 +0,0 @@ | ||||
| /pkg | ||||
| /src | ||||
| /*/ | ||||
| !/keys/ | ||||
|  | ||||
| /*.log | ||||
| /*.tar.* | ||||
| /*.tar | ||||
| /*.tgz | ||||
| /*.zst | ||||
| /*.gz | ||||
| /*.xz | ||||
| /*.bz2 | ||||
| /*.zip | ||||
| /*.xpi | ||||
| /*.jar | ||||
| /*.whl | ||||
| /*.war | ||||
| /*.deb | ||||
| /*.ttf | ||||
| /*.dat | ||||
| /*.iso | ||||
| /*.asc | ||||
| /*.sig | ||||
| /*.signature | ||||
| /*.sign | ||||
| /*.SHA256SUMS | ||||
| /*.sha256 | ||||
| @@ -25,7 +25,7 @@ DLAGENTS=('file::/usr/bin/curl -qgC - -o %o %u' | ||||
|  | ||||
| #-- The package required by makepkg to download VCS sources | ||||
| #  Format: 'protocol::package' | ||||
| VCSCLIENTS=('bzr::breezy' | ||||
| VCSCLIENTS=('bzr::bzr' | ||||
|             'fossil::fossil' | ||||
|             'git::git' | ||||
|             'hg::mercurial' | ||||
| @@ -41,18 +41,18 @@ CHOST="x86_64-pc-linux-gnu" | ||||
| #-- Compiler and Linker Flags | ||||
| #CPPFLAGS="" | ||||
| CFLAGS="-march=x86-64 -mtune=generic -O2 -pipe -fno-plt -fexceptions \ | ||||
|         -Wp,-D_FORTIFY_SOURCE=3 -Wformat -Werror=format-security \ | ||||
|         -fstack-clash-protection -fcf-protection \ | ||||
|         -fno-omit-frame-pointer -mno-omit-leaf-frame-pointer" | ||||
|         -Wp,-D_FORTIFY_SOURCE=2 -Wformat -Werror=format-security \ | ||||
|         -fstack-clash-protection -fcf-protection" | ||||
| CXXFLAGS="$CFLAGS -Wp,-D_GLIBCXX_ASSERTIONS" | ||||
| LDFLAGS="-Wl,-O1 -Wl,--sort-common -Wl,--as-needed -Wl,-z,relro -Wl,-z,now \ | ||||
|          -Wl,-z,pack-relative-relocs" | ||||
| LDFLAGS="-Wl,-O1,--sort-common,--as-needed,-z,relro,-z,now" | ||||
| LTOFLAGS="-flto=auto" | ||||
| RUSTFLAGS="" | ||||
| #-- Make Flags: change this for DistCC/SMP systems | ||||
| #MAKEFLAGS="-j2" | ||||
| #-- Debugging flags | ||||
| DEBUG_CFLAGS="-g" | ||||
| DEBUG_CXXFLAGS="$DEBUG_CFLAGS" | ||||
| DEBUG_RUSTFLAGS="-C debuginfo=2" | ||||
|  | ||||
| ######################################################################### | ||||
| # BUILD ENVIRONMENT | ||||
| @@ -81,7 +81,7 @@ BUILDENV=(!distcc color !ccache check !sign) | ||||
| #   These are default values for the options=() settings | ||||
| ######################################################################### | ||||
| # | ||||
| # Makepkg defaults: OPTIONS=(!strip docs libtool staticlibs emptydirs !zipman !purge !debug !lto !autodeps) | ||||
| # Makepkg defaults: OPTIONS=(!strip docs libtool staticlibs emptydirs !zipman !purge !debug !lto) | ||||
| #  A negated option will do the opposite of the comments below. | ||||
| # | ||||
| #-- strip:      Strip symbols from binaries/libraries | ||||
| @@ -93,7 +93,6 @@ BUILDENV=(!distcc color !ccache check !sign) | ||||
| #-- purge:      Remove files specified by PURGE_TARGETS | ||||
| #-- debug:      Add debugging flags as specified in DEBUG_* variables | ||||
| #-- lto:        Add compile flags for building with link time optimization | ||||
| #-- autodeps:   Automatically add depends/provides | ||||
| # | ||||
| OPTIONS=(strip docs !libtool !staticlibs emptydirs zipman purge debug lto) | ||||
|  | ||||
| @@ -113,8 +112,6 @@ DOC_DIRS=(usr/{,local/}{,share/}{doc,gtk-doc} opt/*/{doc,gtk-doc}) | ||||
| PURGE_TARGETS=(usr/{,share}/info/dir .packlist *.pod) | ||||
| #-- Directory to store source code in for debug packages | ||||
| DBGSRCDIR="/usr/src/debug" | ||||
| #-- Prefix and directories for library autodeps | ||||
| LIB_DIRS=('lib:usr/lib' 'lib32:usr/lib32') | ||||
|  | ||||
| ######################################################################### | ||||
| # PACKAGE OUTPUT | ||||
|   | ||||
| @@ -25,7 +25,7 @@ DLAGENTS=('file::/usr/bin/curl -qgC - -o %o %u' | ||||
|  | ||||
| #-- The package required by makepkg to download VCS sources | ||||
| #  Format: 'protocol::package' | ||||
| VCSCLIENTS=('bzr::breezy' | ||||
| VCSCLIENTS=('bzr::bzr' | ||||
|             'fossil::fossil' | ||||
|             'git::git' | ||||
|             'hg::mercurial' | ||||
| @@ -41,18 +41,18 @@ CHOST="x86_64-pc-linux-gnu" | ||||
| #-- Compiler and Linker Flags | ||||
| #CPPFLAGS="" | ||||
| CFLAGS="-march=x86-64-v3 -mtune=generic -O2 -pipe -fno-plt -fexceptions \ | ||||
|         -Wp,-D_FORTIFY_SOURCE=3 -Wformat -Werror=format-security \ | ||||
|         -fstack-clash-protection -fcf-protection \ | ||||
|         -fno-omit-frame-pointer -mno-omit-leaf-frame-pointer" | ||||
|         -Wp,-D_FORTIFY_SOURCE=2 -Wformat -Werror=format-security \ | ||||
|         -fstack-clash-protection -fcf-protection" | ||||
| CXXFLAGS="$CFLAGS -Wp,-D_GLIBCXX_ASSERTIONS" | ||||
| LDFLAGS="-Wl,-O1 -Wl,--sort-common -Wl,--as-needed -Wl,-z,relro -Wl,-z,now \ | ||||
|          -Wl,-z,pack-relative-relocs" | ||||
| LDFLAGS="-Wl,-O1,--sort-common,--as-needed,-z,relro,-z,now" | ||||
| LTOFLAGS="-flto=auto" | ||||
| RUSTFLAGS="" | ||||
| #-- Make Flags: change this for DistCC/SMP systems | ||||
| #MAKEFLAGS="-j2" | ||||
| #-- Debugging flags | ||||
| DEBUG_CFLAGS="-g" | ||||
| DEBUG_CXXFLAGS="$DEBUG_CFLAGS" | ||||
| DEBUG_RUSTFLAGS="-C debuginfo=2" | ||||
|  | ||||
| ######################################################################### | ||||
| # BUILD ENVIRONMENT | ||||
| @@ -81,7 +81,7 @@ BUILDENV=(!distcc color !ccache check !sign) | ||||
| #   These are default values for the options=() settings | ||||
| ######################################################################### | ||||
| # | ||||
| # Makepkg defaults: OPTIONS=(!strip docs libtool staticlibs emptydirs !zipman !purge !debug !lto !autodeps) | ||||
| # Makepkg defaults: OPTIONS=(!strip docs libtool staticlibs emptydirs !zipman !purge !debug !lto) | ||||
| #  A negated option will do the opposite of the comments below. | ||||
| # | ||||
| #-- strip:      Strip symbols from binaries/libraries | ||||
| @@ -93,7 +93,6 @@ BUILDENV=(!distcc color !ccache check !sign) | ||||
| #-- purge:      Remove files specified by PURGE_TARGETS | ||||
| #-- debug:      Add debugging flags as specified in DEBUG_* variables | ||||
| #-- lto:        Add compile flags for building with link time optimization | ||||
| #-- autodeps:   Automatically add depends/provides | ||||
| # | ||||
| OPTIONS=(strip docs !libtool !staticlibs emptydirs zipman purge debug lto) | ||||
|  | ||||
| @@ -113,8 +112,6 @@ DOC_DIRS=(usr/{,local/}{,share/}{doc,gtk-doc} opt/*/{doc,gtk-doc}) | ||||
| PURGE_TARGETS=(usr/{,share}/info/dir .packlist *.pod) | ||||
| #-- Directory to store source code in for debug packages | ||||
| DBGSRCDIR="/usr/src/debug" | ||||
| #-- Prefix and directories for library autodeps | ||||
| LIB_DIRS=('lib:usr/lib' 'lib32:usr/lib32') | ||||
|  | ||||
| ######################################################################### | ||||
| # PACKAGE OUTPUT | ||||
|   | ||||
| @@ -36,8 +36,6 @@ NoProgressBar | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
|   | ||||
| @@ -36,8 +36,6 @@ NoProgressBar | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
|   | ||||
| @@ -36,8 +36,6 @@ NoProgressBar | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
|   | ||||
| @@ -36,8 +36,6 @@ NoProgressBar | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
|   | ||||
| @@ -36,8 +36,6 @@ NoProgressBar | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
|   | ||||
| @@ -36,8 +36,6 @@ NoProgressBar | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
|   | ||||
| @@ -36,8 +36,6 @@ NoProgressBar | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
|   | ||||
| @@ -36,8 +36,6 @@ NoProgressBar | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
|   | ||||
| @@ -36,8 +36,6 @@ NoProgressBar | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
|   | ||||
| @@ -36,8 +36,6 @@ NoProgressBar | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
|   | ||||
| @@ -36,8 +36,6 @@ NoProgressBar | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
|   | ||||
| @@ -36,8 +36,6 @@ NoProgressBar | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
|   | ||||
| @@ -36,8 +36,6 @@ NoProgressBar | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
|   | ||||
| @@ -36,8 +36,6 @@ NoProgressBar | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
|   | ||||
| @@ -36,8 +36,6 @@ NoProgressBar | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
|   | ||||
| @@ -1,114 +0,0 @@ | ||||
| # | ||||
| # /etc/pacman.conf | ||||
| # | ||||
| # See the pacman.conf(5) manpage for option and repository directives | ||||
|  | ||||
| # | ||||
| # GENERAL OPTIONS | ||||
| # | ||||
| [options] | ||||
| # The following paths are commented out with their default values listed. | ||||
| # If you wish to use different paths, uncomment and update the paths. | ||||
| #RootDir     = / | ||||
| #DBPath      = /var/lib/pacman/ | ||||
| #CacheDir    = /var/cache/pacman/pkg/ | ||||
| #LogFile     = /var/log/pacman.log | ||||
| #GPGDir      = /etc/pacman.d/gnupg/ | ||||
| #HookDir     = /etc/pacman.d/hooks/ | ||||
| HoldPkg     = pacman glibc | ||||
| #XferCommand = /usr/bin/curl -L -C - -f -o %o %u | ||||
| #XferCommand = /usr/bin/wget --passive-ftp -c -O %o %u | ||||
| #CleanMethod = KeepInstalled | ||||
| Architecture = auto | ||||
|  | ||||
| # Pacman won't upgrade packages listed in IgnorePkg and members of IgnoreGroup | ||||
| #IgnorePkg   = | ||||
| #IgnoreGroup = | ||||
|  | ||||
| #NoUpgrade   = | ||||
| #NoExtract   = | ||||
|  | ||||
| # Misc options | ||||
| #UseSyslog | ||||
| #Color | ||||
| NoProgressBar | ||||
| # We cannot check disk space from within a chroot environment | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
| SigLevel    = Required DatabaseOptional | ||||
| LocalFileSigLevel = Optional | ||||
| #RemoteFileSigLevel = Required | ||||
|  | ||||
| # NOTE: You must run `pacman-key --init` before first using pacman; the local | ||||
| # keyring can then be populated with the keys of all official Arch Linux | ||||
| # packagers with `pacman-key --populate archlinux`. | ||||
|  | ||||
| # | ||||
| # REPOSITORIES | ||||
| #   - can be defined here or included from another file | ||||
| #   - pacman will search repositories in the order defined here | ||||
| #   - local/custom mirrors can be added here or in separate files | ||||
| #   - repositories listed first will take precedence when packages | ||||
| #     have identical names, regardless of version number | ||||
| #   - URLs will have $repo replaced by the name of the current repo | ||||
| #   - URLs will have $arch replaced by the name of the architecture | ||||
| # | ||||
| # Repository entries are of the format: | ||||
| #       [repo-name] | ||||
| #       Server = ServerName | ||||
| #       Include = IncludePath | ||||
| # | ||||
| # The header [repo-name] is crucial - it must be present and | ||||
| # uncommented to enable the repo. | ||||
| # | ||||
|  | ||||
| # The testing repositories are disabled by default. To enable, uncomment the | ||||
| # repo name header and Include lines. You can add preferred servers immediately | ||||
| # after the header, and they will be used before the default mirrors. | ||||
|  | ||||
| [gnome-unstable] | ||||
| Include = /etc/pacman.d/mirrorlist | ||||
|  | ||||
| [kde-unstable] | ||||
| Include = /etc/pacman.d/mirrorlist | ||||
|  | ||||
| [core-staging] | ||||
| Include = /etc/pacman.d/mirrorlist | ||||
|  | ||||
| [core-testing] | ||||
| Include = /etc/pacman.d/mirrorlist | ||||
|  | ||||
| [core] | ||||
| Include = /etc/pacman.d/mirrorlist | ||||
|  | ||||
| [extra-staging] | ||||
| Include = /etc/pacman.d/mirrorlist | ||||
|  | ||||
| [extra-testing] | ||||
| Include = /etc/pacman.d/mirrorlist | ||||
|  | ||||
| [extra] | ||||
| Include = /etc/pacman.d/mirrorlist | ||||
|  | ||||
| # If you want to run 32 bit applications on your x86_64 system, | ||||
| # enable the multilib repositories as required here. | ||||
| [multilib-staging] | ||||
| Include = /etc/pacman.d/mirrorlist | ||||
|  | ||||
| [multilib-testing] | ||||
| Include = /etc/pacman.d/mirrorlist | ||||
|  | ||||
| [multilib] | ||||
| Include = /etc/pacman.d/mirrorlist | ||||
|  | ||||
| # An example of a custom package repository.  See the pacman manpage for | ||||
| # tips on creating your own repositories. | ||||
| #[custom] | ||||
| #SigLevel = Optional TrustAll | ||||
| #Server = file:///home/custompkgs | ||||
| @@ -1,85 +0,0 @@ | ||||
| # | ||||
| # /etc/pacman.conf | ||||
| # | ||||
| # See the pacman.conf(5) manpage for option and repository directives | ||||
|  | ||||
| # | ||||
| # GENERAL OPTIONS | ||||
| # | ||||
| [options] | ||||
| # The following paths are commented out with their default values listed. | ||||
| # If you wish to use different paths, uncomment and update the paths. | ||||
| #RootDir     = / | ||||
| #DBPath      = /var/lib/pacman/ | ||||
| #CacheDir    = /var/cache/pacman/pkg/ | ||||
| #LogFile     = /var/log/pacman.log | ||||
| #GPGDir      = /etc/pacman.d/gnupg/ | ||||
| #HookDir     = /etc/pacman.d/hooks/ | ||||
| HoldPkg     = pacman glibc | ||||
| #XferCommand = /usr/bin/curl -L -C - -f -o %o %u | ||||
| #XferCommand = /usr/bin/wget --passive-ftp -c -O %o %u | ||||
| #CleanMethod = KeepInstalled | ||||
| Architecture = auto | ||||
|  | ||||
| # Pacman won't upgrade packages listed in IgnorePkg and members of IgnoreGroup | ||||
| #IgnorePkg   = | ||||
| #IgnoreGroup = | ||||
|  | ||||
| #NoUpgrade   = | ||||
| #NoExtract   = | ||||
|  | ||||
| # Misc options | ||||
| #UseSyslog | ||||
| #Color | ||||
| NoProgressBar | ||||
| # We cannot check disk space from within a chroot environment | ||||
| #CheckSpace | ||||
| VerbosePkgLists | ||||
| ParallelDownloads = 5 | ||||
| DownloadUser = alpm | ||||
| #DisableSandbox | ||||
|  | ||||
| # By default, pacman accepts packages signed by keys that its local keyring | ||||
| # trusts (see pacman-key and its man page), as well as unsigned packages. | ||||
| SigLevel    = Required DatabaseOptional | ||||
| LocalFileSigLevel = Optional | ||||
| #RemoteFileSigLevel = Required | ||||
|  | ||||
| # NOTE: You must run `pacman-key --init` before first using pacman; the local | ||||
| # keyring can then be populated with the keys of all official Arch Linux | ||||
| # packagers with `pacman-key --populate archlinux`. | ||||
|  | ||||
| # | ||||
| # REPOSITORIES | ||||
| #   - can be defined here or included from another file | ||||
| #   - pacman will search repositories in the order defined here | ||||
| #   - local/custom mirrors can be added here or in separate files | ||||
| #   - repositories listed first will take precedence when packages | ||||
| #     have identical names, regardless of version number | ||||
| #   - URLs will have $repo replaced by the name of the current repo | ||||
| #   - URLs will have $arch replaced by the name of the architecture | ||||
| # | ||||
| # Repository entries are of the format: | ||||
| #       [repo-name] | ||||
| #       Server = ServerName | ||||
| #       Include = IncludePath | ||||
| # | ||||
| # The header [repo-name] is crucial - it must be present and | ||||
| # uncommented to enable the repo. | ||||
| # | ||||
|  | ||||
| # The testing repositories are disabled by default. To enable, uncomment the | ||||
| # repo name header and Include lines. You can add preferred servers immediately | ||||
| # after the header, and they will be used before the default mirrors. | ||||
|  | ||||
| [gnome-unstable] | ||||
| Include = /etc/pacman.d/mirrorlist | ||||
|  | ||||
| [kde-unstable] | ||||
| Include = /etc/pacman.d/mirrorlist | ||||
|  | ||||
| # An example of a custom package repository.  See the pacman manpage for | ||||
| # tips on creating your own repositories. | ||||
| #[custom] | ||||
| #SigLevel = Optional TrustAll | ||||
| #Server = file:///home/custompkgs | ||||
| @@ -3,21 +3,12 @@ | ||||
| # SPDX-License-Identifier: GPL-3.0-or-later | ||||
|  | ||||
| _DEVTOOLS_LIBRARY_DIR=${_DEVTOOLS_LIBRARY_DIR:-@pkgdatadir@} | ||||
| # shellcheck source=src/lib/valid-build-install.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-build-install.sh | ||||
| # shellcheck source=src/lib/valid-tags.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-tags.sh | ||||
| # shellcheck source=src/lib/valid-repos.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-repos.sh | ||||
| # shellcheck source=src/lib/valid-inspect.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-inspect.sh | ||||
| # shellcheck source=src/lib/valid-search.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-search.sh | ||||
| # shellcheck source=src/lib/valid-version.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-version.sh | ||||
| # shellcheck source=src/lib/valid-issue.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-issue.sh | ||||
|  | ||||
| _binary_arch=${_arch[*]:0:-1} | ||||
| _colors=(never always auto) | ||||
|  | ||||
|  | ||||
| @@ -31,19 +22,15 @@ _makechrootpkg_args=( | ||||
| 	-I | ||||
| 	-l | ||||
| 	-n | ||||
| 	-t | ||||
| 	-T | ||||
| 	-U | ||||
| 	-x | ||||
| ) | ||||
| _makechrootpkg_args_d_opts() { _filedir -d; } | ||||
| _makechrootpkg_args_D_opts() { _filedir -d; } | ||||
| _makechrootpkg_args_r_opts() { _filedir -d; } | ||||
| _makechrootpkg_args_I_opts() { _filedir '*.pkg.tar.*'; } | ||||
| _makechrootpkg_args_l_opts() { _filedir -d; } | ||||
| _makechrootpkg_args_t_opts() { _filedir -d; } | ||||
| _makechrootpkg_args_U_opts() { :; } | ||||
| _makechrootpkg_args_x_opts() { _devtools_completions_inspect; } | ||||
| _makechrootpkg() { __devtools_complete _makechrootpkg; } | ||||
| complete -F _makechrootpkg makechrootpkg | ||||
|  | ||||
| @@ -51,7 +38,6 @@ complete -F _makechrootpkg makechrootpkg | ||||
| _makerepropkg_args=( | ||||
| 	-h | ||||
| 	-d | ||||
| 	-n | ||||
| 	-c | ||||
| 	-M | ||||
| ) | ||||
| @@ -67,14 +53,12 @@ _mkarchroot_args=( | ||||
| 	-C | ||||
| 	-M | ||||
| 	-c | ||||
| 	-f | ||||
| 	-h | ||||
| ) | ||||
| _mkarchroot_args_U_opts() { _filedir '*.pkg.tar.*'; } | ||||
| _mkarchroot_args_C_opts() { _filedir '*.conf'; } | ||||
| _mkarchroot_args_M_opts() { _filedir '*.conf'; } | ||||
| _mkarchroot_args_c_opts() { _filedir -d; } | ||||
| _mkarchroot_args_f_opts() { _filedir -d; } | ||||
| _mkarchroot_opts() { | ||||
| 	local args | ||||
| 	args=$(__pkgctl_word_count_after_subcommand) | ||||
| @@ -135,7 +119,7 @@ _offload_build_args=( | ||||
| ) | ||||
| _offload_build_args__repo_opts() { _devtools_completions_build_repo; } | ||||
| _offload_build_args_r_opts() { _offload_build_args__repo_opts; } | ||||
| _offload_build_args__arch_opts() { _devtools_completions_binary_arch; } | ||||
| _offload_build_args__arch_opts() { _devtools_completions_arch; } | ||||
| _offload_build_args_a_opts() { _offload_build_args__arch_opts; } | ||||
| _offload_build_args__server_opts() { :; } | ||||
| _offload_build_args_s_opts() { _offload_build_args__server_opts; } | ||||
| @@ -144,15 +128,12 @@ complete -F _offload_build offload-build | ||||
|  | ||||
|  | ||||
| _pkgctl_cmds=( | ||||
| 	aur | ||||
| 	auth | ||||
| 	build | ||||
| 	db | ||||
| 	diff | ||||
| 	issue | ||||
| 	release | ||||
| 	repo | ||||
| 	search | ||||
| 	version | ||||
| ) | ||||
| _pkgctl_args=( | ||||
| @@ -188,14 +169,10 @@ _pkgctl_build_args=( | ||||
| 	-o --offload | ||||
| 	-c --clean | ||||
| 	-w --worker | ||||
| 	--inspect | ||||
| 	-I --install-to-chroot | ||||
| 	-i --install-to-host | ||||
|  | ||||
| 	--pkgver | ||||
| 	--pkgrel | ||||
| 	--rebuild | ||||
| 	--update-checksums | ||||
| 	-e --edit | ||||
|  | ||||
| 	-r --release | ||||
| @@ -204,23 +181,15 @@ _pkgctl_build_args=( | ||||
|  | ||||
| 	-h --help | ||||
| ) | ||||
| _pkgctl_build_args__arch_opts() { _devtools_completions_binary_arch; } | ||||
| _pkgctl_build_args__arch_opts() { _devtools_completions_arch; } | ||||
| _pkgctl_build_args__repo_opts() { _devtools_completions_repo; } | ||||
| _pkgctl_build_args__worker_opts() { :; } | ||||
| _pkgctl_build_args_w_opts() { _pkgctl_build_args__worker_opts; } | ||||
| _pkgctl_build_args__inspect_opts() { _devtools_completions_inspect; } | ||||
| _pkgctl_build_args__pkgver_opts() { :; } | ||||
| _pkgctl_build_args__pkgrel_opts() { :; } | ||||
| _pkgctl_build_args__install_to_host_opts() { _pkgctl_build_completions_install_mode; } | ||||
| _pkgctl_build_args_i_opts() { _pkgctl_build_args__install_to_host_opts; } | ||||
| _pkgctl_build_args__install_to_chroot_opts() { _makechrootpkg_args_I_opts; } | ||||
| _pkgctl_build_args_I_opts() { _pkgctl_build_args__install_to_chroot_opts; } | ||||
| _pkgctl_build_args__message_opts() { :; } | ||||
| _pkgctl_build_args_m_opts() { _pkgctl_build_args__message_opts; } | ||||
| _pkgctl_build_opts() { _filedir -d; } | ||||
| _pkgctl_build_completions_install_mode() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${DEVTOOLS_VALID_BUILD_INSTALL[*]}" -- "$cur") | ||||
| } | ||||
|  | ||||
|  | ||||
| _pkgctl_db_cmds=( | ||||
| @@ -249,13 +218,9 @@ _pkgctl_db_move_opts() { | ||||
|  | ||||
|  | ||||
| _pkgctl_db_remove_args=( | ||||
| 	--partial | ||||
| 	--noconfirm | ||||
| 	-a --arch | ||||
| 	-h --help | ||||
| ) | ||||
| _pkgctl_db_remove_args__arch_opts() { _devtools_completions_binary_arch; } | ||||
| _pkgctl_db_remove_args_a_opts() { _pkgctl_db_remove_args__arch_opts; } | ||||
| _pkgctl_db_remove_opts() { | ||||
| 	local subcommand args | ||||
| 	subcommand=(db remove) | ||||
| @@ -288,20 +253,8 @@ _pkgctl_release_args__repo_opts() { _devtools_completions_repo; } | ||||
| _pkgctl_release_args_r_opts() { _pkgctl_release_args__repo_opts; } | ||||
| _pkgctl_release_opts() { _filedir -d; } | ||||
|  | ||||
| _pkgctl_aur_cmds=( | ||||
| 	drop-from-repo | ||||
| ) | ||||
|  | ||||
| _pkgctl_aur_drop_from_repo_args=( | ||||
| 	--no-disown | ||||
| 	-f --force | ||||
| 	-h --help | ||||
| ) | ||||
| _pkgctl_aur_drop_from_repo_opts() { _filedir -d; } | ||||
|  | ||||
|  | ||||
| _pkgctl_repo_cmds=( | ||||
| 	clean | ||||
| 	clone | ||||
| 	configure | ||||
| 	create | ||||
| @@ -327,12 +280,6 @@ _pkgctl_repo_clone_args__jobs_opts() { :; } | ||||
| _pkgctl_repo_clone_args_j_opts() { _pkgctl_repo_clone_args__jobs_opts; } | ||||
| _pkgctl_repo_clone_opts() { _devtools_completions_all_packages; } | ||||
|  | ||||
| _pkgctl_repo_clean_args=( | ||||
| 	-i --interactive | ||||
| 	-n --dry-run | ||||
| 	-h --help | ||||
| ) | ||||
| _pkgctl_repo_clean_opts() { _filedir -d; } | ||||
|  | ||||
| _pkgctl_repo_configure_args=( | ||||
| 	--protocol | ||||
| @@ -350,6 +297,7 @@ _pkgctl_repo_create_args=( | ||||
| 	-h --help | ||||
| ) | ||||
|  | ||||
|  | ||||
| _pkgctl_repo_switch_args=( | ||||
| 	--discard-changes | ||||
| 	-f --force | ||||
| @@ -367,62 +315,13 @@ _pkgctl_repo_switch_opts() { | ||||
| 	fi | ||||
| } | ||||
|  | ||||
| _pkgctl_version_cmds=( | ||||
| 	check | ||||
| 	setup | ||||
| 	upgrade | ||||
| ) | ||||
|  | ||||
| _pkgctl_version_check_args=( | ||||
| 	-v --verbose | ||||
| 	-h --help | ||||
| 	--json | ||||
| 	-F --format | ||||
| ) | ||||
|  | ||||
| _pkgctl_version_check_opts() { _filedir -d; } | ||||
| _pkgctl_version_check_args__format_opts() { _devtools_completions_version_output_format; } | ||||
| _pkgctl_version_check_args_F_opts() { _devtools_completions_version_output_format; } | ||||
|  | ||||
| _pkgctl_version_setup_args=( | ||||
| 	--prefer-platform-api | ||||
| 	--url | ||||
| 	--no-check | ||||
| 	--no-upstream | ||||
| 	-f --force | ||||
| 	-h --help | ||||
| ) | ||||
|  | ||||
| _pkgctl_version_setup_opts() { _filedir -d; } | ||||
| _pkgctl_version_setup_args__url_opts() { :; } | ||||
|  | ||||
| _pkgctl_version_upgrade_args=( | ||||
| 	--no-update-checksums | ||||
| 	-v --verbose | ||||
| 	-h --help | ||||
| ) | ||||
|  | ||||
| _pkgctl_version_upgrade_opts() { _filedir -d; } | ||||
|  | ||||
| _pkgctl_repo_web_args=( | ||||
| 	--print | ||||
| 	-h --help | ||||
| ) | ||||
| _pkgctl_repo_web_opts() { _filedir -d; } | ||||
|  | ||||
|  | ||||
| _pkgctl_search_args=( | ||||
| 	--no-default-filter | ||||
| 	--json | ||||
| 	-F --format | ||||
| 	-N --no-line-number | ||||
| 	-h --help | ||||
| ) | ||||
| _pkgctl_search_opts() { :; } | ||||
| _pkgctl_search_args__format_opts() { _devtools_completions_search_format; } | ||||
| _pkgctl_search_args_F_opts() { _devtools_completions_search_format; } | ||||
|  | ||||
|  | ||||
| _pkgctl_diff_args=( | ||||
| 	-l --list | ||||
| 	-d --diffoscope | ||||
| @@ -446,185 +345,6 @@ _pkgctl_diff_args__pool_opts() { _filedir -d; } | ||||
| _pkgctl_diff_args_P_opts() { _pkgctl_diff_args__pool_opts; } | ||||
| _pkgctl_diff_opts() { _devtools_completions_all_packages; } | ||||
|  | ||||
| _pkgctl_issue_cmds=( | ||||
| 	close | ||||
| 	comment | ||||
| 	create | ||||
| 	edit | ||||
| 	list | ||||
| 	move | ||||
| 	reopen | ||||
| 	view | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_args=( | ||||
| 	-h --help | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_close_args=( | ||||
| 	-p --package | ||||
| 	-m --message | ||||
| 	-e --edit | ||||
| 	-r --resolution | ||||
| 	-h --help | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_close_opts() { :; } | ||||
| _pkgctl_issue_close_args__package_opts() { _devtools_completions_all_packages; } | ||||
| _pkgctl_issue_close_args_p_opts() { _pkgctl_issue_close_args__package_opts; } | ||||
| _pkgctl_issue_close_args__message_opts() { :; } | ||||
| _pkgctl_issue_close_args_m_opts() { _pkgctl_issue_close_args__message_opts; } | ||||
| _pkgctl_issue_close_args__resolution_opts() { _devtools_completions_issue_resolution; } | ||||
| _pkgctl_issue_close_args_r_opts() { _pkgctl_issue_close_args__resolution_opts; } | ||||
|  | ||||
| _pkgctl_issue_comment_args=( | ||||
| 	-p --package | ||||
| 	-m --message | ||||
| 	-e --edit | ||||
| 	-h --help | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_comment_opts() { :; } | ||||
| _pkgctl_issue_comment_args__package_opts() { _devtools_completions_all_packages; } | ||||
| _pkgctl_issue_comment_args_p_opts() { _pkgctl_issue_comment_args__package_opts; } | ||||
| _pkgctl_issue_comment_args__message_opts() { :; } | ||||
| _pkgctl_issue_comment_args_m_opts() { _pkgctl_issue_comment_args__message_opts; } | ||||
|  | ||||
| _pkgctl_issue_create_args=( | ||||
| 	-p --package | ||||
| 	-t --title | ||||
| 	-F --file | ||||
| 	-e --edit | ||||
| 	-w --web | ||||
| 	--recover | ||||
| 	--confidentiality | ||||
| 	--priority | ||||
| 	--scope | ||||
| 	--severity | ||||
| 	--status | ||||
| 	-h --help | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_create_opts() { :; } | ||||
| _pkgctl_issue_create_args__package_opts() { _devtools_completions_all_packages; } | ||||
| _pkgctl_issue_create_args_p_opts() { _pkgctl_issue_create_args__package_opts; } | ||||
| _pkgctl_issue_create_args__title_opts() { :; } | ||||
| _pkgctl_issue_create_args_t_opts() { _pkgctl_issue_create_args__title_opts; } | ||||
| _pkgctl_issue_create_args__confidentiality_opts() { _devtools_completions_issue_confidentiality; } | ||||
| _pkgctl_issue_create_args__priority_opts() { _devtools_completions_issue_priority; } | ||||
| _pkgctl_issue_create_args__scope_opts() { _devtools_completions_issue_scope; } | ||||
| _pkgctl_issue_create_args__severity_opts() { _devtools_completions_issue_severity; } | ||||
| _pkgctl_issue_create_args__status_opts() { _devtools_completions_issue_status; } | ||||
|  | ||||
| _pkgctl_issue_edit_args=( | ||||
| 	-p --package | ||||
| 	-t --title | ||||
| 	-e --edit | ||||
| 	--recover | ||||
| 	--confidentiality | ||||
| 	--priority | ||||
| 	--resolution | ||||
| 	--scope | ||||
| 	--severity | ||||
| 	--status | ||||
| 	-h --help | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_edit_opts() { :; } | ||||
| _pkgctl_issue_edit_args__package_opts() { _devtools_completions_all_packages; } | ||||
| _pkgctl_issue_edit_args_p_opts() { _pkgctl_issue_edit_args__package_opts; } | ||||
| _pkgctl_issue_edit_args__title_opts() { :; } | ||||
| _pkgctl_issue_edit_args_t_opts() { _pkgctl_issue_edit_args__title_opts; } | ||||
| _pkgctl_issue_edit_args__confidentiality_opts() { _devtools_completions_issue_confidentiality; } | ||||
| _pkgctl_issue_edit_args__priority_opts() { _devtools_completions_issue_priority; } | ||||
| _pkgctl_issue_edit_args__resolution_opts() { _devtools_completions_issue_resolution; } | ||||
| _pkgctl_issue_edit_args__scope_opts() { _devtools_completions_issue_scope; } | ||||
| _pkgctl_issue_edit_args__severity_opts() { _devtools_completions_issue_severity; } | ||||
| _pkgctl_issue_edit_args__status_opts() { _devtools_completions_issue_status; } | ||||
|  | ||||
| _pkgctl_issue_list_args=( | ||||
| 	-g --group | ||||
| 	-w --web | ||||
| 	-A --all | ||||
| 	-c --closed | ||||
| 	-U --unconfirmed | ||||
| 	--search | ||||
| 	--in | ||||
| 	-l --label | ||||
| 	--confidentiality | ||||
| 	--priority | ||||
| 	--resolution | ||||
| 	--scope | ||||
| 	--severity | ||||
| 	--status | ||||
| 	--assignee | ||||
| 	--assigned-to-me | ||||
| 	--author | ||||
| 	--created-by-me | ||||
| 	-h --help | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_list_opts() { _devtools_completions_all_packages; } | ||||
| _pkgctl_issue_list_args__search_opts() { :; } | ||||
| _pkgctl_issue_list_args__in_opts() { _devtools_completions_issue_search_location; } | ||||
| _pkgctl_issue_list_args__label_opts() { :; } | ||||
| _pkgctl_issue_list_args_l_opts() { _pkgctl_issue_list_args__label_opts; } | ||||
| _pkgctl_issue_list_args__confidentiality_opts() { _devtools_completions_issue_confidentiality; } | ||||
| _pkgctl_issue_list_args__priority_opts() { _devtools_completions_issue_priority; } | ||||
| _pkgctl_issue_list_args__resolution_opts() { _devtools_completions_issue_resolution; } | ||||
| _pkgctl_issue_list_args__scope_opts() { _devtools_completions_issue_scope; } | ||||
| _pkgctl_issue_list_args__severity_opts() { _devtools_completions_issue_severity; } | ||||
| _pkgctl_issue_list_args__status_opts() { _devtools_completions_issue_status; } | ||||
| _pkgctl_issue_list_args__assignee_opts() { :; } | ||||
| _pkgctl_issue_list_args__author_opts() { :; } | ||||
|  | ||||
| _pkgctl_issue_move_args=( | ||||
| 	-p --package | ||||
| 	-m --message | ||||
| 	-e --edit | ||||
| 	-h --help | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_move_opts() { | ||||
| 	local subcommand args | ||||
| 	subcommand=(repo switch) | ||||
| 	args=$(__pkgctl_word_count_after_subcommand "${subcommand[@]}") | ||||
|  | ||||
| 	if (( args == 0 )); then | ||||
| 		: | ||||
| 	elif (( args >= 1 )); then | ||||
| 		_devtools_completions_all_packages | ||||
| 	fi | ||||
| } | ||||
| _pkgctl_issue_move_args__package_opts() { _devtools_completions_all_packages; } | ||||
| _pkgctl_issue_move_args_p_opts() { _pkgctl_issue_move_args__package_opts; } | ||||
| _pkgctl_issue_move_args__message_opts() { :; } | ||||
| _pkgctl_issue_move_args_m_opts() { _pkgctl_issue_move_args__message_opts; } | ||||
|  | ||||
| _pkgctl_issue_reopen_args=( | ||||
| 	-p --package | ||||
| 	-m --message | ||||
| 	-e --edit | ||||
| 	-h --help | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_reopen_opts() { :; } | ||||
| _pkgctl_issue_reopen_args__package_opts() { _devtools_completions_all_packages; } | ||||
| _pkgctl_issue_reopen_args_p_opts() { _pkgctl_issue_reopen_args__package_opts; } | ||||
| _pkgctl_issue_reopen_args__message_opts() { :; } | ||||
| _pkgctl_issue_reopen_args_m_opts() { _pkgctl_issue_reopen_args__message_opts; } | ||||
|  | ||||
| _pkgctl_issue_view_args=( | ||||
| 	-p --package | ||||
| 	-c --comments | ||||
| 	-w --web | ||||
| 	-h --help | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_view_opts() { :; } | ||||
| _pkgctl_issue_view_args__package_opts() { _devtools_completions_all_packages; } | ||||
| _pkgctl_issue_view_args_p_opts() { _pkgctl_issue_view_args__package_opts; } | ||||
|  | ||||
|  | ||||
| _pkgctl_version_args=( | ||||
| 	-h --help | ||||
| @@ -635,17 +355,14 @@ _devtools_completions_color() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${_colors[*]}" -- "$cur") | ||||
| } | ||||
| _devtools_completions_arch() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${DEVTOOLS_VALID_ARCHES[*]}" -- "$cur") | ||||
| } | ||||
| _devtools_completions_binary_arch() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${DEVTOOLS_VALID_BINARY_ARCHES[*]}" -- "$cur") | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${_arch[*]}" -- "$cur") | ||||
| } | ||||
| _devtools_completions_repo() { | ||||
| 	local optional=${1:-} | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${optional} ${DEVTOOLS_VALID_REPOS[*]}" -- "$cur") | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${optional} ${_repos[*]}" -- "$cur") | ||||
| } | ||||
| _devtools_completions_build_repo() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${DEVTOOLS_VALID_BUILDREPOS[*]}" -- "$cur") | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${_build_repos[*]}" -- "$cur") | ||||
| } | ||||
| _devtools_completions_all_packages() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "$(pacman -Sql)" -- "$cur") | ||||
| @@ -653,36 +370,6 @@ _devtools_completions_all_packages() { | ||||
| _devtools_completions_protocol() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "https" -- "$cur") | ||||
| } | ||||
| _devtools_completions_inspect() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${DEVTOOLS_VALID_INSPECT_MODES[*]}" -- "$cur") | ||||
| } | ||||
| _devtools_completions_search_format() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${valid_search_output_format[*]}" -- "$cur") | ||||
| } | ||||
| _devtools_completions_version_output_format() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${DEVTOOLS_VALID_VERSION_OUTPUT_FORMAT[*]}" -- "$cur") | ||||
| } | ||||
| _devtools_completions_issue_severity() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${DEVTOOLS_VALID_ISSUE_SEVERITY[*]}" -- "$cur") | ||||
| } | ||||
| _devtools_completions_issue_status() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${DEVTOOLS_VALID_ISSUE_STATUS[*]}" -- "$cur") | ||||
| } | ||||
| _devtools_completions_issue_scope() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${DEVTOOLS_VALID_ISSUE_SCOPE[*]}" -- "$cur") | ||||
| } | ||||
| _devtools_completions_issue_search_location() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${DEVTOOLS_VALID_ISSUE_SEARCH_LOCATION[*]}" -- "$cur") | ||||
| } | ||||
| _devtools_completions_issue_resolution() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${DEVTOOLS_VALID_ISSUE_RESOLUTION[*]}" -- "$cur") | ||||
| } | ||||
| _devtools_completions_issue_priority() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${DEVTOOLS_VALID_ISSUE_PRIORITY[*]}" -- "$cur") | ||||
| } | ||||
| _devtools_completions_issue_confidentiality() { | ||||
| 	mapfile -t COMPREPLY < <(compgen -W "${DEVTOOLS_VALID_ISSUE_CONFIDENTIALITY[*]}" -- "$cur") | ||||
| } | ||||
|  | ||||
| __devtools_complete() { | ||||
| 	local service=$1 | ||||
|   | ||||
| @@ -3,21 +3,12 @@ | ||||
| # SPDX-License-Identifier: GPL-3.0-or-later | ||||
|  | ||||
| _DEVTOOLS_LIBRARY_DIR=${_DEVTOOLS_LIBRARY_DIR:-@pkgdatadir@} | ||||
| # shellcheck source=src/lib/valid-build-install.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-build-install.sh | ||||
| # shellcheck source=src/lib/valid-tags.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-tags.sh | ||||
| # shellcheck source=src/lib/valid-repos.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-repos.sh | ||||
| # shellcheck source=src/lib/valid-inspect.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-inspect.sh | ||||
| # shellcheck source=src/lib/valid-search.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-search.sh | ||||
| # shellcheck source=src/lib/valid-version.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-version.sh | ||||
| # shellcheck source=src/lib/valid-issue.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-issue.sh | ||||
|  | ||||
| _binary_arch=${_arch[*]:0:-1} | ||||
| _colors=(never always auto) | ||||
|  | ||||
| _archbuild_args=( | ||||
| @@ -44,21 +35,18 @@ _pkgctl_auth_status_args=( | ||||
| ) | ||||
|  | ||||
| _pkgctl_build_args=( | ||||
| 	"--arch[Specify architectures to build for (disables auto-detection)]:arch:($DEVTOOLS_VALID_BINARY_ARCHES[*])" | ||||
| 	"--repo[Specify a target repository (disables auto-detection)]:repo:($DEVTOOLS_VALID_REPOS[*])" | ||||
| 	"--arch=[Specify architectures to build for (disables auto-detection)]:arch:($_arch[*])" | ||||
| 	"--repo=[Specify a target repository (disables auto-detection)]:repo:($_repos[*])" | ||||
| 	'(-s --staging)'{-s,--staging}'[Build against the staging counterpart of the auto-detected repo]' | ||||
| 	'(-t --testing)'{-t,--testing}'[Build against the testing counterpart of the auto-detected repo]' | ||||
| 	'(-o --offload)'{-o,--offload}'[Build on a remote server and transfer artifacts afterwards]' | ||||
| 	'(-c --clean)'{-c,--clean}'[Recreate the chroot before building]' | ||||
| 	"--inspect[Spawn an interactive shell to inspect the chroot (never, always, failure)]:inspect:($DEVTOOLS_VALID_INSPECT_MODES[*])" | ||||
| 	'*'{-I,--install-to-chroot}'[Install a package to the working copy of the chroot]:target:_files -g "*.pkg.tar.*(.)"' | ||||
| 	'*'{-i,--install-to-host}"[Install the built packages to the host system]:mode:($DEVTOOLS_VALID_BUILD_INSTALL[*])" | ||||
| 	'(-I --install)'{-I,--install}'[Install a package into the working copy of the chroot]:target:_files -g "*.pkg.tar.*(.)"' | ||||
| 	'(-w --worker)'{-w,--worker}'[Name of the worker slot, useful for concurrent builds (disables auto-detection)]:slot:' | ||||
| 	'--nocheck[Do not run the check() function in the PKGBUILD]' | ||||
| 	'--pkgver=[Set pkgver, reset pkgrel and update checksums]:pkgver:' | ||||
| 	'--pkgrel=[Set pkgrel to a given value]:pkgrel:' | ||||
| 	'--rebuild[Increment the pkgrel variable]' | ||||
| 	'--update-checksums[Force computation and update of the checksums (disables auto-detection)]' | ||||
| 	'(-e --edit)'{-e,--edit}'[Edit the PKGBUILD before building]' | ||||
| 	'(-r --release)'{-r,--release}'[Automatically commit, tag and release after building]' | ||||
| 	'(-m --message=)'{-m,--message=}"[Use the given <msg> as the commit message]:message:" | ||||
| @@ -76,17 +64,15 @@ _pkgctl_db_cmds=( | ||||
|  | ||||
| _pkgctl_db_move_args=( | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	"1:src-repo:($DEVTOOLS_VALID_REPOS[*])" | ||||
| 	"2:target-repo:($DEVTOOLS_VALID_REPOS[*])" | ||||
| 	"1:src-repo:($_repos[*])" | ||||
| 	"2:target-repo:($_repos[*])" | ||||
| 	'*:pkgbase:_devtools_completions_all_packages' | ||||
| ) | ||||
|  | ||||
| _pkgctl_db_remove_args=( | ||||
| 	'--partial[Remove only partial pkgnames from a split package]' | ||||
| 	'--noconfirm[Bypass any confirmation messages, should only be used with caution]' | ||||
| 	'(-a --arch)'{-a,--arch}"[Override the architecture (disables auto-detection)]:arch:($DEVTOOLS_VALID_BINARY_ARCHES[*])" | ||||
| 	'(-a --arch=)'{-a,--arch=}"[Override the architecture (disables auto-detection)]:arch:($_arch[*])" | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	"1:repo:($DEVTOOLS_VALID_REPOS[*])" | ||||
| 	"1:repo:($_repos[*])" | ||||
| 	'*:pkgbase:_devtools_completions_all_packages' | ||||
| ) | ||||
|  | ||||
| @@ -94,115 +80,9 @@ _pkgctl_db_update_args=( | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_cmds=( | ||||
| 	"pkgctl issue command" | ||||
| 	"close[Close an issue]" | ||||
| 	"comment[Comment on an issue]" | ||||
| 	"create[Create a new issue]" | ||||
| 	"edit[Edit and modify an issue]" | ||||
| 	"list[List project or group issues]" | ||||
| 	"move[Move an issue to another project]" | ||||
| 	"reopen[Reopen a closed issue]" | ||||
| 	"view[Display information about an issue]" | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_close_args=( | ||||
| 	'(-p --package)'{-p,--package}'[Interact with <pkgbase> instead of the current directory]:pkgbase:_devtools_completions_all_packages' | ||||
| 	'(-m --message)'{-m,--message}'[Use the provided message as the comment]:message:' | ||||
| 	'(-e --edit)'{-e,--edit}'[Edit the comment using an editor]' | ||||
| 	'(-r --resolution)'{-r,--resolution}"[Set a specific resolution label]:resolution:($DEVTOOLS_VALID_ISSUE_RESOLUTION[*])" | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	"1:issue_iid:" | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_comment_args=( | ||||
| 	'(-p --package)'{-p,--package}'[Interact with <pkgbase> instead of the current directory]:pkgbase:_devtools_completions_all_packages' | ||||
| 	'(-m --message)'{-m,--message}'[Use the provided message as the comment]:message:' | ||||
| 	'(-e --edit)'{-e,--edit}'[Edit the comment using an editor]' | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	"1:issue_iid:" | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_create_args=( | ||||
| 	'(-p --package)'{-p,--package}'[Interact with <pkgbase> instead of the current directory]:pkgbase:_devtools_completions_all_packages' | ||||
| 	'(-t --title)'{-t,--title}'[Use the provided title for the issue]:title:' | ||||
| 	'(-F --file)'{-F,--file}'[Take issue description from <file>]:file:_files' | ||||
| 	'(-e --edit)'{-e,--edit}'[Edit the issue title and description using an editor]' | ||||
| 	'(-w --web)'{-w,--web}'[Continue issue creation with the web interface]' | ||||
| 	"--recover[Automatically recover from a failed run]" | ||||
| 	"--confidentiality[Set the issue confidentiality]:confidential:($DEVTOOLS_VALID_ISSUE_CONFIDENTIALITY[*])" | ||||
| 	"--priority[Set the priority label]:priority:($DEVTOOLS_VALID_ISSUE_PRIORITY[*])" | ||||
| 	"--scope[Set the scope label]:scope:($DEVTOOLS_VALID_ISSUE_SCOPE[*])" | ||||
| 	"--severity[Set the severity label]:severity:($DEVTOOLS_VALID_ISSUE_SEVERITY[*])" | ||||
| 	"--status[Set the status label]:status:($DEVTOOLS_VALID_ISSUE_STATUS[*])" | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_edit_args=( | ||||
| 	'(-p --package)'{-p,--package}'[Interact with <pkgbase> instead of the current directory]:pkgbase:_devtools_completions_all_packages' | ||||
| 	'(-t --title)'{-t,--title}'[Use the provided title for the issue]:title:' | ||||
| 	'(-e --edit)'{-e,--edit}'[Edit the issue title and description using an editor]' | ||||
| 	"--recover[Automatically recover from a failed run]" | ||||
| 	"--confidentiality[Set the issue confidentiality]:confidential:($DEVTOOLS_VALID_ISSUE_CONFIDENTIALITY[*])" | ||||
| 	"--priority[Set the priority label]:priority:($DEVTOOLS_VALID_ISSUE_PRIORITY[*])" | ||||
| 	"--resolution[Set the resolution label]:resolution:($DEVTOOLS_VALID_ISSUE_RESOLUTION[*])" | ||||
| 	"--scope[Set the scope label]:scope:($DEVTOOLS_VALID_ISSUE_SCOPE[*])" | ||||
| 	"--severity[Set the severity label]:severity:($DEVTOOLS_VALID_ISSUE_SEVERITY[*])" | ||||
| 	"--status[Set the status label]:status:($DEVTOOLS_VALID_ISSUE_STATUS[*])" | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	"1:issue_iid:" | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_list_args=( | ||||
| 	'(-g --group)'{-g,--group}'[Get issues from the whole packaging subgroup]' | ||||
| 	'(-w --web)'{-w,--web}'[View results in a browser]' | ||||
| 	'(-A --all)'{-A,--all}'[Get all issues including closed]' | ||||
| 	'(-c --closed)'{-c,--closed}'[Get only closed issues]' | ||||
| 	'(-U --unconfirmed)'{-U,--unconfirmed}'[Shorthand to filter by unconfirmed status label]' | ||||
| 	'--search[Search in the fields defined by --in]:search:' | ||||
| 	"--in[Search in title or description]:location:($DEVTOOLS_VALID_ISSUE_SEARCH_LOCATION[*])" | ||||
| 	"--confidentiality[Filter by confidentiality]:confidential:($DEVTOOLS_VALID_ISSUE_CONFIDENTIALITY[*])" | ||||
| 	"--priority[Shorthand to filter by priority label]:priority:($DEVTOOLS_VALID_ISSUE_PRIORITY[*])" | ||||
| 	"--resolution[Shorthand to filter by resolution label]:resolution:($DEVTOOLS_VALID_ISSUE_RESOLUTION[*])" | ||||
| 	"--scope[Shorthand to filter by scope label]:scope:($DEVTOOLS_VALID_ISSUE_SCOPE[*])" | ||||
| 	"--severity[Shorthand to filter by severity label]:severity:($DEVTOOLS_VALID_ISSUE_SEVERITY[*])" | ||||
| 	"--status[Shorthand to filter by status label]:status:($DEVTOOLS_VALID_ISSUE_STATUS[*])" | ||||
| 	'--assignee[Filter issues assigned to the given username]:username:' | ||||
| 	'--assigned-to-me[Shorthand to filter issues assigned to you]' | ||||
| 	'--author[Filter issues authored by the given username]:username:' | ||||
| 	'--created-by-me[Shorthand to filter issues created by you]' | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	'*:pkgbase:_devtools_completions_all_packages' | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_move_args=( | ||||
| 	'(-p --package)'{-p,--package}'[Interact with <pkgbase> instead of the current directory]:pkgbase:_devtools_completions_all_packages' | ||||
| 	'(-m --message)'{-m,--message}'[Use the provided message as the comment]:message:' | ||||
| 	'(-e --edit)'{-e,--edit}'[Edit the comment using an editor]' | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	"1:issue_iid:" | ||||
| 	'1:pkgbase:_devtools_completions_all_packages' | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_reopen_args=( | ||||
| 	'(-p --package)'{-p,--package}'[Interact with <pkgbase> instead of the current directory]:pkgbase:_devtools_completions_all_packages' | ||||
| 	'(-m --message)'{-m,--message}'[Use the provided message as the comment]:message:' | ||||
| 	'(-e --edit)'{-e,--edit}'[Edit the comment using an editor]' | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	"1:issue_iid:" | ||||
| ) | ||||
|  | ||||
| _pkgctl_issue_view_args=( | ||||
| 	'(-p --package)'{-p,--package}'[Interact with <pkgbase> instead of the current directory]:pkgbase:_devtools_completions_all_packages' | ||||
| 	'(-c --comments)'{-c,--comments}'[Show issue comments and activities]' | ||||
| 	'(-w --web)'{-w,--web}'[View results in a browser]' | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	"1:issue_iid:" | ||||
| ) | ||||
|  | ||||
| _pkgctl_release_args=( | ||||
| 	'(-m --message=)'{-m,--message=}"[Use the given <msg> as the commit message]:message:" | ||||
| 	'(-r --repo)'{-r,--repo}"[Specify a target repository for new packages]:repo:($DEVTOOLS_VALID_REPOS[*])" | ||||
| 	'(-r --repo=)'{-r,--repo=}"[Specify a target repository (disables auto-detection)]:repo:($_repos[*])" | ||||
| 	'(-s --staging)'{-s,--staging}'[Release to the staging counterpart of the auto-detected repo]' | ||||
| 	'(-t --testing)'{-t,--testing}'[Release to the testing counterpart of the auto-detected repo]' | ||||
| 	'(-u --db-update)'{-u,--db-update}'[Automatically update the pacman database after uploading]' | ||||
| @@ -210,21 +90,8 @@ _pkgctl_release_args=( | ||||
| 	'*:git_dir:_files -/' | ||||
| ) | ||||
|  | ||||
| _pkgctl_aur_cmds=( | ||||
| 	"pkgctl aur command" | ||||
| 	"drop-from-repo[Drop a package from the official repository to the AUR]" | ||||
| ) | ||||
|  | ||||
| _pkgctl_aur_drop_from_repo_args=( | ||||
| 	'(-f --force)'{-f,--force}'[Force push to the AUR overwriting the remote repository]' | ||||
| 	'--no-disown[Do not disown the package on the AUR]' | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	'*:git_dir:_files -/' | ||||
| ) | ||||
|  | ||||
| _pkgctl_repo_cmds=( | ||||
| 	"pkgctl repo command" | ||||
| 	"clean[Remove untracked files from the working tree]" | ||||
| 	"clone[Clone a package repository]" | ||||
| 	"configure[Configure a clone according to distro specs]" | ||||
| 	"create[Create a new GitLab package repository]" | ||||
| @@ -239,13 +106,6 @@ _pkgctl_repo_switch_args=( | ||||
| 	'*:git_dir:_files -/' | ||||
| ) | ||||
|  | ||||
| _pkgctl_repo_clean_args=( | ||||
| 	'(-i --interactive)'{-i,--interactive}'[Show what would be done and clean files interactively]' | ||||
| 	'(-n --dry-run)'{-n,--dry-run}"[Don't remove anything, just show what would be done]" | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	'*:git_dir:_files -/' | ||||
| ) | ||||
|  | ||||
| _pkgctl_repo_clone_args=( | ||||
| 	'(-m --maintainer=)'{-m,--maintainer=}'[Clone all packages of the named maintainer]:maintainer:' | ||||
| 	'--protocol[Clone the repository over https]:proto:(https)' | ||||
| @@ -270,25 +130,15 @@ _pkgctl_repo_create_args=( | ||||
| ) | ||||
|  | ||||
| _pkgctl_repo_web_args=( | ||||
| 	'--print[Print the url instead of opening it with xdg-open]' | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	'*:git_dir:_files -/' | ||||
| ) | ||||
|  | ||||
| _pkgctl_search_args=( | ||||
| 	'--no-default-filter[Do not apply default filter (like -path:keys/pgp/*.asc)]' | ||||
| 	'--json[Enable printing results in JSON]' | ||||
| 	'(-F --format)'{-F,--format}"[Controls the formatting of the results]:format:($valid_search_output_format[*])" | ||||
| 	'(-N --no-line-number)'{-N,--no-line-number}"[Don't show line numbers when formatting results]" | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	'1:query' | ||||
| ) | ||||
|  | ||||
| _arch_nspawn_args=( | ||||
| 	'-C[Location of a pacman config file]:pacman_config:_files -g "*.conf(.)"' | ||||
| 	'-M[Location of a makepkg config file]:makepkg_config:_files -g "*.conf(.)"' | ||||
| 	'*-c[Set pacman cache]:pacman_cache:_files -/' | ||||
| 	'*-f[Copy file from the host to the chroot]:copy_file:_files' | ||||
| 	'-c[Set pacman cache]:pacman_cache:_files -/' | ||||
| 	'-f[Copy file from the host to the chroot]:copy_file:_files' | ||||
| 	'-s[Do not run setarch]' | ||||
| 	'-h[Display usage]' | ||||
| 	'1:chroot_dir:_files -/' | ||||
| @@ -296,14 +146,14 @@ _arch_nspawn_args=( | ||||
|  | ||||
| _archrelease_args=( | ||||
| 	'-f[Force release without checks]' | ||||
| 	"*:arch:($DEVTOOLS_VALID_TAGS[*])" | ||||
| 	"*:arch:($_tags[*])" | ||||
| ) | ||||
|  | ||||
| _commitpkg_args=( | ||||
| 	'-f[Force release without checks]' | ||||
| 	'-s[Target repo server]' | ||||
| 	'-l[Set bandwidth limit]:limit' | ||||
| 	"-a[Release to a specific architecture only]:arch:($DEVTOOLS_VALID_ARCHES[*])" | ||||
| 	"-a[Release to a specific architecture only]:arch:($_arch[*])" | ||||
| 	'1:commit_msg' | ||||
| ) | ||||
|  | ||||
| @@ -330,17 +180,15 @@ _finddeps_args=( | ||||
| _makechrootpkg_args=( | ||||
| 	'-h[Display usage]' | ||||
| 	'-c[Clean the chroot before building]' | ||||
| 	'*-d[Bind directory into build chroot as read-write]:bind_dir_rw:_files -/' | ||||
| 	'*-D[Bind directory into build chroot as read-only]:bind_dir_ro:_files -/' | ||||
| 	'*-t[Mount a tmpfs at directory]:tmpfs_dir:_files -/' | ||||
| 	'-d[Bind directory into build chroot as read-write]:bind_dir_rw:_files -/' | ||||
| 	'-D[Bind directory into build chroot as read-only]:bind_dir_ro:_files -/' | ||||
| 	'-u[Update the working copy of the chroot before building]' | ||||
| 	'-r[The chroot dir to use]:chroot_dir:_files -/' | ||||
| 	'*-I[Install a package into the working copy]:target:_files -g "*.pkg.tar.*(.)"' | ||||
| 	'-I[Install a package into the working copy]:target:_files -g "*.pkg.tar.*(.)"' | ||||
| 	'-l[The directory to use as the working copy]:copy_dir:_files -/' | ||||
| 	'-n[Run namcap on the package]' | ||||
| 	'-T[Build in a temporary directory]' | ||||
| 	'-U[Run makepkg as a specified user]:makepkg_user' | ||||
| 	"-x[Spawn an interactive shell to inspect the chroot (never, always, failure)]:inspect:($DEVTOOLS_VALID_INSPECT_MODES[*])" | ||||
| ) | ||||
|  | ||||
| _mkarchroot_args=( | ||||
| @@ -348,7 +196,6 @@ _mkarchroot_args=( | ||||
| 	'-C[Location of a pacman config file]:pacman_config:_files -g "*.conf(.)"' | ||||
| 	'-M[Location of a makepkg config file]:makepkg_config:_files -g "*.conf(.)"' | ||||
| 	'-c[Set pacman cache]:pacman_cache:_files -/' | ||||
| 	'-f[Copy src file from the host to the chroot]:target:_files -/' | ||||
| 	'-h[Display usage]' | ||||
| 	'1:working_dir:_files -/' | ||||
| 	'*:packages:_devtools_completions_all_packages' | ||||
| @@ -365,20 +212,19 @@ _sogrep_args=( | ||||
| 	'(-v --verbose)'{-v,--verbose}'[Show matched links in addition to pkgname]' | ||||
| 	'(-r --refresh)'{-r,--refresh}'[Refresh the links databases]' | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	'1:repo:(all $DEVTOOLS_VALID_REPOS[*])' | ||||
| 	'1:repo:(all $_repos[*])' | ||||
| 	'2:libname' | ||||
| ) | ||||
|  | ||||
| _offload_build_args=( | ||||
| 	'(-r --repo)'{-r,--repo}'[Build against a specific repository]:repo:($DEVTOOLS_VALID_BUILDREPOS[*])' | ||||
| 	'(-a --arch)'{-a,--arch}'[Build against a specific architecture]:arch:(${DEVTOOLS_VALID_BINARY_ARCHES[*]})' | ||||
| 	'(-r --repo)'{-r,--repo}'[Build against a specific repository]:repo:($_build_repos[*])' | ||||
| 	'(-a --arch)'{-a,--arch}'[Build against a specific architecture]:arch:(${_binary_arch[*]})' | ||||
| 	'(-s --server)'{-s,--server}'[Offload to a specific Build server]:server:' | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| ) | ||||
|  | ||||
| _makerepropkg_args=( | ||||
| 	'-d[Run diffoscope if the package is unreproducible]' | ||||
| 	'-n[Do not run the check() function in the PKGBUILD]' | ||||
| 	'-c[Set pacman cache]:pacman_cache:_files -/' | ||||
| 	'-M[Location of a makepkg config file]:makepkg_config:_files -g "*.conf(.)"' | ||||
| 	'-h[Display usage]' | ||||
| @@ -393,16 +239,13 @@ _devtools_completions_all_packages() { | ||||
|  | ||||
| _pkgctl_cmds=( | ||||
| 	"pkgctl command" | ||||
| 	"aur[Interact with the Arch User Repository (AUR)]" | ||||
| 	"auth[Authenticate with services like GitLab]" | ||||
| 	"build[Build packages inside a clean chroot]" | ||||
| 	"db[Pacman database modification for package update, move etc]" | ||||
| 	"diff[Compare package files using different modes]" | ||||
| 	"issue[Work with GitLab packaging issues]" | ||||
| 	"release[Release step to commit, tag and upload build artifacts]" | ||||
| 	"repo[Manage Git packaging repositories and their configuration]" | ||||
| 	"search[Search for an expression across the GitLab packaging group]" | ||||
| 	"version[Check and manage package versions against upstream]" | ||||
| 	"version[Show pkgctl version information]" | ||||
| ) | ||||
|  | ||||
| _pkgctl_args=( | ||||
| @@ -410,36 +253,8 @@ _pkgctl_args=( | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| ) | ||||
|  | ||||
| _pkgctl_version_cmds=( | ||||
| 	"pkgctl version command" | ||||
| 	"check[Compares local package versions against upstream versions]" | ||||
| 	"setup[Automatically detect and setup a basic nvchecker config]" | ||||
| 	"upgrade[Adjust the PKGBUILD to match the latest upstream version]" | ||||
| ) | ||||
|  | ||||
| _pkgctl_version_check_args=( | ||||
| _pkgctl_version_args=( | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	'(-v --verbose)'{-v,--verbose}'[Display all results including up-to-date versions]' | ||||
| 	'--json[Enable printing results in JSON]' | ||||
| 	'(-F --format)'{-F,--format}"[Controls the output format of the results]:format:($DEVTOOLS_VALID_VERSION_OUTPUT_FORMAT[*])" | ||||
| 	'*:git_dir:_files -/' | ||||
| ) | ||||
|  | ||||
| _pkgctl_version_setup_args=( | ||||
| 	'(-f --force)'{-f,--force}'[Do not prompt before overwriting]' | ||||
| 	'--prefer-platform-api[Prefer platform specific GitHub/GitLab API for complex cases]' | ||||
| 	'--url[Derive check target from URL instead of source array]:url:' | ||||
| 	'--no-check[Do not run version check after setup]' | ||||
| 	'--no-upstream[Setup a blank config for packages without upstream sources]' | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	'*:git_dir:_files -/' | ||||
| ) | ||||
|  | ||||
| _pkgctl_version_upgrade_args=( | ||||
| 	'--no-update-checksums[Disable computation and update of the checksums]' | ||||
| 	'(-v --verbose)'{-v,--verbose}'[Display results including up-to-date versions]' | ||||
| 	'(-h --help)'{-h,--help}'[Display usage]' | ||||
| 	'*:git_dir:_files -/' | ||||
| ) | ||||
|  | ||||
| _pkgctl_diff_args=("${_diffpkg_args[@]}") | ||||
| @@ -461,7 +276,7 @@ _handle_subcommands() { | ||||
| 				fi | ||||
| 				;; | ||||
| 			args) | ||||
| 				local service_sub=${service_name}_${line[1]//-/_} | ||||
| 				local service_sub=${service_name}_$line[1] | ||||
| 				if typeset -p ${service_sub}_args &> /dev/null; then | ||||
| 					local cmd_args=${service_sub}_args[@] | ||||
| 					_arguments -s "${(P)cmd_args}" | ||||
|   | ||||
							
								
								
									
										37
									
								
								doc/asciidoc.conf
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										37
									
								
								doc/asciidoc.conf
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,37 @@ | ||||
| ## linkman: macro | ||||
| # Inspired by/borrowed from the GIT source tree at Documentation/asciidoc.conf | ||||
| # | ||||
| # Usage: linkman:command[manpage-section] | ||||
| # | ||||
| # Note, {0} is the manpage section, while {target} is the command. | ||||
| # | ||||
| # Show man link as: <command>(<section>); if section is defined, else just show | ||||
| # the command. | ||||
|  | ||||
| [macros] | ||||
| (?su)[\\]?(?P<name>linkman):(?P<target>\S*?)\[(?P<attrlist>.*?)\]= | ||||
|  | ||||
| [attributes] | ||||
| asterisk=* | ||||
| plus=+ | ||||
| caret=^ | ||||
| startsb=[ | ||||
| endsb=] | ||||
| backslash=\ | ||||
| tilde=~ | ||||
| apostrophe=' | ||||
| backtick=` | ||||
| litdd=-- | ||||
|  | ||||
| ifdef::backend-docbook[] | ||||
| [linkman-inlinemacro] | ||||
| {0%{target}} | ||||
| {0#<citerefentry>} | ||||
| {0#<refentrytitle>{target}</refentrytitle><manvolnum>{0}</manvolnum>} | ||||
| {0#</citerefentry>} | ||||
| endif::backend-docbook[] | ||||
|  | ||||
| ifdef::backend-xhtml11[] | ||||
| [linkman-inlinemacro] | ||||
| <a href="{target}.{0}.html">{target}{0?({0})}</a> | ||||
| endif::backend-xhtml11[] | ||||
| @@ -28,9 +28,8 @@ Options | ||||
| *-c* <dir>:: | ||||
| 	Set pacman cache, if no directory is specified the passed pacman.conf's cachedir is used with a fallback to '/etc/pacman.conf' | ||||
|  | ||||
| *-f* <src>[:<dst>]:: | ||||
| 	Copy file from the host to the chroot. | ||||
| 	If 'dst' is not provided, it defaults to 'src' inside of the chroot. | ||||
| *-f* <file>:: | ||||
| 	Copy file from the host to the chroot | ||||
|  | ||||
| *-s*:: | ||||
| 	Do not run setarch | ||||
|   | ||||
| @@ -43,6 +43,6 @@ Options | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| devtools(7) | ||||
| linkman:devtools[7] | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
|   | ||||
| @@ -38,6 +38,6 @@ Options | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| find-libprovides(1) | ||||
| linkman:find-libprovides[1] | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
|   | ||||
| @@ -21,47 +21,47 @@ Programs | ||||
| The list below gives a short overview; see the respective documentation | ||||
| for details. | ||||
|  | ||||
| pkgctl(1) | ||||
| linkman:pkgctl[1] | ||||
| 	Unified command-line frontend for devtools | ||||
|  | ||||
| archbuild(1) | ||||
| linkman:archbuild[1] | ||||
| 	Build an Arch Linux package inside a clean chroot | ||||
|  | ||||
| arch-nspawn(1) | ||||
| linkman:arch-nspawn[1] | ||||
| 	Run a command or OS in a light-weight namespace container | ||||
|  | ||||
| checkpkg(1) | ||||
| linkman:checkpkg[1] | ||||
| 	Compare the current build package with the repository version | ||||
|  | ||||
| diffpkg(1) | ||||
| linkman:diffpkg[1] | ||||
| 	Compare package files using different modes | ||||
|  | ||||
| export-pkgbuild-keys(1) | ||||
| linkman:export-pkgbuild-keys[1] | ||||
| 	Export valid source signing keys from a PKGBUILD | ||||
|  | ||||
| find-libdeps(1) | ||||
| linkman:find-libdeps[1] | ||||
| 	Find soname dependencies for a package | ||||
|  | ||||
| find-libprovides(1) | ||||
| linkman:find-libprovides[1] | ||||
| 	Find soname's which are provided by a package | ||||
|  | ||||
| lddd(1) | ||||
| linkman:lddd[1] | ||||
| 	Find broken library links on your system | ||||
|  | ||||
| mkarchroot(1) | ||||
| linkman:mkarchroot[1] | ||||
| 	Creates an arch chroot in a specified location with a specified set of | ||||
| 	packages | ||||
|  | ||||
| makechrootpkg(1) | ||||
| linkman:makechrootpkg[1] | ||||
| 	Build a PKGBUILD in a given chroot environment | ||||
|  | ||||
| makerepropkg(1) | ||||
| linkman:makerepropkg[1] | ||||
| 	Rebuild a package to see if it is reproducible | ||||
|  | ||||
| offload-build(1) | ||||
| linkman:offload-build[1] | ||||
| 	Build a PKGBUILD on a remote server using makechrootpkg | ||||
|  | ||||
| sogrep(1) | ||||
| linkman:sogrep[1] | ||||
| 	Find packages using a linked to a given shared library | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
|   | ||||
| @@ -20,6 +20,6 @@ collected data is written to a temporary directory created by mktemp. | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| ldd(1) | ||||
| linkman:ldd[1] | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
|   | ||||
| @@ -45,9 +45,6 @@ Options | ||||
| *-D* <dir>:: | ||||
| 	Bind directory into build chroot as read-only | ||||
|  | ||||
| *-t* <dir>[:opts]:: | ||||
| 	Mount a tmpfs at 'dir'. See the '--tmpfs' argument in systemd-nspawn(1) for more details. | ||||
|  | ||||
| *-u*:: | ||||
| 	Update the working copy of the chroot before building | ||||
| 	This is useful for rebuilds without dirtying the pristine | ||||
| @@ -76,12 +73,4 @@ Options | ||||
| *-U*:: | ||||
| 	Run makepkg as a specified user | ||||
|  | ||||
| *-x* <when>:: | ||||
| 	Inspect chroot after build, possible modes are 'never' (default), 'always' or 'failure' | ||||
|  | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| systemd-nspawn(1) | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
|   | ||||
| @@ -16,7 +16,7 @@ Given the path to a built pacman package(s), attempt to rebuild it using the | ||||
| PKGBUILD in the current directory. The package will be built in an environment | ||||
| as closely matching the environment of the initial package as possible, by | ||||
| building up a chroot to match the information exposed in the package's | ||||
| BUILDINFO(5) manifest. On success, the resulting package will be | ||||
| linkman:BUILDINFO[5] manifest. On success, the resulting package will be | ||||
| compared to the input package, and makerepropkg will report whether the | ||||
| artifacts are identical. | ||||
|  | ||||
| @@ -42,9 +42,6 @@ Options | ||||
| *-d*:: | ||||
| 	If packages are not reproducible, compare them using diffoscope. | ||||
|  | ||||
| *-n*:: | ||||
| 	Do not run the check() function in the PKGBUILD. | ||||
|  | ||||
| *-c*:: | ||||
| 	Set the pacman cache directory. | ||||
|  | ||||
|   | ||||
| @@ -32,9 +32,8 @@ Options | ||||
| *-c* <dir>:: | ||||
| 	Set pacman cache. | ||||
|  | ||||
| *-f* <src>[:<dst>]:: | ||||
| *-f* <file>:: | ||||
| 	Copy file from the host to the chroot. | ||||
| 	If 'dst' is not provided, it defaults to 'src' inside of the chroot. | ||||
|  | ||||
| *-s*:: | ||||
| 	Do not run setarch. | ||||
| @@ -45,6 +44,6 @@ Options | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pacman(1) | ||||
| linkman:pacman[1] | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
|   | ||||
| @@ -1,41 +0,0 @@ | ||||
| pkgctl-aur-drop-from-repo(1) | ||||
| ============================ | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-aur-drop-from-repo - Drop a package from the official repository to the AUR | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl aur drop-from-repo [OPTIONS] [PATH]... | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| Drops a specified package from the official repositories to the Arch User | ||||
| Repository. | ||||
|  | ||||
| This command requires a local Git clone of the package repository. It | ||||
| reconfigures the repository for AUR compatibility and pushes it to the | ||||
| AUR. Afterwards, the package is removed from the official repository. | ||||
|  | ||||
| By default, the package is automatically disowned in the AUR. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *--no-disown*:: | ||||
| 	Do not disown the package on the AUR | ||||
|  | ||||
| *-f, --force*:: | ||||
| 	Force push to the AUR overwriting the remote repository | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-db-remove(1) | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -1,37 +0,0 @@ | ||||
| pkgctl-aur(1) | ||||
| ============= | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-aur - Interact with the Arch User Repository (AUR) | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl aur [OPTIONS] [SUBCOMMAND] | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| Provides a suite of tools designed for managing and interacting with the Arch | ||||
| User Repository (AUR). It simplifies various tasks related to AUR, including | ||||
| importing repositories, managing packages, and transitioning packages between | ||||
| the official repositories and the AUR. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| Subcommands | ||||
| ----------- | ||||
|  | ||||
| pkgctl aur drop-from-repo:: | ||||
| 	Drop a package from the official repository to the AUR | ||||
|  | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-aur-drop-from-repo(1) | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -35,6 +35,6 @@ Options | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-auth-status(1) | ||||
| linkman:pkgctl-auth-status[1] | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
|   | ||||
| @@ -27,6 +27,6 @@ Options | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-auth-login(1) | ||||
| linkman:pkgctl-auth-login[1] | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
|   | ||||
| @@ -32,7 +32,7 @@ pkgctl auth status:: | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-auth-login(1) | ||||
| pkgctl-auth-status(1) | ||||
| linkman:pkgctl-auth-login[1] | ||||
| linkman:pkgctl-auth-status[1] | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
|   | ||||
| @@ -12,10 +12,7 @@ pkgctl build [OPTIONS] [PATH...] | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| Build packages in clean chroot environment, offering various options | ||||
| and functionalities to customize the package building process. | ||||
|  | ||||
| By default, chroot environments are located in '/var/lib/archbuild/'. | ||||
| TODO | ||||
|  | ||||
| Build Options | ||||
| ------------- | ||||
| @@ -24,10 +21,7 @@ Build Options | ||||
| 	Specify architectures to build for (disables auto-detection) | ||||
|  | ||||
| *--repo* 'REPO':: | ||||
| 	Specify target repository for new packages not in any official repo. | ||||
| 	Fallback to `'extra'` when building packages that are not present in any | ||||
| 	official repository yet. Using this option is disallowed if the package is | ||||
| 	already released, as it would circumvent the auto-detection safeguard. | ||||
| 	Specify a target repository (disables auto-detection) | ||||
|  | ||||
| *-s, --staging*:: | ||||
| 	Build against the staging counterpart of the auto-detected repo | ||||
| @@ -41,9 +35,8 @@ Build Options | ||||
| *-c, --clean*:: | ||||
| 	Recreate the chroot before building | ||||
|  | ||||
| *--inspect* 'WHEN':: | ||||
| 	Spawn an interactive shell to inspect the chroot after building. Useful to ease the debugging of a package build. + | ||||
| 	Possible values for 'WHEN' are `'never'`, `'always'` or `'failure'` | ||||
| *-I, --install* 'FILE':: | ||||
| 	Install a package into the working copy of the chroot | ||||
|  | ||||
| *-w, --worker* 'SLOT':: | ||||
| 	Name of the worker slot, useful for concurrent builds. By default the slot | ||||
| @@ -54,17 +47,6 @@ Build Options | ||||
| *--nocheck*:: | ||||
| 	Do not run the check() function in the PKGBUILD | ||||
|  | ||||
| Install Options | ||||
| --------------- | ||||
|  | ||||
| *-I, --install-to-chroot* 'FILE':: | ||||
| 	Install a package to the working copy of the chroot | ||||
|  | ||||
| *-i, --install-to-host* 'MODE':: | ||||
| 	Install the built packages to the host system. Useful when one wants to verify that the package works as intended. | ||||
| 	* When 'MODE' is 'all', this installs all built packages | ||||
| 	* When 'MODE' is 'auto', this installs all built packages which are currently installed | ||||
|  | ||||
| PKGBUILD Options | ||||
| ---------------- | ||||
|  | ||||
| @@ -77,13 +59,6 @@ PKGBUILD Options | ||||
| *--rebuild*:: | ||||
| 	Increment the current pkgrel variable | ||||
|  | ||||
| *--update-checksums*:: | ||||
| 	Force computation and update of the checksums by disabling auto-detection. + | ||||
| 	Should only be used in special circumstances, like when adding new patch | ||||
| 	files to the source array. During regular packaging operations, checksums | ||||
| 	are either automatically updated when upgrading a package using `--pkgver` | ||||
| 	or should remain immutable during rebuilds. | ||||
|  | ||||
| *-e, --edit*:: | ||||
| 	Edit the PKGBUILD before building | ||||
|  | ||||
| @@ -110,7 +85,7 @@ Options | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-release(1) | ||||
| pkgctl-db-update(1) | ||||
| linkman:pkgctl-release[1] | ||||
| linkman:pkgctl-db-update[1] | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
|   | ||||
| @@ -3,16 +3,17 @@ pkgctl-db-move(1) | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-db-move - Move packages between binary repositories. | ||||
| pkgctl-db-update - Update the binary repository as final release step | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl db move [OPTIONS] [SOURCE_REPO] [TARGET_REPO] [PKGBASE]... | ||||
| pkgctl db update [OPTIONS] | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| Move packages between binary repositories i.e. from 'extra-testing' to 'extra'. | ||||
| Update the pacman database as final release step for packages that | ||||
| have been transfered and staged on 'repos.archlinux.org'. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|   | ||||
| @@ -12,27 +12,13 @@ pkgctl db remove [OPTIONS] [REPO] [PKGBASE]... | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| Remove packages from pacman repositories. By default passing a pkgbase removes | ||||
| all split packages, debug packages as well as entries from the state repo for | ||||
| all existing architectures. | ||||
|  | ||||
| Beware when using the `--partial` option, as it may most likely lead to | ||||
| undesired effects by leaving debug packages behind as well as dangling entries | ||||
| in the state repository. | ||||
| Remove packages from pacman repositories. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *--partial*:: | ||||
| 	Remove only partial pkgnames from a split package. This leaves debug | ||||
| 	packages behind and pkgbase entries in the state repo. | ||||
|  | ||||
| *-a, --arch* 'ARCH':: | ||||
| 	Remove only one specific architecture (disables auto-detection). | ||||
| 	By default all architectures are removed when this option is not used. | ||||
|  | ||||
| *--noconfirm*:: | ||||
| 	Bypass any confirmation messages, should only be used with caution. | ||||
| 	Override the architecture (disables auto-detection) | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|   | ||||
| @@ -1,19 +1,18 @@ | ||||
| pkgctl-db-update(1) | ||||
| =================== | ||||
| pkgctl-db-move(1) | ||||
| ================= | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-db-update - Update the binary repository as final release step | ||||
| pkgctl-db-move - Move packages between binary repositories | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl db update [OPTIONS] | ||||
| pkgctl db move [OPTIONS] [SOURCE_REPO] [TARGET_REPO] [PKGBASE]... | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| Update the pacman database as final release step for packages that | ||||
| have been transfered and staged on 'repos.archlinux.org'. | ||||
| Move packages between pacman repositories. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|   | ||||
| @@ -1,43 +0,0 @@ | ||||
| pkgctl-db(1) | ||||
| ============ | ||||
|  | ||||
| NAME | ||||
| ---- | ||||
| pkgctl-db - Pacman database modification utility for package updates, moves, and more. | ||||
|  | ||||
| SYNOPSIS | ||||
| -------- | ||||
| pkgctl db [OPTIONS] [SUBCOMMAND] | ||||
|  | ||||
| DESCRIPTION | ||||
| ----------- | ||||
|  | ||||
| Managing the Pacman database and facilitate the modification of packages and their metadata | ||||
| within the database | ||||
|  | ||||
| OPTIONS | ||||
| ------- | ||||
|  | ||||
| *-h, --help*:: | ||||
|     Display usage information and available options. | ||||
|  | ||||
| Subcommands | ||||
| ----------- | ||||
|  | ||||
| pkgctl db update:: | ||||
|     Update the binary repository as final release step | ||||
|  | ||||
| pkgctl db move:: | ||||
|     Move packages between binary repositories | ||||
|  | ||||
| pkgctl db remove:: | ||||
|     Remove packages from binary repositories | ||||
|  | ||||
| SEE ALSO | ||||
| -------- | ||||
|  | ||||
| pkgctl-db-update(1) | ||||
| pkgctl-db-move(1) | ||||
| pkgctl-db-remove(1) | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -1,47 +0,0 @@ | ||||
| pkgctl-issue-close(1) | ||||
| ===================== | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-issue-close - Close an issue | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl issue close [OPTIONS] [IID] | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| This command is used to close an issue in Arch Linux packaging projects. It | ||||
| finalizes the issue by marking it as resolved and optionally providing a reason | ||||
| for its closure. | ||||
|  | ||||
| To edit an issue, users must specify the issue ID (IID). By default, the | ||||
| command operates within the current directory, but users have the option to | ||||
| specify a different package base. | ||||
|  | ||||
| Users can provide a message directly through the command line to explain the | ||||
| reason for closing the issue. For more detailed or precise reasons, users can | ||||
| opt to edit the closure message using a text editor before submitting it. | ||||
| Additionally, a specific resolution label can be set to categorize the closure | ||||
| reason, with the default label being "completed." | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *-p, --package* 'PKGBASE':: | ||||
| 	Interact with `PKGBASE` instead of the current directory | ||||
|  | ||||
| *-m, --message* 'MSG':: | ||||
| 	Use the provided message as the reason for closing | ||||
|  | ||||
| *-e, --edit*:: | ||||
| 	Edit the reason for closing using an editor | ||||
|  | ||||
| *-r, --resolution* 'REASON':: | ||||
| 	Set a specific resolution label (default: completed) | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -1,43 +0,0 @@ | ||||
| pkgctl-issue-comment(1) | ||||
| ======================= | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-issue-comment - Comment on an issue | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl issue comment [OPTIONS] [IID] | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| This command allows users to add comments to an issue in Arch Linux packaging | ||||
| projects. This command is useful for providing feedback, updates, or any | ||||
| additional information related to an issue directly within the project's issue | ||||
| tracking system. | ||||
|  | ||||
| By default, the command interacts with the current directory, but users can | ||||
| specify a different package base if needed. | ||||
|  | ||||
| Users can provide a comment message directly through the command line, ensuring | ||||
| quick and efficient communication. Additionally, for more detailed or formatted | ||||
| comments, users have the option to edit their comment using a text editor | ||||
| before submitting it. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *-p, --package PKGBASE*:: | ||||
| 	Interact with `PKGBASE` instead of the current directory | ||||
|  | ||||
| *-m, --message MSG*:: | ||||
| 	Use the provided message as the comment | ||||
|  | ||||
| *-e, --edit*:: | ||||
| 	Edit the comment using an editor | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -1,77 +0,0 @@ | ||||
| pkgctl-issue-create(1) | ||||
| ====================== | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-issue-create - Create a new issue | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl issue create [OPTIONS] | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| The create command is used to create a new issue for an Arch Linux package. | ||||
| This command is suitable for reporting bugs, regressions, feature requests, or | ||||
| any other issues related to a package. It provides a flexible way to document | ||||
| and track new issues within the project's issue tracking system. | ||||
|  | ||||
| By default, the command operates within the current directory, but users can | ||||
| specify a different package base if needed. | ||||
|  | ||||
| Users can provide a title for the issue directly through the command line. The | ||||
| issue description can be supplied from a file or edited using a text editor. | ||||
| Alternatively, users can opt to continue the issue creation process using the | ||||
| web interface for a more interactive experience. | ||||
|  | ||||
| The command allows setting various labels and attributes for the issue, such as | ||||
| confidentiality, priority, scope, severity, and status. These options help | ||||
| categorize and prioritize the issue appropriately within the tracking system. | ||||
|  | ||||
| In case of a failed run, the command can automatically recover to ensure that | ||||
| the issue creation process is completed without losing any data. | ||||
|  | ||||
| This command is essential for maintainers, contributors, and users who need to | ||||
| report new issues related to Arch Linux packages. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *-p, --package* 'PKGBASE':: | ||||
| 	Interact with `PKGBASE` instead of the current directory | ||||
|  | ||||
| *-t, --title* 'TITLE':: | ||||
| 	Use the provided title for the issue | ||||
|  | ||||
| *-F, --file* 'FILE':: | ||||
| 	Take issue description from <file> | ||||
|  | ||||
| *-e, --edit*:: | ||||
| 	Edit the issue description using an editor | ||||
|  | ||||
| *-w, --web*:: | ||||
| 	Continue issue creation with the web interface | ||||
|  | ||||
| *--recover*:: | ||||
| 	Automatically recover from a failed run | ||||
|  | ||||
| *--confidentiality* 'TYPE':: | ||||
| 	Set the issue confidentiality | ||||
|  | ||||
| *--priority* 'PRIORITY':: | ||||
| 	Set the priority label | ||||
|  | ||||
| *--scope* 'SCOPE':: | ||||
| 	Set the scope label | ||||
|  | ||||
| *--severity* 'SEVERITY':: | ||||
| 	Set the severity label | ||||
|  | ||||
| *--status* 'STATUS':: | ||||
| 	Set the status label | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -1,75 +0,0 @@ | ||||
| pkgctl-issue-edit(1) | ||||
| ==================== | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-issue-edit - Edit and modify an issue | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl issue edit [OPTIONS] [IID] | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| The pkgctl issue edit command is used to modify an existing issue in Arch Linux | ||||
| packaging projects. This command allows users to update the issue's title, | ||||
| description, and various attributes, ensuring that the issue information | ||||
| remains accurate and up-to-date. It also provides a streamlined facility | ||||
| for bug wranglers to categorize and prioritize issues efficiently. | ||||
|  | ||||
| To edit an issue, users must specify the issue ID (IID). By default, the | ||||
| command operates within the current directory, but users can specify a | ||||
| different package base if needed. | ||||
|  | ||||
| The command allows for direct updates to the issue title and description. For | ||||
| more extensive changes, users can edit these details using a text editor. The | ||||
| command provides various options to set or update labels and attributes such as | ||||
| confidentiality, priority, resolution, scope, severity, and status. These | ||||
| options help maintain clear and organized issue management. | ||||
|  | ||||
| In case of a failed run, the command can automatically recover to ensure that | ||||
| the editing process is completed without losing any data. | ||||
|  | ||||
| This command is particularly useful for maintainers and contributors who need | ||||
| to update the details of an issue to reflect new information or changes in | ||||
| status. It ensures that all issue details are accurately maintained, | ||||
| facilitating efficient tracking and resolution. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *-p, --package* 'PKGBASE':: | ||||
| 	Interact with `PKGBASE` instead of the current directory | ||||
|  | ||||
| *-t, --title* 'TITLE':: | ||||
| 	Use the provided title for the issue | ||||
|  | ||||
| *-e, --edit*:: | ||||
| 	Edit the issue title and description using an editor | ||||
|  | ||||
| *--recover*:: | ||||
| 	Automatically recover from a failed run | ||||
|  | ||||
| *--confidentiality* 'TYPE':: | ||||
| 	Set the issue confidentiality | ||||
|  | ||||
| *--priority* 'PRIORITY':: | ||||
| 	Set the priority label | ||||
|  | ||||
| *--resolution* 'REASON':: | ||||
| 	Set the resolution label | ||||
|  | ||||
| *--scope* 'SCOPE':: | ||||
| 	Set the scope label | ||||
|  | ||||
| *--severity* 'SEVERITY':: | ||||
| 	Set the severity label | ||||
|  | ||||
| *--status* 'STATUS':: | ||||
| 	Set the status label | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -1,100 +0,0 @@ | ||||
| pkgctl-issue-list(1) | ||||
| ==================== | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-issue-list - List project or group issues | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl issue list [OPTIONS] [PKGBASE] | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| The pkgctl issue list command is used to list issues associated with a specific | ||||
| packaging project or the entire packaging subgroup in Arch Linux. This command | ||||
| facilitates efficient issue management by allowing users to list and filter | ||||
| issues based on various criteria. | ||||
|  | ||||
| Results can also be displayed directly in a web browser for easier navigation | ||||
| and review. | ||||
|  | ||||
| The command offers filtering options to refine the results. Users can include | ||||
| closed issues, filter exclusively for unconfirmed issues, or focus on issues | ||||
| with specific labels such as priority, confidentiality, resolution, scope, | ||||
| severity, and status. | ||||
|  | ||||
| Additionally, users can search within issue titles or descriptions and filter | ||||
| issues by the assignee or author. There are also convenient shortcuts to filter | ||||
| issues assigned to or created by the current user. | ||||
|  | ||||
| This command is particularly useful for package maintainers and contributors in | ||||
| the Arch Linux community who need to track and manage issues efficiently. It | ||||
| provides a comprehensive view of the project's or group's issue landscape, | ||||
| enabling maintainers to address and prioritize issues effectively. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *-g, --group*:: | ||||
| 	Get issues from the whole packaging subgroup | ||||
|  | ||||
| *-w, --web*:: | ||||
| 	View results in a browser | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| Filter Options | ||||
| -------------- | ||||
|  | ||||
| *-A, --all*:: | ||||
| 	Get all issues including closed | ||||
|  | ||||
| *-c, --closed*:: | ||||
| 	Get only closed issues | ||||
|  | ||||
| *-U, --unconfirmed*:: | ||||
| 	Shorthand to filter by unconfirmed status label | ||||
|  | ||||
| *--search* 'SEARCH':: | ||||
| 	Search <string> in the fields defined by --in | ||||
|  | ||||
| *--in* 'LOCATION':: | ||||
| 	Search in title or description (default: all) | ||||
|  | ||||
| *-l, --label* 'NAME':: | ||||
| 	Filter issue by label <name> | ||||
|  | ||||
| *--confidentiality* 'TYPE':: | ||||
| 	Filter by confidentiality | ||||
|  | ||||
| *--priority* 'PRIORITY':: | ||||
| 	Shorthand to filter by priority label | ||||
|  | ||||
| *--resolution* 'REASON':: | ||||
| 	Shorthand to filter by resolution label | ||||
|  | ||||
| *--scope* 'SCOPE':: | ||||
| 	Shorthand to filter by scope label | ||||
|  | ||||
| *--severity* 'SEVERITY':: | ||||
| 	Shorthand to filter by severity label | ||||
|  | ||||
| *--status* 'STATUS':: | ||||
| 	Shorthand to filter by status label | ||||
|  | ||||
| *--assignee* 'USERNAME':: | ||||
| 	Filter issues assigned to the given username | ||||
|  | ||||
| *--assigned-to-me*:: | ||||
| 	Shorthand to filter issues assigned to you | ||||
|  | ||||
| *--author* 'USERNAME':: | ||||
| 	Filter issues authored by the given username | ||||
|  | ||||
| *--created-by-me*:: | ||||
| 	Shorthand to filter issues created by you | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -1,43 +0,0 @@ | ||||
| pkgctl-issue-move(1) | ||||
| ==================== | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-issue-move - Move an issue to another project | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl issue move [OPTIONS] [IID] [DESTINATION_PACKAGE] | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| The move command allows users to transfer an issue from one project to another | ||||
| within the Arch Linux packaging group. This is useful when an issue is | ||||
| identified to be more relevant or better handled in a different project. | ||||
|  | ||||
| By default, the command operates within the current directory, but users can | ||||
| specify a different package base from which to move the issue. | ||||
|  | ||||
| Users must specify the issue ID (IID) and the destination package to which the | ||||
| issue should be moved. A comment message explaining the reason for the move can | ||||
| be provided directly through the command line. For more detailed explanations | ||||
| or additional context, users have the option to edit the move comment using a | ||||
| text editor before submitting it. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *-p, --package* 'PKGBASE':: | ||||
| 	Move from `PKGBASE` instead of the current directory | ||||
|  | ||||
| *-m, --message* 'MSG':: | ||||
| 	Use the provided message as the comment | ||||
|  | ||||
| *-e, --edit*:: | ||||
| 	Edit the comment using an editor | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -1,43 +0,0 @@ | ||||
| pkgctl-issue-reopen(1) | ||||
| ====================== | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-issue-reopen - Reopen a closed issue | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl issue reopen [OPTIONS] [IID] | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| The reopen command is used to reopen a previously closed issue in Arch Linux | ||||
| packaging projects. This command is useful when an issue needs to be revisited | ||||
| or additional work is required after it was initially closed. | ||||
|  | ||||
| To edit an issue, users must specify the issue ID (IID). By default, the | ||||
| command operates within the current directory, but users can specify a | ||||
| different package base if needed. | ||||
|  | ||||
| Users can provide a message directly through the command line to explain the | ||||
| reason for reopening the issue. For more detailed explanations or to provide | ||||
| additional context, users have the option to edit the reopening comment using a | ||||
| text editor before submitting it. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *-p, --package* 'PKGBASE':: | ||||
| 	Interact with `PKGBASE` instead of the current directory | ||||
|  | ||||
| *-m, --message* 'MSG':: | ||||
| 	Use the provided message as the comment | ||||
|  | ||||
| *-e, --edit*:: | ||||
| 	Edit the comment using an editor | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -1,43 +0,0 @@ | ||||
| pkgctl-issue-view(1) | ||||
| ==================== | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-issue-view - Display information about an issue | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl issue view [OPTIONS] | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| This command is designed to display detailed information about a specific issue | ||||
| in Arch Linux packaging projects. It gathers and pretty prints all relevant | ||||
| data about the issue, providing a comprehensive view that includes the issue's | ||||
| description, status as well as labels and creation date. | ||||
|  | ||||
| By default, the command operates within the current directory, but users have | ||||
| the option to specify a different package base. Additionally, users can choose | ||||
| to view the issue in a web browser for a more interactive experience. | ||||
|  | ||||
| For those requiring deeper insights, the command can also display all comments | ||||
| and activities related to the issue, providing a full historical context and | ||||
| ongoing discussions. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *-p, --package* 'PKGBASE':: | ||||
| 	Interact with `PKGBASE` instead of the current directory | ||||
|  | ||||
| *-c, --comments*:: | ||||
| 	Show issue comments and activities | ||||
|  | ||||
| *-w, --web*:: | ||||
| 	Open issue in a browser | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -1,62 +0,0 @@ | ||||
| pkgctl-issue(1) | ||||
| =============== | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-issue - Work with GitLab packaging issues | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl issue [SUBCOMMAND] [OPTIONS] | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| Work with GitLab packaging issues. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| Subcommands | ||||
| ----------- | ||||
|  | ||||
| pkgctl issue close:: | ||||
| 	Close an issue | ||||
|  | ||||
| pkgctl issue comment:: | ||||
| 	Comment on an issue | ||||
|  | ||||
| pkgctl issue create:: | ||||
| 	Create a new issue | ||||
|  | ||||
| pkgctl issue edit:: | ||||
| 	Edit and modify an issue | ||||
|  | ||||
| pkgctl issue list:: | ||||
| 	List project or group issues | ||||
|  | ||||
| pkgctl issue move:: | ||||
| 	Move an issue to another project | ||||
|  | ||||
| pkgctl issue reopen:: | ||||
| 	Reopen a closed issue | ||||
|  | ||||
| pkgctl issue view:: | ||||
| 	Display information about an issue | ||||
|  | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-issue-close(1) | ||||
| pkgctl-issue-comment(1) | ||||
| pkgctl-issue-create(1) | ||||
| pkgctl-issue-edit(1) | ||||
| pkgctl-issue-list(1) | ||||
| pkgctl-issue-move(1) | ||||
| pkgctl-issue-reopen(1) | ||||
| pkgctl-issue-view(1) | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -27,9 +27,7 @@ Options | ||||
| 	Use the given <msg> as the commit message | ||||
|  | ||||
| *-r, --repo* 'REPO':: | ||||
| 	Specify target repository for new packages not in any official repo. | ||||
| 	Using this option is disallowed if the package is already released, as it | ||||
| 	would circumvent the auto-detection safeguard. | ||||
| 	Specify a target repository (disables auto-detection) | ||||
|  | ||||
| *-s, --staging*:: | ||||
| 	Build against the staging counterpart of the auto-detected repo | ||||
| @@ -46,6 +44,6 @@ Options | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-db-update(1) | ||||
| linkman:pkgctl-db-update[1] | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
|   | ||||
| @@ -1,40 +0,0 @@ | ||||
| pkgctl-repo-clean(1) | ||||
| ==================== | ||||
|  | ||||
| Name | ||||
| ---- | ||||
|  | ||||
| pkgctl-repo-clean - Remove untracked files from the working tree | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
|  | ||||
| pkgctl repo clean [OPTION] [PATH]... | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| Cleans the working tree by recursively removing files that are not under | ||||
| version control, starting from the current directory. | ||||
|  | ||||
| Files unknown to Git as well as ignored files are removed. This can, for | ||||
| example, be useful to remove all build products. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *-i, --interactive*:: | ||||
| 	Show what would be done and clean files interactively | ||||
|  | ||||
| *-n, --dry-run*:: | ||||
| 	Don't actually remove anything, just show what would be done | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| git-clean(1) | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -46,7 +46,7 @@ Options | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-repo-configure(1) | ||||
| pkgctl-repo-switch(1) | ||||
| linkman:pkgctl-repo-configure[1] | ||||
| linkman:pkgctl-repo-switch[1] | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
|   | ||||
| @@ -22,8 +22,6 @@ The remote protocol is automatically determined from the author email | ||||
| address by choosing SSH for all official packager identities and | ||||
| read-only HTTPS otherwise. | ||||
|  | ||||
| Git default excludes and hooks are applied to the configured repo. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
|   | ||||
| @@ -33,8 +33,8 @@ Options | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-auth(1) | ||||
| pkgctl-repo-clone(1) | ||||
| pkgctl-repo-configure(1) | ||||
| linkman:pkgctl-auth[1] | ||||
| linkman:pkgctl-repo-clone[1] | ||||
| linkman:pkgctl-repo-configure[1] | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
|   | ||||
| @@ -18,9 +18,6 @@ no arguments, open the package cloned in the current working directory. | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *--print*:: | ||||
| 	Print the url instead of opening it with xdg-open | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
|   | ||||
| @@ -32,9 +32,6 @@ Options | ||||
| Subcommands | ||||
| ----------- | ||||
|  | ||||
| pkgctl repo clean:: | ||||
| 	Remove untracked files from the working tree | ||||
|  | ||||
| pkgctl repo clone:: | ||||
| 	Clone a package repository | ||||
|  | ||||
| @@ -53,11 +50,10 @@ pkgctl repo web:: | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-repo-clean(1) | ||||
| pkgctl-repo-clone(1) | ||||
| pkgctl-repo-configure(1) | ||||
| pkgctl-repo-create(1) | ||||
| pkgctl-repo-switch(1) | ||||
| pkgctl-repo-web(1) | ||||
| linkman:pkgctl-repo-clone[1] | ||||
| linkman:pkgctl-repo-configure[1] | ||||
| linkman:pkgctl-repo-create[1] | ||||
| linkman:pkgctl-repo-switch[1] | ||||
| linkman:pkgctl-repo-web[1] | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
|   | ||||
| @@ -1,71 +0,0 @@ | ||||
| pkgctl-search(1) | ||||
| ================ | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-search - Search for an expression across the GitLab packaging group | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl search [OPTIONS] QUERY | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| Search for an expression across the GitLab packaging group. | ||||
|  | ||||
| To use a filter, include it in your query. You may use wildcards (*) to | ||||
| use glob matching. | ||||
|  | ||||
| Available filters for the blobs scope: path, extension | ||||
|  | ||||
| Every usage of the search command must be authenticated. Consult the | ||||
| `'pkgctl auth'` command to authenticate with GitLab or view the authentication | ||||
| status. | ||||
|  | ||||
| Search Tips | ||||
| ----------- | ||||
|  | ||||
| 	Syntax  Description    Example | ||||
| 	─────────────────────────────────────── | ||||
| 	"       Exact search   "gem sidekiq" | ||||
| 	~       Fuzzy search   J~ Doe | ||||
| 	|       Or             display | banner | ||||
| 	+       And            display +banner | ||||
| 	-       Exclude        display -banner | ||||
| 	*       Partial        bug error 50* | ||||
| 	\       Escape         \*md | ||||
| 	#       Issue ID       #23456 | ||||
| 	!       Merge request  !23456 | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| Filter Options | ||||
| -------------- | ||||
|  | ||||
| *--no-default-filter*:: | ||||
| 	Do not apply default filter (like -path:keys/pgp/*.asc) | ||||
|  | ||||
| Output Options | ||||
| -------------- | ||||
|  | ||||
| *--json*:: | ||||
| 	Enable printing in JSON; Shorthand for `'--format json'` | ||||
|  | ||||
| *-F, --format* 'FORMAT':: | ||||
| 	Controls the formatting of the results; `FORMAT` is `'pretty'`, `'plain'`, | ||||
| 	or `'json'` (default `pretty`) | ||||
|  | ||||
| *-N, --no-line-number*:: | ||||
| 	Don't show line numbers when formatting results | ||||
|  | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-auth(1) | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -1,79 +0,0 @@ | ||||
| pkgctl-version-check(1) | ||||
| ======================= | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-version-check - Compares local package versions against upstream | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl version check [OPTIONS] [PKGBASE...] | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| Compares the versions of packages in the local packaging repository against | ||||
| their latest upstream versions. | ||||
|  | ||||
| Upon execution, it generates a grouped list that provides detailed insights | ||||
| into each package's status. For each package, it displays the current local | ||||
| version alongside the latest version available upstream. | ||||
|  | ||||
| Outputs a summary of up-to-date packages, out-of-date packages, and any check | ||||
| failures. | ||||
|  | ||||
| This simplifies the maintenance of PKGBUILD files, reducing the manual effort | ||||
| required to track version changes from upstream sources. | ||||
|  | ||||
| Configuration | ||||
| ------------- | ||||
|  | ||||
| Uses nvchecker(1) and a `.nvchecker.toml` file located alongside the | ||||
| PKGBUILD. Refer to the configuration section in pkgctl-version(1). | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| Filter Options | ||||
| -------------- | ||||
|  | ||||
| *-v, --verbose*:: | ||||
| 	Display all results including up-to-date versions | ||||
|  | ||||
| Output Options | ||||
| -------------- | ||||
|  | ||||
| *--json*:: | ||||
| 	Enable printing in JSON; Shorthand for `'--format json'` | ||||
|  | ||||
| *-F, --format* 'FORMAT':: | ||||
| 	Controls the output format of the results; `FORMAT` is `'pretty'`, | ||||
| 	or `'json'` (default `pretty`) | ||||
|  | ||||
| Exit Codes | ||||
| ---------- | ||||
|  | ||||
| On exit, return one of the following codes: | ||||
|  | ||||
| *0*:: | ||||
| 	Normal exit condition, all checked versions are up-to-date | ||||
|  | ||||
| *1*:: | ||||
| 	Unknown cause of failure | ||||
|  | ||||
| *2*:: | ||||
| 	Normal exit condition, but there are out-of-date versions | ||||
|  | ||||
| *3*:: | ||||
| 	Failed to run some version checks | ||||
|  | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-version(1) | ||||
| nvchecker(1) | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -1,125 +0,0 @@ | ||||
| pkgctl-version-setup(1) | ||||
| ======================= | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-version-setup - Automatically detect and setup a basic nvchecker config | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl version setup [OPTIONS] [PKGBASE...] | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| This subcommand automates the creation of a basic nvchecker(1) configuration | ||||
| file by analyzing the source array specified in the PKGBUILD(1) file of a | ||||
| package. This command intelligently detects various platforms and APIs (e.g., | ||||
| GitHub, GitLab, PyPI) used by the package sources and generates a corresponding | ||||
| `.nvchecker.toml` configuration based on its best guess. | ||||
|  | ||||
| This is particularly useful for initializing nvchecker(1) settings for a | ||||
| package without manually crafting the `.nvchecker.toml` file. It simplifies the | ||||
| process of setting up version checks, especially when transitioning a package's | ||||
| monitoring from one source platform to another or starting version checks for a | ||||
| new package. | ||||
|  | ||||
| If no `PKGBASE` is specified, the command defaults to using the current working | ||||
| directory. | ||||
|  | ||||
| To obtain a list of supported sources and their expected URL formats, please | ||||
| consult the sources section. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *-f, --force*:: | ||||
| 	Overwrite existing nvchecker(1) configuration | ||||
|  | ||||
| *--prefer-platform-api*:: | ||||
| 	Prefer platform specific GitHub/GitLab API over git for complex cases | ||||
|  | ||||
| *--url* 'URL':: | ||||
| 	Derive check target from the given URL instead of the source array entries | ||||
|  | ||||
| *--no-check*:: | ||||
| 	Do not run pkgctl-version-check(1) after setup | ||||
|  | ||||
| *--no-upstream*:: | ||||
| 	Setup a blank config for packages without upstream sources, like meta | ||||
| 	packages. This must only be used for cases without an upstream, please | ||||
| 	reach out to the developer team for guidance regarding upstream sources | ||||
| 	that are hard to configure. | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| Sources | ||||
| ------- | ||||
|  | ||||
| Here are the currently supported platforms and sources, along with examples of | ||||
| URL formats that enable their automatic detection as specific source types: | ||||
|  | ||||
| *Git*:: | ||||
| 	* https://github.com/example/project | ||||
| 	* https://gitlab.com/example/group/project | ||||
| 	* git://git.foobar.org/example | ||||
| 	* git+https://git.foobar.org/example | ||||
|  | ||||
| *GitHub*:: | ||||
| 	* https://github.com/example/project | ||||
| 	* https://github.com/example/project/archive/v1.0/project-v1.0.tar.gz | ||||
|  | ||||
| *GitLab*:: | ||||
| 	* https://gitlab.com/example/group/project | ||||
| 	* https://gitlab.archlinux.org/archlinux/devtools.git | ||||
| 	* https://gitlab.archlinux.org/archlinux/devtools/-/releases/v1.1.0/downloads/devtools-v1.1.0.tar.gz | ||||
|  | ||||
| *Hackage*:: | ||||
| 	* https://hackage.haskell.org/package/xmonad | ||||
| 	* https://hackage.haskell.org/package/xmonad-0.18.0/xmonad-0.18.0.tar.gz | ||||
| 	* https://hackage.haskell.org/packages/archive/xmonad/0.18.0/xmonad-0.18.0.tar.gz | ||||
|  | ||||
| *NPM*:: | ||||
| 	* https://registry.npmjs.org/node-gyp/-/node-gyp-10.0.1.tgz | ||||
| 	* https://www.npmjs.com/package/node-gyp | ||||
|  | ||||
| *PyPI*:: | ||||
| 	* https://pypi.io/packages/source/p/pyflakes | ||||
| 	* https://pypi.org/packages/source/b/bleach | ||||
| 	* https://files.pythonhosted.org/packages/source/p/pyflakes | ||||
| 	* https://pypi.org/project/SQLAlchemy/ | ||||
|  | ||||
| *RubyGems*:: | ||||
| 	* https://rubygems.org/downloads/diff-lcs-1.5.1.gem | ||||
| 	* https://rubygems.org/gems/diff-lcs | ||||
|  | ||||
| *CPAN*:: | ||||
| 	* https://search.cpan.org/CPAN/authors/id/C/CO/COSIMO/Locale-PO-0.27.tar.gz | ||||
| 	* https://cpan.metacpan.org/authors/id/C/CO/COSIMO/Locale-PO-0.27.tar.gz | ||||
|  | ||||
| *crates.io*:: | ||||
| 	* https://static.crates.io/crates/shotgun/shotgun-1.0.crate | ||||
| 	* https://crates.io/api/v1/crates/shotgun/1.0/download | ||||
| 	* https://crates.io/crates/git-smash | ||||
|  | ||||
| Examples | ||||
| -------- | ||||
|  | ||||
| *pkgctl version setup*:: | ||||
| 	Detects the source from the current directory's PKGBUILD(1) and | ||||
| 	sets up a basic `.nvchecker.toml`. | ||||
|  | ||||
| *pkgctl version setup --url https://github.com/example/project*:: | ||||
| 	Generates an `.nvchecker.toml` for the current PKGBUILD(1) but | ||||
| 	overrides the source URL with the specified GitHub project. | ||||
|  | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-version(1) | ||||
| pkgctl-version-check(1) | ||||
| nvchecker(1) | ||||
| PKGBUILD(5) | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -1,53 +0,0 @@ | ||||
| pkgctl-version-upgrade(1) | ||||
| ========================= | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-version-upgrade - Adjust the PKGBUILD to match the latest upstream version | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl version upgrade [OPTIONS] [PKGBASE...] | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| Streamlines the process of keeping PKGBUILD files up-to-date with the latest | ||||
| upstream versions. | ||||
|  | ||||
| Upon execution, it automatically adjusts the PKGBUILD file, ensuring that the | ||||
| pkgver field is set to match the latest version available from the upstream | ||||
| source. In addition to updating the pkgver, this command also resets the pkgrel | ||||
| to 1 and updates checksums. | ||||
|  | ||||
| Outputs a summary of upgraded packages, up-to-date packages, and any check | ||||
| failures. | ||||
|  | ||||
| This simplifies the maintenance of PKGBUILD files, reducing the manual effort | ||||
| required to track and implement version changes from upstream sources. | ||||
|  | ||||
| Configuration | ||||
| ------------- | ||||
|  | ||||
| Uses nvchecker(1) and a `.nvchecker.toml` file located alongside the | ||||
| PKGBUILD. Refer to the configuration section in pkgctl-version(1). | ||||
|  | ||||
| Options | ||||
| ------- | ||||
|  | ||||
| *--no-update-checksums*:: | ||||
| 	Disable computation and update of the checksums | ||||
|  | ||||
| *-v, --verbose*:: | ||||
| 	Display results including up-to-date versions | ||||
|  | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-version(1) | ||||
| nvchecker(1) | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
| @@ -3,41 +3,16 @@ pkgctl-version(1) | ||||
|  | ||||
| Name | ||||
| ---- | ||||
| pkgctl-version - Check and manage package versions against upstream | ||||
|  | ||||
| pkgctl-version - Show pkgctl version information | ||||
|  | ||||
| Synopsis | ||||
| -------- | ||||
| pkgctl version [OPTIONS] [SUBCOMMAND] | ||||
| pkgctl version [OPTIONS] | ||||
|  | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| Commands related to package versions, including checks for outdated packages. | ||||
|  | ||||
| Uses nvchecker(1) and a `.nvchecker.toml` file located alongside the | ||||
| PKGBUILD. | ||||
|  | ||||
| Configuration | ||||
| ------------- | ||||
|  | ||||
| The `.nvchecker.toml` file must contain a section that matches the | ||||
| package's pkgbase. The pkgbase section within the `.nvchecker.toml` file | ||||
| specifies the source and method for checking the latest version of the | ||||
| corresponding package. | ||||
|  | ||||
| Use pkgctl-version-setup(1) to automatically detect and setup a basic nvchecker | ||||
| config based on the source array of the package PKGBUILD. | ||||
|  | ||||
| For detailed information on the various configuration options available for the | ||||
| `.nvchecker.toml` file, refer to the configuration files section in | ||||
| nvchecker(1). This documentation provides insights into the possible | ||||
| options that can be utilized to customize the version checking process. | ||||
|  | ||||
| To supply GitHub or GitLab tokens to nvchecker, a `keyfile.toml` should be | ||||
| placed in the `$XDG_CONFIG_HOME`/nvchecker` directory. This keyfile is | ||||
| used for providing the necessary authentication tokens required for | ||||
| accessing the GitHub or GitLab API. | ||||
| Shows the current version information of pkgctl. | ||||
|  | ||||
| Options | ||||
| ------- | ||||
| @@ -45,23 +20,4 @@ Options | ||||
| *-h, --help*:: | ||||
| 	Show a help text | ||||
|  | ||||
| Subcommands | ||||
| ----------- | ||||
|  | ||||
| pkgctl version check:: | ||||
| 	Compares local package versions against upstream | ||||
|  | ||||
| pkgctl version setup:: | ||||
| 	Automatically detect and setup a basic nvchecker config | ||||
|  | ||||
| pkgctl version upgrade:: | ||||
| 	Adjust the PKGBUILD to match the latest upstream version | ||||
|  | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-version-check(1) | ||||
| pkgctl-version-setup(1) | ||||
| pkgctl-version-upgrade(1) | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
|   | ||||
| @@ -12,12 +12,7 @@ pkgctl [SUBCOMMAND] [OPTIONS] | ||||
| Description | ||||
| ----------- | ||||
|  | ||||
| Command-line utility serving as a unified interface for multiple development tools. | ||||
| This tool aims to simplify and optimize interactions with devtools by offering | ||||
| various subcommands for executing tasks related to package management, repository management, | ||||
| version control, among others. | ||||
|  | ||||
| Utilizing pkgctl enables users to efficiently administer their development workflows. | ||||
| TODO | ||||
|  | ||||
| Options | ||||
| ------- | ||||
| @@ -31,9 +26,6 @@ Options | ||||
| Subcommands | ||||
| ----------- | ||||
|  | ||||
| pkgctl aur:: | ||||
| 	Interact with the Arch User Repository | ||||
|  | ||||
| pkgctl auth:: | ||||
| 	Authenticate with services like GitLab | ||||
|  | ||||
| @@ -46,33 +38,24 @@ pkgctl db:: | ||||
| pkgctl diff:: | ||||
| 	Compare package files using different modes | ||||
|  | ||||
| pkgctl issue:: | ||||
| 	Work with GitLab packaging issues | ||||
|  | ||||
| pkgctl release:: | ||||
| 	Release step to commit, tag and upload build artifacts | ||||
|  | ||||
| pkgctl repo:: | ||||
| 	Manage Git packaging repositories and their configuration | ||||
|  | ||||
| pkgctl search:: | ||||
| 	Search for an expression across the GitLab packaging group | ||||
|  | ||||
| pkgctl version:: | ||||
| 	Check and manage package versions against upstream | ||||
| 	Show pkgctl version information | ||||
|  | ||||
| See Also | ||||
| -------- | ||||
|  | ||||
| pkgctl-aur(1) | ||||
| pkgctl-auth(1) | ||||
| pkgctl-build(1) | ||||
| pkgctl-db(1) | ||||
| pkgctl-diff(1) | ||||
| pkgctl-issue(1) | ||||
| pkgctl-release(1) | ||||
| pkgctl-repo(1) | ||||
| pkgctl-search(1) | ||||
| pkgctl-version(1) | ||||
| linkman:pkgctl-auth[1] | ||||
| linkman:pkgctl-build[1] | ||||
| linkman:pkgctl-db[1] | ||||
| linkman:pkgctl-diff[1] | ||||
| linkman:pkgctl-release[1] | ||||
| linkman:pkgctl-repo[1] | ||||
| linkman:pkgctl-version[1] | ||||
|  | ||||
| include::include/footer.asciidoc[] | ||||
|   | ||||
| @@ -22,13 +22,12 @@ usage() { | ||||
| 	echo "A wrapper around systemd-nspawn. Provides support for pacman." | ||||
| 	echo | ||||
| 	echo ' options:' | ||||
| 	echo '    -C <file>           Location of a pacman config file' | ||||
| 	echo '    -M <file>           Location of a makepkg config file' | ||||
| 	echo '    -c <dir>            Set pacman cache' | ||||
| 	echo '    -f <src>[:<dst>]    Copy src file from the host to the chroot.' | ||||
| 	echo '                        If dst file is not provided, it defaults to src' | ||||
| 	echo '    -s                  Do not run setarch' | ||||
| 	echo '    -h                  This message' | ||||
| 	echo '    -C <file>     Location of a pacman config file' | ||||
| 	echo '    -M <file>     Location of a makepkg config file' | ||||
| 	echo '    -c <dir>      Set pacman cache' | ||||
| 	echo '    -f <file>     Copy file from the host to the chroot' | ||||
| 	echo '    -s            Do not run setarch' | ||||
| 	echo '    -h            This message' | ||||
| 	exit 1 | ||||
| } | ||||
|  | ||||
| @@ -64,8 +63,6 @@ nspawn_args=( | ||||
| 	--slice="devtools-$(systemd-escape "${SUDO_USER:-$USER}")" | ||||
| 	--machine="arch-nspawn-$$" | ||||
| 	--as-pid2 | ||||
| 	--console=autopipe | ||||
| 	--timezone=off | ||||
| ) | ||||
|  | ||||
| if (( ${#cache_dirs[@]} == 0 )); then | ||||
| @@ -74,7 +71,6 @@ fi | ||||
|  | ||||
| # shellcheck disable=2016 | ||||
| host_mirrors=($(pacman-conf --repo extra Server 2> /dev/null | sed -r 's#(.*/)extra/os/.*#\1$repo/os/$arch#')) | ||||
| host_cachemirrors=($(pacman-conf --repo extra CacheServer 2> /dev/null | sed -r 's#(.*/)extra/os/.*#\1$repo/os/$arch#')) | ||||
|  | ||||
| for host_mirror in "${host_mirrors[@]}"; do | ||||
| 	if [[ $host_mirror == *file://* ]]; then | ||||
| @@ -109,17 +105,13 @@ copy_hostconf () { | ||||
|  | ||||
| 	printf 'Server = %s\n' "${host_mirrors[@]}" >"$working_dir/etc/pacman.d/mirrorlist" | ||||
|  | ||||
| 	[[ -n $host_cachemirrors ]] && printf 'CacheServer = %s\n' "${host_cachemirrors[@]}" >>"$working_dir/etc/pacman.d/mirrorlist" | ||||
|  | ||||
| 	[[ -n $pac_conf ]] && cp "$pac_conf" "$working_dir/etc/pacman.conf" | ||||
| 	[[ -n $makepkg_conf ]] && cp "$makepkg_conf" "$working_dir/etc/makepkg.conf" | ||||
|  | ||||
| 	local file | ||||
| 	for file in "${files[@]}"; do | ||||
| 		src="${file%%:*}" | ||||
| 		dst="${file#*:}" | ||||
| 		mkdir -p "$(dirname "$working_dir$dst")" | ||||
| 		cp -T "$src" "$working_dir$dst" | ||||
| 		mkdir -p "$(dirname "$working_dir$file")" | ||||
| 		cp -T "$file" "$working_dir$file" | ||||
| 	done | ||||
|  | ||||
| 	sed -r "s|^#?\\s*CacheDir.+|CacheDir = ${cache_dirs[*]}|g" -i "$working_dir/etc/pacman.conf" | ||||
|   | ||||
| @@ -7,6 +7,8 @@ _DEVTOOLS_LIBRARY_DIR=${_DEVTOOLS_LIBRARY_DIR:-@pkgdatadir@} | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/common.sh | ||||
| # shellcheck source=src/lib/valid-tags.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-tags.sh | ||||
| # shellcheck source=src/lib/util/git.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/util/git.sh | ||||
|  | ||||
| set -e | ||||
|  | ||||
| @@ -35,7 +37,7 @@ fi | ||||
| # validate repo is really repo-arch | ||||
| if [[ -z $FORCE ]]; then | ||||
| 	for tag in "$@"; do | ||||
| 		if ! in_array "$tag" "${DEVTOOLS_VALID_TAGS[@]}"; then | ||||
| 		if ! in_array "$tag" "${_tags[@]}"; then | ||||
| 			die "archrelease: Invalid tag: '%s' (use -f to force release)" "$tag" | ||||
| 		fi | ||||
| 	done | ||||
| @@ -55,8 +57,8 @@ gittag=$(get_tag_from_pkgver "$pkgver") | ||||
| if ! branchname=$(git symbolic-ref --short HEAD); then | ||||
| 	die 'not on any branch' | ||||
| fi | ||||
| if [[ "${branchname}" != main ]]; then | ||||
| 	die 'must be run from the main branch' | ||||
| if ! is_valid_release_branch "${branchname}"; then | ||||
| 	die 'must be run from a valid release branch (%s)' "${VALID_RELEASE_BRANCHES[@]}" | ||||
| fi | ||||
|  | ||||
| # Check if remote origin is setup properly | ||||
| @@ -85,10 +87,10 @@ if git tag --verify "$gittag" &> /dev/null; then | ||||
| 	if [[ "$cwd_checksum" != "$tag_checksum" ]]; then | ||||
| 		die "tagged PKGBUILD is not the same as the working dir PKGBUILD" | ||||
| 	fi | ||||
| 	git push --tags --set-upstream origin main || abort | ||||
| 	git push --tags --set-upstream origin "${branchname}" || abort | ||||
| 	exit 0 | ||||
| fi | ||||
|  | ||||
| msg "Releasing package" | ||||
| git tag --sign --message="Package release ${pkgver}" "$gittag" || abort | ||||
| git push --tags --set-upstream origin main || abort | ||||
| git push --tags --set-upstream origin "${branchname}" || abort | ||||
|   | ||||
| @@ -140,7 +140,7 @@ for _pkgname in "${pkgname[@]}"; do | ||||
| 	bsdtar tf "$TEMPDIR/$oldpkg" | sort > "$TEMPDIR/filelist-$_pkgname-old" | ||||
| 	bsdtar tf "$pkgfile" | sort > "$TEMPDIR/filelist-$_pkgname" | ||||
|  | ||||
| 	diff --side-by-side --suppress-common-lines --width="${COLUMNS:-130}" --color=auto "$TEMPDIR/filelist-$_pkgname-old" "$TEMPDIR/filelist-$_pkgname" | ||||
| 	sdiff -s "$TEMPDIR/filelist-$_pkgname-old" "$TEMPDIR/filelist-$_pkgname" | ||||
|  | ||||
| 	find-libprovides "$TEMPDIR/$oldpkg" 2>/dev/null | sort > "$TEMPDIR/libraries-$_pkgname-old" | ||||
| 	find-libprovides "$pkgfile" 2>/dev/null | sort > "$TEMPDIR/libraries-$_pkgname" | ||||
|   | ||||
| @@ -5,13 +5,11 @@ | ||||
| _DEVTOOLS_LIBRARY_DIR=${_DEVTOOLS_LIBRARY_DIR:-@pkgdatadir@} | ||||
| # shellcheck source=src/lib/common.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/common.sh | ||||
| # shellcheck source=src/lib/util/srcinfo.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/util/srcinfo.sh | ||||
| # shellcheck source=src/lib/util/git.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/util/git.sh | ||||
|  | ||||
| source /usr/share/makepkg/util/util.sh | ||||
|  | ||||
| set -eo pipefail | ||||
|  | ||||
|  | ||||
| check_pkgbuild_validity() { | ||||
| 	# shellcheck source=contrib/makepkg/PKGBUILD.proto | ||||
| @@ -74,14 +72,12 @@ if ! repo_spec=$(git config --local devtools.version) || [[ ${repo_spec} != "${G | ||||
| 	exit 1 | ||||
| fi | ||||
|  | ||||
| if ! repo_variant=$(git config --local devtools.variant) || [[ ${repo_variant} != canonical ]]; then | ||||
| 	error "cannot release from a repository with none canonical specs (%s), try:" "${repo_variant:-development}" | ||||
| 	msg2 'pkgctl repo configure' | ||||
| 	exit 1 | ||||
| if ! branchname=$(git symbolic-ref --short HEAD); then | ||||
| 	die 'not on any branch' | ||||
| fi | ||||
|  | ||||
| if [[ "$(git symbolic-ref --short HEAD)" != main ]]; then | ||||
| 	die 'must be run from the main branch' | ||||
| if ! is_valid_release_branch "${branchname}"; then | ||||
| 	die 'must be run from a valid release branch (%s)' "${VALID_RELEASE_BRANCHES[@]}" | ||||
| fi | ||||
|  | ||||
| source=() | ||||
| @@ -105,6 +101,9 @@ case "$cmd" in | ||||
| 		;; | ||||
| esac | ||||
|  | ||||
| if [[ "${branchname}" == "unstable" ]] && [[ "$repo" != *"unstable" ]]; then | ||||
| 	die 'Cannot release from unstable branch into non-unstable repo: %s' "${repo}" | ||||
| fi | ||||
|  | ||||
| if (( ${#validpgpkeys[@]} != 0 )); then | ||||
| 	if [[ -d keys ]]; then | ||||
| @@ -151,7 +150,7 @@ fi | ||||
|  | ||||
|  | ||||
| server=${PACKAGING_REPO_RELEASE_HOST} | ||||
| rsyncopts=("${RSYNC_OPTS[@]}" --perms --chmod='ug=rw,o=r') | ||||
| rsyncopts=(-e ssh -p '--chmod=ug=rw,o=r' -c -h -L --progress --partial -y) | ||||
| archreleaseopts=() | ||||
| while getopts ':l:a:s:f' flag; do | ||||
| 	case $flag in | ||||
| @@ -187,10 +186,13 @@ done | ||||
| # check for PKGBUILD standards | ||||
| check_pkgbuild_validity | ||||
|  | ||||
| # auto generate .SRCINFO | ||||
| # shellcheck disable=SC2119 | ||||
| write_srcinfo_file | ||||
| git add --force .SRCINFO | ||||
| # auto generate .SRCINFO if present | ||||
| if [[ -f .SRCINFO ]]; then | ||||
| 	stat_busy 'Generating .SRCINFO' | ||||
| 	makepkg --printsrcinfo > .SRCINFO | ||||
| 	git add .SRCINFO | ||||
| 	stat_done | ||||
| fi | ||||
|  | ||||
| if [[ -n $(git status --porcelain --untracked-files=no) ]]; then | ||||
| 	stat_busy 'Staging files' | ||||
| @@ -213,14 +215,14 @@ if [[ -n $(git status --porcelain --untracked-files=no) ]]; then | ||||
| 		echo "$msgtemplate" > "$msgfile" | ||||
| 		if [[ -n $GIT_EDITOR ]]; then | ||||
| 			$GIT_EDITOR "$msgfile" || die | ||||
| 		elif giteditor=$(git config --get core.editor); then | ||||
| 			$giteditor "$msgfile" || die | ||||
| 		elif [[ -n $VISUAL ]]; then | ||||
| 			$VISUAL "$msgfile" || die | ||||
| 		elif [[ -n $EDITOR ]]; then | ||||
| 			$EDITOR "$msgfile" || die | ||||
| 		elif giteditor=$(git config --get core.editor); then | ||||
| 			$giteditor "$msgfile" || die | ||||
| 		else | ||||
| 			die "No usable editor found (tried \$GIT_EDITOR, git config [core.editor], \$VISUAL, \$EDITOR)." | ||||
| 			die "No usable editor found (tried \$GIT_EDITOR, \$VISUAL, \$EDITOR, git config [core.editor])." | ||||
| 		fi | ||||
| 		[[ -s $msgfile ]] || die | ||||
| 		stat_busy 'Committing changes' | ||||
|   | ||||
| @@ -1,60 +0,0 @@ | ||||
| #!/hint/bash | ||||
| # | ||||
| # SPDX-License-Identifier: GPL-3.0-or-later | ||||
|  | ||||
| [[ -z ${DEVTOOLS_INCLUDE_API_ARCHWEB_SH:-} ]] || return 0 | ||||
| DEVTOOLS_INCLUDE_API_ARCHWEB_SH=1 | ||||
|  | ||||
| _DEVTOOLS_LIBRARY_DIR=${_DEVTOOLS_LIBRARY_DIR:-@pkgdatadir@} | ||||
| # shellcheck source=src/lib/common.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/common.sh | ||||
|  | ||||
| set -e | ||||
| set -o pipefail | ||||
|  | ||||
|  | ||||
| archweb_query_all_packages() { | ||||
| 	local -a pkgbases | ||||
|  | ||||
| 	[[ -z ${WORKDIR:-} ]] && setup_workdir | ||||
|  | ||||
| 	stat_busy "Query all released packages" | ||||
| 	mapfile -t pkgbases < <( | ||||
| 		curl --location --show-error --no-progress-meter --fail --retry 3 --retry-delay 3 \ | ||||
| 			"${PKGBASE_MAINTAINER_URL}" 2> "${WORKDIR}/error" \ | ||||
| 			| jq --raw-output --exit-status 'keys[]' 2> "${WORKDIR}/error" | ||||
| 	) | ||||
| 	if ! wait $!; then | ||||
| 		stat_failed | ||||
| 		print_workdir_error | ||||
| 		return 1 | ||||
| 	fi | ||||
| 	stat_done | ||||
|  | ||||
| 	printf "%s\n" "${pkgbases[@]}" | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
|  | ||||
| archweb_query_maintainer_packages() { | ||||
| 	local maintainer=$1 | ||||
| 	local -a pkgbases | ||||
|  | ||||
| 	[[ -z ${WORKDIR:-} ]] && setup_workdir | ||||
|  | ||||
| 	stat_busy "Query maintainer packages" | ||||
| 	mapfile -t pkgbases < <( | ||||
| 		curl --location --show-error --no-progress-meter --fail --retry 3 --retry-delay 3 \ | ||||
| 			"${PKGBASE_MAINTAINER_URL}" 2> "${WORKDIR}/error" \ | ||||
| 			| jq --raw-output --exit-status '. as $parent | keys[] | select(. as $key | $parent[$key] | index("'"${maintainer}"'"))' 2> "${WORKDIR}/error" | ||||
| 	) | ||||
| 	if ! wait $!; then | ||||
| 		stat_failed | ||||
| 		print_workdir_error | ||||
| 		return 1 | ||||
| 	fi | ||||
| 	stat_done | ||||
|  | ||||
| 	printf "%s\n" "${pkgbases[@]}" | ||||
| 	return 0 | ||||
| } | ||||
| @@ -8,72 +8,18 @@ DEVTOOLS_INCLUDE_API_GITLAB_SH=1 | ||||
| _DEVTOOLS_LIBRARY_DIR=${_DEVTOOLS_LIBRARY_DIR:-@pkgdatadir@} | ||||
| # shellcheck source=src/lib/common.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/common.sh | ||||
| # shellcheck source=src/lib/cache.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/cache.sh | ||||
| # shellcheck source=src/lib/config.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/config.sh | ||||
| # shellcheck source=src/lib/valid-issue.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-issue.sh | ||||
|  | ||||
| set -e | ||||
|  | ||||
| graphql_api_call() { | ||||
| 	local outfile=$1 | ||||
| 	local request=$2 | ||||
| 	local node_type=$3 | ||||
| 	local data=$4 | ||||
| 	local hasNextPage cursor | ||||
|  | ||||
| 	# empty token | ||||
| 	if [[ -z "${GITLAB_TOKEN}" ]]; then | ||||
| 		msg_error "  api call failed: No token provided" | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	[[ -z ${WORKDIR:-} ]] && setup_workdir | ||||
| 	api_workdir=$(mktemp --tmpdir="${WORKDIR}" --directory pkgctl-gitlab-api.XXXXXXXXXX) | ||||
|  | ||||
| 	# normalize graphql data and prepare query | ||||
| 	data="${data//\"/\\\"}" | ||||
| 	data='{ | ||||
| 		"query": "'"${data}"'" | ||||
| 	}' | ||||
| 	data="${data//$'\t'/ }" | ||||
| 	data="${data//$'\n'/}" | ||||
|  | ||||
| 	cursor="" | ||||
| 	hasNextPage=true | ||||
| 	while [[ ${hasNextPage} == true ]]; do | ||||
| 		data=$(sed -E 's|after: \\"[a-zA-Z0-9]*\\"|after: \\"'"${cursor}"'\\"|' <<< "${data}") | ||||
| 		result="${api_workdir}/result.${cursor}" | ||||
|  | ||||
| 		if ! curl --request "${request}" \ | ||||
| 				--url "https://${GITLAB_HOST}/api/graphql" \ | ||||
| 				--header "Authorization: Bearer ${GITLAB_TOKEN}" \ | ||||
| 				--header "Content-Type: application/json" \ | ||||
| 				--data "${data}" \ | ||||
| 				--output "${result}" \ | ||||
| 				--silent; then | ||||
| 			msg_error "  api call failed: $(cat "${outfile}")" | ||||
| 			return 1 | ||||
| 		fi | ||||
|  | ||||
| 		hasNextPage=$(jq --raw-output ".data | .${node_type} | .pageInfo | .hasNextPage" < "${result}") | ||||
| 		cursor=$(jq --raw-output ".data | .${node_type} | .pageInfo | .endCursor" < "${result}") | ||||
|  | ||||
| 		cp "${result}" "${api_workdir}/tmp" | ||||
| 		jq ".data.${node_type}.nodes" "${api_workdir}/tmp" > "${result}" | ||||
| 	done | ||||
|  | ||||
| 	jq --slurp add "${api_workdir}"/result.* > "${outfile}" | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| gitlab_api_call() { | ||||
| 	local outfile=$1 | ||||
| 	local request=$2 | ||||
| 	local endpoint=$3 | ||||
| 	local data=${4:-} | ||||
| 	local error | ||||
|  | ||||
| 	# empty token | ||||
| 	if [[ -z "${GITLAB_TOKEN}" ]]; then | ||||
| @@ -92,124 +38,27 @@ gitlab_api_call() { | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	if ! gitlab_check_api_errors "${outfile}"; then | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| gitlab_api_call_paged() { | ||||
| 	local outfile=$1 | ||||
| 	local status_file=$2 | ||||
| 	local request=$3 | ||||
| 	local endpoint=$4 | ||||
| 	local data=${5:-} | ||||
| 	local result header | ||||
|  | ||||
| 	# empty token | ||||
| 	if [[ -z "${GITLAB_TOKEN}" ]]; then | ||||
| 		msg_error "  api call failed: No token provided" | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	[[ -z ${WORKDIR:-} ]] && setup_workdir | ||||
| 	api_workdir=$(mktemp --tmpdir="${WORKDIR}" --directory pkgctl-gitlab-api.XXXXXXXXXX) | ||||
| 	tmp_file=$(mktemp --tmpdir="${api_workdir}" spinner.tmp.XXXXXXXXXX) | ||||
|  | ||||
| 	local next_page=1 | ||||
| 	local total_pages=1 | ||||
| 	local known_total_pages=1 | ||||
| 	local percentage=100 | ||||
|  | ||||
| 	while [[ -n "${next_page}" ]]; do | ||||
| 		percentage=$(( 100 * next_page / total_pages )) | ||||
| 		printf "📡 Querying GitLab: %s/%s [%s] %%spinner%%" \ | ||||
| 			"${BOLD}${next_page}" "${known_total_pages}" "${percentage}%${ALL_OFF}"  \ | ||||
| 			> "${tmp_file}" | ||||
| 		mv "${tmp_file}" "${status_file}" | ||||
|  | ||||
| 		result="${api_workdir}/result.${next_page}" | ||||
| 		header="${api_workdir}/header" | ||||
| 		if ! curl --request "${request}" \ | ||||
| 				--get \ | ||||
| 				--url "https://${GITLAB_HOST}/api/v4/${endpoint}&per_page=100&page=${next_page}" \ | ||||
| 				--header "PRIVATE-TOKEN: ${GITLAB_TOKEN}" \ | ||||
| 				--header "Content-Type: application/json" \ | ||||
| 				--data-urlencode "${data}" \ | ||||
| 				--dump-header "${header}" \ | ||||
| 				--output "${result}" \ | ||||
| 				--silent; then | ||||
| 			msg_error "  api call failed: $(cat "${result}")" | ||||
| 			return 1 | ||||
| 		fi | ||||
|  | ||||
| 		if ! gitlab_check_api_errors "${result}"; then | ||||
| 			return 1 | ||||
| 		fi | ||||
|  | ||||
| 		next_page=$(grep "x-next-page" "${header}" | tr -d '\r' | awk '{ print $2 }') | ||||
| 		total_pages=$(grep "x-total-pages" "${header}" | tr -d '\r' | awk '{ print $2 }') | ||||
| 		# The api is not guaranteed to return x-total-pages for larger query results | ||||
| 		# https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/23931 | ||||
| 		# https://gitlab.com/gitlab-org/gitlab/-/issues/436373 | ||||
| 		if (( total_pages == 0 )); then | ||||
| 			total_pages=${next_page} | ||||
| 			known_total_pages="?" | ||||
| 		else | ||||
| 			known_total_pages=${total_pages} | ||||
| 		fi | ||||
| 	done | ||||
|  | ||||
| 	jq --slurp add "${api_workdir}"/result.* > "${outfile}" | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| gitlab_check_api_errors() { | ||||
| 	local file=$1 | ||||
| 	local error | ||||
|  | ||||
| 	# search API only returns an array, no errors | ||||
| 	if [[ $(jq --raw-output 'type' < "${file}") == "array" ]]; then | ||||
| 		return 0 | ||||
| 	fi | ||||
|  | ||||
| 	# check for general purpose api error | ||||
| 	if error=$(jq --raw-output --exit-status '.error' < "${file}"); then | ||||
| 	if error=$(jq --raw-output --exit-status '.error' < "${outfile}"); then | ||||
| 		msg_error "  api call failed: ${error}" | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	# check for api specific error messages | ||||
| 	if ! jq --raw-output --exit-status '.id' < "${file}" >/dev/null; then | ||||
| 		if jq --raw-output --exit-status '.message | keys[]' < "${file}" &>/dev/null; then | ||||
| 	if ! jq --raw-output --exit-status '.id' < "${outfile}" >/dev/null; then | ||||
| 		if jq --raw-output --exit-status '.message | keys[]' < "${outfile}" &>/dev/null; then | ||||
| 			while read -r error; do | ||||
| 				msg_error "  api call failed: ${error}" | ||||
| 			done < <(jq --raw-output --exit-status '.message|to_entries|map("\(.key) \(.value[])")[]' < "${file}") | ||||
| 		elif error=$(jq --raw-output --exit-status '.message' < "${file}"); then | ||||
| 			done < <(jq --raw-output --exit-status '.message|to_entries|map("\(.key) \(.value[])")[]' < "${outfile}") | ||||
| 		elif error=$(jq --raw-output --exit-status '.message' < "${outfile}"); then | ||||
| 			msg_error "  api call failed: ${error}" | ||||
| 		fi | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| graphql_check_api_errors() { | ||||
| 	local file=$1 | ||||
| 	local error | ||||
|  | ||||
| 	# early exit if we do not have errors | ||||
| 	if ! jq --raw-output --exit-status '.errors[]' < "${file}" &>/dev/null; then | ||||
| 		return 0 | ||||
| 	fi | ||||
|  | ||||
| 	# check for api specific error messages | ||||
| 	while read -r error; do | ||||
| 		msg_error "  api call failed: ${error}" | ||||
| 	done < <(jq --raw-output --exit-status '.errors[].message' < "${file}") | ||||
| 	return 1 | ||||
| } | ||||
|  | ||||
| gitlab_api_get_user() { | ||||
| 	local outfile username | ||||
|  | ||||
| @@ -232,118 +81,6 @@ gitlab_api_get_user() { | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| gitlab_api_get_project_name_mapping() { | ||||
| 	local query=$1 | ||||
| 	local outfile | ||||
|  | ||||
| 	[[ -z ${WORKDIR:-} ]] && setup_workdir | ||||
| 	outfile=$(mktemp --tmpdir="${WORKDIR}" pkgctl-gitlab-api.XXXXXXXXXX) | ||||
|  | ||||
| 	# query user details | ||||
| 	if ! graphql_api_call "${outfile}" POST projects "${query}"; then | ||||
| 		msg_warn "  Invalid token provided?" | ||||
| 		exit 1 | ||||
| 	fi | ||||
|  | ||||
| 	cat "${outfile}" | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| gitlab_lookup_project_names() { | ||||
| 	local status_file=$1; shift | ||||
| 	local project_ids=("$@") | ||||
| 	local graphql_lookup_batch=200 | ||||
|  | ||||
| 	local project_name_cache_file tmp_file from length percentage | ||||
| 	local project_slice query projects mapping_output | ||||
|  | ||||
| 	# collect project ids whose name needs to be looked up | ||||
| 	project_name_cache_file=$(get_cache_file gitlab/project_id_to_name) | ||||
| 	lock 11 "${project_name_cache_file}" "Locking project name cache" | ||||
|  | ||||
| 	# early exit if there is nothing new to look up | ||||
| 	if (( ! ${#project_ids[@]} )); then | ||||
| 		cat "${project_name_cache_file}" | ||||
| 		# close project name cache lock | ||||
| 		lock_close 11 | ||||
| 		return | ||||
| 	fi | ||||
|  | ||||
| 	# reduce project_ids to uncached entries | ||||
| 	mapfile -t project_ids < <( | ||||
| 		printf "%s\n" "${project_ids[@]}" | \ | ||||
| 			grep --invert-match --file <(awk '{ print $1 }' < "${project_name_cache_file}" )) | ||||
|  | ||||
| 	# look up project names | ||||
| 	tmp_file=$(mktemp --tmpdir="${WORKDIR}" pkgctl-gitlab-api-spinner.tmp.XXXXXXXXXX) | ||||
| 	local entries="${#project_ids[@]}" | ||||
| 	local until=0 | ||||
| 	while (( until < entries )); do | ||||
| 		from=${until} | ||||
| 		until=$(( until + graphql_lookup_batch )) | ||||
| 		if (( until > entries )); then | ||||
| 			until=${entries} | ||||
| 		fi | ||||
| 		length=$(( until - from )) | ||||
|  | ||||
| 		percentage=$(( 100 * until / entries )) | ||||
| 		printf "📡 Querying GitLab project names: %s/%s [%s] %%spinner%%" \ | ||||
| 			"${BOLD}${until}" "${entries}" "${percentage}%${ALL_OFF}"  \ | ||||
| 			> "${tmp_file}" | ||||
| 		mv "${tmp_file}" "${status_file}" | ||||
|  | ||||
| 		project_slice=("${project_ids[@]:${from}:${length}}") | ||||
| 		printf -v projects '"gid://gitlab/Project/%s",' "${project_slice[@]}" | ||||
| 		query='{ | ||||
| 			projects(after: "" ids: ['"${projects}"']) { | ||||
| 				pageInfo { | ||||
| 					startCursor | ||||
| 					endCursor | ||||
| 					hasNextPage | ||||
| 				} | ||||
| 				nodes { | ||||
| 					id | ||||
| 					name | ||||
| 				} | ||||
| 			} | ||||
| 		}' | ||||
| 		mapping_output=$(gitlab_api_get_project_name_mapping "${query}") | ||||
|  | ||||
| 		# update cache | ||||
| 		while read -r project_id project_name; do | ||||
| 			printf "%s %s\n" "${project_id}" "${project_name}" >> "${project_name_cache_file}" | ||||
| 		done < <(jq --raw-output \ | ||||
| 			'.[] | "\(.id | rindex("/") as $lastSlash | .[$lastSlash+1:]) \(.name)"' \ | ||||
| 			<<< "${mapping_output}") | ||||
| 	done | ||||
|  | ||||
| 	cat "${project_name_cache_file}" | ||||
|  | ||||
| 	# close project name cache lock | ||||
| 	lock_close 11 | ||||
| } | ||||
|  | ||||
| longest_package_name_from_ids() { | ||||
| 	local project_ids=("$@") | ||||
| 	local longest=0 | ||||
|  | ||||
| 	# collect project ids whose name needs to be looked up | ||||
| 	project_name_cache_file=$(get_cache_file gitlab/project_id_to_name) | ||||
| 	lock 11 "${project_name_cache_file}" "Locking project name cache" | ||||
|  | ||||
| 	# read project_id to name mapping from cache | ||||
| 	while read -r project_id project_name; do | ||||
| 		if (( ${#project_name} > longest )) && in_array "${project_id}" "${project_ids[@]}"; then | ||||
| 			longest="${#project_name}" | ||||
| 		fi | ||||
| 	done < "${project_name_cache_file}" | ||||
|  | ||||
| 	# close project name cache lock | ||||
| 	lock_close 11 | ||||
|  | ||||
| 	printf "%s" "${longest}" | ||||
| } | ||||
|  | ||||
| # Convert arbitrary project names to GitLab valid path names. | ||||
| # | ||||
| # GitLab has several limitations on project and group names and also maintains | ||||
| @@ -393,511 +130,3 @@ gitlab_api_create_project() { | ||||
| 	printf "%s" "${path}" | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| # TODO: parallelize | ||||
| # https://docs.gitlab.com/ee/api/search.html#scope-blobs | ||||
| gitlab_api_search() { | ||||
| 	local search=$1 | ||||
| 	local status_file=$2 | ||||
| 	local outfile | ||||
|  | ||||
| 	[[ -z ${WORKDIR:-} ]] && setup_workdir | ||||
| 	outfile=$(mktemp --tmpdir="${WORKDIR}" pkgctl-gitlab-api.XXXXXXXXXX) | ||||
|  | ||||
| 	if ! gitlab_api_call_paged "${outfile}" "${status_file}" GET "/groups/archlinux%2fpackaging%2fpackages/search?scope=blobs" "search=${search}"; then | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	cat "${outfile}" | ||||
|  | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| # https://docs.gitlab.com/ee/api/projects.html#get-single-project | ||||
| gitlab_project() { | ||||
| 	local project=$1 | ||||
| 	local outfile project_path | ||||
|  | ||||
| 	[[ -z ${WORKDIR:-} ]] && setup_workdir | ||||
| 	outfile=$(mktemp --tmpdir="${WORKDIR}" pkgctl-gitlab-api.XXXXXXXXXX) | ||||
|  | ||||
| 	project_path=$(gitlab_project_name_to_path "${project}") | ||||
|  | ||||
| 	if ! gitlab_api_call "${outfile}" GET "projects/archlinux%2fpackaging%2fpackages%2f${project_path}/"; then | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	cat "${outfile}" | ||||
|  | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| # TODO: parallelize | ||||
| # https://docs.gitlab.com/ee/api/issues.html#list-project-issues | ||||
| gitlab_projects_issues_list() { | ||||
| 	local project=$1 | ||||
| 	local status_file=$2 | ||||
| 	local params=${3:-} | ||||
| 	local data=${4:-} | ||||
| 	local outfile | ||||
|  | ||||
| 	[[ -z ${WORKDIR:-} ]] && setup_workdir | ||||
| 	outfile=$(mktemp --tmpdir="${WORKDIR}" pkgctl-gitlab-api.XXXXXXXXXX) | ||||
|  | ||||
| 	if ! gitlab_api_call_paged "${outfile}" "${status_file}" GET "/projects/archlinux%2fpackaging%2fpackages%2f${project}/issues?${params}" "${data}"; then | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	cat "${outfile}" | ||||
|  | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| # TODO: parallelize | ||||
| # https://docs.gitlab.com/ee/api/issues.html#list-project-issues | ||||
| gitlab_group_issue_list() { | ||||
| 	local group=$1 | ||||
| 	local status_file=$2 | ||||
| 	local params=${3:-} | ||||
| 	local data=${4:-} | ||||
| 	local outfile | ||||
|  | ||||
| 	[[ -z ${WORKDIR:-} ]] && setup_workdir | ||||
| 	outfile=$(mktemp --tmpdir="${WORKDIR}" pkgctl-gitlab-api.XXXXXXXXXX) | ||||
|  | ||||
| 	group=${group//\//%2f} | ||||
| 	params=${params//\[/%5B} | ||||
| 	params=${params//\]/%5D} | ||||
|  | ||||
| 	if ! gitlab_api_call_paged "${outfile}" "${status_file}" GET "/groups/${group}/issues?${params}" "${data}"; then | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	cat "${outfile}" | ||||
| } | ||||
|  | ||||
| # https://docs.gitlab.com/ee/api/issues.html#single-project-issue | ||||
| gitlab_project_issue() { | ||||
| 	local pkgbase=$1 | ||||
| 	local iid=$2 | ||||
| 	local outfile data path project_path | ||||
|  | ||||
| 	[[ -z ${WORKDIR:-} ]] && setup_workdir | ||||
| 	outfile=$(mktemp --tmpdir="${WORKDIR}" pkgctl-gitlab-api.XXXXXXXXXX) | ||||
|  | ||||
| 	project_path=$(gitlab_project_name_to_path "${pkgbase}") | ||||
|  | ||||
| 	if ! gitlab_api_call "${outfile}" GET "projects/archlinux%2fpackaging%2fpackages%2f${project_path}/issues/${iid}"; then | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	if ! path=$(jq --raw-output --exit-status '.title' < "${outfile}"); then | ||||
| 		msg_error "  failed to query path: $(cat "${outfile}")" | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	cat "${outfile}" | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| gitlab_project_issue_create() { | ||||
| 	local pkgbase=$1 | ||||
| 	local title=$2 | ||||
| 	local description=$3 | ||||
| 	local confidential=$4 | ||||
| 	shift 4 | ||||
| 	local labels=("${@}") | ||||
| 	local outfile data iid project_path | ||||
|  | ||||
| 	[[ -z ${WORKDIR:-} ]] && setup_workdir | ||||
| 	outfile=$(mktemp --tmpdir="${WORKDIR}" pkgctl-gitlab-api.XXXXXXXXXX) | ||||
|  | ||||
| 	project_path=$(gitlab_project_name_to_path "${pkgbase}") | ||||
|  | ||||
| 	data=$(jq --null-input \ | ||||
| 		--arg title "${title}" \ | ||||
| 		--arg description "${description}" \ | ||||
| 		--arg confidential "${confidential}" \ | ||||
| 		--arg labels "$(join_by , "${labels[@]}")" \ | ||||
| 		'$ARGS.named') | ||||
| 	if ! gitlab_api_call "${outfile}" POST "/projects/archlinux%2fpackaging%2fpackages%2f${project_path}/issues" "${data}"; then | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	if ! iid=$(jq --raw-output --exit-status '.iid' < "${outfile}"); then | ||||
| 		msg_error "  failed to query note: $(cat "${outfile}")" | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	cat "${outfile}" | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| # TODO: parallelize | ||||
| # https://docs.gitlab.com/ee/api/notes.html#list-project-issue-notes | ||||
| gitlab_project_issue_notes() { | ||||
| 	local project=$1 | ||||
| 	local iid=$2 | ||||
| 	local status_file=$3 | ||||
| 	local params=${4:-} | ||||
| 	local outfile | ||||
|  | ||||
| 	[[ -z ${WORKDIR:-} ]] && setup_workdir | ||||
| 	outfile=$(mktemp --tmpdir="${WORKDIR}" pkgctl-gitlab-api.XXXXXXXXXX) | ||||
|  | ||||
| 	if ! gitlab_api_call_paged "${outfile}" "${status_file}" GET "/projects/archlinux%2fpackaging%2fpackages%2f${project}/issues/${iid}/notes?${params}"; then | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	cat "${outfile}" | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| # https://docs.gitlab.com/ee/api/issues.html#edit-an-issue | ||||
| gitlab_project_issue_edit() { | ||||
| 	local pkgbase=$1 | ||||
| 	local iid=$2 | ||||
| 	local params=$3 | ||||
| 	local data=${4:-} | ||||
| 	local outfile data path project_path | ||||
|  | ||||
| 	[[ -z ${WORKDIR:-} ]] && setup_workdir | ||||
| 	outfile=$(mktemp --tmpdir="${WORKDIR}" pkgctl-gitlab-api.XXXXXXXXXX) | ||||
|  | ||||
| 	project_path=$(gitlab_project_name_to_path "${pkgbase}") | ||||
|  | ||||
| 	if ! gitlab_api_call "${outfile}" PUT "/projects/archlinux%2fpackaging%2fpackages%2f${project_path}/issues/${iid}?${params}" "${data}"; then | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	if ! path=$(jq --raw-output --exit-status '.title' < "${outfile}"); then | ||||
| 		msg_error "  failed to query path: $(cat "${outfile}")" | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	cat "${outfile}" | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| gitlab_create_project_issue_note() { | ||||
| 	local pkgbase=$1 | ||||
| 	local iid=$2 | ||||
| 	local body=$3 | ||||
| 	local outfile data path project_path | ||||
|  | ||||
| 	[[ -z ${WORKDIR:-} ]] && setup_workdir | ||||
| 	outfile=$(mktemp --tmpdir="${WORKDIR}" pkgctl-gitlab-api.XXXXXXXXXX) | ||||
|  | ||||
| 	project_path=$(gitlab_project_name_to_path "${pkgbase}") | ||||
|  | ||||
| 	data=$(jq --null-input --arg body "${body}" '$ARGS.named') | ||||
| 	if ! gitlab_api_call "${outfile}" POST "/projects/archlinux%2fpackaging%2fpackages%2f${project_path}/issues/${iid}/notes" "${data}"; then | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	if ! path=$(jq --raw-output --exit-status '.body' < "${outfile}"); then | ||||
| 		msg_error "  failed to query note: $(cat "${outfile}")" | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	cat "${outfile}" | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| gitlab_project_issue_move() { | ||||
| 	local pkgbase=$1 | ||||
| 	local iid=$2 | ||||
| 	local to_project_id=$3 | ||||
| 	local outfile path project_path | ||||
|  | ||||
| 	[[ -z ${WORKDIR:-} ]] && setup_workdir | ||||
| 	outfile=$(mktemp --tmpdir="${WORKDIR}" pkgctl-gitlab-api.XXXXXXXXXX) | ||||
|  | ||||
| 	project_path=$(gitlab_project_name_to_path "${pkgbase}") | ||||
|  | ||||
| 	if ! gitlab_api_call "${outfile}" POST "/projects/archlinux%2fpackaging%2fpackages%2f${project_path}/issues/${iid}/move?to_project_id=${to_project_id}"; then | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	if ! path=$(jq --raw-output --exit-status '.title' < "${outfile}"); then | ||||
| 		msg_error "  failed to move issue: $(cat "${outfile}")" | ||||
| 		return 1 | ||||
| 	fi | ||||
|  | ||||
| 	cat "${outfile}" | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| gitlab_severity_from_labels() { | ||||
| 	local labels=("$@") | ||||
| 	local severity="unknown" | ||||
| 	local label | ||||
| 	for label in "${labels[@]}"; do | ||||
| 		if [[ ${label} == severity::* ]]; then | ||||
| 			severity="${label#*-}" | ||||
| 		fi | ||||
| 	done | ||||
| 	printf "%s" "${severity}" | ||||
| } | ||||
|  | ||||
| severity_as_gitlab_label() { | ||||
| 	local severity=$1 | ||||
| 	case "${severity}" in | ||||
| 		lowest) | ||||
| 			printf "severity::5-%s" "${severity}" ;; | ||||
| 		low) | ||||
| 			printf "severity::4-%s" "${severity}" ;; | ||||
| 		medium) | ||||
| 			printf "severity::3-%s" "${severity}" ;; | ||||
| 		high) | ||||
| 			printf "severity::2-%s" "${severity}" ;; | ||||
| 		critical) | ||||
| 			printf "severity::1-%s" "${severity}" ;; | ||||
| 		*) | ||||
| 			return 1 ;; | ||||
| 	esac | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| gitlab_priority_from_labels() { | ||||
| 	local labels=("$@") | ||||
| 	local priority="normal" | ||||
| 	local label | ||||
| 	for label in "${labels[@]}"; do | ||||
| 		if [[ ${label} == priority::* ]]; then | ||||
| 			priority="${label#*-}" | ||||
| 		fi | ||||
| 	done | ||||
| 	printf "%s" "${priority}" | ||||
| } | ||||
|  | ||||
| priority_as_gitlab_label() { | ||||
| 	local priority=$1 | ||||
| 	case "${priority}" in | ||||
| 		low) | ||||
| 			printf "priority::4-%s" "${priority}" ;; | ||||
| 		normal) | ||||
| 			printf "priority::3-%s" "${priority}" ;; | ||||
| 		high) | ||||
| 			printf "priority::2-%s" "${priority}" ;; | ||||
| 		urgent) | ||||
| 			printf "priority::1-%s" "${priority}" ;; | ||||
| 		*) | ||||
| 			return 1 ;; | ||||
| 	esac | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| gitlab_scope_from_labels() { | ||||
| 	local labels=("$@") | ||||
| 	local scope="unknown" | ||||
| 	local label | ||||
| 	for label in "${labels[@]}"; do | ||||
| 		if [[ ${label} == scope::* ]]; then | ||||
| 			scope="${label#*::}" | ||||
| 		fi | ||||
| 	done | ||||
| 	printf "%s" "${scope}" | ||||
| } | ||||
|  | ||||
| scope_as_gitlab_label() { | ||||
| 	local scope=$1 | ||||
| 	if ! in_array "${scope}" "${DEVTOOLS_VALID_ISSUE_SCOPE[@]}"; then | ||||
| 		return 1 | ||||
| 	fi | ||||
| 	printf "scope::%s" "${scope}" | ||||
| } | ||||
|  | ||||
| gitlab_scope_short() { | ||||
| 	local scope=$1 | ||||
| 	case "${scope}" in | ||||
| 		regression) | ||||
| 			scope=regress ;; | ||||
| 		enhancement) | ||||
| 			scope=enhance ;; | ||||
| 		documentation) | ||||
| 			scope=doc ;; | ||||
| 		reproducibility) | ||||
| 			scope=repro ;; | ||||
| 		out-of-date) | ||||
| 			scope=ood ;; | ||||
| 	esac | ||||
| 	printf "%s" "${scope}" | ||||
| } | ||||
|  | ||||
| gitlab_scope_color() { | ||||
| 	local scope=$1 | ||||
| 	local color="${GRAY}" | ||||
|  | ||||
| 	case "${scope}" in | ||||
| 		bug) | ||||
| 			color="${DARK_RED}" ;; | ||||
| 		feature) | ||||
| 			color="${DARK_BLUE}" ;; | ||||
| 		security) | ||||
| 			color="${RED}" ;; | ||||
| 		question) | ||||
| 			color="${PURPLE}" ;; | ||||
| 		regression) | ||||
| 			color="${DARK_RED}" ;; | ||||
| 		enhancement) | ||||
| 			color="${DARK_BLUE}" ;; | ||||
| 		documentation) | ||||
| 			color="${ALL_OFF}" ;; | ||||
| 		reproducibility) | ||||
| 			color="${DARK_GREEN}" ;; | ||||
| 		out-of-date) | ||||
| 			color="${DARK_YELLOW}" ;; | ||||
| 	esac | ||||
|  | ||||
| 	printf "%s" "${color}" | ||||
| } | ||||
|  | ||||
| status_as_gitlab_label() { | ||||
| 	local status=$1 | ||||
| 	if ! in_array "${status}" "${DEVTOOLS_VALID_ISSUE_STATUS[@]}"; then | ||||
| 		return 1 | ||||
| 	fi | ||||
| 	printf "status::%s" "${status}" | ||||
| 	return 0 | ||||
| } | ||||
|  | ||||
| gitlab_issue_state_display() { | ||||
| 	local state=$1 | ||||
| 	if [[ ${state} == opened ]]; then | ||||
| 		state=open | ||||
| 	fi | ||||
| 	printf "%s" "${state}" | ||||
| } | ||||
|  | ||||
| gitlab_issue_status_from_labels() { | ||||
| 	local labels=("$@") | ||||
| 	local status=unconfirmed | ||||
| 	local label | ||||
| 	for label in "${labels[@]}"; do | ||||
| 		if [[ ${label} == status::* ]]; then | ||||
| 			status="${label#*::}" | ||||
| 		fi | ||||
| 	done | ||||
| 	printf "%s" "${status}" | ||||
| } | ||||
|  | ||||
| gitlab_issue_status_short() { | ||||
| 	local status=$1 | ||||
| 	if [[ ${status} == waiting-* ]]; then | ||||
| 		status=waiting | ||||
| 	fi | ||||
| 	printf "%s" "${status}" | ||||
| } | ||||
|  | ||||
| gitlab_issue_status_color() { | ||||
| 	local status=$1 | ||||
| 	local color="${GRAY}" | ||||
|  | ||||
| 	case "${status}" in | ||||
| 		confirmed) | ||||
| 			color="${GREEN}" ;; | ||||
| 		in-progress) | ||||
| 			color="${YELLOW}" ;; | ||||
| 		in-review) | ||||
| 			color="${PURPLE}" ;; | ||||
| 		on-hold|unconfirmed) | ||||
| 			color="${GRAY}" ;; | ||||
| 		waiting-input|waiting-upstream) | ||||
| 			color="${DARK_BLUE}" ;; | ||||
| 	esac | ||||
|  | ||||
| 	printf "%s" "${color}" | ||||
| } | ||||
|  | ||||
| resolution_as_gitlab_label() { | ||||
| 	local resolution=$1 | ||||
| 	if ! in_array "${resolution}" "${DEVTOOLS_VALID_ISSUE_RESOLUTION[@]}"; then | ||||
| 		return 1 | ||||
| 	fi | ||||
| 	printf "resolution::%s" "${resolution}" | ||||
| } | ||||
|  | ||||
| gitlab_resolution_from_labels() { | ||||
| 	local labels=("$@") | ||||
| 	local label | ||||
| 	for label in "${labels[@]}"; do | ||||
| 		if [[ ${label} == resolution::* ]]; then | ||||
| 			printf "%s" "${label#*::}" | ||||
| 			return 0 | ||||
| 		fi | ||||
| 	done | ||||
| 	return 1 | ||||
| } | ||||
|  | ||||
| gitlab_resolution_color() { | ||||
| 	local resolution=$1 | ||||
| 	local color="" | ||||
|  | ||||
| 	case "${resolution}" in | ||||
| 		cant-reproduce) | ||||
| 			color="${DARK_YELLOW}" ;; | ||||
| 		completed) | ||||
| 			color="${GREEN}" ;; | ||||
| 		duplicate) | ||||
| 			color="${GRAY}" ;; | ||||
| 		invalid) | ||||
| 			color="${DARK_YELLOW}" ;; | ||||
| 		not-a-bug) | ||||
| 			color="${GRAY}" ;; | ||||
| 		upstream) | ||||
| 			color="${PURPLE}" ;; | ||||
| 		wont-fix) | ||||
| 			color="${DARK_BLUE}" ;; | ||||
| 	esac | ||||
|  | ||||
| 	printf "%s" "${color}" | ||||
| } | ||||
|  | ||||
| gitlab_severity_color() { | ||||
| 	local severity=$1 | ||||
| 	local color="${PURPLE}" | ||||
|  | ||||
| 	case "${severity}" in | ||||
| 		lowest) | ||||
| 			color="${DARK_GREEN}" ;; | ||||
| 		low) | ||||
| 			color="${GREEN}" ;; | ||||
| 		medium) | ||||
| 			color="${YELLOW}" ;; | ||||
| 		high) | ||||
| 			color="${RED}" ;; | ||||
| 		critical) | ||||
| 			color="${RED}${UNDERLINE}" ;; | ||||
| 	esac | ||||
|  | ||||
| 	printf "%s" "${color}" | ||||
| } | ||||
|  | ||||
| gitlab_priority_color() { | ||||
| 	local priority=$1 | ||||
| 	local color="${PURPLE}" | ||||
|  | ||||
| 	case "${priority}" in | ||||
| 		low) | ||||
| 			color="${DARK_GREEN}" ;; | ||||
| 		normal) | ||||
| 			color="${GREEN}" ;; | ||||
| 		high) | ||||
| 			color="${YELLOW}" ;; | ||||
| 		urgent) | ||||
| 			color="${RED}" ;; | ||||
| 	esac | ||||
|  | ||||
| 	printf "%s" "${color}" | ||||
| } | ||||
|  | ||||
| gitlab_issue_state_color() { | ||||
| 	local state=$1 | ||||
| 	local state_color="${DARK_GREEN}" | ||||
|  | ||||
| 	if [[ ${state} == closed ]]; then | ||||
| 		state_color="${DARK_RED}" | ||||
| 	fi | ||||
| 	printf "%s" "${state_color}" | ||||
| } | ||||
|   | ||||
| @@ -1,65 +0,0 @@ | ||||
| #!/hint/bash | ||||
| # | ||||
| # SPDX-License-Identifier: GPL-3.0-or-later | ||||
|  | ||||
| [[ -z ${DEVTOOLS_INCLUDE_AUR_SH:-} ]] || return 0 | ||||
| DEVTOOLS_INCLUDE_AUR_SH=1 | ||||
|  | ||||
| _DEVTOOLS_LIBRARY_DIR=${_DEVTOOLS_LIBRARY_DIR:-@pkgdatadir@} | ||||
|  | ||||
| set -eo pipefail | ||||
|  | ||||
|  | ||||
| pkgctl_aur_usage() { | ||||
| 	local -r COMMAND=${_DEVTOOLS_COMMAND:-${BASH_SOURCE[0]##*/}} | ||||
| 	cat <<- _EOF_ | ||||
| 		Usage: ${COMMAND} [COMMAND] [OPTIONS] | ||||
|  | ||||
| 		Interact with the Arch User Repository (AUR). | ||||
|  | ||||
| 		Provides a suite of tools designed for managing and interacting with the Arch | ||||
| 		User Repository (AUR). It simplifies various tasks related to AUR, including | ||||
| 		importing repositories, managing packages, and transitioning packages between | ||||
| 		the official repositories and the AUR. | ||||
|  | ||||
| 		COMMANDS | ||||
| 		    drop-from-repo    Drop a package from the official repository to the AUR | ||||
|  | ||||
| 		OPTIONS | ||||
| 		    -h, --help        Show this help text | ||||
|  | ||||
| 		EXAMPLES | ||||
| 		    $ ${COMMAND} drop-from-repo libfoo | ||||
| _EOF_ | ||||
| } | ||||
|  | ||||
| pkgctl_aur() { | ||||
| 	if (( $# < 1 )); then | ||||
| 		pkgctl_aur_usage | ||||
| 		exit 0 | ||||
| 	fi | ||||
|  | ||||
| 	# option checking | ||||
| 	while (( $# )); do | ||||
| 		case $1 in | ||||
| 			-h|--help) | ||||
| 				pkgctl_aur_usage | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			drop-from-repo) | ||||
| 				_DEVTOOLS_COMMAND+=" $1" | ||||
| 				shift | ||||
| 				# shellcheck source=src/lib/aur/drop-from-repo.sh | ||||
| 				source "${_DEVTOOLS_LIBRARY_DIR}"/lib/aur/drop-from-repo.sh | ||||
| 				pkgctl_aur_drop_from_repo "$@" | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			-*) | ||||
| 				die "invalid argument: %s" "$1" | ||||
| 				;; | ||||
| 			*) | ||||
| 				die "invalid command: %s" "$1" | ||||
| 				;; | ||||
| 		esac | ||||
| 	done | ||||
| } | ||||
| @@ -1,173 +0,0 @@ | ||||
| #!/bin/bash | ||||
| # | ||||
| # SPDX-License-Identifier: GPL-3.0-or-later | ||||
|  | ||||
| [[ -z ${DEVTOOLS_INCLUDE_AUR_DROP_FROM_REPO_SH:-} ]] || return 0 | ||||
| DEVTOOLS_INCLUDE_AUR_DROP_FROM_REPO_SH=1 | ||||
|  | ||||
| _DEVTOOLS_LIBRARY_DIR=${_DEVTOOLS_LIBRARY_DIR:-@pkgdatadir@} | ||||
|  | ||||
| # shellcheck source=src/lib/common.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/common.sh | ||||
| # shellcheck source=src/lib/db/remove.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/db/remove.sh | ||||
| # shellcheck source=src//lib/util/pacman.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/util/pacman.sh | ||||
|  | ||||
| source /usr/share/makepkg/util/message.sh | ||||
|  | ||||
| set -eo pipefail | ||||
|  | ||||
|  | ||||
| pkgctl_aur_drop_from_repo_usage() { | ||||
| 	local -r COMMAND=${_DEVTOOLS_COMMAND:-${BASH_SOURCE[0]##*/}} | ||||
| 	cat <<- _EOF_ | ||||
| 		Usage: ${COMMAND} [OPTIONS] [PATH]... | ||||
|  | ||||
| 		Drops a specified package from the official repositories to the Arch | ||||
| 		User Repository. | ||||
|  | ||||
| 		This command requires a local Git clone of the package repository. It | ||||
| 		reconfigures the repository for AUR compatibility and pushes it to the | ||||
| 		AUR. Afterwards, the package is removed from the official repository. | ||||
|  | ||||
| 		By default, the package is automatically disowned in the AUR. | ||||
|  | ||||
| 		OPTIONS | ||||
| 		    --no-disown    Do not disown the package on the AUR | ||||
| 		    -f, --force    Force push to the AUR overwriting the remote repository | ||||
| 		    -h, --help     Show this help text | ||||
|  | ||||
| 		EXAMPLES | ||||
| 		    $ ${COMMAND} foo | ||||
| 		    $ ${COMMAND} --no-disown --force | ||||
| _EOF_ | ||||
| } | ||||
|  | ||||
| pkgctl_aur_drop_from_repo() { | ||||
| 	# options | ||||
| 	local paths=() | ||||
| 	local DISOWN=1 | ||||
| 	local FORCE=0 | ||||
|  | ||||
| 	# variables | ||||
| 	local path realpath pkgbase pkgrepo remote_url | ||||
|  | ||||
| 	while (( $# )); do | ||||
| 		case $1 in | ||||
| 			-h|--help) | ||||
| 				pkgctl_aur_drop_from_repo_usage | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			--no-disown) | ||||
| 				DISOWN=0 | ||||
| 				shift | ||||
| 				;; | ||||
| 			-f|--force) | ||||
| 				FORCE=1 | ||||
| 				shift | ||||
| 				;; | ||||
| 			--) | ||||
| 				shift | ||||
| 				break | ||||
| 				;; | ||||
| 			-*) | ||||
| 				die "Invalid argument: %s" "$1" | ||||
| 				;; | ||||
| 			*) | ||||
| 				paths=("$@") | ||||
| 				break | ||||
| 				;; | ||||
| 		esac | ||||
| 	done | ||||
|  | ||||
| 	# check if invoked without any path from within a packaging repo | ||||
| 	if (( ${#paths[@]} == 0 )); then | ||||
| 		if [[ -f PKGBUILD ]]; then | ||||
| 			paths=(".") | ||||
| 		else | ||||
| 			pkgctl_aur_drop_from_repo_usage | ||||
| 			exit 1 | ||||
| 		fi | ||||
| 	fi | ||||
|  | ||||
| 	for path in "${paths[@]}"; do | ||||
| 		# resolve symlink for basename | ||||
| 		if ! realpath=$(realpath --canonicalize-existing -- "${path}"); then | ||||
| 			die "No such directory: ${path}" | ||||
| 		fi | ||||
| 		# skip paths that are not directories | ||||
| 		if [[ ! -d "${realpath}" ]]; then | ||||
| 			continue | ||||
| 		fi | ||||
|  | ||||
| 		pkgbase=$(basename "${realpath}") | ||||
| 		pkgbase=${pkgbase%.git} | ||||
|  | ||||
| 		if [[ ! -d "${realpath}/.git" ]]; then | ||||
| 			die "Not a Git repository: ${path}" | ||||
| 		fi | ||||
|  | ||||
| 		pushd "${path}" >/dev/null | ||||
|  | ||||
| 		if [[ ! -f PKGBUILD ]]; then | ||||
| 			die 'PKGBUILD not found in %s' "${path}" | ||||
| 		fi | ||||
|  | ||||
| 		msg "Dropping ${pkgbase} to the AUR" | ||||
|  | ||||
| 		remote_url="${AUR_URL_SSH}:${pkgbase}.git" | ||||
| 		if ! git remote add origin "${remote_url}" &>/dev/null; then | ||||
| 			git remote set-url origin "${remote_url}" | ||||
| 		fi | ||||
|  | ||||
| 		# move the main branch to master | ||||
| 		if [[ $(git symbolic-ref --quiet --short HEAD) == main ]]; then | ||||
| 			git branch --move master | ||||
| 			git config branch.master.merge refs/heads/master | ||||
| 		fi | ||||
|  | ||||
| 		# auto generate .SRCINFO if not already present | ||||
| 		if [[ -z "$(git ls-tree -r HEAD --name-only .SRCINFO)" ]]; then | ||||
| 			stat_busy 'Generating .SRCINFO' | ||||
| 			makepkg --printsrcinfo > .SRCINFO | ||||
| 			stat_done | ||||
|  | ||||
| 			git add --force -- .SRCINFO | ||||
| 			git commit --quiet --message "Adding .SRCINFO" -- .SRCINFO | ||||
| 		fi | ||||
|  | ||||
| 		msg "Pushing ${pkgbase} to the AUR" | ||||
| 		if (( FORCE )); then | ||||
| 			AUR_OVERWRITE=1 \ | ||||
| 				GIT_SSH_COMMAND="ssh -o SendEnv=AUR_OVERWRITE" \ | ||||
| 				git push --force --no-follow-tags origin master | ||||
| 		else | ||||
| 			git push --no-follow-tags origin master | ||||
| 		fi | ||||
|  | ||||
| 		# update the local default branch in case this clone is used in the future | ||||
| 		git remote set-head origin master | ||||
|  | ||||
| 		if (( DISOWN )); then | ||||
| 			msg "Disowning ${pkgbase} on the AUR" | ||||
| 			# shellcheck disable=SC2029 | ||||
| 			ssh "${AUR_URL_SSH}" disown "${pkgbase}" | ||||
| 		fi | ||||
|  | ||||
| 		# auto-detection of the repo to remove from | ||||
| 		if ! pkgrepo=$(get_pacman_repo_from_pkgbuild PKGBUILD); then | ||||
| 			die 'Failed to get pacman repo' | ||||
| 		fi | ||||
|  | ||||
| 		msg "Deleting ${pkgbase} from the official repository" | ||||
| 		if [[ -z "${pkgrepo}" ]]; then | ||||
| 			warning 'Did not find %s in any repository, please delete manually' "${pkgbase}" | ||||
| 		else | ||||
| 			msg2 "  repo: ${pkgrepo}" | ||||
| 			pkgctl_db_remove --noconfirm "${pkgrepo}" "${pkgbase}" | ||||
| 		fi | ||||
|  | ||||
| 		popd >/dev/null | ||||
| 	done | ||||
| } | ||||
| @@ -63,7 +63,7 @@ pkgctl_auth_login() { | ||||
| 		esac | ||||
| 	done | ||||
|  | ||||
| 	personal_access_token_url="https://${GITLAB_HOST}/-/user_settings/personal_access_tokens?name=pkgctl+token&scopes=api,write_repository" | ||||
| 	personal_access_token_url="https://${GITLAB_HOST}/-/profile/personal_access_tokens?name=pkgctl+token&scopes=api,write_repository" | ||||
|  | ||||
|     cat <<- _EOF_ | ||||
| 	Logging into ${BOLD}${GITLAB_HOST}${ALL_OFF} | ||||
|   | ||||
| @@ -14,25 +14,18 @@ source "${_DEVTOOLS_LIBRARY_DIR}"/lib/db/update.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/release.sh | ||||
| # shellcheck source=src/lib/util/git.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/util/git.sh | ||||
| # shellcheck source=src/lib/util/srcinfo.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/util/srcinfo.sh | ||||
| # shellcheck source=src/lib/util/pacman.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/util/pacman.sh | ||||
| # shellcheck source=src/lib/util/pkgbuild.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/util/pkgbuild.sh | ||||
| # shellcheck source=src/lib/valid-build-install.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-build-install.sh | ||||
| # shellcheck source=src/lib/valid-repos.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-repos.sh | ||||
| # shellcheck source=src/lib/valid-tags.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-tags.sh | ||||
| # shellcheck source=src/lib/valid-inspect.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-inspect.sh | ||||
|  | ||||
| source /usr/share/makepkg/util/config.sh | ||||
| source /usr/share/makepkg/util/message.sh | ||||
|  | ||||
| set -eo pipefail | ||||
| set -e | ||||
| set -o pipefail | ||||
|  | ||||
|  | ||||
| pkgctl_build_usage() { | ||||
| @@ -49,24 +42,19 @@ pkgctl_build_usage() { | ||||
|  | ||||
| 		BUILD OPTIONS | ||||
| 		    --arch ARCH          Specify architectures to build for (disables auto-detection) | ||||
| 		    --repo REPO          Specify target repository for new packages not in any official repo | ||||
| 		    --repo REPO          Specify a target repository (disables auto-detection) | ||||
| 		    -s, --staging        Build against the staging counterpart of the auto-detected repo | ||||
| 		    -t, --testing        Build against the testing counterpart of the auto-detected repo | ||||
| 		    -o, --offload        Build on a remote server and transfer artifacts afterwards | ||||
| 		    -c, --clean          Recreate the chroot before building | ||||
| 		    --inspect WHEN       Spawn an interactive shell to inspect the chroot (never, always, failure) | ||||
| 		    -I, --install FILE   Install a package into the working copy of the chroot | ||||
| 		    -w, --worker SLOT    Name of the worker slot, useful for concurrent builds (disables automatic names) | ||||
| 		    --nocheck            Do not run the check() function in the PKGBUILD | ||||
|  | ||||
| 		INSTALL OPTIONS | ||||
| 		    -I, --install-to-chroot FILE   Install a package to the working copy of the chroot | ||||
| 		    -i, --install-to-host MODE     Install the built package to the host system, possible modes are 'all' and 'auto' | ||||
|  | ||||
| 		PKGBUILD OPTIONS | ||||
| 		    --pkgver=PKGVER      Set pkgver, reset pkgrel and update checksums | ||||
| 		    --pkgrel=PKGREL      Set pkgrel to a given value | ||||
| 		    --rebuild            Increment the current pkgrel variable | ||||
| 		    --update-checksums   Force computation and update of the checksums (disables auto-detection) | ||||
| 		    -e, --edit           Edit the PKGBUILD before building | ||||
|  | ||||
| 		RELEASE OPTIONS | ||||
| @@ -79,8 +67,8 @@ pkgctl_build_usage() { | ||||
|  | ||||
| 		EXAMPLES | ||||
| 		    $ ${COMMAND} | ||||
| 		    $ ${COMMAND} --rebuild --staging --release --message 'libyay 0.42 rebuild' libfoo libbar | ||||
| 		    $ ${COMMAND} --pkgver=1.42 --release --db-update | ||||
| 		    $ ${COMMAND} --rebuild --staging --message 'libyay 0.42 rebuild' libfoo libbar | ||||
| 		    $ ${COMMAND} --pkgver 1.42 --release --db-update | ||||
| _EOF_ | ||||
| } | ||||
|  | ||||
| @@ -89,7 +77,8 @@ pkgctl_build_check_option_group_repo() { | ||||
| 	local repo=$2 | ||||
| 	local testing=$3 | ||||
| 	local staging=$4 | ||||
| 	if [[ -n "${repo}" ]] || (( testing )) || (( staging )); then | ||||
| 	if ( (( testing )) && (( staging )) ) || | ||||
| 		( [[ $repo =~ ^.*-(staging|testing)$ ]] && ( (( testing )) || (( staging )) )); then | ||||
| 		die "The argument '%s' cannot be used with one or more of the other specified arguments" "${option}" | ||||
| 		exit 1 | ||||
| 	fi | ||||
| @@ -115,7 +104,7 @@ pkgctl_build() { | ||||
| 		exit 1 | ||||
| 	fi | ||||
|  | ||||
| 	local UPDATE_CHECKSUMS=0 | ||||
| 	local UPDPKGSUMS=0 | ||||
| 	local EDIT=0 | ||||
| 	local REBUILD=0 | ||||
| 	local OFFLOAD=0 | ||||
| @@ -123,7 +112,6 @@ pkgctl_build() { | ||||
| 	local TESTING=0 | ||||
| 	local RELEASE=0 | ||||
| 	local DB_UPDATE=0 | ||||
| 	local INSTALL_TO_HOST=none | ||||
|  | ||||
| 	local REPO= | ||||
| 	local PKGVER= | ||||
| @@ -136,13 +124,12 @@ pkgctl_build() { | ||||
| 	local MAKECHROOT_OPTIONS=() | ||||
| 	local RELEASE_OPTIONS=() | ||||
| 	local MAKEPKG_OPTIONS=() | ||||
| 	local INSTALL_HOST_PACKAGES=() | ||||
|  | ||||
| 	local WORKER= | ||||
| 	local WORKER_SLOT= | ||||
|  | ||||
| 	# variables | ||||
| 	local _arch path pkgbase pkgrepo source pkgbuild_checksum current_checksum | ||||
| 	local loop_arch path pkgbase pkgrepo source | ||||
|  | ||||
| 	while (( $# )); do | ||||
| 		case $1 in | ||||
| @@ -152,19 +139,18 @@ pkgctl_build() { | ||||
| 				;; | ||||
| 			--repo) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				pkgctl_build_check_option_group_repo '--repo' "${REPO}" "${TESTING}" "${STAGING}" | ||||
| 				REPO="${2}" | ||||
| 				RELEASE_OPTIONS+=("--repo" "${REPO}") | ||||
| 				pkgctl_build_check_option_group_repo '--repo' "${REPO}" "${TESTING}" "${STAGING}" | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--arch) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if [[ ${2} == all ]]; then | ||||
| 					BUILD_ARCH=("${DEVTOOLS_VALID_ARCHES[@]::${#DEVTOOLS_VALID_ARCHES[@]}-1}") | ||||
| 					BUILD_ARCH=("${_arch[@]::${#_arch[@]}-1}") | ||||
| 				elif [[ ${2} == any ]]; then | ||||
| 					BUILD_ARCH=("${DEVTOOLS_VALID_ARCHES[0]}") | ||||
| 					BUILD_ARCH=("${_arch[0]}") | ||||
| 				elif ! in_array "${2}" "${BUILD_ARCH[@]}"; then | ||||
| 					if ! in_array "${2}" "${DEVTOOLS_VALID_ARCHES[@]}"; then | ||||
| 					if ! in_array "${2}" "${_arch[@]}"; then | ||||
| 						die 'invalid architecture: %s' "${2}" | ||||
| 					fi | ||||
| 					BUILD_ARCH+=("${2}") | ||||
| @@ -175,7 +161,7 @@ pkgctl_build() { | ||||
| 				pkgctl_build_check_option_group_ver '--pkgver' "${PKGVER}" "${PKGREL}" "${REBUILD}" | ||||
| 				PKGVER="${1#*=}" | ||||
| 				PKGREL=1 | ||||
| 				UPDATE_CHECKSUMS=1 | ||||
| 				UPDPKGSUMS=1 | ||||
| 				shift | ||||
| 				;; | ||||
| 			--pkgrel=*) | ||||
| @@ -183,10 +169,6 @@ pkgctl_build() { | ||||
| 				PKGREL="${1#*=}" | ||||
| 				shift | ||||
| 				;; | ||||
| 			--update-checksums) | ||||
| 				UPDATE_CHECKSUMS=1 | ||||
| 				shift | ||||
| 				;; | ||||
| 			--rebuild) | ||||
| 				# shellcheck source=src/lib/util/git.sh | ||||
| 				source "${_DEVTOOLS_LIBRARY_DIR}"/lib/util/git.sh | ||||
| @@ -203,37 +185,23 @@ pkgctl_build() { | ||||
| 				shift | ||||
| 				;; | ||||
| 			-s|--staging) | ||||
| 				pkgctl_build_check_option_group_repo '--staging' "${REPO}" "${TESTING}" "${STAGING}" | ||||
| 				STAGING=1 | ||||
| 				RELEASE_OPTIONS+=("--staging") | ||||
| 				pkgctl_build_check_option_group_repo '--staging' "${REPO}" "${TESTING}" "${STAGING}" | ||||
| 				shift | ||||
| 				;; | ||||
| 			-t|--testing) | ||||
| 				pkgctl_build_check_option_group_repo '--testing' "${REPO}" "${TESTING}" "${STAGING}" | ||||
| 				TESTING=1 | ||||
| 				RELEASE_OPTIONS+=("--testing") | ||||
| 				pkgctl_build_check_option_group_repo '--testing' "${REPO}" "${TESTING}" "${STAGING}" | ||||
| 				shift | ||||
| 				;; | ||||
| 			-c|--clean) | ||||
| 				BUILD_OPTIONS+=("-c") | ||||
| 				shift | ||||
| 				;; | ||||
| 			-I|--install-to-chroot) | ||||
| 			-I|--install) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if (( OFFLOAD )); then | ||||
| 					MAKECHROOT_OPTIONS+=("-I" "$2") | ||||
| 				else | ||||
| 					MAKECHROOT_OPTIONS+=("-I" "$(realpath "$2")") | ||||
| 				fi | ||||
| 				warning 'installing packages to the chroot may break reproducible builds, use with caution!' | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			-i|--install-to-host) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! in_array "$2" "${DEVTOOLS_VALID_BUILD_INSTALL[@]}"; then | ||||
| 					die 'invalid install mode: %s' "${2}" | ||||
| 				fi | ||||
| 				INSTALL_TO_HOST=$2 | ||||
| 				MAKECHROOT_OPTIONS+=("-I" "$2") | ||||
| 				warning 'installing packages into the chroot may break reproducible builds, use with caution!' | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--nocheck) | ||||
| @@ -241,14 +209,6 @@ pkgctl_build() { | ||||
| 				warning 'not running checks is disallowed for official packages, except for bootstrapping. Please rebuild after bootstrapping is completed!' | ||||
| 				shift | ||||
| 				;; | ||||
| 			--inspect) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! in_array "${2}" "${DEVTOOLS_VALID_INSPECT_MODES[@]}"; then | ||||
| 					die "Invalid inspect mode: %s" "${2}" | ||||
| 				fi | ||||
| 				MAKECHROOT_OPTIONS+=("-x" "${2}") | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			-r|--release) | ||||
| 				# shellcheck source=src/lib/release.sh | ||||
| 				source "${_DEVTOOLS_LIBRARY_DIR}"/lib/release.sh | ||||
| @@ -312,17 +272,13 @@ pkgctl_build() { | ||||
|  | ||||
| 	# Update pacman cache for auto-detection | ||||
| 	if [[ -z ${REPO} ]]; then | ||||
| 		update_pacman_repo_cache multilib | ||||
| 		update_pacman_repo_cache | ||||
| 	# Check valid repos if not resolved dynamically | ||||
| 	elif ! in_array "${REPO}" "${DEVTOOLS_VALID_REPOS[@]}"; then | ||||
| 	elif ! in_array "${REPO}" "${_repos[@]}"; then | ||||
| 		die "Invalid repository target: %s" "${REPO}" | ||||
| 	fi | ||||
|  | ||||
| 	for path in "${paths[@]}"; do | ||||
| 		# skip paths that are not directories | ||||
| 		if [[ ! -d "${path}" ]]; then | ||||
| 			continue | ||||
| 		fi | ||||
| 		pushd "${path}" >/dev/null | ||||
|  | ||||
| 		if [[ ! -f PKGBUILD ]]; then | ||||
| @@ -334,30 +290,16 @@ pkgctl_build() { | ||||
| 		. ./PKGBUILD | ||||
| 		pkgbase=${pkgbase:-$pkgname} | ||||
| 		pkgrepo=${REPO} | ||||
| 		pkgbuild_checksum=$(b2sum PKGBUILD | awk '{print $1}') | ||||
| 		msg "Building ${pkgbase}" | ||||
|  | ||||
| 		# auto-detect target repository | ||||
| 		if ! repo=$(get_pacman_repo_from_pkgbuild PKGBUILD); then | ||||
| 			die 'Failed to query pacman repo' | ||||
| 		fi | ||||
|  | ||||
| 		# fail if an existing package specifies --repo | ||||
| 		if [[ -n "${repo}" ]] && [[ -n ${pkgrepo} ]]; then | ||||
| 			# allow unstable to use --repo | ||||
| 			if [[ ${pkgrepo} == *unstable ]]; then | ||||
| 				repo=${pkgrepo} | ||||
| 			else | ||||
| 				die 'Using --repo for packages that exist in official repositories is disallowed' | ||||
| 		# auto-detection of build target | ||||
| 		if [[ -z ${pkgrepo} ]]; then | ||||
| 			if ! pkgrepo=$(get_pacman_repo_from_pkgbuild PKGBUILD); then | ||||
| 				die 'failed to get pacman repo' | ||||
| 			fi | ||||
| 			if [[ -z "${pkgrepo}" ]]; then | ||||
| 				die 'unknown repo, specify --repo for packages not currently in any official repo' | ||||
| 			fi | ||||
| 		fi | ||||
|  | ||||
| 		# assign auto-detected target repository | ||||
| 		if [[ -n ${repo} ]]; then | ||||
| 			pkgrepo=${repo} | ||||
| 		# fallback to extra for unreleased packages | ||||
| 		elif [[ -z ${pkgrepo} ]]; then | ||||
| 			pkgrepo=extra | ||||
| 		fi | ||||
|  | ||||
| 		# special cases to resolve final build target | ||||
| @@ -374,13 +316,13 @@ pkgctl_build() { | ||||
| 			BUILD_ARCH=("") | ||||
| 		elif (( ${#BUILD_ARCH[@]} == 0 )); then | ||||
| 			if in_array any "${arch[@]}"; then | ||||
| 				BUILD_ARCH=("${DEVTOOLS_VALID_ARCHES[0]}") | ||||
| 				BUILD_ARCH=("${_arch[0]}") | ||||
| 			else | ||||
| 				for _arch in "${arch[@]}"; do | ||||
| 					if in_array "${_arch}" "${DEVTOOLS_VALID_ARCHES[@]}"; then | ||||
| 						BUILD_ARCH+=("$_arch") | ||||
| 				for loop_arch in "${arch[@]}"; do  | ||||
| 					if in_array "${loop_arch}" "${_arch[@]}"; then | ||||
| 						BUILD_ARCH+=("$loop_arch") | ||||
| 					else | ||||
| 						warning 'invalid architecture, not building for: %s' "${_arch}" | ||||
| 						warning 'invalid architecture, not building for: %s' "${loop_arch}" | ||||
| 					fi | ||||
| 				done | ||||
| 			fi | ||||
| @@ -410,14 +352,20 @@ pkgctl_build() { | ||||
|  | ||||
| 		# update pkgver | ||||
| 		if [[ -n ${PKGVER} ]]; then | ||||
| 			if [[ $(type -t pkgver) == function ]]; then | ||||
| 				# TODO: check if die or warn, if we provide _commit _gitcommit setter maybe? | ||||
| 				warning 'setting pkgver variable has no effect if the PKGBUILD has a pkgver() function' | ||||
| 			fi | ||||
| 			msg "Bumping pkgver to ${PKGVER}" | ||||
| 			pkgbuild_set_pkgver "${PKGVER}" | ||||
| 			grep --extended-regexp --quiet --max-count=1 "^pkgver=${pkgver}$" PKGBUILD || die "Non-standard pkgver declaration" | ||||
| 			sed --regexp-extended "s|^(pkgver=)${pkgver}$|\1${PKGVER}|g" -i PKGBUILD | ||||
| 		fi | ||||
|  | ||||
| 		# update pkgrel | ||||
| 		if [[ -n ${PKGREL} ]]; then | ||||
| 			msg "Bumping pkgrel to ${PKGREL}" | ||||
| 			pkgbuild_set_pkgrel "${PKGREL}" | ||||
| 			grep --extended-regexp --quiet --max-count=1 "^pkgrel=${pkgrel}$" PKGBUILD || die "Non-standard pkgrel declaration" | ||||
| 			sed --regexp-extended "s|^(pkgrel=)${pkgrel}$|\1${PKGREL}|g" -i PKGBUILD | ||||
| 		fi | ||||
|  | ||||
| 		# edit PKGBUILD | ||||
| @@ -437,19 +385,10 @@ pkgctl_build() { | ||||
| 			stat_done | ||||
| 		fi | ||||
|  | ||||
| 		# update checksums if any sources are declared | ||||
| 		if (( UPDATE_CHECKSUMS )) && (( ${#source[@]} >= 1 )); then | ||||
| 			if ! result=$(pkgbuild_update_checksums /dev/stderr); then | ||||
| 				die "${result}" | ||||
| 			fi | ||||
| 		fi | ||||
|  | ||||
| 		# re-source the PKGBUILD if it changed | ||||
| 		current_checksum="$(b2sum PKGBUILD | awk '{print $1}')" | ||||
| 		if [[ ${pkgbuild_checksum} != "${current_checksum}" ]]; then | ||||
| 			pkgbuild_checksum=${current_checksum} | ||||
| 			# shellcheck source=contrib/makepkg/PKGBUILD.proto | ||||
| 			. ./PKGBUILD | ||||
| 		# update checksums if any sources are declared | ||||
| 		if (( UPDPKGSUMS )) && (( ${#source[@]} >= 1 )); then | ||||
| 			updpkgsums | ||||
| 		fi | ||||
|  | ||||
| 		# execute build | ||||
| @@ -469,41 +408,9 @@ pkgctl_build() { | ||||
| 			fi | ||||
| 		done | ||||
|  | ||||
| 		# re-source the PKGBUILD if it changed | ||||
| 		current_checksum="$(b2sum PKGBUILD | awk '{print $1}')" | ||||
| 		if [[ ${pkgbuild_checksum} != "${current_checksum}" ]]; then | ||||
| 			pkgbuild_checksum=${current_checksum} | ||||
| 			# shellcheck source=contrib/makepkg/PKGBUILD.proto | ||||
| 			. ./PKGBUILD | ||||
| 		fi | ||||
|  | ||||
| 		# auto generate .SRCINFO | ||||
| 		# shellcheck disable=SC2119 | ||||
| 		write_srcinfo_file | ||||
|  | ||||
| 		# test-install (some of) the produced packages | ||||
| 		if [[ ${INSTALL_TO_HOST} == auto ]] || [[ ${INSTALL_TO_HOST} == all ]]; then | ||||
| 			# shellcheck disable=2119 | ||||
| 			load_makepkg_config | ||||
|  | ||||
| 			# this is inspired by print_all_package_names from libmakepkg | ||||
| 			local version pkg_architecture pkg pkgfile | ||||
| 			version=$(get_full_version) | ||||
|  | ||||
| 			for pkg in "${pkgname[@]}"; do | ||||
| 				pkg_architecture=$(get_pkg_arch "$pkg") | ||||
| 				pkgfile=$(realpath "$(printf "%s/%s-%s-%s%s\n" "${PKGDEST:-.}" "$pkg" "$version" "$pkg_architecture" "$PKGEXT")") | ||||
|  | ||||
| 				# check if we install all packages or if the (split-)package is already installed | ||||
| 				if [[ ${INSTALL_TO_HOST} == all ]] || ( [[ ${INSTALL_TO_HOST} == auto ]] && pacman -Qq -- "$pkg" &>/dev/null ); then | ||||
| 					INSTALL_HOST_PACKAGES+=("$pkgfile") | ||||
| 				fi | ||||
| 			done | ||||
| 		fi | ||||
|  | ||||
| 		# release the build | ||||
| 		if (( RELEASE )); then | ||||
| 			pkgctl_release "${RELEASE_OPTIONS[@]}" | ||||
| 			pkgctl_release --repo "${pkgrepo}" "${RELEASE_OPTIONS[@]}" | ||||
| 		fi | ||||
|  | ||||
| 		# reset common PKGBUILD variables | ||||
| @@ -511,12 +418,6 @@ pkgctl_build() { | ||||
| 		popd >/dev/null | ||||
| 	done | ||||
|  | ||||
| 	# install all collected packages to the host system | ||||
| 	if (( ${#INSTALL_HOST_PACKAGES[@]} )); then | ||||
| 		msg "Installing built packages to the host system" | ||||
| 		sudo pacman -U -- "${INSTALL_HOST_PACKAGES[@]}" | ||||
| 	fi | ||||
|  | ||||
| 	# update the binary package repo db as last action | ||||
| 	if (( RELEASE )) && (( DB_UPDATE )); then | ||||
| 		# shellcheck disable=2119 | ||||
|   | ||||
| @@ -1,22 +0,0 @@ | ||||
| #!/hint/bash | ||||
| # | ||||
| # SPDX-License-Identifier: GPL-3.0-or-later | ||||
|  | ||||
| [[ -z ${DEVTOOLS_INCLUDE_CACHE_SH:-} ]] || return 0 | ||||
| DEVTOOLS_INCLUDE_CACHE_SH=1 | ||||
|  | ||||
| set -e | ||||
|  | ||||
| readonly XDG_DEVTOOLS_CACHE_DIR="${XDG_CACHE_HOME:-$HOME/.cache}/devtools" | ||||
|  | ||||
| get_cache_file() { | ||||
| 	local filename=$1 | ||||
| 	local path="${XDG_DEVTOOLS_CACHE_DIR}/${filename}" | ||||
|  | ||||
| 	mkdir --parents -- "$(dirname -- "$path")" | ||||
| 	if [[ ! -f ${path} ]]; then | ||||
| 		touch -- "${path}" | ||||
| 	fi | ||||
|  | ||||
| 	printf '%s' "${path}" | ||||
| } | ||||
| @@ -13,10 +13,7 @@ set +u +o posix | ||||
| $DEVTOOLS_INCLUDE_COMMON_SH | ||||
|  | ||||
| # Avoid any encoding problems | ||||
| export LANG=C.UTF-8 | ||||
|  | ||||
| # Avoid systemd trying to color the terminal on systemd-nspawn | ||||
| export SYSTEMD_TINT_BACKGROUND=no | ||||
| export LANG=C | ||||
|  | ||||
| # Set buildtool properties | ||||
| export BUILDTOOL=devtools | ||||
| @@ -25,62 +22,21 @@ export BUILDTOOLVER=@buildtoolver@ | ||||
| # Set common properties | ||||
| export PACMAN_KEYRING_DIR=/etc/pacman.d/gnupg | ||||
| export GITLAB_HOST=gitlab.archlinux.org | ||||
| export GIT_REPO_SPEC_VERSION=2 | ||||
| export GIT_REPO_SPEC_VERSION=1 | ||||
| export GIT_PACKAGING_NAMESPACE=archlinux/packaging/packages | ||||
| export GIT_PACKAGING_NAMESPACE_ID=11323 | ||||
| export GIT_PACKAGING_URL_SSH="git@${GITLAB_HOST}:${GIT_PACKAGING_NAMESPACE}" | ||||
| export GIT_PACKAGING_URL_HTTPS="https://${GITLAB_HOST}/${GIT_PACKAGING_NAMESPACE}" | ||||
| export PACKAGING_REPO_RELEASE_HOST=repos.archlinux.org | ||||
| export PKGBASE_MAINTAINER_URL=https://archlinux.org/packages/pkgbase-maintainer | ||||
| export AUR_URL_SSH=aur@aur.archlinux.org | ||||
|  | ||||
| # Create or reuse a shared SSH control socket with ControlMaster=auto. The | ||||
| # connection is initialized on the first use and persisted for some time, so | ||||
| # multiple invokations of devtools can share it. | ||||
| # shellcheck disable=SC2016 | ||||
| export SSH_OPTS=( | ||||
|   -o ControlMaster=auto | ||||
|   -o ControlPersist=60s | ||||
|   -o ControlPath='${XDG_RUNTIME_DIR}/devtools-%r@%h:%p' | ||||
| ) | ||||
|  | ||||
| export RSYNC_OPTS=( | ||||
|   --rsh="ssh ${SSH_OPTS[*]}" | ||||
|   --checksum | ||||
|   --copy-links | ||||
|   --human-readable | ||||
|   --progress | ||||
|   --partial | ||||
|   --partial-dir=.partial | ||||
|   --delay-updates | ||||
| ) | ||||
|  | ||||
| # ensure TERM is set with a fallback to dumb | ||||
| export TERM=${TERM:-dumb} | ||||
| export VALID_RELEASE_BRANCHES=(main unstable) | ||||
|  | ||||
| # check if messages are to be printed using color | ||||
| if [[ -t 2 && "$TERM" != dumb ]] || [[ ${DEVTOOLS_COLOR} == always ]]; then | ||||
| 	colorize | ||||
| 	if tput setaf 0 &>/dev/null; then | ||||
| 		PURPLE="$(tput setaf 5)" | ||||
| 		DARK_GREEN="$(tput setaf 2)" | ||||
| 		DARK_RED="$(tput setaf 1)" | ||||
| 		DARK_BLUE="$(tput setaf 4)" | ||||
| 		DARK_YELLOW="$(tput setaf 3)" | ||||
| 		UNDERLINE="$(tput smul)" | ||||
| 		GRAY=$(tput setaf 242) | ||||
| 	else | ||||
| 		PURPLE="\e[35m" | ||||
| 		DARK_GREEN="\e[32m" | ||||
| 		DARK_RED="\e[31m" | ||||
| 		DARK_BLUE="\e[34m" | ||||
| 		DARK_YELLOW="\e[33m" | ||||
| 		UNDERLINE="\e[4m" | ||||
| 		GRAY="" | ||||
| 	fi | ||||
| else | ||||
| 	# shellcheck disable=2034 | ||||
| 	declare -gr ALL_OFF='' BOLD='' BLUE='' GREEN='' RED='' YELLOW='' PURPLE='' DARK_RED='' DARK_GREEN='' DARK_BLUE='' DARK_YELLOW='' UNDERLINE='' GRAY='' | ||||
| 	declare -gr ALL_OFF='' BOLD='' BLUE='' GREEN='' RED='' YELLOW='' | ||||
| fi | ||||
|  | ||||
| stat_busy() { | ||||
| @@ -99,11 +55,6 @@ stat_done() { | ||||
| 	printf "${BOLD}done${ALL_OFF}\n" >&2 | ||||
| } | ||||
|  | ||||
| stat_failed() { | ||||
| 	# shellcheck disable=2059 | ||||
| 	printf "${BOLD}${RED}failed${ALL_OFF}\n" >&2 | ||||
| } | ||||
|  | ||||
| msg_success() { | ||||
| 	local msg=$1 | ||||
| 	local padding | ||||
| @@ -128,18 +79,7 @@ msg_warn() { | ||||
| 	printf "%s %s\n" "${padding}${YELLOW}!${ALL_OFF}" "${msg}" >&2 | ||||
| } | ||||
|  | ||||
| print_workdir_error() { | ||||
| 	if [[ ! -f "${WORKDIR}"/error ]]; then | ||||
| 		return | ||||
| 	fi | ||||
| 	while read -r LINE; do | ||||
| 		error '%s' "${LINE}" | ||||
| 	done < "${WORKDIR}/error" | ||||
| } | ||||
|  | ||||
| _setup_workdir=false | ||||
| # Ensure that there is no outside value for WORKDIR leaking in | ||||
| unset WORKDIR | ||||
| setup_workdir() { | ||||
| 	[[ -z ${WORKDIR:-} ]] && WORKDIR=$(mktemp -d --tmpdir "${0##*/}.XXXXXXXXXX") | ||||
| 	_setup_workdir=true | ||||
| @@ -151,9 +91,6 @@ cleanup() { | ||||
| 	if [[ -n ${WORKDIR:-} ]] && $_setup_workdir; then | ||||
| 		rm -rf "$WORKDIR" | ||||
| 	fi | ||||
| 	if tput setaf 0 &>/dev/null; then | ||||
| 		tput cnorm >&2 | ||||
| 	fi | ||||
| 	exit "${1:-0}" | ||||
| } | ||||
|  | ||||
| @@ -185,7 +122,7 @@ lock() { | ||||
| 	# Only reopen the FD if it wasn't handed to us | ||||
| 	if ! [[ "/dev/fd/$1" -ef "$2" ]]; then | ||||
| 		mkdir -p -- "$(dirname -- "$2")" | ||||
| 		eval "exec $1>>"'"$2"' | ||||
| 		eval "exec $1>"'"$2"' | ||||
| 	fi | ||||
|  | ||||
| 	if ! flock -n "$1"; then | ||||
| @@ -376,65 +313,3 @@ is_debug_package() { | ||||
| 	pkgdesc="$(getpkgdesc "${pkgfile}")" | ||||
| 	[[ ${pkgdesc} == "Detached debugging symbols for "* && ${pkgbase}-debug = "${pkgname}" ]] | ||||
| } | ||||
|  | ||||
| # Proxy function to check if a file exists. Using [[ -f ... ]] directly is not | ||||
| # always wanted because we might want to expand bash globs first. This way we | ||||
| # can pass unquoted globs to is_globfile() and have them expanded as function | ||||
| # arguments before being checked. | ||||
| is_globfile() { | ||||
| 	[[ -f $1 ]] | ||||
| } | ||||
|  | ||||
| join_by() { | ||||
| 	local IFS="	" | ||||
| 	local sep=$1 | ||||
| 	local split | ||||
| 	shift | ||||
| 	split=$(printf "%s" "$*") | ||||
| 	echo "${split//${IFS}/"${sep}"}" | ||||
| } | ||||
|  | ||||
| trim_string() { | ||||
| 	local max_length=$1 | ||||
| 	local string=$2 | ||||
|  | ||||
| 	if (( ${#string} > max_length )); then | ||||
| 		# Subtract 3 from max_length to accommodate "..." | ||||
| 		max_length=$((max_length - 3)) | ||||
| 		string="${string:0:max_length}..." | ||||
| 	fi | ||||
|  | ||||
| 	printf "%s" "${string}" | ||||
| } | ||||
|  | ||||
| relative_date_unit() { | ||||
| 	local target_date=$1 | ||||
| 	local now diff value units unit names | ||||
|  | ||||
| 	target_date=$(date -d "$1" +%s) | ||||
| 	now=$(date +%s) | ||||
| 	diff=$((now - target_date)) | ||||
|  | ||||
| 	local names=(year month week day hour minute second) | ||||
| 	declare -A units=( | ||||
| 		[year]=$((60 * 60 * 24 * 365)) | ||||
| 		[month]=$((60 * 60 * 24 * 30)) | ||||
| 		[week]=$((60 * 60 * 24 * 7)) | ||||
| 		[day]=$((60 * 60 * 24)) | ||||
| 		[hour]=$((60 * 60)) | ||||
| 		[minute]=60 | ||||
| 		[second]=1 | ||||
| 	) | ||||
|  | ||||
| 	for unit in "${names[@]}"; do | ||||
| 		local value=$((diff / ${units[${unit}]})) | ||||
| 		if (( value > 1 )); then | ||||
| 			printf "%s %ss" "${value}" "${unit}" | ||||
| 			return | ||||
| 		elif (( value == 1 )); then | ||||
| 			printf "%s %s" "${value}" "${unit}" | ||||
| 			return | ||||
| 		fi | ||||
| 	done | ||||
| 	printf "1 second" | ||||
| } | ||||
|   | ||||
| @@ -8,12 +8,6 @@ DEVTOOLS_INCLUDE_DB_REMOVE_SH=1 | ||||
| _DEVTOOLS_LIBRARY_DIR=${_DEVTOOLS_LIBRARY_DIR:-@pkgdatadir@} | ||||
| # shellcheck source=src/lib/common.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/common.sh | ||||
| # shellcheck source=src/lib/util/pacman.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/util/pacman.sh | ||||
| # shellcheck source=src/lib/util/term.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/util/term.sh | ||||
| # shellcheck source=src/lib/valid-repos.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/valid-repos.sh | ||||
|  | ||||
| set -e | ||||
|  | ||||
| @@ -23,19 +17,10 @@ pkgctl_db_remove_usage() { | ||||
| 	cat <<- _EOF_ | ||||
| 		Usage: ${COMMAND} [OPTIONS] [REPO] [PKGBASE]... | ||||
|  | ||||
| 		Remove packages from pacman repositories. By default passing a pkgbase removes | ||||
| 		all split packages, debug packages as well as entries from the state repo for | ||||
| 		all existing architectures. | ||||
|  | ||||
| 		Beware when using the --partial option, as it may most likely lead to | ||||
| 		undesired effects by leaving debug packages behind as well as dangling entries | ||||
| 		in the state repository. | ||||
| 		Remove packages from binary repositories. | ||||
|  | ||||
| 		OPTIONS | ||||
| 		    -a, --arch    Remove only one specific architecture (disables auto-detection) | ||||
| 		    --partial     Remove only partial pkgnames from a split package. This leaves | ||||
| 		                  debug packages behind and pkgbase entries in the state repo. | ||||
| 		    --noconfirm   Bypass any confirmation messages, should only be used with caution | ||||
| 		    -a, --arch    Override the architecture (disables auto-detection) | ||||
| 		    -h, --help    Show this help text | ||||
|  | ||||
| 		EXAMPLES | ||||
| @@ -46,13 +31,8 @@ _EOF_ | ||||
|  | ||||
| pkgctl_db_remove() { | ||||
| 	local REPO="" | ||||
| 	local ARCH=any | ||||
| 	local PKGBASES=() | ||||
| 	local pkgnames=() | ||||
| 	local partial=0 | ||||
| 	local confirm=1 | ||||
| 	local dbscripts_options=() | ||||
| 	local lookup_repo=multilib | ||||
| 	local pkgname | ||||
|  | ||||
| 	# option checking | ||||
| 	while (( $# )); do | ||||
| @@ -61,20 +41,11 @@ pkgctl_db_remove() { | ||||
| 				pkgctl_db_remove_usage | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			--partial) | ||||
| 				partial=1 | ||||
| 				dbscripts_options+=(--partial) | ||||
| 				shift | ||||
| 				;; | ||||
| 			-a|--arch) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				dbscripts_options+=(--arch "$2") | ||||
| 				ARCH=$2 | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--noconfirm) | ||||
| 				confirm=0 | ||||
| 				shift | ||||
| 				;; | ||||
| 			-*) | ||||
| 				die "invalid argument: %s" "$1" | ||||
| 				;; | ||||
| @@ -92,62 +63,7 @@ pkgctl_db_remove() { | ||||
| 	REPO=$1 | ||||
| 	shift | ||||
| 	PKGBASES+=("$@") | ||||
| 	pkgnames=("${PKGBASES[@]}") | ||||
|  | ||||
| 	# check if the target repo is valid | ||||
| 	if ! in_array "${REPO}" "${DEVTOOLS_VALID_REPOS[@]}"; then | ||||
| 		die "Invalid repository target: %s" "${REPO}" | ||||
| 	fi | ||||
|  | ||||
| 	# update pacman cache to query all pkgnames | ||||
| 	if (( ! partial )); then | ||||
| 		case ${REPO} in | ||||
| 			*-unstable) | ||||
| 				update_pacman_repo_cache unstable | ||||
| 				;; | ||||
| 			*-staging) | ||||
| 				update_pacman_repo_cache multilib-staging | ||||
| 				;; | ||||
| 			*-testing) | ||||
| 				update_pacman_repo_cache multilib-testing | ||||
| 				;; | ||||
| 			*) | ||||
| 				update_pacman_repo_cache multilib | ||||
| 				;; | ||||
| 		esac | ||||
|  | ||||
| 		# fetch the pkgnames of all pkgbase as present in the repo | ||||
| 		mapfile -t pkgnames < <(get_pkgnames_from_repo_pkgbase "${REPO}" "${PKGBASES[@]}") | ||||
| 		echo | ||||
|  | ||||
| 		if (( ! ${#pkgnames[@]} )); then | ||||
| 			error "Packages not found in %s" "${REPO}" | ||||
| 			exit 1 | ||||
| 		fi | ||||
| 	fi | ||||
|  | ||||
| 	# print list of packages | ||||
| 	printf "%sRemoving packages from %s:%s\n" "${RED}" "${REPO}" "${ALL_OFF}" | ||||
| 	for pkgname in "${pkgnames[@]}"; do | ||||
| 		printf "• %s\n" "${pkgname}" | ||||
| 	done | ||||
|  | ||||
| 	# print explenation about partial removal | ||||
| 	if (( partial )); then | ||||
| 		echo | ||||
| 		msg_warn "${YELLOW}Removing only partial pkgnames from a split package.${ALL_OFF}" | ||||
| 		msg_warn "${YELLOW}This leaves debug packages and pkgbase entries in the state repo!${ALL_OFF}" | ||||
| 	fi | ||||
|  | ||||
| 	# ask for confirmation | ||||
| 	if (( confirm )); then | ||||
| 		echo | ||||
| 		if ! prompt "${GREEN}${BOLD}?${ALL_OFF} Are you sure this is correct?"; then | ||||
| 			exit 1 | ||||
| 		fi | ||||
| 	fi | ||||
|  | ||||
| 	echo | ||||
| 	# shellcheck disable=SC2029 | ||||
| 	ssh "${PACKAGING_REPO_RELEASE_HOST}" db-remove "${dbscripts_options[@]}" "${REPO}" "${PKGBASES[@]}" | ||||
| 	ssh "${PACKAGING_REPO_RELEASE_HOST}" db-remove "${REPO}" "${ARCH}" "${PKGBASES[@]}" | ||||
| } | ||||
|   | ||||
| @@ -1,194 +0,0 @@ | ||||
| #!/hint/bash | ||||
| # | ||||
| # SPDX-License-Identifier: GPL-3.0-or-later | ||||
|  | ||||
| [[ -z ${DEVTOOLS_INCLUDE_ISSUE_CLOSE_SH:-} ]] || return 0 | ||||
| DEVTOOLS_INCLUDE_ISSUE_CLOSE_SH=1 | ||||
|  | ||||
| _DEVTOOLS_LIBRARY_DIR=${_DEVTOOLS_LIBRARY_DIR:-@pkgdatadir@} | ||||
|  | ||||
| # shellcheck source=src/lib/common.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/common.sh | ||||
| # shellcheck source=src/lib/api/gitlab.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/api/gitlab.sh | ||||
|  | ||||
| set -eo pipefail | ||||
|  | ||||
|  | ||||
| pkgctl_issue_close_usage() { | ||||
| 	local -r COMMAND=${_DEVTOOLS_COMMAND:-${BASH_SOURCE[0]##*/}} | ||||
| 	cat <<- _EOF_ | ||||
| 		Usage: ${COMMAND} [OPTIONS] [IID] | ||||
|  | ||||
| 		This command is used to close an issue in Arch Linux packaging projects. It | ||||
| 		finalizes the issue by marking it as resolved and optionally providing a reason | ||||
| 		for its closure. | ||||
|  | ||||
| 		By default, the command operates within the current directory, but users have | ||||
| 		the option to specify a different package base. | ||||
|  | ||||
| 		Users can provide a message directly through the command line to explain the | ||||
| 		reason for closing the issue. Additionally, a specific resolution label can be | ||||
| 		set to categorize the closure reason, with the default label being "completed." | ||||
|  | ||||
| 		OPTIONS | ||||
| 		    -p, --package PKGBASE    Interact with <pkgbase> instead of the current directory | ||||
| 		    -m, --message MSG        Use the provided message as the reason for closing | ||||
| 		    -e, --edit               Edit the reason for closing using an editor | ||||
| 		    -r, --resolution REASON  Set a specific resolution label (default: completed) | ||||
| 		    -h, --help               Show this help text | ||||
|  | ||||
| 		EXAMPLES | ||||
| 		    $ ${COMMAND} 42 | ||||
| 		    $ ${COMMAND} --edit --package linux 42 | ||||
| _EOF_ | ||||
| } | ||||
|  | ||||
| pkgctl_issue_close() { | ||||
| 	if (( $# < 1 )); then | ||||
| 		pkgctl_issue_close_usage | ||||
| 		exit 0 | ||||
| 	fi | ||||
|  | ||||
| 	local iid="" | ||||
| 	local pkgbase="" | ||||
| 	local message="" | ||||
| 	local edit=0 | ||||
| 	local labels=() | ||||
| 	local resolution="completed" | ||||
|  | ||||
| 	local issue note | ||||
| 	local params="state_event=close" | ||||
|  | ||||
| 	# option checking | ||||
| 	while (( $# )); do | ||||
| 		case $1 in | ||||
| 			-h|--help) | ||||
| 				pkgctl_issue_close_usage | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			-m|--message) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				message=$2 | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			-p|--package) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				pkgbase=$2 | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			-e|--edit) | ||||
| 				edit=1 | ||||
| 				shift | ||||
| 				;; | ||||
| 			--resolution) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! label="$(resolution_as_gitlab_label "$2")"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				params+="&add_labels=${label}" | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			-*) | ||||
| 				die "invalid argument: %s" "$1" | ||||
| 				;; | ||||
| 			*) | ||||
| 				iid=$1 | ||||
| 				shift | ||||
| 				;; | ||||
| 		esac | ||||
| 	done | ||||
|  | ||||
| 	if [[ -z ${iid} ]]; then | ||||
| 		die "missing issue iid argument" | ||||
| 	fi | ||||
|  | ||||
| 	if [[ -z ${pkgbase} ]]; then | ||||
| 		if ! [[ -f PKGBUILD ]]; then | ||||
| 			die "missing --package option or PKGBUILD in current directory" | ||||
| 		fi | ||||
| 		pkgbase=$(realpath --canonicalize-existing .) | ||||
| 	fi | ||||
| 	pkgbase=$(basename "${pkgbase}") | ||||
|  | ||||
| 	# spawn editor | ||||
| 	if (( edit )); then | ||||
| 		msgfile=$(mktemp --tmpdir="${WORKDIR}" pkgctl-issue-note.XXXXXXXXXX.md) | ||||
| 		printf "%s\n" "${message}" >> "${msgfile}" | ||||
| 		if [[ -n $VISUAL ]]; then | ||||
| 			$VISUAL "${msgfile}" || die | ||||
| 		elif [[ -n $EDITOR ]]; then | ||||
| 			$EDITOR "${msgfile}" || die | ||||
| 		else | ||||
| 			die "No usable editor found (tried \$VISUAL, \$EDITOR)." | ||||
| 		fi | ||||
| 		message=$(cat "${msgfile}") | ||||
| 	fi | ||||
|  | ||||
| 	# comment on issue | ||||
| 	if [[ -n ${message} ]]; then | ||||
| 		if ! note=$(gitlab_create_project_issue_note "${pkgbase}" "${iid}" "${message}"); then | ||||
| 			msg_error "Failed to comment on issue ${BOLD}#${iid}${ALL_OFF}" | ||||
| 			exit 1 | ||||
| 		fi | ||||
| 		msg_success "Commented on issue ${BOLD}#${iid}${ALL_OFF}" | ||||
| 	fi | ||||
|  | ||||
| 	# close issue | ||||
| 	if ! issue=$(gitlab_project_issue_edit "${pkgbase}" "${iid}" "${params}"); then | ||||
| 		msg_error "Failed to close issue ${BOLD}#${iid}${ALL_OFF}" | ||||
| 		exit 1 | ||||
| 	fi | ||||
| 	msg_success "Closed issue ${BOLD}#${iid}${ALL_OFF}" | ||||
| 	echo | ||||
|  | ||||
| 	{ read -r iid; read -r title; read -r state; read -r created_at; read -r author; } < <( | ||||
| 		jq --raw-output ".iid, .title, .state, .created_at, .author.username" <<< "${issue}" | ||||
| 	) | ||||
| 	mapfile -t labels < <( | ||||
| 		jq --raw-output ".labels[]" <<< "${issue}" | ||||
| 	) | ||||
|  | ||||
| 	severity="$(gitlab_severity_from_labels "${labels[@]}")" | ||||
| 	severity_color="$(gitlab_severity_color "${severity}")" | ||||
| 	created_at=$(relative_date_unit "${created_at}") | ||||
| 	state_color="$(gitlab_issue_state_color "${state}")" | ||||
| 	state="$(gitlab_issue_state_display "${state}")" | ||||
| 	status="$(gitlab_issue_status_from_labels "${labels[@]}")" | ||||
| 	status_color="$(gitlab_issue_status_color "${status}")" | ||||
|  | ||||
| 	scope="$(gitlab_scope_from_labels "${labels[@]}")" | ||||
| 	scope_color="$(gitlab_scope_color "${scope}")" | ||||
| 	scope_label="" | ||||
| 	if [[ ${scope} != unknown ]]; then | ||||
| 		scope_label="${scope_color}${scope}${ALL_OFF} ${GRAY}•${ALL_OFF} " | ||||
| 	fi | ||||
|  | ||||
| 	resolution_label="" | ||||
| 	if resolution="$(gitlab_resolution_from_labels "${labels[@]}")"; then | ||||
| 		resolution_color="$(gitlab_resolution_color "${resolution}")" | ||||
| 		resolution_label="${resolution_color}${resolution}${ALL_OFF} ${GRAY}•${ALL_OFF} " | ||||
| 	fi | ||||
|  | ||||
| 	printf "%s%s • %s%sseverity %s • %s • %s%sopened by %s %s ago%s\n" \ | ||||
| 		"${state_color}${state}${ALL_OFF}" "${GRAY}" "${resolution_label}" "${severity_color}" "${severity}${GRAY}" \ | ||||
| 		"${status_color}${status}${GRAY}" "${scope_label}" "${GRAY}" "${author}" "${created_at}" "${ALL_OFF}" | ||||
| 	printf "%s %s\n" "${BOLD}${title}${ALL_OFF}" "${GRAY}#${iid}${ALL_OFF}" | ||||
|  | ||||
| 	# show comment | ||||
| 	if [[ -n ${note} ]]; then | ||||
| 		{ read -r created_at; read -r author; } < <( | ||||
| 			jq --raw-output ".created_at, .author.username" <<< "${note}" | ||||
| 		) | ||||
| 		body=$(jq --raw-output ".body" <<< "${note}") | ||||
| 		created_at=$(relative_date_unit "${created_at}") | ||||
|  | ||||
| 		echo | ||||
| 		echo "${BOLD}Comments / Notes${ALL_OFF}" | ||||
| 		printf -v spaces '%*s' $(( COLUMNS - 2 )) '' | ||||
| 		printf '%s\n\n' "${spaces// /─}" | ||||
|  | ||||
| 		printf "%s commented%s %s ago%s\n" "${author}" "${GRAY}" "${created_at}" "${ALL_OFF}" | ||||
| 		echo "${body}" | glow | ||||
| 	fi | ||||
| } | ||||
| @@ -1,130 +0,0 @@ | ||||
| #!/hint/bash | ||||
| # | ||||
| # SPDX-License-Identifier: GPL-3.0-or-later | ||||
|  | ||||
| [[ -z ${DEVTOOLS_INCLUDE_ISSUE_COMMENT_SH:-} ]] || return 0 | ||||
| DEVTOOLS_INCLUDE_ISSUE_COMMENT_SH=1 | ||||
|  | ||||
| _DEVTOOLS_LIBRARY_DIR=${_DEVTOOLS_LIBRARY_DIR:-@pkgdatadir@} | ||||
|  | ||||
| # shellcheck source=src/lib/common.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/common.sh | ||||
| # shellcheck source=src/lib/api/gitlab.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/api/gitlab.sh | ||||
|  | ||||
| set -eo pipefail | ||||
|  | ||||
|  | ||||
| pkgctl_issue_comment_usage() { | ||||
| 	local -r COMMAND=${_DEVTOOLS_COMMAND:-${BASH_SOURCE[0]##*/}} | ||||
| 	cat <<- _EOF_ | ||||
| 		Usage: ${COMMAND} [OPTIONS] [IID] | ||||
|  | ||||
| 		This command allows users to add comments to an issue in Arch Linux packaging | ||||
| 		projects. This command is useful for providing feedback, updates, or any | ||||
| 		additional information related to an issue directly within the project's issue | ||||
| 		tracking system. | ||||
|  | ||||
| 		By default, the command interacts with the current directory, but users can | ||||
| 		specify a different package base if needed. | ||||
|  | ||||
| 		OPTIONS | ||||
| 		    -p, --package PKGBASE  Interact with <pkgbase> instead of the current directory | ||||
| 		    -m, --message MSG      Use the provided message as the comment | ||||
| 		    -e, --edit             Edit the comment using an editor | ||||
| 		    -h, --help             Show this help text | ||||
|  | ||||
| 		EXAMPLES | ||||
| 		    $ ${COMMAND} --message "I've attached some logs" 42 | ||||
| 		    $ ${COMMAND} --package linux 42 | ||||
| 		    $ ${COMMAND} 42 | ||||
| _EOF_ | ||||
| } | ||||
|  | ||||
| pkgctl_issue_comment() { | ||||
| 	if (( $# < 1 )); then | ||||
| 		pkgctl_issue_comment_usage | ||||
| 		exit 0 | ||||
| 	fi | ||||
|  | ||||
| 	local iid="" | ||||
| 	local pkgbase="" | ||||
| 	local message="" | ||||
| 	local edit=0 | ||||
|  | ||||
| 	local note | ||||
|  | ||||
| 	# option checking | ||||
| 	while (( $# )); do | ||||
| 		case $1 in | ||||
| 			-h|--help) | ||||
| 				pkgctl_issue_comment_usage | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			-m|--message) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				message=$2 | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			-p|--package) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				pkgbase=$2 | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			-e|--edit) | ||||
| 				edit=1 | ||||
| 				shift | ||||
| 				;; | ||||
| 			-*) | ||||
| 				die "invalid argument: %s" "$1" | ||||
| 				;; | ||||
| 			*) | ||||
| 				iid=$1 | ||||
| 				shift | ||||
| 				;; | ||||
| 		esac | ||||
| 	done | ||||
|  | ||||
| 	if [[ -z ${iid} ]]; then | ||||
| 		die "missing issue iid argument" | ||||
| 	fi | ||||
|  | ||||
| 	if [[ -z ${pkgbase} ]]; then | ||||
| 		if ! [[ -f PKGBUILD ]]; then | ||||
| 			die "missing --package option or PKGBUILD in current directory" | ||||
| 		fi | ||||
| 		pkgbase=$(realpath --canonicalize-existing .) | ||||
| 	fi | ||||
| 	pkgbase=$(basename "${pkgbase}") | ||||
|  | ||||
| 	# spawn editor | ||||
| 	if (( edit )) || [[ -z ${message} ]]; then | ||||
| 		msgfile=$(mktemp --tmpdir="${WORKDIR}" pkgctl-issue-note.XXXXXXXXXX.md) | ||||
| 		printf "%s\n" "${message}" >> "${msgfile}" | ||||
| 		if [[ -n $VISUAL ]]; then | ||||
| 			$VISUAL "${msgfile}" || die | ||||
| 		elif [[ -n $EDITOR ]]; then | ||||
| 			$EDITOR "${msgfile}" || die | ||||
| 		else | ||||
| 			die "No usable editor found (tried \$VISUAL, \$EDITOR)." | ||||
| 		fi | ||||
| 		message=$(< "${msgfile}") | ||||
| 	fi | ||||
|  | ||||
| 	# comment on issue | ||||
| 	if ! note=$(gitlab_create_project_issue_note "${pkgbase}" "${iid}" "${message}"); then | ||||
| 		msg_error "Failed to comment on issue ${BOLD}#${iid}${ALL_OFF}" | ||||
| 		exit 1 | ||||
| 	fi | ||||
| 	msg_success "Commented on issue ${BOLD}#${iid}${ALL_OFF}" | ||||
| 	echo | ||||
|  | ||||
| 	{ read -r created_at; read -r author; } < <( | ||||
| 		jq --raw-output ".created_at, .author.username" <<< "${note}" | ||||
| 	) | ||||
| 	body=$(jq --raw-output ".body" <<< "${note}") | ||||
| 	created_at=$(relative_date_unit "${created_at}") | ||||
|  | ||||
| 	printf "%s commented%s %s ago%s\n" "${author}" "${GRAY}" "${created_at}" "${ALL_OFF}" | ||||
| 	echo "${body}" | glow | ||||
| } | ||||
| @@ -1,296 +0,0 @@ | ||||
| #!/hint/bash | ||||
| # | ||||
| # SPDX-License-Identifier: GPL-3.0-or-later | ||||
|  | ||||
| [[ -z ${DEVTOOLS_INCLUDE_ISSUE_CREATE_SH:-} ]] || return 0 | ||||
| DEVTOOLS_INCLUDE_ISSUE_CREATE_SH=1 | ||||
|  | ||||
| _DEVTOOLS_LIBRARY_DIR=${_DEVTOOLS_LIBRARY_DIR:-@pkgdatadir@} | ||||
|  | ||||
| # shellcheck source=src/lib/common.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/common.sh | ||||
| # shellcheck source=src/lib/api/gitlab.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/api/gitlab.sh | ||||
| # shellcheck source=src/lib/util/term.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/util/term.sh | ||||
|  | ||||
| set -eo pipefail | ||||
|  | ||||
|  | ||||
| pkgctl_issue_create_usage() { | ||||
| 	local -r COMMAND=${_DEVTOOLS_COMMAND:-${BASH_SOURCE[0]##*/}} | ||||
| 	cat <<- _EOF_ | ||||
| 		Usage: ${COMMAND} [OPTIONS] | ||||
|  | ||||
| 		The create command is used to create a new issue for an Arch Linux package. | ||||
| 		This command is suitable for reporting bugs, regressions, feature requests, or | ||||
| 		any other issues related to a package. It provides a flexible way to document | ||||
| 		and track new issues within the project's issue tracking system. | ||||
|  | ||||
| 		By default, the command operates within the current directory, but users can | ||||
| 		specify a different package base if needed. | ||||
|  | ||||
| 		Users can provide a title for the issue directly through the command line. | ||||
| 		The command allows setting various labels and attributes for the issue, such as | ||||
| 		confidentiality, priority, scope, severity, and status. | ||||
|  | ||||
| 		In case of a failed run, the command can automatically recover to ensure that | ||||
| 		the issue creation process is completed without losing any data. | ||||
|  | ||||
| 		OPTIONS | ||||
| 		    -p, --package PKGBASE    Interact with <pkgbase> instead of the current directory | ||||
| 		    -t, --title TITLE        Use the provided title for the issue | ||||
| 		    -F, --file FILE          Take issue description from <file> | ||||
| 		    -e, --edit               Edit the issue description using an editor | ||||
| 		    -w, --web                Continue issue creation with the web interface | ||||
| 		    --recover                Automatically recover from a failed run | ||||
| 		    --confidentiality TYPE   Set the issue confidentiality | ||||
| 		    --priority PRIORITY      Set the priority label | ||||
| 		    --scope SCOPE            Set the scope label | ||||
| 		    --severity SEVERITY      Set the severity label | ||||
| 		    --status STATUS          Set the status label | ||||
| 		    -h, --help               Show this help text | ||||
|  | ||||
| 		EXAMPLES | ||||
| 		    $ ${COMMAND} --package linux --title "some very informative title" | ||||
| _EOF_ | ||||
| } | ||||
|  | ||||
| pkgctl_issue_create() { | ||||
| 	if (( $# < 1 )); then | ||||
| 		pkgctl_issue_create_usage | ||||
| 		exit 0 | ||||
| 	fi | ||||
|  | ||||
| 	local pkgbase="" | ||||
| 	local title_placeholder="PLACEHOLDER" | ||||
| 	local title="${title_placeholder}" | ||||
| 	local description="" | ||||
| 	local labels=() | ||||
| 	local msgfile="" | ||||
| 	local edit=0 | ||||
| 	local web=0 | ||||
| 	local recover=0 | ||||
| 	local confidential=0 | ||||
|  | ||||
| 	local issue_template_url="https://gitlab.archlinux.org/archlinux/packaging/templates/-/raw/master/.gitlab/issue_templates/Default.md" | ||||
| 	local issue_template | ||||
| 	local recovery_home=${XDG_DATA_HOME:-$HOME/.local/share}/devtools/recovery | ||||
| 	local recovery_file | ||||
| 	local issue_url | ||||
| 	local project_path | ||||
| 	local result | ||||
| 	local iid | ||||
| 	local message | ||||
| 	local editor | ||||
|  | ||||
| 	# option checking | ||||
| 	while (( $# )); do | ||||
| 		case $1 in | ||||
| 			-h|--help) | ||||
| 				pkgctl_issue_create_usage | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			-t|--title) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				title=$2 | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			-p|--package) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				pkgbase=$2 | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			-F|--file) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				msgfile=$2 | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			-e|--edit) | ||||
| 				edit=1 | ||||
| 				shift | ||||
| 				;; | ||||
| 			-w|--web) | ||||
| 				web=1 | ||||
| 				shift | ||||
| 				;; | ||||
| 			--recover) | ||||
| 				recover=1 | ||||
| 				shift | ||||
| 				;; | ||||
| 			--confidentiality) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! in_array "$2" "${DEVTOOLS_VALID_ISSUE_CONFIDENTIALITY[@]}"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				if [[ $2 == confidential ]]; then | ||||
| 					confidential=1 | ||||
| 				fi | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--priority) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! label="$(priority_as_gitlab_label "$2")"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				labels+=("$label") | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--scope) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! label="$(scope_as_gitlab_label "$2")"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				labels+=("$label") | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--severity) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! label="$(severity_as_gitlab_label "$2")"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				labels+=("$label") | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--status) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! label="$(status_as_gitlab_label "$2")"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				labels+=("$label") | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			*) | ||||
| 				die "invalid argument: %s" "$1" | ||||
| 				;; | ||||
| 		esac | ||||
| 	done | ||||
|  | ||||
| 	if [[ -z ${pkgbase} ]]; then | ||||
| 		if ! [[ -f PKGBUILD ]]; then | ||||
| 			die "missing --package option or PKGBUILD in current directory" | ||||
| 		fi | ||||
| 		pkgbase=$(realpath --canonicalize-existing .) | ||||
| 	fi | ||||
| 	pkgbase=$(basename "${pkgbase}") | ||||
| 	project_path=$(gitlab_project_name_to_path "${pkgbase}") | ||||
| 	recovery_file="${recovery_home}/issue_create_${pkgbase}.md" | ||||
|  | ||||
| 	# spawn web browser | ||||
| 	if (( web )); then | ||||
| 		if ! command -v xdg-open &>/dev/null; then | ||||
| 			die "The web option requires 'xdg-open'" | ||||
| 		fi | ||||
| 		issue_url="${GIT_PACKAGING_URL_HTTPS}/${project_path}/-/issues/new" | ||||
| 		echo "Opening ${issue_url} in your browser." | ||||
| 		xdg-open "${issue_url}" | ||||
| 		return | ||||
| 	fi | ||||
|  | ||||
| 	# check existence of recovery file | ||||
| 	if [[ -f ${recovery_file} ]]; then | ||||
| 		if (( ! recover )); then | ||||
| 			msg_warn "Recovery file already exists: ${recovery_file}" | ||||
| 			if prompt "${GREEN}${BOLD}?${ALL_OFF} Do you want to recover?"; then | ||||
| 				msgfile=${recovery_file} | ||||
| 				recover=1 | ||||
| 				edit=1 | ||||
| 			fi | ||||
| 		fi | ||||
| 	fi | ||||
|  | ||||
| 	# check existence of msgfile | ||||
| 	if [[ -n ${msgfile} ]]; then | ||||
| 		if [[ ! -f ${msgfile} ]]; then | ||||
| 			msg_error "File does not exist: ${msgfile}${ALL_OFF}" | ||||
| 			exit 1 | ||||
| 		fi | ||||
| 	else | ||||
| 		# prepare msgfile and fetch the issue template | ||||
| 		if ! issue_template=$(curl --url "${issue_template_url}" --silent); then | ||||
| 			msg_error "Failed to fetch issue template${ALL_OFF}" | ||||
| 			exit 1 | ||||
| 		fi | ||||
| 		# populate message file | ||||
| 		msgfile=$(mktemp --tmpdir="${WORKDIR}" pkgctl-issue-create.XXXXXXXXXX.md) | ||||
| 		edit=1 | ||||
| 		printf "# Title: %s\n\n" "${title}" >> "${msgfile}" | ||||
| 		printf "%s\n" "${issue_template}" >> "${msgfile}" | ||||
| 	fi | ||||
|  | ||||
| 	# spawn editor | ||||
| 	if (( edit )); then | ||||
| 		if [[ -n $VISUAL ]]; then | ||||
| 			editor=${VISUAL} | ||||
| 		elif [[ -n $EDITOR ]]; then | ||||
| 			editor=${EDITOR} | ||||
| 		else | ||||
| 			die "No usable editor found (tried \$VISUAL, \$EDITOR)." | ||||
| 		fi | ||||
|  | ||||
| 		if ! ${editor} "${msgfile}"; then | ||||
| 			message=$(< "${msgfile}") | ||||
| 			pkgctl_issue_write_recovery_file "${pkgbase}" "${message}" "${recovery_file}" "${recover}" | ||||
| 		fi | ||||
| 	fi | ||||
|  | ||||
| 	# check if the file contains a title | ||||
| 	message=$(< "${msgfile}") | ||||
| 	description=${message} | ||||
| 	if [[ ${message} == "# Title: "* ]]; then | ||||
| 		title=$(head --lines 1 <<< "${message}") | ||||
| 		title=${title//# Title: /} | ||||
| 		description=$(tail --lines +2 <<< "${message}") | ||||
| 		if [[ ${description} == $'\n'* ]]; then | ||||
| 			description=$(tail --lines +3 <<< "${message}") | ||||
| 		fi | ||||
| 	fi | ||||
|  | ||||
| 	# validate title | ||||
| 	if [[ ${title} == 'PLACEHOLDER' ]]; then | ||||
| 		msg_error "Invalid issue title: ${title}${ALL_OFF}" | ||||
| 		pkgctl_issue_write_recovery_file "${pkgbase}" "${message}" "${recovery_file}" "${recover}" | ||||
| 		exit 1 | ||||
| 	fi | ||||
|  | ||||
| 	# create the issue | ||||
| 	if ! result=$(gitlab_project_issue_create "${pkgbase}" "${title}" "${description}" "${confidential}" "${labels[@]}"); then | ||||
| 		msg_error "Failed to create issue in ${BOLD}${pkgbase}${ALL_OFF}" | ||||
| 		pkgctl_issue_write_recovery_file "${pkgbase}" "${message}" "${recovery_file}" "${recover}" | ||||
| 		exit 1 | ||||
| 	fi | ||||
|  | ||||
| 	# delete old recovery file if we succeeded | ||||
| 	if [[ -f ${recovery_file} ]]; then | ||||
| 		rm --force "${recovery_file}" | ||||
| 	fi | ||||
|  | ||||
| 	# read issue iid | ||||
| 	{ read -r iid; } < <( | ||||
| 		jq --raw-output ".iid" <<< "${result}" | ||||
| 	) | ||||
| 	issue_url="${GIT_PACKAGING_URL_HTTPS}/${project_path}/-/issues/${iid}" | ||||
|  | ||||
| 	msg_success "Created new issue ${BOLD}#${iid}${ALL_OFF}" | ||||
| 	printf "%sView this issue on GitLab: %s%s\n" "${GRAY}" "${issue_url}" "${ALL_OFF}" | ||||
| } | ||||
|  | ||||
| pkgctl_issue_write_recovery_file() { | ||||
| 	local pkgbase=$1 | ||||
| 	local message=$2 | ||||
| 	local recovery_file=$3 | ||||
| 	local recover=$4 | ||||
|  | ||||
| 	if [[ -f ${recovery_file} ]] && (( ! recover )); then | ||||
| 		msg_warn "Recovery file already exists: ${recovery_file}" | ||||
| 		if ! prompt "${YELLOW}${BOLD}?${ALL_OFF} Are you sure you want to overwrite it?"; then | ||||
| 			return 1 | ||||
| 		fi | ||||
| 	fi | ||||
|  | ||||
| 	mkdir -p "$(dirname "${recovery_file}")" | ||||
| 	printf "%s\n" "${message}" > "${recovery_file}" | ||||
|  | ||||
| 	printf "Created recovery file: %s\n" "${recovery_file}" | ||||
| 	return 0 | ||||
| } | ||||
| @@ -1,311 +0,0 @@ | ||||
| #!/hint/bash | ||||
| # | ||||
| # SPDX-License-Identifier: GPL-3.0-or-later | ||||
|  | ||||
| [[ -z ${DEVTOOLS_INCLUDE_ISSUE_EDIT_SH:-} ]] || return 0 | ||||
| DEVTOOLS_INCLUDE_ISSUE_EDIT_SH=1 | ||||
|  | ||||
| _DEVTOOLS_LIBRARY_DIR=${_DEVTOOLS_LIBRARY_DIR:-@pkgdatadir@} | ||||
|  | ||||
| # shellcheck source=src/lib/common.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/common.sh | ||||
| # shellcheck source=src/lib/api/gitlab.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/api/gitlab.sh | ||||
| # shellcheck source=src/lib/util/term.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/util/term.sh | ||||
|  | ||||
| set -eo pipefail | ||||
|  | ||||
|  | ||||
| pkgctl_issue_edit_usage() { | ||||
| 	local -r COMMAND=${_DEVTOOLS_COMMAND:-${BASH_SOURCE[0]##*/}} | ||||
| 	cat <<- _EOF_ | ||||
| 		Usage: ${COMMAND} [OPTIONS] [IID] | ||||
|  | ||||
| 		The pkgctl issue edit command is used to modify an existing issue in Arch Linux | ||||
| 		packaging projects. This command allows users to update the issue's title, | ||||
| 		description, and various attributes, ensuring that the issue information | ||||
| 		remains accurate and up-to-date. It also provides a streamlined facility | ||||
| 		for bug wranglers to categorize and prioritize issues efficiently. | ||||
|  | ||||
| 		By default, the command operates within the current directory, but users can | ||||
| 		specify a different package base if needed. | ||||
|  | ||||
| 		In case of a failed run, the command can automatically recover to ensure that | ||||
| 		the editing process is completed without losing any data. | ||||
|  | ||||
| 		OPTIONS | ||||
| 		    -p, --package PKGBASE   Interact with <pkgbase> instead of the current directory | ||||
| 		    -t, --title TITLE       Use the provided title for the issue | ||||
| 		    -e, --edit              Edit the issue title and description using an editor | ||||
| 		    --recover               Automatically recover from a failed run | ||||
| 		    --confidentiality TYPE  Set the issue confidentiality | ||||
| 		    --priority PRIORITY     Set the priority label | ||||
| 		    --resolution REASON     Set the resolution label | ||||
| 		    --scope SCOPE           Set the scope label | ||||
| 		    --severity SEVERITY     Set the severity label | ||||
| 		    --status STATUS         Set the status label | ||||
| 		    -h, --help              Show this help text | ||||
|  | ||||
| 		EXAMPLES | ||||
| 		    $ ${COMMAND} --package linux --title "some very informative title" | ||||
| _EOF_ | ||||
| } | ||||
|  | ||||
| pkgctl_issue_edit() { | ||||
| 	if (( $# < 1 )); then | ||||
| 		pkgctl_issue_edit_usage | ||||
| 		exit 0 | ||||
| 	fi | ||||
|  | ||||
| 	local pkgbase="" | ||||
| 	local title="" | ||||
| 	local description="" | ||||
| 	local labels=() | ||||
| 	local confidential="" | ||||
| 	local msgfile="" | ||||
| 	local edit=0 | ||||
| 	local recover=0 | ||||
|  | ||||
| 	local recovery_home=${XDG_DATA_HOME:-$HOME/.local/share}/devtools/recovery | ||||
| 	local recovery_file | ||||
| 	local issue_url | ||||
| 	local project_path | ||||
| 	local result | ||||
| 	local iid | ||||
| 	local message | ||||
|  | ||||
| 	# option checking | ||||
| 	while (( $# )); do | ||||
| 		case $1 in | ||||
| 			-h|--help) | ||||
| 				pkgctl_issue_edit_usage | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			-p|--package) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				pkgbase=$2 | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			-t|--title) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				title=$2 | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			-e|--edit) | ||||
| 				edit=1 | ||||
| 				shift | ||||
| 				;; | ||||
| 			--recover) | ||||
| 				recover=1 | ||||
| 				shift | ||||
| 				;; | ||||
| 			--confidentiality) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! in_array "$2" "${DEVTOOLS_VALID_ISSUE_CONFIDENTIALITY[@]}"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				if [[ $2 == public ]]; then | ||||
| 					confidential=false | ||||
| 				else | ||||
| 					confidential=true | ||||
| 				fi | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--priority) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! label="$(priority_as_gitlab_label "$2")"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				labels+=("$label") | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--resolution) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! label="$(resolution_as_gitlab_label "$2")"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				labels+=("$label") | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--scope) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! label="$(scope_as_gitlab_label "$2")"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				labels+=("$label") | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--severity) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! label="$(severity_as_gitlab_label "$2")"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				labels+=("$label") | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--status) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! label="$(status_as_gitlab_label "$2")"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				labels+=("$label") | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			-*) | ||||
| 				die "invalid argument: %s" "$1" | ||||
| 				;; | ||||
| 			*) | ||||
| 				iid=$1 | ||||
| 				shift | ||||
| 				;; | ||||
| 		esac | ||||
| 	done | ||||
|  | ||||
| 	if [[ -z ${iid} ]]; then | ||||
| 		die "missing issue iid argument" | ||||
| 	fi | ||||
|  | ||||
| 	if [[ -z ${pkgbase} ]]; then | ||||
| 		if ! [[ -f PKGBUILD ]]; then | ||||
| 			die "missing --package option or PKGBUILD in current directory" | ||||
| 		fi | ||||
| 		pkgbase=$(realpath --canonicalize-existing .) | ||||
| 	fi | ||||
| 	pkgbase=$(basename "${pkgbase}") | ||||
| 	project_path=$(gitlab_project_name_to_path "${pkgbase}") | ||||
| 	recovery_file="${recovery_home}/issue_edit_${pkgbase}.md" | ||||
|  | ||||
| 	# load current issue data | ||||
| 	if ! result=$(gitlab_project_issue "${pkgbase}" "${iid}"); then | ||||
| 		die "Failed to query issue ${pkgbase} #${iid}" | ||||
| 	fi | ||||
| 	{ read -r current_title; read -r current_confidential; } < <( | ||||
| 		jq --raw-output ".title, .confidential" <<< "${result}" | ||||
| 	) | ||||
| 	current_description=$(jq --raw-output ".description" <<< "${result}") | ||||
|  | ||||
| 	# check existence of recovery file | ||||
| 	if [[ -f ${recovery_file} ]]; then | ||||
| 		if (( ! recover )); then | ||||
| 			msg_warn "Recovery file already exists: ${recovery_file}" | ||||
| 			if prompt "${GREEN}${BOLD}?${ALL_OFF} Do you want to recover?"; then | ||||
| 				msgfile=${recovery_file} | ||||
| 				recover=1 | ||||
| 				edit=1 | ||||
| 			fi | ||||
| 		fi | ||||
| 	fi | ||||
|  | ||||
| 	# assign data to msgfile | ||||
| 	if [[ -n ${msgfile} ]]; then | ||||
| 		# check existence of msgfile | ||||
| 		if [[ ! -f ${msgfile} ]]; then | ||||
| 			msg_error "File does not exist: ${msgfile}${ALL_OFF}" | ||||
| 			exit 1 | ||||
| 		fi | ||||
| 	fi | ||||
|  | ||||
| 	# spawn editor | ||||
| 	if (( edit )); then | ||||
| 		if [[ -z ${msgfile} ]]; then | ||||
| 			msgfile=$(mktemp --tmpdir="${WORKDIR}" pkgctl-issue-create.XXXXXXXXXX.md) | ||||
| 			if [[ -n ${title} ]]; then | ||||
| 				printf "# Title: %s\n\n" "${title}" >> "${msgfile}" | ||||
| 			else | ||||
| 				printf "# Title: %s\n\n" "${current_title}" >> "${msgfile}" | ||||
| 			fi | ||||
| 			printf "%s\n" "${current_description}" >> "${msgfile}" | ||||
| 		fi | ||||
|  | ||||
| 		if [[ -n $VISUAL ]]; then | ||||
| 			editor=${VISUAL} | ||||
| 		elif [[ -n $EDITOR ]]; then | ||||
| 			editor=${EDITOR} | ||||
| 		else | ||||
| 			die "No usable editor found (tried \$VISUAL, \$EDITOR)." | ||||
| 		fi | ||||
|  | ||||
| 		if ! ${editor} "${msgfile}"; then | ||||
| 			message=$(< "${msgfile}") | ||||
| 			pkgctl_issue_write_recovery_file "${pkgbase}" "${message}" "${recovery_file}" "${recover}" | ||||
| 			return 1 | ||||
| 		fi | ||||
| 	fi | ||||
|  | ||||
| 	# check if the file contains a title | ||||
| 	if [[ -n ${msgfile} ]]; then | ||||
| 		message=$(< "${msgfile}") | ||||
| 		description=${message} | ||||
| 		if [[ ${message} == "# Title: "* ]]; then | ||||
| 			title=$(head --lines 1 <<< "${message}") | ||||
| 			title=${title//# Title: /} | ||||
| 			description=$(tail --lines +2 <<< "${message}") | ||||
| 			if [[ ${description} == $'\n'* ]]; then | ||||
| 				description=$(tail --lines +3 <<< "${message}") | ||||
| 			fi | ||||
| 		fi | ||||
| 	fi | ||||
|  | ||||
| 	# prepare changes | ||||
| 	data='{}' | ||||
| 	if [[ -n ${title} ]] && [[ ${title} != "${current_title}" ]]; then | ||||
| 		result=$(jq --null-input \ | ||||
| 			--arg title "${title}" \ | ||||
| 			'$ARGS.named') | ||||
| 		data=$(jq --slurp '.[0] * .[1]' <(echo "${data}") <(echo "${result}")) | ||||
| 	fi | ||||
| 	if [[ -n ${description} ]] && [[ ${description} != "${current_description}" ]]; then | ||||
| 		result=$(jq --null-input \ | ||||
| 			--arg description "${description}" \ | ||||
| 			'$ARGS.named') | ||||
| 		data=$(jq --slurp '.[0] * .[1]' <(echo "${data}") <(echo "${result}")) | ||||
| 	fi | ||||
| 	if [[ -n ${confidential} ]] && [[ ${confidential} != "${current_confidential}" ]]; then | ||||
| 		result=$(jq --null-input \ | ||||
| 			--arg confidential "${confidential}" \ | ||||
| 			'$ARGS.named') | ||||
| 		data=$(jq --slurp '.[0] * .[1]' <(echo "${data}") <(echo "${result}")) | ||||
| 	fi | ||||
| 	if (( ${#labels[@]} )); then | ||||
| 		result=$(jq --null-input \ | ||||
| 			--arg add_labels "$(join_by , "${labels[@]}")" \ | ||||
| 			'$ARGS.named') | ||||
| 		data=$(jq --slurp '.[0] * .[1]' <(echo "${data}") <(echo "${result}")) | ||||
| 	fi | ||||
|  | ||||
| 	# edit the issue | ||||
| 	if ! result=$(gitlab_project_issue_edit "${pkgbase}" "${iid}" "${params}" "${data}"); then | ||||
| 		msg_error "Failed to edit issue ${BOLD}${pkgbase}${ALL_OFF} #${iid}" | ||||
| 		pkgctl_issue_write_recovery_file "${pkgbase}" "${message}" "${recovery_file}" "${recover}" | ||||
| 		exit 1 | ||||
| 	fi | ||||
|  | ||||
| 	# delete old recovery file if we succeeded | ||||
| 	if [[ -f ${recovery_file} ]]; then | ||||
| 		rm --force "${recovery_file}" | ||||
| 	fi | ||||
|  | ||||
| 	issue_url="${GIT_PACKAGING_URL_HTTPS}/${project_path}/-/issues/${iid}" | ||||
| 	msg_success "Updated issue ${BOLD}#${iid}${ALL_OFF}" | ||||
| 	printf "%sView this issue on GitLab: %s%s\n" "${GRAY}" "${issue_url}" "${ALL_OFF}" | ||||
| } | ||||
|  | ||||
| pkgctl_issue_write_recovery_file() { | ||||
| 	local pkgbase=$1 | ||||
| 	local message=$2 | ||||
| 	local recovery_file=$3 | ||||
|  | ||||
| 	if [[ -f ${recovery_file} ]]; then | ||||
| 		msg_warn "Recovery file already exists: ${recovery_file}" | ||||
| 		if ! prompt "${YELLOW}${BOLD}?${ALL_OFF} Are you sure you want to overwrite it?"; then | ||||
| 			return 1 | ||||
| 		fi | ||||
| 	fi | ||||
|  | ||||
| 	mkdir -p "$(dirname "${recovery_file}")" | ||||
| 	printf "%s\n" "${message}" > "${recovery_file}" | ||||
|  | ||||
| 	printf "Created recovery file: %s\n" "${recovery_file}" | ||||
| 	return 0 | ||||
| } | ||||
| @@ -1,124 +0,0 @@ | ||||
| #!/hint/bash | ||||
| # | ||||
| # SPDX-License-Identifier: GPL-3.0-or-later | ||||
|  | ||||
| [[ -z ${DEVTOOLS_INCLUDE_ISSUE_SH:-} ]] || return 0 | ||||
| DEVTOOLS_INCLUDE_ISSUE_SH=1 | ||||
|  | ||||
| _DEVTOOLS_LIBRARY_DIR=${_DEVTOOLS_LIBRARY_DIR:-@pkgdatadir@} | ||||
|  | ||||
| set -eo pipefail | ||||
|  | ||||
|  | ||||
| pkgctl_issue_usage() { | ||||
| 	local -r COMMAND=${_DEVTOOLS_COMMAND:-${BASH_SOURCE[0]##*/}} | ||||
| 	cat <<- _EOF_ | ||||
| 		Usage: ${COMMAND} [COMMAND] [OPTIONS] | ||||
|  | ||||
| 		Work with GitLab packaging issues. | ||||
|  | ||||
| 		COMMANDS | ||||
| 		    close     Close an issue | ||||
| 		    comment   Comment on an issue | ||||
| 		    create    Create a new issue | ||||
| 		    edit      Edit and modify an issue | ||||
| 		    list      List project or group issues | ||||
| 		    move      Move an issue to another project | ||||
| 		    reopen    Reopen a closed issue | ||||
| 		    view      Display information about an issue | ||||
|  | ||||
| 		OPTIONS | ||||
| 		    -h, --help    Show this help text | ||||
|  | ||||
| 		EXAMPLES | ||||
| 		    $ ${COMMAND} list libfoo libbar | ||||
| 		    $ ${COMMAND} view 4 | ||||
| _EOF_ | ||||
| } | ||||
|  | ||||
| pkgctl_issue() { | ||||
| 	if (( $# < 1 )); then | ||||
| 		pkgctl_issue_usage | ||||
| 		exit 0 | ||||
| 	fi | ||||
|  | ||||
| 	# option checking | ||||
| 	while (( $# )); do | ||||
| 		case $1 in | ||||
| 			-h|--help) | ||||
| 				pkgctl_issue_usage | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			close) | ||||
| 				_DEVTOOLS_COMMAND+=" $1" | ||||
| 				shift | ||||
| 				# shellcheck source=src/lib/issue/close.sh | ||||
| 				source "${_DEVTOOLS_LIBRARY_DIR}"/lib/issue/close.sh | ||||
| 				pkgctl_issue_close "$@" | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			create) | ||||
| 				_DEVTOOLS_COMMAND+=" $1" | ||||
| 				shift | ||||
| 				# shellcheck source=src/lib/issue/create.sh | ||||
| 				source "${_DEVTOOLS_LIBRARY_DIR}"/lib/issue/create.sh | ||||
| 				pkgctl_issue_create "$@" | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			edit|update) | ||||
| 				_DEVTOOLS_COMMAND+=" $1" | ||||
| 				shift | ||||
| 				# shellcheck source=src/lib/issue/edit.sh | ||||
| 				source "${_DEVTOOLS_LIBRARY_DIR}"/lib/issue/edit.sh | ||||
| 				pkgctl_issue_edit "$@" | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			list) | ||||
| 				_DEVTOOLS_COMMAND+=" $1" | ||||
| 				shift | ||||
| 				# shellcheck source=src/lib/issue/list.sh | ||||
| 				source "${_DEVTOOLS_LIBRARY_DIR}"/lib/issue/list.sh | ||||
| 				pkgctl_issue_list "$@" | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			comment|note) | ||||
| 				_DEVTOOLS_COMMAND+=" $1" | ||||
| 				shift | ||||
| 				# shellcheck source=src/lib/issue/comment.sh | ||||
| 				source "${_DEVTOOLS_LIBRARY_DIR}"/lib/issue/comment.sh | ||||
| 				pkgctl_issue_comment "$@" | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			move) | ||||
| 				_DEVTOOLS_COMMAND+=" $1" | ||||
| 				shift | ||||
| 				# shellcheck source=src/lib/issue/move.sh | ||||
| 				source "${_DEVTOOLS_LIBRARY_DIR}"/lib/issue/move.sh | ||||
| 				pkgctl_issue_move "$@" | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			reopen) | ||||
| 				_DEVTOOLS_COMMAND+=" $1" | ||||
| 				shift | ||||
| 				# shellcheck source=src/lib/issue/reopen.sh | ||||
| 				source "${_DEVTOOLS_LIBRARY_DIR}"/lib/issue/reopen.sh | ||||
| 				pkgctl_issue_reopen "$@" | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			view) | ||||
| 				_DEVTOOLS_COMMAND+=" $1" | ||||
| 				shift | ||||
| 				# shellcheck source=src/lib/issue/view.sh | ||||
| 				source "${_DEVTOOLS_LIBRARY_DIR}"/lib/issue/view.sh | ||||
| 				pkgctl_issue_view "$@" | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			-*) | ||||
| 				die "invalid argument: %s" "$1" | ||||
| 				;; | ||||
| 			*) | ||||
| 				die "invalid command: %s" "$1" | ||||
| 				;; | ||||
| 		esac | ||||
| 	done | ||||
| } | ||||
| @@ -1,417 +0,0 @@ | ||||
| #!/hint/bash | ||||
| # | ||||
| # SPDX-License-Identifier: GPL-3.0-or-later | ||||
|  | ||||
| [[ -z ${DEVTOOLS_INCLUDE_ISSUE_LIST_SH:-} ]] || return 0 | ||||
| DEVTOOLS_INCLUDE_ISSUE_LIST_SH=1 | ||||
|  | ||||
| _DEVTOOLS_LIBRARY_DIR=${_DEVTOOLS_LIBRARY_DIR:-@pkgdatadir@} | ||||
|  | ||||
| # shellcheck source=src/lib/common.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/common.sh | ||||
| # shellcheck source=src/lib/api/gitlab.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/api/gitlab.sh | ||||
| # shellcheck source=src/lib/util/term.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/util/term.sh | ||||
|  | ||||
| set -eo pipefail | ||||
|  | ||||
|  | ||||
| pkgctl_issue_list_usage() { | ||||
| 	local -r COMMAND=${_DEVTOOLS_COMMAND:-${BASH_SOURCE[0]##*/}} | ||||
| 	cat <<- _EOF_ | ||||
| 		Usage: ${COMMAND} [OPTIONS] [PKGBASE] | ||||
|  | ||||
| 		The pkgctl issue list command is used to list issues associated with a specific | ||||
| 		packaging project or the entire packaging subgroup in Arch Linux. This command | ||||
| 		facilitates efficient issue management by allowing users to list and filter | ||||
| 		issues based on various criteria. | ||||
|  | ||||
| 		Results can also be displayed directly in a web browser for easier navigation | ||||
| 		and review. | ||||
|  | ||||
| 		OPTIONS | ||||
| 		    -g, --group             Get issues from the whole packaging subgroup | ||||
| 		    -w, --web               View results in a browser | ||||
| 		    -h, --help              Show this help text | ||||
|  | ||||
| 		FILTER | ||||
| 		    -A, --all               Get all issues including closed | ||||
| 		    -c, --closed            Get only closed issues | ||||
| 		    -U, --unconfirmed       Shorthand to filter by unconfirmed status label | ||||
| 		    --search SEARCH         Search <string> in the fields defined by --in | ||||
| 		    --in LOCATION           Search in title or description (default: all) | ||||
| 		    -l, --label NAME        Filter issue by label <name> | ||||
| 		    --confidentiality TYPE  Filter by confidentiality | ||||
| 		    --priority PRIORITY     Shorthand to filter by priority label | ||||
| 		    --resolution REASON     Shorthand to filter by resolution label | ||||
| 		    --scope SCOPE           Shorthand to filter by scope label | ||||
| 		    --severity SEVERITY     Shorthand to filter by severity label | ||||
| 		    --status STATUS         Shorthand to filter by status label | ||||
| 		    --assignee USERNAME     Filter issues assigned to the given username | ||||
| 		    --assigned-to-me        Shorthand to filter issues assigned to you | ||||
| 		    --author USERNAME       Filter issues authored by the given username | ||||
| 		    --created-by-me         Shorthand to filter issues created by you | ||||
|  | ||||
| 		EXAMPLES | ||||
| 		    $ ${COMMAND} libfoo libbar | ||||
| 		    $ ${COMMAND} --group --unconfirmed | ||||
| _EOF_ | ||||
| } | ||||
|  | ||||
| pkgctl_issue_list() { | ||||
| 	if (( $# < 1 )) && [[ ! -f PKGBUILD ]]; then | ||||
| 		pkgctl_issue_list_usage | ||||
| 		exit 0 | ||||
| 	fi | ||||
|  | ||||
| 	local paths path project_path params web_params label username issue_url | ||||
|  | ||||
| 	local group=0 | ||||
| 	local web=0 | ||||
| 	local confidential=0 | ||||
| 	local state=opened | ||||
| 	local request_data="" | ||||
| 	local search_in="all" | ||||
| 	local labels=() | ||||
| 	local assignee= | ||||
| 	local author= | ||||
| 	local scope=all | ||||
| 	local confidentiality= | ||||
|  | ||||
| 	# option checking | ||||
| 	while (( $# )); do | ||||
| 		case $1 in | ||||
| 			-h|--help) | ||||
| 				pkgctl_issue_list_usage | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			-A|--all) | ||||
| 				state=all | ||||
| 				shift | ||||
| 				;; | ||||
| 			-c|--closed) | ||||
| 				state=closed | ||||
| 				shift | ||||
| 				;; | ||||
| 			-U|--unconfirmed) | ||||
| 				labels+=("$(status_as_gitlab_label unconfirmed)") | ||||
| 				shift | ||||
| 				;; | ||||
| 			-g|--group) | ||||
| 				group=1 | ||||
| 				shift | ||||
| 				;; | ||||
| 			-w|--web) | ||||
| 				web=1 | ||||
| 				shift | ||||
| 				;; | ||||
| 			--in) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				search_in=$2 | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--search) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				request_data="search=$2" | ||||
| 				web_params+="&search=$2" | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			-l|--label) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				labels+=("$2") | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--confidentiality) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				confidentiality=$2 | ||||
| 				if ! in_array "${confidentiality}" "${DEVTOOLS_VALID_ISSUE_CONFIDENTIALITY[@]}"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--priority) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! label="$(priority_as_gitlab_label "$2")"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				labels+=("$label") | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--resolution) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! label="$(resolution_as_gitlab_label "$2")"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				labels+=("$label") | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--scope) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! label="$(scope_as_gitlab_label "$2")"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				labels+=("$label") | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--severity) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! label="$(severity_as_gitlab_label "$2")"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				labels+=("$label") | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--status) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				if ! label="$(status_as_gitlab_label "$2")"; then | ||||
| 					die "invalid argument for %s: %s" "$1" "$2" | ||||
| 				fi | ||||
| 				labels+=("$label") | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--assignee) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				assignee="$2" | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--assigned-to-me) | ||||
| 				scope=assigned_to_me | ||||
| 				shift | ||||
| 				;; | ||||
| 			--author) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				author="$2" | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			--created-by-me) | ||||
| 				scope=created_by_me | ||||
| 				shift | ||||
| 				;; | ||||
| 			-*) | ||||
| 				die "invalid argument: %s" "$1" | ||||
| 				;; | ||||
| 			*) | ||||
| 				paths=("$@") | ||||
| 				break | ||||
| 				;; | ||||
| 		esac | ||||
| 	done | ||||
|  | ||||
| 	if [[ ${search_in} == all ]]; then | ||||
| 		search_in="title,description" | ||||
| 	else | ||||
| 		web_params+="&in=${search_in^^}" | ||||
| 	fi | ||||
| 	params+="&in=${search_in}" | ||||
|  | ||||
| 	if [[ ${state} != all ]]; then | ||||
| 		params+="&state=${state}" | ||||
| 	fi | ||||
| 	web_params+="&state=${state}" | ||||
|  | ||||
| 	if (( ${#labels} )); then | ||||
| 		params+="&labels=$(join_by , "${labels[@]}")" | ||||
| 		web_params+="&label_name[]=$(join_by "&label_name[]=" "${labels[@]}")" | ||||
| 	fi | ||||
|  | ||||
| 	if [[ -n ${scope} ]]; then | ||||
| 		params+="&scope=${scope}" | ||||
| 		if (( web )); then | ||||
| 			if ! username=$(gitlab_api_get_user); then | ||||
| 				exit 1 | ||||
| 			fi | ||||
| 			case "${scope}" in | ||||
| 				created_by_me) author=${username} ;; | ||||
| 				assigned_to_me) assignee=${username} ;; | ||||
| 			esac | ||||
| 		fi | ||||
| 	fi | ||||
|  | ||||
| 	if [[ -n ${assignee} ]]; then | ||||
| 		params+="&assignee_username=${assignee}" | ||||
| 		web_params+="&assignee_username=${assignee}" | ||||
| 	fi | ||||
|  | ||||
| 	if [[ -n ${author} ]]; then | ||||
| 		params+="&author_username=${author}" | ||||
| 		web_params+="&author_username=${author}" | ||||
| 	fi | ||||
|  | ||||
| 	if [[ -n ${confidentiality} ]]; then | ||||
| 		if [[ ${confidentiality} == confidential ]]; then | ||||
| 			params+="&confidential=true" | ||||
| 			web_params+="&confidential=yes" | ||||
| 		else | ||||
| 			params+="&confidential=false" | ||||
| 			web_params+="&confidential=no" | ||||
| 		fi | ||||
| 	fi | ||||
|  | ||||
| 	# check if invoked without any path from within a packaging repo | ||||
| 	if (( ${#paths[@]} == 0 )); then | ||||
| 		if [[ -f PKGBUILD ]] && (( ! group )); then | ||||
| 			paths=("$(realpath --canonicalize-existing .)") | ||||
| 		elif (( ! group )); then | ||||
| 			pkgctl_issue_list_usage | ||||
| 			exit 1 | ||||
| 		fi | ||||
| 	fi | ||||
|  | ||||
| 	if (( web )) && ! command -v xdg-open &>/dev/null; then | ||||
| 		die "The web option requires 'xdg-open'" | ||||
| 	fi | ||||
|  | ||||
| 	local separator="	" | ||||
|  | ||||
| 	for path in "${paths[@]}"; do | ||||
| 		# skip paths from a glob that aren't directories | ||||
| 		if [[ -e "${path}" ]] && [[ ! -d "${path}" ]]; then | ||||
| 			continue | ||||
| 		fi | ||||
|  | ||||
| 		pkgbase=$(basename "${path}") | ||||
| 		project_path=$(gitlab_project_name_to_path "${pkgbase}") | ||||
|  | ||||
| 		echo "${UNDERLINE}${pkgbase}${ALL_OFF}" | ||||
|  | ||||
| 		if (( web )); then | ||||
| 			issue_url="${GIT_PACKAGING_URL_HTTPS}/${project_path}/-/issues/?${web_params}" | ||||
| 			echo "Opening ${issue_url} in your browser." | ||||
| 			xdg-open "${issue_url}" | ||||
| 			continue | ||||
| 		fi | ||||
|  | ||||
| 		status_dir=$(mktemp --tmpdir="${WORKDIR}" --directory pkgctl-gitlab-api.XXXXXXXXXX) | ||||
| 		printf "📡 Querying GitLab issues API..." > "${status_dir}/status" | ||||
| 		term_spinner_start "${status_dir}" | ||||
| 		if ! output=$(gitlab_projects_issues_list "${project_path}" "${status_dir}/status" "${params}" "${request_data}"); then | ||||
| 			term_spinner_stop "${status_dir}" | ||||
| 			echo | ||||
| 			continue | ||||
| 		fi | ||||
| 		term_spinner_stop "${status_dir}" | ||||
|  | ||||
| 		issue_count=$(jq --compact-output 'length' <<< "${output}") | ||||
| 		if (( issue_count == 0 )); then | ||||
| 			echo "No open issues match your search" | ||||
| 			echo | ||||
| 			continue | ||||
| 		else | ||||
| 			echo "Showing ${issue_count} issues that match your search" | ||||
| 		fi | ||||
|  | ||||
| 		print_issue_list "${output}" | ||||
| 	done | ||||
|  | ||||
| 	if (( group )); then | ||||
| 		if (( web )); then | ||||
| 			issue_url="https://${GITLAB_HOST}/groups/${GIT_PACKAGING_NAMESPACE}/-/issues/?${web_params}" | ||||
| 			echo "Opening ${issue_url} in your browser." | ||||
| 			xdg-open "${issue_url}" | ||||
| 			return | ||||
| 		fi | ||||
|  | ||||
| 		status_dir=$(mktemp --tmpdir="${WORKDIR}" --directory pkgctl-gitlab-api.XXXXXXXXXX) | ||||
| 		printf "📡 Querying GitLab issues API..." > "${status_dir}/status" | ||||
| 		term_spinner_start "${status_dir}" | ||||
| 		if ! output=$(gitlab_group_issue_list "${GIT_PACKAGING_NAMESPACE_ID}" "${status_dir}/status" "${params}" "${request_data}"); then | ||||
| 			term_spinner_stop "${status_dir}" | ||||
| 			exit 1 | ||||
| 		fi | ||||
| 		term_spinner_stop "${status_dir}" | ||||
|  | ||||
| 		print_issue_list "${output}" | ||||
| 	fi | ||||
| } | ||||
|  | ||||
| print_issue_list() { | ||||
| 	local output=$1 | ||||
| 	local limit=${2:-100} | ||||
| 	local i=0 | ||||
| 	local status_dir | ||||
| 	local longest_pkgname | ||||
|  | ||||
| 	# limit results | ||||
| 	output=$(jq ".[:${limit}]" <<< "${output}") | ||||
|  | ||||
| 	mapfile -t project_ids < <( | ||||
| 		jq --raw-output '[.[].project_id] | unique[]' <<< "${output}") | ||||
|  | ||||
| 	status_dir=$(mktemp --tmpdir="${WORKDIR}" --directory pkgctl-gitlab-api.XXXXXXXXXX) | ||||
| 	printf "📡 Querying GitLab project names..." > "${status_dir}/status" | ||||
| 	term_spinner_start "${status_dir}" | ||||
|  | ||||
| 	# read project_id to name mapping from cache | ||||
| 	declare -A project_name_lookup=() | ||||
| 	while read -r project_id project_name; do | ||||
| 		project_name_lookup[${project_id}]=${project_name} | ||||
| 	done < <(gitlab_lookup_project_names "${status_dir}/status" "${project_ids[@]}") | ||||
| 	longest_pkgname=$(longest_package_name_from_ids "${project_ids[@]}") | ||||
|  | ||||
| 	term_spinner_stop "${status_dir}" | ||||
|  | ||||
| 	result_file=$(mktemp --tmpdir="${WORKDIR}" pkgctl-issue-list.XXXXXXXXXX) | ||||
| 	printf "📡 Collecting issue information %%spinner%%" > "${status_dir}/status" | ||||
| 	term_spinner_start "${status_dir}" | ||||
|  | ||||
| 	local columns="ID,Title,Scope,Status,Severity,Age" | ||||
| 	if (( group )); then | ||||
| 		columns="ID,Package,Title,Scope,Status,Severity,Age" | ||||
| 	fi | ||||
|  | ||||
| 	# pretty print each result | ||||
| 	while read -r result; do | ||||
| 		if (( i > limit )); then | ||||
| 			break | ||||
| 		fi | ||||
| 		i=$(( ++i )) | ||||
|  | ||||
| 		{ read -r project_id; read -r iid; read -r title; read -r state; read -r created_at; read -r confidential; } < <( | ||||
| 			jq --raw-output ".project_id, .iid, .title, .state, .created_at, .confidential" <<< "${result}" | ||||
| 		) | ||||
| 		mapfile -t labels < <( | ||||
| 			jq --raw-output ".labels[]" <<< "${result}" | ||||
| 		) | ||||
|  | ||||
| 		pkgbase=${project_name_lookup[${project_id}]} | ||||
| 		created_at=$(relative_date_unit "${created_at}") | ||||
| 		severity="$(gitlab_severity_from_labels "${labels[@]}")" | ||||
| 		severity_color="$(gitlab_severity_color "${severity}")" | ||||
| 		state_color="$(gitlab_issue_state_color "${state}")" | ||||
| 		state="$(gitlab_issue_state_display "${state}")" | ||||
| 		status="$(gitlab_issue_status_from_labels "${labels[@]}")" | ||||
| 		status_color="$(gitlab_issue_status_color "${status}")" | ||||
| 		status="$(gitlab_issue_status_short "${status}")" | ||||
| 		scope="$(gitlab_scope_from_labels "${labels[@]}")" | ||||
| 		scope_color="$(gitlab_scope_color "${scope}")" | ||||
| 		scope="$(gitlab_scope_short "${scope}")" | ||||
|  | ||||
| 		title_space=$(( COLUMNS - 7 - 10 - 15 - 12 - 10 )) | ||||
| 		if (( group )); then | ||||
| 			title_space=$(( title_space - longest_pkgname )) | ||||
| 		fi | ||||
| 		if [[ ${confidential} == true ]]; then | ||||
| 			title_space=$(( title_space - 2 )) | ||||
| 		fi | ||||
| 		title=$(trim_string "${title_space}" "${title}") | ||||
| 		# gum is silly and doesn't allow double quotes | ||||
| 		title=${title//\"/} | ||||
| 		if [[ ${confidential} == true ]]; then | ||||
| 			title="${YELLOW}${PKGCTL_TERM_ICON_CONFIDENTIAL} ${title}${ALL_OFF}" | ||||
| 		fi | ||||
|  | ||||
| 		if (( group )); then | ||||
| 			printf "%s\n" "${state_color}#$iid${ALL_OFF}${separator}${BOLD}${pkgbase}${separator}${ALL_OFF}${title}${separator}${scope_color}${scope}${ALL_OFF}${separator}${status_color}${status}${separator}${severity_color}${severity}${ALL_OFF}${separator}${GRAY}${created_at}${ALL_OFF}" \ | ||||
| 				>> "${result_file}" | ||||
| 		else | ||||
| 			printf "%s\n" "${state_color}#$iid${ALL_OFF}${separator}${title}${separator}${scope_color}${scope}${ALL_OFF}${separator}${status_color}${status}${separator}${severity_color}${severity}${ALL_OFF}${separator}${GRAY}${created_at}${ALL_OFF}" \ | ||||
| 				>> "${result_file}" | ||||
| 		fi | ||||
| 	done < <(jq --compact-output '.[]' <<< "${output}") | ||||
|  | ||||
| 	term_spinner_stop "${status_dir}" | ||||
|  | ||||
| 	gum table --print --border="none" --columns="${columns}" \ | ||||
| 		--separator="${separator}" --file "${result_file}" | ||||
| } | ||||
| @@ -1,156 +0,0 @@ | ||||
| #!/hint/bash | ||||
| # | ||||
| # SPDX-License-Identifier: GPL-3.0-or-later | ||||
|  | ||||
| [[ -z ${DEVTOOLS_INCLUDE_ISSUE_MOVE_SH:-} ]] || return 0 | ||||
| DEVTOOLS_INCLUDE_ISSUE_MOVE_SH=1 | ||||
|  | ||||
| _DEVTOOLS_LIBRARY_DIR=${_DEVTOOLS_LIBRARY_DIR:-@pkgdatadir@} | ||||
|  | ||||
| # shellcheck source=src/lib/common.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/common.sh | ||||
| # shellcheck source=src/lib/cache.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/cache.sh | ||||
| # shellcheck source=src/lib/api/gitlab.sh | ||||
| source "${_DEVTOOLS_LIBRARY_DIR}"/lib/api/gitlab.sh | ||||
|  | ||||
| set -eo pipefail | ||||
|  | ||||
|  | ||||
| pkgctl_issue_move_usage() { | ||||
| 	local -r COMMAND=${_DEVTOOLS_COMMAND:-${BASH_SOURCE[0]##*/}} | ||||
| 	cat <<- _EOF_ | ||||
| 		Usage: ${COMMAND} [OPTIONS] [IID] [DESTINATION_PACKAGE] | ||||
|  | ||||
| 		The move command allows users to transfer an issue from one project to another | ||||
| 		within the Arch Linux packaging group. This is useful when an issue is | ||||
| 		identified to be more relevant or better handled in a different project. | ||||
|  | ||||
| 		By default, the command operates within the current directory, but users can | ||||
| 		specify a different package base from which to move the issue. | ||||
|  | ||||
| 		Users must specify the issue ID (IID) and the destination package to which the | ||||
| 		issue should be moved. A comment message explaining the reason for the move can | ||||
| 		be provided directly through the command line. | ||||
|  | ||||
| 		OPTIONS | ||||
| 		    -p, --package PKGBASE  Move from <pkgbase> instead of the current directory | ||||
| 		    -m, --message MSG      Use the provided message as the comment | ||||
| 		    -e, --edit             Edit the comment using an editor | ||||
| 		    -h, --help             Show this help text | ||||
|  | ||||
| 		EXAMPLES | ||||
| 		    $ ${COMMAND} 42 to-bar | ||||
| 		    $ ${COMMAND} --package from-foo 42 to-bar | ||||
| _EOF_ | ||||
| } | ||||
|  | ||||
| pkgctl_issue_move() { | ||||
| 	if (( $# < 1 )); then | ||||
| 		pkgctl_issue_move_usage | ||||
| 		exit 0 | ||||
| 	fi | ||||
|  | ||||
| 	local iid="" | ||||
| 	local pkgbase="" | ||||
| 	local message="" | ||||
| 	local edit=0 | ||||
|  | ||||
| 	local to_project_name to_project_id project_path issue_url to_iid result | ||||
|  | ||||
| 	# option checking | ||||
| 	while (( $# )); do | ||||
| 		case $1 in | ||||
| 			-h|--help) | ||||
| 				pkgctl_issue_move_usage | ||||
| 				exit 0 | ||||
| 				;; | ||||
| 			-p|--package) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				pkgbase=$2 | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			-m|--message) | ||||
| 				(( $# <= 1 )) && die "missing argument for %s" "$1" | ||||
| 				message=$2 | ||||
| 				shift 2 | ||||
| 				;; | ||||
| 			-e|--edit) | ||||
| 				edit=1 | ||||
| 				shift | ||||
| 				;; | ||||
| 			-*) | ||||
| 				die "invalid argument: %s" "$1" | ||||
| 				;; | ||||
| 			*) | ||||
| 				break | ||||
| 				;; | ||||
| 		esac | ||||
| 	done | ||||
|  | ||||
| 	if [[ -z ${pkgbase} ]]; then | ||||
| 		if ! [[ -f PKGBUILD ]]; then | ||||
| 			die "missing --package option or PKGBUILD in current directory" | ||||
| 		fi | ||||
| 		pkgbase=$(realpath --canonicalize-existing .) | ||||
| 	fi | ||||
| 	pkgbase=$(basename "${pkgbase}") | ||||
|  | ||||
| 	if (( $# < 2 )); then | ||||
| 		pkgctl_issue_move_usage | ||||
| 		exit 1 | ||||
| 	fi | ||||
|  | ||||
| 	iid=$1 | ||||
| 	to_project_name=$(basename "$2") | ||||
|  | ||||
| 	# spawn editor | ||||
| 	if (( edit )); then | ||||
| 		msgfile=$(mktemp --tmpdir="${WORKDIR}" pkgctl-issue-note.XXXXXXXXXX.md) | ||||
| 		printf "%s\n" "${message}" >> "${msgfile}" | ||||
| 		if [[ -n $VISUAL ]]; then | ||||
| 			$VISUAL "${msgfile}" || die | ||||
| 		elif [[ -n $EDITOR ]]; then | ||||
| 			$EDITOR "${msgfile}" || die | ||||
| 		else | ||||
| 			die "No usable editor found (tried \$VISUAL, \$EDITOR)." | ||||
| 		fi | ||||
| 		message=$(cat "${msgfile}") | ||||
| 	fi | ||||
|  | ||||
| 	if ! result=$(gitlab_project "${to_project_name}"); then | ||||
| 		msg_error "Failed to query target project ${BOLD}${to_project_name}${ALL_OFF}" | ||||
| 		exit 1 | ||||
| 	fi | ||||
|  | ||||
| 	if ! to_project_id=$(jq --raw-output ".id" <<< "${result}"); then | ||||
| 		msg_error "Failed to query project id for ${BOLD}${to_project_name}${ALL_OFF}" | ||||
| 		exit 1 | ||||
| 	fi | ||||
|  | ||||
| 	# comment on issue | ||||
| 	if [[ -n ${message} ]]; then | ||||
| 		if ! result=$(gitlab_create_project_issue_note "${pkgbase}" "${iid}" "${message}"); then | ||||
| 			msg_error "Failed to comment on issue ${BOLD}#${iid}${ALL_OFF}" | ||||
| 			exit 1 | ||||
| 		fi | ||||
| 		msg_success "Commented on issue ${BOLD}#${iid}${ALL_OFF}" | ||||
| 	fi | ||||
|  | ||||
| 	if ! result=$(gitlab_project_issue_move "${pkgbase}" "${iid}" "${to_project_id}"); then | ||||
| 		msg_error "Failed to move issue ${BOLD}#${iid}${ALL_OFF} to ${BOLD}${to_project_name}${ALL_OFF}" | ||||
| 		exit 1 | ||||
| 	fi | ||||
|  | ||||
| 	if ! to_iid=$(jq --raw-output ".iid" <<< "${result}"); then | ||||
| 		msg_error "Failed to query issue id for ${BOLD}${to_project_name}${ALL_OFF}" | ||||
| 		exit 1 | ||||
| 	fi | ||||
|  | ||||
| 	project_path=$(gitlab_project_name_to_path "${to_project_name}") | ||||
| 	issue_url="${GIT_PACKAGING_URL_HTTPS}/${project_path}/-/issues/${to_iid}" | ||||
|  | ||||
| 	msg_success "Moved issue ${BOLD}${pkgbase}${ALL_OFF} ${BOLD}#${iid}${ALL_OFF} to ${BOLD}${to_project_name}${ALL_OFF} ${BOLD}#${to_iid}${ALL_OFF}" | ||||
| 	echo | ||||
| 	printf "%sView this issue on GitLab: %s%s\n" "${GRAY}" "${issue_url}" "${ALL_OFF}" | ||||
| } | ||||
Some files were not shown because too many files have changed in this diff Show More
		Reference in New Issue
	
	Block a user