Perl
For nontrivial changes to this page, please ask / propose the changes on the talk page first! Dilfridge (talk) 14:18, 18 April 2017 (UTC)
Perl is a general purpose interpreted programming language with a powerful regular expression engine.
Introduction
The Perl language itself is packaged as dev-lang/perl. There're three Perl-related categories:
- dev-perl: Libraries in / for Perl, corresponding to dev-java, dev-python, etc. In most cases the package name directly corresponds to a CPAN distribution.
- perl-core: Packages in this category are modules included in dev-lang/perl, which are also independently packaged on CPAN. When modules are installed via perl-core, they override the counterpart in the core dev-lang/perl. This can be used for selective bugfixes. For the details, see below - but please never manually install any perl-core packages with emerge.
- virtual/perl-*: Virtual packages that allow choosing a module between perl-core/ packages and the one contained in the core dev-lang/perl. If you need a specific version of a core package, emerge the corresponding virtual - and the package manager will figure out if a perl-core/ package is needed or not.
More on perl-core[1]:
- It allows users to have more update versions of some modules that the core ones.
- It allows package-based installation, without bumping or patching the core perl.
- Sometimes these modules get deprecated in newer Perl. Such cases are handled by virtual/perl-*. Search [1] for "Module::Build" for more in-depth stories.
Normally you do not have to care at all about perl-core packages or virtuals; if you need any specifics there they should be pulled in as dependencies.
Installation
USE flags
Global
Since many packages depend on the perl, Portage is aware of the perl USE flag. It can be enabled (or disabled) globally:
/etc/portage/make.confUSE="perl"
This is typically only required if carrying out a lot of Perl development locally.
Package
USE flags for dev-lang/perl Larry Wall's Practical Extraction and Report Language
berkdb
|
Add support for sys-libs/db (Berkeley DB for MySQL) |
debug
|
Enable extra debug codepaths, like asserts and extra output. If you want to get meaningful backtraces see https://wiki.gentoo.org/wiki/Project:Quality_Assurance/Backtraces |
doc
|
Add extra documentation (API, Javadoc, etc). It is recommended to enable per package instead of globally |
gdbm
|
Add support for sys-libs/gdbm (GNU database libraries) |
ithreads
|
Enable Perl threads, has some compatibility problems |
minimal
|
Install a very minimal build (disables, for example, plugins, fonts, most drivers, non-critical features) |
quadmath
|
Enable 128bit floating point arithmetic via libquadmath |
As always, after adjusting USE flags, be sure to tell Portage to apply the changes to installed packages on the system:
root #emerge --ask --update --changed-use --deep --autounmask-keep-masks=y @worldIn addition, after changing the ithreads or debug use flag setting, you need to re-build all packages installing perl modules or linking to libperl:
root #perl-cleaner --reallyallUpgrading
The official way of upgrading Perl, e.g. from Perl 5.36 to Perl 5.38, is upgrading your entire world, and upgrading Perl with it. This is because Portage needs to be able to rebuild packages depending on Perl. If you ask Portage to selectively only upgrade the Perl package itself, it can't do this and the emerge command will fail.
As in all cases when automatic rebuilds are involved, it helps a lot if you do regular updates and regularly run depclean.
The official way
root #emerge -uDNav --backtrack=100 --autounmask-keep-masks=y @world
root #perl-cleaner --all
The need for the --backtrack=100 switches will go away over upcoming Portage releases.
If this fails, please check your world file for packages which cannot be updated/reinstalled because they've been removed or are in some way masked.
Some knowledge
- Perl modules are installed under e.g., /usr/lib/perl5/vendor_perl/5.36/. Note that the core Perl version number is present. When upgrading Perl by a major version, the packages providing these modules have to be re-emerged, too.
- The same is valid for all packages linking to libperl.
- The rebuilds 'should' be done automatically by emerge.
app-admin/perl-cleanerexists to do them as well and can catch things missed by emerge (sadly Portage still has some bugs). - During Perl upgrade, packages that depend on Perl may become unavailable.
- No rebuilds are necessary during a point-release update (i.e. from 5.36.0 to 5.36.1).
In order to upgrade your Perl installation to unstable (~arch) version on an otherwise stable system, add the following text to /etc/portage/package.accept_keywords:
# use Perl from ~arch dev-lang/perl perl-core/* virtual/perl-*
Perl itself, the perl-core packages and the Perl virtuals 'must' have the same, consistent status (either all stable or all ~arch). What setting you use for dev-perl packages does not matter at all.
Troubleshooting
How do I list all Perl modules installed from CPAN?
The following Bash one-liner can give you a list of all modules:
for MODULE in `perldoc -t perllocal | grep Module | sed -e 's/^.*" //'`; do VERSION=`perldoc -t perllocal | awk "/$MODULE/{y=1;next}y" | grep VERSION | head -n 1`; printf "%30s %s\n" "$MODULE" "$VERSION"; done | sort
See also
- Awk — a scripting language for data extraction
- Bash — the default shell on Gentoo systems and a popular shell program found on many Linux systems.
- CPAN — the Comprehensive Perl Archive Network, Perl's package ecosystem.
- Grep — a tool for searching text files with regular expressions
- PHP — a general-purpose server-side scripting language to produce dynamic web pages.
- Python — an extremely popular cross-platform object oriented programming language.
- Raku — a high-level, general-purpose, and gradually typed programming language with low boilerplate objects, optionally immutable data structures, and an advanced macro system.
- Ruby — an interpreted programming language.
- Sed — a program that uses regular expressions to programmatically modify streams of text
External Resources
Learning Modern Perl
- Why Perl? — A detailed but approachable article on the empowering nature of Perl while still remaining honest about its limitations.
- Learn X in Y minutes, Where X=Perl — A quick but well respected Perl primer.
- perlsyn — A guide to Perl's basic syntax.
- Modern Perl, 4e — An in-depth guide to Perl though v5.22.
- Perl Maven — A large collection of Perl tutorials written by a prominent member of the Perl community.
- perlclasstut — Object-Oriented Programming via the the Corinna object system which debuted in Perl 5.38.
- Corinna — The specification for Perl's modern object syntax as of Perl 5.38; very technically in depth, not really a tutorial.
- Rosetta Code: Perl — examples of common programming tasks in Perl.
- Exercism's Perl 5 track — free interactive online lessons for learning Perl 5.
Learning Perl Regular Expressions
- perlrequick — Perl regular expressions quick start tutorial.
- perlretut — Perl's in depth regular expressions tutorial.
- Regular Expressions.info — An extensive collection of regular expression related resources.
- RegexOne — Learn basic regular expressions with simple interactive exercises.
- Regex Crossword — A crossword puzzle game with clues written as regular expression patterns.
Debugging and Testing
- perldebug — A guide to Perl debugging.
- perltrap — Traps and "foot-guns" for the unwary.
- Test::Tutorial — A tutorial for writing basic tests with Test Anything Protocol (TAP).
Cheat Sheets
- perlcheat — Perl 5's cheat sheet.
- Regex Cheat Sheet — a Perl 5 regex cheat sheet.
Modern Perl Tools
- App::cpanminus — A modern CPAN client.
- Perl::Critic — Critique Perl source code for best-practices.
- Perl::Tidy — Beautify and enhance the readability of Perl source.
- App::opan — A CPAN overlay with local repository (darkpan) support and module version pinning capability.
- Perlbrew — An Perl installation management tool allowing programmers to decouple their code from system Perl.
- zarn — A lightweight static analysis tool for modern Perl application security.
- (R)?ex — A user friendly automation framework written in Perl.
Popular Perl Frameworks
- Mojolicious — Mojolicious is a fresh take on web development.
- Catalyst — the Elegant MVC web application framework.
- Dancer — Dancer is a simple but powerful web application framework.
- Template::Toolkit — Perl's famous Template Processing System.
Code Documentation
- perlpod — the Plain Old Documentation (POD) format, Perl's native documentation format.
- perlpodstyle — Perl's Plain Old Documentation (POD) style guide.
- podchecker — A tool for checking the syntax of Plain Old Documentation (POD) documentations.
- pod2man — A tool for converting POD data to roff (man page) format.
- pod2html — A tool for converting POD files to HTML format.
- Doxygen::Filter::Perl — A Perl code pre-filter for Doxygen-style comments.