Modern::Perl - enable all of the features of Modern Perl with one import
Modern Perl programs use several modules to enable additional features of Perl
and of the CPAN. Instead of copying and pasting all of these "use"
lines, instead write only one:
This enables the strict and warnings pragmas, as well as all of the features
available in Perl 5.10. It also enables C3 method resolution order as
documented in "perldoc mro" and loads IO::File and IO::Handle so
that you may call methods on filehandles. In the future, it may include
additional core modules and pragmas (but is unlikely to include non-core
Because so much of this module's behavior uses lexically scoped pragmas, you may
disable these pragmas within an inner scope with:
for more information, <http://www.modernperlbooks.com/> for further
discussion of Modern Perl and its implications, and
<http://onyxneon.com/books/modern_perl/index.html> for a
freely-downloadable Modern Perl tutorial.
If you want to wrap Modern::Perl in your own "import()" method, you
can do so to add additional pragmas or features, such as the use of Try::Tiny.
Please note that, if you do so, you will not
automatically enable C3
method resolution in the calling scope. This is due to how the mro pragma
works. In your custom "import()" method, you will need to write code
mro::set_mro( scalar caller(), 'c3' );
For forward compatibility, I recommend you specify a string containing a
value as the single optional import tag. For example:
use Modern::Perl '2009';
use Modern::Perl '2010';
... both enable 5.10 features, while:
use Modern::Perl '2011';
... enables 5.12 features:
use Modern::Perl '2012';
... enables 5.14 features:
use Modern::Perl '2013';
... enables 5.16 features, and:
use Modern::Perl '2014';
... enables 5.18 features, and:
use Modern::Perl '2015';
... enables 5.20 features, and:
use Modern::Perl '2016';
... enables 5.24 features, and:
use Modern::Perl '2017';
... enables 5.24 features, and:
use Modern::Perl '2018';
... enables 5.26 features.
Obviously you cannot use newer features on earlier versions. Perl will throw the
appropriate exception if you try.
chromatic, "<chromatic at wgz.org>"
Please report any bugs or feature requests to "bug-modern-perl at
rt.cpan.org", or through the web interface at
<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Modern-Perl>. I will be
notified, and then you'll automatically be notified of progress on your bug as
I make changes.
You can find documentation for this module with the perldoc command.
You can also look for information at:
- RT: CPAN's request tracker
- AnnoCPAN: Annotated CPAN documentation
- CPAN Ratings
- Search CPAN
Damian Conway (inspiration from Toolkit), Florian Ragwitz (B::Hooks::Parser, so
I didn't have to write it myself), chocolateboy (for suggesting that I don't
even need B::Hooks::Parser), Damien Learns Perl, David Moreno, Evan Carroll,
Elliot Shank, Andreas König, Father Chrysostomos, Gryphon Shafer, and
Norbert E. Grüner for reporting bugs, filing patches, and requesting
This software is copyright (c) 2018 by email@example.com.
This is free software; you can redistribute it and/or modify it under the same
terms as the Perl 5 programming language system itself.