dwgebler/geblang repository overview

⁠Geblang

Geblang is a statically typed scripting language implemented in Go. It combines PHP/Python-style scripting ergonomics with static typing, generics, decorators, async/generator support, runtime reflection, a bytecode VM, and a batteries-included standard library.

This official image ships the geblang CLI and the Geblang standard library, ready to run without installing Go or building from source.

⁠Quick Start

Check the installed version:

docker run --rm dwgebler/geblang --version

Run a script from the current directory:

docker run --rm -v "$PWD":/app dwgebler/geblang hello.gb

Start the REPL:

docker run --rm -it dwgebler/geblang repl

Run tests:

docker run --rm -v "$PWD":/app dwgebler/geblang test tests/

Build a bundled application binary:

docker run --rm -v "$PWD":/app dwgebler/geblang build --entry app.main --out dist/app .

⁠Tags

Use latest for the most recent published Geblang release:

docker pull dwgebler/geblang:latest

Version tags are also published:

docker pull dwgebler/geblang:<version>

Example:

docker run --rm -v "$PWD":/app dwgebler/geblang:1.24.0 hello.gb

⁠Image Behavior

The image entrypoint is geblang, so arguments after the image name are passed directly to the CLI:

docker run --rm -v "$PWD":/app dwgebler/geblang check src/
docker run --rm -v "$PWD":/app dwgebler/geblang fmt src/
docker run --rm -v "$PWD":/app dwgebler/geblang doctor

The working directory is /app. Mount your project there when running scripts, tests, or builds.

The standard library is installed inside the image at:

/usr/local/share/geblang/stdlib

No environment variable is required for normal use.

⁠Using as a Base Image

FROM dwgebler/geblang:latest

WORKDIR /app
COPY . /app

CMD ["main.gb"]

⁠Notes

This image is based on Debian with glibc support so Geblang FFI features using dlopen can work with shared libraries installed or mounted into the container.

Project source and documentation: https://github.com/dwgebler/geblang⁠