A tecnica de 'bootstrapping'¶

Uma forma comum de instalar o local::lib e usando o que e conhecido como tecnica de "bootstrapping". E uma boa abordagem caso seu administrador de sistemas na~o tenha instalado o local::lib. Nesse caso, voce precisara instalar o local::lib em seu diretorio de usuario.

Caso voce tenha privilegios de administrador, ainda assim devera configurar suas variaveis de ambiente, como discutido no passo 4, abaixo. Sem elas, voce ainda instalara modulos no CPAN do sistema e seus scripts Perl na~o utilizara~o o caminho para o lib/ que voce definiu com o local::lib.

Por padra~o, o local::lib instala os modulos do CPAN e a si proprio em ~/perl5.

Usuarios do Windows devem ler "Diferencas ao usar esse modulo em Win32".

1. Baixe e descompacte o local::lib do CPAN (procure por "Download" na pagina do CPAN sobre o local::lib). Faca isso como um usuario comum, na~o como root ou administrador. Descompacte o arquivo em seu diretorio de usuario ou em qualquer outro local conveniente.

2. Execute isso:

  perl Makefile.PL --bootstrap

Caso o sistema pergunte se deve configurar tudo que puder automaticamente, voce provavelmente deve responder que sim (yes).

Para instalar o local::lib em um diretorio que na~o o padra~o, voce precisara especifica-lo ao chamar o bootstrap, da seguinte forma:

  perl Makefile.PL --bootstrap=~/foo

3. Execute isso: (local::lib assume que voce possui o comando 'make' instalado em seu sistema)

  make test && make install

4. Agora precisamos configurar as variaveis de ambiente apropriadas para que o Perl use nosso recem-criado diretorio lib/. Caso esteja usando bash ou outra shell Bourne, voce pode fazer isso adicionando a seguinte linha em seu script de inicializaca~o da shell:

  echo 'eval $(perl -I$HOME/perl5/lib/perl5 -Mlocal::lib)' >>~/.bashrc

Caso esteja usando a shell C, pode fazer da seguinte forma:

  /bin/csh
  echo $SHELL
  /bin/csh
  perl -I$HOME/perl5/lib/perl5 -Mlocal::lib >> ~/.cshrc

Caso tenha passado para o bootstrap um diretorio que na~o o padra~o, voce precisara indica-lo na chamada ao local::lib, dessa forma:

  echo 'eval $(perl -I$HOME/foo/lib/perl5 -Mlocal::lib=$HOME/foo)' >>~/.bashrc

Apos atualizar seu arquivo de configuraca~o da shell, certifique-se de processa-lo novamente para obter as modificaco~es em sua shell atual. Shells Bourne usam ". ~/.bashrc" para isso, enquanto shells C usam "source ~/.cshrc".

Se estiver em uma maquina lenta ou operando com grandes limitaco~es de espaco em disco, voce pode desativar a geraca~o automatica de manpages a partir do POD ao instalar modulos. Para isso, basta passar o argumento "--no-manpages" durante o bootstrap:

  perl Makefile.PL --bootstrap --no-manpages

Para evitar ter que fazer varios bootstraps para varios ambientes de modulos Perl na mesma conta de usuario - por exemplo se voce usa o local::lib para desenvolver diferentes aplicativos independentes - voce pode utilizar uma unica instalaca~o bootstrap do local::lib para instalar modulos em diretorios diferentes da seguinte forma:

  cd ~/meudir1
  perl -Mlocal::lib=./
  eval $(perl -Mlocal::lib=./)  ### Para configurar o ambiente apenas nessa shell
  printenv                      ### Veja que o ~/meudir1 esta na PERL5LIB
  perl -MCPAN -e install ...    ### Os modulos que quiser
  cd ../meudir2
  ... REPITA ...

Para multiplos ambientes destinados a multiplos aplicativos, voce pode precisar incluir uma versa~o modificada das instruco~es de "use FindBin" no exemplo "No codigo" acima. Caso tenha feito algo como o que foi descrito acima, tera um conjunto de modulos Perl em "~/meudir1/lib". Caso tenha um script em "~/meudir1/scripts/meuscript.pl", voce precisara indicar a ele onde encontrar os modulos que instalou para ele em "~/meudir1/lib".

Em "~/meudir1/scripts/meuscript.pl":

  use strict;
  use warnings;
  use local::lib "$FindBin::Bin/..";  ### aponta para ~/meudir1 e o local::lib acha o lib/
  use lib "$FindBin::Bin/../lib";     ### aponta para ~/meudir1/lib

Coloque isso antes de qualquer bloco BEGIN { ... } que precise dos modulos instalados.

Diferencas ao usar esse modulo em Win32¶

