Skip to main content
ドキュメントへの更新が頻繁に発行されており、このページの翻訳はまだ行われている場合があります。 最新の情報については、「英語のドキュメント」を参照してください。
現在、GitHub AE は限定的リリースです。

query format

QL ソース コードのオートフォーマット。

GitHub CodeQL は、インストール時にユーザーごとにライセンスされます。 CodeQL は、ライセンスの制限の下で特定のタスクでのみ使用できます。 詳しくは、「CodeQL CLI について」を参照してください。

GitHub Advanced Security ライセンスがある場合は、CodeQL を使用して、自動分析、継続的インテグレーション、継続的デリバリーを行うことができます。 詳しくは、「GitHub Advanced Security について」を参照してください。

This content describes the most recent release of the CodeQL CLI. For more information about this release, see https://github.com/github/codeql-cli-binaries/releases.

To see details of the options available for this command in an earlier release, run the command with the --help option in your terminal.

構文

Shell
codeql query format [--output=<file>] [--in-place] [--backup=<ext>] <options>... -- <file>...

説明

QL ソース コードのオートフォーマット。

主なオプション

<file>...

オートフォーマットする 1 つまたは複数の .ql または .qll ソース ファイル。 標準入力から読み取るダッシュを指定できます。

-o, --output=<file>

標準出力ストリームではなく、書式設定された QL コードをこのファイルに書き込みます。 複数の入力がある場合は指定できません。

-i, --[no-]in-place

各入力ファイルを、そのコンテンツの書式設定されたバージョンで上書きします。

--[no-]check-only

入力ファイルが正しい書式と ''異なる'' 場合は、出力を書き込む代わりに、状態 1 で終了します。** -qq も指定しない限り、どのファイルが異なるかを示すメッセージが標準エラーに出力されます。

-b, --backup=<ext>

既に存在するファイルを書き込む場合は、この拡張子をその名前に追加して、既存のファイルの名前をバックアップに変更します。 バックアップ ファイルが既に存在する場合は、自動的に削除されます。

--no-syntax-errors

入力ファイルが構文的に正しい QL でない場合は、既に正しく書式設定されていると見せかけます (通常、このようなファイルを使用すると、コマンドがエラー メッセージで終了します)。

共通オプション

-h, --help

このヘルプ テキストを表示します。

-J=<opt>

[詳細設定] コマンドを実行している JVM にオプションを指定します

(スペースを含むオプションは、正しく処理されないことにご注意ください)。

-v, --verbose

出力される進行状況メッセージの数を段階的に増やします。

-q, --quiet

出力される進行状況メッセージの数を段階的に減らします。

--verbosity=<level>

[詳細設定] 詳細レベルを、errors、warnings、progress、progress+、progress++、progress+++ のいずれかに明示的に設定します。 -v-q がオーバーライドされます。

--logdir=<dir>

[詳細設定] タイムスタンプと実行中のサブコマンドの名前を含む生成された名前を使って、指定されたディレクトリ内の 1 つまた複数のファイルに詳細なログを書き込みます

(完全に制御できる名前でログ ファイルを書き込むには、代わりに --log-to-stderr を指定し、必要に応じて stderr をリダイレクトします)。