Our main building block is the language driver, each language driver provides parsing services for one language. It can be written in any language and is packaged as a standard Docker container. These containers are executed by the bblfshd server in a very specific runtime.
Our implementations of language drivers are composed of two pieces: a code parser, that can be written in any language (usually the source language) and an AST to UAST normalizer written in Go. In the case of code parsers written in Go or other languages producing linkable object files or shared library, the code parser and UAST normalizer might be combined by dynamic or static linking without a separate runnable component.
The entry point of the container is the Go UAST normalizer, which communicates internally with the language-specific code parser.
bblfshd is the higher level component of the architecture managing client requests (done via gRPC using a simple protocol) with the containerized language drivers which it orchestrates to keep warm instances, pools and handling any other orchestration needs.
The server itself is also designed to run inside a container allowing an easy deployment and operation.
The server executes driver in a very constrained and lightweight driver runtime based on libcontainer.
The runtime executes the driver contained in a standard Docker container in an isolate namespace and cgroup avoiding Docker's complex filesystems or networking features.
Drivers must assume:
No network interface.
Only one core available.
Currently we're allowing drivers to write on their container disk, although this might be disallowed in the future.