Support xbps packages

[Elara6331]

Is your feature request related to a problem? Please describe.

nFPM doesn't have support for the XBPS package format used by Void Linux

Describe the solution you'd like

Implement support for XBPS packages. I can work on a PR for this.

Describe alternatives you've considered

N/A

Search

• I did search for other open and closed issues before opening this.

Code of Conduct

• I agree to follow this project's Code of Conduct

Additional context

No response

[caarlos0]

I don't know and never personally used xbps packages or void linux, but if you want to work on it, feel free to.

the steps are:

• implement the packager interface
• add unit tests for what is possible
• add integration tests
• add/update documentation

I can give more detailed help on specifics if you need, although I'm a bit swamped and may be slow to respond.

In any case, thanks for the interested in contributing 🤟🏻

[Elara6331]

Thanks! I contributed Arch support so I remember how to do this :)

[caarlos0]

ah, right, sorry I didn't recognize you :D

the offer stand, if you need help, let me know :D

[caarlos0]

hey!

is this still something you want to work on? if not, I think I'll close it, as no one else showed interest...

[IronFractal]

Void Linux Repositories:

https://mirrors.servercentral.com/voidlinux/current/
https://mirrors.servercentral.com/voidlinux/current/musl/

xbps-create source:

https://github.com/void-linux/xbps/tree/master/bin/xbps-create

XBPS-CREATE(1)              General Commands Manual             XBPS-CREATE(1)

NAME
     xbps-create – XBPS utility to create binary packages

SYNOPSIS
     xbps-create [OPTIONS] destdir

DESCRIPTION
     The xbps-create utility creates XBPS binary packages from files stored in
     a directory.  The files must have correct permissions and location within
     this directory.  The behaviour of resulting package is changed by using
     multiple values in the options.

OPTIONS
     -A, --architecture string
         The target architecture for this package (required). Use noarch if
         package doesn't contain any arch-dependent file.

     -B, --built-with string
         The package builder string, free form.

     -C, --conflicts list
         A list of package patterns that this package should conflict with,
         separated by whitespaces. Example: 'foo>=1.0 blah<1.0'.

     -c, --changelog string
         The package changelog string.

     -D, --dependencies list
         A list of package patterns this package depends on, separated by
         whitespaces. Example: 'foo>=1.0 blah-1.0_1'.

     -F, --config-files list
         A list of configuration files this package provides, separated by
         whitespace.

     -G, --source-revisions string
         This sets a string with the git revisions of the sourcepkg that was
         used to build this binary package. It is set automatically by xbps-
         src.

     -H, --homepage string
         The package homepage string.

     -h, --help
         Show the help message.

     -l, --license string
         The package license.

     -M, --mutable-files list
         A list of mutable files this package provides, separated by
         whitespaces.

     -m, --maintainer string
         The package maintainer name and/or email contact.

     -n, --pkgver string
         The package name/version tuple, e.g: 'foo-1.0_1'.

     -P, --provides list
         A list of virtual packages this package provides, separated by
         whitespaces. Example: 'virtualpkg-9999 virtualpkg2-1.0_1'.

     -p, --preserve
         If set the package files will be preserved after being updated.

     -q, --quiet
         Enable quiet operation.

     -R, --replaces list
         A list of package patterns this package replaces, separated by
         whitespaces. Example: 'foo>=1.0 blah>=2.0'.

     -r, --reverts list
         A list of versions this package reverts, separated by whitespaces.
         Example: '2.0_1 2.1_1'.

     -S, --long-desc string
         A long description for this package.

     -s, --desc string
         A short description for this package, one line with less than 80
         characters.

     -t, --tags list
         A list of tags (categories) this package should be part of, separated
         by whitespaces. Example: 'development nonfree'.

     -V, --version
         Show the version information.

     --alternatives list
         A list of alternatives provided by this package, separated by
         whitespaces. Example: 'group:symlink:target group2:symlink:target'.
         If symlink is a relative path, the symlink will be created relative
         to target.

     --build-options string
         A string containing the build options used in package.

     --compression none | gzip | bzip2 | xz | lz4 | zstd
         Set the binary package compression format. If unset, defaults to
         zstd.

     --shlib-provides list
         A list of provided shared libraries, separated by whitespaces.
         Example: 'libfoo.so.2 libblah.so.1'.

     --shlib-requires list
         A list of required shared libraries, separated by whitespaces.
         Example: 'libz.so.1 libfoo.so.2'.

     --sourcepkg string
         The pkgver of the sourcepkg that was used to build this binary
         package.

EXIT STATUS
     The xbps-create utility exits 0 on success, and >0 if an error occurs.  A
     descriptive error message will be printed to stderr.

SEE ALSO
     xbps-alternatives(1), xbps-checkvers(1), xbps-dgraph(1), xbps-digest(1),
     xbps-fbulk(1), xbps-fetch(1), xbps-install(1), xbps-pkgdb(1),
     xbps-query(1), xbps-reconfigure(1), xbps-remove(1), xbps-rindex(1),
     xbps-uchroot(1), xbps-uunshare(1), xbps.d(5)

AUTHORS
     Juan Romero Pardines <xtraeme@gmail.com>

BUGS
     Probably, but I try to make this not happen. Use it under your own
     responsibility and enjoy your life.

     Report bugs at https://github.com/void-linux/xbps/issues

Void Linux                     February 9, 2023                     Void Linux

---

file extension: .xbps

$ file fd-10.3.0_1.x86_64-musl.xbps 
fd-10.3.0_1.x86_64-musl.xbps: Zstandard compressed data (v0.8+), Dictionary ID: None

note from xbps-create manpage "none, gzip, bzip2, lz4, xz, zstd (default)"

