{"meta":{"title":"разрешение файлов","intro":"[Глубокая сантехника] Разверните набор глобов включения и исключения файлов.","product":"Безопасность и качество кода","breadcrumbs":[{"href":"/ru/code-security","title":"Безопасность и качество кода"},{"href":"/ru/code-security/reference","title":"Reference"},{"href":"/ru/code-security/reference/code-scanning","title":"Проверка кода"},{"href":"/ru/code-security/reference/code-scanning/codeql","title":"CodeQL"},{"href":"/ru/code-security/reference/code-scanning/codeql/codeql-cli-manual","title":"Руководство по cli CodeQL"},{"href":"/ru/code-security/reference/code-scanning/codeql/codeql-cli-manual/resolve-files","title":"разрешение файлов"}],"documentType":"article"},"body":"# разрешение файлов\n\n[Глубокая сантехника] Разверните набор глобов включения и исключения файлов.\n\n> [!NOTE]\n> Это содержимое описывает последний выпуск данных CodeQL CLI. Дополнительные сведения об этом выпуске см. в статье https://github.com/github/codeql-cli-binaries/releases.\n>\n> Чтобы просмотреть сведения о параметрах, доступных для этой команды в предыдущем выпуске, выполните команду с <span style=\"white-space: nowrap;\">`--help`</span> параметром в терминале.\n\n## Synopsis\n\n```shell copy\ncodeql resolve files <options>... -- <dir>\n```\n\n## Description\n\n              \\[Глубокий сантехника] Разверните набор глобов включения и исключения файлов.\n\nЭта команда сантехники отвечает за расширение параметров командной строки вложенных команд, работающих с несколькими файлами, идентифицируемых по их путям. По умолчанию все файлы включены и поэтому выполнение этой команды без аргументов фильтра будет собирать все файлы в каталоге.\n\n              `--include`Параметры `--exclude`и `--prune` параметры принимают шаблоны глобов, которые могут использовать следующие подстановочные знаки:\n\n* Один символ \"?\" соответствует любому символу, отличному от косой черты вперед или назад;\n* Один \"\\*\" соответствует любому количеству символов, отличных от косой черты вперед или назад;\n* Шаблон \"\\*\\*\" соответствует нулю или более полным компонентам каталога.\n\n## Options\n\n### Основные параметры\n\n#### `<dir>`\n\nКаталог для поиска.\n\n#### `--format=<fmt>`\n\nВыберите выходной формат либо (по умолчанию),_ либо `text`_`json`.\n\n### Параметры ограничения набора собранных файлов\n\n#### `--include-extension=<.ext>`\n\nВключите все файлы в дерево каталога поиска с заданным расширением. Как правило, перед расширением следует включить точку.\nНапример, передача `--include-extension .xml` будет включать все файлы с расширением \".xml\". Этот параметр несовместим с отрицающими `--include` параметрами.\n\n#### `--include=<glob>`\n\nВключите все файлы и каталоги в дерево каталогов поиска, соответствующие заданному глобу, используя относительный путь к каждому файлу и каталогу из каталога поиска. Если глоб начинается с символа `!` , вместо этого будут исключены соответствующие файлы и каталоги.\n\n              `--include` параметры обрабатываются по порядку, при этом более поздние параметры переопределяют более ранние. Например, `--include ** --include !sub/*.ts --include sub/main.*` будет включать `sub/main.ts` (так как оно включается `sub/main.*`), исключить `sub/index.ts` (так как `!sub/*.ts`оно исключается) и включить `sub/test.js` (поскольку оно включается `**` без последующего исключения).)\n\n#### `--also-match=<glob>`\n\nТребовать, чтобы все результаты соответствовали заданному глобу, используя относительный путь к каждому файлу и каталогу из каталога поиска. Этот параметр имеет ту же структуру и ту же интерпретацию, что `--include` и указать отдельную последовательность глобов, применяемых в сочетании с `--include`.\n\n#### `--exclude=<glob>`\n\nИсключите все файлы и каталоги, соответствующие заданному глобу, используя относительный путь к каждому файлу и каталогу из каталога поиска. Этот параметр переопределяет все параметры включения. Этот параметр несовместим с отрицающими `--include` параметрами.\n\n#### `--prune=<glob>`\n\nИсключите все файлы и каталоги, соответствующие заданному глобу, используя относительный путь к каждому файлу и каталогу из каталога поиска. Этот параметр переопределяет все параметры включения. Этот параметр несовместим с отрицающими `--include` параметрами.\n\n#### `--size-limit=<bytes>`\n\nИсключите все файлы, размер которых превышает заданное ограничение. Ограничение размера в байтах или в кибибайтах (KiB) с суффиксом \"k\", в mebibytes (MiB) с суффиксом \"m\" и в гибибайтах (GiB) с суффиксом \"g\". Этот параметр переопределяет все параметры включения.\n\n#### `--total-size-limit=<bytes>`\n\nВыполните выход команды с ошибкой, если общий размер всех разрешенных файлов превысит заданное ограничение. Ограничение размера в байтах или в кибибайтах (KiB) с суффиксом \"k\", в mebibytes (MiB) с суффиксом \"m\" и в гибибайтах (GiB) с суффиксом \"g\".\n\n#### `--[no-]follow-symlinks`\n\nСледуйте любым символьным ссылкам на их цели.\n\n#### `--[no-]find-any`\n\nНайти не более одного совпадения (в отличие от всех совпадений).\n\nДоступно с момента `v2.11.3`.\n\n### Распространенные параметры\n\n#### `-h, --help`\n\nОтображение этого текста справки.\n\n#### `-J=<opt>`\n\n              \\[Дополнительно] Укажите параметр JVM, выполняя команду.\n\n(Убедитесь, что параметры, содержащие пробелы, не будут обрабатываться правильно.)\n\n#### `-v, --verbose`\n\nПостепенно увеличьте число отображаемых сообщений о ходе выполнения.\n\n#### `-q, --quiet`\n\nПостепенно уменьшайте количество отображаемых сообщений о ходе выполнения.\n\n#### `--verbosity=<level>`\n\n              \\[Дополнительно] Явным образом задайте уровень детализации на одну из ошибок, предупреждений, хода выполнения, хода выполнения+, хода выполнения++, хода выполнения+++. Переопределяет `-v` и `-q`.\n\n#### `--logdir=<dir>`\n\n              \\[Дополнительно] Запись подробных журналов в один или несколько файлов в указанном каталоге с созданными именами, включающими метки времени и имя выполняющегося подкоманда.\n\n(Чтобы записать файл журнала с именем, над которым у вас есть полный контроль, вместо этого предоставьте `--log-to-stderr` и перенаправите stderr по мере необходимости.)\n\n#### `--common-caches=<dir>`\n\n              \\[Дополнительно] Управляет расположением кэшированных данных на диске, которые будут сохраняться между несколькими запусками интерфейса командной строки, такими как скачанные пакеты QL и скомпилированные планы запросов. Если этот параметр не задан явным образом, по умолчанию используется каталог с именем `.codeql` в домашнем каталоге пользователя; он будет создан, если он еще не существует.\n\nДоступно с момента `v2.15.2`."}