This is a Kotlin implementation of the PartiQL specification. PartiQL is based on SQL92 and has added support for working with schemaless hierarchical data. PartiQL’s extensions to SQL are easy to understand, treat nested data as first class citizens and compose seamlessly with each other and SQL.
This repository contains an embeddable reference interpreter, test framework, and tests for PartiQL in Kotlin.
The easiest way to get started with PartiQL is to clone this repository locally, build, then run the REPL.
PartiQL should be considered to be in "preview" status. It has been in use within a number of Amazon internal systems and an AWS product for over one year. The behavior of the language itself is mostly stable however the public API of the interpreter is slated to undergo significant improvements in the near term. (See the GitHub issues list for details.)
After the public API has been improved it will be released to Maven Central and will be available for general production use.
To build this project, clone this repository and from its root directory execute:
$./gradlew build
This will build the reference interpreter and test framework, then run all unit and integration tests.
docs/userdocumentation for developers embedding the interpreter in an application.docs/devdocumentation for developers of the interpreter library.langcontains the source code of the library containing the interpreter.clicontains the source code of the command-line interface and interactive prompt. (CLI/REPL)testframeworkcontains the source code of the integration test framework.integration-test/test-scriptscontains the test scripts executed by the test framework as part of the Gradle build.integration-test/test-scripts-ignoredcontains test scripts which cannot be executed during the Gradle build.
See the examples project in this repository for examples covering use of the PartiQL interpreter in your project.
See CONTRIBUTING
This the works contained within this repository are licensed under the Apache 2.0 License.
See the LICENSE file.