scons-time - Интернет в облаке

ПРОГРАММА:

ИМЯ

scons-time - генерировать и отображать информацию о времени SCons

СИНТАКСИС

бра подкоманда [кредита...] [Аргументы...]

ПОЛУЧЕНИЕ СРОКИ ИНФОРМАЦИЯ

бра пробег [-hnqv] [--aegis =ПРОЕКТ] [-f ФАЙЛОВ] [--число =НОМЕР] [--outdir =ВНЕШНИЙ] [-p
STRING] [--python =ПИТОН] [-s DIR] [--scons =СКОНС] [--svn =URL] [АРГУМЕНТЫ]

экстрагирование Функция Расписание
бра FUNC [-h] [--chdir =DIR] [-f ФАЙЛОВ] [--fmt =ФОРМАТ] [--func =ИМЯ] [-p STRING] [-t
НОМЕР] [--title = TITLE] [АРГУМЕНТЫ]

экстрагирование Память Показатели
бра сувениры [-h] [--chdir =DIR] [-f ФАЙЛОВ] [--fmt =ФОРМАТ] [-p STRING] [--stage =ЭТАП] [-t
НОМЕР] [--title =TITLE] [АРГУМЕНТЫ]

экстрагирование объект Графы
бра об [-h] [--chdir =DIR] [-f ФАЙЛОВ] [--fmt =ФОРМАТ] [-p STRING] [--stage =ЭТАП] [-t
НОМЕР] [--title =TITLE] [АРГУМЕНТЫ]

экстрагирование Типы раз
бра время [-h] [--chdir =DIR] [-f ФАЙЛОВ] [--fmt =ФОРМАТ] [-p STRING] [-t НОМЕР]
[--title =TITLE] [--which =КОТОРЫЙ] [АРГУМЕНТЫ]

Помощь Текст
бра помощь ПОДКОМАНДА [...]

ОПИСАНИЕ

Команда бра команда запускает конфигурацию SCons через стандартный набор профилированных
тайминги и может извлекать и отображать информацию из результирующих профилей и файлов журналов
те сроки. Действие, которое должен выполнить бра сценарий задается
подкоманда, первый аргумент в командной строке. См. Раздел ПОДКОМАНДЫ ниже для
информация о работе конкретных подкоманд.

Основной способ использования бра это запустить бра пробег подкоманда (возможно, несколько
раз), чтобы сгенерировать вывод файла профиля и журнала, а затем использовать одну из других подкоманд
для отображения результатов, записанных в профилях и файлах журнала для определенного типа
информация: тайминги функций ( бра FUNC подкоманда), общий объем используемой памяти (
бра сувениры подкоманда), количество объектов ( бра об подкоманда) и в целом
время исполнения ( бра время подкоманда). Существуют варианты размещения и поиска
профили и файлы журналов в отдельных каталогах, чтобы сгенерировать вывод в формате
подходит для построения графиков с Gnuplot(1) программа и так далее.

Есть два основных способа бра пробег подкоманда предназначена для сбора
статистика времени для конфигурации. Один из них - использовать --svn = возможность протестировать
конфигурацию со списком ревизий из репозитория SCons Subversion. Это будет
генерировать профиль и файл журнала времени для каждой ревизии, указанной с --число =
вариант, и может использоваться, чтобы посмотреть влияние зафиксированных изменений на базу кода SCons
на конкретной конфигурации с течением времени.

Другой способ - профилировать инкрементальные изменения в локальной базе кода SCons во время
цикл разработки - то есть посмотреть на влияние на производительность изменений, которые вы вносите в
местное дерево. В этом режиме вы запускаете бра пробег подкоманда без --svn =
вариант, и в этом случае он просто просматривает выходной каталог файла профиля / журнала (
текущий каталог по умолчанию) и автоматически определяет следующий номер запуска для
выходной профиль и файл журнала. При таком использовании цикл разработки выглядит примерно так:
внести изменения в SCons; запустить бра пробег профилировать его в соответствии с определенной конфигурацией;
внести еще одно изменение в SCons; запустить бра пробег снова профилировать его; и т.п.

