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

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

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

Несколько универсальных инструментов поставляются с 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