Difference between revisions of "Perl package guidelines (Italiano)"

From ArchWiki
Jump to: navigation, search
m (Automatizzazione)
(Automatizzazione)
Line 72: Line 72:
  
 
{{Attenzione|Lo sviluppo di ''Bauerbill'' è stato ufficialmente interrotto: l'ultima versione disponibile è pertanto incompatibile con versioni di pacman superiori alla 3.5. Si veda a tal proposito: [[https://bbs.archlinux.org/viewtopic.php?id=115660]]. }}
 
{{Attenzione|Lo sviluppo di ''Bauerbill'' è stato ufficialmente interrotto: l'ultima versione disponibile è pertanto incompatibile con versioni di pacman superiori alla 3.5. Si veda a tal proposito: [[https://bbs.archlinux.org/viewtopic.php?id=115660]]. }}
 +
 +
==Dipendenze dei moduli==
 +
 +
Perl ha un modo particolare per definire le dipendenze di un pacchetto, rispetto ad altri sistemi come le python eggs o le ruby gems: un egg dipende da altri eggs; una gem da altre gems, mentre le varie Distribuzioni Perl dipendono dai moduli. I moduli sono disponibili esclusivamente tramite distribuzioni CPAN, ma una distribuzione dipende da altre distribuzioni in maniera indiretta: un modulo può definire una propria versione indipendente da quella della distribuzione a cui appartiene, specificandola all'interno del codice sorgente. Allo scopo, viene usata la variabile {{ic|$VERSION}} che, quando si usano {{ic|strics}} e {{ic|warnings}}, viene indicata con la keyword {{ic|our}}. Ad esempio:
 +
 +
package Foo::Module;
 +
use warnings;
 +
use strict;
 +
our $VERSION = '1.00';
 +
 +
I moduli possono cambiare la propria versione a piacimento, ed essere indipendenti da quela della distribuzione. L'utilità di questo comportamento è alquanto dubbia, ma è importante tenerlo a mente. Le versioni dei vari moduli sono difficili da determinare all'infuori dell'interprete perl e richiedono il parsing del codice del modulo, o persino il caricamento dello stesso in perl. Tuttavia, dall'interno dell'interprete perl, determinare la versione di un modulo è molto semplice. Ad esempio:
 +
 +
use Foo::Module;
 +
print $Foo::Module::VERSION, "\n";
 +
 +
===Implementazione===
 +
 +
CPAN è l'acronimo di "Centralized Network for Perl Authors". Ogni mirror CPAN, contiene gli indici delle distribuzioni disponibili su CPAN, i moduli in esse contenuti e il nome dell'autore che le ha caricate, il tutto contenuto in semplici files di testo. L'indice più utile risiede in {{ic|/modules/02packages.details.txt.gz}}, disponibile in ogni mirror CPAN. Il termine "packages" si riferisce alla keyword {{ic|package}} propria del linguaggio perl, e non ad un entità simile ai pacchetti pacman. La shell CPAN, scritta in minuscolo è semplicemente uno script Perl che naviga tali indici alla ricerca dei moduli che si desidera installare.
 +
 +
I moduli sono elencati nel file {{ic|02packages.details.txt.gz}}. Sulla stessa linea del nome del modulo/pacchetto, c'è il percorso al tarball della distribuzione contenente il modulo. Quando si richiede l'installazione di un modulo tramite ''cpan'', quest'ultimo verrà cercato nell'elenco e sarà installata la relativa distribuzione. Durante l'installazione, verrà generata una lista di dipendenze. ''Cpan'' proverà quindi a caricare ogni dipendenza nell'interprete perl: se un modulo della versione specificata non può essere caricato, il processo si ripete.
 +
 +
La shell ''cpan'' non deve preoccuparsi di quale versione del modulo richiesto stia installando, poichè l'ultima versione del modulo soddisferà sicuramente la richiesta del modulo di cui era stata inizialmente richiesta l'installazione. Solamente l'ultima versione di ogni modulo viene elencata nel file {{ic|02packages.details.txt.gz}} ma, sfortunatamente per l'autore di un pacchetto perl, non è sempre possibile fare affidamento sul fatto che i nostri pacchetti offrano l'ultima versione di una distribuzione perl e dei relativi moduli, poichè il controllo sulle dipendenze operato da Pacman, è molto più statico e rigido.
  
 
==Argomenti avanzati==
 
==Argomenti avanzati==

Revision as of 16:59, 26 February 2012

This template has only maintenance purposes. For linking to local translations please use interlanguage links, see Help:i18n#Interlanguage links.


Local languages: Català – Dansk – English – Español – Esperanto – Hrvatski – Indonesia – Italiano – Lietuviškai – Magyar – Nederlands – Norsk Bokmål – Polski – Português – Slovenský – Česky – Ελληνικά – Български – Русский – Српски – Українська – עברית – العربية – ไทย – 日本語 – 正體中文 – 简体中文 – 한국어


External languages (all articles in these languages should be moved to the external wiki): Deutsch – Français – Română – Suomi – Svenska – Tiếng Việt – Türkçe – فارسی

Nomenclatura pacchetti

Per quanto riguarda i moduli, il nome del pacchetto dovrebbe iniziare con perl-, mentre il resto dovrebbe essere ricavato dal nome del modulo scritto in minuscolo, sostituendo i due punti con dei trattini. Per esempio, il nome pacchetto corrispondente al modulo HTML::Parser sarà perl-html-parser. Le applicazioni in Perl, dovrebbero mantenere il loro nome, avendo però cura di scriverlo in minuscolo.

Posizione dei files

I moduli Perl dovrebbero installare i propri files in /usr/lib/perl5/vendor_perl/ (questo comportamento si può ottenere impostando la variabile INSTALLDIRS, come mostrato sotto). Nessun file dovrebbe essere inserito in /usr/lib/perl5/site_perl/, poichè quella directory è riservata ai pacchetti Perl non installati tramite il package manager. I files perllocal.pod e .packlist dovrebbero essere presenti. Le operazioni sopra elencate vengono eseguite nel PKGBUILD d'esempio mostrato sotto.

Esempio

Un PKGBUILD d'esempio può essere trovato in /usr/share/pacman/PKGBUILD-perl.proto, file fornito dal pacchetto abs. Viene anche riportato sotto:

 _author=AUTHOR_NAME
 _perlmod=MODNAME
 pkgname=perl-$_perlmod
 pkgver=VERSION
 pkgrel=1
 pkgdesc=""
 arch=()
 url="http://search.cpan.org/~$_author/$_perlmod-$pkgver/"
 license=('GPL' 'PerlArtistic')
 groups=()
 depends=('perl>=5.10.0')
 makedepends=()
 provides=()
 conflicts=()
 replaces=()
 backup=()
 options=(!emptydirs)
 install=
 source=(http://cpan.perl.org/modules/by-authors/id/$_author/$_perlmod-$pkgver.tar.gz)
 md5sums=()

 build() {
  cd "$srcdir/$_perlmod-$pkgver"

  # Install module in vendor directories.
  PERL_MM_USE_DEFAULT=1 perl Makefile.PL INSTALLDIRS=vendor
  make

  ## For packages with Build.PL, do this instead:
  # perl Build.PL installdirs=vendor destdir="$pkgdir/"
  # perl Build
 }

 package() {
  cd "$srcdir/$_perlmod-$pkgver"
  make install DESTDIR="$pkgdir/"

  ## For packages with Build.PL, do this instead:
  # perl Build install
 }

 # vim:set ts=2 sw=2 et:

Nella maggior parte dei casi, è consigliato inserire any nell'array arch, poichè molti pacchetti Perl sono indipendenti dall'architettura del sistema.

Automatizzazione

Poichè Perl si basa su CPAN, esistono alcuni script che eseguono quanto scritto sopra automaticamente, risparmiandovi dallo scrivere i PKGBUILD a mano.

CPANPLUS (disponibile come perl-cpanplus-dist-arch nel repository [community]), è un plugin a CPAN che pacchettizza al volo i moduli installati tramite lo stesso. E' possibile consultare la documentazione online all'indirizzo: https://metacpan.org/release/CPANPLUS-Dist-Arch

Attenzione: Lo sviluppo di Pacpan è stato ufficialmente interrotto: l'ultima versione disponibile è pertanto incompatibile con versioni di pacman superiori alla 3.5. Si veda a tal proposito: [[1]].

Esiste inoltre uno script, chiamato pacpan, che è in grado di generare ricosivamente dei PKGBUILD per un dato modulo.

Vale la pena segnalare che Bauerbill supporta la generazione di PKGBUILD in modo simile a quanto fatto da pacpan, così come è in grado di aggiornare tutti i moduli CPAN direttamente da CPAN stesso attraverso un'interfaccia a pacman. Assicurarsi di leggere la pagina di manuale di Bauerbill per le istruzioni d'uso.

Attenzione: Lo sviluppo di Bauerbill è stato ufficialmente interrotto: l'ultima versione disponibile è pertanto incompatibile con versioni di pacman superiori alla 3.5. Si veda a tal proposito: [[2]].

Dipendenze dei moduli

Perl ha un modo particolare per definire le dipendenze di un pacchetto, rispetto ad altri sistemi come le python eggs o le ruby gems: un egg dipende da altri eggs; una gem da altre gems, mentre le varie Distribuzioni Perl dipendono dai moduli. I moduli sono disponibili esclusivamente tramite distribuzioni CPAN, ma una distribuzione dipende da altre distribuzioni in maniera indiretta: un modulo può definire una propria versione indipendente da quella della distribuzione a cui appartiene, specificandola all'interno del codice sorgente. Allo scopo, viene usata la variabile $VERSION che, quando si usano strics e warnings, viene indicata con la keyword our. Ad esempio:

package Foo::Module;
use warnings;
use strict;
our $VERSION = '1.00';

I moduli possono cambiare la propria versione a piacimento, ed essere indipendenti da quela della distribuzione. L'utilità di questo comportamento è alquanto dubbia, ma è importante tenerlo a mente. Le versioni dei vari moduli sono difficili da determinare all'infuori dell'interprete perl e richiedono il parsing del codice del modulo, o persino il caricamento dello stesso in perl. Tuttavia, dall'interno dell'interprete perl, determinare la versione di un modulo è molto semplice. Ad esempio:

use Foo::Module;
print $Foo::Module::VERSION, "\n";

Implementazione

CPAN è l'acronimo di "Centralized Network for Perl Authors". Ogni mirror CPAN, contiene gli indici delle distribuzioni disponibili su CPAN, i moduli in esse contenuti e il nome dell'autore che le ha caricate, il tutto contenuto in semplici files di testo. L'indice più utile risiede in /modules/02packages.details.txt.gz, disponibile in ogni mirror CPAN. Il termine "packages" si riferisce alla keyword package propria del linguaggio perl, e non ad un entità simile ai pacchetti pacman. La shell CPAN, scritta in minuscolo è semplicemente uno script Perl che naviga tali indici alla ricerca dei moduli che si desidera installare.

I moduli sono elencati nel file 02packages.details.txt.gz. Sulla stessa linea del nome del modulo/pacchetto, c'è il percorso al tarball della distribuzione contenente il modulo. Quando si richiede l'installazione di un modulo tramite cpan, quest'ultimo verrà cercato nell'elenco e sarà installata la relativa distribuzione. Durante l'installazione, verrà generata una lista di dipendenze. Cpan proverà quindi a caricare ogni dipendenza nell'interprete perl: se un modulo della versione specificata non può essere caricato, il processo si ripete.

La shell cpan non deve preoccuparsi di quale versione del modulo richiesto stia installando, poichè l'ultima versione del modulo soddisferà sicuramente la richiesta del modulo di cui era stata inizialmente richiesta l'installazione. Solamente l'ultima versione di ogni modulo viene elencata nel file 02packages.details.txt.gz ma, sfortunatamente per l'autore di un pacchetto perl, non è sempre possibile fare affidamento sul fatto che i nostri pacchetti offrano l'ultima versione di una distribuzione perl e dei relativi moduli, poichè il controllo sulle dipendenze operato da Pacman, è molto più statico e rigido.

Argomenti avanzati

Una volta che si è acquisita dimestichezza con la creazione di pacchetti perl, è possibile leggere la sezione sottostante, che potrebbe offrire parecchi spunti interessanti. Le informazioni sotto riportate potrebbero inoltre essere utili per risolvere i problemi di pacchettizzazione.

Glossario

Si dovrebbe aver già acquisito familiarità con i seguenti termini:

Modulo

In Perl, moduli sono dichiarati con la parola chiave package. Essi sono contenuti all'interno di un file con estensione .pm, che può a sua volta ospitare diversi moduli al suo interno. I namespace dei moduli sono separati da ::, (due doppi punti), ad esempio: Archlinux::Modulo. Quando si carica un modulo, i due doppi punti sono sostituiti con uno slash. Per esempio, il modulo Archlinux::Modulo caricherà il file Archlinux/Modulo.pm.

Core Module

I Core Modules sono quelli inclusi in un'installazione di Perl, ed alcuni di essi sono disponibili solamente con Perl stesso. Altri moduli possono invece essere scaricati tramite CPAN.

Dist Packages

Sono l'equivalente Perl di un pacchetto di Archlinux. I dist packages sono archivi .tar.gz pieni di files con estensione .pm, tests, documentazione, e tutto il necessario per i moduli ivi contenuti.

Installazione di Perl locale

Il fatto che i programmatori perl potrebbero voler installare diverse versioni di perl potrebbe rappresentare un problema, benchè ciò sia utile per verificare la retrocompatibilità dei programmi. Compilare una propria versione di perl potrebbe garantire inoltre benefici prestazionali. Inoltre, poichè spesso il perl di sistema non è all'ultima versione disponibile, l'utente potrebbe decidere di voler provare una versione più recente.

Se l'utente ha l'eseguibile perl nel proprio $PATH, esso verrà eseguito quando si scrive il comando "perl" nella shell. Inoltre, questo verrà eseguito anche all'interno del PKGBUILD, cosa che potrebbe causare problemi di difficile individuazione.

Il problema principale risiede nei moduli XS, che fungono da bridge tra Perl e C, usando le API proprie del Perl. Poichè queste ultime possono cambiare in modo significativo tra due versioni di Perl, se l'utente compila dei moduli XS con la propria versione dell'interprete, questi saranno incompatibili con il Perl di sistema, il quale darà luogo ad un errore di linkin quando si proverà a caricarli.

Una soluzione potrebbe essere quella di specificare il path assoluto dell'interprete di sistema (/usr/bin/perl) quando si richiama il comando perl nel PKGBUILD.

Moduli per l'installazione di moduli Perl

Uno dei maggiori vantaggi del Perl, è la grande varietà di moduli/dist packages installabili tramite CPAN. Tra gli altri, esistono moduli che si occupano dell'installazione di... moduli!

Ne esistono di diversi tipi, ma generalmente il procedimento è sempre lo stesso e si basa sull'inserimento di un piccolo build script nel pacchetto contenente il modulo perl: avviando questo script, il processo di compilazione e installazione ha inizio.

Di seguito, un elenco dei moduli più comuni:

ExtUtils::MakeMaker

Build script
MakeFile.PL
CPAN Link
http://search.cpan.org/dist/ExtUtils-MakeMaker

Il primo, e più vecchio è sicuramente ExtUtils::MakeMaker. Il principale svantaggio di questo sistema, è che richiede l'utility make affinché possa compilare ed installare il tutto. Benchè questo non sia un grande problema su un sistema Linux, può diventare problematico per utenti Windows! La comunità Perl sta cercando di incoraggiare l'uso di moduli più nuovi, che non hanno questo problema.

Module::Build

Build Script
Build.PL
CPAN Link
http://search.cpan.org/dist/Module-Build

Il vantaggio principale derivante dall'uso di questo modulo, è che usa solamente perl e perciò non richiede l'utility make per funzionare. Un tempo, la sua installazione era abbastanza difficoltosa, poichè non era possibile eseguire il build script senza averlo prima installato. Ad oggi, ciò non rappresenta più un problema, visto Module::Build fa parte dei core modules.

Module::Install

Build Script
Makefile.PL
CPAN Link
http://search.cpan.org/dist/Module-Install

Di recente introduzione, Module::Install richiede che make sia installato per funzionare. È stato scritto per essere un sostituto naturale di ExtUtils::MakeMaker, oltre che per compensare ad alcune delle sue mancanze.

Una caratteristica molto interessante di questo modulo, è che ne viene fornita una copia all'interno del dist package, cosicchè, a differenza dei moduli sopra menzionati, non sia necessario installarlo nel sistema.

Un'altra caratteristica di rilievo è l'auto-install. Anche se l'uso di questa feature non è raccomandato, questa viene usata molto spesso. Quando l'autore del modulo ne abilita l'uso, Module::Install procederà alla ricerca e all'installazione di tutti i moduli richiesti che non siano presenti al momento dell'esecuzione di Makefile.PL. Benchè questa funzione venga disabilitata quando Module::Install viene eseguito da CPAN o CPANPLUS, ciò non accade se viene utilizzato all'interno di un PKGBUILD! Si veda PERL_AUTOINSTALL per risolvere il problema.

Variabili d'ambiente

Alcune variabili di sistema, possono influenzare il modo in cui i moduli sono compilati o installati, e potrebbero causare problemi inaspettati se usate in modo scorretto, specialmente all'interno di un PKGBUILD.

PERL_MM_USE_DEFAULT

Quando questa variabile ha valore "true", i sistemi di installazione dei moduli descritti sopra, risponderanno ad eventuali domande con una risposta affermativa.

PERL_AUTOINSTALL

È possibile passare degli argomenti a linea di comando aggiuntivi a Module::Install attraverso questa variabile. Per disattivare l'auto-install (altamente consigliato), si assegni il valore --skipdeps a questa variabile.

export PERL_AUTOINSTALL="--skipdeps"

PERL_MM_OPT

Questa variabile consente, similmente a PERL_AUTOINSTALL, di passare degli argomenti al sistema di build. Per esempio, è possibile installare i moduli nella propria home directory usando:

export PERL_MM_OPT=INSTALLBASE=~/perl5

PERL_MB_OPT

Uguale a PERL_MM_OPT, questa variabile è riservata a Module::Build. Come sopra, per installare i moduli nella propria home directory:

export PERL_MB_OPT=--install_base=~/perl5

MODULEBUILDRC

Module::Build permette di scavalcare gli argomenti a riga di comando con un file di configurazione. Di default, questo è ~/.modulebuildrc. È possibile definire un file di configurazione personalizzato inserendone il percorso in MODULEBUILDRC.

Esempio migliorato

Usando le nozioni appena acquisite, è possibile creare un PKGBUILD che resisterà a qualunque tentativo di sabotaggio da parte delle variabili d'ambiente:

# Contributor: Your Name <youremail@domain.com>
pkgname=perl-foo-bar
pkgver=VERSION
pkgrel=1
pkgdesc='This is the awesome Foo::Bar module!'
arch=('any')
url='http://search.cpan.org/dist/Foo-Bar'
license=('GPL' 'PerlArtistic')
depends=('perl>=5.10.0')
makedepends=()
provides=()
conflicts=()
replaces=()
backup=()
options=(!emptydirs)
install=
source=("http://search.cpan.org/CPAN/authors/id/***/***-$pkgver.tar.gz")
md5sums=()

build() {
  cd "$srcdir/***-$pkgver"
  
  # Setting these env variables overwrites any command-line-options we don't want...
  export PERL_MM_USE_DEFAULT=1 PERL_AUTOINSTALL=--skipdeps \
    PERL_MM_OPT="INSTALLDIRS=vendor DESTDIR='$pkgdir'" \
    PERL_MB_OPT="--installdirs vendor --destdir '$pkgdir'" \
    MODULEBUILDRC=/dev/null

  # If using Makefile.PL
  { /usr/bin/perl Makefile.PL &&
    make &&
    make test &&
    make install; } || return 1

  # If using Build.PL
  { /usr/bin/perl Build.PL &&
    ./Build &&
    ./Build test &&
    ./Build install; } || return 1

  # remove perllocal.pod and .packlist
  find "$pkgdir" -name .packlist -o -name perllocal.pod -delete