NAME

Evo::Export

VERSION

version 0.0405

DESCRIPTION

Standart Exporter wasn't good enough for me, so I've written a new one from the scratch

SYNOPSYS

package My::Lib;
use Evo '-Export *', -Loaded;

# export foo, other as bar
sub foo : Export        { say 'foo' }
sub other : Export(bar) { say 'bar' }

# test.pl
package main;
use Evo 'My::Lib *';
foo();
bar();

IMPORTING

use Evo;
use Evo 'Evo::Eval eval_try';
use Evo '-Promise promise deferred';

For convenient, you can load all above in one line (divide by , or ;)

use Evo '-Eval eval_try; -Promise promise deferred';
use Evo '-Eval eval_try, -Promise promise deferred';

* means load all. - is a shortcut. See ""shortcuts" in Evo

what to import and how

You can rename subroutines to avoid method clashing

# import promise as prm
use Evo '-Promise promise:prm';

You can use * with exclude - for convinient, use whitespace as a delimiter

# import all except "deferred"
use Evo '-Promise * -deferred';

If one name clashes with yours, you can import all except that name and import renamed version of that name

# import all as is but only deferred will be renamed to "renamed_deferred"
use Evo '-Promise * -deferred deferred:renamed_deferred';

EXPORTING

Firstly you need to load Evo::Export with import (or *). This will import import method:

use Evo '-Export *';
use Evo '-Export import';

By default, use Your::Module;, without arguments will import nothing. You can change this behaviour to export all without arguments

use Evo '-Export import_all:import';
use Evo '-Export * -import import_all:import';

Using attribute Export

package My::Lib;
use Evo '-Export *'; # or use Evo::Export 'import';
use Evo -Loaded;

sub foo : Export { say 'foo' }

package main;
use Evo 'My::Lib foo';
foo();

Pay attention that module should either import import, or call Evo::Export/install directly (see example below) from import method

You can export with another name

# export as bar
sub foo : Export(bar) {say 'foo'}

(EXPERIMENTAL) Using attribte ExportGen

package My::Lib;
use Evo '-Export *; -Loaded';

sub bar ($me, $dest) : ExportGen {
  say qq{"$dest" requested "bar" exported by "$me"};
  return sub { say "$me-$dest-bar" };
}

package main;
use Evo;
My::Lib->import('*');
bar();

INSTALLING DIRECTLY

If you want to write your own import method, do it this way:

package My::Lib;
use Evo -Export;    # don't import "import"
use Evo -Loaded;

sub import ($self, @list) {
  my $dest = scalar caller;
  Evo::Export->install_in($dest, $self, @list ? @list : ('*'));    # force to install all
}
sub foo : Export { say 'foo' }


package main;
use Evo 'My::Lib';
foo();

export;

Export signature is more preffered way, but if you wish

# export foo
export 'foo';

# export "foo" under name "bar"
export 'foo:bar';

Trying to export not existing subroitine will cause an exception

export_code

Export function, that won't be available in the source class

# My::Lib now exports foo, but My::Lib::foo doesn't exist
export_code foo => sub { say "hello" };

export_proxy

# reexport all from My::Other
export_proxy 'My::Other', '*';


# reexport "foo" from My::Other
export_proxy 'My::Other', 'foo';

# reexport "foo" from My::Other as "bar"
export_proxy 'My::Other', 'foo:bar';

export_gen (EXPERIMENTAL)

package My::Lib;
use Evo '-Export *; -Loaded';

export_gen foo => sub ($me, $dest) {
  say qq{"$dest" requested "foo" exported by "$me"};
  sub {say "hello, $dest"};
};


package main;
use Evo;
My::Lib->import('*');
foo();

Very powefull and most exciting feature. Evo::Export exports generators, that produces subroutines. Consider it as a 3nd dimension in 3d programming. Better using with ExportGen attribute

EXPORT

This method returns a bound instance of Evo::Export::Meta, which is stored in package's $EVO_EXPORT_META variable. Also a cache for generated export is stored in class'es $EVO_EXPORT_CACHE variable

use Evo;
{

  package My::Lib;
  use Evo '-Export *', -Loaded;
  sub foo : Export { }

  sub bar : ExportGen {
    sub { }
  }

  package My::Dest;
  use My::Lib '*';
}

use Data::Dumper;
say Dumper (My::Lib->EXPORT->info);
say Dumper ($My::Lib::EVO_EXPORT_META->info);
say "cache of My::Dest: ", Dumper($My::Dest::EVO_EXPORT_CACHE);

import

By default, this method will be exported and do the stuff. If you need replace import of your module, exclude it by use Evo '-Export * -import'

AUTHOR

alexbyk.com

COPYRIGHT AND LICENSE

This software is copyright (c) 2016 by alexbyk.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

cpanm Evo

perl -MCPAN -e shell
install Evo