ДОПОЛНИТЕЛЬНЫЕ ОПЦИИ

Команда бра команда поддерживает только несколько глобальных параметров:

-х, --помощь
Отображает общий текст справки и выходы, идентичные бра помощь подкоманда.

-V, --версия
Отображает бра версия и выходы.

Большинство функций контролируется параметрами отдельных подкоманд. Смотрите следующий
раздел для получения информации об отдельных параметрах подкоманд.

ПОДКОМАНДЫ

Команда бра команда поддерживает следующие отдельные подкоманды.

Команда FUNC Подкоманда
бра FUNC [-h] [--chdir =DIR] [-f ФАЙЛОВ] [--fmt =ФОРМАТ] [--func =ИМЯ] [-p STRING] [-t
НОМЕР] [--title = TITLE] [АРГУМЕНТЫ]

Команда бра FUNC подкоманда отображает информацию о времени для конкретной функции Python
внутри SCons. По умолчанию он извлекает информацию о _основной() функция, которая
включает время профилировщика Python для всех SCons.

Команда бра FUNC подкоманда извлекает информацию о времени функции из всех указанных
аргументы файла, которые должны быть выходными файлами профилировщика Python. (Обычно это
* .prof файлы, созданные бра пробег подкоманды, но на самом деле они могут быть
генерируется любым вызовом профилировщика Python.) Все аргументы имени файла будут объединены для
файлы на диске.

Если аргументы не указаны, то информация о времени функции будет извлечена из всех
* .prof файлы или их подмножество с префиксом, указанным в -p опцию.

Опции включают:

-C КАТАЛОГ, --chdir = КАТАЛОГ
Изменения в указанном СПРАВОЧНИК перед поиском указанных файлов (или файлов
которые соответствуют указанным шаблонам).

-f ФАЙЛ, --file = ФАЙЛ
Считывает информацию о конфигурации из указанного ФАЙЛОВ.

-fmt = ФОРМАТ, --format = ФОРМАТ
Сообщает о выходе в указанном ФОРМАТ. В настоящее время поддерживаются следующие форматы: ASCII
(по умолчанию) и Gnuplot.

--func = ИМЯ
Извлекает тайминги для указанной функции ИМЯ. По умолчанию отчет является совокупным.
сроки для _основной(), которая содержит весь запуск SCons.

-х, --помощь
Отображает текст справки для бра FUNC подкоманда.

-p СТРОКА, --prefix = СТРОКА
Задает строку префикса для профилей, из которых нужно извлечь время функции.
Информация. Это будет использоваться для поиска профилей, если не указаны аргументы
командная строка.

-t ЧИСЛО, --tail = НОМЕР
Извлекает тайминги функций только из последнего НОМЕР файлы.

Команда помощь Подкоманда
бра помощь ПОДКОМАНДА [...] помощь подкоманда печатает текст справки для любого другого
подкоманды, перечисленные в качестве последующих аргументов в командной строке.

Команда сувениры Подкоманда
бра сувениры [-h] [--chdir =DIR] [-f ФАЙЛОВ] [--fmt =ФОРМАТ] [-p STRING] [--stage =ЭТАП] [-t
НОМЕР] [--title =TITLE] [АРГУМЕНТЫ]

Команда бра сувениры подкоманда показывает, сколько памяти использует SCons.

Команда бра сувениры подкоманда извлекает информацию об использовании памяти из всего указанного файла
аргументы, которые должны быть файлами, содержащими вывод запущенных SCons с
--debug = память вариант. (Обычно это * .log файлы, созданные бра
пробег подкоманда.) Все аргументы имени файла будут объединены для файлов на диске.

Если аргументы не указаны, информация о памяти будет извлечена из всех * .log
файлы или их подмножество с префиксом, указанным в -p опцию.

