view release on metacpan or  search on metacpan

lib/Acme/CPANAuthors/Nonhuman.pm  view on Meta::CPAN

=end html

The original list of authors was determined via
L<The Faces of CPAN|http://hexten.net/cpan-faces/>.

=for stopwords programmatically

I wrote this module initially as a reaction to a previous L<Acme::CPANAuthors>
distribution that inappropriately highlighted a particular demographic (it has
now since been deleted).  Then, I realized that so much of the content I
wanted to include in this module could be programmatically generated, so I
continued on as an exercise in templating code at build time using raw data in
the C<__DATA__> section.  That support code has since been split off into its
own distribution, L<Dist::Zilla::Plugin::MungeFile::WithDataSection>.

This module has continued to evolve, as rough edges in bits of the toolchain
are polished.  These improvements include:

=for stopwords metacpan

=over 4

=item *

better HTML rendering in L<metacpan|https://metacpan.org>

=item *

proper encoding handling in L<Dist::Zilla> and many of its plugins

=item *

parsing improvements in L<PPI>

=item *

heuristic refinement in kwalitee metrics in L<Module::CPANTS::Analyse>

=item *

additional interfaces added to L<Acme::CPANAuthors>

=back

=head1 METHODS

=head2 authors

Returns the hash of authors in list context, or a hashref in scalar context.

=head2 category

Returns C<'Nonhuman'>.

=head2 avatar_url

=for stopwords gravatar

Returns the gravatar url of the id shown on L<https://metacpan.org>. Note this
is B<not> necessarily the same result as C<< Acme::CPANAuthors->url($id) >>:
this module queries metacpan directly, where a user may have overridden the
gravatar in their profile; whereas L<Acme::CPANAuthors> (via L<Gravatar::URL>)
performs a lookup on the email address registered with PAUSE.

=head1 SEE ALSO

=over 4

=item *

L<Acme::CPANAuthors> - the main class to manipulate this one.

=back

=head1 SUPPORT

It may well be the case that some of the authors listed here are B<not>
actually non-human, in which case this absolutely must be reported immediately
so this module can be corrected! We of the furry and clawed will not stand for
imposters in our midst.

On the other hand, occasionally new brothers and sisters join the Perl family
and are not recognized here -- please let me know so they can be added to the
list.

Bugs may be submitted through L<the RT bug tracker|https://rt.cpan.org/Public/Dist/Display.html?Name=Acme-CPANAuthors-Nonhuman>
(or L<bug-Acme-CPANAuthors-Nonhuman@rt.cpan.org|mailto:bug-Acme-CPANAuthors-Nonhuman@rt.cpan.org>).

I am also usually active on irc, as 'ether' at C<irc.perl.org>.

=head1 AUTHOR

Karen Etheridge <ether@cpan.org>

=head1 CONTRIBUTORS

=for stopwords Graham Knop Carlos Lima Сергей Романов

=over 4

=item *

Graham Knop <haarg@haarg.org>

=item *

Carlos Lima <carlos@cpan.org>

=item *

Сергей Романов <sromanov@cpan.org>

=back

=head1 COPYRIGHT AND LICENCE

This software is copyright (c) 2013 by Karen Etheridge.

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