Как начать писать модуль для CPAN?

Question

Прямо сейчас у меня есть свой собственный доморощенный тестовый жгут/структура каталогов/поддержка doc strucure/инструменты распространения для моих библиотек. Однако, прочитав сообщение в блоге Write your code like it's going on CPAN, это звучало как хорошая идея. Затем мне пришло в голову, я действительно не знаю, как это сделать.

Каковы некоторые хорошие ресурсы для создания собственных пакетов Perl в структуре, подобной CPAN?

Answer 1

Обычно я начинаю с Module::Starter. Он поставляется с довольно простым command-line tool, который создаст новый дистрибутив из шаблона, включая все необходимые файлы и каталог t /, и так далее. Он также будет создавать либо Makefile.PL (используя ExtUtils :: MakeMaker), либо Build.PL (используя Module :: Build.)

Он также помещает туда пустой файл .pm с шаблонами для вашего POD и например.

Answer 2

Лучшее место для начала - CPAN FAQ.

Как отмечалось там, следующие хорошие ресурсы:

• perldoc perlmod
• perldoc perlmodlib

Как всегда, PerlMonks являются хорошим ресурсом, а также. См. Их «How to make a CPAN Module Distribution».

Answer 3

См. José's Guide for creating modules.

Вам также может понравиться Сэм Трегар Writing Perl Modules for CPAN.

Answer 4

• Ricardo Signes является довольно плодовитым автором модуля, и он часто пишет инструменты, чтобы сделать создание модуля максимально простым. Его модули, как правило, довольно актуальны, и он, похоже, придерживается самых современных подходов к созданию дистрибутива CPAN, поэтому его дистрибутивы, вероятно, являются хорошими примерами. Кажется, он использует Dist::Zilla для управления и загрузки своих дистрибутивов.

• Модуль Module::Starter, который генерирует полезный шаблон, чтобы помочь с созданием современного модуля Perl.

• Напишите тесты! Проверьте Perl Quality Assurance Projects page. Это немного устарело, но у него есть отличные ссылки на качественные материалы для чтения.

• Заканчивать CPANTS, the CPAN Testing Service

• После того как вы читали на лучших инструментов для создания модулей, получить счет на PAUSE, который позволяет Вам управлять своими распределениями на CPAN.

• Соедините #perl канал чата IRC на irc.perl.org. Только около половины обсуждений на самом деле касается Perl, но многие авторы модулей болтаются там, и вы можете многому научиться.