Para configurar as variaveis de ambiente apropriadas para sua sessa~o atual do "CMD.exe", voce pode fazer assim:

  C:\>perl -Mlocal::lib
  set PERL_MB_OPT=--install_base C:\DOCUME~1\ADMINI~1\perl5
  set PERL_MM_OPT=INSTALL_BASE=C:\DOCUME~1\ADMINI~1\perl5
  set PERL5LIB=C:\DOCUME~1\ADMINI~1\perl5\lib\perl5;C:\DOCUME~1\ADMINI~1\perl5\lib\perl5\MSWin32-x86-multi-thread
  set PATH=C:\DOCUME~1\ADMINI~1\perl5\bin;%PATH%
  
  ### Para configurar o ambiente apenas dessa shell
  C:\>perl -Mlocal::lib > %TEMP%\tmp.bat && %TEMP%\tmp.bat && del %TEMP%\temp.bat
  ### em vez de $(perl -Mlocal::lib=./)

Caso queira que as configuraco~es do ambiente persistam, voce precisara adiciona-las em Painel de Controle -> Sistema, ou usar o App::local::lib::Win32Helper.

O "~" e transformado no diretorio do perfil do usuario (o diretorio com o nome do usuario dentro de "Documents and Settings" (Windows XP ou anterior) ou "Usuarios" (Windows Vista e mais recentes)) a menos que $ENV{HOME} exista. Apos isso, o nome do diretorio e encurtado e os subdiretorios sa~o criados (o que significa que o diretorio deve existir).

ensure_dir_structure_for¶

Argumentos: $caminho_do_diretorio

Valor de Retorno: Nenhum

Tenta criar o caminho fornecido, e todos os diretorios superiores necessarios. Gera uma exceca~o em caso de falha.

print_environment_vars_for¶

Argumentos: $caminho_do_diretorio

Valor de Retorno: Nenhum

Exibe na saida padra~o as variaveis listadas acima, devidamente ajustadas para utilizar o caminho fornecido como diretorio base.

build_environment_vars_for¶

Argumentos: $caminho_do_diretorio, $interpolar

Valor de Retorno: %variaveis_de_ambiente

Retorna hash contendo as variaveis de ambiente listadas acima, devidamente ajustadas para utilizar o caminho fornecido como diretorio base.

setup_env_hash_for¶

Argumentos: $caminho_do_diretorio

Valor de Retorno: Nenhum

Constroi as chaves no %ENV para o caminho fornecido, chamando "build_environment_vars_for".

install_base_perl_path¶

Argumentos: $caminho_do_diretorio

Valor de Retorno: $caminho_base_de_instalacao

Retorna um caminho de diretorio indicando onde instalar os modulos Perl para essa instalaca~o local de bibliotecas. Adiciona os diretorios "lib" e "perl5" ao final do caminho fornecido.

install_base_arch_path¶

Argumentos: $caminho_do_diretorio

Valor de Retorno: $caminho_base_de_instalacao_arch

Retorna um caminho de diretorio indicando onde instalar os modulos Perl de arquiteturas especificas para essa instalaca~o local de bibliotecas. Baseia-se no valor de retorno do metodo "install_base_perl_path", adicionando o valor de $Config{archname}.

install_base_bin_path¶

Argumentos: $caminho_do_diretorio

Valor de Retorno: $caminho_base_de_instalacao_bin

Retorna um caminho de diretorio indicando onde instalar programas executaveis para essa instalaca~o local de bibliotecas. Baseia-se no valor de retorno do metodo "install_base_perl_path", adicionando o diretorio "bin".

resolve_empty_path¶

Argumentos: $caminho_do_diretorio

Valor de Retorno: $caminho_base_de_instalacao

Cria e retorna o caminho de diretorio raiz em que a instalaca~o local de modulos deve ser feita. O padra~o e "~/perl5".

resolve_home_path¶

Argumentos: $caminho_do_diretorio

Valor de Retorno: $caminho_para_home

Procura pelo diretorio padra~o (home) do usuario. Caso esteja instalado, utiliza o "File::HomeDir" para isso. Gera uma exceca~o caso na~o encontre resultado definitivo.

resolve_relative_path¶

Argumentos: $caminho_do_diretorio

Valor de Retorno: $caminho_absoluto

Transforma o caminho fornecido em um caminho absoluto.

resolve_path¶

Argumentos: $caminho_do_diretorio

Valor de Retorno: $caminho_absoluto

Invoca os seguintes metodos em sequencia, passando o resultado do metodo anterior para o seguinte, na tentativa de descobrir onde configurar o ambiente para a instalaca~o local de bibliotecas: "resolve_empty_path", "resolve_home_path", "resolve_relative_path". Passa o caminho de diretorio fornecido para "resolve_empty_path" que retorna um resultado que e passado para "resolve_home_path", que enta~o tem seu resultado passado para "resolve_relative_path". O resultado dessa chamada final e enta~o retornado pelo "resolve_path".