Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
dmikusa authored May 17, 2024
1 parent 02dc3bf commit 5a07719
Showing 1 changed file with 28 additions and 6 deletions.
34 changes: 28 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,28 +2,50 @@

This repository pulls together and publishes a number of helpful tools for the management and release of buildpacks.

## `libpak-tools package create`
## `libpak-tools package compile`

The `package create` command creates a `libpak.Package` and calls `libpak.Package.Create()`. This takes a Paketo buildpack written in Go and packages is it into a buildpack. That involves compiling the source code, possibly copying in additional resource files, and generating the buildpack in the given output directory.
The `package compile` command creates a `libpak.Package` and calls `libpak.Package.Create()`. This takes a Paketo buildpack written in Go and packages is it into a buildpack. That involves compiling the source code, possibly copying in additional resource files, and generating the buildpack in the given output directory. The key is that the output of this command is a *directory*. If you want it to output an image, use `libpak-tools package bundle`.

```
> libpak-tools package create -h
Create a package from buildpack source code
> libpak-tools package compile -h
Compile buildpack source code
Usage:
libpak-tools package create [flags]
libpak-tools package compile [flags]
Flags:
--cache-location string path to cache downloaded dependencies (default: $PWD/dependencies)
--dependency-filter stringArray one or more filters that are applied to exclude dependencies
--destination string path to the build package destination directory
-h, --help help for create
-h, --help help for compile
--include-dependencies whether to include dependencies (default: false)
--source string path to build package source directory (default: $PWD) (default "/Users/dmikusa/Code/OSS/paketo-buildpacks/libpak-tools")
--strict-filters require filter to match all data or just some data (default: false)
--version string version to substitute into buildpack.toml/extension.toml
```

## `libpak-tools package bundle`

The `package bundle` does the same thing as `libpak-tools package compile` but then runs `pack buildpack package` as well, so the output is a buildpack image.

```
> libpak-tools package bundle -h
Compile and package a single buildpack
Usage:
libpak-tools package bundle [flags]
Flags:
--buildpack-id string id of the buildpack to use
--buildpack-path string path to buildpack directory
--cache-location string path to cache downloaded dependencies (default: $PWD/dependencies)
--dependency-filter stringArray one or more filters that are applied to exclude dependencies
-h, --help help for bundle
--include-dependencies whether to include dependencies (default: false)
--strict-filters require filter to match all data or just some data (default: false)
--version string version to substitute into buildpack.toml/extension.toml
```

## `libpak-tools dependency update build-image`

The `dependency update build-image` command is used to update dependencies in a build image dependency in a builder configuration file. It takes as an argument the builder configuration file and the new version.
Expand Down

0 comments on commit 5a07719

Please sign in to comment.