Pacote :: DeprecationManager.

Gerenciar avisos de deprecação para sua distribuição
Baixe Agora

Pacote :: DeprecationManager. Classificação e resumo

Propaganda

  • Rating:
  • Licença:
  • Perl Artistic License
  • Nome do editor:
  • Dave Rolsky
  • Site do editor:
  • http://search.cpan.org/~drolsky/

Pacote :: DeprecationManager. Tag


Pacote :: DeprecationManager. Descrição

Gerenciar avisos de depreciação para sua distribuição Package :: DeprecationManager é um módulo Perl que permite gerenciar um conjunto de depreciações para um ou mais módulos. Quando você importar pacote :: DeprecationManager, você deve fornecer um conjunto de suas precations como um HASH Ref. As chaves são nomes "recursos" e os valores são a versão quando esse recurso foi depreciado. Em muitos casos, você pode simplesmente usar o nome completo de uma sub-rotina ou método como o nome do recurso. Isso funciona para casos em que toda a sub-rotina é descontinuada. No entanto, os nomes de recursos podem ser qualquer string. Isso é útil se você não quiser depreciar uma sub-rotina inteira, apenas um determinado uso. Você também pode fornecer uma referência de matriz opcional no parâmetro -igne. Os valores a serem ignorados podem ser nomes de pacotes ou expressões regulares (feitas com QR //). Use isso para ignorar pacotes em sua distribuição que pode aparecer na pilha de chamadas quando um recurso obsoleto é usado. Como parte do processo de importação, pacote :: deprecationManager exportará duas sub-rotinas em seu chamador. Ele fornece um suberço de importação () para o chamador e um sub.the Sub.A () Sub.The Import () permite que os chamadores da sua classe especifiquem um parâmetro -api_version. Se isso for fornecido, então avisos de depreciação são emitidos apenas para depreciações para as versões da API mais cedo do que a especificada. Você deve chamar a sub-rotina depreciada () em cada sub-rotina obsoleta. Quando chamado, ele emitirá um aviso usando Carpa :: Cluck (). O subprecado () sub pode ser chamado de várias maneiras. Se você não passar nenhum argumento, ele gerará uma mensagem de aviso apropriada. Se você passar um único argumento, isso é usado como a mensagem de aviso.Finalmente, você pode chamá-lo com argumentos nomeados. Atualmente, os únicos nomes permitidos são mensagens e recursos. O argumento de recurso deve corresponder ao nome do recurso passado no hashPreprecations hash.Se você não especificar explicitamente um recurso, o Subprecado () Sub usa o chamador () para identificar seu chamador, usando seu nome de sub-rotina totalmente qualificado. AVISO é emitido apenas uma vez para um determinado pacote. Este módulo rastreia isso com base no nome do recurso e na própria mensagem de erro. Isso significa que, se você fornecer várias mensagens de erro para o mesmo recurso, todos esses erros aparecerão.Synopsis pacote minha :: Class; Usar pacote :: DeprecationManager -Deprecations => {'My :: Class :: foo' => '0.02', 'My :: Classe :: Bar' => '0.05', '0,07' }; Sub foo {deprecado ('não ligue para foo!'); ...} Sub Bar {Reprovado (); ...} sub baz {my% args = @_; if ($ args {foo}) {deprecado (mensagem => ..., recurso => 'recurso-x',); }} pacote Outro :: Classe; Use o meu :: Classe -api_version => '0.04'; Meu :: Class-> Novo () -> foo (); # adverte o meu :: Class-> Novo () -> Bar (); # não avisa o meu: aula-> novo () -> longe (); # não avisa novamente requisitos: · Perl.


Pacote :: DeprecationManager. Software Relacionado