Chris Williams > Env-Sanctify-Moosified-1.06 > Env::Sanctify::Moosified

Download:
Env-Sanctify-Moosified-1.06.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 1.06   Source  

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 DESTROYed, for instance, when it goes out of scope.

AUTHOR ^

Chris Williams <chris@bingosnet.co.uk>

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.

syntax highlighting: