/cargo-arch

cargo subcommand to generate Arch Linux package

Primary LanguageRustApache License 2.0Apache-2.0

This is my personally modified version of https://github.com/wdv4758h/cargo-arch with some improvements in generating the output PKGBUILD

cargo-arch will generate ready to use PKGBUILD from information in Cargo.toml. You can add extra information in [package.metadata.arch] sections, options can be found by man PKGBUILD.

Documentation

From crate.io

$ cargo install cargo-arch

From GitHub

$ cargo install --git https://github.com/wdv4758h/cargo-arch

Download Prebuilt Binary

# by curl
$ curl -O -J -L https://github.com/wdv4758h/cargo-arch/releases/download/v0.1.4/cargo-arch-v0.1.4-x86_64-unknown-linux-gnu.tar.gz

# by wget
$ wget https://github.com/wdv4758h/cargo-arch/releases/download/v0.1.4/cargo-arch-v0.1.4-x86_64-unknown-linux-gnu.tar.gz
$ cargo arch --help
cargo-arch 0.1.4
Chiu-Hsiang Hsu <wdv4758h@gmail.com>
Rust Arch Linux package packer

USAGE:
    cargo arch [FLAGS] [OPTIONS]

FLAGS:
    -f, --force        Overwrite existing package
    -h, --help         Prints help information
    -i, --install      Install package after successful build
        --mksrcinfo    Run mksrcinfo
    -s, --syncdeps     Install missing dependencies with pacman
    -V, --version      Prints version information

OPTIONS:
    -b, --build <build>                    whether build the source [default: true]  [possible values:
                                           true, false]
    -p, --manifest-path <manifest-path>    Cargo.toml directory path
$ cargo arch
==> Making package: cargo-arch 0.1.4-1 (Sat 07 Dec 2019 09:53:39 PM CST)
==> Checking runtime dependencies...
==> Checking buildtime dependencies...
==> Retrieving sources...
==> Extracting sources...
==> Starting pkgver()...
==> Updated version: cargo-arch 0.1.4.r0.gc93e08e-1
==> Removing existing $pkgdir/ directory...
==> Starting build()...
   Compiling proc-macro2 v1.0.6
   Compiling unicode-xid v0.2.0
   Compiling syn v1.0.11
   Compiling libc v0.2.66
   Compiling bitflags v1.2.1
   Compiling serde v1.0.103
   Compiling anyhow v1.0.25
   Compiling unicode-width v0.1.7
   Compiling vec_map v0.8.1
   Compiling strsim v0.8.0
   Compiling ansi_term v0.11.0
   Compiling yaml-rust v0.3.5
   Compiling textwrap v0.11.0
   Compiling quote v1.0.2
   Compiling atty v0.2.13
   Compiling clap v2.33.0
   Compiling serde_derive v1.0.103
   Compiling toml v0.5.5
   Compiling cargo-arch v0.1.4 (/home/user/cargo-arch)
    Finished release [optimized] target(s) in 36.00s
==> Entering fakeroot environment...
==> Starting package()...
  Installing cargo-arch v0.1.4 (/home/user/cargo-arch)
    Updating crates.io index
    Finished release [optimized] target(s) in 4.36s
  Installing /home/user/cargo-arch/pkg/cargo-arch/usr/bin/cargo-arch
   Installed package `cargo-arch v0.1.4 (/home/user/cargo-arch)` (executable `cargo-arch`)
warning: be sure to add `/home/user/cargo-arch/pkg/cargo-arch/usr/bin` to your PATH to be able to run the installed binaries
==> Tidying install...
  -> Removing libtool files...
  -> Purging unwanted files...
  -> Removing static library files...
  -> Stripping unneeded symbols from binaries and libraries...
  -> Compressing man and info pages...
==> Checking for packaging issues...
==> Creating package "cargo-arch"...
  -> Generating .PKGINFO file...
  -> Generating .BUILDINFO file...
  -> Generating .MTREE file...
  -> Compressing package...
==> Leaving fakeroot environment.
==> Finished making: cargo-arch 0.1.4.r0.gc93e08e-1 (Sat 07 Dec 2019 09:54:21 PM CST)

You can put your PKGBUILD fields setting in Cargo.toml under [package.metadata.arch] section:

[package.metadata.arch]
arch = ["x86_64"]
makedepends = ["cargo", "my-build-dep1", "my-build-dep2"]
depends = ["my-run-dep1", "my-run-dep2"]
provides = ["cargo-arch", "my-command1", "my-command2"]
  • better error report with anyhow (thanks @cardoe)
  • default arch to x86_64 (thanks @cardoe)
  • fix bash array syntax (thanks @cardoe)
  • share artifact between build and package stage (thanks @cardoe)
  • Add --manifest-path support (thanks @ZettaScript)
  • Update dependencies version
  • Use "/usr" instead of "/" as install base
  • Change to use serde instead of rustc-serialize
  • Update PKGBUILD template to remove .crates.toml
  • Update toml to use serde API
  • Update clap version
  • support building Arch Linux packages

I've only tested on my x86_64 Linux. Other platforms are built by CI. If they don't work properly, please tell me.

  1. update version in src/arguments.yml
  2. update version in Cargo.toml
  3. update version in Cargo.lock
  4. add git tag
  • anyhow for better error message
  • cargo-deb for generates Debian packages (as a reference)
  • trust for CI integration
  • rust-everywhere for CI integration (old)
  • clap-rs for arguments parsing
  • serde for nice deserialization API
  • toml-rs for parsing TOML config and integrate with Serde
  • Rust Team
  • and every project I've used

cargo-arch is licensed under the Apache-2.0 License - see the LICENSE file for details