perlutil

СОДЕРЖАНИЕ

• НАЗВАНИЕ
• ОПИСАНИЕ
• СПИСОК УТИЛИТ
  • Документация
  • Конвертеры
  • Администрирование
  • Разработка
  • Общие инструменты
  • Установка
• СМОТРИТЕ ТАКЖЕ

НАЗВАНИЕ

perlutil — утилиты, входящие в дистрибутив Perl

ОПИСАНИЕ

Вместе с самим интерпретатором Perl, дистрибутив Perl устанавливает ряд утилит на вашей системе. Также существует несколько утилит, которые используются самим дистрибутивом Perl в процессе установки. Этот документ предназначен для перечисления всех этих утилит, объяснения их назначения и предоставления ссылок на документацию каждого модуля, если это уместно.

СПИСОК УТИЛИТ

Документация

perldoc

Основной интерфейс к документации Perl — perldoc, хотя, если вы читаете это, скорее всего, вы уже нашли его. perldoc извлечёт и отформатирует документацию из любого файла в текущей директории, любого модуля Perl, установленного в системе, или любой из стандартных страниц документации, например, этой. Используйте perldoc <name> для получения информации об любой из утилит, описанных в этом документе.

pod2man и pod2text

Если утилита запускается из терминала, perldoc обычно вызывает pod2man для перевода POD (Plain Old Documentation — см. perlpod для объяснения) в man-страницу, а затем запускает man для её отображения; если man недоступен, будет использоваться pod2text, а результат будет перенаправлен в ваш любимый просмотрщик.

pod2html

Помимо этих двух, существует ещё один конвертер: pod2html создаст HTML-страницы из POD.

pod2usage

Если вам просто нужно узнать, как использовать описанные здесь утилиты, pod2usage извлечёт только раздел «USAGE»; некоторые утилиты автоматически вызовут pod2usage на себе, когда вы вызовете их с -help.

podselect

pod2usage — это частный случай podselect, утилиты для извлечения именованных разделов из документов, написанных в формате POD. Например, у утилит есть разделы «USAGE», а у модулей Perl обычно есть разделы «SYNOPSIS»; podselect -s "SYNOPSIS" ... извлечёт этот раздел для данного файла.

podchecker

Если вы пишете собственную документацию в формате POD, утилита podchecker проверит вашу разметку на ошибки.

splain

splain — это интерфейс к perldiag — вставьте в него сообщение об ошибке, и он его объяснит.

roffitall

Утилита roffitall не установлена на вашей системе, но находится в каталоге pod/ вашего исходного пакета Perl; она конвертирует всю документацию из дистрибутива в формат *roff и создаёт отформатированный PostScript или текстовый файл со всем содержимым.

Конвертеры

Чтобы помочь вам конвертировать старые программы в более современный Perl, утилита pl2pm поможет вам перевести старые библиотеки Perl 4 в новые модули Perl 5.

Администрирование

libnetcfg

Для отображения и изменения конфигурации libnet запустите команду libnetcfg.

perlivp

Программа perlivp настраивается на время сборки исходного кода Perl для проверки версии Perl, под которой она была скомпилирована. Она может быть использована после выполнения make install (или эквивалентной процедуры вашей платформы) для проверки правильности установки Perl и его библиотек.

Разработка

Существует набор утилит, которые помогут вам в разработке программ на Perl, а также в расширении Perl с помощью C.

perlbug

perlbug раньше был рекомендуемым способом сообщения о ошибках в самом интерпретаторе Perl или любом из стандартных модулей библиотеки разработчикам; теперь сообщения об ошибках и исправления должны подаваться на https://github.com/Perl/perl5/issues.

perlthanks

Эта программа предоставляет простой способ отправить сообщение благодарности авторам и разработчикам Perl. Это просто perlbug, установленный под другим именем.

h2ph

До того, как в Perl появился механизм XS для подключения к библиотекам C, программисты получали константы библиотек, читая файлы заголовков C. Вы по-прежнему можете увидеть require 'syscall.ph' или что-то подобное — файл .ph должен создаваться путём выполнения h2ph для соответствующего файла .h. См. документацию h2ph для получения более подробной информации о том, как конвертировать сразу несколько файлов заголовков.

h2xs

h2xs преобразует файлы заголовков C в модули XS и попытается создать как можно больше связей между библиотеками C и модулями Perl. Он также очень полезен для создания скелетов чисто Perl-модулей.

enc2xs

enc2xs создаёт расширение Perl для использования модулем Encode из файлов сопоставления символов Юникода (.ucm) или файлов кодировки Tcl (.enc). Помимо использования во время сборки модуля Encode, вы можете использовать enc2xs для добавления собственной кодировки в perl. Знание XS не требуется.

xsubpp

xsubpp — компилятор для преобразования кода Perl XS в код C. Обычно он запускается make-файлами, созданными ExtUtils::MakeMaker.

xsubpp компилирует код XS в код C, встраивая конструкции, необходимые для того, чтобы функции C могли манипулировать значениями Perl, и создаёт необходимое связующее звено, позволяющее Perl получить доступ к этим функциям.

prove

prove — командная строка для функциональности выполнения тестов модуля Test::Harness. Это альтернатива make test.

corelist

Командная строка интерфейс для Module::CoreList, для запроса модулей, поставляемых с заданными версиями Perl.

Общие инструменты

Несколько инструментов общего назначения поставляются с Perl, в основном потому, что они пришли вместе с модулями, включёнными в дистрибутив Perl.

piconv

piconv — это версия Perl для iconv, конвертера кодировок символов, широко доступного для различных систем Unix. Этот скрипт первоначально был демонстрационным проектом для Perl v5.8.0, но вы можете использовать piconv вместо iconv практически в любом случае.

ptar

ptar — программа типа tar, написанная на чистом Perl.

ptardiff

ptardiff — небольшая утилита, которая генерирует diff между извлечённым архивом и не извлечённым. (Обратите внимание, что эта утилита требует модуля Text::Diff, чтобы работать должным образом; этот модуль не входит в дистрибутив Perl, но доступен с CPAN.)

ptargrep

ptargrep — утилита для применения сопоставления шаблонов к содержимому файлов в архиве tar.

shasum

Эта утилита, которая входит в состав модуля Digest::SHA, используется для вывода или проверки контрольных сумм SHA.

zipdetails

zipdetails отображает информацию о внутренней структуре записей файла zip. Он не отображает никакой информации о сжатых данных, хранящихся в файле zip.

Установка

Эти утилиты помогают управлять дополнительными модулями Perl, которые не входят в дистрибутив Perl.

cpan

cpan — командная строка для CPAN.pm. Он позволяет устанавливать модули или дистрибутивы с CPAN, или просто получать информацию о них, и многое другое. Он похож на командную строку модуля CPAN.

perl -MCPAN -e shell

instmodsh

Небольшой интерфейс к ExtUtils::Installed для проверки установленных модулей, проверки ваших списков пакетов и даже создания tar-архива из установленного модуля.

СМОТРИТЕ ТАКЖЕ

perldoc, pod2man, perlpod, pod2html, pod2usage, podselect, podchecker, splain, perldiag, roffitall|roffitall, File::Find, pl2pm, perlbug, h2ph, h2xs, enc2xs, xsubpp, cpan, instmodsh, piconv, prove, corelist, ptar, ptardiff, shasum, zipdetails