Catalyst::Devel


-->

Catalyst::Devel - Средство разработки Catalyst


Описание
"Catalyst-Devel" распространяет различные модули полезные при разработки Catalyst приложений, но не требующих их запуска.
Это предназначено для облегчения развертывания Catalyst приложений. Рабочий цикл частей Catalyst теперь назван как "Catalyst::Runtime".
"Catalyst-Devel" включает Catalyst::Helper систему,которая автогенерирует скрипты и тесты; Module::Install::Catalyst, Module::Install расширения для Catalyst; и требования для различны зависимых модулей при разработки. Документация осталась в Catalyst::Runtime.


Catalyst::Runtime - Catalyst фреймворк рабочий цикл

Главный класс для Catalyst-Runtime дистрибьюции. версии 5.80


Catalyst::Helper - Инициализация Catalyst приложений

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

Он также предоставляет некоторые полезные модули для Helper модуля чтобы вызвать когда создается компонент. См "METHODS(методы)".

Скрипты
_create.pl
Используется для создания нового компонента для приложения в стадии разработки.

_server.pl
Тестовый сервер Catalyst, стартуе на HTTPD который выводид отладку в терминал.

_test.pl
Скрипт, для запуска скриптов из командной строки.

_cgi.pl
Запускает приложение как CGI.

_fastcgi.pl
Запускает приложения как fastcgi приложение. Либо в ручную, либо вызов из FastCgiServer в вашем http сервере настроек.




ПОМОЩНИКИ
"_create.pl" скрипт создает компоненты приложения используя Helper модули. Catalyst команда предоставляет хорошее количество Helper для вашего использования. Вы также можете добавить свой собственный.

Хелперы - классы, которые предоставляют два метода.

* mk_compclass - создают Component класс
* mk_comptest - создают Component тест

Итак, когда вы вызываете "scripts/myapp_create.pl view MyView TT", попытается создать для выполнения Catalyst::Helper::View::TT->mk_compclass и Catalyst::Helper::View::TT->mk_comptest.

Module::Install::Catalyst - Module::Install расширения для Catalyst



use inc::Module::Install;

name 'MyApp';
all_from 'lib/MyApp.pm';

requires 'Catalyst::Runtime' => '5.7014';

catalyst_ignore('.*temp');
catalyst_ignore('.*tmp');
catalyst;
WriteAll;


Module::Install расширения для Catalyst.

МЕТОДЫ
 
catalyst
Вызывает catalyst_files и catalyst_par. Желательно быть последней catalyst* командой вызванной в "Makefile.PL".

catalyst_files
Коллекция списка всех файлов Catalyst приложения состоит и копирует это внутрь blib/lib папку. Файлы и дерриктории которые совпадают с модулями игнорируют список исключая (см. catalyst_ignore и catalyst_ignore_all).

catalyst_ignore_all(\@ignore)
Функция заменяет встроенное по умолчани список игнора с заданным списком.

catalyst_ignore(@ignore)
Добавляет регулярку в список игнорируемых шаблонов. Может быть вызван несколько раз.

catalyst_par($name)
catalyst_par_core($core)
catalyst_par_classes(@clases)
catalyst_par_engine($engine)
catalyst_par_multiarch($multiarch)
catalyst_par_options($optstring)
Эта команда может быть использована в Makefile.PL переделывания PAR процесс создания. Параметр "$optstring" содержит строку с аргументами с идентичным синтаксисом как аргументы pp команды из PAR::Packer пакета.

Пример:

# часть вашего Makefile.PL
catalyst_par_options("--verbose=2 -f Bleach -z 9");
# verbose mode; use filter 'Bleach'; zip with compression level 9
catalyst;

Примечание 1: Нет причины использовать catalyst_par_options() команду несколько раз как вы можете объявить в "$optstring" столько раз, сколько пожелаете.
Все еще поддерживается вызов catalyst_par_options() более одного раза. В этом случае объявленные сливаются (коллизии управляются по принципу "послдений победил").
ОСТЕРЕГАЙТЕСЬ: вам не рекомендуется использовать параметры -a -A -X -f -F -I -l -M i в множественных catalyst_par_options() так как они не сливаются, а заменяются, как вы не ожидали.

Примечание 2: По умолчанию опции "-x -p -o=<appname>.par" установлены и опция "-n" не установлена. Это по умолчанию, всегда перезаписывается какую бы вы не выбрали.
catalyst_par_options().

catalyst_par_script($script)
catalyst_par_usage($usage)

См Catalyst.pm