Paquete :: DeprecationManager Administre las advertencias de deprecación para su distribución
Descargar ahora

Paquete :: DeprecationManager Clasificación y resumen

Paquete :: DeprecationManager Etiquetas

Módulo perl perla advertencias deprecación avisos de obsolescencia gerente de deprecación

Paquete :: DeprecationManager Descripción

Gestionar las advertencias de deprecación para su distribución. Paquete :: deprecationmanager es un módulo de Perl que le permite administrar un conjunto de deprecaciones para uno o más módulos. Cuando importe el paquete :: deprecationmanager, debe proporcionar un conjunto de -depecaciones como hash ref. Las llaves son nombres de "características", y los valores son la versión cuando esa función fue desaprobada. En muchos casos, simplemente puede usar el nombre completamente calificado de una subrutina o método como el nombre de la característica. Esto funciona para los casos en que toda la subrutina está en desuso. Sin embargo, los nombres de las características pueden ser cualquier cadena. Esto es útil si no desea despreciar una subrutina completa, solo un cierto uso. También puede proporcionar una referencia de matriz opcional en el parámetro -ignore. Los valores a ignorar pueden ser nombres de paquetes o expresiones regulares (hechas con QR //). Use esto para ignorar los paquetes en su distribución que puede aparecer en la pila de llamadas cuando se usa una función en desuso. En parte del proceso de importación, el paquete:: DeprecationManager exportará dos subrutinas a su persona que llama. Proporciona un subcontrol () Sub para la persona que llama y una subpecida () Sub.El importante () Sub permite a las personas que llaman a las personas de su clase especificar un parámetro -api_version. Si se suministra esto, entonces las advertencias de deprecación solo se emiten para las deprecaciones para las versiones API anteriores a las especificadas. Debe llamar al subcrobado () Sub en cada subrutina desaprobada. Cuando se llama, emitirá una advertencia usando carp :: Cluck (). El subcrobado () subcubiera se puede llamar de varias maneras. Si no pasa ningún argumento, generará un mensaje de advertencia adecuado. Si pasa un solo argumento, esto se usa como mensaje de advertencia. En general, puede llamarlo con argumentos nombrados. Actualmente, los únicos nombres permitidos son el mensaje y la función. El argumento de la característica debe corresponder al nombre de la característica pasado en el hash -deprecations HASH. Si no especifica explícitamente una característica, la persona que se encuentra en desuso () en desuso () para identificar a su persona que llama, utilizando su nombre de subrutina totalmente calificado. Una depreciación completamente calificada. La advertencia solo se emite una vez para un paquete dado. Este módulo rastrea esto según el nombre de la función y el mensaje de error en sí. Esto significa que si proporciona varios mensajes de error diferentes para la misma función, aparecerán todos esos errores. Paquete de HSYNOPSIS MI :: Clase; Usa el paquete :: deprecationmanager -deprecations => {'my :: clase :: foo' => '0.02', 'My :: Class :: Bar' => '0.05', 'Featur-X' => '0.07' ,}; Sub foo {en desuso ('¡No llames foo!'); ...} Sub Bar {Enfortada (); ...} Sub Baz {My% args = @_; if ($ args {foo}) {en desuso (mensaje => ..., característica => 'característica-x',); }} paquete Otro :: Clase; Usa mi :: clase -api_version => '0.04'; Mi :: clase-> nuevo () -> foo (); # advierte mi clase ::> Nueva () -> Bar (); # no advierte mi :: clase-> nuevo () -> lejos (); # no advierte nuevamente requisitos: · Perl

Paquete :: DeprecationManager Software relacionado