use Template::Config;

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

Переменные пакета такие как $STASH, $SERVICE, $CONTEXT и т.д. содержат имена модулей/пакетов для каждого компонента (Template::Stash, Template::Service и Template::Context, соответственно) и используются различными производящими методами (stash(), service() и context()) для загрузки подходящего модуля. Изменение этих переменных приведет к последующим вызовам подходящего производящего метода, загружающего и инициализирующего объект нового класса.

Загружает модуль посредством require(). Все вхождения '::' в имени модуля преобразуются в '/' и добавляется '.pm'. Возвращает 1 в случае успеха или undef при ошибке. Используйте $class->error(), чтобы получить строку с сообщением об ошибке.

Этот метод выполняет предварительную загрузку всех других модулей Template::*, которые возможно будут использоваться. Он вызывается модулем Template при выполнении под mod_perl ($ENV{MOD_PERL} установлена).

Создает экземпляр нового объекта парсера класса, имя которого указано переменной пакета $PARSER (по умолчанию: Template::Parser). Возвращает ссылку на вновь созданный экземпляр парсера или undef в случае ошибки.

Создает экземпляр нового объекта поставщика шаблонов (по умолчанию: Template::Provider). Как и выше, возвращает ссылку на вновь созданный экземпляр объекта или undef в случае ошибки.

Создает экземпляр нового объекта поставщика плагинов (по умолчанию: Template::Plugins). Как и выше, возвращает ссылку на вновь созданный экземпляр объекта или undef в случае ошибки.

Создает экземпляр нового объекта поставщика фильтров (по умолчанию: Template::Filters). Как и выше, возвращает ссылку на вновь созданный экземпляр объекта или undef в случае ошибки.

Создает экземпляр нового объекта хранилища (Template::Stash или Template::Stash::XS в зависимости от установки по умолчанию, выбранной при установке), используя содержимое хеша, передаваемого в качестве необязательного аргумента как начальные определения переменных. Как и выше, возвращает ссылку на вновь созданный экземпляр объекта или undef в случае ошибки.

Создает экземпляр нового объекта контекста шаблона (по умолчанию: Template::Context). Как и выше, возвращает ссылку на вновь созданный экземпляр объекта или undef в случае ошибки.

Создает экземпляр нового объекта сервиса шаблона (по умолчанию: Template::Service). Как и выше, возвращает ссылку на вновь созданный экземпляр объекта или undef в случае ошибки.

Возвращает корневой каталог установки Template Toolkit, в котором установлены дополнительные компоненты. Любой относительный путь, передаваемый в качестве аргумента будет добавлен к возвращаемому каталогу.

    # например, возвращается '/usr/local/tt2'
    my $ttroot = Template::Config->instdir()
	|| die "$Template::Config::ERROR\n";

    # например, возвращается '/usr/local/tt2/templates'
    my $template = Template::Config->instdir('templates')
	|| die "$Template::Config::ERROR\n";

Возвращает undef и соответственно устанавливает $Template::Config::ERROR, если дополнительные компоненты Template Toolkit не установлены.

Энди Уардли (Andy Wardley <abw@andywardley.com>)

http://www.andywardley.com/

2.68, поставляется в составе Template Toolkit версии 2.14, дата релиза - 4 октября 2004.

  Copyright (C) 1996-2004 Andy Wardley.  All Rights Reserved.
  Copyright (C) 1998-2002 Canon Research Centre Europe Ltd.

Этот модуль является свободно-распространяемым программным обеспечением; вы можете распространять и/или модифицировать его на тех же условиях, что и Perl.

Template