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 просто извлечёт раздел «Использование»; некоторые утилиты автоматически вызовут 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), конвертера кодировок символов, широко доступного для различных Unixen сегодня. Этот скрипт был в первую очередь демонстрационной технологией для 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 сжимает данные, переданные в STDIN, в потоковый 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