buildkit-rs

Crates.iobuildkit-rs
lib.rsbuildkit-rs
version0.1.0
sourcesrc
created_at2023-04-11 00:11:06.649785
updated_at2023-04-11 00:11:06.649785
descriptionRust client for BuildKit
homepagehttps://cicada.build
repository
max_upload_size
id835589
size38,890
Grant G (grant0417)

documentation

README

buildkit-rs

According to the buildkit repo buildkit is:

a toolkit for converting source code to build artifacts in an efficient, expressive and repeatable manner

This is a Rust client library for buildkit.

Crates

  • buildkit-rs - The meta crate for the buildkit-rs project, it contains all the other crates reexported with no other functionality
  • buildkit-rs-llb - The low level buildkit client library
  • buildkit-rs-proto - The buildkit protobuf definitions
  • buildkit-rs-util - Utilities for building applications that use buildkit

Planned crates

  • buildkit-rs-client - A high level client library for buildkit exposing a simmilar API to the Go client
  • buildkit-rs-dockerfile - A library for parsing and converting Dockerfiles to LLB (this is mostly for validation and testing, not for production use)

QA

What are the goals of this project?

Goals

In order of importance:

  • Provide a simple, safe, and fast buildkit client library for Rust
  • Make the API idiomatic Rust
  • Provide other utilities for building applications that use buildkit in Rust
  • Keeping the API simmilar to the buildkit Go client API
  • Keeping the code modular as to allow easy opt-in for features
  • No unsafe code

Non-goals (non-exhaustive)

  • Provide a buildkit daemon implementation
  • Provide a CLI for buildkit
  • Provide a production ready Dockerfile llb converter

In short, this project is not trying to replace buildkit, but rather provide a Rust client library for buildkit.

What about the rust-buildkit

It is a similar project, we did draw some inspiration from its API, but it is not maintained anymore and it is not compatible with the latest buildkit version. This project is backed by Cicada and which comes first when it comes to priorities.

Why not use the buildkit Go client directly?

The Go client is a great library, but it is not easy to use in Rust. A native Rust client library is much easier to use and it is much faster for our use case. We are all in on Rust but still want to leverage the buildkit ecosystem.

License

All contributions are licensed under either Apache-2.0 OR MIT. If you contribute any code you agree to license it under the same terms as the project.

Contributing

Any contributions are welcome! If you are interested in contributing, please open an issue or a PR as soon as possible so we can discuss it and ensure it fits the goals of the project + we can avoid duplicate work.

We also are welcome to discuss the project in the Cicada Discord in the #buildkit-rs channel.

Commit count: 0

cargo fmt