mirror of https://github.com/github/codeql.git synced 2025-12-16 08:43:11 +01:00

Files

Cornelius Riemenschneider 1bd7aef1b2 Fix search paths.

It turns out we still need to supply this option, so `codeql` goes looking
for the extractor paths specified in the `codeql-workspace.yml` file.

2024-06-03 16:33:17 +02:00

1.4 KiB

Raw Blame History

Developer information

This document contains information about common development tasks.

Building the tools from source

Install Rust, then run:

(cd extractor && cargo build --release)

Generating the database schema and QL library

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

# Run the generator
(cd extractor && cargo run --release --bin generator -- --dbscheme ../ql/lib/ruby.dbscheme --library ../ql/lib/codeql/ruby/ast/internal/TreeSitter.qll)
# Then auto-format the QL library
codeql query format -i ql/lib/codeql/ruby/ast/internal/TreeSitter.qll

Building a CodeQL database for a Ruby program

First, get an extractor pack. There are two options:

Either download the latest codeql-ruby-pack from Actions and unzip it twice, or
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 ruby -s <project-source-path> --search-path <extractor-pack-path>

Running qltests

Run

codeql test run <test-path> --search-path <extractor-pack-path>

Writing database upgrade scripts

See this guide.

1.4 KiB Raw Blame History