Language Clients

There are some clients in different languages that provide a higher level API, built on top of gRPC and libuast.

These clients make it easier to both parse and analyze the resulting UAST, abstracting from network communication and providing a query language to filter UASTs.

Existing clients

There are clients for the following languages:

Language Status Libuast URL
Python Beta
Go Beta
Scala Beta


The client API's differ to adapt to their language specific idioms, the following codes shows several simple examples with the Go, Python and Scala clients that parsers a file and applies a filter to return all the simple identifiers:

Go example

package main

import (


func main() {
    client, err := bblfsh.NewClient("localhost:9432")
    if err != nil {

    res, err := client.NewParseRequest().ReadFile("").Do()
    if err != nil {

    // Always check the Response.Status before further processing!
    if res.Status != protocol.Ok {
        panic("Parsing failed")

    query := "//*[@roleIdentifier and not(@roleQualified)]"
    nodes, _ := tools.Filter(res.UAST, query)
    for _, n := range nodes {

Python example

import bblfsh

from bblfsh import filter as filter_uast

if __name__ == "__main__":
    client = bblfsh.BblfshClient("")
    response = client.parse("")

    if response.status != 0:
      raise Exception('Some error happened: ' + str(response.errors))

    query = "//*[@roleIdentifier and not(@roleQualified)]"
    nodes = filter_uast(response.uast, query)
    for n in nodes:

Scala example

import org.bblfsh.client.BblfshClient._



class BblfshClientParseTest {
  val fileName = "src/test/resources/"
  val fileContent = Source.fromFile(fileName) .getLines.mkString

  val resp = client.parse(fileName, fileContent)

  if (resp.uast.isDefined) {
     rootNode = resp.uast.get
     val filtered = client.filter(rootNode, "//*[@roleIdentifier and not(@roleQualified)]")
     filtered.foreach{ println }
  } else {
    // ... handle resp.uast.errors

Query language

When using one of the clients that support libuast you can query the UAST result nodes using an xpath-like query language. Check the UAST querying page in this documentation for the details.


The client also allow you to instance an Iterator object and iterate over the tree on several predefined orders:

To check the exact way to use an iterator you must consult the readme of the specific language client you're using, but they're generally easy to use as this Python example shows:

import bblfsh
client = bblfsh.BblfshClient("")
root = client.parse("/path/to/")

for node in bblfsh.iterator(root, bblfsh.TreeOrder.PRE_ORDER):
    #... do stuff with the node

results matching ""

    No results matching ""