├── web ├── website │ ├── static │ │ ├── CNAME │ │ └── img │ │ │ ├── favicon.ico │ │ │ ├── favicon-16x16.png │ │ │ ├── favicon-32x32.png │ │ │ └── apple-touch-icon.png │ ├── .gitignore │ ├── themes │ │ └── prql-theme │ │ │ ├── layouts │ │ │ ├── shortcodes │ │ │ │ ├── cite.html │ │ │ │ ├── faq.html │ │ │ │ ├── columns.html │ │ │ │ └── link.html │ │ │ ├── 404.html │ │ │ └── _default │ │ │ │ ├── big_iframe.html │ │ │ │ ├── single.html │ │ │ │ ├── _markup │ │ │ │ └── render-link.html │ │ │ │ └── list.html │ │ │ ├── static │ │ │ ├── favicon.ico │ │ │ ├── favicon-16x16.png │ │ │ ├── favicon-32x32.png │ │ │ ├── fonts │ │ │ │ ├── boxicons.eot │ │ │ │ ├── boxicons.ttf │ │ │ │ ├── boxicons.woff │ │ │ │ ├── boxicons.woff2 │ │ │ │ ├── inter-extra-nold.woff │ │ │ │ └── inter-extra-bold.woff2 │ │ │ └── apple-touch-icon.png │ │ │ ├── archetypes │ │ │ └── default.md │ │ │ └── theme.toml │ ├── archetypes │ │ └── default.md │ ├── content │ │ ├── playground.html │ │ └── posts │ │ │ ├── 2023-02-02-one-year │ │ │ ├── 7cpDySb.png │ │ │ ├── FQ9QSOo.png │ │ │ ├── GXLvoXn.png │ │ │ ├── URpCf29.png │ │ │ └── ncVXken.png │ │ │ └── 2023-01-28-format-pretty-reports │ │ │ └── query_result.png │ ├── data │ │ └── examples │ │ │ ├── f-strings.yaml │ │ │ ├── functions.yaml │ │ │ ├── s-strings.yaml │ │ │ ├── basic.yaml │ │ │ ├── dialects.yaml │ │ │ ├── null-handling.yaml │ │ │ ├── windows.yaml │ │ │ ├── joins.yaml │ │ │ ├── orthogonal.yaml │ │ │ ├── top-n.yaml │ │ │ ├── expressions.yaml │ │ │ ├── hero.yaml │ │ │ └── friendly-syntax.yaml │ └── README.md ├── book │ ├── src │ │ ├── reference │ │ │ ├── data │ │ │ │ ├── README.md │ │ │ │ └── from.md │ │ │ ├── declarations │ │ │ │ └── README.md │ │ │ ├── spec │ │ │ │ └── README.md │ │ │ ├── syntax │ │ │ │ ├── arrays.md │ │ │ │ ├── comments.md │ │ │ │ ├── r-strings.md │ │ │ │ ├── parameters.md │ │ │ │ └── case.md │ │ │ └── stdlib │ │ │ │ └── transforms │ │ │ │ ├── take.md │ │ │ │ ├── derive.md │ │ │ │ └── filter.md │ │ └── project │ │ │ ├── changelog.md │ │ │ ├── bindings │ │ │ ├── php.md │ │ │ ├── dotnet.md │ │ │ ├── elixir.md │ │ │ ├── java.md │ │ │ ├── javascript.md │ │ │ ├── python.md │ │ │ ├── rust.md │ │ │ └── r.md │ │ │ ├── integrations │ │ │ ├── prqlc-cli.md │ │ │ ├── rill.md │ │ │ ├── databend.md │ │ │ ├── clickhouse.md │ │ │ ├── prefect.md │ │ │ ├── README.md │ │ │ ├── duckdb.md │ │ │ └── vscode.md │ │ │ └── contributing │ │ │ └── fortnightly-dev-call.ics │ ├── tests │ │ └── documentation │ │ │ ├── README.md │ │ │ ├── snapshots │ │ │ ├── documentation__book__reference__data__from__0.snap │ │ │ ├── documentation__book__reference__data__from__2.snap │ │ │ ├── documentation__book__project__target__version__0.snap │ │ │ ├── documentation__book__reference__syntax__tuples__0.snap │ │ │ ├── documentation__book__reference__syntax__tuples__1.snap │ │ │ ├── documentation__book__reference__data__from__1.snap │ │ │ ├── documentation__book__reference__data__read-files__reading-files__1.snap │ │ │ ├── documentation__book__reference__syntax__s-strings__1.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__select__examples__2.snap │ │ │ ├── documentation__book__reference__spec__name-resolution__translating-to-sql__0.snap │ │ │ ├── documentation__book__reference__syntax__parameters__0.snap │ │ │ ├── documentation__book__reference__data__from__3.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__take__examples__0.snap │ │ │ ├── documentation__book__reference__syntax__keywords__schemas--database-names__0.snap │ │ │ ├── documentation__book__reference__syntax__s-strings__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__sort__examples__0.snap │ │ │ ├── documentation__book__reference__syntax__comments__0.snap │ │ │ ├── documentation__book__reference__syntax__keywords__identifiers--keywords__0.snap │ │ │ ├── documentation__book__reference__syntax__keywords__quoting__0.snap │ │ │ ├── documentation__book__reference__syntax__operators__coalesce__0.snap │ │ │ ├── documentation__book__reference__stdlib__distinct__how-do-i-remove-duplicates__1.snap │ │ │ ├── documentation__book__reference__syntax__keywords__quoting__1.snap │ │ │ ├── documentation__book__reference__stdlib__math__example__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__filter__examples__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__sort__examples__1.snap │ │ │ ├── documentation__book__reference__syntax__keywords__identifiers--keywords__3.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__select__excluding-columns__2.snap │ │ │ ├── documentation__book__reference__syntax__operators__regex-expressions__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__group__1.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__select__excluding-columns__3.snap │ │ │ ├── documentation__book__project__target__version__1.snap │ │ │ ├── documentation__book__reference__stdlib__distinct__how-do-i-remove-duplicates__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__filter__examples__3.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__select__examples__3.snap │ │ │ ├── documentation__book__reference__syntax__f-strings__0.snap │ │ │ ├── documentation__book__project__target__examples__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__select__examples__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__select__excluding-columns__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__append__0.snap │ │ │ ├── documentation__book__reference__syntax__literals__dates__0.snap │ │ │ ├── documentation__book__reference__syntax__literals__durations__0.snap │ │ │ ├── documentation__book__reference__syntax__operators__parentheses__2.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__aggregate__aggregate-is-required__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__derive__examples__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__filter__examples__2.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__sort__examples__2.snap │ │ │ ├── documentation__book__reference__stdlib__date__date-functions__0.snap │ │ │ ├── documentation__book__reference__stdlib__date__date-functions__2.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__aggregate__examples__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__select__excluding-columns__1.snap │ │ │ ├── documentation__book__reference__syntax__keywords__0.snap │ │ │ ├── documentation__book__project__target__examples__1.snap │ │ │ ├── documentation__book__reference__stdlib__date__date-functions__1.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__filter__examples__1.snap │ │ │ ├── documentation__book__reference__syntax__ranges__1.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__append__remove__0.snap │ │ │ ├── documentation__book__reference__syntax__literals__times__0.snap │ │ │ ├── documentation__book__reference__syntax__operators__regex-expressions__4.snap │ │ │ ├── documentation__book__reference__syntax__operators__regex-expressions__1.snap │ │ │ ├── documentation__book__reference__spec__null__null-handling__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__append__intersection__0.snap │ │ │ ├── documentation__book__reference__syntax__operators__regex-expressions__2.snap │ │ │ ├── documentation__book__reference__syntax__pipes__0.snap │ │ │ ├── documentation__book__reference__syntax__pipes__1.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__take__examples__1.snap │ │ │ ├── documentation__book__reference__declarations__functions__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__join__examples__4.snap │ │ │ ├── documentation__book__reference__syntax__keywords__identifiers--keywords__1.snap │ │ │ ├── documentation__book__reference__syntax__operators__regex-expressions__3.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__join__examples__3.snap │ │ │ ├── documentation__book__reference__syntax__keywords__identifiers--keywords__2.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__window__windowing-by-default__0.snap │ │ │ ├── documentation__book__reference__syntax__s-strings__braces__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__join__examples__1.snap │ │ │ ├── documentation__book__reference__syntax__pipes__ceci-nest-pas-une-pipe__1.snap │ │ │ ├── documentation__book__reference__declarations__variables__variables--__1.snap │ │ │ ├── documentation__book__reference__declarations__functions__piping-values-into-functions__1.snap │ │ │ ├── documentation__book__reference__syntax__operators__regex-expressions__5.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__join__examples__0.snap │ │ │ ├── documentation__book__reference__syntax__operators__wrapping-lines__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__select__examples__1.snap │ │ │ ├── documentation__book__reference__syntax__f-strings__1.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__window__windowing-by-default__1.snap │ │ │ ├── documentation__book__reference__stdlib__text__example__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__group__0.snap │ │ │ ├── documentation__book__reference__syntax__r-strings__0.snap │ │ │ ├── documentation__book__reference__syntax__s-strings__precedence-within-s-strings__0.snap │ │ │ ├── documentation__book__reference__syntax__pipes__inner-transforms__0.snap │ │ │ ├── documentation__book__reference__syntax__s-strings__precedence-within-s-strings__1.snap │ │ │ ├── documentation__book__reference__spec__name-resolution__translating-to-sql__1.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__sort__examples__3.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__sort__ordering-guarantees__0.snap │ │ │ ├── documentation__book__reference__syntax__case__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__aggregate__examples__1.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__derive__examples__1.snap │ │ │ ├── documentation__book__reference__syntax__operators__parentheses__1.snap │ │ │ ├── documentation__book__reference__syntax__strings__0.snap │ │ │ ├── documentation__book__reference__stdlib__README__standard-library__2.snap │ │ │ ├── documentation__book__reference__syntax__pipes__ceci-nest-pas-une-pipe__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__window__window-functions-as-first-class-citizens__0.snap │ │ │ ├── documentation__book__reference__syntax__case__1.snap │ │ │ ├── documentation__book__reference__syntax__literals__timestamps__0.snap │ │ │ ├── documentation__book__reference__syntax__strings__quoting-and-escape-characters__0.snap │ │ │ ├── documentation__book__reference__data__relation-literals__array-literals__0.snap │ │ │ ├── documentation__book__reference__stdlib__distinct__remove-duplicates-from-each-group__1.snap │ │ │ ├── documentation__book__reference__data__relation-literals__array-literals__3.snap │ │ │ ├── documentation__book__reference__syntax__literals__numbers__0.snap │ │ │ ├── documentation__book__reference__syntax__ranges__0.snap │ │ │ ├── documentation__book__reference__stdlib__README__standard-library__1.snap │ │ │ ├── documentation__book__reference__syntax__f-strings__2.snap │ │ │ ├── documentation__book__reference__declarations__functions__1.snap │ │ │ ├── documentation__book__reference__declarations__functions__piping-values-into-functions__2.snap │ │ │ ├── documentation__book__reference__declarations__variables__variables--__2.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__join__examples__2.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__window__example__0.snap │ │ │ ├── documentation__book__reference__syntax__s-strings__2.snap │ │ │ ├── documentation__book__reference__syntax__keywords__quoting__2.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__group__2.snap │ │ │ ├── documentation__book__reference__declarations__functions__piping-values-into-functions__0.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__loop__examples__0.snap │ │ │ ├── documentation__book__reference__stdlib__distinct__remove-duplicates-from-each-group__0.snap │ │ │ ├── documentation__book__reference__data__relation-literals__array-literals__2.snap │ │ │ ├── documentation__book__reference__stdlib__README__standard-library__0.snap │ │ │ ├── documentation__book__reference__data__relation-literals__array-literals__4.snap │ │ │ ├── documentation__book__reference__syntax__operators__division-and-integer-division__0.snap │ │ │ ├── documentation__book__README__prql-language-book__0.snap │ │ │ ├── documentation__book__reference__syntax__operators__0.snap │ │ │ ├── documentation__book__reference__declarations__variables__variables--__0.snap │ │ │ ├── documentation__book__reference__syntax__operators__wrapping-lines__1.snap │ │ │ ├── documentation__book__reference__syntax__s-strings__3.snap │ │ │ ├── documentation__book__reference__declarations__functions__late-binding__0.snap │ │ │ ├── documentation__book__reference__syntax__strings__quoting-and-escape-characters__1.snap │ │ │ ├── documentation__book__reference__stdlib__transforms__window__example__1.snap │ │ │ └── documentation__book__reference__data__read-files__reading-files__0.snap │ │ │ ├── main.rs │ │ │ └── readme.rs │ ├── theme │ │ └── head.hbs │ ├── comparison-table.css │ ├── book.toml │ └── README.md ├── .gitignore ├── prql-codemirror-demo │ ├── src │ │ ├── vite-env.d.ts │ │ └── style.css │ ├── index.html │ ├── .gitignore │ ├── README.md │ ├── tsconfig.json │ └── package.json └── playground │ ├── public │ ├── robots.txt │ ├── favicon.ico │ └── manifest.json │ ├── src │ ├── app │ │ └── App.css │ ├── setupTests.js │ ├── reportWebVitals.js │ ├── output │ │ └── Output.css │ └── main.jsx │ ├── vite.config.js │ ├── README.md │ ├── .gitignore │ └── .eslintrc.cjs ├── prqlc ├── bindings │ ├── dotnet │ │ ├── .gitignore │ │ ├── PrqlCompiler.Tests │ │ │ └── Usings.cs │ │ └── PrqlCompiler │ │ │ ├── NativeResult.cs │ │ │ ├── NativePrqlCompilerOptions.cs │ │ │ ├── MessageKind.cs │ │ │ └── Span.cs │ ├── java │ │ ├── java │ │ │ ├── src │ │ │ │ ├── main │ │ │ │ │ └── resources │ │ │ │ │ │ └── .gitkeep │ │ │ │ └── test │ │ │ │ │ └── resources │ │ │ │ │ └── .gitkeep │ │ │ └── .mvn │ │ │ │ └── wrapper │ │ │ │ └── maven-wrapper.jar │ │ ├── .gitignore │ │ ├── Cargo.toml │ │ └── README.md │ ├── php │ │ ├── .gitignore │ │ ├── .editorconfig │ │ └── src │ │ │ ├── Result.php │ │ │ ├── Span.php │ │ │ ├── MessageKind.php │ │ │ └── SourceLocation.php │ ├── prqlc-python │ │ ├── python │ │ │ └── prqlc │ │ │ │ ├── py.typed │ │ │ │ ├── debug.pyi │ │ │ │ ├── __init__.py │ │ │ │ └── __init__.pyi │ │ ├── build.rs │ │ └── Taskfile.yaml │ ├── elixir │ │ ├── test │ │ │ └── test_helper.exs │ │ ├── .formatter.exs │ │ ├── native │ │ │ └── prql │ │ │ │ ├── README.md │ │ │ │ ├── .cargo │ │ │ │ └── config.toml │ │ │ │ └── Cargo.toml │ │ ├── lib │ │ │ └── prql │ │ │ │ └── errors.ex │ │ └── .gitignore │ └── prqlc-c │ │ ├── examples │ │ ├── minimal-zig │ │ │ ├── .gitignore │ │ │ └── README.md │ │ ├── minimal-c │ │ │ ├── README.md │ │ │ └── Makefile │ │ └── minimal-cpp │ │ │ ├── README.md │ │ │ ├── main.cpp │ │ │ └── Makefile │ │ └── cbindgen.toml ├── prqlc │ ├── tests │ │ └── integration │ │ │ ├── project │ │ │ ├── artists.prql │ │ │ └── Project.prql │ │ │ ├── queries │ │ │ ├── take.prql │ │ │ ├── constants_only.prql │ │ │ ├── distinct.prql │ │ │ ├── sort_2.prql │ │ │ ├── read_csv.prql │ │ │ ├── cast.prql │ │ │ ├── append_select_nulls.prql │ │ │ ├── distinct_on.prql │ │ │ ├── group_all.prql │ │ │ ├── group_sort.prql │ │ │ ├── append_select_simple.prql │ │ │ ├── aggregation.prql │ │ │ ├── append_select.prql │ │ │ ├── set_ops_remove.prql │ │ │ ├── genre_counts.prql │ │ │ ├── loop_01.prql │ │ │ ├── switch.prql │ │ │ ├── sort.prql │ │ │ ├── group_sort_limit_take.prql │ │ │ ├── pipelines.prql │ │ │ ├── sort_3.prql │ │ │ ├── append_select_multiple_with_null.prql │ │ │ ├── group_sort_derive_select_join.prql │ │ │ ├── append_select_compute.prql │ │ │ ├── group_sort_filter_derive_select_join.prql │ │ │ └── text_module.prql │ │ │ ├── main.rs │ │ │ ├── data │ │ │ └── chinook │ │ │ │ ├── media_types.csv │ │ │ │ ├── playlists.csv │ │ │ │ └── genres.csv │ │ │ ├── snapshots │ │ │ ├── integration__queries__fmt__take.snap │ │ │ ├── integration__queries__compileall__distinct.snap │ │ │ ├── integration__queries__compile__take.snap │ │ │ ├── integration__queries__results__constants_only.snap │ │ │ ├── integration__queries__fmt__constants_only.snap │ │ │ ├── integration__queries__fmt__read_csv.snap │ │ │ ├── integration__queries__fmt__distinct.snap │ │ │ ├── integration__queries__fmt__cast.snap │ │ │ ├── integration__queries__fmt__sort_2.snap │ │ │ ├── integration__queries__results__append_select_nulls.snap │ │ │ ├── integration__queries__compileall__genre_counts.snap │ │ │ ├── integration__queries__results__genre_counts.snap │ │ │ ├── integration__queries__results__read_csv.snap │ │ │ ├── integration__queries__compileall__loop_01.snap │ │ │ ├── integration__queries__results__aggregation.snap │ │ │ ├── integration__queries__compileall__sort.snap │ │ │ ├── integration__queries__results__group_sort.snap │ │ │ ├── integration__queries__results__set_ops_remove.snap │ │ │ ├── integration__queries__compileall__take.snap │ │ │ ├── integration__queries__compileall__group_sort_limit_take.snap │ │ │ ├── integration__queries__fmt__group_sort.snap │ │ │ ├── integration__queries__results__loop_01.snap │ │ │ ├── integration__queries__compile__read_csv.snap │ │ │ ├── integration__queries__compile__distinct.snap │ │ │ ├── integration__queries__results__take.snap │ │ │ ├── integration__queries__fmt__distinct_on.snap │ │ │ ├── integration__queries__fmt__group_all.snap │ │ │ ├── integration__queries__results__sort_3.snap │ │ │ ├── integration__queries__fmt__loop_01.snap │ │ │ ├── integration__queries__fmt__append_select_nulls.snap │ │ │ ├── integration__queries__fmt__genre_counts.snap │ │ │ ├── integration__queries__compile__constants_only.snap │ │ │ ├── integration__queries__compile__cast.snap │ │ │ ├── integration__queries__compileall__group_sort_derive_select_join.snap │ │ │ ├── integration__queries__results__append_select.snap │ │ │ ├── integration__queries__compile__genre_counts.snap │ │ │ ├── integration__queries__fmt__aggregation.snap │ │ │ ├── integration__queries__results__switch.snap │ │ │ ├── integration__queries__fmt__switch.snap │ │ │ ├── integration__queries__fmt__append_select_simple.snap │ │ │ ├── integration__queries__fmt__pipelines.snap │ │ │ ├── integration__queries__compileall__group_sort_filter_derive_select_join.snap │ │ │ ├── integration__queries__compile__aggregation.snap │ │ │ ├── integration__queries__fmt__append_select.snap │ │ │ ├── integration__queries__results__group_all.snap │ │ │ ├── integration__queries__results__sort.snap │ │ │ ├── integration__queries__fmt__group_sort_limit_take.snap │ │ │ ├── integration__queries__fmt__sort.snap │ │ │ ├── integration__queries__results__append_select_compute.snap │ │ │ ├── integration__queries__results__append_select_multiple_with_null.snap │ │ │ ├── integration__queries__compileall__append_select_simple.snap │ │ │ ├── integration__queries__results__group_sort_filter_derive_select_join.snap │ │ │ ├── integration__queries__compile__sort_2.snap │ │ │ ├── integration__queries__compileall__cast.snap │ │ │ ├── integration__queries__fmt__set_ops_remove.snap │ │ │ ├── integration__queries__compile__group_all.snap │ │ │ └── integration__queries__compileall__group_sort.snap │ │ │ └── dbs │ │ │ └── dockerfiles │ │ │ └── glaredb.Dockerfile │ ├── examples │ │ └── compile-files │ │ │ ├── queries │ │ │ ├── query1.prql │ │ │ └── arrays.prql │ │ │ ├── README.md │ │ │ ├── src │ │ │ └── main.rs │ │ │ └── Cargo.toml │ ├── src │ │ ├── debug │ │ │ └── mod.rs │ │ ├── ir │ │ │ ├── mod.rs │ │ │ ├── pl │ │ │ │ └── utils.rs │ │ │ └── rq │ │ │ │ └── utils.rs │ │ ├── main.rs │ │ └── semantic │ │ │ └── resolver │ │ │ └── snapshots │ │ │ ├── prqlc__semantic__resolver__test__functions_pipeline.snap │ │ │ ├── prqlc__semantic__resolver__test__frames_and_names-2.snap │ │ │ ├── prqlc__semantic__resolver__test__append_union_different_tables.snap │ │ │ └── prqlc__semantic__resolver__test__functions_1.snap │ ├── benches │ │ └── bench.rs │ └── build.rs ├── prqlc-parser │ └── src │ │ ├── lib.rs │ │ └── parser │ │ └── pr │ │ └── mod.rs ├── README.md └── prqlc-macros │ └── Cargo.toml ├── .github ├── ISSUE_TEMPLATE │ ├── config.yaml │ └── something_else.yaml ├── CONTRIBUTING.md ├── actionlint.yaml ├── workflows │ ├── README.md │ └── scripts │ │ └── set_version.sh ├── nightly-failure.md ├── .codecov.yaml └── CODE_OF_CONDUCT.md ├── grammars ├── prql-lezer │ ├── .gitignore │ ├── dist │ │ ├── index.d.cts │ │ └── index.d.ts │ ├── rollup.config.js │ └── test │ │ ├── identifiers.txt │ │ └── test-prql.js ├── CotEditor │ └── README.md ├── emacs │ └── README.md ├── nano │ └── README.md ├── raku │ ├── t │ │ └── identifiers.rakutest │ ├── META6.json │ └── README.md └── vim │ └── README.md ├── .sqlfluff ├── .prettierrc.yaml ├── .vscode └── extensions.json ├── .config ├── insta.yaml └── vscode-recommended │ ├── settings.json │ ├── tasks.json │ └── launch.json ├── .cargo └── config.toml ├── rust-toolchain.toml ├── .devcontainer └── base-image │ └── Dockerfile ├── .prettierignore ├── .markdownlint-cli2.yaml └── .gitattributes /web/website/static/CNAME: -------------------------------------------------------------------------------- 1 | prql-lang.org 2 | -------------------------------------------------------------------------------- /prqlc/bindings/dotnet/.gitignore: -------------------------------------------------------------------------------- 1 | bin 2 | obj 3 | -------------------------------------------------------------------------------- /prqlc/bindings/java/java/src/main/resources/.gitkeep: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /prqlc/bindings/java/java/src/test/resources/.gitkeep: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /prqlc/bindings/php/.gitignore: -------------------------------------------------------------------------------- 1 | vendor/ 2 | lib/ 3 | -------------------------------------------------------------------------------- /prqlc/bindings/prqlc-python/python/prqlc/py.typed: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /web/book/src/reference/data/README.md: -------------------------------------------------------------------------------- 1 | # Importing data 2 | -------------------------------------------------------------------------------- /prqlc/bindings/elixir/test/test_helper.exs: -------------------------------------------------------------------------------- 1 | ExUnit.start() 2 | -------------------------------------------------------------------------------- /web/website/.gitignore: -------------------------------------------------------------------------------- 1 | public/ 2 | 3 | .hugo_build.lock 4 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/config.yaml: -------------------------------------------------------------------------------- 1 | blank_issues_enabled: true 2 | -------------------------------------------------------------------------------- /web/.gitignore: -------------------------------------------------------------------------------- 1 | build 2 | 3 | # the old build dir 4 | book/book 5 | -------------------------------------------------------------------------------- /web/book/src/reference/declarations/README.md: -------------------------------------------------------------------------------- 1 | # Declarations 2 | -------------------------------------------------------------------------------- /grammars/prql-lezer/.gitignore: -------------------------------------------------------------------------------- 1 | /node_modules/ 2 | /src/parser.* 3 | /dist 4 | -------------------------------------------------------------------------------- /prqlc/bindings/dotnet/PrqlCompiler.Tests/Usings.cs: -------------------------------------------------------------------------------- 1 | global using Xunit; 2 | -------------------------------------------------------------------------------- /web/book/src/project/changelog.md: -------------------------------------------------------------------------------- 1 | {{#include ../../../../CHANGELOG.md}} 2 | -------------------------------------------------------------------------------- /.sqlfluff: -------------------------------------------------------------------------------- 1 | [sqlfluff] 2 | dialect = ansi 3 | exclude_rules = references.keywords 4 | -------------------------------------------------------------------------------- /web/prql-codemirror-demo/src/vite-env.d.ts: -------------------------------------------------------------------------------- 1 | /// 2 | -------------------------------------------------------------------------------- /web/website/themes/prql-theme/layouts/shortcodes/cite.html: -------------------------------------------------------------------------------- 1 | {{ .Inner }} 2 | -------------------------------------------------------------------------------- /prqlc/bindings/java/.gitignore: -------------------------------------------------------------------------------- 1 | target/ 2 | 3 | **/libprql_java* 4 | **/prql_java.dll 5 | -------------------------------------------------------------------------------- /prqlc/bindings/prqlc-c/examples/minimal-zig/.gitignore: -------------------------------------------------------------------------------- 1 | zig-cache/ 2 | zig-out/ 3 | c/ 4 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/project/artists.prql: -------------------------------------------------------------------------------- 1 | let input = read_parquet "artists.parquet" 2 | -------------------------------------------------------------------------------- /web/book/src/project/bindings/php.md: -------------------------------------------------------------------------------- 1 | {{#include ../../../../../prqlc/bindings/php/README.md}} 2 | -------------------------------------------------------------------------------- /web/book/src/project/bindings/dotnet.md: -------------------------------------------------------------------------------- 1 | {{#include ../../../../../prqlc/bindings/dotnet/README.md}} 2 | -------------------------------------------------------------------------------- /web/book/src/project/bindings/elixir.md: -------------------------------------------------------------------------------- 1 | {{#include ../../../../../prqlc/bindings/elixir/README.md}} 2 | -------------------------------------------------------------------------------- /web/book/src/project/bindings/java.md: -------------------------------------------------------------------------------- 1 | {{#include ../../../../../prqlc/bindings/java/README.md}} 2 | -------------------------------------------------------------------------------- /web/book/src/project/bindings/javascript.md: -------------------------------------------------------------------------------- 1 | {{#include ../../../../../prqlc/bindings/js/README.md}} 2 | -------------------------------------------------------------------------------- /web/book/src/project/integrations/prqlc-cli.md: -------------------------------------------------------------------------------- 1 | {{#include ../../../../../prqlc/prqlc/README.md}} 2 | -------------------------------------------------------------------------------- /prqlc/bindings/php/.editorconfig: -------------------------------------------------------------------------------- 1 | root = true 2 | 3 | [*.php] 4 | indent_size = 4 5 | indent_style = space 6 | -------------------------------------------------------------------------------- /web/book/src/project/bindings/python.md: -------------------------------------------------------------------------------- 1 | {{#include ../../../../../prqlc/bindings/prqlc-python/README.md}} 2 | -------------------------------------------------------------------------------- /web/playground/public/robots.txt: -------------------------------------------------------------------------------- 1 | # https://www.robotstxt.org/robotstxt.html 2 | User-agent: * 3 | Disallow: 4 | -------------------------------------------------------------------------------- /grammars/prql-lezer/dist/index.d.cts: -------------------------------------------------------------------------------- 1 | import { LRParser } from "@lezer/lr"; 2 | 3 | export const parser: LRParser; 4 | -------------------------------------------------------------------------------- /grammars/prql-lezer/dist/index.d.ts: -------------------------------------------------------------------------------- 1 | import { LRParser } from "@lezer/lr"; 2 | 3 | export const parser: LRParser; 4 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/take.prql: -------------------------------------------------------------------------------- 1 | # mssql:test 2 | from tracks 3 | sort {+track_id} 4 | take 3..5 5 | -------------------------------------------------------------------------------- /web/playground/public/favicon.ico: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/playground/public/favicon.ico -------------------------------------------------------------------------------- /web/website/static/img/favicon.ico: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/static/img/favicon.ico -------------------------------------------------------------------------------- /prqlc/prqlc/examples/compile-files/queries/query1.prql: -------------------------------------------------------------------------------- 1 | from albums 2 | select {title, artist_id} 3 | join artists (==artist_id) 4 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/main.rs: -------------------------------------------------------------------------------- 1 | mod bad_error_messages; 2 | mod dbs; 3 | mod error_messages; 4 | mod queries; 5 | mod sql; 6 | -------------------------------------------------------------------------------- /web/website/static/img/favicon-16x16.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/static/img/favicon-16x16.png -------------------------------------------------------------------------------- /web/website/static/img/favicon-32x32.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/static/img/favicon-32x32.png -------------------------------------------------------------------------------- /web/book/src/project/bindings/rust.md: -------------------------------------------------------------------------------- 1 | Please check the documentation of the 2 | [prqlc crate](https://docs.rs/prqlc/latest/prqlc/). 3 | -------------------------------------------------------------------------------- /web/website/archetypes/default.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "{{ replace .Name "-" " " | title }}" 3 | date: {{ .Date }} 4 | draft: true 5 | --- 6 | -------------------------------------------------------------------------------- /web/website/static/img/apple-touch-icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/static/img/apple-touch-icon.png -------------------------------------------------------------------------------- /.github/CONTRIBUTING.md: -------------------------------------------------------------------------------- 1 | # Contributing 2 | 3 | Check out our 4 | [Contributing Docs](https://prql-lang.org/book/project/contributing/) 5 | -------------------------------------------------------------------------------- /.github/actionlint.yaml: -------------------------------------------------------------------------------- 1 | # Custom runner labels not yet recognized by actionlint 2 | self-hosted-runner: 3 | labels: 4 | - macos-15-intel 5 | -------------------------------------------------------------------------------- /prqlc/bindings/prqlc-python/python/prqlc/debug.pyi: -------------------------------------------------------------------------------- 1 | def prql_lineage(prql_query: str) -> str: ... 2 | def pl_to_lineage(pl_json: str) -> str: ... 3 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/constants_only.prql: -------------------------------------------------------------------------------- 1 | from genres 2 | take 10 3 | filter true 4 | take 20 5 | filter true 6 | select d = 10 7 | -------------------------------------------------------------------------------- /web/website/themes/prql-theme/static/favicon.ico: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/themes/prql-theme/static/favicon.ico -------------------------------------------------------------------------------- /prqlc/bindings/elixir/.formatter.exs: -------------------------------------------------------------------------------- 1 | # Used by "mix format" 2 | [ 3 | inputs: ["{mix,.formatter}.exs", "{config,lib,test}/**/*.{ex,exs}"] 4 | ] 5 | -------------------------------------------------------------------------------- /web/website/content/playground.html: -------------------------------------------------------------------------------- 1 | --- 2 | title: "Playground" 3 | layout: big_iframe 4 | --- 5 | 6 | 7 | -------------------------------------------------------------------------------- /web/website/themes/prql-theme/archetypes/default.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: "{{ replace .Name "-" " " | title }}" 3 | date: {{ .Date }} 4 | draft: true 5 | --- 6 | -------------------------------------------------------------------------------- /web/website/themes/prql-theme/static/favicon-16x16.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/themes/prql-theme/static/favicon-16x16.png -------------------------------------------------------------------------------- /web/website/themes/prql-theme/static/favicon-32x32.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/themes/prql-theme/static/favicon-32x32.png -------------------------------------------------------------------------------- /prqlc/bindings/java/java/.mvn/wrapper/maven-wrapper.jar: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/prqlc/bindings/java/java/.mvn/wrapper/maven-wrapper.jar -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/distinct.prql: -------------------------------------------------------------------------------- 1 | # mssql:test 2 | from tracks 3 | select {album_id, genre_id} 4 | group tracks.* (take 1) 5 | sort tracks.* 6 | -------------------------------------------------------------------------------- /web/book/tests/documentation/README.md: -------------------------------------------------------------------------------- 1 | # PRQL documentation tests 2 | 3 | This directory contains tests for PRQL documentation (website, book and README). 4 | -------------------------------------------------------------------------------- /web/website/themes/prql-theme/static/fonts/boxicons.eot: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/themes/prql-theme/static/fonts/boxicons.eot -------------------------------------------------------------------------------- /web/website/themes/prql-theme/static/fonts/boxicons.ttf: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/themes/prql-theme/static/fonts/boxicons.ttf -------------------------------------------------------------------------------- /web/website/themes/prql-theme/static/fonts/boxicons.woff: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/themes/prql-theme/static/fonts/boxicons.woff -------------------------------------------------------------------------------- /prqlc/prqlc-parser/src/lib.rs: -------------------------------------------------------------------------------- 1 | pub mod error; 2 | pub mod generic; 3 | pub mod lexer; 4 | pub mod parser; 5 | pub mod span; 6 | #[cfg(test)] 7 | pub(crate) mod test; 8 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/sort_2.prql: -------------------------------------------------------------------------------- 1 | from albums 2 | select { AA=album_id, artist_id } 3 | sort AA 4 | filter AA >= 25 5 | join artists (==artist_id) 6 | -------------------------------------------------------------------------------- /web/website/content/posts/2023-02-02-one-year/7cpDySb.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/content/posts/2023-02-02-one-year/7cpDySb.png -------------------------------------------------------------------------------- /web/website/content/posts/2023-02-02-one-year/FQ9QSOo.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/content/posts/2023-02-02-one-year/FQ9QSOo.png -------------------------------------------------------------------------------- /web/website/content/posts/2023-02-02-one-year/GXLvoXn.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/content/posts/2023-02-02-one-year/GXLvoXn.png -------------------------------------------------------------------------------- /web/website/content/posts/2023-02-02-one-year/URpCf29.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/content/posts/2023-02-02-one-year/URpCf29.png -------------------------------------------------------------------------------- /web/website/content/posts/2023-02-02-one-year/ncVXken.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/content/posts/2023-02-02-one-year/ncVXken.png -------------------------------------------------------------------------------- /web/website/themes/prql-theme/static/apple-touch-icon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/themes/prql-theme/static/apple-touch-icon.png -------------------------------------------------------------------------------- /web/website/themes/prql-theme/static/fonts/boxicons.woff2: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/themes/prql-theme/static/fonts/boxicons.woff2 -------------------------------------------------------------------------------- /web/website/themes/prql-theme/static/fonts/inter-extra-nold.woff: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/themes/prql-theme/static/fonts/inter-extra-nold.woff -------------------------------------------------------------------------------- /.github/workflows/README.md: -------------------------------------------------------------------------------- 1 | # GitHub Workflows 2 | 3 | See 4 | [our development docs](https://prql-lang.org/book/project/contributing/development.html) 5 | for docs & discussion. 6 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/read_csv.prql: -------------------------------------------------------------------------------- 1 | # sqlite:skip 2 | # postgres:skip 3 | # mysql:skip 4 | from (read_csv "data_file_root/media_types.csv") 5 | sort media_type_id 6 | -------------------------------------------------------------------------------- /web/website/themes/prql-theme/static/fonts/inter-extra-bold.woff2: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/themes/prql-theme/static/fonts/inter-extra-bold.woff2 -------------------------------------------------------------------------------- /.github/nightly-failure.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Nightly tests failed 3 | labels: github_actions 4 | --- 5 | 6 | Nightly tests [failed on {{ date | date('YYYY-MM-DD') }}]({{ env.LINK }}) 7 | -------------------------------------------------------------------------------- /prqlc/prqlc/examples/compile-files/README.md: -------------------------------------------------------------------------------- 1 | # Compile-time example 2 | 3 | `compile-files` is an example of using `prqlc` to compile PRQL to SQL at compile 4 | time in a Rust crate. 5 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/cast.prql: -------------------------------------------------------------------------------- 1 | # mssql:test 2 | from tracks 3 | sort {-bytes} 4 | select { 5 | name, 6 | bin = ((album_id | as REAL) * 99) 7 | } 8 | take 20 9 | -------------------------------------------------------------------------------- /web/playground/src/app/App.css: -------------------------------------------------------------------------------- 1 | .main { 2 | height: 100%; 3 | display: flex; 4 | } 5 | .main > * { 6 | flex-grow: 1; 7 | } 8 | .sidebar { 9 | flex: 0 0 200px; 10 | } 11 | -------------------------------------------------------------------------------- /prqlc/bindings/prqlc-c/examples/minimal-c/README.md: -------------------------------------------------------------------------------- 1 | # Basic C example 2 | 3 | A minimal example for using prql-lib with `gcc` and `make`. 4 | 5 | ## How to run 6 | 7 | make run 8 | -------------------------------------------------------------------------------- /prqlc/bindings/prqlc-c/examples/minimal-cpp/README.md: -------------------------------------------------------------------------------- 1 | # Basic C++ example 2 | 3 | A minimal example for using prqlc-c with `gcc` and `make`. 4 | 5 | ## How to run 6 | 7 | make run 8 | -------------------------------------------------------------------------------- /prqlc/bindings/prqlc-c/examples/minimal-zig/README.md: -------------------------------------------------------------------------------- 1 | # Basic Zig example 2 | 3 | A minimal example for using prql-lib with Zig. 4 | 5 | Run with `task zig` from the root of the repo. 6 | -------------------------------------------------------------------------------- /web/website/themes/prql-theme/layouts/shortcodes/faq.html: -------------------------------------------------------------------------------- 1 |
2 |

