gitpan / env-sanctify-moosified Goto Github PK

NAME
    Env::Sanctify::Moosified - Lexically scoped sanctification of %ENV

VERSION
    version 1.06

SYNOPSIS
      my $sanctify = Env::Sanctify::Moosified->consecrate( sanctify => [ '^POE' ] );

      # do some stuff, fork some processes etc.

      $sanctify->restore

      {

        my $sanctify = Env::Sanctify::Moosified->consecrate( env => { POE_TRACE_DEFAULT => 1 } );

        # do some stuff, fork some processes etc.
      }

      # out of scope, %ENV is back to normal

DESCRIPTION
    Env::Sanctify::Moosified is a module that provides lexically scoped
    manipulation and sanctification of %ENV.

    You can specify that it alter or add additional environment variables or
    remove existing ones according to a list of matching regexen.

    You can then either "restore" the environment back manually or let the
    object fall out of scope, which automagically restores.

    Useful for manipulating the environment that forked processes and
    sub-processes will inherit.

CONSTRUCTOR
    "consecrate"
        Creates an Env::Sanctify::Moosified object. Takes two optional
        arguments:

        "env"
            A hashref of env vars to add to %ENV.

        "sanctify"
            An arrayref of regex pattern strings to match against current
            %ENV vars;

        Any %ENV var that matches a "sanctify" regex is removed from the
        resultant %ENV.

METHODs
    "restore"
        Explicitly restore the previous %ENV. This is called automagically
        when the object is "DESTROY"ed, for instance, when it goes out of
        scope.

AUTHOR
    Chris Williams <[email protected]>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2013 by Chris Williams.

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