perl-Package-DeprecationManager

Questo modulo consente di gestire un insieme di deprecazioni per uno o più moduli. Quando si importa 'Package::DeprecationManager', si deve fornire un insieme di '-deprecations' come riferimento a hash. Le chiavi sono nomi di "feature", e i valori sono la versione in cui quella feature è stata deprecata. In molti casi, si può semplicemente usare il nome completamente qualificato di una subroutine o metodo come nome di feature. Funziona nei casi in cui l'intera subroutine è deprecata. Tuttavia, i nomi di feature possono essere qualsiasi stringa. È utile se non si vuole deprecare un'intera subroutine, ma solo un certo utilizzo. Si può anche fornire un riferimento a array opzionale nel parametro '-ignore'. I valori da ignorare possono essere nomi di package o espressioni regolari (create con 'qr//'). Usarlo per ignorare package nella propria distribuzione che possono comparire nello stack delle chiamate quando si usa una feature deprecata. Come parte del processo di import, 'Package::DeprecationManager' esporta due subroutine nel suo chiamante. Fornisce una sub 'import()' per il chiamante e una sub 'deprecated()'. La sub 'import()' permette ai chiamanti della _vostra_ classe di specificare un parametro '-api_version'. Se fornito, gli avvisi di deprecazione vengono emessi solo per deprecazioni con versioni API precedenti a quella specificata. Si deve chiamare la sub 'deprecated()' in ogni subroutine deprecata. Quando chiamata, emette un avviso usando 'Carp::cluck()'. La sub 'deprecated()' può essere chiamata in diversi modi. Se non si passa alcun argomento, genera un messaggio di avviso appropriato. Se si passa un single argomento, questo viene usato come messaggio di avviso. Infine, si può chiamarla con argomenti nominati. Attualmente, gli unici nomi consentiti sono 'message' e 'feature'. L'argomento 'feature' dovrebbe corrispondere al nome di feature passato nell'hash '-deprecations'. Se non si specifica esplicitamente una feature, la sub 'deprecated()' usa 'caller()' per identificare il suo chiamante, usando il suo nome di subroutine completamente qualificato. Un dato avviso di deprecazione viene emesso una sola volta per un dato package. Questo modulo lo tiene traccia in base sia al nome della feature _sia_ al messaggio di errore stesso. Ciò significa che se si forniscono diversi messaggi di errore per la stessa feature, tutti quegli errori compariranno.