NAME Exporter::Declare::Magic - Enhance Exporter::Declare with some fancy magic. DESCRIPTION SYNOPSIS package Some::Exporter; use Exporter::Declare::Magic; ... #Same as the basic Exporter::Declare synopsis #Quoting is not necessary unless you have space or special characters export another_sub; export parsed_sub parser; # no 'sub' keyword, not a typo export anonymous_export { ... } #No semicolon, not a typo export parsed_anon parser { ... } # Same as export default_export name { ... } # No quoting required export $VAR; export %VAR; my $iterator = 'a'; gen_export unique_class_id { my $current = $iterator++; return sub { $current }; } gen_default_export '$my_letter' { my $letter = $iterator++; return \$letter; } parser myparser { ... See Devel::Declare } parsed_exports parser => qw/ parsed_sub_a parsed_sub_b /; parsed_default_exports parser_b => qw/ parsed_sub_c /; API These all work fine in function or method form, however the syntax sugar will only work in function form. parsed_exports( $parser, @exports ) Add exports that should use a 'Devel::Declare' based parser. The parser should be the name of a registered Devel::Declare::Interface parser, or the name of a parser sub created using the parser() function. parsed_default_exports( $parser, @exports ) Same as parsed_exports(), except exports are added to the -default tag. parser name { ... } parser name => \&code Define a parser. You need to be familiar with Devel::Declare to make use of this. export( $name ) export( $name, $ref ) export( $name, $parser ) export( $name, $parser, $ref ) export name { ... } export name parser { ... } export is a keyword that lets you export any 1 item at a time. The item can be exported by name, name+ref, or name+parser+ref. You can also use it without parentheses or quotes followed by a codeblock. default_export( $name ) default_export( $name, $ref ) default_export( $name, $parser ) default_export( $name, $parser, $ref ) default_export name { ... } default_export name parser { ... } gen_export( $name ) gen_export( $name, $ref ) gen_export( $name, $parser ) gen_export( $name, $parser, $ref ) gen_export name { ... } gen_export name parser { ... } gen_default_export( $name ) gen_default_export( $name, $ref ) gen_default_export( $name, $parser ) gen_default_export( $name, $parser, $ref ) gen_default_export name { ... } gen_default_export name parser { ... } These all act just like export(), except that they add subrefs as generators, and/or add exports to the -default tag. AUTHORS Chad Granum exodist7@gmail.com COPYRIGHT Copyright (C) 2010 Chad Granum Exporter-Declare is free software; Standard perl licence. Exporter-Declare 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 license for more details.