-C DIR, --chdir = DIR
Изменения в указанном СПРАВОЧНИК перед поиском указанных файлов (или файлов
которые соответствуют указанным шаблонам).

-f ФАЙЛ, --file = ФАЙЛ
Считывает информацию о конфигурации из указанного ФАЙЛОВ.

-fmt = ФОРМАТ, --format = ФОРМАТ
Сообщает о выходе в указанном ФОРМАТ. В настоящее время поддерживаются следующие форматы: ASCII
(по умолчанию) и Gnuplot.

-х, --помощь
Отображает текст справки для бра сувениры подкоманда.

-p СТРОКА, --prefix = СТРОКА
Задает строку префикса для файлов журнала, из которых следует извлечь информацию об использовании памяти.
Информация. Это будет использоваться для поиска файлов журнала, если не указаны аргументы.
в командной строке.

--stage = ЭТАП
Печатает память, использованную в конце указанного ЭТАП: предварительно прочитать (перед
Читаются файлы SConscript), читать после , (после чтения файлов SConscript),
предварительная сборка (до того, как будут построены какие-либо цели) или после сборки (после того, как построены любые мишени).
Если нет --сцена опция указана, поведение по умолчанию после сборки, который сообщает
окончательный объем памяти, используемый SCons во время каждого запуска.

-t ЧИСЛО, --tail = НОМЕР
Сообщает только статистику памяти с последнего НОМЕР файлы.

Команда об Подкоманда
бра об [-h] [--chdir =DIR] [-f ФАЙЛОВ] [--fmt =ФОРМАТ] [-p STRING] [--stage =ЭТАП] [-t
НОМЕР] [--title =TITLE] [АРГУМЕНТЫ]

Команда бра об подкоманда показывает, сколько объектов определенного именованного типа
создано SCons.

Команда бра об подкоманда извлекает количество объектов из всего указанного файла
аргументы, которые должны быть файлами, содержащими вывод запущенных SCons с
--debug = количество вариант. (Обычно это * .log файлы, созданные бра
пробег подкоманда.) Все аргументы имени файла будут объединены для файлов на диске.

Если аргументы не указаны, то счетчики объектов будут извлечены из всех * .log файлы,
или их подмножество с префиксом, указанным -p опцию.

-C DIR, --chdir = DIR
Изменения в указанном СПРАВОЧНИК перед поиском указанных файлов (или файлов
которые соответствуют указанным шаблонам).

-f ФАЙЛ, --file = ФАЙЛ
Считывает информацию о конфигурации из указанного ФАЙЛОВ.

-fmt = ФОРМАТ, --format = ФОРМАТ
Сообщает о выходе в указанном ФОРМАТ. В настоящее время поддерживаются следующие форматы: ASCII
(по умолчанию) и Gnuplot.

-х, --помощь
Отображает текст справки для бра об подкоманда.

-p СТРОКА, --prefix = СТРОКА
Задает строку префикса для файлов журнала, из которых следует извлечь счетчики объектов. Этот
будет использоваться для поиска файлов журнала, если в команде не указаны аргументы
линии.

--stage = ЭТАП
Печатает количество объектов в конце указанного ЭТАП: предварительно прочитать (перед
Читаются файлы SConscript), читать после , (после чтения файлов SConscript),
предварительная сборка (до того, как будут построены какие-либо цели) или после сборки (после того, как построены любые мишени).
Если нет --сцена опция указана, поведение по умолчанию после сборки, который сообщает
окончательное количество объектов во время каждого прогона.

-t ЧИСЛО, --tail = НОМЕР
Сообщает только количество объектов с последнего НОМЕР файлы.

Команда пробег Подкоманда
бра пробег [-hnqv] [--aegis =ПРОЕКТ] [-f ФАЙЛОВ] [--число =НОМЕР] [--outdir =ВНЕШНИЙ] [-p
STRING] [--python =ПИТОН] [-s DIR] [--scons =СКОНС] [--svn =URL] [АРГУМЕНТЫ] бра
пробег подкоманда - это основная подкоманда для профилирования конкретной конфигурации по
версия SCons.

