question:Привет, рад тебя снова видеть

question:ты технический писатель с опытом работы более 5 лет. ты занимался описанием систем сборок maven, meson, компилятор gcc и других консольных утилит. Тебе дали задание описать систему сборки byb make. Команды этой сборки интегрированы в универсальную утилиту byb. Инженеры предоставили тебе описание утилиты byb. Вот это описание " Утилита byb- основной консольный инструмент для сборки, тестирования и пакетирования исходных кодов. Как задавать и настраивать опции byb — сложная утилита с большим количеством подкоманд, у каждой из которых существует большое количество опций, меняющих поведение утилиты. Для того чтобы удобно задавать, менять и управлять настройками исполнения, есть несколько способов: Аргументы командной строки (аргумент --help или -h/-hh/-hhh покажет доступные аргументы) Переменные окружения (чаще всего начинаются с префикса byb_) Файлы byb.conf в формате toml Как сгенерировать byb.conf Формат byb.conf должен быть представлен в виде toml файла. Для опций без параметров следует указывать true в качестве значения. Для опций "словарей" (например flags), следует открывать одноимённую секцию (таблицу), где дальше будут следовать записи в формате key = "val". Например: [flags] NO_DEBUGINFO = "yes" Порядок применения опций Места возможных расположений файла с опциями byb (каждый последующий может переопределять поля предыдущего): arcadia/byb.conf arcadia/junk/{USER}/byb.conf arcadia/../byb.conf (если вы хотите иметь разный конфиг для разных репозиториев) ~/.byb/byb.conf переменные окружения аргументы командной строки Так же есть возможность менять имя byb.conf (каждый последующий может переопределять поля предыдущего): byb.conf (сначала обрабатывается файл из корня аркадии, потом из junk, ...) byb.{system}.conf byb.{command}.conf Модификаторы {command} и {system} влияют на то, из какой подкомманды (handler) и на какой системе (windows, linux, darwin, java, unknown) будет применяется данный файл конфигурации. То есть, например, чтобы конфигурация применялась для хэндлера make на платформе darwin достаточно создать в одном из удобных мест файл с названием, например, byb.make.darwin.conf. Опции для конкретных команд byb Если одна и та же опция используется в нескольких хендлерах и вам нужны, в зависимости от хендлера, разные значения, можно точно указать нужный хендлер и переопределить опции только для него. Например: project_output = "/default/path" [ide.qt] project_output = "/path/to/qt/project" [ide.msvs] project_output = "c:pathtomsvsproject" Таким образом byb ide qt и byb ide msvs будут иметь разные пути до проекта, отличные от значения по умолчанию. Пример с переопределением словарной опции flags только для хендлера byb dump json-test-list [flags] NO_DEBUGINFO = "yes" [dump.json-test-list.flags] MY_SPECIAL_FLAG = "yes" Вызов byb dump json-test-list в этом случае будет эквивалентен byb dump json-test-list -DMY_SPECIAL_FLAG="yes", NO_DEBUGINFO не будет использоваться. Подстановка переменных окружения Строковые ключи могут указывать переменные окружения в формате {ENV_VAR}, которые будут подменяться после загрузки конфигов. Дополнительно резолвится переменная окружения byb_ARCADIA_ROOT, которая указывает на Аркадию, из которой работает byb. Например: output_root = "{byb_ARCADIA_ROOT}/../out" Изменение цветовой схемы byb по умолчанию Для колоризации byb использует внутри текста свои маркеры, которые при выводе на терминал изменяют цвет последующего текста: alt1 = "cyan" alt2 = "magenta" alt3 = "light-blue" bad = "red" good = "green" imp = "light-default" path = "yellow" unimp = "dark-default" warn = "yellow" Значения по умолчанию можно изменить с помощью секции terminal_profile в конфиге, например: [terminal_profile] bad = "light-red" unimp = "default" Добавление целевых платформ Подробнее про платформы можно найти в документации по byb make. Подробнее о том, как добавить целевые плафтормы через командную строку. Чтобы добавить интересующие целевые платформы, достаточно несколько раз описать следующую конструкцию: [[target_platform]] platform_name = "default-darwin-arm64" build_type = "relwithdebinfo" [target_platform.flags] ANY_FLAG = "flag_value" ANY_OTHER_FLAG = "flag_value" На каждый параметр командной строки --target-platform-smth существует аналогичный ключ для файла конфигурации. Внимание Не нужно добавлять целевые платформы в файлы конфигурации внутри аркадии — эта конфигурация автоматически применится на всех машинах. Описание дополнительных опций (alias) Если есть необходимость постоянно задавать одни и те же аргументы, их можно объединить в alias. Для описания alias-ов используется синтаксис toml Array of Tables. Пример: --add-go-result Например, если нужно добавить симлинки на сгенерированные go файлы, приходится писать что-то подобное: byb make path/to/project --replace-result --add-result=.go --no-output-for=.cgo1.go --no-output-for=.res.go --no-output-for=_cgo_gotypes.go --no-output-for=_cgo_import.go В качестве решения можно записать всё в файл junk/<username>/byb.make.conf следующие строки: # junk/<username>/byb.make.conf replace_result = true # --replace-result add_result_extend = [".go"] # --add-result=.go suppress_outputs = [".cgo1", ".res.go", "_cgo_gotypes.go"] # ----no-output-for=.cgo1.go --no-output-for=.res.go --no-output-for=_cgo_gotypes.go В таком случае значения будут применяться всегда (при всех запусках byb make для пользователя <username>). Если же необходимо иметь возможность включать данное поведение, можно использовать технологию alias-ов: # junk/<username>/byb.conf # ^ alias will be available only for user <username> # ^ in any handler [[alias]] # define new alias # Any keys, available in byb.conf replace_result = true add_result_extend = [".go"] suppress_outputs = [".cgo1", ".res.go", "_cgo_gotypes.go"] [alias._settings.arg] # define argument for this alias names = ["--add-go-result"] # define only long name help = "Add generated .go files" # define help string visible = true # make this argument visible in `byb make --help` Теперь флаг --add-go-result виден в выводе byb make --help, и мы можем сократить команду до: byb make path/to/project --add-go-result Пример: отключение предпостроенных тулов Чтобы отключить использование предпостроенных тулов, нужно запускать byb со следующими аргументами: byb make path/to/project -DUSE_PREBUILT_TOOLS=no --host-platform-flag=USE_PREBUILT_TOOLS=no Сначала опишем желаемое поведение в byb.conf: [host_platform_flags] USE_PREBUILT_TOOLS = "no" [flags] USE_PREBUILT_TOOLS = "no" Теперь опишем alias, который будет включаться по аргументу, переменной окружения или выставлением значения в любом byb.conf: [[alias]] [alias.host_platform_flags] # host_platform_flags is subkey for alias USE_PREBUILT_TOOLS = "no" [alias.flags] # flags is subkey for alias USE_PREBUILT_TOOLS = "no" [alias._settings.arg] # define argument names = ["-p", "--disable-prebild-tools"] # define short and long name help = "Disable prebuild tools" visible = true [alias._settings.env] # define environment value name = "byb_DISABLE_PREBUILD_TOOLS" [alias._settings.conf] # define config key name = "disable_prebuild_tools" Теперь, чтобы активировать это поведение, можно воспользоваться следующими способами: # Long argument byb make path/to/project --disable-prebuild-tools # Short argument byb make path/to/project -p # Env byb_DISABLE_PREBUILD_TOOLS=yes byb make path/to/project # Config value echo "ndisable_prebuild_tools=truen" >> junk/USER/byb.conf byb make path/to/project Несколько alias-ов Можно создавать любое количество alias-ов внутри одного файла. Alias-ы из разных файлов не перезаписывают друг друга. Задавать описанную переменную в блоке [alias._settings.conf] можно в любом файле, в любом месте, так как создание alias-ов происходит до применения значений из файлов конфигурации. # path/to/first/byb.conf some_values = true third_alias = true [[alias]] # ... [alias._settings.conf] name = "first_alias" [[alias]] # ... # path/to/second/byb.conf some_other_values = true [[alias]] # ... [alias._settings.conf] name = "third_alias" [[alias]] first_alias = true # ... Пример с target_platform [[alias]] [[alias.target_platform]] # --target-platform platfom_name = "..." build_type = "debug" # --target-platform-debug run_tests = true # --target-platform-tests target_platform_compiler = "c_compiler" # --target-platform-c-compiler # ... [alias.target_platform.flags] # --target-platform-flag FLAG = true OTHER_FLAG = "other_value" [alias._settings.arg] # Create argument consumer for alias names = ["-a", "--my-cool-alias"] # Short and long name help = "This alias are awesome! It really helps me" # Help string visible = true # make it visible in `byb make --help` [alias._settings.env] # Create environment consumer for alias, must starts with byb name = "byb_MY_COOL_ALIAS" [alias._settings.conf] # Create config consumer for alias, can be enabled from any config-file name = "my_cool_alias" Семантика alias Внутри одного блока [[alias]] можно задавать произвольное количество опций и под-опций. Для создания аргумента или переменной окружения нужно описать их в ключах [alias._settings.arg] и [alias._settings.env], как показано в примере. После этого они станут доступными во всех подкомандах byb. Для создания опции, которая будет существовать только в конкретном handler-е (например make), достаточно дописать между ключами alias и settings произвольный префикс: [alias.make._settings.args] — будет работать только в byb make ... [alias.ide.idea._settings.args] — будет работать только в byb ide idea ... При заполнении ключа [alias._settings.conf] создаётся опция, которую можно явно включить в любом конфигурационном файле (даже в том, который применился раньше — поиск и обработка alias-ов происходит до применения значений). Более того, появляется возможность применять один alias внутри другого, обеспечивая таким образом простейшую композицию. Внимание Пока мы не рекомендуем использовать композицию — byb может вести себя непредсказуемо. Но мы будем рады, если вы попробуете :) Важно Переменные окружения и опции в файлах конфигурациях не могут иметь значений, отличных от булевых, при этом если в значение передано false, соответствующий alias не активируется. Аргумент является флагом и не может принимать никаких значений. Обо всех проблемах и идеях улучшений смело рассказывайте в очередь DEVTOOLSSUPPORT Композиция Если возникла необходимость вынести общую часть из alias-ов, можно воспользоваться композицией. Пусть у нас есть два alias-а: [[alias]] first_value = 1 second_value = 2 [[alias._settings.arg]] names = ["--first"] [[alias]] second_value = 2 third_value = 3 [[alias._settings.arg]] names = ["--second"] Чтобы вынести общую часть, нужно создать новый alias c параметром конфигурации: [[alias]] second_value = 2 [[alias._settings.conf]] name = "common_alias" [[alias]] first_value = 1 common_alias = true # Call alias [[alias._settings.arg]] names = ["--first"] [[alias]] common_alias = true # Call alias third_value = 3 [[alias._settings.arg]] names = ["--second"] Теперь, при вызове byb <handler> --second применится alias common_alias, и выставится значение для third_value. Особенности: Можно вызывать несколько alias-ов внутри другого alias-а Глубина «вложенности» может быть любой Есть защита от циклов Можно использовать alias, объявленный позже места использования или находящийся в другом файле " Вот еще одно описание " byb make Запустить сборку и тестировние. byb make [OPTION]... [TARGET]... Опции -d Debug build -r Release build --sanitize=SANITIZE Sanitizer type(address, memory, thread, undefined, leak) --sanitizer-flag=SANITIZER_FLAGS Additional flag for sanitizer --lto Build with LTO --thinlto Build with ThinLTO --sanitize-coverage=SANITIZE_COVERAGE Enable sanitize coverage --afl Use AFL instead of libFuzzer --musl Build with musl-libc --pch Build with Precompiled Headers --hardening Build with hardening --race Build Go projects with race detector --cuda=CUDA_PLATFORM Cuda platform(optional, required, disabled) (default: optional) --report-config=REPORT_CONFIG_PATH Set path to TestEnvironment report config -k, --keep-going Build as much as possible -v, --verbose Be verbose -T Do not rewrite output information (ninja/make) --do-not-output-stderrs Do not output any stderrs -h, --help Print help -j=BUILD_THREADS, --threads=BUILD_THREADS Build threads count (default: NCPU) --clear Clear temporary data --no-src-links Do not create any symlink in source directory --ttl=TTL Resource TTL in days (pass 'inf' - to mark resource not removable) (default: 14) -o=OUTPUT_ROOT, --output=OUTPUT_ROOT Directory with build results --no-output-for=SUPPRESS_OUTPUTS Do not symlink/copy output for files with given suffix, they may still be save in cache as result --checkout Checkout missing dirs -q, --quiet Checkout silently (for svn) Testing options Run tests -t, --run-tests Run tests (-t runs only SMALL tests, -tt runs SMALL and MEDIUM tests, -ttt runs SMALL, MEDIUM and FAT tests) -A, --run-all-tests Run test suites of all sizes --add-peerdirs-tests=PEERDIRS_TEST_TYPE Peerdirs test types (none, gen, all) (default: none) --test-threads=TEST_THREADS Restriction on concurrent tests (no limit by default) (default: 0) --fail-fast Fail after the first test failure -L, --list-tests List tests Filtering -X, --last-failed-tests restart tests which failed in last run for chosen target -F=TESTS_FILTERS, --test-filter=TESTS_FILTERS Run only tests that match <tests-filter> --test-size=TEST_SIZE_FILTERS Run only specified set of tests --test-type=TEST_TYPE_FILTERS Run only specified types of tests --style Run only "classpath.clash flake8.py2 flake8.py3 gofmt govet java.style" style tests (implies --strip-skipped-test-deps) --regular-tests Run only "boost_test exectest fuzz g_benchmark go_bench go_test gtest java py2test py3test pytest unittest" test types --test-tag=TEST_TAGS_FILTER Run tests that have specified tag --test-filename=TEST_FILES_FILTER Run only tests with specified filenames (pytest only) --test-size-timeout=TEST_SIZE_TIMEOUTS Set test timeout for each size (small=60, medium=600, large=3600) Console report -P, --show-passed-tests Show passed tests --show-skipped-tests Show skipped tests --inline-diff Disable truncation of the comments and print diff to the terminal --show-metrics Show metrics on console (You need to add "-P" option to see metrics for the passed tests) Linters --disable-flake8-migrations Enable all flake8 checks Canonization -Z, --canonize-tests Canonize selected tests --canonize-via-skynet use skynet to upload big canonical data --canonize-via-http use http to upload big canonical data --canon-diff=TEST_DIFF Show test canonical data diff, allowed values are r<revision>, rev1:rev2, HEAD, PREV Debugging --pdb Start pdb on errors --gdb Run c++ unittests in gdb --tests-retries=TESTS_RETRIES Run every test specified number of times (default: 1) --no-random-ports Use requested ports --test-stderr Output test stderr to console online --test-stdout Output test stdout to console online --test-disable-timeout Turn off timeout for tests (only for local runs, incompatible with --cache-tests, --dist) --test-debug Test debug mode (prints test pid after launch and implies --test-threads=1 --test-disable-timeout --retest --test-stderr) --disable-test-graceful-shutdown Test node will be killed immediately after the timeout Runtime environment --test-param=TEST_PARAMS Arbitrary parameters to be passed to tests (name=val) --private-ram-drive Creates a private ram drive for all test nodes requesting one Test uid calculation --cache-tests Use cache for tests --retest No cache for tests Test dependencies --strip-skipped-test-deps Don't build skipped test's dependencies --drop-graph-result-before-tests Build only targets required for requested tests File reports --allure=ALLURE_REPORT (deprecated) Path to allure report to be generated --junit=JUNIT_PATH Path to junit report to be generated Test outputs --no-test-outputs Don't save testing_out_stuff --no-dir-outputs (deprecated) Tar testing output dir in the intermediate machinery --keep-full-test-logs Don't truncate logs on distbuild --test-keep-symlinks Don't delete symlinks from test output Tests over YT --run-tagged-tests-on-yt Run tests marked with byb:yt tag on the YT --ytexec-bin=YTEXEC_BIN use local ytexec binary --ytexec-run Use ytexec tool to run YT vanilla operations (should be used with "--run-tagged-tests-on-yt") Tests over Sandbox --run-tagged-tests-on-sandbox Run tests marked with byb:force_sandbox tag on the Sandbox Coverage --coverage (deprecated) Collect coverage information. (deprecated alias for "--gcov --java-coverage --python-coverage --coverage-report") --coverage-prefix-filter=COVERAGE_PREFIX_FILTER Inspect only matched paths --coverage-exclude-regexp=COVERAGE_EXCLUDE_REGEXP Exclude matched paths from coverage report --coverage-report-path=COVERAGE_REPORT_PATH Path inside output dir where to store gcov cpp coverage report (use with --output) --python-coverage Collect python coverage information --go-coverage Collect go coverage information --java-coverage Collect java coverage information --merge-coverage Merge all resolved coverage files to one file --sancov Collect sanitize coverage information (automatically increases tests timeout at 1.5 times) --clang-coverage Clang's source based coverage (automatically increases tests timeout at 1.5 times) --fast-clang-coverage-merge Merge profiles in the memory in test's runtime using fuse --coverage-report Build HTML coverage report (use with --output) --enable-java-contrib-coverage Add sources and classes from contib/java into jacoco report --enable-contrib-coverage Build contrib with coverage options and insert coverage.extractor tests for contrib binaries --nlg-coverage Collect Alice's NLG coverage information Fuzzing --fuzzing Extend test's corpus --fuzz-opts=FUZZ_OPTS Space separated string of fuzzing options (default: ) --fuzz-case=FUZZ_CASE_FILENAME Specify path to the file with data for fuzzing (conflicting with "--fuzzing") --fuzz-minimization-only Allows to run minimization without fuzzing (should be used with "--fuzzing") Pytest specific --test-log-level=TEST_LOG_LEVEL Specifies logging level for output test logs ("critical", "error", "warning", "info", "debug") --test-traceback=TEST_TRACEBACK Test traceback style for pytests ("long", "short", "line", "native", "no") (default: short) --profile-pytest Profile pytest calls Java tests specific --jstyle-runner-path=JSTYLE_RUNNER_PATH Path to custom runner for java style tests -R=PROPERTIES, --system-property=PROPERTIES Set system property (name=val) --system-properties-file=PROPERTIES_FILES Load system properties from file --jvm-args=JVM_ARGS Add jvm args for jvm launch Developer options --test-tool-bin=TEST_TOOL_BIN Path to test_tool binary --test-tool3-bin=TEST_TOOL3_BIN Path to test_tool3 binary --profile-test-tool=PROFILE_TEST_TOOL Profile specified test_tool handlers --build=BUILD_TYPE Build type (debug, release, profile, gprof, valgrind, valgrind-release, coverage, relwithdebinfo, minsizerel, debugnoasserts, fastdebug) https://wiki.bybndex-team.ru/bybtool/build-types (default: debug) -D=FLAGS Set variables (name[=val], "yes" if val is omitted) --rebuild Rebuild all --strict-inputs Enable strict mode --build-results-report=BUILD_RESULTS_REPORT_FILE Dump build report to file in the --output-dir --build-results-report-tests-only Report only test results in the report --build-report-type=BUILD_REPORT_TYPE Build report type(canonical, human_readable) (default: canonical) --build-results-resource-id=BUILD_RESULTS_RESOURCE_ID Id of sandbox resource id containing build results --use-links-in-report Use links in report instead of local paths --report-skipped-suites Report skipped suites --report-skipped-suites-only Report only skipped suites --dump-raw-results Dump raw build results to the output root -C=BUILD_TARGETS, --target=BUILD_TARGETS Targets to build --stat Show additional statistics --stat-dir=STATISTICS_OUT_DIR Additional statistics output dir --mask-roots Mask source and build root paths in stderr -S=CUSTOM_SOURCE_ROOT, --source-root=CUSTOM_SOURCE_ROOT Custom source root (autodetected by default) -B=CUSTOM_BUILD_DIRECTORY, --build-dir=CUSTOM_BUILD_DIRECTORY Custom build directory (autodetected by default) --misc-build-info-dir=MISC_BUILD_INFO_DIR Directory for miscellaneous build files (build directory by default) --host-build-type=HOST_BUILD_TYPE Host platform build type (debug, release, profile, gprof, valgrind, valgrind-release, coverage, relwithdebinfo, minsizerel, debugnoasserts, fastdebug) https://wiki.bybndex-team.ru/bybtool/build-types (default: release) --host-platform=HOST_PLATFORM Host platform --host-platform-flag=HOST_PLATFORM_FLAGS Host platform flag --c-compiler=C_COMPILER Specifies path to the custom compiler for the host and target platforms --cxx-compiler=CXX_COMPILER Specifies path to the custom compiler for the host and target platforms --target-platform=TARGET_PLATFORMS Target platform --target-platform-build-type=TARGET_PLATFORM_BUILD_TYPE Set build type for the last target platform --target-platform-release Set release build type for the last target platform --target-platform-debug Set debug build type for the last target platform --target-platform-tests Run tests for the last target platform --target-platform-test-size=TARGET_PLATFORM_TEST_SIZE Run tests only with given size for the last target platform --target-platform-test-type=TARGET_PLATFORM_TEST_TYPE Run tests only with given type for the last target platform --target-platform-regular-tests Run only "boost_test exectest fuzz go_bench go_test gtest g_benchmark java junit py2test py3test pytest testng unittest" test types for the last target platform --target-platform-flag=TARGET_PLATFORM_FLAG Set build flag for the last target platform --target-platform-c-compiler=TARGET_PLATFORM_COMPILER Specifies path to the custom compiler for the last target platform --target-platform-cxx-compiler=TARGET_PLATFORM_COMPILER Specifies path to the custom compiler for the last target platform --universal-binaries Generate multiplatform binaries --show-command=SHOW_COMMAND Print command for selected build output --add-result=ADD_RESULT Process selected build output as a result --add-protobuf-result Process protobuf output as a result --add-flatbuf-result Process flatbuf output as a result --show-timings Print execution time for commands --show-extra-progress Print extra progress info --replace-result Build only --add-result targets --add-modules-to-results Process all modules as results --no-local-executor Use Popen instead of local executor --use-clonefile Use clonefile instead of hardlink on macOS --force-build-depends Build by DEPENDS anyway --ignore-recurses Do not build by RECURSES -I=INSTALL_DIR, --install=INSTALL_DIR Path to accumulate resulting binaries and libraries --html-display=HTML_DISPLAY Alternative output in html format --teamcity Generate additional info for teamcity --tools-cache-size=TOOLS_CACHE_SIZE Max tool cache size (default: 30GiB) --cache-size=CACHE_SIZE Max cache size (default: 300GiB) --pgo-add Create PGO profile --pgo-use=PGO_USER_PATH PGO profiles path --pic Force PIC mode --maps-mobile Enable mapsmobi configuration preset --share-results Share results with skynet --profile=PROFILE_TO_FILE Write profile info to file --stages=STAGES_PROFILE Write stages info to file -x=DEBUG_OPTIONS, --dev=DEBUG_OPTIONS ymake debug options --vcs-file=VCS_FILE Provides VCS file --dump-files-path=DUMP_FILE_PATH Put extra ymake dumps into specified directory --dev-conf=CONF_DEBUG_OPTIONS Configure step debug options: list-files, print-commands, force-run, verbose-run --ymake-bin=YMAKE_BIN Path to ymake binary --no-ymake-resource Do not use ymake binary as part of build commands --no-byb-bin-resource Do not use byb-bin binary as part of build commands --do-not-use-local-conf Do not use local configuration files --local-conf-path=LOCAL_CONF_PATH Path to <local.ymake> --build-custom-json=CUSTOM_JSON Build custom graph specified by file name --custom-context=CUSTOM_CONTEXT Use custom context specified by file name (requires additionally passing --build-custom-json) -G, --dump-graph Dump full build graph to stdout --dump-json-graph Dump full build graph as json to stdout -M, --makefile Generate Makefile --dist Run on distbuild --keep-temps Do not remove temporary build roots. Print test's working directory to the stderr (use --test-stderr to make sure it's printed at the test start) --profile-to=PROFILE_TO Run with cProfile --log-file=LOG_FILE Append verbose log into specified file --evlog-file=EVLOG_FILE Dump event log into specified file --no-evlogs Disable standard evlogs in byb_CACHE_DIR --evlog-dump-platform Add platform in event message --cache-stat Show cache statistics --gc Remove all cache except uids from the current graph --gc-symlinks Remove all symlink results except files from the current graph --symlinks-ttl=SYMLINKS_TTL Results cache TTL (default: 168.0h) --yt-store Use YT storage --yt-proxy=YT_PROXY YT storage proxy (default: hahn.yt.bybndex.net) --yt-dir=YT_DIR YT storage cypress directory pass (default: //home/devtools/cache) --yt-token=YT_TOKEN YT token --yt-token-path=YT_TOKEN_PATH YT token path (default: ~/.yt/token) --yt-put Upload to YT store --yt-create-tables Create YT storage tables --yt-max-store-size=YT_MAX_CACHE_SIZE YT storage max size --yt-store-filter=YT_CACHE_FILTER YT store filter --yt-store-ttl=YT_STORE_TTL YT store ttl in hours(0 for infinity) (default: 24) --yt-store-codec=YT_STORE_CODEC YT store codec --yt-replace-result Build only targets that need to be uploaded to the YT store --yt-store-threads=YT_STORE_THREADS YT store max threads (default: 3) --raw-params=RAW_PARAMS Params dict as json encoded with base64 --dump-distbuild-result=DUMP_DISTBUILD_RESULT Dump result returned by distbuild (default: False) --build-time=BUILD_EXECUTION_TIME Set maximum build execution time (in seconds) -E, --download-artifacts Download build artifacts when using distributed build --sonar Analyze code with sonar. --sonar-project-filter=SONAR_PROJECT_FILTERS Analyze only projects that match any filter -N=SONAR_PROPERTIES, --sonar-property=SONAR_PROPERTIES Property for sonar analyzer(name[=val], "yes" if val is omitted") --sonar-java-args=SONAR_JAVA_ARGS Java machine properties for sonar scanner run --get-deps=GET_DEPS Compile and collect all dependencies into specified directory -s, --sources Make sources jars as well --maven-export Export to maven repository --maven-no-recursive-deps Not export recursive dependencies --maven-exclude-transitive-from-deps Exclude transitive from dependencies --version=VERSION Version of artifacts for exporting to maven --deploy Deploy artifact to repository --repository-id=REPOSITORY_ID Maven repository id --repository-url=REPOSITORY_URL Maven repository url --settings=MAVEN_SETTINGS Maven settings.xml file path --maven-out-dir=MAVEN_OUTPUT Maven output directory( for .class files ) --use-uncanonical-pom-name Use uncanonical pom output filename( {artifact}.pom ) -J=JAVAC_FLAGS, --javac-opts=JAVAC_FLAGS Set common javac flags (name=val) --owner=RESOURCE_OWNER User name to own data saved to sandbox --sandbox-url=SANDBOX_URL sandbox url to use for storing canonical file (default: https://sandbox.bybndex-team.ru) --task-kill-timeout=TASK_KILL_TIMEOUT Timeout in seconds for sandbox uploading task --sandbox Upload to Sandbox --mds Upload to MDS --mds-host=MDS_HOST MDS Host (default: storage.bybndex-team.ru) --mds-port=MDS_PORT MDS Port (default: 80) --mds-namespace=MDS_NAMESPACE MDS namespace (default: devtools) --mds-token=MDS_TOKEN MDS Basic Auth token --key=SSH_KEYS Path to private ssh key to exchange for OAuth token --token=OAUTH_TOKEN oAuth token --user=USERNAME Custom user name for authorization Примеры byb make -r Build current directory in release mode byb make -t -j16 library Build and test library with 16 threads byb make --checkout -j0 Checkout absent directories without build " и еще одно описание "byb tool Запустить иструмент доставляемый byb. byb tool <subcommand> [options] Об инструментах, доставляемых byb Список инструментов можно получить, набрав byb tool без параметров. В перечень входят: разрабатывамые в Яндексе инструменты для внутреннего использования; внешние программы, которые имеют более актуальные версии, чем предоставляют операционные системы, либо поставляются с настройками, адаптированными для использования в инфраструктуре Яндекса. Опции --print-path Only print path to tool, do not execute --print-toolchain-path Print path to toolchain root --print-toolchain-sys-libs Print pathes to toolchsin system libraries --platform=PLATFORM Set specific platform --toolchain=TOOLCHAIN Specify toolchain --get-param=PARAM Get specified param --get-resource-id Get resource id for specific platform (the platform should be specified) --get-task-id Get task id --byb-help Show help --target-platform=TARGET_PLATFORMS Target platform --force-update Check tool for updates before the update interval elapses --force-refetch Refetch toolchain Advanced options --tools-cache-size=TOOLS_CACHE_SIZE Max tool cache size (default: 30GiB) Authorization options --key=SSH_KEYS Path to private ssh key to exchange for OAuth token --token=OAUTH_TOKEN oAuth token --user=USERNAME Custom user name for authorization Список инструментов byb abcd Run abcd cli afl-fuzz Run afl-fuzz ag Run ag (super fast source-code grep) allure Run Allure commandline amduprof-cli AMDuProfCLI is a command-line tool for AMD uProf Profiler amduprof-pcm AMDuProfPcm is a command-line tool to monitor CPU performance metrics of AMD processors apphost Run local apphost instance appteka Run local appteka instance arc Arcadia command-line client atop Advanced System & Process Monitor aws Run aws bigb_ab bigb utility bigb_bb_cluster_analyzer bigb utility bigb_bsyeti_experiments bigb utility bigb_hitlog_analyser bigb utility bigb_request utility to get user info bigb_yt_profiles_dumper bigb utility bigrt_cli bigrt utility black Python styler, Python 3 only black_py2 Python styler with Python 2 support blkiomon monitor block device I/O based o blktrace data blkparse produce formatted output of event streams of block devices from blktrace utility blktrace generate traces of the i/o traffic on block devices bpftool tool for inspection and simple manipulation of eBPF programs and maps bpftrace High-level tracing language for Linux eBPF btt analyse block i/o traces produces by blktrace buf Protobuf lint and breaking change detector c++ Run C++ compiler c++filt Run c++filt caesar_lookup_profile caesar utility caesar_profile_size_analyzer caesar utility caesar_yt_sync caesar utility cc Run C compiler clang-apply-replacements Run clang-apply-replacements companion for clang-tidy clang-format Run Clang-Format source code formatter clang-rename Run Clang-Rename refactoring tool clang-tidy Run Clang-Tidy source code linter cling Run cling cmake Run cmake coronerctl bybndex-coroner cli, https://a.bybndex-team.ru/arc/trunk/arcadia/infra/rsm/coroner/README.md crypta Run Crypta client cs Fast CodeSearch CLI tool ctags Run ctags cuda-check Run cuda-check cue Validate and define text-based and dynamic configuration dctl Run bybndex.Deploy CLI dlv Debugger for the Go programming language dns-client Run dns-client(tools for change RRs) dns-storage Run DNS Storage client eductl eductl is a toolchain of bybndex Education emacs Run emacs exp_stats bsyeti tool fio flexible I/O tester foremost Foremost is a Linux program to recover files based on their headers gcov Run gcov gdb Run gdb gdbnew Run gdb for Ubuntu 16.04 or later gdbserver Run gdbserver gdbservernew Run gdbserver for Ubuntu 16.04 or later go Run go tool (1.18.4) godoc Arcadia version of godoc gofmt Run gofmt tool (1.18.4) gpt_heap Google performance tools: heap checker gpt_perf Google performance tools: performance checker grpc_cli GRPC command-line tool grut Run GrUT CLI horadric Run horadric generator iceflame Performance data collection and analysis infractl Run InfraCtl CLI iowatcher Create visualizations from blktrace results iperf network load tester jar Run jar jar15 Run jar from jdk15 jar17 Run jar from jdk17 java Run java java10 Run java 10 java11 Run java 11 java15 Run java 15 java17 Run java 17 javac Run javac javac10 Run javac 10 javac11 Run javac 11 javac15 Run javac 15 javac17 Run javac 17 jq Run jq jstyle Java styler ktlint Run kotlin styler kubectl Run kubectl CLI lama Analytics tool for safe reactor calculation lambda Run tplatform serverless tool license_analyzer Run devtools license analyzer lkvm kvmtool is a userland tool for creating and controlling KVM guests llvm-cov Run llvm-cov Clang utility llvm-profdata Run llvm-profdata Clang utility llvm-symbolizer Run llvm-symbolizer Clang utility logbroker Logbroker configuration utility logos run logos helpers tools lz4 Compress or decompress .lz4 files marketsre Run Market SRE Cli metrika-core Run metrika-core toolkit mfkit Toolkit for maps frontend mockgen Run GoMock (go mocking framework) news Run news team tools ninja Run ninja nm Run nm nots Everyday multitool for developing TypeScript modules in Arcadia nvim Run neovim objcopy Run objcopy perf Run Perf pprof Run pprof pqos Intel(R) Resource Director Technology monitoring and control tool procaas Run procaas CLI puncher Run Puncher CLI qemu QEMU x86_64 machine emulator and virtualizer qemu-i386 QEMU i386 machine emulator and virtualizer qemu-img QEMU disk image utility qemu-nbd QEMU disk network block device server qyp QYP tool rdtset Task CPU affinity and Intel(R) Resource Director Technology control tool releaser Release tool rem-tool Run REM cli client renderer Run local renderer instance rex Run REX toolkit rex-cli Run REX CLI rm ReleaseMachine cmd tool rsync Run RSync rtcdiag RTC hosts diag tool rtmr-deploy Run RTMR deploy run_python_udf run_python_udf tool samogonctl Run Samogon Controller sandboxctl Tool to run tasks in Sandbox sedem SEDEM tool - Service management tool for Maps services setrace Run SeTrace agent skotty Skotty (SSH-agent) launcher sre Run sretool strace the linux syscall tracer stress-ng stress load tester strip Run strip utility svn Subversion command-line client swagger Run go-swagger tasklet Run tasklet CLI taxi-python Taxi backend-py3 python tctl A command-line tool for Temporal users temporal A CLI to run a Temporal Server and interact with it tmux Run Tmux transfer-manager Run Transfer Manager client tvmknife Tool for debugging and testing with TVM tickets uc Run Uber Compressor valgrind Run valgrind vh3 Run VH3 CLI vim Run vim vmexec VMEXEC run script inside qemu-vm wall-e Client for Wall-E byb_sed This tool simplifies replacing of some text in Arcadia bybdi Arcadia version of bybdi yd-migrate Run deploy migration yf Run YF client yfm-docs YFM-extended markdown processor for Cloud deploy (v3) ymakeyndexer Run ymake ydx converter yndexer Run Yndexer yo Tool for managing vendor/ directory yoimports Go imports formatting tool yp Run low level YP client yp-util Run YP useful stuff yt Run YT client ytexec Run ytexec ytyndexer Run YtYndexer zcli Run zcli (console client for zephyr) zipatcher Apply zipatch from file or Arcanum pull request" . Изучи эти описания и напиши документацию по утилите byb

question:As a prompt generator for a generative AI called "Midjourney", you will create image prompts for the AI to visualize. I will give you a concept, and you will provide a detailed prompt for Midjourney AI to generate an image. Please adhere to the structure and formatting below, and follow these guidelines: Do not use the words "description" or ":" in any form. Do not place a comma between [ar] and [v]. Write each prompt in one line without using return. Structure: [1] = 水墨古风美女 [2] = a detailed description of [1] with specific imagery details. [3] = a detailed description of the scene's environment. [4] = a detailed description of the compositions. [5] = a detailed description of the scene's mood, feelings, and atmosphere. [6] = A style (e.g. photography, painting, illustration, sculpture, artwork, paperwork, 3D, etc.) for [1]. [7] = a detailed description of the scene's mood, feelings, and atmosphere. [ar] = Use "--ar 16:9" for horizontal images, "--ar 9:16" for vertical images, or "--ar 1:1" for square images. [v] = Use "--niji" for Japanese art style, or "--v 5" for other styles. Formatting: Follow this prompt structure: "/imagine prompt: [1], [2], [3], [4], [5], [6], [7], [ar] [v]". Your task: Create 4 distinct prompts for each concept [1], varying in details description, environment,compositions,atmosphere, and realization. Write your prompts in english. Do not describe unreal concepts as "real" or "photographic". Include one realistic photographic style prompt with lens type and size. Separate different prompts with two new lines. Example Prompts: /imagine prompt: cute dog, fluffy fur, wagging tail, playful expression, sitting on a grassy field, under a clear blue sky, with a colorful collar, in a natural and vibrant setting, by a lake, captured with a Nikon D750 camera, 50mm lens, shallow depth of field, composition focused on the dog's face, capturing its joyful spirit, in a style reminiscent of William Wegman's iconic dog portraits. --ar 1:1 --v 5.2 /imagine prompt: beautiful women in the coffee shop, elegant and sophisticated, sipping a cup of steaming coffee, natural sunlight streaming through the window, soft and warm color tones, vintage decor with cozy armchairs and wooden tables, a bookshelf filled with classic novels, delicate porcelain teacups, a hint of aromatic coffee beans in the air, captured by a Leica M10 camera, 35mm lens, capturing the essence of timeless beauty, composition focused on the woman's face and hands, reminiscent of a painting by Leonardo da Vinci. --ar 1:1 --v 5.2 /imagine prompt: A captivating Halo Reach landscape with a Spartan amidst a battlefield, fallen enemies around, smoke and fire in the background, emphasizing the Spartan's determination and bravery, detailed environment blending chaos and beauty, Illustration, digital art, --ar 16:9 --v 5

question:Quanto a Sofocracia, é correto afirmar que: