25 releases (breaking)

0.22.0 Jun 18, 2024
0.20.0 Apr 12, 2024
0.19.0 Feb 23, 2024
0.17.0 Dec 6, 2023
0.1.0 Dec 8, 2021

#83 in Cargo plugins

Download history 1/week @ 2024-03-19 4/week @ 2024-03-26 16/week @ 2024-04-02 133/week @ 2024-04-09 11/week @ 2024-04-16 152/week @ 2024-04-30 15/week @ 2024-05-07 12/week @ 2024-05-14 7/week @ 2024-05-21 1/week @ 2024-05-28 7/week @ 2024-06-04 18/week @ 2024-06-11 150/week @ 2024-06-18 3/week @ 2024-06-25

173 downloads per month

BSD-3-Clause

155KB
3.5K SLoC

libcnb-cargo   Latest Version MSRV

A Cargo command for managing buildpacks written with libcnb.rs.

Installation

cargo install --locked libcnb-cargo

Usage

Currently, there is only one sub-command: package. It allows users to package their Rust buildpack in a spec-compliant manner and helps with cross-compilation.

$ cargo libcnb package --help
Packages a libcnb.rs Cargo project as a Cloud Native Buildpack

Usage: cargo libcnb package [OPTIONS]

Options:
      --no-cross-compile-assistance  Disable cross-compile assistance
      --release                      Build in release mode, with optimizations
      --target <TARGET>              Build for the target triple [default: x86_64-unknown-linux-musl]
      --package-dir <PACKAGE_DIR>    Directory for packaged buildpacks, defaults to 'packaged' in Cargo workspace root
  -h, --help                         Print help

Using it is fairly simple, run cargo libcnb package inside the buildpack's project directory:

$ cargo libcnb package
🚚 Preparing package directory...
🖥️ Gathering Cargo configuration (for x86_64-unknown-linux-musl)
🏗️ Building buildpack dependency graph...
🔀 Determining build order...
🚚 Building 1 buildpacks...
📦 [1/1] Building libcnb-examples/my-buildpack (./)
# Omitting compilation output...
    Finished dev [unoptimized] target(s) in 8.24s
Successfully wrote buildpack directory: packaged/x86_64-unknown-linux-musl/debug/libcnb-examples_my-buildpack (4.09 MiB)
✨ Packaging successfully finished!

💡 To test your buildpack locally with pack, run:
pack build my-image-name \
  --buildpack packaged/x86_64-unknown-linux-musl/debug/libcnb-examples_my-buildpack \
  --path /path/to/application

/Users/example/src/my-buildpack/packaged/x86_64-unknown-linux-musl/debug/libcnb-examples_my-buildpack

Dependencies

~10–21MB
~302K SLoC