Тестируемая конфигурация указывается в виде списка файлов или каталогов, которые будут
распаковывается или копируется во временный каталог, в котором будут вызываться SCons. В
бра пробег подкоманда понимает суффиксы файлов, такие как .tar, .tar.gz, . TGZ и .zip и
распакует их содержимое во временный каталог. Если более одного аргумента
указано, каждый будет распакован или скопирован во временный каталог «поверх»
предыдущие архивы или каталоги, поэтому ожидается, что несколько указанных
архивы имеют одинаковую структуру каталогов.

После того, как аргументы файла или каталога распакованы или скопированы во временный каталог,
бра пробег подкоманда запускает запрошенную версию SCons для
конфигурация трижды:

Стартап
SCons запускается с --Помогите вариант, чтобы считывались только файлы SConscript, и
затем печатается текст справки по умолчанию. Это профилирует только предполагаемые "накладные расходы"
запуск SCons и обработка файлов SConscript.

Полная сборка
SCons запускается для сборки всего, что указано в конфигурации. Конкретные цели для
передается по команде, строка может быть указана направлена против ключевое слово в
конфигурационный файл; подробности см. ниже.

Перестраивать
SCons снова запускается в том же только что созданном каталоге. Если зависимости в SCons
конфигурация правильная, это должна быть последняя версия, "ничего не делать" перестроить.

Каждый вызов фиксирует выходной файл журнала и профиль.

Команда бра пробег подкоманда поддерживает следующие параметры:

--aegis = ПРОЕКТ
Определяет Aegis ПРОЕКТ из которых версия (и) бра быть рассчитанным будет
извлечен. Когда --эгида указано, --число =НОМЕР опция указывает дельту
числа, которые будут проверены. Результат каждого запуска будет помещен в файл.
имена, соответствующие дельта-числам Aegis. Если --число = опция не указана,
тогда поведение по умолчанию - время окончания указанного ПРОЕКТ.

-f ФАЙЛ, --file = ФАЙЛ
Считывает информацию о конфигурации из указанного ФАЙЛОВ. Это часто дает больше
удобный способ указать и собрать параметры, связанные с конкретным сроком
конфигурации, чем указание их в командной строке. Смотрите КОНФИГУРАЦИОННЫЙ ФАЙЛ
раздел ниже для получения информации о параметрах файла конфигурации.

-х, --помощь
Отображает текст справки для бра пробег подкоманда.

-n, --no-exec
Не выполняйте команды, просто печатайте эквиваленты командной строки того, что было бы
выполнен. Обратите внимание, что бра скрипт фактически выполняет свои действия на Python,
где возможно, для портативности. Отображаются команды UNIX. эквиваленты о том, что
это делает.

--number = ЧИСЛО
Задает номер запуска, который будет использоваться в именах файлов журнала и выходных данных профиля.
генерируется этим запуском.

При использовании вместе с --aegis =ПРОЕКТ вариант, НОМЕР указывает один или несколько
разделенные запятыми дельта-числа Aegis, которые будут автоматически извлечены из
уточнил Aegis ПРОЕКТ.

При использовании вместе с --svn =URL вариант, НОМЕР указывает один или несколько
разделенные запятыми номера ревизий Subversion, которые будут автоматически извлечены из
Репозиторий Subversion в указанном URL. Диапазоны дельта-номеров или номеров версий могут быть
указывается разделением двух чисел дефисом (-).

Пример:

% scons-time run --svn =http://scons.tigris.org/svn/trunk --num = 1247,1249-1252.

