Html

root

para

L<Examples| file:../examples/index.podlite>


L<Download |file:../download/index.podlite>


React

=begin React :component<HeaderCol> :id<menu> 
=para L<Documentation|/doc/introduction>
=para L<Modules| /mods>
=para L<Examples| file:../examples/index.podlite>
=para L<Download |file:../download/index.podlite>
=para L<About|file:../about/index.podlite>
=para 🔍 K<⌘K>/K<ctrl-K>
=end React


HEADER

FOOTER

README

use v6;

my %EXPORT;

module Trait::Env:ver<1.1.2>:auth<zef:Scimon> {

    use Trait::Env::Attribute;
    use Trait::Env::Variable;

    %EXPORT<&trait_mod:<is>> = &trait_mod:<is>;
}

sub EXPORT { %EXPORT }



head

Trait::Env - Trait to set an attribute from an environment variable.


use Trait::Env;
class Test {
    # Sets from %*ENV{HOME}. Undef if the var doesn't exist
    has $.home is env;


# Sets from %*ENV{TMPDIR}. Defaults to '/tmp'
has $.tmpdir is env is default "/tmp";


# Sets from %*ENV{EXTRA_DIR}. Defaults to '/tmp'
has $.extra-dir is env( :default</tmp> );


# Set from %*ENV{WORKDIR}. Dies if not set.
has $.workdir is env(:required);


# Set from %*ENV{READ_DIRS.+} ordered lexically
has @.read-dirs is env;


# Set from %*ENV{PATH} split on ':'
# has @.path is env(:sep<:>);
# Or default to the $*DISTRO.path-sep value
has @.path is env;      


# Set from %*ENV{NAME_MAP} data split on ';' pairs split on ':'
# EG a:b;c:d => { "a" => "b", "c" => "d" }
has %.name-map is env( :sep<;>, :kvsep<:> );


# Get all pairs where the key ends with '_POST'
has %.post-map is env( :post_match<_POST> );


# Get all pairs where the Key starts with 'PRE_'
has %.pre-map is env( :pre_match<PRE_> );


# Get all pairs where the Key starts with 'PRE_' and ends with '_POST'
has %.both-map is env( :pre_match<PRE_>, :post_match<_POST> );


# Parses JSON data
has $.json-data is env( :json );
}


# Sets from %*ENV{HOME}. Undef if the var doesn't exist
has $home is env;


# Sets from %*ENV{PATH}. Uses default path seperator
has @path is env;


Trait::Env is exports the new trait C<is env>.


Note the the variable name will be uppercased and any dashes changed to underscores before matching against the environment.
This functionality may be modifiable in the future.


For Booleans the standard Empty String == C<False> other String == C<True> works but the string "True" and "False" (any capitalization) will also map to True and False respectively.


If a required attribute is not set the code will raise a C<X::Trait::Env::Required::Not::Set> Exception.


Defaults can be set using the standard C<is default> trait or the C<:default> key. Note that for Positional attributes only the C<:default> key works.


Positional attributes will use the attribute name (after coercing) as the prefix to scan %*ENV for.
Any keys starting with that prefix will be ordered by the key name lexically and their values put into the attribute.


Alternatively you can use the C<:sep> key to specify a seperator, in which case the single value will be read based on the name and the list then created by spliting on this seperator.


If there is a single matching environment variable and no C<:sep> key is set then the system will fall back to splitting on the C<$*DISTRO.path-sep> value as a seperator.


Hashes can be single value with a C<:sep> key to specify the seperator between pairs and a C<:kvsep> to specifiy the seperator in each pair between key and value.


Hashes can also be defined by giving a C<:post_match> or C<:pre_match> arguments (or both).
Any Environment variable starting with C<:pre_match> is defined or ending with C<:post-match> if defined will be included.


Scalars, Positionals and Associative attributes can all be typed.


Variables can also be defined with C<is env> following the same rules.		     


Attribute or Variable only C<is env> traits can be loaded individually with C<Trait::Env::Attribute> and C<Trait::Env::Variable>.


Scalar Attributes and Variables can use C<is env(:json)> which will parse the ENV string as a JSON string using C<JSON::Tiny>.
You can combine this with the C<:default> and C<:required> options but be aware that the C<:default> value should be a data store NOT
a JSON value.


Thanks to Jonathan Worthington and Elizabeth Mattijsen for giving me the framework to build this on. Any mistakes are mine. 


This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.


item

TODO

The Raku Knowledge Base


=begin React :component<HeaderCol> :id<footer>  
=begin nested :!nested
=item1 B<Language>
    =item2 L<Get started|file:../getting-started/getting-started.podlite>
    =item2 L<Why Raku?|/doc/language/faq#Why-should-I-learn-Raku-What's-so-great-about-it>
    =item2 L<Try Raku|https://glot.io/new/raku>
    =item2 L<Raku cheat sheet|https://github.com/Raku/mu/blob/master/docs/Perl6/Cheatsheet/cheatsheet.txt>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<Raku on Exercism|https://exercism.org/tracks/raku>
    =item2 L<Wikipedia|https://en.wikipedia.org/wiki/Raku_(programming_language)>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=end nested
=begin nested :!nested

=item1 B<L<Documentation|/doc>>
    =item2 L<Getting started, Migration guides from other languages, & Tutorials | file:../doc/introduction.podlite>
    =item2 L<Language References|file:../doc/reference.podlite>
    =item2 L<Type Reference| file:../doc/types.podlite>
    =item2 L<Miscellaneous| file:../doc/miscellaneous.podlite>
    =item2 L<FAQs (Frequently Asked Questions)|/doc/language/faq>
    =item2 L<Community|/doc/language/community>
    =item2 L<The list of all documents|file:../doc/index.podlite>

=item1 B<Resources>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>

=end nested
=begin nested :!nested

=item1 B<Resoures>
    =item2 L<Download | file:../download/index.podlite>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=item1 B<Learning>
    =item2 L<The Raku Guide|https://raku.guide/>
    =item2 L<Wikibook |https://en.wikibooks.org/wiki/Raku_Programming>
    =item2 L<Books |https://perl6book.com/>
    =item2 L<Rosetta Code | https://www.raku.org/community/rosettacode>
    =item2 L<Learn Raku in Y minutes|https://learnxinyminutes.com/docs/raku/>
    =item2 L<Golfing |https://github.com/AlexDaniel/raku-golf-cheatsheet>
=end nested
=begin nested :!nested

=item1 B<Explore>
    =item2 L<Raku Blog Aggregator|https://planet.raku.org/>
    =item2 L<Rakudo Weekly|https://rakudoweekly.blog/>
    =item2 L<The Weekly Challenge |https://perlweeklychallenge.org/>
    =item2 L<Raku Advent Calendar|https://raku-advent.blog/>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>
    =item2 L<empty|#>

=end nested
=end React


=begin React :component<CookieConsent> :id<CookieConsent> :buttonCaption("Got it!")
=para
This website uses cookies for analytics.
=end React


README

Touch v0.7.0

Authors

License

Dependencies

Test Dependencies

Provides

Documentation