init

.zprezto/modules/perl/README.md

@@ -0,0 +1,63 @@
+Perl
+====
+
+Enables local [Perl][1] module installation on Mac OS X and defines aliases.
+
+Local Module Installation
+-------------------------
+
+Perl versions older than 5.14 do not support the local installation of Perl
+modules natively. This module allows for local installation of Perl modules on
+Mac OS X in *~/Library/Perl/5.12* by altering the environment.
+
+### Usage
+
+For Perl versions older than 5.14, install *local::lib*.
+
+    curl -L -C - -O http://search.cpan.org/CPAN/authors/id/A/AP/APEIRON/local-lib-1.008004.tar.gz
+    tar xvf local-lib-1.008004.tar.gz
+    cd local-lib-1.008004
+    perl Makefile.PL --bootstrap=$HOME/Library/Perl/5.12
+    make && make test && make install
+
+Install *cpanminus*:
+
+    curl -L http://cpanmin.us | perl - --self-upgrade
+
+Perlbrew
+--------
+
+An alternative to the above is to use [Perlbrew][2], which allows for the
+management of multiple, isolated Perl installations in the home directory.
+
+Aliases
+-------
+
+### General
+
+  - `pl` is short for `perl`.
+  - `pld` looks up Perl documentation (`perldoc`).
+  - `ple` executes a one line program in a loop (`perl -wlne`).
+
+### Perlbrew
+
+  - `plb` manages Perl environments.
+  - `plba` lists available Perl versions.
+  - `plbi` installs a Perl version.
+  - `plbl` lists installed Perl versions.
+  - `plbo` temporarily turns off Perlbrew.
+  - `plbO` turns off Perlbrew.
+  - `plbs` switches to a Perl version.
+  - `plbu` uninstalls a Perl version.
+  - `plbx` temporarily sets the Perl version to use.
+
+Authors
+-------
+
+*The authors of this module should be contacted via the [issue tracker][3].*
+
+  - [Sorin Ionescu](https://github.com/sorin-ionescu)
+
+[1]: http://www.perl.org
+[2]: http://perlbrew.pl
+[3]: https://github.com/sorin-ionescu/prezto/issues

.zprezto/modules/perl/init.zsh

@@ -0,0 +1,52 @@
+#
+# Enables local Perl module installation on Mac OS X and defines aliases.
+#
+# Authors:
+#   Sorin Ionescu <sorin.ionescu@gmail.com>
+#
+
+# Return if requirements are not found.
+if (( ! $+commands[perl] )); then
+  return 1
+fi
+
+#
+# Local Module Installation
+#
+
+if [[ "$OSTYPE" == darwin* ]]; then
+  # Perl is slow; cache its output.
+  cache_file="${0:h}/cache.zsh"
+  perl_path="$HOME/Library/Perl/5.12"
+
+  if [[ -f "$perl_path/lib/perl5/local/lib.pm" ]]; then
+    if [[ ! -s "$cache_file" ]]; then
+      perl -I$perl_path/lib/perl5 -Mlocal::lib=$perl_path >! "$cache_file"
+    fi
+
+    source "$cache_file"
+  fi
+
+  unset perl_path
+  unset cache_file
+fi
+
+#
+# Aliases
+#
+
+# General
+alias pl='perl'
+alias pld='perldoc'
+alias ple='perl -wlne'
+
+# Perlbrew
+alias plb='perlbrew'
+alias plba='perlbrew available'
+alias plbi='perlbrew install'
+alias plbl='perlbrew list'
+alias plbo='perlbrew off'
+alias plbO='perlbrew switch-off'
+alias plbs='perlbrew switch'
+alias plbu='perlbrew use'
+alias plbx='perlbrew uninstall'