{{ (.Get 0) | markdownify }}

 3 | {{ .Inner | markdownify }} 4 |
5 | -------------------------------------------------------------------------------- /prqlc/prqlc/src/debug/mod.rs: -------------------------------------------------------------------------------- 1 | mod log; 2 | mod messages; 3 | mod render_html; 4 | 5 | pub use crate::debug::log::*; 6 | pub use messages::MessageLogger; 7 | pub use render_html::render_log_to_html; 8 | -------------------------------------------------------------------------------- /web/website/content/posts/2023-01-28-format-pretty-reports/query_result.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/max-sixty/prql/HEAD/web/website/content/posts/2023-01-28-format-pretty-reports/query_result.png -------------------------------------------------------------------------------- /prqlc/prqlc/src/ir/mod.rs: -------------------------------------------------------------------------------- 1 | //! Intermediate Representations of Abstract Syntax Tree 2 | //! 3 | pub use prqlc_parser::span::Span; 4 | 5 | pub mod decl; 6 | pub mod generic; 7 | pub mod pl; 8 | pub mod rq; 9 | -------------------------------------------------------------------------------- /web/book/src/project/integrations/rill.md: -------------------------------------------------------------------------------- 1 | # Rill 2 | 3 | PRQL has had some work to integrate with Rill. See the 4 | [Rill issues](https://github.com/PRQL/prql/issues?q=is%3Aissue+rill) for more 5 | details. 6 | -------------------------------------------------------------------------------- /web/website/themes/prql-theme/layouts/shortcodes/columns.html: -------------------------------------------------------------------------------- 1 |
2 | {{ range split .Inner "<--->" }} 3 |
{{ . | $.Page.RenderString }}
4 | {{ end }} 5 |
6 | -------------------------------------------------------------------------------- /web/website/themes/prql-theme/layouts/shortcodes/link.html: -------------------------------------------------------------------------------- 1 | {{/* Compile a link as markdown so it runs the `render-link` template */}} 2 | {{ print "[" (.Get "label") "]" "(" .Get "link" ")" | markdownify }} 3 | -------------------------------------------------------------------------------- /web/book/src/project/integrations/databend.md: -------------------------------------------------------------------------------- 1 | # Databend 2 | 3 | Databend natively supports PRQL. For more details see the 4 | [databend docs](https://www.databend.com/blog/2024-04-03-databend-integrates-prql/). 5 | -------------------------------------------------------------------------------- /web/website/themes/prql-theme/layouts/404.html: -------------------------------------------------------------------------------- 1 | {{ define "main" }} 2 |
3 |

Not found

4 | 5 |

This page does not exist.

