|
16 | 16 | checklist for a CLI release, you can edit here. But then
|
17 | 17 | you know what to do).
|
18 | 18 | -->
|
| 19 | +## Release 2.16.0 (2024-01-16) |
| 20 | + |
| 21 | +### New Features |
| 22 | + |
| 23 | +- Users specifying extra tracing configurations may now use the `GetRegisteredMatchers(languageId)` Lua function to retrieve the existing table of matchers registered to a given language. |
| 24 | + |
| 25 | +### Improvements |
| 26 | + |
| 27 | +- The `Experimental` flag has been removed from all packaging and related commands. |
| 28 | +- The RA pretty-printer omits names of internal RA nodes and pretty-prints |
| 29 | + binary unions with nested internal unions as n-ary unions. VS Code extension |
| 30 | + v1.11.0 or newer is required to compute join order badness metrics in VS Code |
| 31 | + for the new RA format. |
| 32 | + |
| 33 | + |
| 34 | +### Potentially breaking changes |
| 35 | + |
| 36 | +- The Python extractor will no longer extract dependencies by default. See https://github.blog/changelog/2023-07-12-code-scanning-with-codeql-no-longer-installs-python-dependencies-automatically-for-new-users/ for more context. In versions until 2.17.0, it will be possible to restore the old behavior by setting `CODEQL_EXTRACTOR_PYTHON_FORCE_ENABLE_LIBRARY_EXTRACTION_UNTIL_2_17_0=1`. |
| 37 | +- The `--ram` option to `codeql database run-queries` and other |
| 38 | + commands that execute queries is now interpreted more strictly. |
| 39 | + Previously it was mostly a rough hint for how much memory to use, |
| 40 | + and the actual memory footprint of the CodeQL process could be |
| 41 | + hundreds of megabytes higher. From this release, CodeQL tries harder |
| 42 | + to keep its _total_ memory consumption during evaluation below the |
| 43 | + given limit. |
| 44 | + |
| 45 | + The new behavior yields more predictable memory use, but since it |
| 46 | + works by allocating less RAM, it can lead to more use of _disk_ |
| 47 | + storage for intermediate results compared to earlier releases with |
| 48 | + the same `--ram` value, and consequently a slight performance |
| 49 | + loss. In rare cases, for large databases, analysis may fail with a |
| 50 | + Java `OutOfMemoryError`. |
| 51 | + |
| 52 | + The cure for this is to increase `--ram` to be closer to the amount |
| 53 | + of memory actually available for CodeQL. As a rule of thumb, it will |
| 54 | + usually be possible to increase the value of `--ram` by 700 MB or |
| 55 | + more, without actually using more resources than release 2.15.x |
| 56 | + would with the old setting. An exact amount cannot stated, however, |
| 57 | + since the actual memory footprint in earlier releases depended on |
| 58 | + factors such as the size of the databases that were not fully taken |
| 59 | + into account. |
| 60 | + |
| 61 | + If you use the CodeQL Action, you do not need to do anything unless |
| 62 | + you have manually overridden the Action's RAM setting. The Action |
| 63 | + will automatically select a `--ram` setting that matches the version |
| 64 | + of the CLI it uses. |
19 | 65 |
|
20 | 66 | ## Release 2.15.5 (2023-12-20)
|
21 | 67 |
|
|
33 | 79 |
|
34 | 80 | - Fixed an issue where CodeQL would sometimes incorrectly report that no files
|
35 | 81 | were scanned when running on Windows.
|
36 |
| - This affected the human-readable summary produced by `codeql database analyze` |
| 82 | + This affected the human-readable summary produced by `codeql database analyze` |
37 | 83 | and `codeql database interpret-results`, but did not impact the file coverage
|
38 | 84 | information produced in the SARIF output and displayed on the tool status page.
|
39 | 85 | - When analyzing Swift codebases, CodeQL build tracing will now ignore the
|
|
44 | 90 |
|
45 | 91 | ### New features
|
46 | 92 |
|
47 |
| -- Java 21 is now fully supported, including support for new language features such as |
48 |
| - pattern switches and record patterns. |
| 93 | +- Java 21 is now fully supported, including support for new language features such as pattern switches and record patterns. |
49 | 94 |
|
50 | 95 | ### Improvements
|
51 | 96 |
|
|
0 commit comments