use Carp qw(confess);
-use Mouse::Util qw(get_code_info);
-
my %SPEC;
+use constant _strict_bits => strict::bits(qw(subs refs vars));
+
+# it must be "require", because Mouse::Util depends on Mouse::Exporter,
+# which depends on Mouse::Util::import()
+require Mouse::Util;
+
+sub import{
+ $^H |= _strict_bits; # strict->import;
+ ${^WARNING_BITS} |= $warnings::Bits{all}; # warnings->import;
+ return;
+}
+
+
sub setup_import_methods{
my($class, %args) = @_;
my $exporting_package = $args{exporting_package} ||= caller();
+ my($import, $unimport) = $class->build_import_methods(%args);
+
+ no strict 'refs';
+
+ *{$exporting_package . '::import'} = $import;
+ *{$exporting_package . '::unimport'} = $unimport;
+
+ # for backward compatibility
+ *{$exporting_package . '::export_to_level'} = sub{
+ my($package, $level, undef, @args) = @_; # the third argument is redundant
+ $package->import({ into_level => $level + 1 }, @args);
+ };
+ *{$exporting_package . '::export'} = sub{
+ my($package, $into, @args) = @_;
+ $package->import({ into => $into }, @args);
+ };
+ return;
+}
+
+sub build_import_methods{
+ my($class, %args) = @_;
+
+ my $exporting_package = $args{exporting_package} ||= caller();
+
$SPEC{$exporting_package} = \%args;
# canonicalize args
push @export_from, $current;
my $also = $SPEC{$current}{also} or next;
- push @stack, grep{ !$seen{$_}++ } @{ $also };
+ push @stack, grep{ !$seen{$_}++ } ref($also) ? @{ $also } : $also;
}
}
else{
my @removables;
my @all;
+ my @init_meta_methods;
+
foreach my $package(@export_from){
my $spec = $SPEC{$package} or next;
if(ref($thingy)){
$code = $thingy;
- ($code_package, $code_name) = get_code_info($code);
+ ($code_package, $code_name) = Mouse::Util::get_code_info($code);
}
else{
no strict 'refs';
}
}
}
+
+ if(my $init_meta = $package->can('init_meta')){
+ if(!grep{ $_ == $init_meta } @init_meta_methods){
+ push @init_meta_methods, $init_meta;
+ }
+ }
}
$args{EXPORTS} = \%exports;
$args{REMOVABLES} = \@removables;
- $args{group}{default} ||= \@all;
- $args{group}{all} ||= \@all;
- }
-
- no strict 'refs';
+ $args{groups}{all} ||= \@all;
- *{$exporting_package . '::import'} = \&do_import;
- *{$exporting_package . '::unimport'} = \&do_unimport;
+ if(my $default_list = $args{groups}{default}){
+ my %default;
+ foreach my $keyword(@{$default_list}){
+ $default{$keyword} = $exports{$keyword}
+ || confess(qq{The $exporting_package package does not export "$keyword"});
+ }
+ $args{DEFAULT} = \%default;
+ }
+ else{
+ $args{groups}{default} ||= \@all;
+ $args{DEFAULT} = $args{EXPORTS};
+ }
- if(!defined &{$exporting_package . '::init_meta'}){
- *{$exporting_package . '::init_meta'} = \&do_init_meta;
+ if(@init_meta_methods){
+ $args{INIT_META} = \@init_meta_methods;
+ }
}
- return;
-}
-# the entity of general init_meta()
-sub do_init_meta {
- my($class, %args) = @_;
-
- my $spec = $SPEC{$class}
- or confess("The package $class does not use Mouse::Exporter");
-
- my $for_class = $args{for_class}
- or confess("Cannot call init_meta without specifying a for_class");
-
- my $base_class = $args{base_class} || 'Mouse::Object';
- my $metaclass = $args{metaclass} || 'Mouse::Meta::Class';
-
- my $meta = $metaclass->initialize($for_class);
-
- $meta->add_method(meta => sub{
- $metaclass->initialize(ref($_[0]) || $_[0]);
- });
-
- $meta->superclasses($base_class)
- unless $meta->superclasses;
-
- return $meta;
+ return (\&do_import, \&do_unimport);
}
+
# the entity of general import()
sub do_import {
- my($class, @args) = @_;
+ my($package, @args) = @_;
- my $spec = $SPEC{$class}
- or confess("The package $class does not use Mouse::Exporter");
+ my $spec = $SPEC{$package}
+ || confess("The package $package package does not use Mouse::Exporter");
my $into = _get_caller_package(ref($args[0]) ? shift @args : undef);
my @exports;
- foreach my $arg(@args){
- if($arg =~ s/^[-:]//){
- my $group = $spec->{group}{$arg} or confess(qq{group "$arg" is not exported by the $class module});
+ my @traits;
+
+ while(@args){
+ my $arg = shift @args;
+ if($arg =~ s/^-//){
+ if($arg eq 'traits'){
+ push @traits, ref($args[0]) ? @{shift(@args)} : shift(@args);
+ }
+ else {
+ Mouse::Util::not_supported("-$arg");
+ }
+ }
+ elsif($arg =~ s/^://){
+ my $group = $spec->{groups}{$arg}
+ || confess(qq{The $package package does not export the group "$arg"});
push @exports, @{$group};
}
else{
}
}
- strict->import;
- warnings->import;
-
- if($into eq 'main' && !$spec->{_not_export_to_main}){
- warn qq{$class does not export its sugar to the 'main' package.\n};
- return;
- }
+ $^H |= _strict_bits; # strict->import;
+ ${^WARNING_BITS} |= $warnings::Bits{all}; # warnings->import;
- if($class->can('init_meta')){
- my $meta = $class->init_meta(
- for_class => $into,
- );
+ if($spec->{INIT_META}){
+ my $meta;
+ foreach my $init_meta(@{$spec->{INIT_META}}){
+ $meta = $into->$init_meta(for_class => $into);
+ }
- # TODO: process -metaclass and -traits
- # ...
+ if(@traits){
+ my $type = (split /::/, ref $meta)[-1]; # e.g. "Class" for "My::Meta::Class"
+ @traits =
+ map{
+ ref($_) ? $_
+ : Mouse::Util::resolve_metaclass_alias($type => $_, trait => 1)
+ } @traits;
+
+ require Mouse::Util::MetaRole;
+ Mouse::Util::MetaRole::apply_metaclass_roles(
+ for_class => $into,
+ metaclass_roles => \@traits,
+ );
+ }
+ }
+ elsif(@traits){
+ Carp::confess("Cannot provide traits when $package does not have an init_meta() method");
}
-
- my $exports_ref = @exports ? \@exports : $spec->{group}{default};
-
- foreach my $keyword(@{$exports_ref}){
- no strict 'refs';
- *{$into.'::'.$keyword} = $spec->{EXPORTS}{$keyword}
- or confess(qq{"$keyword" is not exported by the $class module});
+ if(@exports){
+ foreach my $keyword(@exports){
+ no strict 'refs';
+ *{$into.'::'.$keyword} = $spec->{EXPORTS}{$keyword}
+ || confess(qq{The $package package does not export "$keyword"});
+ }
+ }
+ else{
+ my $default = $spec->{DEFAULT};
+ while(my($keyword, $code) = each %{$default}){
+ no strict 'refs';
+ *{$into.'::'.$keyword} = $code;
+ }
}
return;
}
# the entity of general unimport()
sub do_unimport {
- my($class, $arg) = @_;
+ my($package, $arg) = @_;
- my $spec = $SPEC{$class}
- or confess("The package $class does not use Mouse::Exporter");
+ my $spec = $SPEC{$package}
+ || confess("The package $package does not use Mouse::Exporter");
my $from = _get_caller_package($arg);
return;
}
+# 1 extra level because it's called by import so there's a layer\r
+# of indirection\r
+sub _LEVEL(){ 1 }
+
sub _get_caller_package {
my($arg) = @_;
- # 2 extra level because it's called by import so there's a layer\r
- # of indirection\r
- my $offset = 1;\r
-
if(ref $arg){
return defined($arg->{into}) ? $arg->{into}
- : defined($arg->{into_level}) ? scalar caller($offset + $arg->{into_level})
- : scalar caller($offset);
+ : defined($arg->{into_level}) ? scalar caller(_LEVEL + $arg->{into_level})
+ : scalar caller(_LEVEL);
}
else{
- return scalar caller($offset);
+ return scalar caller(_LEVEL);
}
}
+#sub _spec{ %SPEC }
+
1;
__END__
=head1 NAME
-Mouse - The Mouse Exporter
+Mouse::Exporter - make an import() and unimport() just like Mouse.pm
-=head1 SYNOPSIS
+=head1 VERSION
- package MouseX::Foo;
- use Mouse::Exporter;
+This document describes Mouse version 0.40_08
- Mouse::Exporter->setup_import_methods(
+=head1 SYNOPSIS
- );
+ package MyApp::Mouse;\r
+\r
+ use Mouse ();\r
+ use Mouse::Exporter;\r
+\r
+ Mouse::Exporter->setup_import_methods(\r
+ as_is => [ 'has_rw', 'other_sugar', \&Some::Random::thing ],\r
+ also => 'Mouse',\r
+ );\r
+\r
+ sub has_rw {
+ my $meta = caller->meta;\r
+ my ( $name, %options ) = @_;\r
+ $meta->add_attribute(\r
+ $name,\r
+ is => 'rw',\r
+ %options,\r
+ );\r
+ }\r
+\r
+ # then later ...\r
+ package MyApp::User;\r
+
+ use MyApp::Mouse;\r
+\r
+ has 'name';\r
+ has_rw 'size';\r
+ thing;\r
+\r
+ no MyApp::Mouse;
=head1 DESCRIPTION
+This module encapsulates the exporting of sugar functions in a\r
+C<Mouse.pm>-like manner. It does this by building custom C<import>,\r
+C<unimport> methods for your module, based on a spec you provide.\r
+
+Note that C<Mouse::Exporter> does not provide the C<with_meta> option,
+but you can easily get the metaclass by C<< caller->meta >> as L</SYNOPSIS> shows.
+
+=head1 METHODS
+
+=head2 C<< setup_import_methods( ARGS ) >>
+
+=head2 C<< build_import_methods( ARGS ) -> (\&import, \&unimport) >>
=head1 SEE ALSO
L<Moose::Exporter>
=cut
+