Catalyst::Helper

Catalyst::Helper

Модуль для быстрого создания Catalyst приложения

catalyst.pl  <myappname>
создает набор скриптов для нового Catalyst приложения.  Каждый скрипт содержит документации и хелп по его использованию.


Так же предоставляет несколько полезных методов для Модуля Помощника для вызова когда создается компонент.


Скрипты


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

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

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

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

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


Помощники

"_create.pl" скрипт создает компоненты приложения используемые модулями помощника.

Помощники - классы, которые предоставляют два метода.
* mk_compclass - создает класс компонент
* mk_comptest - создает тест компонента

Поэтому, когда вы вызываете script/myapp_create.pl view MyView TT, при создании пытается выполнить Catalyst::Helper::View::TT->mk_compclass и Catalyst::Helper::View::TT->mk_comptest.

Все классы помощников находятся под одним пространством имен из:
Catalyst::Helper::Model::
Catalyst::Helper::View::
Catalyst::Helper::Controller::
 
Catalyst::Helper::Model::Adaptor - обертывает любой класс в Catalyst модель.
 
Примечание
Помощники прочитают информацию об авторе из /etc/password по умолчанию. Для перезаписи экспортируйте AUTHOR переменную.
 
 

Методы

 
mk_compclass
Этот метод в вашем модуле Помощника будет вызван $helper который является объектом Catalyst::Helper и какие бы ни были другие аргументы, которые добавит пользователь в командной строке. Вы можете использовать $helper чтобы вызвать методы описанные ниже.
Если Помощник не содержит mk_compclass метод, он передаст управление "render_file" с аргументом compclass.

mk_comptest
Аналогично, описанному выше, за исключением (вместо compclass - comptest).

mk_stuff
Этот метод будет вызван, если пользователь не укажет один из обычных типов компонента Виды, Контроллеры, Модели. Так же ему будут переданы установленные пользователем.


Внутренние методы


render_file ($file, $path, $vars, $perms)
Формирует и создает файл из шаблона в DATA используя Template Toolkit. $file - соответствующая часть __DATA__ секции, $path - путь к файлу, $vars - хеш ссылок как ожидаемые Template Toolkit и $perms желанные права доступа (или системные по умолчанию)

get_file($class, $file)
Выбирает содержимое файла из DATA секции. Это используется внутри "render_file". $class - имя класса из области которого будут выбранные DATA данные. __PACKAGE__ или (caller(0))[0] могут быть чувствительными значениями для этого.

mk_app
Создает каркас главного приложения. Это вызывается catalyst.pl

mk_component($app)
Создает новые компоненты при вызове create.pl

mk_dir($path)
Создает директорию.
 
mk_file($file, $content)
Пишет содержимое в файл. Вызывается "render_file"
 
next_test($test_name)
Вычисляет имя следующего пронумерованного тестового файла и возвращает его. Не передавайте номер или .t окончание для имени теста.
 
get_sharedir_file
Метод для вытаскивания файла из общей области.

render_file_contents
Обрабатывает Template::Toolkit шаблон.

render_sharedir_file
Формирует template/image файл из директории общего доступа.