6 |
7 | {{ end }} 8 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/data/chinook/media_types.csv: -------------------------------------------------------------------------------- 1 | media_type_id,name 2 | 1,MPEG audio file 3 | 2,Protected AAC audio file 4 | 3,Protected MPEG-4 video file 5 | 4,Purchased AAC audio file 6 | 5,AAC audio file 7 | -------------------------------------------------------------------------------- /web/book/src/reference/spec/README.md: -------------------------------------------------------------------------------- 1 | # Specification 2 | 3 | This chapter explains PRQL's semantics: how expressions are interpreted and 4 | their meaning. It's intended for advanced users and compiler contributors. 5 | -------------------------------------------------------------------------------- /.github/ISSUE_TEMPLATE/something_else.yaml: -------------------------------------------------------------------------------- 1 | name: Something else 2 | description: Anything that's not a bug report 3 | body: 4 | - type: textarea 5 | id: what-happened 6 | attributes: 7 | label: What's up? 8 | -------------------------------------------------------------------------------- /.prettierrc.yaml: -------------------------------------------------------------------------------- 1 | proseWrap: always 2 | # TODO: fix 3 | # overrides: 4 | # # https://github.com/NiklasPor/prettier-plugin-go-template 5 | # - files: 6 | # - "*.html" 7 | # options: 8 | # parser: "go-template" 9 | -------------------------------------------------------------------------------- /web/book/src/reference/syntax/arrays.md: -------------------------------------------------------------------------------- 1 | # Arrays 2 | 3 | Array is a container type, composed of multiple items. All items must be of the 4 | same type. Number of fields can be vary. 5 | 6 | > [!WARNING] This page is a stub. 7 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__data__from__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from artists\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | artists 9 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/append_select_nulls.prql: -------------------------------------------------------------------------------- 1 | from invoices 2 | select {an_id = invoice_id, name = null} 3 | take 2 4 | append ( 5 | from employees 6 | select {an_id = null, name = first_name} 7 | take 2 8 | ) 9 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/distinct_on.prql: -------------------------------------------------------------------------------- 1 | # mssql:test 2 | from tracks 3 | select {genre_id, media_type_id, album_id} 4 | group {genre_id, media_type_id} (sort {-album_id} | take 1) 5 | sort {-genre_id, media_type_id} 6 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/group_all.prql: -------------------------------------------------------------------------------- 1 | # mssql:test 2 | from a=albums 3 | take 10 4 | join tracks (==album_id) 5 | group {a.album_id, a.title} (aggregate price = (sum tracks.unit_price | math.round 2)) 6 | sort album_id 7 | -------------------------------------------------------------------------------- /web/book/src/project/integrations/clickhouse.md: -------------------------------------------------------------------------------- 1 | # ClickHouse 2 | 3 | PRQL works natively in ClickHouse. Check out the 4 | [ClickHouse docs](https://clickhouse.com/docs/en/guides/developer/alternative-query-languages) 5 | for more details. 6 | -------------------------------------------------------------------------------- /web/website/themes/prql-theme/theme.toml: -------------------------------------------------------------------------------- 1 | # theme.toml template for a Hugo theme 2 | # See https://github.com/gohugoio/hugoThemes#themetoml for an example 3 | 4 | license = "Apache 2.0" 5 | min_version = "0.41.0" 6 | name = "PRQL Theme" 7 | -------------------------------------------------------------------------------- /prqlc/bindings/elixir/native/prql/README.md: -------------------------------------------------------------------------------- 1 | # NIF for Elixir.PRQL 2 | 3 | ## To build the NIF module: 4 | 5 | - Your NIF will now build along with your project. 6 | - NIFs are loaded into `PRQL.Native` module in Elixir(`lib/prql/native.ex`) 7 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__data__from__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from `artist tracks`\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | "artist tracks" 9 | -------------------------------------------------------------------------------- /web/website/themes/prql-theme/layouts/_default/big_iframe.html: -------------------------------------------------------------------------------- 1 | {{ define "footer" }} 2 | 3 | {{ end }} 4 | {{ define "main" }} 5 |
6 | {{ .Content }} 7 |
8 | {{ end }} 9 | -------------------------------------------------------------------------------- /web/prql-codemirror-demo/src/style.css: -------------------------------------------------------------------------------- 1 | :root { 2 | color-scheme: light dark; 3 | color: rgba(255, 255, 255, 0.87); 4 | background-color: #242424; 5 | } 6 | 7 | .cm-editor { 8 | max-height: 400px; 9 | border: 1px solid silver; 10 | } 11 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/project/Project.prql: -------------------------------------------------------------------------------- 1 | let favorite_artists = [ 2 | {artist_id = 120, last_listen = @2023-05-18}, 3 | {artist_id = 7, last_listen = @2023-05-16}, 4 | ] 5 | 6 | favorite_artists 7 | join side:left artists.input (==artist_id) 8 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/group_sort.prql: -------------------------------------------------------------------------------- 1 | # mssql:test 2 | from tracks 3 | derive d = album_id + 1 4 | group d ( 5 | aggregate { 6 | n1 = (track_id | sum), 7 | } 8 | ) 9 | sort d 10 | take 10 11 | select { d1 = d, n1 } 12 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__project__target__version__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql version:\"0.13.4\"\n\nfrom employees\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees 9 | -------------------------------------------------------------------------------- /prqlc/README.md: -------------------------------------------------------------------------------- 1 | # PRQL compiler 2 | 3 | Reference implementation of a compiler from PRQL to SQL, written in Rust. 4 | 5 | The bindings for other programming languages can be found in 6 | [./bindings/](./bindings/). 7 | 8 | `prqlc` is the CLI for the compiler. 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__tuples__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nselect {first_name}\n" 4 | --- 5 | SELECT 6 | first_name 7 | FROM 8 | employees 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__tuples__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nselect first_name\n" 4 | --- 5 | SELECT 6 | first_name 7 | FROM 8 | employees 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__data__from__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from e = employees\nselect e.first_name\n" 4 | --- 5 | SELECT 6 | first_name 7 | FROM 8 | employees AS e 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__data__read-files__reading-files__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from `artists.parquet`\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | "artists.parquet" 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__s-strings__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\naggregate {average salary}\n" 4 | --- 5 | SELECT 6 | AVG(salary) 7 | FROM 8 | employees 9 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/append_select_simple.prql: -------------------------------------------------------------------------------- 1 | from invoices 2 | select { invoice_id, billing_country } 3 | append ( 4 | from invoices 5 | select { invoice_id = `invoice_id` + 100, billing_country } 6 | ) 7 | filter (billing_country | text.starts_with("I")) 8 | -------------------------------------------------------------------------------- /prqlc/bindings/prqlc-python/python/prqlc/__init__.py: -------------------------------------------------------------------------------- 1 | # ruff: noqa: F403, F405 2 | # 3 | # This is the default module init provided automatically by Maturin. 4 | from .prqlc import * 5 | 6 | __doc__ = prqlc.__doc__ 7 | if hasattr(prqlc, "__all__"): 8 | __all__ = prqlc.__all__ 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__select__examples__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nselect first_name\n" 4 | --- 5 | SELECT 6 | first_name 7 | FROM 8 | employees 9 | -------------------------------------------------------------------------------- /.vscode/extensions.json: -------------------------------------------------------------------------------- 1 | { 2 | "recommendations": [ 3 | // Keep in sync with Taskfile.yaml 4 | "prql-lang.prql-vscode", 5 | "rust-lang.rust-analyzer", 6 | "mitsuhiko.insta", 7 | "esbenp.prettier-vscode", 8 | "budparr.language-hugo-vscode" 9 | ] 10 | } 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__spec__name-resolution__translating-to-sql__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nselect first_name\n" 4 | --- 5 | SELECT 6 | first_name 7 | FROM 8 | employees 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__parameters__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nfilter id == $1\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees 9 | WHERE 10 | id = $1 11 | -------------------------------------------------------------------------------- /web/playground/src/setupTests.js: -------------------------------------------------------------------------------- 1 | // jest-dom adds custom jest matchers for asserting on DOM nodes. 2 | // allows you to do things like: 3 | // expect(element).toHaveTextContent(/react/i) 4 | // learn more: https://github.com/testing-library/jest-dom 5 | import "@testing-library/jest-dom"; 6 | -------------------------------------------------------------------------------- /.config/insta.yaml: -------------------------------------------------------------------------------- 1 | behavior: 2 | # Disabling because of issues with running on Windows 3 | # force_update: true 4 | review: 5 | # The default (true) has a small performance hit and never needed for us 6 | warn_undiscovered: false 7 | include_ignored: false 8 | include_hidden: false 9 | -------------------------------------------------------------------------------- /web/book/src/reference/syntax/comments.md: -------------------------------------------------------------------------------- 1 | # Comments 2 | 3 | Character `#` denotes a comment until the end of the line. 4 | 5 | ```prql 6 | from employees # Comment 1 7 | # Comment 2 8 | aggregate {average salary} 9 | ``` 10 | 11 | There's no distinct multiline comment syntax. 12 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__data__from__3.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "default_db.group # in place of `from group`\ntake 1\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | "group" 9 | LIMIT 10 | 1 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__take__examples__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\ntake 10\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees 9 | LIMIT 10 | 10 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__keywords__schemas--database-names__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from my_database.chinook.albums\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | my_database.chinook.albums 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__s-strings__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from my_table\nselect db_version = s\"version()\"\n" 4 | --- 5 | SELECT 6 | version() AS db_version 7 | FROM 8 | my_table 9 | -------------------------------------------------------------------------------- /web/website/data/examples/f-strings.yaml: -------------------------------------------------------------------------------- 1 | label: F-strings 2 | prql: | 3 | from web 4 | # Just like Python 5 | select url = f"https://www.{domain}.{tld}/{page}" 6 | sql: | 7 | SELECT 8 | CONCAT('https://www.', domain, '.', tld, '/', page) AS url 9 | FROM 10 | web 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__sort__examples__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nsort age\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees 9 | ORDER BY 10 | age 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__comments__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees # Comment 1\n# Comment 2\naggregate {average salary}\n" 4 | --- 5 | SELECT 6 | AVG(salary) 7 | FROM 8 | employees 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__keywords__identifiers--keywords__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from invoices\naggregate (\n count this\n)\n" 4 | --- 5 | SELECT 6 | COUNT(*) 7 | FROM 8 | invoices 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__keywords__quoting__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.mysql\nfrom employees\nselect `first name`\n" 4 | --- 5 | SELECT 6 | `first name` 7 | FROM 8 | employees 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__operators__coalesce__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from orders\nderive amount ?? 0\n" 4 | --- 5 | SELECT 6 | *, 7 | COALESCE(amount, 0) 8 | FROM 9 | orders 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__distinct__how-do-i-remove-duplicates__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\ngroup employees.* (take 1)\n" 4 | --- 5 | SELECT 6 | DISTINCT * 7 | FROM 8 | employees 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__keywords__quoting__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.postgres\nfrom employees\nselect `first name`\n" 4 | --- 5 | SELECT 6 | "first name" 7 | FROM 8 | employees 9 | -------------------------------------------------------------------------------- /.cargo/config.toml: -------------------------------------------------------------------------------- 1 | [target.wasm32-unknown-unknown] 2 | runner = 'wasm-bindgen-test-runner' 3 | 4 | [target.x86_64-pc-windows-msvc] 5 | # https://github.com/rust-lang/rust/issues/141626#issuecomment-2919988483 6 | linker = "rust-lld" 7 | 8 | [resolver] 9 | incompatible-rust-versions = "fallback" 10 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/aggregation.prql: -------------------------------------------------------------------------------- 1 | # mysql:skip 2 | # clickhouse:skip 3 | # glaredb:skip (the string_agg function is not supported) 4 | from tracks 5 | filter genre_id == 100 6 | derive empty_name = name == '' 7 | aggregate {sum track_id, concat_array name, all empty_name, any empty_name} 8 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__math__example__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nselect age_squared = (age | math.pow 2)\n" 4 | --- 5 | SELECT 6 | POW(age, 2) AS age_squared 7 | FROM 8 | employees 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__filter__examples__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nfilter age > 25\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees 9 | WHERE 10 | age > 25 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__sort__examples__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nsort {-age}\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees 9 | ORDER BY 10 | age DESC 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__keywords__identifiers--keywords__3.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from invoices\nderive t = this.time\n" 4 | --- 5 | SELECT 6 | *, 7 | time AS t 8 | FROM 9 | invoices 10 | -------------------------------------------------------------------------------- /web/website/data/examples/functions.yaml: -------------------------------------------------------------------------------- 1 | label: Functions 2 | prql: | 3 | let celsius_to_fahrenheit = temp -> temp * 9/5 + 32 4 | 5 | from weather 6 | select temp_f = (celsius_to_fahrenheit temp_c) 7 | sql: | 8 | SELECT 9 | temp_c * 9 / 5 + 32 AS temp_f 10 | FROM 11 | weather 12 | -------------------------------------------------------------------------------- /prqlc/bindings/prqlc-python/build.rs: -------------------------------------------------------------------------------- 1 | // From https://pyo3.rs/v0.14.5/building_and_distribution.html#macos 2 | // Note the alternative static option with `config.toml` has an problem in https://github.com/PRQL/prql/issues/411. 3 | 4 | fn main() { 5 | pyo3_build_config::add_extension_module_link_args(); 6 | } 7 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/append_select.prql: -------------------------------------------------------------------------------- 1 | from invoices 2 | select { customer_id, invoice_id, billing_country } 3 | take 10..15 4 | append ( 5 | from invoices 6 | select { customer_id, invoice_id, billing_country } 7 | take 40..45 8 | ) 9 | select { billing_country, invoice_id } 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__select__excluding-columns__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from artists\nderive nick = name\nselect !{artists.*}\n" 4 | --- 5 | SELECT 6 | name AS nick 7 | FROM 8 | artists 9 | -------------------------------------------------------------------------------- /web/website/data/examples/s-strings.yaml: -------------------------------------------------------------------------------- 1 | label: S-strings 2 | prql: | 3 | # There's no `version` in PRQL, but s-strings 4 | # let us embed SQL as an escape hatch: 5 | from x 6 | derive db_version = s"version()" 7 | sql: | 8 | SELECT 9 | *, 10 | version() AS db_version 11 | FROM x 12 | -------------------------------------------------------------------------------- /web/website/data/examples/basic.yaml: -------------------------------------------------------------------------------- 1 | label: Basic example 2 | prql: | 3 | from employees 4 | select {id, first_name, age} 5 | sort age 6 | take 10 7 | sql: | 8 | SELECT 9 | id, 10 | first_name, 11 | age 12 | FROM 13 | employees 14 | ORDER BY 15 | age 16 | LIMIT 17 | 10 18 | -------------------------------------------------------------------------------- /web/book/src/reference/syntax/r-strings.md: -------------------------------------------------------------------------------- 1 | # R-strings 2 | 3 | R-strings handle escape characters without special treatment: 4 | 5 | ```prql 6 | from artists 7 | derive normal_string = "\\\t" # two characters - \ and tab (\t) 8 | derive raw_string = r"\\\t" # four characters - \, \, \, and t 9 | ``` 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__operators__regex-expressions__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from tracks\nfilter (name ~= \"Love\")\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | tracks 9 | WHERE 10 | REGEXP(name, 'Love') 11 | -------------------------------------------------------------------------------- /web/website/README.md: -------------------------------------------------------------------------------- 1 | # PRQL Website 2 | 3 | A [hugo](https://gohugo.io/) website with PRQL theme, which uses minimal 4 | [water.css](https://watercss.kognise.dev/) styling. 5 | 6 | Serve: 7 | 8 | ```sh 9 | cd website 10 | hugo server 11 | ``` 12 | 13 | To add pages, just add files in `content/` directory. 14 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/set_ops_remove.prql: -------------------------------------------------------------------------------- 1 | # mssql:test 2 | let distinct = rel -> (from t = _param.rel | group {t.*} (take 1)) 3 | 4 | from_text format:json '{ "columns": ["a"], "data": [[1], [2], [2], [3]] }' 5 | distinct 6 | remove (from_text format:json '{ "columns": ["a"], "data": [[1], [2]] }') 7 | sort a 8 | -------------------------------------------------------------------------------- /rust-toolchain.toml: -------------------------------------------------------------------------------- 1 | [toolchain] 2 | # Generally run 1 behind latest 3 | channel = "1.90.0" 4 | components = ["rustfmt", "clippy"] 5 | # We want two targets: wasm32, and the default target for the platform, which we 6 | # don't list here. (i.e. we use each platform to test each platform) 7 | targets = ["wasm32-unknown-unknown"] 8 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__group__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nsort join_date\ntake 1\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees 9 | ORDER BY 10 | join_date 11 | LIMIT 12 | 1 13 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__select__excluding-columns__3.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.bigquery\nfrom tracks\nselect !is_compilation\n" 4 | --- 5 | SELECT 6 | NOT is_compilation 7 | FROM 8 | tracks 9 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/genre_counts.prql: -------------------------------------------------------------------------------- 1 | # clickhouse:skip (ClickHouse prefers aliases to column names https://github.com/PRQL/prql/issues/2827) 2 | # mssql:test 3 | let genre_count = ( 4 | from genres 5 | aggregate {a = count name} 6 | ) 7 | 8 | from genre_count 9 | filter a > 0 10 | select a = -a 11 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/loop_01.prql: -------------------------------------------------------------------------------- 1 | # clickhouse:skip (DB::Exception: Syntax error) 2 | # glaredb:skip (DataFusion does not support recursive CTEs https://github.com/apache/arrow-datafusion/issues/462) 3 | from [{n = 1}] 4 | select n = n - 2 5 | loop (filter n < 4 | select n = n + 1) 6 | select n = n * 2 7 | sort n 8 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__take.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom tracks\nsort {+track_id}\ntake 3..5\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/take.prql 5 | --- 6 | from tracks 7 | sort {+track_id} 8 | take 3..5 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__project__target__version__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "[{version = prql.version}]\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | '0.13.8' AS version 8 | ) 9 | SELECT 10 | version 11 | FROM 12 | table_0 13 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__distinct__how-do-i-remove-duplicates__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nselect department\ngroup employees.* (\n take 1\n)\n" 4 | --- 5 | SELECT 6 | DISTINCT department 7 | FROM 8 | employees 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__filter__examples__3.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nfilter (age | in 25..40)\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees 9 | WHERE 10 | age BETWEEN 25 AND 40 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__select__examples__3.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from e=employees\nselect {e.first_name, e.last_name}\n" 4 | --- 5 | SELECT 6 | first_name, 7 | last_name 8 | FROM 9 | employees AS e 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__f-strings__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nselect full_name = f\"{first_name} {last_name}\"\n" 4 | --- 5 | SELECT 6 | CONCAT(first_name, ' ', last_name) AS full_name 7 | FROM 8 | employees 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__project__target__examples__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.postgres\n\nfrom employees\nsort age\ntake 10\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees 9 | ORDER BY 10 | age 11 | LIMIT 12 | 10 13 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compileall__distinct.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom tracks\nselect {album_id, genre_id}\ngroup tracks.* (take 1)\nsort tracks.*\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/distinct.prql 5 | --- 6 | 7 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__select__examples__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nselect name = f\"{first_name} {last_name}\"\n" 4 | --- 5 | SELECT 6 | CONCAT(first_name, ' ', last_name) AS name 7 | FROM 8 | employees 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__select__excluding-columns__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.bigquery\nfrom tracks\nselect !{milliseconds, bytes}\n" 4 | --- 5 | SELECT 6 | * EXCEPT (milliseconds, bytes) 7 | FROM 8 | tracks 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__append__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees_1\nappend employees_2\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees_1 9 | UNION 10 | ALL 11 | SELECT 12 | * 13 | FROM 14 | employees_2 15 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__literals__dates__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nderive age_at_year_end = (@2022-12-31 - dob)\n" 4 | --- 5 | SELECT 6 | *, 7 | DATE '2022-12-31' - dob AS age_at_year_end 8 | FROM 9 | employees 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__literals__durations__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from projects\nderive first_check_in = start + 10days\n" 4 | --- 5 | SELECT 6 | *, 7 | "start" + INTERVAL 10 DAY AS first_check_in 8 | FROM 9 | projects 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__operators__parentheses__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nderive other_distance = (sum distance)\n" 4 | --- 5 | SELECT 6 | *, 7 | SUM(distance) OVER () AS other_distance 8 | FROM 9 | employees 10 | -------------------------------------------------------------------------------- /web/website/data/examples/dialects.yaml: -------------------------------------------------------------------------------- 1 | label: Dialects 2 | prql: | 3 | prql target:sql.mssql # Will generate TOP rather than LIMIT 4 | 5 | from employees 6 | sort age 7 | take 10 8 | sql: | 9 | SELECT 10 | * 11 | FROM 12 | employees 13 | ORDER BY 14 | age OFFSET 0 ROWS 15 | FETCH 16 | FIRST 10 ROWS ONLY 17 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/switch.prql: -------------------------------------------------------------------------------- 1 | # glaredb:skip (May be a bag of String type conversion for Postgres Client) 2 | # mssql:test 3 | from tracks 4 | sort milliseconds 5 | select display = case [ 6 | composer != null => composer, 7 | genre_id < 17 => 'no composer', 8 | true => f'unknown composer' 9 | ] 10 | take 10 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__aggregate__aggregate-is-required__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nderive {avg_sal = average salary}\n" 4 | --- 5 | SELECT 6 | *, 7 | AVG(salary) OVER () AS avg_sal 8 | FROM 9 | employees 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__derive__examples__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nderive gross_salary = salary + payroll_tax\n" 4 | --- 5 | SELECT 6 | *, 7 | salary + payroll_tax AS gross_salary 8 | FROM 9 | employees 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__filter__examples__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nfilter (department | in [\"IT\", \"HR\"])\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees 9 | WHERE 10 | department IN ('IT', 'HR') 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__sort__examples__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nsort {age, -tenure, +salary}\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees 9 | ORDER BY 10 | age, 11 | tenure DESC, 12 | salary 13 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__date__date-functions__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.duckdb\n\nfrom invoices\nselect (invoice_date | date.to_text \"%d/%m/%Y\")\n\n" 4 | --- 5 | SELECT 6 | strftime(invoice_date, '%d/%m/%Y') 7 | FROM 8 | invoices 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__date__date-functions__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.mysql\n\nfrom invoices\nselect (invoice_date | date.to_text \"%d/%m/%Y\")\n\n" 4 | --- 5 | SELECT 6 | DATE_FORMAT(invoice_date, '%d/%m/%Y') 7 | FROM 8 | invoices 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__aggregate__examples__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\naggregate {\n average salary,\n ct = count salary\n}\n" 4 | --- 5 | SELECT 6 | AVG(salary), 7 | COUNT(*) AS ct 8 | FROM 9 | employees 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__select__excluding-columns__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from tracks\nselect {track_id, title, composer, bytes}\nselect !{title, composer}\n" 4 | --- 5 | SELECT 6 | track_id, 7 | bytes 8 | FROM 9 | tracks 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__keywords__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "std.from my_table\nstd.select {from = my_table.a, take = my_table.b}\nstd.take 3\n" 4 | --- 5 | SELECT 6 | a AS "from", 7 | b AS take 8 | FROM 9 | my_table 10 | LIMIT 11 | 3 12 | -------------------------------------------------------------------------------- /web/book/theme/head.hbs: -------------------------------------------------------------------------------- 1 | 2 | 6 | -------------------------------------------------------------------------------- /grammars/CotEditor/README.md: -------------------------------------------------------------------------------- 1 | # PRQL syntax style for CotEditor 2 | 3 | [CotEditor](https://coteditor.com/)'s syntax style file for the PRQL query 4 | language. 5 | 6 | ## Install 7 | 8 | 1. Go to _Preferences > Format_ and choose _Import…_ in the gear icon menu that 9 | is just below the installed style list. 10 | 2. Choose the `PRQL.yaml` file. 11 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/sort.prql: -------------------------------------------------------------------------------- 1 | # mssql:test 2 | from e=employees 3 | filter first_name != "Mitchell" 4 | sort {first_name, last_name} 5 | 6 | # joining may use HashMerge, which can undo ORDER BY 7 | join manager=employees side:left (e.reports_to == manager.employee_id) 8 | 9 | select {e.first_name, e.last_name, manager.first_name} 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__project__target__examples__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.mssql\n\nfrom employees\nsort age\ntake 10\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees 9 | ORDER BY 10 | age OFFSET 0 ROWS 11 | FETCH FIRST 12 | 10 ROWS ONLY 13 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__date__date-functions__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.postgres\n\nfrom invoices\nselect (invoice_date | date.to_text \"%d/%m/%Y\")\n\n" 4 | --- 5 | SELECT 6 | TO_CHAR(invoice_date, 'DD/MM/YYYY') 7 | FROM 8 | invoices 9 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__filter__examples__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nfilter (age > 25 || department != \"IT\")\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees 9 | WHERE 10 | age > 25 11 | OR department <> 'IT' 12 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__ranges__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from orders\nsort {-value, created_at}\ntake 101..110\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | orders 9 | ORDER BY 10 | value DESC, 11 | created_at 12 | LIMIT 13 | 10 OFFSET 100 14 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/group_sort_limit_take.prql: -------------------------------------------------------------------------------- 1 | # Compute the 3 longest songs for each genre and sort by genre 2 | # mssql:test 3 | from tracks 4 | select {genre_id,milliseconds} 5 | group {genre_id} ( 6 | sort {-milliseconds} 7 | take 3 8 | ) 9 | join genres (==genre_id) 10 | select {name, milliseconds} 11 | sort {+name,-milliseconds} 12 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__append__remove__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees_1\nremove employees_2\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees_1 AS t 9 | EXCEPT 10 | ALL 11 | SELECT 12 | * 13 | FROM 14 | employees_2 AS b 15 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__literals__times__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from orders\nderive should_have_shipped_today = (order_time < @08:30)\n" 4 | --- 5 | SELECT 6 | *, 7 | order_time < TIME '08:30' AS should_have_shipped_today 8 | FROM 9 | orders 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__operators__regex-expressions__4.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.mysql\n\nfrom tracks\nfilter (name ~= \"With You\")\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | tracks 9 | WHERE 10 | REGEXP_LIKE(name, 'With You', 'c') 11 | -------------------------------------------------------------------------------- /web/playground/vite.config.js: -------------------------------------------------------------------------------- 1 | import { defineConfig } from "vite"; 2 | import react from "@vitejs/plugin-react"; 3 | import wasm from "vite-plugin-wasm"; 4 | 5 | // https://vitejs.dev/config/ 6 | export default defineConfig({ 7 | build: { 8 | target: "esnext", 9 | }, 10 | base: "/playground/playground", 11 | plugins: [react(), wasm()], 12 | }); 13 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__operators__regex-expressions__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.duckdb\n\nfrom artists\nfilter (name ~= \"Love.*You\")\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | artists 9 | WHERE 10 | REGEXP_MATCHES(name, 'Love.*You') 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__spec__null__null-handling__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nfilter first_name == null\nfilter null != last_name\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees 9 | WHERE 10 | first_name IS NULL 11 | AND last_name IS NOT NULL 12 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__append__intersection__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees_1\nintersect employees_2\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | employees_1 AS t 9 | INTERSECT 10 | ALL 11 | SELECT 12 | * 13 | FROM 14 | employees_2 AS b 15 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__operators__regex-expressions__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.bigquery\n\nfrom tracks\nfilter (name ~= \"\\\\bLove\\\\b\")\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | tracks 9 | WHERE 10 | REGEXP_CONTAINS(name, '\bLove\b') 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__pipes__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nfilter department == \"Product\"\nselect {first_name, last_name}\n" 4 | --- 5 | SELECT 6 | first_name, 7 | last_name 8 | FROM 9 | employees 10 | WHERE 11 | department = 'Product' 12 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__pipes__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees | filter department == \"Product\" | select {first_name, last_name}\n" 4 | --- 5 | SELECT 6 | first_name, 7 | last_name 8 | FROM 9 | employees 10 | WHERE 11 | department = 'Product' 12 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__take__examples__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from orders\nsort {-value, created_at}\ntake 101..110\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | orders 9 | ORDER BY 10 | value DESC, 11 | created_at 12 | LIMIT 13 | 10 OFFSET 100 14 | -------------------------------------------------------------------------------- /prqlc/bindings/php/src/Result.php: -------------------------------------------------------------------------------- 1 | 19 | */ 20 | public array $messages; 21 | } 22 | -------------------------------------------------------------------------------- /prqlc/prqlc/benches/bench.rs: -------------------------------------------------------------------------------- 1 | // Exclude benchmarks from WASM builds (criterion depends on alloca). 2 | // The inner cfg attr compiles an empty crate, but we still need a main for WASM. 3 | #![cfg_attr(not(target_family = "wasm"), allow(unused))] 4 | 5 | #[cfg(target_family = "wasm")] 6 | fn main() {} 7 | 8 | #[cfg(not(target_family = "wasm"))] 9 | include!("bench_impl.rs"); 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__declarations__functions__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "let fahrenheit_to_celsius = temp -> (temp - 32) / 1.8\n\nfrom cities\nderive temp_c = (fahrenheit_to_celsius temp_f)\n" 4 | --- 5 | SELECT 6 | *, 7 | (temp_f - 32) / 1.8 AS temp_c 8 | FROM 9 | cities 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__join__examples__4.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\njoin positions (==emp_no)\n" 4 | --- 5 | SELECT 6 | employees.*, 7 | positions.* 8 | FROM 9 | employees 10 | INNER JOIN positions ON employees.emp_no = positions.emp_no 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__keywords__identifiers--keywords__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from invoices\njoin tracks (this.track_id==that.id)\n" 4 | --- 5 | SELECT 6 | invoices.*, 7 | tracks.* 8 | FROM 9 | invoices 10 | INNER JOIN tracks ON invoices.track_id = tracks.id 11 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compile__take.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom tracks\nsort {+track_id}\ntake 3..5\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/take.prql 5 | --- 6 | SELECT 7 | * 8 | FROM 9 | tracks 10 | ORDER BY 11 | track_id 12 | LIMIT 13 | 3 OFFSET 2 14 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__operators__regex-expressions__3.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.postgres\n\nfrom tracks\nfilter (name ~= \"\\\\(I Can't Help\\\\) Falling\")\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | tracks 9 | WHERE 10 | name ~ '\(I Can''t Help\) Falling' 11 | -------------------------------------------------------------------------------- /.config/vscode-recommended/settings.json: -------------------------------------------------------------------------------- 1 | { 2 | "files.exclude": { 3 | "**/.git": true, 4 | "**/.svn": true, 5 | "**/.hg": true, 6 | "**/CVS": true, 7 | "**/.DS_Store": true, 8 | "**/Thumbs.db": true, 9 | "web/book/book": true, 10 | "web/build": true, 11 | ".direnv": true, 12 | ".pytest_cache": true, 13 | ".mypy_cache": true 14 | } 15 | } 16 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__join__examples__3.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from tracks\njoin side:inner artists (\n this.id==that.artist_id\n)\n" 4 | --- 5 | SELECT 6 | tracks.*, 7 | artists.* 8 | FROM 9 | tracks 10 | INNER JOIN artists ON tracks.id = artists.artist_id 11 | -------------------------------------------------------------------------------- /web/prql-codemirror-demo/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | CodeMirror with PRQL 7 | 8 | 9 |
10 | 11 | 12 | 13 | -------------------------------------------------------------------------------- /.config/vscode-recommended/tasks.json: -------------------------------------------------------------------------------- 1 | { 2 | "version": "2.0.0", 3 | "tasks": [ 4 | { 5 | "label": "prqlc-build", 6 | "type": "cargo", 7 | "command": "build", 8 | "args": ["--package=prqlc"], 9 | "presentation": { 10 | "reveal": "silent", 11 | "clear": true 12 | }, 13 | "problemMatcher": ["$rustc"] 14 | } 15 | ] 16 | } 17 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/pipelines.prql: -------------------------------------------------------------------------------- 1 | # sqlite:skip (Only works on Sqlite implementations which have the extension 2 | # installed 3 | # https://stackoverflow.com/questions/24037982/how-to-use-regexp-in-sqlite) 4 | 5 | from tracks 6 | 7 | filter (name ~= "Love") 8 | filter ((milliseconds / 1000 / 60) | in 3..4) 9 | sort track_id 10 | take 1..15 11 | select {name, composer} 12 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__keywords__identifiers--keywords__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from invoices\nderive t = time\n" 4 | --- 5 | Error: 6 | ╭─[ :2:12 ] 7 | │ 8 | 2 │ derive t = time 9 | │ ──┬─ 10 | │ ╰─── expected a value, but found a type 11 | ───╯ 12 | -------------------------------------------------------------------------------- /web/website/data/examples/null-handling.yaml: -------------------------------------------------------------------------------- 1 | label: Null handling 2 | prql: | 3 | from users 4 | filter last_login != null 5 | filter deleted_at == null 6 | derive channel = channel ?? "unknown" 7 | sql: | 8 | SELECT 9 | *, 10 | COALESCE(channel, 'unknown') AS channel 11 | FROM 12 | users 13 | WHERE 14 | last_login IS NOT NULL 15 | AND deleted_at IS NULL 16 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__results__constants_only.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "from genres\ntake 10\nfilter true\ntake 20\nfilter true\nselect d = 10\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/constants_only.prql 5 | --- 6 | 10 7 | 10 8 | 10 9 | 10 10 | 10 11 | 10 12 | 10 13 | 10 14 | 10 15 | 10 16 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__window__windowing-by-default__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nsort age\nderive {rnk = rank age}\n" 4 | --- 5 | SELECT 6 | *, 7 | RANK() OVER ( 8 | ORDER BY 9 | age 10 | ) AS rnk 11 | FROM 12 | employees 13 | ORDER BY 14 | age 15 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__s-strings__braces__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nderive {\n has_valid_title = s\"regexp_contains(title, '([a-z0-9]*-){{2,}}')\"\n}\n" 4 | --- 5 | SELECT 6 | *, 7 | regexp_contains(title, '([a-z0-9]*-){2,}') AS has_valid_title 8 | FROM 9 | employees 10 | -------------------------------------------------------------------------------- /web/prql-codemirror-demo/.gitignore: -------------------------------------------------------------------------------- 1 | # Logs 2 | logs 3 | *.log 4 | npm-debug.log* 5 | yarn-debug.log* 6 | yarn-error.log* 7 | pnpm-debug.log* 8 | lerna-debug.log* 9 | 10 | node_modules 11 | dist 12 | dist-ssr 13 | *.local 14 | 15 | # Editor directories and files 16 | .vscode/* 17 | !.vscode/extensions.json 18 | .idea 19 | .DS_Store 20 | *.suo 21 | *.ntvs* 22 | *.njsproj 23 | *.sln 24 | *.sw? 25 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__join__examples__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\njoin side:left p=positions (employees.id==p.employee_id)\n" 4 | --- 5 | SELECT 6 | employees.*, 7 | p.* 8 | FROM 9 | employees 10 | LEFT OUTER JOIN positions AS p ON employees.id = p.employee_id 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__pipes__ceci-nest-pas-une-pipe__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "let b =\n \\ 3 # No pipe from line break within this line wrap\n\n# No pipe from line break before this `from` statement\n\nfrom y\nderive a = b\n" 4 | --- 5 | SELECT 6 | *, 7 | 3 AS a 8 | FROM 9 | y 10 | -------------------------------------------------------------------------------- /prqlc/bindings/dotnet/PrqlCompiler/NativeResult.cs: -------------------------------------------------------------------------------- 1 | using System; 2 | 3 | namespace Prql.Compiler 4 | { 5 | internal struct NativeResult 6 | { 7 | #pragma warning disable CS0649 // Field is never assigned to 8 | public string Output; 9 | public IntPtr Messages; 10 | public int MessagesLen; 11 | #pragma warning restore CS0649 // Field is never assigned to 12 | } 13 | } 14 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/sort_3.prql: -------------------------------------------------------------------------------- 1 | from [{track_id=0, album_id=1, genre_id=2}] 2 | select { AA=track_id, album_id, genre_id } 3 | sort AA 4 | join side:left [{album_id=1, album_title="Songs"}] (==album_id) 5 | select { AA, AT = album_title ?? "unknown", genre_id } 6 | filter AA < 25 7 | join side:left [{genre_id=1, genre_title="Rock"}] (==genre_id) 8 | select { AA, AT, GT = genre_title ?? "unknown" } 9 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__constants_only.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "from genres\ntake 10\nfilter true\ntake 20\nfilter true\nselect d = 10\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/constants_only.prql 5 | --- 6 | from genres 7 | take 10 8 | filter true 9 | take 20 10 | filter true 11 | select d = 10 12 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__declarations__variables__variables--__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\ntake 50\ninto first_50\n\nfrom first_50\n" 4 | --- 5 | WITH first_50 AS ( 6 | SELECT 7 | * 8 | FROM 9 | employees 10 | LIMIT 11 | 50 12 | ) 13 | SELECT 14 | * 15 | FROM 16 | first_50 17 | -------------------------------------------------------------------------------- /prqlc/bindings/elixir/lib/prql/errors.ex: -------------------------------------------------------------------------------- 1 | defmodule PRQL.PRQLError do 2 | @moduledoc """ 3 | Represents an error returned from PRQL compiler. 4 | 5 | `:error` contains the message from compiler as a **JSON string**. 6 | """ 7 | defexception [:message, :error] 8 | 9 | @impl true 10 | def exception(err) do 11 | %__MODULE__{message: "Error compiling PRQL query", error: err} 12 | end 13 | end 14 | -------------------------------------------------------------------------------- /prqlc/bindings/php/src/Span.php: -------------------------------------------------------------------------------- 1 | s"x({p1})" 2 | 3 | from [{a=null}, {a=2}] 4 | filter (a | in [2, 4]) 5 | select { 6 | empty_array = [], 7 | single_element = [42], 8 | null_element = [null], 9 | complex_expressions = [a + a, (a * 2) + 1], 10 | nested_function_calls = [(min a), (max a ?? 0)], 11 | passing_as_arg = x [1,2,3], 12 | nested = ['a', ['b']] 13 | } 14 | -------------------------------------------------------------------------------- /web/book/src/reference/stdlib/transforms/take.md: -------------------------------------------------------------------------------- 1 | # Take 2 | 3 | Picks rows based on their position. 4 | 5 | ```prql no-eval 6 | take (n|range) 7 | ``` 8 | 9 | See [Ranges](../../syntax/ranges.md) for more details on how ranges work. 10 | 11 | ## Examples 12 | 13 | ```prql 14 | from employees 15 | take 10 16 | ``` 17 | 18 | ```prql 19 | from orders 20 | sort {-value, created_at} 21 | take 101..110 22 | ``` 23 | -------------------------------------------------------------------------------- /web/book/src/reference/syntax/parameters.md: -------------------------------------------------------------------------------- 1 | # Parameters 2 | 3 | Parameter is a placeholder for a value provided after the compilation of the 4 | query. 5 | 6 | It uses the following syntax: `$id`, where `id` is an arbitrary alpha numeric 7 | string. 8 | 9 | Most database engines only support numeric positional parameter ids (i.e `$3`). 10 | 11 | ```prql 12 | from employees 13 | filter id == $1 14 | ``` 15 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__declarations__functions__piping-values-into-functions__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "let fahrenheit_to_celsius = temp -> (temp - 32) / 1.8\n\nfrom cities\nderive temp_c = (temp_f | fahrenheit_to_celsius)\n" 4 | --- 5 | SELECT 6 | *, 7 | (temp_f - 32) / 1.8 AS temp_c 8 | FROM 9 | cities 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__operators__regex-expressions__5.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.sqlite\n\nfrom tracks\nfilter (name ~= \"But Why Isn't Your Syntax More Similar\\\\?\")\n" 4 | --- 5 | SELECT 6 | * 7 | FROM 8 | tracks 9 | WHERE 10 | name REGEXP 'But Why Isn''t Your Syntax More Similar\?' 11 | -------------------------------------------------------------------------------- /.github/workflows/scripts/set_version.sh: -------------------------------------------------------------------------------- 1 | #!/bin/bash 2 | 3 | # We set prefix-key to the version from Cargo.toml for Swatinem/rust-cache@v2 4 | # since the caches seem to accumulate cruft over time; 5 | # ref https://github.com/PRQL/prql/pull/2407 6 | 7 | version=$(cargo metadata --format-version=1 --no-deps | jq --raw-output '.packages[] | select(.name == "prqlc") | .version') 8 | echo "version=${version}" >>"$GITHUB_ENV" 9 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/append_select_multiple_with_null.prql: -------------------------------------------------------------------------------- 1 | from invoices 2 | select { customer_id, invoice_id, billing_country } 3 | take 5 4 | append ( 5 | from employees 6 | select { employee_id, employee_id, country } 7 | take 5 8 | ) 9 | append ( 10 | from invoice_items 11 | select { invoice_line_id, invoice_id, null } 12 | take 5 13 | ) 14 | select { billing_country, invoice_id } 15 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__read_csv.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# sqlite:skip\n# postgres:skip\n# mysql:skip\nfrom (read_csv \"data_file_root/media_types.csv\")\nsort media_type_id\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/read_csv.prql 5 | --- 6 | from (read_csv "data_file_root/media_types.csv") 7 | sort media_type_id 8 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__join__examples__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\njoin side:left positions (employees.id==positions.employee_id)\n" 4 | --- 5 | SELECT 6 | employees.*, 7 | positions.* 8 | FROM 9 | employees 10 | LEFT OUTER JOIN positions ON employees.id = positions.employee_id 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__operators__wrapping-lines__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from artists\nselect is_europe =\n\\ country == \"DE\"\n\\ || country == \"FR\"\n\\ || country == \"ES\"\n" 4 | --- 5 | SELECT 6 | country = 'DE' 7 | OR country = 'FR' 8 | OR country = 'ES' AS is_europe 9 | FROM 10 | artists 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__select__examples__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nselect {\n name = f\"{first_name} {last_name}\",\n age_eoy = dob - @2022-12-31,\n}\n" 4 | --- 5 | SELECT 6 | CONCAT(first_name, ' ', last_name) AS name, 7 | dob - DATE '2022-12-31' AS age_eoy 8 | FROM 9 | employees 10 | -------------------------------------------------------------------------------- /prqlc/prqlc/src/main.rs: -------------------------------------------------------------------------------- 1 | #[cfg(all(not(target_family = "wasm"), feature = "cli"))] 2 | mod cli; 3 | 4 | #[cfg(all(not(target_family = "wasm"), feature = "cli"))] 5 | fn main() -> color_eyre::eyre::Result<()> { 6 | cli::main() 7 | } 8 | 9 | #[cfg(any(target_family = "wasm", not(feature = "cli")))] 10 | fn main() { 11 | panic!("Crate is not built with the `cli` feature enabled, or was built for a wasm target."); 12 | } 13 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__distinct.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom tracks\nselect {album_id, genre_id}\ngroup tracks.* (take 1)\nsort tracks.*\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/distinct.prql 5 | --- 6 | from tracks 7 | select {album_id, genre_id} 8 | group tracks.`*` (take 1) 9 | sort tracks.`*` 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__f-strings__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from web\nselect url = f\"http{tls}://www.{domain}.{tld}/{page}\"\n" 4 | --- 5 | SELECT 6 | CONCAT( 7 | 'http', 8 | tls, 9 | '://www.', 10 | domain, 11 | '.', 12 | tld, 13 | '/', 14 | page 15 | ) AS url 16 | FROM 17 | web 18 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__window__windowing-by-default__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\ngroup department (\n sort age\n derive {rnk = rank age}\n)\n" 4 | --- 5 | SELECT 6 | *, 7 | RANK() OVER ( 8 | PARTITION BY department 9 | ORDER BY 10 | age 11 | ) AS rnk 12 | FROM 13 | employees 14 | -------------------------------------------------------------------------------- /prqlc/prqlc/examples/compile-files/src/main.rs: -------------------------------------------------------------------------------- 1 | // a helper macro 2 | #[macro_export] 3 | macro_rules! include_query { 4 | ($filename:expr) => { 5 | include_str!(concat!(env!("OUT_DIR"), "/", $filename)) 6 | }; 7 | } 8 | 9 | fn main() { 10 | // queries are accessible under their original filename 11 | let compiler_query: &str = include_query!("query1.prql"); 12 | 13 | println!("{compiler_query}"); 14 | } 15 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/data/chinook/playlists.csv: -------------------------------------------------------------------------------- 1 | playlist_id,name 2 | 1,Music 3 | 2,Movies 4 | 3,TV Shows 5 | 4,Audiobooks 6 | 5,90’s Music 7 | 6,Audiobooks 8 | 7,Movies 9 | 8,Music 10 | 9,Music Videos 11 | 10,TV Shows 12 | 11,Brazilian Music 13 | 12,Classical 14 | 13,Classical 101 - Deep Cuts 15 | 14,Classical 101 - Next Steps 16 | 15,Classical 101 - The Basics 17 | 16,Grunge 18 | 17,Heavy Metal Classic 19 | 18,On-The-Go 1 20 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__cast.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom tracks\nsort {-bytes}\nselect {\n name,\n bin = ((album_id | as REAL) * 99)\n}\ntake 20\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/cast.prql 5 | --- 6 | from tracks 7 | sort {-bytes} 8 | select {name, bin = (album_id | as REAL) * 99} 9 | take 20 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__text__example__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nselect {\n (last_name | text.lower | text.starts_with(\"a\")),\n (title | text.replace \"manager\" \"chief\"),\n}\n" 4 | --- 5 | SELECT 6 | LOWER(last_name) LIKE CONCAT('a', '%'), 7 | REPLACE(title, 'manager', 'chief') 8 | FROM 9 | employees 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__group__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\ngroup {title, country} (\n aggregate {\n average salary,\n ct = count salary\n }\n)\n" 4 | --- 5 | SELECT 6 | title, 7 | country, 8 | AVG(salary), 9 | COUNT(*) AS ct 10 | FROM 11 | employees 12 | GROUP BY 13 | title, 14 | country 15 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__r-strings__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from artists\nderive normal_string = \"\\\\\\t\" # two characters - \\ and tab (\\t)\nderive raw_string = r\"\\\\\\t\" # four characters - \\, \\, \\, and t\n" 4 | --- 5 | SELECT 6 | *, 7 | '\ ' AS normal_string, 8 | '\\\t' AS raw_string 9 | FROM 10 | artists 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__s-strings__precedence-within-s-strings__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nderive {\n gross_salary = salary + benefits,\n daily_rate = s\"{gross_salary} / 365\"\n}\n" 4 | --- 5 | SELECT 6 | *, 7 | salary + benefits AS gross_salary, 8 | salary + benefits / 365 AS daily_rate 9 | FROM 10 | employees 11 | -------------------------------------------------------------------------------- /prqlc/bindings/elixir/native/prql/.cargo/config.toml: -------------------------------------------------------------------------------- 1 | # Note that this doesn't apply when compiling from the workspace root 2 | 3 | # (also it seems to work at first glance without this? but it's referenced at 4 | # https://github.com/philss/rustler_precompiled/blob/main/PRECOMPILATION_GUIDE.md, 5 | # and I don't know enough to remove it 6 | [target.'cfg(target_os = "macos")'] 7 | rustflags = ["-C", "link-arg=-undefined", "-C", "link-arg=dynamic_lookup"] 8 | -------------------------------------------------------------------------------- /prqlc/bindings/prqlc-c/cbindgen.toml: -------------------------------------------------------------------------------- 1 | language = "C" 2 | 3 | header = '''/* 4 | * PRQL is a modern language for transforming data — a simple, powerful, pipelined SQL replacement 5 | * 6 | * License: Apache-2.0 7 | * Website: https://prql-lang.org/ 8 | */''' 9 | 10 | autogen_warning = "/* This file is autogenerated. Do not modify this file manually. */" 11 | 12 | namespace = "prqlc" 13 | 14 | after_includes = '#define FFI_SCOPE "PRQL"' 15 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__sort_2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "from albums\nselect { AA=album_id, artist_id }\nsort AA\nfilter AA >= 25\njoin artists (==artist_id)\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/sort_2.prql 5 | --- 6 | from albums 7 | select {AA = album_id, artist_id} 8 | sort AA 9 | filter AA >= 25 10 | join artists (==artist_id) 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__pipes__inner-transforms__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\ngroup {title, country} (\n aggregate {\n average salary,\n ct = count salary,\n }\n)\n" 4 | --- 5 | SELECT 6 | title, 7 | country, 8 | AVG(salary), 9 | COUNT(*) AS ct 10 | FROM 11 | employees 12 | GROUP BY 13 | title, 14 | country 15 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__s-strings__precedence-within-s-strings__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nderive {\n gross_salary = salary + benefits,\n daily_rate = s\"({gross_salary}) / 365\"\n}\n" 4 | --- 5 | SELECT 6 | *, 7 | salary + benefits AS gross_salary, 8 | (salary + benefits) / 365 AS daily_rate 9 | FROM 10 | employees 11 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/group_sort_derive_select_join.prql: -------------------------------------------------------------------------------- 1 | s"SELECT album_id,title,artist_id FROM albums" 2 | group {artist_id} (aggregate { album_title_count = count this.`title`}) 3 | sort {this.artist_id, this.album_title_count} 4 | derive {new_album_count = this.album_title_count} 5 | select {this.artist_id, this.new_album_count} 6 | join side:left ( s"SELECT artist_id,name as artist_name FROM artists" ) (this.artist_id == that.artist_id) 7 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__spec__name-resolution__translating-to-sql__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nderive {first_name, dept_id}\njoin d=departments (==dept_id)\nselect {first_name, d.title}\n" 4 | --- 5 | SELECT 6 | employees.first_name, 7 | d.title 8 | FROM 9 | employees 10 | INNER JOIN departments AS d ON employees.dept_id = d.dept_id 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__sort__examples__3.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nsort {s\"substr({first_name}, 2, 5)\"}\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | *, 8 | substr(first_name, 2, 5) AS _expr_0 9 | FROM 10 | employees 11 | ) 12 | SELECT 13 | * 14 | FROM 15 | table_0 16 | ORDER BY 17 | _expr_0 18 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__sort__ordering-guarantees__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nsort tenure\njoin locations (==employee_id)\n" 4 | --- 5 | SELECT 6 | employees.*, 7 | locations.* 8 | FROM 9 | employees 10 | INNER JOIN locations ON employees.employee_id = locations.employee_id 11 | ORDER BY 12 | employees.tenure 13 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__case__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nderive distance = case [\n city == \"Calgary\" => 0,\n city == \"Edmonton\" => 300,\n]\n" 4 | --- 5 | SELECT 6 | *, 7 | CASE 8 | WHEN city = 'Calgary' THEN 0 9 | WHEN city = 'Edmonton' THEN 300 10 | ELSE NULL 11 | END AS distance 12 | FROM 13 | employees 14 | -------------------------------------------------------------------------------- /web/playground/README.md: -------------------------------------------------------------------------------- 1 | # PRQL Playground 2 | 3 | A fast-feedback compiler from PRQL to SQL, hosted at 4 | 5 | 6 | To run locally, 7 | [set up a development environment](https://prql-lang.org/book/project/contributing/development.html), 8 | and then run: 9 | 10 | ```sh 11 | task web:run-playground 12 | ``` 13 | 14 | ...or use the commands which that command calls from 15 | [our Taskfile](../Taskfile.yaml). 16 | -------------------------------------------------------------------------------- /web/playground/src/reportWebVitals.js: -------------------------------------------------------------------------------- 1 | const reportWebVitals = (onPerfEntry) => { 2 | if (onPerfEntry && onPerfEntry instanceof Function) { 3 | import("web-vitals").then(({ getCLS, getFID, getFCP, getLCP, getTTFB }) => { 4 | getCLS(onPerfEntry); 5 | getFID(onPerfEntry); 6 | getFCP(onPerfEntry); 7 | getLCP(onPerfEntry); 8 | getTTFB(onPerfEntry); 9 | }); 10 | } 11 | }; 12 | 13 | export default reportWebVitals; 14 | -------------------------------------------------------------------------------- /.github/.codecov.yaml: -------------------------------------------------------------------------------- 1 | comment: false 2 | 3 | ignore: 4 | - "**/tests/**" 5 | 6 | coverage: 7 | status: 8 | project: 9 | default: 10 | removed_code_behavior: adjust_base 11 | # This disables report a success/failure. That's not helpful on `main` 12 | # and we get the success/failure from the patch status on PRs. 13 | informational: true 14 | 15 | patch: 16 | default: 17 | only_pulls: true 18 | -------------------------------------------------------------------------------- /grammars/prql-lezer/rollup.config.js: -------------------------------------------------------------------------------- 1 | import { nodeResolve } from "@rollup/plugin-node-resolve"; 2 | 3 | export default { 4 | input: "./src/parser.js", 5 | output: [ 6 | { 7 | format: "cjs", 8 | file: "./dist/index.cjs", 9 | }, 10 | { 11 | format: "es", 12 | file: "./dist/index.js", 13 | }, 14 | ], 15 | external(id) { 16 | return !/^[\.\/]/.test(id); 17 | }, 18 | plugins: [nodeResolve()], 19 | }; 20 | -------------------------------------------------------------------------------- /prqlc/bindings/php/src/MessageKind.php: -------------------------------------------------------------------------------- 1 | total * 2, true => total] 3 | select { customer_id, invoice_id, total } 4 | take 5 5 | append ( 6 | from invoice_items 7 | derive unit_price = case [unit_price < 1 => unit_price * 2, true => unit_price] 8 | select { invoice_line_id, invoice_id, unit_price } 9 | take 5 10 | ) 11 | select { a = customer_id * 2, b = math.round 1 (invoice_id * total) } 12 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__results__append_select_nulls.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# duckdb:skip\n# postgres:skip\n\nfrom invoices\nselect {an_id = invoice_id, name = null}\ntake 2\nappend (\n from employees\n select {an_id = null, name = first_name}\n take 2\n)\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/append_select_nulls.prql 5 | --- 6 | 1, 7 | 2, 8 | ,Andrew 9 | ,Nancy 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__pipes__ceci-nest-pas-une-pipe__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "[\n {a=2} # No pipe from line break before & after this list item\n]\nderive {\n c = 2 * a, # No pipe from line break before & after this tuple item\n}\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | 2 AS a 8 | ) 9 | SELECT 10 | a, 11 | 2 * a AS c 12 | FROM 13 | table_0 14 | -------------------------------------------------------------------------------- /grammars/emacs/README.md: -------------------------------------------------------------------------------- 1 | # Syntax highlighting for GNU Emacs 2 | 3 | This is a syntax highlighting file for GNU Emacs. 4 | 5 | ## Installation 6 | 7 | Copy the `prql-mode.el` file to: 8 | 9 | ~/.emacs.d/custom-modes/ 10 | 11 | Then, edit your `~/emacs.d/init.el` file and add the following: 12 | 13 | ```emacs 14 | (add-to-list 'load-path "~/.emacs.d/custom-modes/") 15 | (require 'prql-mode) 16 | 17 | (add-to-list 'auto-mode-alist '("\\.prql\\'" . prql-mode)) 18 | ``` 19 | -------------------------------------------------------------------------------- /grammars/nano/README.md: -------------------------------------------------------------------------------- 1 | # Syntax highlighting for GNU nano 2 | 3 | This is a syntax highlighting file the [GNU nano](https://nano-editor.org/) text 4 | editor. 5 | 6 | ## Installation 7 | 8 | To install place the `prql.nanorc` file in the `~/.nano/` directory and and 9 | include the following line in your `.nanorc` file. 10 | 11 | include "~/.nano/prql.nanorc" 12 | 13 | You can append it with this command: 14 | 15 | echo 'include "~/.nano/prql.nanorc"' >> ~/.nanorc 16 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compileall__genre_counts.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# clickhouse:skip (ClickHouse prefers aliases to column names https://github.com/PRQL/prql/issues/2827)\n# mssql:test\nlet genre_count = (\n from genres\n aggregate {a = count name}\n)\n\nfrom genre_count\nfilter a > 0\nselect a = -a\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/genre_counts.prql 5 | --- 6 | 7 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__results__genre_counts.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# clickhouse:skip (ClickHouse prefers aliases to column names https://github.com/PRQL/prql/issues/2827)\n# mssql:test\nlet genre_count = (\n from genres\n aggregate {a = count name}\n)\n\nfrom genre_count\nfilter a > 0\nselect a = -a\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/genre_counts.prql 5 | --- 6 | -25 7 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__window__window-functions-as-first-class-citizens__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nfilter salary < (average salary)\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | *, 8 | AVG(salary) OVER () AS _expr_0 9 | FROM 10 | employees 11 | ) 12 | SELECT 13 | * 14 | FROM 15 | table_0 16 | WHERE 17 | salary < _expr_0 18 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__case__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nderive distance = case [\n city == \"Calgary\" => 0,\n city == \"Edmonton\" => 300,\n true => \"Unknown\",\n]\n" 4 | --- 5 | SELECT 6 | *, 7 | CASE 8 | WHEN city = 'Calgary' THEN 0 9 | WHEN city = 'Edmonton' THEN 300 10 | ELSE 'Unknown' 11 | END AS distance 12 | FROM 13 | employees 14 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__literals__timestamps__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from commits\nderive first_prql_commit = @2020-01-01T13:19:55-08:00\nderive first_prql_commit_utc = @2020-01-02T21:19:55Z\n" 4 | --- 5 | SELECT 6 | *, 7 | TIMESTAMP '2020-01-01T13:19:55-0800' AS first_prql_commit, 8 | TIMESTAMP '2020-01-02T21:19:55Z' AS first_prql_commit_utc 9 | FROM 10 | commits 11 | -------------------------------------------------------------------------------- /grammars/prql-lezer/test/identifiers.txt: -------------------------------------------------------------------------------- 1 | # Basic identifier 2 | 3 | filter foo 4 | 5 | ==> 6 | 7 | Query(Pipeline(CallExpression(Identifier,ArgList(Identifier)))) 8 | 9 | 10 | # Identifier with underscore and digit 11 | 12 | filter foo_123 13 | 14 | ==> 15 | 16 | Query(Pipeline(CallExpression(Identifier,ArgList(Identifier)))) 17 | 18 | # Unicode identifier 19 | 20 | filter räksmörgås 21 | 22 | ==> 23 | 24 | Query(Pipeline(CallExpression(Identifier,ArgList(Identifier)))) 25 | -------------------------------------------------------------------------------- /web/book/src/reference/stdlib/transforms/derive.md: -------------------------------------------------------------------------------- 1 | # Derive 2 | 3 | Computes one or more new columns. 4 | 5 | ```prql no-eval 6 | derive { 7 | name = expression, 8 | # or 9 | column, 10 | } 11 | ``` 12 | 13 | ## Examples 14 | 15 | ```prql 16 | from employees 17 | derive gross_salary = salary + payroll_tax 18 | ``` 19 | 20 | ```prql 21 | from employees 22 | derive { 23 | gross_salary = salary + payroll_tax, 24 | gross_cost = gross_salary + benefits_cost 25 | } 26 | ``` 27 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/dbs/dockerfiles/glaredb.Dockerfile: -------------------------------------------------------------------------------- 1 | # syntax=docker/dockerfile:1.4 2 | 3 | # TODO: switch to `curlimages/curl` 4 | # glaredb binary releases are not compatible with alpine 5 | # So we can't use here now 6 | # https://github.com/GlareDB/glaredb/issues/1912 7 | FROM --platform=linux/amd64 docker.io/library/buildpack-deps:stable 8 | 9 | RUN < Result<(), Box> { 8 | let git = GitBuilder::default().describe(true, true, None).build()?; 9 | Emitter::default().add_instructions(&git)?.emit()?; 10 | Ok(()) 11 | } 12 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/data/chinook/genres.csv: -------------------------------------------------------------------------------- 1 | genre_id,name 2 | 1,Rock 3 | 2,Jazz 4 | 3,Metal 5 | 4,Alternative & Punk 6 | 5,Rock And Roll 7 | 6,Blues 8 | 7,Latin 9 | 8,Reggae 10 | 9,Pop 11 | 10,Soundtrack 12 | 11,Bossa Nova 13 | 12,Easy Listening 14 | 13,Heavy Metal 15 | 14,R&B/Soul 16 | 15,Electronica/Dance 17 | 16,World 18 | 17,Hip Hop/Rap 19 | 18,Science Fiction 20 | 19,TV Shows 21 | 20,Sci Fi & Fantasy 22 | 21,Drama 23 | 22,Comedy 24 | 23,Alternative 25 | 24,Classical 26 | 25,Opera 27 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/group_sort_filter_derive_select_join.prql: -------------------------------------------------------------------------------- 1 | s"SELECT album_id,title,artist_id FROM albums" 2 | group {artist_id} (aggregate { album_title_count = count this.`title`}) 3 | sort {this.artist_id, this.album_title_count} 4 | filter (this.album_title_count) > 10 5 | derive {new_album_count = this.album_title_count} 6 | select {this.artist_id, this.new_album_count} 7 | join side:left ( s"SELECT artist_id,name as artist_name FROM artists" ) (this.artist_id == that.artist_id) 8 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compileall__loop_01.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# clickhouse:skip (DB::Exception: Syntax error)\n# glaredb:skip (DataFusion does not support recursive CTEs https://github.com/apache/arrow-datafusion/issues/462)\nfrom [{n = 1}]\nselect n = n - 2\nloop (filter n < 4 | select n = n + 1)\nselect n = n * 2\nsort n\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/loop_01.prql 5 | --- 6 | 7 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__results__aggregation.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:skip\n# mysql:skip\n# clickhouse:skip\n# glaredb:skip (the string_agg function is not supported)\nfrom tracks\nfilter genre_id == 100\nderive empty_name = name == ''\naggregate {sum track_id, concat_array name, all empty_name, any empty_name}\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/aggregation.prql 5 | --- 6 | 0,,1,0 7 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__data__relation-literals__array-literals__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from [\n {a=5, b=false},\n {a=6, b=true},\n]\nfilter b == true\nselect a\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | 5 AS a, 8 | false AS b 9 | UNION 10 | ALL 11 | SELECT 12 | 6 AS a, 13 | true AS b 14 | ) 15 | SELECT 16 | a 17 | FROM 18 | table_0 19 | WHERE 20 | b = true 21 | -------------------------------------------------------------------------------- /.devcontainer/base-image/Dockerfile: -------------------------------------------------------------------------------- 1 | # syntax=docker/dockerfile:1.4 2 | 3 | FROM mcr.microsoft.com/devcontainers/rust:2-1-bookworm 4 | 5 | # ========= Install cargo-tools for non-root user (vscode) ========= 6 | USER vscode 7 | 8 | ARG cargo_crates 9 | 10 | RUN <<"EOF" 11 | curl -L --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/cargo-bins/cargo-binstall/main/install-from-binstall-release.sh | bash 12 | cargo binstall -y --locked ${cargo_crates} 13 | EOF 14 | 15 | USER root 16 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__distinct__remove-duplicates-from-each-group__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\ngroup {first_name, last_name} (take 1)\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | *, 8 | ROW_NUMBER() OVER (PARTITION BY first_name, last_name) AS _expr_0 9 | FROM 10 | employees 11 | ) 12 | SELECT 13 | * 14 | FROM 15 | table_0 16 | WHERE 17 | _expr_0 <= 1 18 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compileall__sort.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom e=employees\nfilter first_name != \"Mitchell\"\nsort {first_name, last_name}\n\n# joining may use HashMerge, which can undo ORDER BY\njoin manager=employees side:left (e.reports_to == manager.employee_id)\n\nselect {e.first_name, e.last_name, manager.first_name}\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/sort.prql 5 | --- 6 | 7 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__results__group_sort.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom tracks\nderive d = album_id + 1\ngroup d (\n aggregate {\n n1 = (track_id | sum),\n }\n)\nsort d\ntake 10\nselect { d1 = d, n1 }\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/group_sort.prql 5 | --- 6 | 2,91 7 | 3,2 8 | 4,12 9 | 5,148 10 | 6,450 11 | 7,572 12 | 8,678 13 | 9,973 14 | 10,644 15 | 11,1281 16 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__results__set_ops_remove.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nlet distinct = rel -> (from t = _param.rel | group {t.*} (take 1))\n\nfrom_text format:json '{ \"columns\": [\"a\"], \"data\": [[1], [2], [2], [3]] }'\ndistinct\nremove (from_text format:json '{ \"columns\": [\"a\"], \"data\": [[1], [2]] }')\nsort a\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/set_ops_remove.prql 5 | --- 6 | 3 7 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__data__relation-literals__array-literals__3.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from_text format:json \"\"\"\n[\n {\"a\": 1, \"m\": \"5\"},\n {\"a\": 4, \"n\": \"6\"}\n]\n\"\"\"\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | 1 AS a, 8 | '5' AS m 9 | UNION 10 | ALL 11 | SELECT 12 | 4 AS a, 13 | NULL AS m 14 | ) 15 | SELECT 16 | a, 17 | m 18 | FROM 19 | table_0 20 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__literals__numbers__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from numbers\nselect {\n small = 1.000_000_1,\n big = 5_000_000,\n huge = 5e9,\n binary = 0b0011,\n hex = 0x80,\n octal = 0o777,\n}\n" 4 | --- 5 | SELECT 6 | 1.0000001 AS small, 7 | 5000000 AS big, 8 | 5000000000.0 AS huge, 9 | 3 AS "binary", 10 | 128 AS hex, 11 | 511 AS octal 12 | FROM 13 | numbers 14 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__ranges__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from events\nfilter (created_at | in @1776-07-04..@1787-09-17)\nfilter (magnitude | in 50..100)\nderive is_northern = (latitude | in 0..)\n" 4 | --- 5 | SELECT 6 | *, 7 | latitude >= 0 AS is_northern 8 | FROM 9 | events 10 | WHERE 11 | created_at BETWEEN DATE '1776-07-04' AND DATE '1787-09-17' 12 | AND magnitude BETWEEN 50 AND 100 13 | -------------------------------------------------------------------------------- /grammars/raku/t/identifiers.rakutest: -------------------------------------------------------------------------------- 1 | use Test; 2 | use prql; 3 | 4 | plan 3; 5 | 6 | # Basic identifier 7 | ok PRQL.parse('filter foo'); 8 | #query(pipeline(call-expression(identifier,arg-list(identifier)))) 9 | 10 | # Identifier with underscore and digit 11 | ok PRQL.parse('filter foo_123'); 12 | #query(pipeline(call-expression(identifier,arg-list(identifier)))) 13 | 14 | # Unicode identifier 15 | ok PRQL.parse('filter räksmörgås'); 16 | #query(pipeline(call-expression(identifier,arg-list(identifier)))) 17 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__README__standard-library__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.sqlite\n\nfrom [{x = 13, y = 5}]\nselect {\n quotient = x / y,\n int_quotient = x // y,\n}\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | 13 AS x, 8 | 5 AS y 9 | ) 10 | SELECT 11 | (x * 1.0 / y) AS quotient, 12 | ROUND(ABS(x / y) - 0.5) * SIGN(x) * SIGN(y) AS int_quotient 13 | FROM 14 | table_0 15 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__f-strings__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from tracks\nselect length_str = f\"{length_seconds / 60} minutes\"\n" 4 | --- 5 | Error: 6 | ╭─[ :2:38 ] 7 | │ 8 | 2 │ select length_str = f"{length_seconds / 60} minutes" 9 | │ ┬ 10 | │ ╰── expected something else, '.', ':', or '}', but found " " 11 | ───╯ 12 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compileall__take.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom tracks\nsort {+track_id}\ntake 3..5\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/take.prql 5 | --- 6 | --- generic 7 | +++ mssql 8 | @@ -1,8 +1,8 @@ 9 | SELECT 10 | * 11 | FROM 12 | tracks 13 | ORDER BY 14 | - track_id 15 | -LIMIT 16 | - 3 OFFSET 2 17 | + track_id OFFSET 2 ROWS 18 | +FETCH FIRST 19 | + 3 ROWS ONLY 20 | -------------------------------------------------------------------------------- /web/book/src/reference/stdlib/transforms/filter.md: -------------------------------------------------------------------------------- 1 | # Filter 2 | 3 | Picks rows based on their values. 4 | 5 | ```prql no-eval 6 | filter boolean_expression 7 | ``` 8 | 9 | ## Examples 10 | 11 | ```prql 12 | from employees 13 | filter age > 25 14 | ``` 15 | 16 | ```prql 17 | from employees 18 | filter (age > 25 || department != "IT") 19 | ``` 20 | 21 | ```prql 22 | from employees 23 | filter (department | in ["IT", "HR"]) 24 | ``` 25 | 26 | ```prql 27 | from employees 28 | filter (age | in 25..40) 29 | ``` 30 | -------------------------------------------------------------------------------- /web/playground/public/manifest.json: -------------------------------------------------------------------------------- 1 | { 2 | "background_color": "#ffffff", 3 | "display": "standalone", 4 | "icons": [ 5 | { 6 | "sizes": "64x64 32x32 24x24 16x16", 7 | "src": "favicon.ico", 8 | "type": "image/x-icon" 9 | }, 10 | { 11 | "sizes": "192x192", 12 | "src": "icon192.png", 13 | "type": "image/png" 14 | } 15 | ], 16 | "name": "PRQL Playground", 17 | "short_name": "PRQL Playground", 18 | "start_url": ".", 19 | "theme_color": "#222222" 20 | } 21 | -------------------------------------------------------------------------------- /web/website/themes/prql-theme/layouts/_default/single.html: -------------------------------------------------------------------------------- 1 | {{ define "main" }} 2 |
3 |
4 | {{ if not .Params.no_head }} 5 |

{{ .Title }}

6 | {{ if .Date }} 7 | 10 | {{ end }} 11 | {{ end }} 12 | 13 | {{ .Content }} 14 |
15 |
16 | {{ end }} 17 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compileall__group_sort_limit_take.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# Compute the 3 longest songs for each genre and sort by genre\n# mssql:test\nfrom tracks\nselect {genre_id,milliseconds}\ngroup {genre_id} (\n sort {-milliseconds}\n take 3\n)\njoin genres (==genre_id)\nselect {name, milliseconds}\nsort {+name,-milliseconds}\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/group_sort_limit_take.prql 5 | --- 6 | 7 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__declarations__functions__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "let interp = low:0 high x -> (x - low) / (high - low)\n\nfrom students\nderive {\n sat_proportion_1 = (interp 1600 sat_score),\n sat_proportion_2 = (interp low:0 1600 sat_score),\n}\n" 4 | --- 5 | SELECT 6 | *, 7 | (sat_score - 0) / (1600 - 0) AS sat_proportion_1, 8 | (sat_score - 0) / (1600 - 0) AS sat_proportion_2 9 | FROM 10 | students 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__declarations__functions__piping-values-into-functions__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "let fahrenheit_to_celsius = temp -> (temp - 32) / 1.8\nlet interp = low:0 high x -> (x - low) / (high - low)\n\nfrom kettles\nderive boiling_proportion = (temp_c | fahrenheit_to_celsius | interp 100)\n" 4 | --- 5 | SELECT 6 | *, 7 | ((temp_c - 32) / 1.8 - 0) / (100 - 0) AS boiling_proportion 8 | FROM 9 | kettles 10 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__declarations__variables__variables--__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "let grouping = s\"\"\"\n SELECT SUM(a)\n FROM tbl\n GROUP BY\n GROUPING SETS\n ((b, c, d), (d), (b, d))\n\"\"\"\n\nfrom grouping\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | SUM(a) 8 | FROM 9 | tbl 10 | GROUP BY 11 | GROUPING SETS ((b, c, d), (d), (b, d)) 12 | ) 13 | SELECT 14 | * 15 | FROM 16 | table_0 17 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__join__examples__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from tracks\njoin side:left artists (\n # This adds a `country` condition, as an alternative to filtering\n artists.id==tracks.artist_id && artists.country=='UK'\n)\n" 4 | --- 5 | SELECT 6 | tracks.*, 7 | artists.* 8 | FROM 9 | tracks 10 | LEFT OUTER JOIN artists ON artists.id = tracks.artist_id 11 | AND artists.country = 'UK' 12 | -------------------------------------------------------------------------------- /web/website/data/examples/joins.yaml: -------------------------------------------------------------------------------- 1 | label: Joins 2 | prql: | 3 | from employees 4 | join b=benefits (==employee_id) 5 | join side:left p=positions (p.id==employees.employee_id) 6 | select {employees.employee_id, p.role, b.vision_coverage} 7 | sql: | 8 | SELECT 9 | employees.employee_id, 10 | p.role, 11 | b.vision_coverage 12 | FROM 13 | employees 14 | INNER JOIN benefits AS b ON employees.employee_id = b.employee_id 15 | LEFT OUTER JOIN positions AS p ON p.id = employees.employee_id 16 | -------------------------------------------------------------------------------- /web/book/src/project/integrations/prefect.md: -------------------------------------------------------------------------------- 1 | # Prefect 2 | 3 | Because [Prefect](https://www.prefect.io/) is in native Python, it's extremely 4 | easy to integrate with PRQL. 5 | 6 | With a Postgres Task, replace: 7 | 8 | ```python 9 | PostgresExecute.run(..., query=sql) 10 | ``` 11 | 12 | ...with... 13 | 14 | ```python 15 | PostgresExecute.run(..., query=prql_python.compile(prql)) 16 | ``` 17 | 18 | We're big fans of Prefect, and if there is anything that would make the 19 | integration easier, please open an issue. 20 | -------------------------------------------------------------------------------- /prqlc/bindings/dotnet/PrqlCompiler/NativePrqlCompilerOptions.cs: -------------------------------------------------------------------------------- 1 | namespace Prql.Compiler 2 | { 3 | internal struct NativePrqlCompilerOptions 4 | { 5 | public bool Format; 6 | public string Target; 7 | public bool SignatureComment; 8 | 9 | public NativePrqlCompilerOptions(PrqlCompilerOptions options) 10 | { 11 | Format = options.Format; 12 | Target = options.Target; 13 | SignatureComment = options.SignatureComment; 14 | } 15 | } 16 | } 17 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__window__example__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\ngroup employee_id (\n sort month\n window rolling:12 (\n derive {trail_12_m_comp = sum paycheck}\n )\n)\n" 4 | --- 5 | SELECT 6 | *, 7 | SUM(paycheck) OVER ( 8 | PARTITION BY employee_id 9 | ORDER BY 10 | month ROWS BETWEEN 11 PRECEDING AND CURRENT ROW 11 | ) AS trail_12_m_comp 12 | FROM 13 | employees 14 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__group_sort.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom tracks\nderive d = album_id + 1\ngroup d (\n aggregate {\n n1 = (track_id | sum),\n }\n)\nsort d\ntake 10\nselect { d1 = d, n1 }\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/group_sort.prql 5 | --- 6 | from tracks 7 | derive d = album_id + 1 8 | group d (aggregate {n1 = (track_id | sum)}) 9 | sort d 10 | take 10 11 | select {d1 = d, n1} 12 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__results__loop_01.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# clickhouse:skip (DB::Exception: Syntax error)\n# glaredb:skip (DataFusion does not support recursive CTEs https://github.com/apache/arrow-datafusion/issues/462)\nfrom [{n = 1}]\nselect n = n - 2\nloop (filter n < 4 | select n = n + 1)\nselect n = n * 2\nsort n\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/loop_01.prql 5 | --- 6 | -2 7 | 0 8 | 2 9 | 4 10 | 6 11 | 8 12 | -------------------------------------------------------------------------------- /web/book/comparison-table.css: -------------------------------------------------------------------------------- 1 | /* Styling for Tables */ 2 | 3 | .comparison { 4 | display: flex; 5 | flex-wrap: wrap; 6 | gap: 1rem; 7 | width: 100%; 8 | padding-bottom: 3rem; 9 | } 10 | .comparison > div { 11 | flex: 1 0 0; 12 | display: flex; 13 | flex-direction: column; 14 | padding-bottom: 0.5rem; 15 | } 16 | .comparison h4 { 17 | margin: 0; 18 | } 19 | .comparison pre { 20 | margin: 0; 21 | flex-grow: 1; 22 | } 23 | .comparison code { 24 | padding: 0.5rem; 25 | min-height: calc(100% - 1rem); 26 | } 27 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__s-strings__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from de=dept_emp\njoin s=salaries side:left (s.emp_no == de.emp_no && s\"\"\"\n ({s.from_date}, {s.to_date})\n OVERLAPS\n ({de.from_date}, {de.to_date})\n\"\"\")\n" 4 | --- 5 | SELECT 6 | de.*, 7 | s.* 8 | FROM 9 | dept_emp AS de 10 | LEFT OUTER JOIN salaries AS s ON s.emp_no = de.emp_no 11 | AND (s.from_date, s.to_date) OVERLAPS (de.from_date, de.to_date) 12 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__keywords__quoting__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.bigquery\n\nfrom `project-foo.dataset.table`\njoin `project-bar.dataset.table` (==col_bax)\n" 4 | --- 5 | SELECT 6 | `project-foo.dataset.table`.*, 7 | `project-bar.dataset.table`.* 8 | FROM 9 | `project-foo.dataset.table` 10 | INNER JOIN `project-bar.dataset.table` ON `project-foo.dataset.table`.col_bax = `project-bar.dataset.table`.col_bax 11 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__group__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\ngroup role (\n sort join_date # taken from above\n take 1\n)\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | *, 8 | ROW_NUMBER() OVER ( 9 | PARTITION BY role 10 | ORDER BY 11 | join_date 12 | ) AS _expr_0 13 | FROM 14 | employees 15 | ) 16 | SELECT 17 | * 18 | FROM 19 | table_0 20 | WHERE 21 | _expr_0 <= 1 22 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compile__read_csv.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# sqlite:skip\n# postgres:skip\n# mysql:skip\nfrom (read_csv \"data_file_root/media_types.csv\")\nsort media_type_id\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/read_csv.prql 5 | --- 6 | WITH table_0 AS ( 7 | SELECT 8 | * 9 | FROM 10 | read_csv('data_file_root/media_types.csv') 11 | ) 12 | SELECT 13 | * 14 | FROM 15 | table_0 16 | ORDER BY 17 | media_type_id 18 | -------------------------------------------------------------------------------- /prqlc/bindings/java/Cargo.toml: -------------------------------------------------------------------------------- 1 | [package] 2 | name = "prql-java" 3 | publish = false 4 | 5 | edition.workspace = true 6 | license.workspace = true 7 | repository.workspace = true 8 | rust-version.workspace = true 9 | version.workspace = true 10 | 11 | [lib] 12 | bench = false 13 | crate-type = ["cdylib"] 14 | doc = false 15 | doctest = false 16 | test = false 17 | 18 | [dependencies] 19 | jni = "0.21.1" 20 | prqlc = {path = "../../prqlc", default-features = false} 21 | 22 | [package.metadata.release] 23 | tag-name = "{{version}}" 24 | tag-prefix = "" 25 | -------------------------------------------------------------------------------- /web/book/tests/documentation/main.rs: -------------------------------------------------------------------------------- 1 | #![cfg(not(target_family = "wasm"))] 2 | 3 | /// As well as the examples in the book, we also test the examples in the 4 | /// website & README in this integration test binary. 5 | mod book; 6 | mod readme; 7 | mod website; 8 | 9 | use ::prqlc::Options; 10 | 11 | fn compile(prql: &str) -> Result { 12 | prqlc::compile( 13 | prql, 14 | &Options::default() 15 | .no_signature() 16 | .with_display(prqlc::DisplayOptions::Plain), 17 | ) 18 | } 19 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__declarations__functions__piping-values-into-functions__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "let interp = low:0 high x -> (x - low) / (high - low)\n\nfrom students\nderive {\n sat_proportion_1 = (sat_score | interp 1600),\n sat_proportion_2 = (sat_score | interp low:0 1600),\n}\n" 4 | --- 5 | SELECT 6 | *, 7 | (sat_score - 0) / (1600 - 0) AS sat_proportion_1, 8 | (sat_score - 0) / (1600 - 0) AS sat_proportion_2 9 | FROM 10 | students 11 | -------------------------------------------------------------------------------- /prqlc/bindings/php/src/SourceLocation.php: -------------------------------------------------------------------------------- 1 | @2021-01-01 6 | group country ( 7 | aggregate {max_salary = max salary} 8 | ) 9 | # ...and `filter` after aggregations! 10 | filter max_salary > 100_000 11 | sql: | 12 | SELECT 13 | country, 14 | MAX(salary) AS max_salary 15 | FROM 16 | employees 17 | WHERE 18 | start_date > DATE '2021-01-01' 19 | GROUP BY 20 | country 21 | HAVING 22 | MAX(salary) > 100000 23 | -------------------------------------------------------------------------------- /web/website/data/examples/top-n.yaml: -------------------------------------------------------------------------------- 1 | label: Top N by group 2 | prql: | 3 | # Most recent employee in each role 4 | # Quite difficult in SQL... 5 | from employees 6 | group role ( 7 | sort join_date 8 | take 1 9 | ) 10 | sql: | 11 | WITH table_0 AS ( 12 | SELECT 13 | *, 14 | ROW_NUMBER() OVER ( 15 | PARTITION BY role 16 | ORDER BY 17 | join_date 18 | ) AS _expr_0 19 | FROM 20 | employees 21 | ) 22 | SELECT 23 | * 24 | FROM 25 | table_0 26 | WHERE 27 | _expr_0 <= 1 28 | -------------------------------------------------------------------------------- /.prettierignore: -------------------------------------------------------------------------------- 1 | # prettier respects the root `.gitignore` file, so prefer that for files which 2 | # we also want to ignore from our version control. This should contain files we 3 | # want to track but not format. 4 | 5 | **/*.rs 6 | **/*.min.* 7 | 8 | /web/book/theme/highlight.js 9 | /web/playground/build 10 | /web/website/public 11 | /web/book/book 12 | 13 | # TODO: move these into content out of layouts 14 | /web/website/themes/prql-theme/layouts/_default/_markup/render-link.html 15 | 16 | # TODO: fix the go-template issue in `.prettierrc.yaml` 17 | **/*.html 18 | -------------------------------------------------------------------------------- /web/book/src/project/bindings/r.md: -------------------------------------------------------------------------------- 1 | # R (prqlr) 2 | 3 | R bindings for `prqlc`. 4 | 5 | `prqlr` also includes `knitr` (R Markdown and Quarto) integration, which allows 6 | us to easily create documents with the PRQL conversion results embedded in. 7 | 8 | Check out for more context. 9 | 10 | > [!NOTE] `prqlr` is generously maintained by 11 | > [@eitsupi](https://github.com/eitsupi) in the 12 | > [PRQL/prqlc-r](https://github.com/PRQL/prqlc-r) repo. 13 | 14 | ## Installation 15 | 16 | ```r 17 | install.packages("prqlr") 18 | ``` 19 | -------------------------------------------------------------------------------- /web/book/src/project/integrations/README.md: -------------------------------------------------------------------------------- 1 | # Integrations 2 | 3 | PRQL is building integrations with lots of external tools, including: 4 | 5 | - [`prqlc` CLI](./prqlc-cli.md) - Rust compiler for the command line 6 | - [ClickHouse](./clickhouse.md) 7 | - [Jupyter](./jupyter.md) 8 | - [DuckDB](./duckdb.md) 9 | - [QStudio](./qstudio.md) 10 | - [Prefect](./prefect.md) 11 | - [VS Code](./vscode.md) 12 | - [PostgreSQL](./postgresql.md) 13 | - [Databend](./databend.md) 14 | - [Rill](./rill.md) 15 | - [Syntax highlighting](./syntax-highlighting.md) for many popular tools. 16 | -------------------------------------------------------------------------------- /web/prql-codemirror-demo/README.md: -------------------------------------------------------------------------------- 1 | # CodeMirror with PRQL demo 2 | 3 | This is a demo of CodeMirror with PRQL. We don't have any published `lang-prql` 4 | or `prql-lezer` package yet. 5 | 6 | ## Instructions 7 | 8 | Build `prql-lezer` then copy the files from `/grammars/prql-lezer/dist/` to 9 | `src/lang-prql/prql-lezer/`. 10 | 11 | ``` 12 | mkdir src/lang-prql/prql-lezer 13 | cd ../../grammars/prql-lezer/ 14 | npm run build 15 | cp dist/* ../../web/prql-codemirror-demo/src/lang-prql/prql-lezer/ 16 | cd ../../web/prql-codemirror-demo/ 17 | npm run dev 18 | ``` 19 | -------------------------------------------------------------------------------- /prqlc/bindings/prqlc-python/Taskfile.yaml: -------------------------------------------------------------------------------- 1 | version: "3" 2 | 3 | vars: 4 | build_dir: "../../../target/python" 5 | 6 | tasks: 7 | build: 8 | desc: Build 9 | vars: 10 | profile: "dev" 11 | cmds: 12 | - cmd: | 13 | maturin build \ 14 | --profile={{.profile}} \ 15 | --out={{.build_dir}} 16 | 17 | test: 18 | desc: A fast test used for feedback during compiler development 19 | cmds: 20 | # uv run automatically includes dev dependencies from dependency-groups 21 | - uv run pytest python/tests 22 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__results__take.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom tracks\nsort {+track_id}\ntake 3..5\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/take.prql 5 | --- 6 | 3,Fast As a Shark,3,2,1,F. Baltes, S. Kaufman, U. Dirkscneider & W. Hoffman,230619,3990994,0.99 7 | 4,Restless and Wild,3,2,1,F. Baltes, R.A. Smith-Diesel, S. Kaufman, U. Dirkscneider & W. Hoffman,252051,4331779,0.99 8 | 5,Princess of the Dawn,3,2,1,Deaffy & R.A. Smith-Diesel,375418,6290521,0.99 9 | -------------------------------------------------------------------------------- /web/book/book.toml: -------------------------------------------------------------------------------- 1 | [book] 2 | description = "Modern language for transforming data — a simple, powerful, pipelined SQL replacement" 3 | language = "en" 4 | title = "PRQL language book" 5 | 6 | [output.html] 7 | additional-css = ["comparison-table.css"] 8 | additional-js = ["highlight-prql.js"] 9 | git-repository-url = "https://github.com/PRQL/prql" 10 | 11 | [preprocessor.prql] 12 | # This is required because mdbook-prql isn't necessarily installed; maybe 13 | # there's a better way. 14 | # 15 | command = "cargo run --bin mdbook-prql" 16 | 17 | [preprocessor.footnote] 18 | -------------------------------------------------------------------------------- /web/book/src/reference/syntax/case.md: -------------------------------------------------------------------------------- 1 | # Case 2 | 3 | Search for the first condition that evaluates to `true` and return its 4 | associated value. If none of the conditions match, `null` is returned. 5 | 6 | ```prql 7 | from employees 8 | derive distance = case [ 9 | city == "Calgary" => 0, 10 | city == "Edmonton" => 300, 11 | ] 12 | ``` 13 | 14 | To set a default, a `true` condition can be used: 15 | 16 | ```prql 17 | from employees 18 | derive distance = case [ 19 | city == "Calgary" => 0, 20 | city == "Edmonton" => 300, 21 | true => "Unknown", 22 | ] 23 | ``` 24 | -------------------------------------------------------------------------------- /web/playground/src/output/Output.css: -------------------------------------------------------------------------------- 1 | .tab-content.arrow { 2 | padding: 1.5rem; 3 | overflow-x: scroll; 4 | } 5 | 6 | .arrow table { 7 | border-collapse: collapse; 8 | } 9 | 10 | .arrow table td, 11 | .arrow table th { 12 | min-width: 2rem; 13 | padding: 2px 0.5rem; 14 | text-align: right; 15 | } 16 | 17 | .arrow table thead { 18 | border-bottom: 1px solid #444; 19 | } 20 | 21 | .arrow table tbody tr:not(:first-child) td { 22 | border-top: 1px solid #444; 23 | } 24 | 25 | /* .arrow table tbody tr:nth-child(2n) td { 26 | background-color: #333; 27 | } */ 28 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__distinct_on.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom tracks\nselect {genre_id, media_type_id, album_id}\ngroup {genre_id, media_type_id} (sort {-album_id} | take 1)\nsort {-genre_id, media_type_id}\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/distinct_on.prql 5 | --- 6 | from tracks 7 | select {genre_id, media_type_id, album_id} 8 | group {genre_id, media_type_id} ( 9 | sort {-album_id} 10 | take 1 11 | ) 12 | sort {-genre_id, media_type_id} 13 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__group_all.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom a=albums\ntake 10\njoin tracks (==album_id)\ngroup {a.album_id, a.title} (aggregate price = (sum tracks.unit_price | math.round 2))\nsort album_id\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/group_all.prql 5 | --- 6 | from a = albums 7 | take 10 8 | join tracks (==album_id) 9 | group {a.album_id, a.title} (aggregate price = ( 10 | sum tracks.unit_price 11 | math.round 2 12 | )) 13 | sort album_id 14 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__loop__examples__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from [{n = 1}]\nloop (\n filter n<4\n select n = n+1\n)\n\n# returns [1, 2, 3, 4]\n" 4 | --- 5 | WITH RECURSIVE table_0 AS ( 6 | SELECT 7 | 1 AS n 8 | ), 9 | table_1 AS ( 10 | SELECT 11 | n 12 | FROM 13 | table_0 14 | UNION 15 | ALL 16 | SELECT 17 | n + 1 18 | FROM 19 | table_1 20 | WHERE 21 | n < 4 22 | ) 23 | SELECT 24 | n 25 | FROM 26 | table_1 AS table_2 27 | -------------------------------------------------------------------------------- /grammars/raku/META6.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "PRQL", 3 | "version": "0.0.1", 4 | "description": "Grammar for PRQL", 5 | "tags": ["data", "grammar", "pipeline", "sql"], 6 | "source-url": "https://github.com/PRQL/prql/", 7 | "support": { 8 | "source": "https://github.com/PRQL/prql/", 9 | "bugtracker": "https://github.com/PRQL/prql/issues" 10 | }, 11 | "api": "1.0", 12 | "production": false, 13 | "auth": "github:PRQL", 14 | "license": "Artistic-2.0", 15 | "provides": { 16 | "prql": "lib/prql.rakumod" 17 | }, 18 | "raku": "6.*", 19 | "meta-version": "1" 20 | } 21 | -------------------------------------------------------------------------------- /prqlc/prqlc-macros/Cargo.toml: -------------------------------------------------------------------------------- 1 | [package] 2 | description = "Macros for PRQL compilation at build time" 3 | name = "prqlc-macros" 4 | 5 | edition.workspace = true 6 | license.workspace = true 7 | repository.workspace = true 8 | rust-version.workspace = true 9 | version.workspace = true 10 | 11 | [lib] 12 | bench = false 13 | doctest = false 14 | proc-macro = true 15 | test = false 16 | 17 | [dependencies] 18 | prqlc = {path = "../prqlc", default-features = false, version = "0.13.9" } 19 | syn = "2.0.111" 20 | 21 | [package.metadata.release] 22 | tag-name = "{{version}}" 23 | tag-prefix = "" 24 | -------------------------------------------------------------------------------- /prqlc/prqlc-parser/src/parser/pr/mod.rs: -------------------------------------------------------------------------------- 1 | //! PR, or "Parser Representation" is an AST representation of parsed PRQL. It 2 | //! takes LR tokens and converts them into a more structured form which 3 | //! understands expressions, such as tuples & functions. 4 | 5 | pub use expr::*; 6 | pub use ident::*; 7 | pub use ops::*; 8 | pub use stmt::*; 9 | pub use types::*; 10 | 11 | // re-export Literal from LR, since it's encapsulated in TyKind 12 | pub use crate::lexer::lr::Literal; 13 | pub use crate::span::Span; 14 | 15 | mod expr; 16 | mod ident; 17 | mod ops; 18 | mod stmt; 19 | mod types; 20 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__results__sort_3.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "from [{track_id=0, album_id=1, genre_id=2}]\nselect { AA=track_id, album_id, genre_id }\nsort AA\njoin side:left [{album_id=1, album_title=\"Songs\"}] (==album_id)\nselect { AA, AT = album_title ?? \"unknown\", genre_id }\nfilter AA < 25\njoin side:left [{genre_id=1, genre_title=\"Rock\"}] (==genre_id)\nselect { AA, AT, GT = genre_title ?? \"unknown\" }\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/sort_3.prql 5 | --- 6 | 0,Songs,unknown 7 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__distinct__remove-duplicates-from-each-group__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "# youngest employee from each department\nfrom employees\ngroup department (\n sort age\n take 1\n)\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | *, 8 | ROW_NUMBER() OVER ( 9 | PARTITION BY department 10 | ORDER BY 11 | age 12 | ) AS _expr_0 13 | FROM 14 | employees 15 | ) 16 | SELECT 17 | * 18 | FROM 19 | table_0 20 | WHERE 21 | _expr_0 <= 1 22 | -------------------------------------------------------------------------------- /web/website/data/examples/expressions.yaml: -------------------------------------------------------------------------------- 1 | label: Expressions 2 | prql: | 3 | from track_plays 4 | derive { 5 | finished = started - unfinished, 6 | fin_share = finished / started, # Use previous definitions 7 | fin_ratio = fin_share / (1-fin_share), # BTW, hanging commas are optional! 8 | } 9 | 10 | sql: | 11 | SELECT 12 | *, 13 | started - unfinished AS finished, 14 | (started - unfinished) / started AS fin_share, 15 | (started - unfinished) / started / (1 - (started - unfinished) / started) 16 | AS fin_ratio 17 | FROM 18 | track_plays 19 | -------------------------------------------------------------------------------- /grammars/vim/README.md: -------------------------------------------------------------------------------- 1 | # Syntax highlighting for Vim 2 | 3 | This is a syntax highlighting file for Vim and Neovim. 4 | 5 | ## Installation 6 | 7 | ### For Vim 8 | 9 | Copy the `prql.vim` file to: 10 | 11 | ~/.vim/syntax/ 12 | 13 | Then, edit your `~/.vimrc` file and add the following: 14 | 15 | ```vim 16 | augroup PrqlFileType 17 | autocmd! 18 | autocmd BufRead,BufNewFile *.prql setfiletype prql 19 | augroup END 20 | ``` 21 | 22 | ### For Neovim 23 | 24 | Copy the `prql.vim` file to: 25 | 26 | ~/.config/nvim/syntax/ 27 | 28 | Then, edit your `~/.config/nvim/init.vim` file. 29 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__data__relation-literals__array-literals__2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from_text \"\"\"\na,b,c\n1,2,3\n4,5,6\n\"\"\"\nderive {\n d = b + c,\n answer = 20 * 2 + 2,\n}\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | '1' AS a, 8 | '2' AS b, 9 | '3' AS c 10 | UNION 11 | ALL 12 | SELECT 13 | '4' AS a, 14 | '5' AS b, 15 | '6' AS c 16 | ) 17 | SELECT 18 | a, 19 | b, 20 | c, 21 | b + c AS d, 22 | 20 * 2 + 2 AS answer 23 | FROM 24 | table_0 25 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__README__standard-library__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from employees\nderive {\n gross_salary = (salary + payroll_tax | as int),\n gross_salary_rounded = (gross_salary | math.round 0),\n time = s\"NOW()\", # an s-string, given no `now` function exists in PRQL\n}\n" 4 | --- 5 | SELECT 6 | *, 7 | CAST(salary + payroll_tax AS int) AS gross_salary, 8 | ROUND(CAST(salary + payroll_tax AS int), 0) AS gross_salary_rounded, 9 | NOW() AS time 10 | FROM 11 | employees 12 | -------------------------------------------------------------------------------- /.markdownlint-cli2.yaml: -------------------------------------------------------------------------------- 1 | config: 2 | # We use prettier for line length & wrapping 3 | MD013: false 4 | # Code block style — generally this is fine, but it has false positives on 5 | # footnotes. See below re markdown-it-footnote issue. If we could resolve 6 | # that, we could turn this back on. 7 | MD046: false 8 | # markdownItPlugins: 9 | # 10 | # Doesn't seem to help with some issues — if someone wants to help resolve then 11 | # great, but it's no huge stress to have some false positives. 12 | # 13 | # https://github.com/DavidAnson/markdownlint/issues/689 14 | # - ["markdown-it-footnote"] 15 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__loop_01.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# clickhouse:skip (DB::Exception: Syntax error)\n# glaredb:skip (DataFusion does not support recursive CTEs https://github.com/apache/arrow-datafusion/issues/462)\nfrom [{n = 1}]\nselect n = n - 2\nloop (filter n < 4 | select n = n + 1)\nselect n = n * 2\nsort n\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/loop_01.prql 5 | --- 6 | from [{n = 1}] 7 | select n = n - 2 8 | loop (filter n < 4 | select n = n + 1) 9 | select n = n * 2 10 | sort n 11 | -------------------------------------------------------------------------------- /prqlc/prqlc/src/semantic/resolver/snapshots/prqlc__semantic__resolver__test__functions_pipeline.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/src/semantic/resolver/mod.rs 3 | expression: "resolve_derive(r#\"\n from a\n derive one = (foo | sum)\n \"#).unwrap()" 4 | --- 5 | - RqOperator: 6 | name: std.sum 7 | args: 8 | - Ident: 9 | - this 10 | - a 11 | - foo 12 | span: "1:46-49" 13 | ty: 14 | kind: 15 | Array: ~ 16 | span: "0:1699-1701" 17 | name: array 18 | span: "1:52-55" 19 | alias: one 20 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__append_select_nulls.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# duckdb:skip\n# postgres:skip\n\nfrom invoices\nselect {an_id = invoice_id, name = null}\ntake 2\nappend (\n from employees\n select {an_id = null, name = first_name}\n take 2\n)\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/append_select_nulls.prql 5 | --- 6 | from invoices 7 | select {an_id = invoice_id, name = null} 8 | take 2 9 | append ( 10 | from employees 11 | select {an_id = null, name = first_name} 12 | take 2 13 | ) 14 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__data__relation-literals__array-literals__4.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from_text format:json \"\"\"\n{\n \"columns\": [\"a\", \"b\", \"c\"],\n \"data\": [\n [1, \"x\", false],\n [4, \"y\", null]\n ]\n}\n\"\"\"\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | 1 AS a, 8 | 'x' AS b, 9 | false AS c 10 | UNION 11 | ALL 12 | SELECT 13 | 4 AS a, 14 | 'y' AS b, 15 | NULL AS c 16 | ) 17 | SELECT 18 | a, 19 | b, 20 | c 21 | FROM 22 | table_0 23 | -------------------------------------------------------------------------------- /prqlc/bindings/dotnet/PrqlCompiler/MessageKind.cs: -------------------------------------------------------------------------------- 1 | using System; 2 | 3 | namespace Prql.Compiler 4 | { 5 | /// 6 | /// Compile message kind. Currently only Error is implemented. 7 | /// 8 | [Serializable] 9 | public enum MessageKind 10 | { 11 | /// 12 | /// Error message. 13 | /// 14 | Error, 15 | /// 16 | /// Warning message. 17 | /// 18 | Warning, 19 | /// 20 | /// Lint message. 21 | /// 22 | Lint 23 | } 24 | } 25 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__operators__division-and-integer-division__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.sqlite\n\nfrom [\n {a = 5, b = 2},\n {a = 5, b = -2},\n]\nselect {\n div_out = a / b,\n int_div_out = a // b,\n}\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | 5 AS a, 8 | 2 AS b 9 | UNION 10 | ALL 11 | SELECT 12 | 5 AS a, 13 | -2 AS b 14 | ) 15 | SELECT 16 | (a * 1.0 / b) AS div_out, 17 | ROUND(ABS(a / b) - 0.5) * SIGN(a) * SIGN(b) AS int_div_out 18 | FROM 19 | table_0 20 | -------------------------------------------------------------------------------- /web/website/data/examples/hero.yaml: -------------------------------------------------------------------------------- 1 | prql: | 2 | from invoices 3 | filter invoice_date >= @1970-01-16 4 | derive { 5 | transaction_fees = 0.8, 6 | income = total - transaction_fees 7 | } 8 | filter income > 1 9 | group customer_id ( 10 | aggregate { 11 | average total, 12 | sum_income = sum income, 13 | ct = count total, 14 | } 15 | ) 16 | sort {-sum_income} 17 | take 10 18 | join c=customers (==customer_id) 19 | derive name = f"{c.last_name}, {c.first_name}" 20 | select { 21 | c.customer_id, name, sum_income 22 | } 23 | derive db_version = s"version()" 24 | -------------------------------------------------------------------------------- /prqlc/bindings/prqlc-c/examples/minimal-cpp/main.cpp: -------------------------------------------------------------------------------- 1 | #include 2 | #include 3 | 4 | #include "prqlc.hpp" 5 | 6 | using namespace prqlc; 7 | 8 | void print_result(CompileResult res) { 9 | if (strcmp(res.output, "") == 0) { 10 | std::cout << "Output: \n\n"; 11 | } else { 12 | std::cout << "Output:\n\n" << res.output; 13 | } 14 | } 15 | 16 | int main() { 17 | const auto prql_query = "from albums | select {album_id, title} | take 3"; 18 | 19 | CompileResult res = compile(prql_query, nullptr); 20 | print_result(res); 21 | result_destroy(res); 22 | 23 | return 0; 24 | } 25 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__genre_counts.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# clickhouse:skip (ClickHouse prefers aliases to column names https://github.com/PRQL/prql/issues/2827)\n# mssql:test\nlet genre_count = (\n from genres\n aggregate {a = count name}\n)\n\nfrom genre_count\nfilter a > 0\nselect a = -a\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/genre_counts.prql 5 | --- 6 | let genre_count = ( 7 | from genres 8 | aggregate {a = count name} 9 | ) 10 | 11 | from genre_count 12 | filter a > 0 13 | select a = -a 14 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compile__constants_only.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "from genres\ntake 10\nfilter true\ntake 20\nfilter true\nselect d = 10\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/constants_only.prql 5 | --- 6 | WITH table_1 AS ( 7 | SELECT 8 | NULL 9 | FROM 10 | genres 11 | LIMIT 12 | 10 13 | ), table_0 AS ( 14 | SELECT 15 | NULL 16 | FROM 17 | table_1 18 | WHERE 19 | true 20 | LIMIT 21 | 20 22 | ) 23 | SELECT 24 | 10 AS d 25 | FROM 26 | table_0 27 | WHERE 28 | true 29 | -------------------------------------------------------------------------------- /web/book/tests/documentation/readme.rs: -------------------------------------------------------------------------------- 1 | use regex::Regex; 2 | 3 | use super::compile; 4 | 5 | #[test] 6 | fn test_readme_examples() { 7 | let contents = include_str!("../../../../README.md"); 8 | // Similar to code at https://github.com/PRQL/prql/blob/65706a115a84997c608eaeda38b1aef1240fcec3/web/book/tests/snapshot.rs#L152, but specialized for the Readme. 9 | let re = Regex::new(r"(?s)```(elm|prql)\r?\n(?P.+?)\r?\n```").unwrap(); 10 | assert_ne!(re.find_iter(contents).count(), 0); 11 | re.captures_iter(contents).for_each(|capture| { 12 | compile(&capture["prql"]).unwrap(); 13 | }); 14 | } 15 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__README__prql-language-book__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from tracks\nfilter artist == \"Bob Marley\" # Each line transforms the previous result\naggregate { # `aggregate` reduces each column to a value\n plays = sum plays,\n longest = max length,\n shortest = min length, # Trailing commas are allowed\n}\n" 4 | --- 5 | SELECT 6 | COALESCE(SUM(plays), 0) AS plays, 7 | MAX(length) AS longest, 8 | MIN(length) AS shortest 9 | FROM 10 | tracks 11 | WHERE 12 | artist = 'Bob Marley' 13 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compile__cast.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom tracks\nsort {-bytes}\nselect {\n name,\n bin = ((album_id | as REAL) * 99)\n}\ntake 20\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/cast.prql 5 | --- 6 | WITH table_0 AS ( 7 | SELECT 8 | name, 9 | CAST(album_id AS REAL) * 99 AS bin, 10 | bytes 11 | FROM 12 | tracks 13 | ORDER BY 14 | bytes DESC 15 | LIMIT 16 | 20 17 | ) 18 | SELECT 19 | name, 20 | bin 21 | FROM 22 | table_0 23 | ORDER BY 24 | bytes DESC 25 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__operators__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from foo\nselect {\n circumference = diameter * 3.14159,\n area = (diameter / 2) ** 2,\n color,\n}\nfilter circumference > 10 && color != \"red\"\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | diameter * 3.14159 AS circumference, 8 | POW(diameter / 2, 2) AS area, 9 | color 10 | FROM 11 | foo 12 | ) 13 | SELECT 14 | circumference, 15 | area, 16 | color 17 | FROM 18 | table_0 19 | WHERE 20 | circumference > 10 21 | AND color <> 'red' 22 | -------------------------------------------------------------------------------- /web/playground/.eslintrc.cjs: -------------------------------------------------------------------------------- 1 | module.exports = { 2 | root: true, 3 | env: { browser: true, es2020: true }, 4 | extends: [ 5 | "eslint:recommended", 6 | "plugin:react/recommended", 7 | "plugin:react/jsx-runtime", 8 | "plugin:react-hooks/recommended", 9 | ], 10 | ignorePatterns: ["dist", ".eslintrc.cjs"], 11 | parserOptions: { ecmaVersion: "latest", sourceType: "module" }, 12 | settings: { react: { version: "18.2" } }, 13 | plugins: ["react-refresh"], 14 | rules: { 15 | "react-refresh/only-export-components": [ 16 | "warn", 17 | { allowConstantExport: true }, 18 | ], 19 | }, 20 | }; 21 | -------------------------------------------------------------------------------- /prqlc/bindings/dotnet/PrqlCompiler/Span.cs: -------------------------------------------------------------------------------- 1 | using System.Runtime.InteropServices; 2 | 3 | namespace Prql.Compiler 4 | { 5 | /// 6 | /// Identifier of a location in source. 7 | /// Contains offsets in terms of chars. 8 | /// 9 | [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Ansi)] 10 | public struct Span 11 | { 12 | /// 13 | /// Start offset. 14 | /// 15 | public int Start { get; set; } 16 | 17 | /// 18 | /// End offset. 19 | /// 20 | public int End { get; set; } 21 | } 22 | } 23 | -------------------------------------------------------------------------------- /prqlc/prqlc/src/semantic/resolver/snapshots/prqlc__semantic__resolver__test__frames_and_names-2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/src/semantic/resolver/mod.rs 3 | expression: "resolve_lineage(r#\"\n from table_1\n join customers (==customer_no)\n \"#).unwrap()" 4 | --- 5 | columns: 6 | - All: 7 | input_id: 116 8 | except: [] 9 | - All: 10 | input_id: 113 11 | except: [] 12 | inputs: 13 | - id: 116 14 | name: table_1 15 | table: 16 | - default_db 17 | - table_1 18 | - id: 113 19 | name: customers 20 | table: 21 | - default_db 22 | - customers 23 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compileall__group_sort_derive_select_join.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "s\"SELECT album_id,title,artist_id FROM albums\"\ngroup {artist_id} (aggregate { album_title_count = count this.`title`})\nsort {this.artist_id, this.album_title_count}\nderive {new_album_count = this.album_title_count}\nselect {this.artist_id, this.new_album_count}\njoin side:left ( s\"SELECT artist_id,name as artist_name FROM artists\" ) (this.artist_id == that.artist_id)\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/group_sort_derive_select_join.prql 5 | --- 6 | 7 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__results__append_select.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "from invoices\nselect { customer_id, invoice_id, billing_country }\ntake 10..15\nappend (\n from invoices\n select { customer_id, invoice_id, billing_country }\n take 40..45\n)\nselect { billing_country, invoice_id }\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/append_select.prql 5 | --- 6 | Ireland,10 7 | United Kingdom,11 8 | Germany,12 9 | USA,13 10 | USA,14 11 | USA,15 12 | Germany,40 13 | Spain,41 14 | Sweden,42 15 | United Kingdom,43 16 | Australia,44 17 | India,45 18 | -------------------------------------------------------------------------------- /prqlc/bindings/prqlc-python/python/prqlc/__init__.pyi: -------------------------------------------------------------------------------- 1 | from typing import List, Optional 2 | 3 | class CompileOptions: 4 | def __init__( 5 | self, 6 | *, 7 | format: bool = True, 8 | target: str = "sql.any", 9 | signature_comment: bool = True, 10 | ) -> None: ... 11 | 12 | def compile(prql_query: str, options: Optional[CompileOptions] = None) -> str: ... 13 | def prql_to_pl(prql_query: str) -> str: ... 14 | def pl_to_rq(pl_json: str) -> str: ... 15 | def pl_to_prql(pl_json: str) -> str: ... 16 | def rq_to_sql(rq_json: str) -> str: ... 17 | def get_targets() -> List[str]: ... 18 | 19 | __version__: str 20 | -------------------------------------------------------------------------------- /web/book/src/project/contributing/fortnightly-dev-call.ics: -------------------------------------------------------------------------------- 1 | BEGIN:VCALENDAR 2 | PRODID:-//Apple Inc.//macOS 12.6.1//EN 3 | VERSION:2.0 4 | BEGIN:VEVENT 5 | DTSTAMP:20240107T160200 6 | UID:dev-call.prql-lang.org 7 | DTSTART;TZID=America/New_York:20240107T133000 8 | DTEND;TZID=America/New_York:20240107T140000 9 | RRULE:FREQ=MONTHLY;INTERVAL=1;BYDAY=1SU,3SU;UNTIL=20250331 10 | DESCRIPTION:Discord #dev-voice-channel\nhttps://discord.gg/2RUBzz3R3J\n1730Z on 1st & 3rd Sunday 11 | LOCATION:https://discord.gg/2RUBzz3R3J\n1730Z 12 | SEQUENCE:6 13 | STATUS:CONFIRMED 14 | SUMMARY:PRQL Fortnightly Dev Call 15 | TRANSP:TRANSPARENT 16 | END:VEVENT 17 | END:VCALENDAR 18 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__declarations__variables__variables--__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "let top_50 = (\n from employees\n sort salary\n take 50\n aggregate {total_salary = sum salary}\n)\n\nfrom top_50 # Starts a new pipeline\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | salary 8 | FROM 9 | employees 10 | ORDER BY 11 | salary 12 | LIMIT 13 | 50 14 | ), top_50 AS ( 15 | SELECT 16 | COALESCE(SUM(salary), 0) AS total_salary 17 | FROM 18 | table_0 19 | ) 20 | SELECT 21 | total_salary 22 | FROM 23 | top_50 24 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__operators__wrapping-lines__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from tracks\n# This would be a really long line without being able to split it:\nselect listening_time_years = (spotify_plays + apple_music_plays + pandora_plays)\n# We can toggle between lines when developing:\n# \\ * length_seconds\n\\ * length_s\n# min hour day year\n\\ / 60 / 60 / 24 / 365\n" 4 | --- 5 | SELECT 6 | ( 7 | spotify_plays + apple_music_plays + pandora_plays 8 | ) * length_s / 60 / 60 / 24 / 365 AS listening_time_years 9 | FROM 10 | tracks 11 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compile__genre_counts.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# clickhouse:skip (ClickHouse prefers aliases to column names https://github.com/PRQL/prql/issues/2827)\n# mssql:test\nlet genre_count = (\n from genres\n aggregate {a = count name}\n)\n\nfrom genre_count\nfilter a > 0\nselect a = -a\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/genre_counts.prql 5 | --- 6 | WITH genre_count AS ( 7 | SELECT 8 | COUNT(*) AS a 9 | FROM 10 | genres 11 | ) 12 | SELECT 13 | - a AS a 14 | FROM 15 | genre_count 16 | WHERE 17 | a > 0 18 | -------------------------------------------------------------------------------- /web/prql-codemirror-demo/tsconfig.json: -------------------------------------------------------------------------------- 1 | { 2 | "compilerOptions": { 3 | "target": "ES2020", 4 | "useDefineForClassFields": true, 5 | "module": "ESNext", 6 | "lib": ["ES2020", "DOM", "DOM.Iterable"], 7 | "skipLibCheck": true, 8 | 9 | /* Bundler mode */ 10 | "moduleResolution": "bundler", 11 | "allowImportingTsExtensions": true, 12 | "resolveJsonModule": true, 13 | "isolatedModules": true, 14 | "noEmit": true, 15 | 16 | /* Linting */ 17 | "strict": true, 18 | "noUnusedLocals": true, 19 | "noUnusedParameters": true, 20 | "noFallthroughCasesInSwitch": true 21 | }, 22 | "include": ["src"] 23 | } 24 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__aggregation.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mysql:skip\n# clickhouse:skip\n# glaredb:skip (the string_agg function is not supported)\nfrom tracks\nfilter genre_id == 100\nderive empty_name = name == ''\naggregate {sum track_id, concat_array name, all empty_name, any empty_name}\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/aggregation.prql 5 | --- 6 | from tracks 7 | filter genre_id == 100 8 | derive empty_name = name == "" 9 | aggregate { 10 | sum track_id, 11 | concat_array name, 12 | all empty_name, 13 | any empty_name, 14 | } 15 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__results__switch.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# glaredb:skip (May be a bag of String type conversion for Postgres Client)\n# mssql:test\nfrom tracks\nsort milliseconds\nselect display = case [\n composer != null => composer,\n genre_id < 17 => 'no composer',\n true => f'unknown composer'\n]\ntake 10\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/switch.prql 5 | --- 6 | Samuel Rosa 7 | no composer 8 | no composer 9 | no composer 10 | L. Muggerud 11 | no composer 12 | L. Muggerud 13 | unknown composer 14 | Gilberto Gil 15 | Chico Science 16 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__s-strings__3.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from s\"SELECT DISTINCT ON first_name, id, age FROM employees ORDER BY age ASC\"\njoin s = s\"SELECT * FROM salaries\" (==id)\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | DISTINCT ON first_name, 8 | id, 9 | age 10 | FROM 11 | employees 12 | ORDER BY 13 | age ASC 14 | ), 15 | table_1 AS ( 16 | SELECT 17 | * 18 | FROM 19 | salaries 20 | ) 21 | SELECT 22 | table_0.*, 23 | table_1.* 24 | FROM 25 | table_0 26 | INNER JOIN table_1 ON table_0.id = table_1.id 27 | -------------------------------------------------------------------------------- /web/playground/src/main.jsx: -------------------------------------------------------------------------------- 1 | import React from "react"; 2 | import ReactDOM from "react-dom/client"; 3 | import "./index.css"; 4 | import "./highlight.css"; 5 | import App from "./app/App"; 6 | import reportWebVitals from "./reportWebVitals"; 7 | 8 | const root = ReactDOM.createRoot(document.getElementById("root")); 9 | root.render( 10 | 11 | 12 | , 13 | ); 14 | 15 | // If you want to start measuring performance in your app, pass a function 16 | // to log results (for example: reportWebVitals(console.log)) 17 | // or send to an analytics endpoint. Learn more: https://bit.ly/CRA-vitals 18 | reportWebVitals(); 19 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__declarations__functions__late-binding__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "let cost_share = cost -> cost / cost_total\n\nfrom costs\nselect {materials, labor, overhead, cost_total}\nderive {\n materials_share = (cost_share materials),\n labor_share = (cost_share labor),\n overhead_share = (cost_share overhead),\n}\n" 4 | --- 5 | SELECT 6 | materials, 7 | labor, 8 | overhead, 9 | cost_total, 10 | materials / cost_total AS materials_share, 11 | labor / cost_total AS labor_share, 12 | overhead / cost_total AS overhead_share 13 | FROM 14 | costs 15 | -------------------------------------------------------------------------------- /grammars/prql-lezer/test/test-prql.js: -------------------------------------------------------------------------------- 1 | import { parser } from "../dist/index.js"; 2 | import { fileTests } from "@lezer/generator/dist/test"; 3 | 4 | import * as fs from "fs"; 5 | import * as path from "path"; 6 | import { fileURLToPath } from "url"; 7 | let caseDir = path.dirname(fileURLToPath(import.meta.url)); 8 | 9 | for (let file of fs.readdirSync(caseDir)) { 10 | if (!/\.txt$/.test(file)) continue; 11 | 12 | let name = /^[^\.]*/.exec(file)[0]; 13 | describe(name, () => { 14 | for (let { name, run } of fileTests( 15 | fs.readFileSync(path.join(caseDir, file), "utf8"), 16 | file, 17 | )) 18 | it(name, () => run(parser)); 19 | }); 20 | } 21 | -------------------------------------------------------------------------------- /prqlc/prqlc/src/ir/pl/utils.rs: -------------------------------------------------------------------------------- 1 | use super::{Expr, ExprKind, FuncCall}; 2 | use crate::pr::Ident; 3 | 4 | pub fn maybe_binop(left: Option, op_name: &[&str], right: Option) -> Option { 5 | match (left, right) { 6 | (Some(left), Some(right)) => Some(new_binop(left, op_name, right)), 7 | (left, right) => left.or(right), 8 | } 9 | } 10 | 11 | pub fn new_binop(left: Expr, op_name: &[&str], right: Expr) -> Expr { 12 | Expr::new(ExprKind::FuncCall(FuncCall { 13 | name: Box::new(Expr::new(Ident::from_path(op_name.to_vec()))), 14 | args: vec![left, right], 15 | named_args: Default::default(), 16 | })) 17 | } 18 | -------------------------------------------------------------------------------- /web/book/src/project/integrations/duckdb.md: -------------------------------------------------------------------------------- 1 | # DuckDB 2 | 3 | There's a [DuckDB](https://duckdb.org/) community extension by 4 | **[@ywelsch](https://github.com/ywelsch)** at the DuckDB Community Extension 5 | Repository. 6 | 7 | ```sql 8 | INSTALL prql FROM community; 9 | LOAD prql; 10 | -- Once the extension is loaded, you can write PRQL queries 11 | from (read_csv 'https://raw.githubusercontent.com/PRQL/prql/0.8.0/prql-compiler/tests/integration/data/chinook/invoices.csv') 12 | filter invoice_date >= @2009-02-01 13 | take 5; 14 | ``` 15 | 16 | Check out the 17 | [extension's documentation](https://community-extensions.duckdb.org/extensions/prql.html) 18 | for more details. 19 | -------------------------------------------------------------------------------- /prqlc/bindings/prqlc-c/examples/minimal-cpp/Makefile: -------------------------------------------------------------------------------- 1 | PRQL_PROJECT=../../../../.. 2 | 3 | run: build 4 | ./main.out 5 | 6 | build-prql: 7 | cargo build --package prqlc-c --release 8 | 9 | UNAME_S := $(shell uname -s) 10 | 11 | LD_FLAGS = -L${PRQL_PROJECT}/target/release \ 12 | ${PRQL_PROJECT}/target/release/libprqlc_c.a 13 | 14 | ifeq ($(UNAME_S),Darwin) 15 | LD_FLAGS := $(LD_FLAGS) -framework CoreFoundation 16 | endif 17 | 18 | # TODO: would be helpful to allow running with a debug build too. 19 | build: main.cpp build-prql 20 | g++ main.cpp -o main.out \ 21 | -I${PRQL_PROJECT}/prqlc/bindings/prqlc-c \ 22 | $(LD_FLAGS) 23 | 24 | valgrind: build 25 | valgrind ./main.out 26 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__switch.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# glaredb:skip (May be a bag of String type conversion for Postgres Client)\n# mssql:test\nfrom tracks\nsort milliseconds\nselect display = case [\n composer != null => composer,\n genre_id < 17 => 'no composer',\n true => f'unknown composer'\n]\ntake 10\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/switch.prql 5 | --- 6 | from tracks 7 | sort milliseconds 8 | select display = case [ 9 | composer != null => composer, 10 | genre_id < 17 => "no composer", 11 | true => f"unknown composer", 12 | ] 13 | take 10 14 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__append_select_simple.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "from invoices\nselect { invoice_id, billing_country }\nappend (\n from invoices\n select { invoice_id = `invoice_id` + 100, billing_country }\n)\nfilter (billing_country | text.starts_with(\"I\"))\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/append_select_simple.prql 5 | --- 6 | from invoices 7 | select {invoice_id, billing_country} 8 | append ( 9 | from invoices 10 | select { 11 | invoice_id = invoice_id + 100, 12 | billing_country, 13 | } 14 | ) 15 | filter (billing_country | text.starts_with "I") 16 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__pipelines.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# sqlite:skip (Only works on Sqlite implementations which have the extension\n# installed\n# https://stackoverflow.com/questions/24037982/how-to-use-regexp-in-sqlite)\n\nfrom tracks\n\nfilter (name ~= \"Love\")\nfilter ((milliseconds / 1000 / 60) | in 3..4)\nsort track_id\ntake 1..15\nselect {name, composer}\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/pipelines.prql 5 | --- 6 | from tracks 7 | filter name ~= "Love" 8 | filter (milliseconds / 1000 / 60 | in 3..4) 9 | sort track_id 10 | take 1..15 11 | select {name, composer} 12 | -------------------------------------------------------------------------------- /web/book/README.md: -------------------------------------------------------------------------------- 1 | # PRQL language book 2 | 3 | These docs serve as a language book, for users of the language. They should be 4 | friendly & accessible, at a minimum to those who understand basic SQL. 5 | 6 | ## Running 7 | 8 | Install all required PRQL dev tools with: 9 | 10 | ```sh 11 | task setup-dev 12 | ``` 13 | 14 | ...or for the precise cargo command, run `cargo install --locked mdbook`. For 15 | the complete build, add any `mdbook` crates listed in the `Taskfile.yaml`. 16 | 17 | And then to build & serve locally[^1]: 18 | 19 | ```sh 20 | task web:run-book 21 | ``` 22 | 23 | [^1]: ...which is equivalent to: 24 | 25 | ```sh 26 | cd book 27 | mdbook serve 28 | ``` 29 | -------------------------------------------------------------------------------- /prqlc/bindings/elixir/native/prql/Cargo.toml: -------------------------------------------------------------------------------- 1 | [package] 2 | authors = ["Kasun Vithanage "] 3 | description = "Elixir NIF bindings for prqlc" 4 | name = "prql" 5 | publish = false 6 | 7 | edition.workspace = true 8 | license.workspace = true 9 | repository.workspace = true 10 | rust-version.workspace = true 11 | version.workspace = true 12 | 13 | [lib] 14 | bench = false 15 | crate-type = ["cdylib"] 16 | doc = false 17 | doctest = false 18 | name = "prql" 19 | path = "src/lib.rs" 20 | test = false 21 | 22 | [target.'cfg(not(any(target_family="wasm")))'.dependencies] 23 | prqlc = { path = "../../../../prqlc", default-features = false, version = "0.13.9" } 24 | rustler = "0.37.0" 25 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compileall__group_sort_filter_derive_select_join.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "s\"SELECT album_id,title,artist_id FROM albums\"\ngroup {artist_id} (aggregate { album_title_count = count this.`title`})\nsort {this.artist_id, this.album_title_count}\nfilter (this.album_title_count) > 10\nderive {new_album_count = this.album_title_count}\nselect {this.artist_id, this.new_album_count}\njoin side:left ( s\"SELECT artist_id,name as artist_name FROM artists\" ) (this.artist_id == that.artist_id)\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/group_sort_filter_derive_select_join.prql 5 | --- 6 | 7 | -------------------------------------------------------------------------------- /prqlc/bindings/prqlc-c/examples/minimal-c/Makefile: -------------------------------------------------------------------------------- 1 | PRQL_PROJECT=../../../../.. 2 | 3 | run: build 4 | ./main.out 5 | 6 | build-prql: 7 | cargo build --package prqlc-c --release 8 | 9 | UNAME_S := $(shell uname -s) 10 | 11 | LD_FLAGS = -L${PRQL_PROJECT}/target/release \ 12 | ${PRQL_PROJECT}/target/release/libprqlc_c.a \ 13 | -pthread -ldl -lm 14 | 15 | ifeq ($(UNAME_S),Darwin) 16 | LD_FLAGS := $(LD_FLAGS) -framework CoreFoundation 17 | endif 18 | 19 | # TODO: would be helpful to allow running with a debug build too. 20 | build: main.c build-prql 21 | gcc main.c -o main.out \ 22 | -I${PRQL_PROJECT}/prqlc/bindings/prqlc-c \ 23 | $(LD_FLAGS) 24 | 25 | valgrind: build 26 | valgrind ./main.out 27 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compile__aggregation.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mysql:skip\n# clickhouse:skip\n# glaredb:skip (the string_agg function is not supported)\nfrom tracks\nfilter genre_id == 100\nderive empty_name = name == ''\naggregate {sum track_id, concat_array name, all empty_name, any empty_name}\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/aggregation.prql 5 | --- 6 | SELECT 7 | COALESCE(SUM(track_id), 0), 8 | COALESCE(STRING_AGG(name, ''), ''), 9 | COALESCE(BOOL_AND(name = ''), TRUE), 10 | COALESCE(BOOL_OR(name = ''), FALSE) 11 | FROM 12 | tracks 13 | WHERE 14 | genre_id = 100 15 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__append_select.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "from invoices\nselect { customer_id, invoice_id, billing_country }\ntake 10..15\nappend (\n from invoices\n select { customer_id, invoice_id, billing_country }\n take 40..45\n)\nselect { billing_country, invoice_id }\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/append_select.prql 5 | --- 6 | from invoices 7 | select {customer_id, invoice_id, billing_country} 8 | take 10..15 9 | append ( 10 | from invoices 11 | select {customer_id, invoice_id, billing_country} 12 | take 40..45 13 | ) 14 | select {billing_country, invoice_id} 15 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__results__group_all.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom a=albums\ntake 10\njoin tracks (==album_id)\ngroup {a.album_id, a.title} (aggregate price = (sum tracks.unit_price | math.round 2))\nsort album_id\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/group_all.prql 5 | --- 6 | 1,For Those About To Rock We Salute You,9.9 7 | 2,Balls to the Wall,0.99 8 | 3,Restless and Wild,2.97 9 | 4,Let There Be Rock,7.92 10 | 5,Big Ones,14.85 11 | 6,Jagged Little Pill,12.87 12 | 7,Facelift,11.88 13 | 8,Warner 25 Anos,13.86 14 | 9,Plays Metallica By Four Cellos,7.92 15 | 10,Audioslave,13.86 16 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__syntax__strings__quoting-and-escape-characters__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from artists\nderive escapes = \"\\tXYZ\\n \\\\ \" # tab (\\t), \"XYZ\", newline (\\n), \" \", \\, \" \"\nderive world = \"\\u{0048}\\u{0065}\\u{006C}\\u{006C}\\u{006F}\" # \"Hello\"\nderive hex = \"\\x48\\x65\\x6C\\x6C\\x6F\" # \"Hello\"\nderive turtle = \"\\u{01F422}\" # \"🐢\"\n" 4 | --- 5 | SELECT 6 | *, 7 | ' XYZ 8 | \ ' AS escapes, 9 | 'Hello' AS world, 10 | 'Hello' AS hex, 11 | '🐢' AS turtle 12 | FROM 13 | artists 14 | -------------------------------------------------------------------------------- /web/prql-codemirror-demo/package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "prql-codemirror-demo", 3 | "private": true, 4 | "version": "0.0.0", 5 | "type": "module", 6 | "scripts": { 7 | "dev": "vite", 8 | "build": "tsc && vite build", 9 | "preview": "vite preview" 10 | }, 11 | "devDependencies": { 12 | "typescript": "^5.3.2", 13 | "vite": "^6.4.1" 14 | }, 15 | "dependencies": { 16 | "@codemirror/autocomplete": "^6.11.0", 17 | "@codemirror/commands": "^6.3.0", 18 | "@codemirror/language": "^6.9.2", 19 | "@codemirror/lint": "^6.4.2", 20 | "@codemirror/search": "^6.5.4", 21 | "@codemirror/theme-one-dark": "^6.1.2", 22 | "@codemirror/view": "^6.22.0" 23 | } 24 | } 25 | -------------------------------------------------------------------------------- /web/website/data/examples/friendly-syntax.yaml: -------------------------------------------------------------------------------- 1 | label: Friendly syntax 2 | prql: | 3 | from track_plays 4 | filter plays > 10_000 # Readable numbers 5 | filter (length | in 60..240) # Ranges with `..` 6 | filter recorded > @2008-01-01 # Simple date literals 7 | filter released - recorded < 180days # Nice interval literals 8 | sort {-length} # Concise order direction 9 | 10 | sql: | 11 | SELECT 12 | * 13 | FROM 14 | track_plays 15 | WHERE 16 | plays > 10000 17 | AND length BETWEEN 60 AND 240 18 | AND recorded > DATE '2008-01-01' 19 | AND released - recorded < INTERVAL 180 DAY 20 | ORDER BY 21 | length DESC 22 | -------------------------------------------------------------------------------- /web/website/themes/prql-theme/layouts/_default/_markup/render-link.html: -------------------------------------------------------------------------------- 1 | {{/* 2 | 3 | Formats external links with an icon, and opens in a new tab. 4 | 5 | Note that it's important not to have a blank line at the end; so we exclude this 6 | file from prettier / pre-commit's fixer 7 | 8 | */}} 9 | {{ $is_external := strings.HasPrefix .Destination "http" }} 10 | 19 | {{ .Text | safeHTML }} 20 | {{- if $is_external -}} 21 | 22 | {{- end -}} 23 | -------------------------------------------------------------------------------- /web/website/themes/prql-theme/layouts/_default/list.html: -------------------------------------------------------------------------------- 1 | {{ define "main" }} 2 |
3 |

{{ .Title }}

4 | 5 | {{ if .Content }} 6 |
{{ .Content }}
7 | {{ end }} 8 | 9 | {{ range .Pages }} 10 |

11 |
12 | 15 |
16 | {{ .Title }} 17 |

18 | {{ end }} 19 | 20 |
21 | {{ end }} 22 | -------------------------------------------------------------------------------- /.gitattributes: -------------------------------------------------------------------------------- 1 | # Currently required for: 2 | # - Elixir tests at 3 | # https://github.com/PRQL/prql/blob/5eb4063dbd36bdac07529797dd2cec8c55127263/.github/workflows/test-elixir.yaml#L31 4 | # - Previously for Readme tests, those those now should support either lf or 5 | # crlf, at https://github.com/PRQL/prql/blob/6d4662b4e6e0f07dc3cd8eb5c19cc78fc199d0b2/web/book/tests/documentation/readme.rs#L9 6 | * text=auto eol=lf 7 | 8 | # Prevent files from cluttering `git grep` results 9 | *.min.js -diff 10 | *.min.js.map -diff 11 | *.min.css -diff 12 | *.min.css.map -diff 13 | package-lock.json -diff 14 | # mdbook expects the file to be named highlight.js so we cannot rename it to .min.js 15 | highlight.js -diff 16 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__results__sort.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom e=employees\nfilter first_name != \"Mitchell\"\nsort {first_name, last_name}\n\n# joining may use HashMerge, which can undo ORDER BY\njoin manager=employees side:left (e.reports_to == manager.employee_id)\n\nselect {e.first_name, e.last_name, manager.first_name}\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/sort.prql 5 | --- 6 | Andrew,Adams,Michael 7 | Jane,Peacock,Nancy 8 | Laura,Callahan,Michael 9 | Margaret,Park,Nancy 10 | Michael,Mitchell,Andrew 11 | Nancy,Edwards,Andrew 12 | Robert,King,Michael 13 | Steve,Johnson,Nancy 14 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__group_sort_limit_take.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# Compute the 3 longest songs for each genre and sort by genre\n# mssql:test\nfrom tracks\nselect {genre_id,milliseconds}\ngroup {genre_id} (\n sort {-milliseconds}\n take 3\n)\njoin genres (==genre_id)\nselect {name, milliseconds}\nsort {+name,-milliseconds}\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/group_sort_limit_take.prql 5 | --- 6 | from tracks 7 | select {genre_id, milliseconds} 8 | group {genre_id} (sort {-milliseconds} | take 3) 9 | join genres (==genre_id) 10 | select {name, milliseconds} 11 | sort {+name, -milliseconds} 12 | -------------------------------------------------------------------------------- /prqlc/prqlc/src/semantic/resolver/snapshots/prqlc__semantic__resolver__test__append_union_different_tables.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/src/semantic/resolver/mod.rs 3 | assertion_line: 234 4 | expression: final_lineage 5 | --- 6 | columns: 7 | - Single: 8 | name: 9 | - employees 10 | - name 11 | target_id: 131 12 | target_name: ~ 13 | - Single: 14 | name: 15 | - employees 16 | - salary 17 | target_id: 132 18 | target_name: ~ 19 | inputs: 20 | - id: 129 21 | name: employees 22 | table: 23 | - default_db 24 | - employees 25 | - id: 118 26 | name: managers 27 | table: 28 | - default_db 29 | - managers 30 | -------------------------------------------------------------------------------- /.config/vscode-recommended/launch.json: -------------------------------------------------------------------------------- 1 | { 2 | // Use IntelliSense to learn about possible attributes. 3 | // Hover to view descriptions of existing attributes. 4 | // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387 5 | "version": "0.2.0", 6 | "configurations": [ 7 | { 8 | "type": "lldb", 9 | "request": "launch", 10 | "name": "prqlc _a.prql", 11 | "program": "${workspaceFolder}/target/debug/prqlc", 12 | "args": ["debug", "semantics", "_a.prql"], 13 | "env": { 14 | "RUST_LOG": "debug", 15 | "RUST_BACKTRACE": "1" 16 | }, 17 | "preLaunchTask": "prqlc-build", 18 | "cwd": "${workspaceFolder}" 19 | } 20 | ] 21 | } 22 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__sort.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom e=employees\nfilter first_name != \"Mitchell\"\nsort {first_name, last_name}\n\n# joining may use HashMerge, which can undo ORDER BY\njoin manager=employees side:left (e.reports_to == manager.employee_id)\n\nselect {e.first_name, e.last_name, manager.first_name}\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/sort.prql 5 | --- 6 | from e = employees 7 | filter first_name != "Mitchell" 8 | sort {first_name, last_name} 9 | join side:left manager = employees e.reports_to == manager.employee_id 10 | select {e.first_name, e.last_name, manager.first_name} 11 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/queries/text_module.prql: -------------------------------------------------------------------------------- 1 | # mssql:test 2 | # glaredb:skip — TODO: started raising an error on 2024-05-20; see `window.prql` 3 | # for more details 4 | from albums 5 | select { 6 | title, 7 | title_and_spaces = f" {title} ", 8 | low = (title | text.lower), 9 | up = (title | text.upper), 10 | ltrimmed = (title | text.ltrim), 11 | rtrimmed = (title | text.rtrim), 12 | trimmed = (title | text.trim), 13 | len = (title | text.length), 14 | subs = (title | text.extract 2 5), 15 | replace = (title | text.replace "al" "PIKA"), 16 | } 17 | sort {title} 18 | filter (title | text.starts_with "Black") || (title | text.contains "Sabbath") || (title | text.ends_with "os") 19 | -------------------------------------------------------------------------------- /prqlc/prqlc/src/semantic/resolver/snapshots/prqlc__semantic__resolver__test__functions_1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/src/semantic/resolver/mod.rs 3 | expression: "resolve_derive(r#\"\n let subtract = a b -> a - b\n\n from employees\n derive {\n net_salary = subtract gross_salary tax\n }\n \"#).unwrap()" 4 | --- 5 | - RqOperator: 6 | name: std.sub 7 | args: 8 | - Ident: 9 | - this 10 | - employees 11 | - gross_salary 12 | span: "1:128-140" 13 | - Ident: 14 | - this 15 | - employees 16 | - tax 17 | span: "1:141-144" 18 | span: "1:119-144" 19 | alias: net_salary 20 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__results__append_select_compute.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "from invoices\nderive total = case [total < 10 => total * 2, true => total]\nselect { customer_id, invoice_id, total }\ntake 5\nappend (\n from invoice_items\n derive unit_price = case [unit_price < 1 => unit_price * 2, true => unit_price]\n select { invoice_line_id, invoice_id, unit_price }\n take 5\n)\nselect { a = customer_id * 2, b = math.round 1 (invoice_id * total) }\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/append_select_compute.prql 5 | --- 6 | 4,4 7 | 8,15.8 8 | 16,35.6 9 | 28,71.3 10 | 46,69.3 11 | 2,2 12 | 4,2 13 | 6,4 14 | 8,4 15 | 10,4 16 | -------------------------------------------------------------------------------- /web/book/src/project/integrations/vscode.md: -------------------------------------------------------------------------------- 1 | # Visual Studio Code extension 2 | 3 | PRQL has a Visual Studio Code extension that compiles a PRQL query in a VS Code 4 | editor and displays the resulting SQL code in a second pane on the side. This is 5 | very handy for editing, saving, and reusing PRQL queries in VS Code. 6 | 7 | To install the VS Code extension, open VS Code and type 8 | Ctrl-Shift-P 9 | (Cmd-Shift-P on a Mac) and type `PRQL`. Install 10 | the extension as usual. 11 | 12 | [Repo for the PRQL VS Code extension](https://github.com/PRQL/prql-vscode) 13 | 14 | [Extension on VS Marketplace](https://marketplace.visualstudio.com/items?itemName=PRQL-lang.prql-vscode) 15 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__results__append_select_multiple_with_null.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "from invoices\nselect { customer_id, invoice_id, billing_country }\ntake 5\nappend (\n from employees\n select { employee_id, employee_id, country }\n take 5\n)\nappend (\n from invoice_items\n select { invoice_line_id, invoice_id, null }\n take 5\n)\nselect { billing_country, invoice_id }\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/append_select_multiple_with_null.prql 5 | --- 6 | Germany,1 7 | Norway,2 8 | Belgium,3 9 | Canada,4 10 | USA,5 11 | Canada,1 12 | Canada,2 13 | Canada,3 14 | Canada,4 15 | Canada,5 16 | ,1 17 | ,1 18 | ,2 19 | ,2 20 | ,2 21 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__stdlib__transforms__window__example__1.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "from orders\nsort day\nwindow rows:-3..3 (\n derive {centered_weekly_average = average value}\n)\ngroup {order_month} (\n sort day\n window expanding:true (\n derive {monthly_running_total = sum value}\n )\n)\n" 4 | --- 5 | SELECT 6 | *, 7 | AVG(value) OVER ( 8 | ORDER BY 9 | day ROWS BETWEEN 3 PRECEDING AND 3 FOLLOWING 10 | ) AS centered_weekly_average, 11 | SUM(value) OVER ( 12 | PARTITION BY order_month 13 | ORDER BY 14 | day ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW 15 | ) AS monthly_running_total 16 | FROM 17 | orders 18 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compileall__append_select_simple.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "from invoices\nselect { invoice_id, billing_country }\nappend (\n from invoices\n select { invoice_id = `invoice_id` + 100, billing_country }\n)\nfilter (billing_country | text.starts_with(\"I\"))\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/append_select_simple.prql 5 | --- 6 | --- generic 7 | +++ sqlite 8 | @@ -11,11 +11,11 @@ 9 | billing_country 10 | FROM 11 | invoices 12 | ) 13 | SELECT 14 | invoice_id, 15 | billing_country 16 | FROM 17 | table_1 18 | WHERE 19 | - billing_country LIKE CONCAT('I', '%') 20 | + billing_country LIKE 'I' || '%' 21 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__results__group_sort_filter_derive_select_join.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "s\"SELECT album_id,title,artist_id FROM albums\"\ngroup {artist_id} (aggregate { album_title_count = count this.`title`})\nsort {this.artist_id, this.album_title_count}\nfilter (this.album_title_count) > 10\nderive {new_album_count = this.album_title_count}\nselect {this.artist_id, this.new_album_count}\njoin side:left ( s\"SELECT artist_id,name as artist_name FROM artists\" ) (this.artist_id == that.artist_id)\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/group_sort_filter_derive_select_join.prql 5 | --- 6 | 22,14,22,Led Zeppelin 7 | 58,11,58,Deep Purple 8 | 90,21,90,Iron Maiden 9 | -------------------------------------------------------------------------------- /grammars/raku/README.md: -------------------------------------------------------------------------------- 1 | # Raku grammar 2 | 3 | PRQL grammar for Raku. 4 | 5 | ## Instructions 6 | 7 | ```raku 8 | use lib '.'; 9 | use prql; 10 | 11 | say PRQL.parse('from employees'); 12 | say PRQL.parsefile('employees.prql'); 13 | ``` 14 | 15 | ## Installation 16 | 17 | To install from source run: 18 | 19 | zef install . 20 | 21 | ## Tests 22 | 23 | Tests can be run individually by specifying the test filename on the command 24 | line: 25 | 26 | raku t/arithmetics.rakutest 27 | 28 | To run all tests in the directory you have to install `prove6` using `zef`: 29 | 30 | zef install App::Prove6 31 | prove6 --lib t/ 32 | 33 | ## Documentation 34 | 35 | - https://docs.raku.org/language/grammar_tutorial 36 | - https://docs.raku.org/language/grammars 37 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compile__sort_2.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "from albums\nselect { AA=album_id, artist_id }\nsort AA\nfilter AA >= 25\njoin artists (==artist_id)\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/sort_2.prql 5 | --- 6 | WITH table_1 AS ( 7 | SELECT 8 | album_id AS "AA", 9 | artist_id 10 | FROM 11 | albums 12 | ), 13 | table_0 AS ( 14 | SELECT 15 | "AA", 16 | artist_id 17 | FROM 18 | table_1 19 | WHERE 20 | "AA" >= 25 21 | ) 22 | SELECT 23 | table_0."AA", 24 | table_0.artist_id, 25 | artists.* 26 | FROM 27 | table_0 28 | INNER JOIN artists ON table_0.artist_id = artists.artist_id 29 | ORDER BY 30 | table_0."AA" 31 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compileall__cast.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom tracks\nsort {-bytes}\nselect {\n name,\n bin = ((album_id | as REAL) * 99)\n}\ntake 20\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/cast.prql 5 | --- 6 | --- generic 7 | +++ mssql 8 | @@ -1,19 +1,19 @@ 9 | WITH table_0 AS ( 10 | SELECT 11 | name, 12 | CAST(album_id AS REAL) * 99 AS bin, 13 | bytes 14 | FROM 15 | tracks 16 | ORDER BY 17 | - bytes DESC 18 | - LIMIT 19 | - 20 20 | + bytes DESC OFFSET 0 ROWS 21 | + FETCH FIRST 22 | + 20 ROWS ONLY 23 | ) 24 | SELECT 25 | name, 26 | bin 27 | FROM 28 | table_0 29 | ORDER BY 30 | bytes DESC 31 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__fmt__set_ops_remove.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nlet distinct = rel -> (from t = _param.rel | group {t.*} (take 1))\n\nfrom_text format:json '{ \"columns\": [\"a\"], \"data\": [[1], [2], [2], [3]] }'\ndistinct\nremove (from_text format:json '{ \"columns\": [\"a\"], \"data\": [[1], [2]] }')\nsort a\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/set_ops_remove.prql 5 | --- 6 | let distinct = func rel -> ( 7 | from t = _param.rel 8 | group {t.`*`} (take 1) 9 | ) 10 | 11 | from_text format:json '{ "columns": ["a"], "data": [[1], [2], [2], [3]] }' 12 | distinct 13 | remove (from_text format:json '{ "columns": ["a"], "data": [[1], [2]] }') 14 | sort a 15 | -------------------------------------------------------------------------------- /web/book/src/reference/data/from.md: -------------------------------------------------------------------------------- 1 | # From 2 | 3 | Specifies a data source. 4 | 5 | ```prql 6 | from artists 7 | ``` 8 | 9 | To introduce an alias, use an assign expression: 10 | 11 | ```prql 12 | from e = employees 13 | select e.first_name 14 | ``` 15 | 16 | Table names containing spaces or special characters 17 | [need to be contained within backticks](../syntax/keywords.md#quoting): 18 | 19 | ```prql 20 | from `artist tracks` 21 | ``` 22 | 23 | `default_db.tablename` can be used if the table name matches a function from the 24 | standard library. 25 | 26 | > [!NOTE] We realize this is an awkward workaround. Track & 👍 27 | > [#3271](https://github.com/PRQL/prql/issues/3271) for resolving this. 28 | 29 | ```prql 30 | default_db.group # in place of `from group` 31 | take 1 32 | ``` 33 | -------------------------------------------------------------------------------- /prqlc/bindings/elixir/.gitignore: -------------------------------------------------------------------------------- 1 | # The directory Mix will write compiled artifacts to. 2 | /_build/ 3 | 4 | # If you run "mix test --cover", coverage assets end up here. 5 | /cover/ 6 | 7 | # The directory Mix downloads your dependencies sources to. 8 | /deps/ 9 | 10 | # Where third-party dependencies like ExDoc output generated docs. 11 | /doc/ 12 | 13 | # Ignore .fetch files in case you like to edit your project deps locally. 14 | /.fetch 15 | 16 | # If the VM crashes, it generates a dump, let's ignore it too. 17 | erl_crash.dump 18 | 19 | # Also ignore archive artifacts (built via "mix archive.build"). 20 | *.ez 21 | 22 | # Ignore package tarball (built via "mix hex.build"). 23 | prql_elixir-*.tar 24 | 25 | # Temporary files, for example, from tests. 26 | /tmp/ 27 | 28 | /priv/native/* 29 | -------------------------------------------------------------------------------- /web/book/tests/documentation/snapshots/documentation__book__reference__data__read-files__reading-files__0.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: web/book/tests/documentation/book.rs 3 | expression: "prql target:sql.duckdb\n\nfrom (read_parquet \"artists.parquet\")\njoin (read_csv \"albums.csv\") (==track_id)\n" 4 | --- 5 | WITH table_0 AS ( 6 | SELECT 7 | * 8 | FROM 9 | read_parquet( 10 | 'artists.parquet', 11 | binary_as_string = false, 12 | file_row_number = false, 13 | hive_partitioning = NULL, 14 | union_by_name = false 15 | ) 16 | ), 17 | table_1 AS ( 18 | SELECT 19 | * 20 | FROM 21 | read_csv_auto('albums.csv') 22 | ) 23 | SELECT 24 | table_0.*, 25 | table_1.* 26 | FROM 27 | table_0 28 | INNER JOIN table_1 ON table_0.track_id = table_1.track_id 29 | -------------------------------------------------------------------------------- /.github/CODE_OF_CONDUCT.md: -------------------------------------------------------------------------------- 1 | # Code of Conduct 2 | 3 | We prefer keeping our rules as short as possible and filling the gaps with the 4 | mortar of human interaction: empathy. 5 | 6 | All we ask of members of this project is this: 7 | 8 | - Please treat each other with respect and understanding. 9 | - Please respect our wish to not serve as a stage for disputes about fairness or 10 | personal differences. 11 | 12 | If you can agree to these conditions, your contributions are welcome. If you can 13 | not, please don’t spoil it for the rest of us. 14 | 15 | To report a violation of these rules, please email 16 | [prql@prql-lang.org](mailto:prql@prql-lang.org) or contact one of the 17 | [project maintainers](https://github.com/orgs/PRQL/people). 18 | 19 | --- 20 | 21 | (based on ) 22 | -------------------------------------------------------------------------------- /prqlc/prqlc/src/ir/rq/utils.rs: -------------------------------------------------------------------------------- 1 | use super::Expr; 2 | use super::ExprKind; 3 | 4 | pub fn new_binop(left: Expr, operator_name: &str, right: Expr) -> Expr { 5 | Expr { 6 | kind: ExprKind::Operator { 7 | name: operator_name.to_string(), 8 | args: vec![left, right], 9 | }, 10 | span: None, 11 | } 12 | } 13 | 14 | pub fn maybe_binop(left: Option, operator_name: &str, right: Option) -> Option { 15 | match (left, right) { 16 | (Some(left), Some(right)) => Some(Expr { 17 | kind: ExprKind::Operator { 18 | name: operator_name.to_string(), 19 | args: vec![left, right], 20 | }, 21 | span: None, 22 | }), 23 | (left, right) => left.or(right), 24 | } 25 | } 26 | -------------------------------------------------------------------------------- /prqlc/bindings/java/README.md: -------------------------------------------------------------------------------- 1 | # prql-java 2 | 3 | `prql-java` offers Java bindings to the `prqlc` Rust library. It exposes a Java 4 | native method `public static native String toSql(String query)`. 5 | 6 | It's still at an early stage, and currently requires compiling locally, and 7 | isn't published to Maven. Contributions are welcome. 8 | 9 | ## Installation 10 | 11 | ```xml 12 | 13 | org.prqllang 14 | prql-java 15 | ${PRQL_VERSION} 16 | 17 | ``` 18 | 19 | ## Usage 20 | 21 | ```java 22 | import org.prqllang.prql4j.PrqlCompiler; 23 | 24 | class Main { 25 | public static void main(String[] args) { 26 | String sql = PrqlCompiler.toSql("from table"); 27 | System.out.println(sql); 28 | } 29 | } 30 | ``` 31 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compile__group_all.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom a=albums\ntake 10\njoin tracks (==album_id)\ngroup {a.album_id, a.title} (aggregate price = (sum tracks.unit_price | math.round 2))\nsort album_id\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/group_all.prql 5 | --- 6 | WITH table_0 AS ( 7 | SELECT 8 | album_id, 9 | title 10 | FROM 11 | albums AS a 12 | LIMIT 13 | 10 14 | ) 15 | SELECT 16 | table_0.album_id, 17 | table_0.title, 18 | ROUND(COALESCE(SUM(tracks.unit_price), 0), 2) AS price 19 | FROM 20 | table_0 21 | INNER JOIN tracks ON table_0.album_id = tracks.album_id 22 | GROUP BY 23 | table_0.album_id, 24 | table_0.title 25 | ORDER BY 26 | table_0.album_id 27 | -------------------------------------------------------------------------------- /prqlc/prqlc/tests/integration/snapshots/integration__queries__compileall__group_sort.snap: -------------------------------------------------------------------------------- 1 | --- 2 | source: prqlc/prqlc/tests/integration/queries.rs 3 | expression: "# mssql:test\nfrom tracks\nderive d = album_id + 1\ngroup d (\n aggregate {\n n1 = (track_id | sum),\n }\n)\nsort d\ntake 10\nselect { d1 = d, n1 }\n" 4 | input_file: prqlc/prqlc/tests/integration/queries/group_sort.prql 5 | --- 6 | --- generic 7 | +++ mssql 8 | @@ -8,21 +8,21 @@ 9 | album_id + 1 10 | ), 11 | table_1 AS ( 12 | SELECT 13 | _expr_0 AS d1, 14 | n1, 15 | _expr_0 16 | FROM 17 | table_0 18 | ORDER BY 19 | - _expr_0 20 | - LIMIT 21 | - 10 22 | + _expr_0 OFFSET 0 ROWS 23 | + FETCH FIRST 24 | + 10 ROWS ONLY 25 | ) 26 | SELECT 27 | d1, 28 | n1 29 | FROM 30 | table_1 31 | ORDER BY 32 | d1 33 | --------------------------------------------------------------------------------