NAME

exported::constants - Declare constants and export them automatically

SYNOPSIS

    package MyProg::Constants;

    use exported::constants
        USER_TYPE_USER => 'U',
        USER_TYPE_APPLICATION => 'A',
        USER_TYPE_ROBOT => 'B',
    ;

    package MyProg::App;

    use MyProg::Constants;

    my @real_users = $users->search({ user_type => USER_TYPE_USER, });

DESCRIPTION

This is a boilerplate-removal module for creating modules of just constants in your program. This is useful if you have a lot of magic numbers you want to eliminate, especially things that show up in database schemas or APIs that you want to re-use across multiple modules.

It's pretty simple to use; just say

    use exported::constants
        CONSTANT1 => $value1,
        CONSTANT2 => $value2,
    ;

and your package is automatically an exporter, and automatically exports (by default) all the constants listed.

RESTRICTIONS

• List constants don't work, because exported::constants is intended to always create multiple constants in a single invocation.

• This module always works using @EXPORT in Exporter; this is unfortunate for developers who want to explicitly import all their constants.

SEE ALSO

• constant

• Exporter

AUTHOR

Jonathan Cast <jonathanccast@fastmail.fm>

COPYRIGHT AND LICENSE

Copyright 2017 Jonathan Cast

Licensed under the Apache License, Version 2.0 (the "License").