$ zstd --decompress fd-10.3.0_1.x86_64-musl.xbps -o fd-10.3.0_1.x86_64-musl.xbps.clear
$ file fd-10.3.0_1.x86_64-musl.xbps.clear 
fd-10.3.0_1.x86_64-musl.xbps.clear: POSIX tar archive
$ tar --list --file fd-10.3.0_1.x86_64-musl.xbps
./props.plist
./files.plist
./usr/share/zsh/site-functions/_fd
./usr/share/man/man1/fd.1
./usr/share/licenses/fd/LICENSE-MIT
./usr/share/licenses/fd/LICENSE-APACHE
./usr/share/fish/vendor_completions.d/fd.fish
./usr/share/bash-completion/completions/fd
./usr/bin/fd

$ cat files.plist 
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>dirs</key>
	<array>
		<dict>
			<key>file</key>
			<string>/usr</string>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/bin</string>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share</string>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share/bash-completion</string>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share/bash-completion/completions</string>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share/fish</string>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share/fish/vendor_completions.d</string>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share/licenses</string>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share/licenses/fd</string>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share/man</string>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share/man/man1</string>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share/zsh</string>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share/zsh/site-functions</string>
		</dict>
	</array>
	<key>files</key>
	<array>
		<dict>
			<key>file</key>
			<string>/usr/bin/fd</string>
			<key>sha256</key>
			<string>72b360ee90267b6295f4fbc1cee93539c91764b54012a0836b9cb87cfb10476f</string>
			<key>size</key>
			<integer>4053488</integer>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share/bash-completion/completions/fd</string>
			<key>sha256</key>
			<string>8c14a6bbfa44cd9e74111ccd7afc7eb6977eaaabcc81060d445db3cfc7262962</string>
			<key>size</key>
			<integer>7001</integer>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share/fish/vendor_completions.d/fd.fish</string>
			<key>sha256</key>
			<string>b5ca455489b4a51b452f662fc0b7d5bc70aa022a0a0b9a096c957e455db39400</string>
			<key>size</key>
			<integer>6037</integer>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share/licenses/fd/LICENSE-APACHE</string>
			<key>sha256</key>
			<string>73c83c60d817e7df1943cb3f0af81e4939a8352c9a96c2fd00451b1116fa635c</string>
			<key>size</key>
			<integer>10838</integer>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share/licenses/fd/LICENSE-MIT</string>
			<key>sha256</key>
			<string>322cfc7aa0c774d0eca3b2610f1d414de3ddbd7d8dd4b9dea941a13a6eb07455</string>
			<key>size</key>
			<integer>1082</integer>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share/man/man1/fd.1</string>
			<key>sha256</key>
			<string>b3a19c1d909e831b9bf703cf1f874551d05dd2074e78b63663028e9d6f962fb5</string>
			<key>size</key>
			<integer>18364</integer>
		</dict>
		<dict>
			<key>file</key>
			<string>/usr/share/zsh/site-functions/_fd</string>
			<key>sha256</key>
			<string>7c21da13fd48a865ed0b60b3a18312dfead8d33d584be2b9d09764609f9f9dba</string>
			<key>size</key>
			<integer>11722</integer>
		</dict>
	</array>
</dict>
</plist>

$ cat props.plist 
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>architecture</key>
	<string>x86_64-musl</string>
	<key>changelog</key>
	<string>https://raw.githubusercontent.com/sharkdp/fd/master/CHANGELOG.md</string>
	<key>homepage</key>
	<string>https://github.com/sharkdp/fd</string>
	<key>installed_size</key>
	<integer>4108532</integer>
	<key>license</key>
	<string>Apache-2.0 OR MIT</string>
	<key>maintainer</key>
	<string>tranzystorekk &lt;tranzystorek.io@protonmail.com&gt;</string>
	<key>pkgname</key>
	<string>fd</string>
	<key>pkgver</key>
	<string>fd-10.3.0_1</string>
	<key>provides</key>
	<array>
		<string>cmd:fd-10.3.0_1</string>
	</array>
	<key>run_depends</key>
	<array>
		<string>libgcc&gt;=4.4.0_1</string>
		<string>musl&gt;=1.2.5_1</string>
	</array>
	<key>shlib-requires</key>
	<array>
		<string>libc.so</string>
		<string>libgcc_s.so.1</string>
	</array>
	<key>short_desc</key>
	<string>Simple, fast and user-friendly alternative to find</string>
	<key>source-revisions</key>
	<string>fd:eea9353cc1f</string>
	<key>sourcepkg</key>
	<string>fd</string>
	<key>version</key>
	<string>10.3.0_1</string>
</dict>
</plist>

static const char *
entry_type_str(enum entry_type type)
{
	switch (type) {
	case ENTRY_TYPE_LINKS:
		return "links";
	case ENTRY_TYPE_DIRS:
		return "dirs";
	case ENTRY_TYPE_FILES:
		return "files";
	case ENTRY_TYPE_CONF_FILES:
		return "conf_files";
	case ENTRY_TYPE_METADATA:
		return "metadata";
	}
	diex("unknown entry type");
}

/* Optional INSTALL/REMOVE messages */
	process_file("INSTALL.msg", "install-msg");
	process_file("REMOVE.msg", "remove-msg");

from https://docs.voidlinux.org/installation/guides/chroot.html

XBPS also needs to know what architecture is being installed. Available options are x86_64, x86_64-musl, i686 for PC architecture computers and aarch64

https://voidlinux.org/packages/

• noarch
• aarch64
• aarch64-musl
• armv6l
• armv6l-musl
• armv7l
• armv7l-musl
• i686
• x86_64
• x86_64-musl