Metadata-Version: 2.1
Name: dbt-prql
Version: 0.1.0
Summary: Write PRQL in dbt models
Home-page: https://github.com/prql/dbt-prql
License: Apache-2.0
Author: Maximilian Roos
Author-email: m@maxroos.com
Requires-Python: >=3.7,<4.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: dbt-core (==1.1.0)
Requires-Dist: pyprql (>=0.5.0)
Project-URL: Repository, https://github.com/prql/dbt-prql
Description-Content-Type: text/markdown

# dbt-prql

dbt-prql allows writing PRQL in dbt models.

Trivial Example:

```elm
{% prql %}
from employees
filter (age | in 20..30)
{% endprql %}
```

...compiles to:

```sql
SELECT
  employees.*
FROM
  employees
WHERE
  age BETWEEN 20
  AND 30
```

More complex example:

```elm
{% prql %}
from {{ source('salesforce', 'in_process') }}
derive expected_sales = probability * value
join {{ ref('team', 'team_sales') }} [name]
group name (
    aggregate (expected_sales)
)
{% endprql %}
```

...compiles to:

```sql
SELECT
  name,
  {{ source('salesforce', 'in_process') }}.probability * {{ source('salesforce', 'in_process') }}.value AS expected_sales
FROM
  {{ source('salesforce', 'in_process') }}
  JOIN {{ ref('team', 'team_sales') }} USING(name)
GROUP BY
  name
```

## Functionality

- Any text between `{% prql %}` and `{% endprql %}` tags will be compiled from
  PRQL to SQL.
- Any text within the PRQL query that's surrounded by `{{...}}` will be passed
  through to dbt parser without modification.

## Installation

```sh
pip install dbt-prql
```

## Current state

Currently this in an early state. But it's enthusiastically supported — if there
are any problems, please open an issue.

Note that we need to release a new `pyprql` version for this to pass jinja
expressions through, which we'll do in the next couple of days.

## Is this magic?

It's much worse.

Unfortunately, it's not possible to add behavior to dbt beyond the database
adapters (e.g. `dbt-bigquery`) or jinja-only plugins (e.g. `dbt-utils`). So this
library hacks the python import system to monkeypatch dbt's jinja environment
with an additional jinja extension, which avoids the need for any changes to
dbt.

Thanks to
[mtkennerly/poetry-dynamic-versioning](https://github.com/mtkennerly/poetry-dynamic-versioning)
for the technique.

This isn't stable between dbt versions, since it relies on internal dbt APIs.
The technique is also normatively bad — it runs a few lines of code every time
the python interpreter starts — whose errors could lead to very confusing bugs
beyond the domain of the problem (though in the case of this code, it's small
and well-constructed™).

If there's ever any concern that the library might be causing a problem, just
set an environment variable `DBT_PRQL_DISABLE=1`, and this library won't
monkeypatch anything. It's also fully uninstallable with `pip uninstall
dbt-prql`.

