perlutil

СОДЕРЖАНИЕ

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

НАЗВАНИЕ

perlutil — утилиты, входящие в комплект Perl

ОПИСАНИЕ

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

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

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

perldoc

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

pod2man

pod2text

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

pod2html

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

pod2usage

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

podchecker

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

splain

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

roffitall

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

Конвертеры

pl2pm

Чтобы помочь вам преобразовать старые программы в более современный 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 из файлов отображения символов Unicode (.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

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

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

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

encguess

encguess попытается определить кодировку символов файлов.

json_pp

json_pp — чистый Perl-конвертер и форматировщик JSON.

piconv

piconv — Perl-версия iconv(1), конвертера кодировок символов, широко используемого на различных 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.

streamzip

streamzip сжимает данные, поступающие на стандартный ввод, в потоковый zip-контейнер.

zipdetails

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

Установка

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

cpan

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

perl -MCPAN -e shell

instmodsh

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

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

perldoc, pod2man, pod2text, pod2html, pod2usage, podchecker, splain, pl2pm, perlbug, h2ph, h2xs, enc2xs, xsubpp, cpan, encguess, instmodsh, json_pp, piconv, prove, corelist, ptar, ptardiff, shasum, streamzip, zipdetails