NAME

local::lib::profiles - makes modules feel at home

VERSION

Version 0.03

SYNOPSIS

describe the module, working code example

DESCRIPTION

local::lib::profiles is designed to extend upon the methodologies of lib::local to make it simpler to create, manage, and discard local perl profiles.

COMMANDS

These are the cmd line usages for the package

ll_mkprofile

Creates a profile under the LOCAL_LIB_HOME directory by the given name.

ll_rmprofile

Removes a profile that lives under the LOCAL_LIB_HOME directory by the given name.

ll_workon

Activates a previously created profile.

ll_deactivate

Deactivate the currently active profile. Note that this is only available if an profile is active

ll_upgrade_profile

Replaces or create the Active scripts in a given local-lib profile. This can be used to either turn a local-lib library into a full blown profile or to take an existing profile and upgrade it to contain more recent scripts

ll_cdprofile

Changes directory into the root of the profile

ROUTINES

make_profile

Creates a new local lib profile in the supplied directory

find_activate_script

Finds the path of the activate.sh script

upgrade_profile

Upgrades a local lib directory into a full profile

deploy_support_file

takes a support file from a given local (like lib/activate.sh or the templates directory), substitutes the content tokens that it finds, then writes the file to the required destination

AUTHOR

Please contribute patches to Github:

    http://github.com/Potatohead/local-lib-profiles

Christopher Mckay (cmckay), <potatohead@potatolan.com>

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc local::lib::profiles

BUGS

Colons in profile names

This breaks the profile creation, just don't do it untill I fix it.

ACKNOWLEDGEMENTS

This code is largely modeled upon, and in places copied from, work by Doug Hellmann in his virtualenvwrapper python package

COPYRIGHT & LICENSE

Copyright Doug Hellmann, All Rights Reserved

Permission to use, copy, modify, and distribute this software and its documentation for any purpose and without fee is hereby granted, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of Doug Hellmann not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission.

Copyright 2009 Christopher Mckay.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.