Skip to content
@sqlfluff

SQLFluff

SQL Linting and Auto-formatting for Humans

SQLFluff

The SQL Linter for Humans

ReadTheDocs

SQLFluff is a dialect-flexible and configurable SQL linter. Designed with ELT applications in mind, SQLFluff also works with Jinja templating and dbt. SQLFluff will auto-fix most linting errors, allowing you to focus your time on what matters.

PyPi Version PyPi License PyPi Python Versions PyPi Status PyPi Downloads

The core python library sqlfluff is the cornerstone of the SQLFluff family. This is the project which is published on pypi as sqlfluff.

If you're looking for somewhere to get started with SQLFluff, particularly in a CLI or CI/CD context, this is almost certainly the place to start.

PyPi Version PyPi License PyPi Python Versions PyPi Status PyPi Downloads

If you're using SQLFluff within the context of a dbt project you might also be looking for to install along side the core SQLFluff library above. This is the project which is published on pypi as sqlfluff.

This is a plugin for SQLFluff and allows the dbt templater to be selected. Currently, this plugin is maintained within the same git repository as the main SQLFluff project because of fairly tight coupling between the two.

If you're developing SQL code within VSCode as your IDE, you may find our maintained VSCode extension helpful. This project is published on OpenVSX as vscode-sqlfluff or on the Visual Studio Marketplace as dorzey.vscode-sqlfluff.

Many users deploying SQFluff within a CI/CD context do so on the Github Actions platform. For those users we provide a few templates of how some organisations have done the same. These are provided as templates and examples. We recommend that you personalise them to your own use case as applicable.

Documentation

For full documentation visit docs.sqlfluff.com. This documentation is generated from the core SQLFluff repository, so to any issues or contributions should be focussed there.

SQLFluff on Slack

We have a fast-growing community on Slack, come and join us!

SQLFluff on Twitter

Follow us on Twitter @SQLFluff for announcements and other related posts.

Contributing

We are grateful to all our contributors. There is a lot to do in this project, and we are just getting started.

If you want to understand more about the architecture of SQLFluff, you can find more here.

If you would like to contribute, check out the open issues on GitHub. You can also see the guide to contributing.

Pinned Loading

  1. sqlfluff Public

    A modular SQL linter and auto-formatter with support for multiple dialects and templated code.

    Python 8.4k 750

  2. vscode-sqlfluff Public

    An extension to use the sqlfluff linter in vscode.

    TypeScript 159 33

  3. sqlfluff-github-actions Public

    The official resource for SQLFluff related GitHub Actions

    105 36

Repositories

Showing 6 of 6 repositories
  • sqlfluff Public

    A modular SQL linter and auto-formatter with support for multiple dialects and templated code.

    Python 8,380 MIT 750 545 (6 issues need help) 7 Updated Dec 20, 2024
  • sqlfluff-online Public

    An online SQL formatter, via SQLFluff.

    Python 34 14 3 1 Updated Dec 16, 2024
  • sqlfluff.com Public

    Website for sqlfluff.com

    HTML 0 GPL-3.0 1 0 0 Updated Oct 28, 2024
  • vscode-sqlfluff Public

    An extension to use the sqlfluff linter in vscode.

    TypeScript 159 MIT 33 38 1 Updated Sep 27, 2024
  • sqlfluff-github-actions Public

    The official resource for SQLFluff related GitHub Actions

    105 MIT 36 3 2 Updated Aug 13, 2024
  • .github Public

    SQLFluff Organization README

    0 0 0 0 Updated Jul 18, 2023