spectacles-ci / spectacles

A continuous integration tool for Looker and LookML.
https://spectacles.dev
MIT License
216 stars 34 forks source link
analytics continuous-integration looker testing

CircleCI downloads

What is Spectacles?

Spectacles is a continuous integration tool for Looker and LookML. Spectacles runs validators which perform a range of tests on your Looker instance and your LookML. Each validator interacts with the Looker API to run tests that ensure your Looker instance is running smoothly.

From the command line, you can run the following validators as subcommands (e.g. spectacles sql):

βœ… SQL validation - tests the sql field of each dimension for database errors

βœ… Assert validation - runs Looker data tests

βœ… Content validation - tests for errors in Looks and Dashboards

βœ… LookML validation - runs LookML validator

Installation

Spectacles CLI is distributed on PyPi and is easy to install with pip:

pip install spectacles

πŸ“£ You can also use Spectacles as a full-service web application! Check out our website to learn more.

Documentation

You can find detailed documentation for the CLI and web app on our docs page: docs.spectacles.dev.

Why we built this

Occasionally, when we make changes to LookML or our data warehouse, we break downstream experiences in Looker:

We believe in the power of testing and continuous integration for analytics. We believe that automated tests should catch these errors before they're ever pushed to production.

We wanted a single tool to perform these checks for us, so we built Spectacles to enhance the business intelligence layer of analytics CI pipelines.

Community

Have a question or just want to chat Spectacles or Looker? Join us in Slack.