-p СТРОКА, --prefix = СТРОКА
Задает строку префикса, которая будет использоваться для всех сгенерированных файлов журналов и профилей.
к этому пробегу. Значение по умолчанию является производным от первого указанного аргумента: если первый
аргумент - это каталог, префиксом по умолчанию является имя каталога; если первый
аргумент - это архив (tar или zip-файл), префиксом по умолчанию является базовое имя
архив, то есть то, что осталось после удаления суффикса архива (. TGZ, .tar.gz
or .zip).

--python = ПИТОН
Задает путь к исполняемому файлу Python, который будет использоваться для расчетов времени. По умолчанию
заключается в использовании того же исполняемого файла Python, на котором запущен бра сама команда.

-к, --тишина
Подавляет отображение выполняемых командных строк.

-s DIR, --subdir = DIR
Задает имя каталога или подкаталога, из которого должны быть отправлены команды.
выполнен. По умолчанию - XXX.

--scons = SCONS
Задает путь к сценарию SCons, который будет использоваться для выполнения отсчета времени. По умолчанию
XXX

--svn = URL, --subversion = URL
Определяет URL репозитория Subversion, из которого версия (и) бра
время будет извлечено. Когда --svn указано, --число =НОМЕР вариант
указывает номера ревизий, которые будут проверяться. Результат каждого запуска вызова будет
быть помещенными в имена файлов, которые соответствуют номерам ревизий Subversion. Если --число =
не указан, то по умолчанию время ГОЛОВА
указанный URL.

-v, --подробный
Отображает вывод отдельных команд на экран (в дополнение к захвату
вывод в файлы журнала).

Команда время Подкоманда
бра время [-h] [--chdir =DIR] [-f ФАЙЛОВ] [--fmt =ФОРМАТ] [-p STRING] [-t НОМЕР]
[--title =TITLE] [--which =КОТОРЫЙ] [АРГУМЕНТЫ]

Команда бра время подкоманда отображает время выполнения SCons, как сообщает бра
--debug = время опцию.

Команда бра время подкоманда извлекает время SCons из всего указанного файла
аргументы, которые должны быть файлами, содержащими вывод запущенных SCons с
--debug = время вариант. (Обычно это * .log файлы, созданные бра пробег
подкоманда.) Все аргументы имени файла будут объединены для файлов на диске.

Если аргументы не указаны, время выполнения будет извлечено из всех * .log
файлы или их подмножество с префиксом, указанным в -p опцию.

-C DIR, --chdir = DIR
Изменения в указанном СПРАВОЧНИК перед поиском указанных файлов (или файлов
которые соответствуют указанным шаблонам).

-f ФАЙЛ, --file = ФАЙЛ
Считывает информацию о конфигурации из указанного ФАЙЛОВ.

-fmt = ФОРМАТ, --format = ФОРМАТ
Сообщает о выходе в указанном ФОРМАТ. В настоящее время поддерживаются следующие форматы: ASCII
(по умолчанию) и Gnuplot.

-х, --помощь
Отображает текст справки для бра время подкоманда.

-p СТРОКА, --prefix = СТРОКА
Задает строку префикса для файлов журнала, из которых следует извлечь время выполнения.
Это будет использоваться для поиска файлов журнала, если в команде не указаны аргументы.
линии.

-t ЧИСЛО, --tail = НОМЕР
Сообщает только количество объектов с последнего НОМЕР файлы.

--which = КОТОРЫЙ
Печатает время выполнения для указанного КОТОРЫЙ значение: общий (общее исполнение
время), Призывники (общее время выполнения самих файлов SConscript), SCons
(время выполнения в самом коде SCons) или команды (время выполнения команд и
другие действия, используемые для построения мишеней). Если нет --который опция указана, по умолчанию
поведение общий, который сообщает общее время выполнения для каждого запуска.

КОНФИГУРАЦИЯ ФАЙЛОВ

Различный бра подкоманды могут считывать информацию из указанного файла конфигурации
когда прошел -f or --файл параметры. Файл конфигурации фактически выполняется как
Скрипт Python. Установка переменных Python в файле конфигурации контролирует поведение
бра скрипт удобнее, чем указывать параметры командной строки или
аргументы для каждого запуска и предоставляет удобный способ "упаковать" необходимые
информация для составления (и отчетности) согласованных временных прогонов для заданного
конфигурации.

