export vs export_ok in perl

Question

Non riesco a capire qual è la differenza/use case di EXPORT_OK rispetto a EXPORT.
La maggior parte delle risorse accenna qualcosa nelle linee di:

@Export permette di esportare le funzioni e le variabili di moduli per namespace dell'utente utilizzando il metodo standard di importazione. In questo modo, non è necessario che crei gli oggetti per i moduli per accedere ai relativi membri.
@EXPORT_OK esegue l'esportazione di simboli su richiesta per l'elenco selettivo di simboli (subroutine e variabili) del modulo.

Ma io davvero non vedo la differenza/significato qui.
Qualcuno può fornire un piccolo esempio fondamentale della differenza/utilizzo di questi 2 simboli?

Answer 1

Dal fine Exporter manual:

• use YourModule;
  Questo importa tutti i simboli nomemodulo di @EXPORT nel namespace del utilizzo dichiarazione.
• use YourModule();
  Ciò fa sì che perl carichi il modulo ma non importi alcun simbolo.
• use YourModule qw(...);
  Questo importa solo i simboli elencati dal chiamante nel proprio spazio dei nomi. Tutti i simboli elencati devono essere nel tuo @EXPORT o @EXPORT_OK, altrimenti si verifica un errore. Le funzionalità di esportazione avanzate di Exporter sono accessibili in questo modo, ma con voci di lista che sono sintatticamente distinte dai nomi dei simboli.

Quindi, se si utilizza @EXPORT e qualcuno fa il solito use YourModule;, allora hai appena inquinato il loro spazio dei nomi con tutto in @EXPORT. Ma se usi @EXPORT_OK, loro devono chiedere specificamente cose da importare in modo che la persona che usa il tuo modulo abbia il controllo su cosa succede al loro spazio dei nomi.

la differenza è davvero una questione di chi controlla cosa entra nel namespace use del r: se si utilizza @EXPORT allora il modulo essendo use d fa, se si utilizza @EXPORT_OK quindi il codice a fare l'importazione controlla il proprio spazio dei nomi.

Ovviamente, puoi sempre dire use Whatever(); per impedire ai moduli maleducati di inquinare il tuo spazio dei nomi, ma questo è brutto e non dovresti avere a che fare con codice maleducato che vuole scarabocchiare tutto il tuo spazio dei nomi.

Answer 2

Diciamo che ho un pacchetto MyPackage che utilizza @EXPORT.

#this is MyPackage.pm 
package MyPackage; 
@EXPORT = qw(do_awesome_thing); 

sub do_awesome_thing { ... } 

sub be_awesome { ... } 

Ora, quando uso MyPackage nel mio codice,

#this is myscript.pl 
use MyPackage; 

do_awesome_thing(); #works 

be_awesome(); #doesn't work 
MyPackage::be_awesome(); #works 

do_awesome_thing ottiene esportati automaticamente al mio codice da MyPackage, senza di me dover dire "dare a questo a me". be_awesome non viene esportato (e non verrà esportato con @EXPORT_OK, sto solo mostrando quella parte per chiarire cosa ci "esporta").

D'altra parte, se ho un pacchetto MyOtherPackage che utilizza @EXPORT_OK,

#this is MyOtherPackage.pm 
package MyOtherPackage; 
@EXPORT_OK = qw(do_awesome_thing); 

sub do_awesome_thing { ... } 

sub be_awesome { ... } 

e quindi provare

#this is mynewscript.pl 
use MyOtherPackage; 

do_awesome_thing(); #doesn't work 
MyOtherPackage::do_awesome_thing(); #works, as always 

la linea chiamando direttamente do_awesome_thing non funzionerà. Questo perché mettere qualcosa in @EXPORT_OK dice "dai ai miei utenti solo se lo chiedono". Poiché abbiamo appena detto use MyOtherPackage senza chiedere esplicitamente che do_awesome_thing venga importato qui, non viene importato ed è accessibile solo specificando il nome del pacchetto.

Il modo in cui si richiede do_awesome_thing da importare è use MyOtherPackage qw(do_awesome_thing) nella seconda riga di mynewscript.pl precedente. Questo dice importare quel modulo e rendere disponibile do_awesome_thing direttamente. Dopodiché, la quarta riga in mynewscript.pl inizierà a funzionare.

Si noti che l'utente può specificare anche use MyPackage qw(do_awesome_thing) con il primo pacchetto, e in tal caso, qualsiasi altro contenuto nell'elenco @EXPORT non verrà esportato, sarà solo do_awesome_thing. Pertanto, ad eccezione del caso predefinito use PackageName;, @EXPORT e @EXPORT_OK si comportano in modo simile. Nel caso predefinito, qualsiasi elemento di @EXPORT viene automaticamente inserito nello script dell'utente, mentre @EXPORT_OK è più educato e non esporta nulla.