Pacchetto :: deprecationmanager. Gestisci Avvertenze di deprecazione per la tua distribuzione
Scarica ora

Pacchetto :: deprecationmanager. Classifica e riepilogo

Pacchetto :: deprecationmanager. Tag

modulo Perl perl Avvertenze deprecazione Avvertenze di deprecazione direttore di deprecazione

Pacchetto :: deprecationmanager. Descrizione

Gestire gli avvertenze di deprecazione per la tua distribuzione Pacchetto :: DeprecationManager è un modulo Perl che consente di gestire un insieme di deprecazioni per uno o più moduli. Quando si imposta il pacchetto :: DeprecationManager, è necessario fornire un insieme di -Deprecazioni come hash ref. I tasti sono nomi "funzionalità" e i valori sono la versione quando quella funzione è stata deprecata. In molti casi, è possibile utilizzare semplicemente il nome completo di una subroutine o il metodo come nome della funzione. Questo funziona per casi in cui l'intera subroutine è deprecata. Tuttavia, i nomi delle caratteristiche possono essere qualsiasi stringa. Questo è utile se non vuoi deprecare un'intera subroutine, solo un certo utilizzo. Puoi anche fornire un riferimento di array opzionale nel parametro -ignore. I valori da ignorare possono essere i nomi dei pacchetti o le espressioni regolari (realizzate con QR //). Utilizzare questo per ignorare i pacchetti nella tua distribuzione che può apparire nello stack di chiamata quando viene utilizzata una funzione deprecata. Una parte del processo di importazione, pacchetto :: deprecationmanager esporterà due subroutine nel suo chiamante. Fornisce un'importazione () Sub per il chiamante e un subnoteco () sub.La import () subs () Sub consente ai chiamanti della classe di specificare un parametro -api_version. Se ciò viene fornito, le avvertenze di deprecazione vengono rilasciate solo per le deprecazioni per le versioni API prima di quella specificata. È necessario chiamare il subroutine demolito () in ciascuna subroutine deprecata. Quando viene chiamato, emetterà un avvertimento usando Carp :: Cluck (). Il subnoteco () sub può essere chiamato in diversi modi. Se non superano alcun argomento, genererà un messaggio di avviso appropriato. Se si passa un singolo argomento, questo viene utilizzato come messaggio di avviso. Infinalmente, è possibile chiamarlo con argomenti denominati. Attualmente, gli unici nomi consentiti sono messaggi e funzionalità. L'argomento delle caratteristiche dovrebbe corrispondere al nome della funzione passata in -deprecations hash.it Non specificare esplicitamente una funzionalità, il subnotante () sub utilizza il chiamante () per identificare il suo chiamante, utilizzando il suo nome di subroutine completamente qualificato. L'avviso viene rilasciato solo una volta per un dato pacchetto. Questo modulo traccia questo in base al nome del nome della funzione e dal messaggio di errore stesso. Ciò significa che se fornisci diversi messaggi di errore indifferenti per la stessa funzione, tutti questi errori appariranno.Synopsis Package My :: Class; Usa pacchetto :: deprecationmanager -Deprecations => {'My :: class :: foo' => '0.02', 'My :: class :: bar' => '0.05', 'feature-x' => '0.07' ,};; sub foo {deprecato ('non chiamare foo!'); ...} Sub bar {deprecato (); ...} sub baz {my% args = @_; se ($ args {foo}) {deprecated (messaggio => ..., feature => 'feature-x',); }} Pacchetto Altro :: Class; Usa il mio :: class -api_version => '0.04'; My :: Class-> New () -> foo (); # avverte il mio :: class-> nuovo () -> bar (); # non avverte il mio :: class-> nuovo () -> lontano (); # non avverte di nuovo i requisiti: · Perl.

Pacchetto :: deprecationmanager. Software correlato