codeql/ql
dependabot[bot] d0554a05f9
Bump rayon from 1.7.0 to 1.8.0 in /ql
Bumps [rayon](https://github.com/rayon-rs/rayon) from 1.7.0 to 1.8.0.
- [Changelog](https://github.com/rayon-rs/rayon/blob/master/RELEASES.md)
- [Commits](https://github.com/rayon-rs/rayon/compare/rayon-core-v1.7.0...rayon-core-v1.8.0)

---
updated-dependencies:
- dependency-name: rayon
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
2023-09-21 03:10:09 +00:00
..
.vscode
buramu Bump rayon from 1.7.0 to 1.8.0 in /ql 2023-09-21 03:10:09 +00:00
extractor Bump rayon from 1.7.0 to 1.8.0 in /ql 2023-09-21 03:10:09 +00:00
ql Update ql/ql/test/queries/performance/MissingNoInline/MissingNoInline.expected 2023-07-19 11:34:05 +01:00
scripts QL: Rename extractor to codeql-extractor-ql 2023-04-19 06:30:09 +00:00
tools QL: switch to shared YAML extractor 2023-05-22 19:28:59 +02:00
.gitattributes
.gitignore
Cargo.lock Bump rayon from 1.7.0 to 1.8.0 in /ql 2023-09-21 03:10:09 +00:00
Cargo.toml QL: Merge extractor crates into one 2023-03-23 11:59:14 +13:00
README.md
codeql-extractor.yml Specify language names in extractor packs 2022-12-23 13:15:04 +00:00
rust-toolchain.toml QL: Bump rust to 1.68 2023-03-23 11:59:14 +13:00

README.md

QL for QL

QL for QL is a CodeQL analysis designed to find common bug patterns in QL code.
This analysis is mostly used as a PR check in github/codeql.
QL for QL is experimental technology and not a supported product.

This directory contains the extractor, CodeQL libraries, and queries that power QL for QL.

Some setup is required to use QL for QL (see the below sections).

Building the tools from source

Install Rust (if using VSCode, you may also want the rust-analyzer extension), then run:

cargo build --release

Generating the database schema and QL library

The generated ql/src/ql.dbscheme and ql/src/codeql_ql/ast/internal/TreeSitter.qll files are included in the repository, but they can be re-generated as follows:

./scripts/create-extractor-pack.sh

Building a CodeQL database for a QL program

First, get an extractor pack:

Run ./scripts/create-extractor-pack.sh (Linux/Mac) or .\scripts\create-extractor-pack.ps1 (Windows PowerShell) and the pack will be created in the extractor-pack directory.

Then run

codeql database create <database-path> -l ql -s <project-source-path> --search-path <extractor-pack-path>

CodeQL can be configured to remember the extractor by setting the config file ~/.config/codeql/config to:

--search-path /full/path/to/extractor-pack

Running qltests

Run

codeql test run <test-path> --search-path <repository-root-path>