.. _testing-custom-queries:

Testing custom queries
======================

.. pull-quote:: 
  This article was moved to "`Testing custom queries <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries>`__" on the `GitHub Docs <https://docs.github.com/en/code-security/codeql-cli>`__ site as of January 2023.
  
  .. include:: ../reusables/codeql-cli-articles-migration-note.rst

.. include:: ../reusables/codeql-cli-migration-toc-note.rst

* `Setting up a test CodeQL pack for custom queries <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries#setting-up-a-test-codeql-pack-for-custom-queries>`__
* `Setting up the test files for a query <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries#setting-up-the-test-files-for-a-query>`__
* `Running codeql test run <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries#running-codeql-test-run>`__
* `Example <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries#example>`__
    * `Prepare a query and test files <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries#prepare-a-query-and-test-files>`__
    * `Execute the test <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries#execute-the-test>`__
    * `View the query test output <https://docs.github.com/en/code-security/codeql-cli/using-the-codeql-cli/testing-custom-queries#view-the-query-test-output>`__