perlutil

СОДЕРЖАНИЕ

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

ИМЯ

perlutil - утилиты, входящие в дистрибутив 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- или текстовый файл со всем содержимым.

Конвертеры

Для помощи в преобразовании устаревших программ в более современный 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

Интерфейс командной строки для 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, podchecker, splain, perldiag, roffitall|roffitall, File::Find, pl2pm, perlbug, h2ph, h2xs, enc2xs, xsubpp, cpan, instmodsh, piconv, prove, corelist, ptar, ptardiff, shasum, zipdetails