hlb

KO | EN

gitlite — search

#python #java #javascript #ruby #php #dotfiles #django #wordpress #c-plus-plus #html #lua #macos

★ 118 Open GitHub ↗

A developer-first language to build and test any software efficiently

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# hlb

[![GoDoc](https://img.shields.io/static/v1?label=godoc&message=reference&color=blue)](https://pkg.go.dev/github.com/openllb/hlb)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
[![Test](https://github.com/openllb/hlb/workflows/Test/badge.svg)](https://github.com/openllb/hlb/actions?query=workflow%3ATest)

`hlb` is a high-level build language for [BuildKit](https://github.com/moby/buildkit/).

Describe your build in containerized units of work, and BuildKit will build your target as efficiently as possible.

## Getting started with HLB

If you're on a MacOS or Linux (`linux-amd64`), head on over to [Releases](https://github.com/openllb/hlb/releases) to grab a static binary.

Otherwise, you can compile HLB yourself using [go](https://golang.org/dl/):
```sh
git clone https://github.com/openllb/hlb.git
cd hlb
go install ./cmd/hlb
```

Then you can run one of the examples in `./examples`:
```sh
hlb run ./examples/node.hlb
```

## Bring your own BuildKit

By default, HLB uses the BuildKit embedded in a docker engine. HLB supports `BUILDKIT_HOST` the same way `buildctl` does, so you can run BuildKit in a container and connect to it:

```sh
docker run -d --name buildkitd --privileged moby/buildkit:master
export BUILDKIT_HOST=docker-container://buildkitd
hlb run ./examples/node.hlb
```

## Language server

If your editor has a decent LSP plugin, HLB does support LSP over stdio via the `hlb langserver` subcommand.

hlb

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README