The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Acme::Marvel::CinematicUniverse::Characters - example of distributing instance data on CPAN

SYNOPSIS

  use Acme::Marvel::CinematicUniverse::Characters;
  
  say for Acme::Marvel::CinematicUniverse::Characters->find('tony');

DESCRIPTION

This module is primarily intended as an example of how to distribute instances of objects on CPAN.

It uses characters from the Marvel Cinematic Universe (Earth-199999) rather than the comic book universe, though power grid data is taken from the Marvel wiki, and mostly based on the comic books. It currently only includes the six core characters from Marvel's The Avengers (2012), also known as Avengers Assemble in the UK and Ireland.

Methods

characters

Returns a list of all known characters. In scalar context, returns the count of characters.

Characters are Acme::Marvel::CinematicUniverse::Character objects.

find($needle)

Given a string or regexp to search for, searches for a character by name, returning all the results as a list. In scalar context, returns the first match, which may or may not be the "best" match.

Strings given as search terms are treated case-insensitively. Regexps are used as-is, so may or may not be case-sensitive.

Characters are Acme::Marvel::CinematicUniverse::Character objects.

instance_modules

Returns a list of modules that have been used to find character data.

load_character($character)

Used by instance modules to load characters.

BUGS

Please report any bugs to http://rt.cpan.org/Dist/Display.html?Queue=Acme-Marvel-CinematicUniverse-Characters.

SEE ALSO

Acme::Marvel::CinematicUniverse::Character, WWW::Marvel.

AUTHOR

Toby Inkster <tobyink@cpan.org>.

COPYRIGHT AND LICENCE

This software is copyright (c) 2020 by Toby Inkster.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

DISCLAIMER OF WARRANTIES

THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.