NAME

Lexical::Importer - Importer + Lexical subs/vars.

DESCRIPTION

This is a subclass of Importer which will import all symbols as lexicals instead of package symbols.

IMPORTANT NOTE

This imports symbols into the currently compiling scope which is not necessarily the same as the package doing the importing.

SYNOPSIS

Say you have a module, Foo.pm:

    package Foo

    use base 'Exporter';
    our @EXPORT = qw/foo/;

    sub foo { 'foo' }

You want to import foo() to use, but you also have your own foo() method you do not want to squash in Your::Module.pm

    # Define package versions first
    sub foo { 'not lexical' }

    say foo(); # prints 'not lexical';

    {
        use Lexical::Importer Foo => 'foo';
        say foo(); # prints 'foo'
    }

    say foo(); # prints 'not lexical' again;

    use Lexical::Importer Foo => 'foo';
    say foo(); # prints 'foo'

    say __PACKAGE__->foo(); # prints 'not lexical', method dispatch find package sub.

    # Remove lexical subs
    no Lexical::Importer;
    say foo(); # prints 'not lexical' again;

IMPORTER

This package inherits from Importer and works exactly the same apart from being lexical instead of modifying the symbol table.

SEE ALSO

Importer - The importer module this package subclasses

Lexical::Var and Lexical::Sub - The awesome modules Zefram wrote that make this possible. Note: Lexical::Importer ships with a forked copy of these

Lexical::Import - A similar module, but it does not support everything Lexical::Importer does.

LEXICAL-VAR FORK

The Lexical::Importer module is bundled with a fork of the Lexical::Var XS code. This fork is necessary due to Lexical::Var being broken on newer perls. The author of the original package is not accepting third party patches, and has not yet fixed the issues himself. Once a version of Lexical::Var ships with a fix for newer perls this fork will likely be removed.

AUTHOR

Andrew Main (Zefram) <zefram@fysh.org>

Copyright (C) 2009, 2010, 2011, 2012, 2013 Andrew Main (Zefram) <zefram@fysh.org>

LICENSE

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

SOURCE

The source code repository for Lexical-Importer can be found at https://github.com/exodist/Lexical-Importer.

MAINTAINERS

Chad Granum <exodist@cpan.org>

AUTHORS

Chad Granum <exodist@cpan.org>

COPYRIGHT

Copyright 2016 Chad Granum <exodist@cpan.org>.

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

See http://dev.perl.org/licenses/