Modern-Perl-1.20170117/0000775000175000017500000000000013037317571014756 5ustar chromaticchromaticModern-Perl-1.20170117/dist.ini0000644000175000017500000000174113037317571016423 0ustar chromaticchromaticname = Modern-Perl author = chromatic license = Perl_5 copyright_holder = chromatic@wgz.org copyright_year = 2016 [AutoVersion] format = {{ cldr('1.yyyyMMdd') }} [AutoPrereqs] [Prereqs] perl = 5.010 autodie = 2.22 [@Filter] -bundle = @Basic -remove = Readme [PodWeaver] finder = :InstallModules [PkgVersion] [PodVersion] [NextRelease] [ModuleBuild] [@Git] changelog = Changes ; this is the default allow_dirty = dist.ini ; see Git::Check... allow_dirty = Changes ; ... and Git::Commit commit_msg = v%v%n%n%c ; see Git::Commit tag_format = %v ; see Git::Tag tag_message = %v ; see Git::Tag push_to = origin ; see Git::Push [MetaResources] homepage = https://github.com/chromatic/Modern-Perl repository.url = https://github.com/chromatic/Modern-Perl.git repository.web = https://github.com/chromatic/Modern-Perl repository.type = git Modern-Perl-1.20170117/Changes0000644000175000017500000000475013037317571016255 0ustar chromaticchromaticRevision history for Modern::Perl 1.20170117 2017-01-16 20:37:12-08:00 America/Los_Angeles - cleaned up test suite - fixed Perl 5.25 failures (RT #114690) 1.20170116 2017-01-16 08:46:50-08:00 America/Los_Angeles - updated for 2017 release - maybe 2016 should have supported 5.22, but given how long I waited... oops - improved documentation about reexporting (RT #109076) 1.20161229 2016-12-28 16:02:17-08:00 America/Los_Angeles - improved VERSION numbering (Gryphon Shafer, GH #5) 1.20161005 2016-10-05 09:38:21-07:00 America/Los_Angeles - updated for 2016 release (Gryphon Shafer) - added support for 5.24 1.20150127 2015-01-26 23:21:44-08:00 America/Los_Angeles - updated for 2015 release (Elmer Quintanilla) - added support for 5.20 1.20140107 2014-01-07 15:35:42 America/Los_Angeles - updated for 2014 release - added support for 5.18 1.20121103 2012-11-03 13:30:26 America/Los_Angeles - fixed VERSION( undef ) (Peter Vereshagin, RT #80304) - fixed POD encoding error (Norbert E. Grüner, RT #80468) 1.20120521 2012-05-21 15:58:59 America/Los_Angeles - added Perl 5.16 support 1.20120130 2012-01-30 11:38:08 America/Los_Angeles - fixed t/year_imports.t for 5.10 (ANDK and sprout again) 1.20120126 2012-01-25 22:15:50 America/Los_Angeles - fixed t/regressions.t for 5.10 1.20120123 2012-01-23 10:16:10 America/Los_Angeles - made raw numbers work in import 1.20120119 2012-01-19 15:01:10 America/Los_Angeles - fixed for Perl 5.15.5 and later (ANDK and sprout) 1.20120106 2012-01-05 16:26:09 America/Los_Angeles - loaded IO::File/IO::Handle to allow methods on lexical filehandles - added unimporting - removed use of autodie; moved it to a distribution prerequisite - enabled unicode_strings by default when your Perl supports it 1.20120105 2012-01-04 21:01:10 America/Los_Angeles - migrated to Dist::Zilla - added autodie dependency/import 1.03 Wed Feb 18 00:40:40 UTC 2009 - removed duplicate use lines (Damien Learns Perl) - fixed (hopefully) v-string warnings (Damien, David Moreno) - enabled C3 MRO (Evan Carroll) 1.02 Tue Jan 27 03:44:29 UTC 2009 - removed the current need for B::Hooks::Parser (suggested by chocolateboy) 1.01 Tue Jan 27 01:11:48 UTC 2009 - fixed a documentation typo reported by Vasily Chekalkin - added caveats to the documentation per bug report from Ben Hengst 1.00 Mon Jan 26 22:41:28 UTC 2009 - First version, released on an unsuspecting world. Modern-Perl-1.20170117/Makefile.PL0000644000175000017500000000256713037317571016740 0ustar chromaticchromatic# This file was automatically generated by Dist::Zilla::Plugin::MakeMaker v5.043. use strict; use warnings; use 5.010; use ExtUtils::MakeMaker; my %WriteMakefileArgs = ( "ABSTRACT" => "enable all of the features of Modern Perl with one import", "AUTHOR" => "chromatic", "BUILD_REQUIRES" => { "Module::Build" => "0.28" }, "CONFIGURE_REQUIRES" => { "ExtUtils::MakeMaker" => 0, "Module::Build" => "0.28" }, "DISTNAME" => "Modern-Perl", "LICENSE" => "perl", "MIN_PERL_VERSION" => "5.010", "NAME" => "Modern::Perl", "PREREQ_PM" => { "IO::File" => 0, "IO::Handle" => 0, "autodie" => "2.22", "feature" => 0, "mro" => 0, "strict" => 0, "warnings" => 0 }, "TEST_REQUIRES" => { "Test::More" => "0.98" }, "VERSION" => "1.20170117", "test" => { "TESTS" => "t/*.t" } ); my %FallbackPrereqs = ( "IO::File" => 0, "IO::Handle" => 0, "Module::Build" => "0.28", "Test::More" => "0.98", "autodie" => "2.22", "feature" => 0, "mro" => 0, "strict" => 0, "warnings" => 0 ); unless ( eval { ExtUtils::MakeMaker->VERSION(6.63_03) } ) { delete $WriteMakefileArgs{TEST_REQUIRES}; delete $WriteMakefileArgs{BUILD_REQUIRES}; $WriteMakefileArgs{PREREQ_PM} = \%FallbackPrereqs; } delete $WriteMakefileArgs{CONFIGURE_REQUIRES} unless eval { ExtUtils::MakeMaker->VERSION(6.52) }; WriteMakefile(%WriteMakefileArgs); Modern-Perl-1.20170117/README0000644000175000017500000000202013037317571015626 0ustar chromaticchromaticModern::Perl ------------ Modern Perl often relies on the presence of several core and CPAN pragmas and modules. Wouldn't it be nice to use them all with a single command? Try this one: use Modern::Perl; INSTALLATION To install this module, run the following commands: $ perl Build.PL $ perl ./Build $ perl ./Build test $ sudo perl ./Build install SUPPORT AND DOCUMENTATION After installing, you can find documentation for this module with the perldoc command. perldoc Modern::Perl You can also look for information at: RT, CPAN's request tracker http://rt.cpan.org/NoAuth/Bugs.html?Dist=Modern-Perl AnnoCPAN, Annotated CPAN documentation http://annocpan.org/dist/Modern-Perl CPAN Ratings http://cpanratings.perl.org/d/Modern-Perl Search CPAN http://search.cpan.org/dist/Modern-Perl/ COPYRIGHT AND LICENCE Copyright (C) 2009-2017 chromatic This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. Modern-Perl-1.20170117/META.yml0000644000175000017500000000133213037317571016224 0ustar chromaticchromatic--- abstract: 'enable all of the features of Modern Perl with one import' author: - chromatic build_requires: Module::Build: '0.28' Test::More: '0.98' configure_requires: ExtUtils::MakeMaker: '0' Module::Build: '0.28' dynamic_config: 0 generated_by: 'Dist::Zilla version 5.043, CPAN::Meta::Converter version 2.150001' license: perl meta-spec: url: http://module-build.sourceforge.net/META-spec-v1.4.html version: '1.4' name: Modern-Perl requires: IO::File: '0' IO::Handle: '0' autodie: '2.22' feature: '0' mro: '0' perl: '5.010' strict: '0' warnings: '0' resources: homepage: https://github.com/chromatic/Modern-Perl repository: https://github.com/chromatic/Modern-Perl.git version: '1.20170117' Modern-Perl-1.20170117/LICENSE0000644000175000017500000004367413037317571015777 0ustar chromaticchromaticThis software is copyright (c) 2016 by chromatic@wgz.org. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. Terms of the Perl programming language system itself a) the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version, or b) the "Artistic License" --- The GNU General Public License, Version 1, February 1989 --- This software is Copyright (c) 2016 by chromatic@wgz.org. This is free software, licensed under: The GNU General Public License, Version 1, February 1989 GNU GENERAL PUBLIC LICENSE Version 1, February 1989 Copyright (C) 1989 Free Software Foundation, Inc. 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed. Preamble The license agreements of most software companies try to keep users at the mercy of those companies. By contrast, our General Public License is intended to guarantee your freedom to share and change free software--to make sure the software is free for all its users. The General Public License applies to the Free Software Foundation's software and to any other program whose authors commit to using it. You can use it for your programs, too. When we speak of free software, we are referring to freedom, not price. Specifically, the General Public License is designed to make sure that you have the freedom to give away or sell copies of free software, that you receive source code or can get it if you want it, that you can change the software or use pieces of it in new free programs; and that you know you can do these things. To protect your rights, we need to make restrictions that forbid anyone to deny you these rights or to ask you to surrender the rights. These restrictions translate to certain responsibilities for you if you distribute copies of the software, or if you modify it. For example, if you distribute copies of a such a program, whether gratis or for a fee, you must give the recipients all the rights that you have. You must make sure that they, too, receive or can get the source code. And you must tell them their rights. We protect your rights with two steps: (1) copyright the software, and (2) offer you this license which gives you legal permission to copy, distribute and/or modify the software. Also, for each author's protection and ours, we want to make certain that everyone understands that there is no warranty for this free software. If the software is modified by someone else and passed on, we want its recipients to know that what they have is not the original, so that any problems introduced by others will not reflect on the original authors' reputations. The precise terms and conditions for copying, distribution and modification follow. GNU GENERAL PUBLIC LICENSE TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION 0. This License Agreement applies to any program or other work which contains a notice placed by the copyright holder saying it may be distributed under the terms of this General Public License. The "Program", below, refers to any such program or work, and a "work based on the Program" means either the Program or any work containing the Program or a portion of it, either verbatim or with modifications. Each licensee is addressed as "you". 1. You may copy and distribute verbatim copies of the Program's source code as you receive it, in any medium, provided that you conspicuously and appropriately publish on each copy an appropriate copyright notice and disclaimer of warranty; keep intact all the notices that refer to this General Public License and to the absence of any warranty; and give any other recipients of the Program a copy of this General Public License along with the Program. You may charge a fee for the physical act of transferring a copy. 2. You may modify your copy or copies of the Program or any portion of it, and copy and distribute such modifications under the terms of Paragraph 1 above, provided that you also do the following: a) cause the modified files to carry prominent notices stating that you changed the files and the date of any change; and b) cause the whole of any work that you distribute or publish, that in whole or in part contains the Program or any part thereof, either with or without modifications, to be licensed at no charge to all third parties under the terms of this General Public License (except that you may choose to grant warranty protection to some or all third parties, at your option). c) If the modified program normally reads commands interactively when run, you must cause it, when started running for such interactive use in the simplest and most usual way, to print or display an announcement including an appropriate copyright notice and a notice that there is no warranty (or else, saying that you provide a warranty) and that users may redistribute the program under these conditions, and telling the user how to view a copy of this General Public License. d) You may charge a fee for the physical act of transferring a copy, and you may at your option offer warranty protection in exchange for a fee. Mere aggregation of another independent work with the Program (or its derivative) on a volume of a storage or distribution medium does not bring the other work under the scope of these terms. 3. You may copy and distribute the Program (or a portion or derivative of it, under Paragraph 2) in object code or executable form under the terms of Paragraphs 1 and 2 above provided that you also do one of the following: a) accompany it with the complete corresponding machine-readable source code, which must be distributed under the terms of Paragraphs 1 and 2 above; or, b) accompany it with a written offer, valid for at least three years, to give any third party free (except for a nominal charge for the cost of distribution) a complete machine-readable copy of the corresponding source code, to be distributed under the terms of Paragraphs 1 and 2 above; or, c) accompany it with the information you received as to where the corresponding source code may be obtained. (This alternative is allowed only for noncommercial distribution and only if you received the program in object code or executable form alone.) Source code for a work means the preferred form of the work for making modifications to it. For an executable file, complete source code means all the source code for all modules it contains; but, as a special exception, it need not include source code for modules which are standard libraries that accompany the operating system on which the executable file runs, or for standard header files or definitions files that accompany that operating system. 4. You may not copy, modify, sublicense, distribute or transfer the Program except as expressly provided under this General Public License. Any attempt otherwise to copy, modify, sublicense, distribute or transfer the Program is void, and will automatically terminate your rights to use the Program under this License. However, parties who have received copies, or rights to use copies, from you under this General Public License will not have their licenses terminated so long as such parties remain in full compliance. 5. By copying, distributing or modifying the Program (or any work based on the Program) you indicate your acceptance of this license to do so, and all its terms and conditions. 6. Each time you redistribute the Program (or any work based on the Program), the recipient automatically receives a license from the original licensor to copy, distribute or modify the Program subject to these terms and conditions. You may not impose any further restrictions on the recipients' exercise of the rights granted herein. 7. The Free Software Foundation may publish revised and/or new versions of the General Public License from time to time. Such new versions will be similar in spirit to the present version, but may differ in detail to address new problems or concerns. Each version is given a distinguishing version number. If the Program specifies a version number of the license which applies to it and "any later version", you have the option of following the terms and conditions either of that version or of any later version published by the Free Software Foundation. If the Program does not specify a version number of the license, you may choose any version ever published by the Free Software Foundation. 8. If you wish to incorporate parts of the Program into other free programs whose distribution conditions are different, write to the author to ask for permission. For software which is copyrighted by the Free Software Foundation, write to the Free Software Foundation; we sometimes make exceptions for this. Our decision will be guided by the two goals of preserving the free status of all derivatives of our free software and of promoting the sharing and reuse of software generally. NO WARRANTY 9. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION. 10. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. END OF TERMS AND CONDITIONS Appendix: How to Apply These Terms to Your New Programs If you develop a new program, and you want it to be of the greatest possible use to humanity, the best way to achieve this is to make it free software which everyone can redistribute and change under these terms. To do so, attach the following notices to the program. It is safest to attach them to the start of each source file to most effectively convey the exclusion of warranty; and each file should have at least the "copyright" line and a pointer to where the full notice is found. Copyright (C) 19yy This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 1, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301 USA Also add information on how to contact you by electronic and paper mail. If the program is interactive, make it output a short notice like this when it starts in an interactive mode: Gnomovision version 69, Copyright (C) 19xx name of author Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. This is free software, and you are welcome to redistribute it under certain conditions; type `show c' for details. The hypothetical commands `show w' and `show c' should show the appropriate parts of the General Public License. Of course, the commands you use may be called something other than `show w' and `show c'; they could even be mouse-clicks or menu items--whatever suits your program. You should also get your employer (if you work as a programmer) or your school, if any, to sign a "copyright disclaimer" for the program, if necessary. Here a sample; alter the names: Yoyodyne, Inc., hereby disclaims all copyright interest in the program `Gnomovision' (a program to direct compilers to make passes at assemblers) written by James Hacker. , 1 April 1989 Ty Coon, President of Vice That's all there is to it! --- The Artistic License 1.0 --- This software is Copyright (c) 2016 by chromatic@wgz.org. This is free software, licensed under: The Artistic License 1.0 The Artistic License Preamble The intent of this document is to state the conditions under which a Package may be copied, such that the Copyright Holder maintains some semblance of artistic control over the development of the package, while giving the users of the package the right to use and distribute the Package in a more-or-less customary fashion, plus the right to make reasonable modifications. Definitions: - "Package" refers to the collection of files distributed by the Copyright Holder, and derivatives of that collection of files created through textual modification. - "Standard Version" refers to such a Package if it has not been modified, or has been modified in accordance with the wishes of the Copyright Holder. - "Copyright Holder" is whoever is named in the copyright or copyrights for the package. - "You" is you, if you're thinking about copying or distributing this Package. - "Reasonable copying fee" is whatever you can justify on the basis of media cost, duplication charges, time of people involved, and so on. (You will not be required to justify it to the Copyright Holder, but only to the computing community at large as a market that must bear the fee.) - "Freely Available" means that no fee is charged for the item itself, though there may be fees involved in handling the item. It also means that recipients of the item may redistribute it under the same conditions they received it. 1. You may make and give away verbatim copies of the source form of the Standard Version of this Package without restriction, provided that you duplicate all of the original copyright notices and associated disclaimers. 2. You may apply bug fixes, portability fixes and other modifications derived from the Public Domain or from the Copyright Holder. A Package modified in such a way shall still be considered the Standard Version. 3. You may otherwise modify your copy of this Package in any way, provided that you insert a prominent notice in each changed file stating how and when you changed that file, and provided that you do at least ONE of the following: a) place your modifications in the Public Domain or otherwise make them Freely Available, such as by posting said modifications to Usenet or an equivalent medium, or placing the modifications on a major archive site such as ftp.uu.net, or by allowing the Copyright Holder to include your modifications in the Standard Version of the Package. b) use the modified Package only within your corporation or organization. c) rename any non-standard executables so the names do not conflict with standard executables, which must also be provided, and provide a separate manual page for each non-standard executable that clearly documents how it differs from the Standard Version. d) make other distribution arrangements with the Copyright Holder. 4. You may distribute the programs of this Package in object code or executable form, provided that you do at least ONE of the following: a) distribute a Standard Version of the executables and library files, together with instructions (in the manual page or equivalent) on where to get the Standard Version. b) accompany the distribution with the machine-readable source of the Package with your modifications. c) accompany any non-standard executables with their corresponding Standard Version executables, giving the non-standard executables non-standard names, and clearly documenting the differences in manual pages (or equivalent), together with instructions on where to get the Standard Version. d) make other distribution arrangements with the Copyright Holder. 5. You may charge a reasonable copying fee for any distribution of this Package. You may charge any fee you choose for support of this Package. You may not charge a fee for this Package itself. However, you may distribute this Package in aggregate with other (possibly commercial) programs as part of a larger (possibly commercial) software distribution provided that you do not advertise this Package as a product of your own. 6. The scripts and library files supplied as input to or produced as output from the programs of this Package do not automatically fall under the copyright of this Package, but belong to whomever generated them, and may be sold commercially, and may be aggregated with this Package. 7. C or perl subroutines supplied by you and linked into this Package shall not be considered part of this Package. 8. The name of the Copyright Holder may not be used to endorse or promote products derived from this software without specific prior written permission. 9. THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. The End Modern-Perl-1.20170117/MANIFEST0000644000175000017500000000034213037317571016104 0ustar chromaticchromatic# This file was automatically generated by Dist::Zilla::Plugin::Manifest v5.043. Build.PL Changes LICENSE MANIFEST META.yml Makefile.PL README dist.ini lib/Modern/Perl.pm t/base.t t/regressions.t t/unimport.t t/year_imports.t Modern-Perl-1.20170117/lib/0000775000175000017500000000000013037317571015524 5ustar chromaticchromaticModern-Perl-1.20170117/lib/Modern/0000775000175000017500000000000013037317571016750 5ustar chromaticchromaticModern-Perl-1.20170117/lib/Modern/Perl.pm0000644000175000017500000001303113037317571020204 0ustar chromaticchromaticpackage Modern::Perl; # ABSTRACT: enable all of the features of Modern Perl with one import $Modern::Perl::VERSION = '1.20170117'; use 5.010_000; use strict; use warnings; use mro (); use feature (); # enable methods on filehandles; unnecessary when 5.14 autoloads them use IO::File (); use IO::Handle (); my $wanted_date; sub VERSION { my ($self, $version) = @_; return $Modern::Perl::VERSION || 2017 unless defined $version; return $Modern::Perl::VERSION || 2017 if $version < 2009; $wanted_date = $version if (caller(1))[3] =~ /::BEGIN/; return 2017; } sub import { my ($class, $date) = @_; $date = $wanted_date unless defined $date; my $feature_tag = validate_date( $date ); undef $wanted_date; warnings->import; strict->import; feature->import( $feature_tag ); mro::set_mro( scalar caller(), 'c3' ); } sub unimport { warnings->unimport; strict->unimport; feature->unimport; } my %dates = ( 2009 => ':5.10', 2010 => ':5.10', 2011 => ':5.12', 2012 => ':5.14', 2013 => ':5.16', 2014 => ':5.18', 2015 => ':5.20', 2016 => ':5.24', 2017 => ':5.24', ); sub validate_date { my $date = shift; # always enable unicode_strings when available unless ($date) { return ':5.12' if $] > 5.011003; return ':5.10'; } my $year = substr $date, 0, 4; return $dates{$year} if exists $dates{$year}; die "Unknown date '$date' requested\n"; } 1; __END__ =pod =encoding UTF-8 =head1 NAME Modern::Perl - enable all of the features of Modern Perl with one import =head1 VERSION version 1.20170117 =head1 SYNOPSIS Modern Perl programs use several modules to enable additional features of Perl and of the CPAN. Instead of copying and pasting all of these C lines, instead write only one: use Modern::Perl; This enables the L and L pragmas, as well as all of the features available in Perl 5.10. It also enables C3 method resolution order as documented in C and loads L and L so that you may call methods on filehandles. In the future, it may include additional core modules and pragmas. Because so much of this module's behavior uses lexically scoped pragmas, you may disable these pragmas within an inner scope with: no Modern::Perl; See L for more information, L for further discussion of Modern Perl and its implications, and L for a freely-downloadable Modern Perl tutorial. =head2 Wrapping Modern::Perl If you want to wrap Modern::Perl in your own C method, you can do so to add additional pragmas or features, such as the use of L. Please note that, if you do so, you will I automatically enable C3 method resolution in the calling scope. This is due to how the L pragma works. In your custom C method, you will need to write code such as: mro::set_mro( scalar caller(), 'c3' ); =head2 Forward Compatibility For forward compatibility, I recommend you specify a string containing a I 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. Obviously you cannot use newer features on earlier versions. Perl will throw the appropriate exception if you try. =head1 AUTHOR chromatic, C<< >> =head1 BUGS None reported. Please report any bugs or feature requests to C, or through the web interface at L. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. =head1 SUPPORT You can find documentation for this module with the perldoc command. perldoc Modern::Perl You can also look for information at: =over 4 =item * RT: CPAN's request tracker L =item * AnnoCPAN: Annotated CPAN documentation L =item * CPAN Ratings L =item * Search CPAN L =back =head1 ACKNOWLEDGEMENTS Damian Conway (inspiration from L), Florian Ragwitz (L, so I didn't have to write it myself), chocolateboy (for suggesting that I don't even need L), 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 features. =head1 COPYRIGHT & LICENSE Copyright 2009-2017 chromatic, all rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl 5.24 itself. =head1 AUTHOR chromatic =head1 COPYRIGHT AND LICENSE This software is copyright (c) 2016 by chromatic@wgz.org. This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself. =cut Modern-Perl-1.20170117/Build.PL0000644000175000017500000000224213037317571016250 0ustar chromaticchromatic # This file was automatically generated by Dist::Zilla::Plugin::ModuleBuild v5.043. use strict; use warnings; use Module::Build 0.28; my %module_build_args = ( "build_requires" => { "Module::Build" => "0.28" }, "configure_requires" => { "ExtUtils::MakeMaker" => 0, "Module::Build" => "0.28" }, "dist_abstract" => "enable all of the features of Modern Perl with one import", "dist_author" => [ "chromatic" ], "dist_name" => "Modern-Perl", "dist_version" => "1.20170117", "license" => "perl", "module_name" => "Modern::Perl", "recursive_test_files" => 1, "requires" => { "IO::File" => 0, "IO::Handle" => 0, "autodie" => "2.22", "feature" => 0, "mro" => 0, "perl" => "5.010", "strict" => 0, "warnings" => 0 }, "test_requires" => { "Test::More" => "0.98" } ); my %fallback_build_requires = ( "Module::Build" => "0.28", "Test::More" => "0.98" ); unless ( eval { Module::Build->VERSION(0.4004) } ) { delete $module_build_args{test_requires}; $module_build_args{build_requires} = \%fallback_build_requires; } my $build = Module::Build->new(%module_build_args); $build->create_build_script; Modern-Perl-1.20170117/t/0000775000175000017500000000000013037317571015221 5ustar chromaticchromaticModern-Perl-1.20170117/t/regressions.t0000644000175000017500000000527313037317571017756 0ustar chromaticchromatic#! perl use Test::More 0.98; use Modern::Perl (); $SIG{__WARN__} = sub { return if $_[0] =~ /Number found where operator expected/; return if $_[0] =~ /Do you need to predeclare/; return if $_[0] =~ /future reserved word/; return if $_[0] =~ /given is experimental/; warn shift }; eval 'sub { given (0) {} }'; isnt $@, '', 'use Modern::Perl () does not enable switch'; eval 'sub { say 0 }'; isnt $@, '', 'use Modern::Perl () does not enable say'; eval 'state $x;'; isnt $@, '', 'use Modern::Perl () does not enable state'; is uc "\xdf", "\xdf", 'Modern::Perl () does not enable unicode_strings'; { use Modern::Perl 2009; eval 'sub { given (0) {} }'; is $@, '', q|use Modern::Perl 2009 enables switch|; eval 'sub { say 0 }'; is $@, '', q|use Modern::Perl 2009 enables say|; eval 'state $x'; is $@, '', q|use Modern::Perl 2009 enables state|; is uc "\xdf", "\xdf", 'but not unicode_strings'; } { use Modern::Perl 2010; eval 'sub { given (0) {} }'; is $@, '', q|use Modern::Perl 2010 enables switch|; eval 'sub { say 0 }'; is $@, '', q|use Modern::Perl 2010 enables say|; eval 'state $x'; is $@, '', q|use Modern::Perl 2010 enables state|; is uc "\xdf", "\xdf", 'but not unicode_strings'; } if ($] >= 5.012) { eval <<'END_HERE'; use Modern::Perl 2011; eval 'sub { given (0) {} }'; is $@, '', q|use Modern::Perl 2011 enables switch|; eval 'sub { say 0 }'; is $@, '', q|use Modern::Perl 2011 enables say|; eval 'state $x'; is $@, '', q|use Modern::Perl 2011 enables state|; is uc "\xdf", "SS", '2011 enables unicode_strings'; END_HERE } if ($] >= 5.014) { eval <<'END_HERE'; use Modern::Perl 2012; eval 'sub { given (0) {} }'; is $@, '', q|use Modern::Perl 2012 enables switch|; eval 'sub { say 0 }'; is $@, '', q|use Modern::Perl 2012 enables say|; eval 'state $x'; is $@, '', q|use Modern::Perl 2012 enables state|; is uc "\xdf", "SS", '2012 enables unicode_strings'; END_HERE } eval 'sub { given (0) {} }'; isnt $@, "", 'switch feature does not leak out'; eval 'sub { say 0 }'; isnt $@, '', 'say feature does not leak out'; eval 'state $x'; isnt $@, '', 'state feature does not leak out'; is uc "\xdf", "\xdf", 'unicode_strings feature does not leak out'; # RT #80304: warning on Modern::Perl->VERSION() { my $warning = ''; local $SIG{__WARN__} = sub { $warning = shift }; $Modern::Perl::VERSION ||= '1.20121103'; my $version = Modern::Perl->VERSION; like $version, qr/1\.201\d/, 'VERSION() should return version number, given no argument'; is $warning, '', '... without warning about undef argument'; } done_testing; Modern-Perl-1.20170117/t/base.t0000644000175000017500000000217013037317571016316 0ustar chromaticchromatic#! perl use Test::More 0.98; BEGIN { local $INC{'IO/File.pm'}; local $INC{'IO/Handle.pm'}; use_ok( 'Modern::Perl' ) or exit; ok exists $INC{'IO/File.pm'}, 'M::P should load IO::File'; ok exists $INC{'IO/Handle.pm'}, 'M::P should load IO::Handle'; Modern::Perl->import(); } eval 'say "# say() should be available";'; is( $@, '', 'say() should be available' ); eval '$x = 1;'; like( $@, qr/Global symbol "\$x" requires explicit/, 'strict should be enabled' ); my $warnings; local $SIG{__WARN__} = sub { $warnings = shift }; my $y =~ s/hi//; like( $warnings, qr/Use of uninitialized value/, 'warnings should be enabled' ); eval<<'END_CLASSES'; package A; $A::VERSION = 1; package B; @B::ISA = 'A'; package C; @C::ISA = 'A'; package D; use Modern::Perl; @D::ISA = qw( B C ); END_CLASSES package main; is_deeply( mro::get_linear_isa( 'D' ), [qw( D B C A )], 'mro should use C3' ); if ($] > 5.011003) { eval q| use Modern::Perl; BEGIN { ok exists $^H{feature_unicode}, '... and should unilaterally enable unicode_strings, when available'; } |; } done_testing; Modern-Perl-1.20170117/t/unimport.t0000644000175000017500000000111713037317571017261 0ustar chromaticchromatic#! perl use Test::More 0.98; use Modern::Perl; eval 'say "# say() should be available";'; is $@, '', 'say() should be available'; { no Modern::Perl; eval 'say "# say() should be unavailable when unimported"'; like $@, qr/syntax error.+near "say /, 'unimport should disable say feature'; eval '$x = 1'; is $@, '', 'unimport should disable strictures'; my $warnings; local $SIG{__WARN__} = sub { $warnings = shift }; my $y =~ s/hi//; unlike $warnings, qr/Use of uninitialized value/, 'unimport should disable warnings'; } done_testing; Modern-Perl-1.20170117/t/year_imports.t0000644000175000017500000001316413037317571020126 0ustar chromaticchromatic#! perl use Test::More 0.98; use Modern::Perl (); $SIG{__WARN__} = sub { return if $_[0] =~ /Number found where operator expected/; return if $_[0] =~ /Do you need to predeclare/; return if $_[0] =~ /future reserved word/; return if $_[0] =~ /given is experimental/; warn shift }; sub _get_year { my $year = shift; return $year eq '()' ? $year : "'$year'"; } sub test_lexical_subs_for { # lexical subs removed from feature.pm in 5.25.2 return if $] >= 5.025002; my $year = _get_year(shift); eval qq|use Modern::Perl $year; my sub foo {}|; isnt $@, '', qq|use Modern::Perl $year should not enable lexical subs|; } sub test_switch_for { my $year = _get_year(shift); eval qq|use Modern::Perl $year; sub { given (0) {} }|; is $@, '', qq|use Modern::Perl $year enables switch|; } sub test_say_for { my $year = _get_year(shift); eval qq|use Modern::Perl $year; sub { say 0 }|; is $@, '', qq|use Modern::Perl $year enables say|; } sub test_state_for { my $year = _get_year(shift); eval qq|use Modern::Perl $year; state \$x;|; is $@, '', qq|use Modern::Perl $year enables state|; } sub test_cur_sub_for { my $year = _get_year(shift); eval qq|use Modern::Perl $year; sub { return __SUB__ }|; is $@, '', qq|use Modern::Perl $year enables current_sub|; } sub test_array_base_for { my $year = _get_year(shift); my $warning = ''; local $SIG{__WARN__} = sub { $warning = shift }; eval qq|use Modern::Perl $year; \$[ = 10;|; like $warning, qr/Use of assignment to \$\[ is deprecated/, qq|use Modern::Perl $year disables array_base|; } sub test_fc_for { my $year = _get_year(shift); eval qq|use Modern::Perl $year; fc("tschüß") eq fc("TSCHÜSS")|; is $@, '', qq|use Modern::Perl $year enables fc|; } sub test_postderef_for { my $year = _get_year(shift); eval qq|use Modern::Perl $year; my \$r = [ 1, [ 2, 3 ], 4 ]; \$r->[1]->@*|; is $@, '', qq|use Modern::Perl $year enables postderef_qq|; } sub test_unicode_strings_for { my $year = _get_year(shift); eval qq{ use Modern::Perl $year; is uc "\xdf", "SS", q|$year enables unicode_strings|; }; } eval 'sub { given (0) {} }'; isnt $@, '', 'use Modern::Perl () does not enable switch'; eval 'sub { say 0 }'; isnt $@, '', 'use Modern::Perl () does not enable say'; eval 'state $x;'; isnt $@, '', 'use Modern::Perl () does not enable state'; is uc "\xdf", "\xdf", 'Modern::Perl () does not enable unicode_strings'; eval 'sub { return __SUB__ }'; is $@, '', q|use Modern::Perl '2013' does not enable current_sub|; { my $warning = ''; local $SIG{__WARN__} = sub { $warning = shift }; eval 'fc("tschüß") eq fc("TSCHÜSS")'; isnt $@, '', q|use Modern::Perl () does not enable fc|; } { use Modern::Perl '2009'; test_switch_for( '2009' ); test_say_for( '2009' ); test_state_for( '2009' ); is uc "\xdf", "\xdf", 'but not unicode_strings'; } { use Modern::Perl '2010'; test_switch_for( '2010' ); test_say_for( '2010' ); test_state_for( '2010' ); is uc "\xdf", "\xdf", 'but not unicode_strings'; } if ($] >= 5.012) { my $year = 2011; test_switch_for( $year ); test_say_for( $year ); test_state_for( $year ); test_unicode_strings_for( $year ); } if ($] >= 5.014) { my $year = 2012; test_switch_for( $year ); test_say_for( $year ); test_state_for( $year ); test_unicode_strings_for( $year ); } if ($] >= 5.016) { my $year = 2013; test_switch_for( $year ); test_say_for( $year ); test_state_for( $year ); test_cur_sub_for( $year ); test_array_base_for( $year ); test_lexical_subs_for( $year ); test_fc_for( $year ); test_unicode_strings_for( $year ); } if ($] >= 5.018) { my $year = 2014; test_switch_for( $year ); test_say_for( $year ); test_state_for( $year ); test_cur_sub_for( $year ); test_array_base_for( $year ); test_lexical_subs_for( $year ); test_fc_for( $year ); test_unicode_strings_for( $year ); } if ($] >= 5.020) { my $year = 2015; test_switch_for( $year ); test_say_for( $year ); test_state_for( $year ); test_cur_sub_for( $year ); test_array_base_for( $year ); test_lexical_subs_for( $year ); test_fc_for( $year ); test_unicode_strings_for( $year ); } if ($] >= 5.024) { my $year = 2016; test_switch_for( $year ); test_say_for( $year ); test_state_for( $year ); test_cur_sub_for( $year ); test_array_base_for( $year ); test_lexical_subs_for( $year ); test_fc_for( $year ); test_postderef_for( $year ); test_unicode_strings_for( $year ); } if ($] >= 5.024) { my $year = 2017; test_switch_for( $year ); test_say_for( $year ); test_state_for( $year ); test_cur_sub_for( $year ); test_array_base_for( $year ); test_lexical_subs_for( $year ); test_fc_for( $year ); test_postderef_for( $year ); test_unicode_strings_for( $year ); } eval 'sub { given (0) {} }'; isnt $@, "", 'switch feature does not leak out'; eval 'sub { say 0 }'; isnt $@, '', 'say feature does not leak out'; eval 'state $x'; isnt $@, '', 'state feature does not leak out'; is uc "\xdf", "\xdf", 'unicode_strings feature does not leak out'; done_testing;