#perldoc

Vi devo ancora spiegazione di come ho risolto la questione delle librerie da caricare.

Come vi ho detto non avevo voglia di una soluzione complessa e così mi sono accontentato di una soluzione sporca: in pratica mi sono arreso all'idea di installare sul server tutte le librerie necessarie prendendole giù da CPAN, sperando di non introdurre incompatibilità.

Rimane il problema: come fare a capire quali sono tutte le librerie?

Per risolvere questo problema mi è venudo in aiuto perldoc perllocal, comando che vi permette di vedere tutte le librerie che avete installato nel vostro sistema. Ovviamente, se accendendete una sandbox via local::lib, censisce solo le librerie che, appunto, avete in quel contesto.

perldoc perllocal non fa altro che leggere un file pod. Purtroppo questo file è troppo human readable per fini di automazione quindi gli ho spremuto fuori il listone grezzo di librerie con un banalissimo script:

#!/usr/bin/perl my $input_file = $ARGV[0];

open(INPUT, "< $input_file"); for(<INPUT>) {

     if(m/C<Module>/)       {            m/L<(.*)\|/;            print "cpan -i $1\n";        } }

Come vedete a quel punto ho un bordello di cpan -i che, messi in uno script sh, partono praticamente da soli.

L'unica ottimizzazione che andrebbe fare è capire come far dire yes a CPAN in automatico :-)

Questo sistema mi ha permesso di completare il setup su server.

Ora c'è già qualcosina di vivo, ma prima di cantare vittoria devo imparare a usare mod_proxy e gestire le risorse statiche nella maniera giusta.

Some time ago I wrote about perldoc being perl's killer app. I still think that's true. Recently I've been going through my python code and attempting to add useful comments that could be picked up by some auto documenting mechanism. Clearly they exist... python.org is full of doc and I'm certain it's rendered.

Included with python, since 2.1, is pydoc. At first glance it appears to be an analog to perldoc; and for the most part it isn't.

pydoc will generate text or html - perldoc will convert the poddoc to html, latex, man, text

pydoc has a graphic UI embedded - but it requires TK (and x-windows)

pydoc has an embedded http server - could leak important data if the pydoc is internal use only.

perldoc generates static files - pydoc generates dynamic files

pydoc recurses the class dependency tree - if the stack is deep the document is long (there is a lesson in this)

In a way, it's nice that pydoc scans your code looking for your comments in your classes etc. The format makes sense and it's not all that terrible. There are even ways to comment individual functions instead of just one monster perldoc (as typically demonstrated)

  So perldoc is still the killer app.