эгида
Исполняемый файл Aegis для извлечения дельт. По умолчанию просто эгида.

эгида_проект
Проект Aegis, из которого нужно извлекать дельты. По умолчанию все равно
указано с --aegis = параметр командной строки.

архив_список
Список архивов (файлов или каталогов), которые будут скопированы во временную
каталог, в котором будут вызываться SCons. .tar, .tar.gz, . TGZ и .zip файлы будут
распаковать их содержимое во временном каталоге. Деревья каталогов и файлы
будут скопированы как есть.

начальные_команды
Список команд, которые будут выполнены до фактического заданного времени. бра бежит. Это может
использоваться для команд, которые необходимы для подготовки дерева исходных текстов, например,
создание файла конфигурации, который не должен быть частью синхронизированного запуска.

key_location
Расположение ключа в графической информации Gnuplot, созданной с помощью
--format = gnuplot вариант. По умолчанию нижний оставил.

префикс
Префикс имени файла, который будет использоваться при запуске или извлечении времени для этого
конфигурации.

питон
Путь к исполняемому файлу Python, который будет использоваться при запуске или извлечении.
информация для этой конфигурации. По умолчанию используется та же версия Python, которая использовалась для
запустить SCons

бра
Путь к сценарию SCons, который будет использоваться при запуске или извлечении информации.
для этой конфигурации. По умолчанию просто бра.

scons_flags
Команда бра флаги, используемые при запуске SCons для сбора информации о времени. По умолчанию
Значение --debug = количество --debug = память --debug = время --debug = мемоизатор.

scons_lib_dir, scons_wrapper, start_targets, подкаталог
Поддиректория проекта, в которую бра сценарий должен измениться перед
своевременное выполнение команд SCons.

subversion_url
URL Subversion из

СВН
Исполняемый файл Subversion, используемый для проверки исправлений SCons, подлежащих синхронизации. В
по умолчанию просто СВН.

svn_co_flag, деготь, направлена против
Строка, содержащая цели, которые следует добавлять в командную строку каждого
своевременное бра бег. Это можно использовать, чтобы ограничить то, что приурочено к подмножеству
полная сборка для комплектации.

цели0, цели1, цели2, название, расстегнуть молнию, подробный, вертикальные_бары

Пример
Вот пример бра файл конфигурации для гипотетического образца проекта:

# Проект изначально не использует SCons (пока), поэтому мы
# синхронизируем отдельный набор файлов SConscript, которые мы закладываем
# поверх ванильного распакованного архива проекта.
arguments = ['проект-1.2.tgz', 'проект-SConscripts.tar']

# Имя подкаталога содержит номер версии проекта,
# так что скажите scons-time to chdir перед сборкой.
subdir = 'проект-1.2'

# Задайте префикс, чтобы имена выходных файлов журналов и профилей назывались:
# project-000- [012]. {log, prof}
# project-001- [012]. {log, prof}
# и т.д.
префикс = 'проект'

# Тестируемые файлы SConscript не выполняют никаких действий SConf
# конфигурации, так что запустите их обычный скрипт ./configure
# перед вызовом SCons.
начальные_команды = [
'./configure',
]

# Только время сборки исполняемого файла bin / проекта.
target = 'корзина / проект'

# Время против SCons ревизии ветки / основной ветки
subversion_url = 'http://scons.tigris.org/svn/scons/branches/core'

ОКРУЖАЮЩАЯ СРЕДА

Команда бра скрипт использует следующие переменные среды:

СОХРАНИТЬ
Если это значение установлено, бра сценарий будет удалить временный каталог или
каталоги, в которых он создает указанную конфигурацию или загружает конкретную
версия SCons.

Используйте scons-time онлайн с помощью сервисов onworks.net