Technical details on the Narrascope query language
Authors/Creators
Description
This repository contains files detailing the use and detailed structure of Narrascope's query language (NQL).
NQL is a functional programming language. It is used to (1) describe the structure of the queryable data (the "schema"), (2) formulate specific queries, (3) create functional building blocks/utility functions that can be used to simplify queries.
As example, schema.txt contains one domain-specific data schema that was used to import video corpus data for querying film editing patterns. The file is written in NQL. A second file, query.txt, contains implementations of utility functions that are available in all user queries. The file is written in NQL.
The NQL interpreter relies on a grammar and a prelude of standard functions. These components are described in the following files:
* prelude.txt contains the low-level prelude for the NQL interpreter, which are mostly type and operator predence definitions for fundamental library functions such as map and sort. Most functions are stubs that refer to native JavaScript implementations. The file is written in NQL.
* grammar.ohmjs contains the parsing expression grammar (PEG) for NQL. The grammar file is written in the Ohm language (see https://ohmjs.org/docs/syntax-reference).