Pakket :: DeprecationManager

Beheer de afschrijvingswaarschuwingen voor uw distributie
Download nu

Pakket :: DeprecationManager Rangschikking & Samenvatting

Advertentie

  • Rating:
  • Vergunning:
  • Perl Artistic License
  • Naam uitgever:
  • Dave Rolsky
  • Uitgever website:
  • http://search.cpan.org/~drolsky/

Pakket :: DeprecationManager Tags


Pakket :: DeprecationManager Beschrijving

Beheer de afschrijvingswaarschuwingen voor uw distributie Pakket :: DeprecationManager is een PERL-module waarmee u een reeks afschrijvingen voor een of meer modules kunt beheren. Wanneer u Pakket :: DeprecationManager importeert, moet u een set van -deprecaties opleveren als HASH Ref. De toetsen zijn 'Feature'-namen en de waarden zijn de versie wanneer die functie is afgeschreven. In veel gevallen kunt u eenvoudig de volledig gekwalificeerde naam van een subroutine of methode gebruiken als de functienaam. Dit werkt voor gevallen waarin de hele subroutine wordt verouderd. De functienamen kunnen echter elke reeks zijn. Dit is handig als u geen volledige subroutine wilt afwijzen, slechts een bepaald gebruik. U kunt ook een optionele array-referentie opgeven in de parameter-Vignore. De te negeren waarden kunnen pakketnamen of reguliere uitdrukkingen zijn (gemaakt met QR //). Gebruik dit om pakketten in uw distributie te negeren die op de oproepstapel kan verschijnen wanneer een verouderde functie wordt gebruikt. Een deel van het importproces, pakket :: DeprecationManager zal twee subroutines exporteren in zijn beller. Het biedt een import () sub voor de beller en een verouderde () sub.De import () sub stelt bellers van uw klasse toe om een parameter -api_version te specificeren. Als dit wordt geleverd, worden de afschrijvingswaarschuwingen alleen uitgegeven voor de afschrijvingen voor API-versies die eerder dan degene is opgegeven. U moet de verouderde () sub in elke verouderde subroutine bellen. Wanneer het wordt gebeld, zal het een waarschuwing geven met karper :: Cluk (). De verouderde () sub kan op verschillende manieren worden opgeroepen. Als u geen argumenten passeert, genereert deze een passend waarschuwingsbericht. Als u een enkel argument passeert, wordt dit gebruikt als het waarschuwingsbericht. Finaal kunt u het bellen met de naam argumenten. Momenteel zijn de enige toegestane namen bericht en functie. Het featureringsargument moet overeenkomen met de functienaam van de functies in de -deprecaties hash.Als u niet expliciet een functie opgeven, gebruikt de verouderde () subbruiklepel () om de beller te identificeren, met behulp van de volledig gekwalificeerde subroutine-naam. Waarschuwing wordt slechts één keer uitgegeven voor een bepaald pakket. Deze module volgt dit op basis van zowel de functienaam als het foutbericht zelf. Dit betekent dat als u verschillende foutenmeldingen voor verschillende functie verstrekken, alle van die fouten zullen verschijnen. Synopsis-pakket Mijn :: Klasse; Gebruik Package :: DeprecationManager -Deprecations => {'My :: Class :: FOO' => '0.02', 'My :: Class :: Bar' => '0.05', 'Feature-X' => '0.07' ,}; sub foo {verouderd ('noem geen foo!'); ...} Substaaf {Afwezig (); ...} sub baz {mijn% args = @_; if ($ args {foo}) {afweiten (bericht => ..., functie => 'feature-x',); }} Pakket andere :: Klasse; Gebruik mijn :: class -api_version => '0,04'; Mijn :: Klasse-> Nieuw () -> FOO (); # Waarschuwt mijn :: Klasse-> Nieuw () -> Bar (); # Waarschuwt mijn :: Klasse-> Nieuw () -> Ver (); # Waarschuwt niet meer vereisten: · Perl


Pakket :: DeprecationManager Gerelateerde software