You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
sipwise-base/lib/Sipwise/Base.pm

113 lines
2.4 KiB

package Sipwise::Base;
use utf8;
use Module::Runtime qw(use_module);
use parent 'autodie';
our $VERSION = '1.001';
our %features = (
lambda => q(use lambda 'λ';),
perl5i => q(use perl5i::2 -skip => [qw(Signatures Try::Tiny)];),
Moose => q(use Moose qw(after augment before extends has inner override super with);),
'MooseX::Method::Signatures' => q(use MooseX::Method::Signatures;),
TryCatch => q(use TryCatch;),
);
sub import {
my ($class, %param) = @_;
if ($param{-skip}) {
for my $feature (@{ $param{-skip} }) {
delete $features{$feature};
}
}
my $caller = caller;
use_module('strictures')->import(1);
use_module('perl5i::2')->import(-skip => [qw(Signatures Try::Tiny autodie)]);
my $export = "package $caller;\n";
for my $f (sort keys %features) {
$export .= "$features{$f}\n";
}
eval $export;
@_ = ($class, ':all');
goto &autodie::import;
}
1;
__END__
=encoding UTF-8
=head1 NAME
Sipwise::Base - import boilerplate code
=head1 VERSION
This document describes Sipwise::Base version 1.001
=head1 SYNOPSIS
use Sipwise::Base;
=head1 DESCRIPTION
The purpose of this module is to reduce the amount of boilerplate code and to enable some Perl features that are not
available by default. This is in the spirit of
L<http://modernperlbooks.com/mt/2009/10/remove-the-little-pessimizations.html|eliminating pessimisations>.
Switches on the functionality of the pragmatic modules L<strictures>, L<lambda>, L<perl5i>, L<Moose>,
L<MooseX::Method::Signatures>, L<TryCatch>.
=head1 INTERFACE
=head2 C<import>
See L<perlfunc/import>.
By passing an arrayref to C<-skip>, you can disable features:
use Sipwise::Base -skip => ['Moose']; # skip importing Moose
The features strings are C<lambda>, C<perl5i>, C<Moose>, C<MooseX::Method::Signatures>, C<TryCatch>.
=head2 Exports
=head1 DIAGNOSTICS
None.
=head1 CONFIGURATION AND ENVIRONMENT
Sipwise::Base requires no configuration files or environment variables.
=head1 DEPENDENCIES
See meta file in the source distribution.
=head1 INCOMPATIBILITIES
None reported.
=head1 BUGS AND LIMITATIONS
L<https://bugtracker.sipwise.com>
=head1 TO DO
different profiles for command-line applications
=head1 SEE ALSO
L<ToolSet>, L<Toolkit>, Ingy's L<perl5>, L<Syntax::Collector>
=head1 AUTHOR
Lars Dieckow C<< <ldieckow@sipwise.com> >>
=head1 LICENCE
restricted