1MetaCPAN::Client::AuthoUrs(e3r)Contributed Perl DocumentMaettiaoCnPAN::Client::Author(3)
2
3
4

NAME

6       MetaCPAN::Client::Author - An Author data object
7

VERSION

9       version 2.030000
10

SYNOPSIS

12           my $author = $mcpan->author('MICKEY');
13

DESCRIPTION

15       a MetaCPAN author entity object.
16

ATTRIBUTES

18   pauseid
19       The author's pause id, which is a string like "MICKEY" or "XSAWYERX".
20
21   name
22       The author's full name, if they've provided this in their MetaCPAN
23       profile. This may contain Unicode characters.
24
25   ascii_name
26       An ASCII-only version of the author's full name, if they've provided
27       this in their MetaCPAN profile.
28
29   city
30       The author's city, if they've provided this in their MetaCPAN profile.
31
32   region
33       The author's region, if they've provided this in their MetaCPAN
34       profile.
35
36   country
37       The author's country, if they've provided this in their MetaCPAN
38       profile.
39
40   updated
41       An ISO8601 datetime string like "2016-11-19T12:41:46" indicating when
42       the author last updated their MetaCPAN profile. This is always provided
43       in UTC.
44
45   dir
46       The author's CPAN directory, which is something like "id/P/PE/PERLER".
47
48   gravatar_url
49       The author's gravatar.com user URL, if they have one. This URL is
50       generated using PAUSEID@cpan.org.
51
52   user
53       The user's internal MetaCPAN id.
54
55   donation
56       This is an arrayref containing zero or more hashrefs. Each hashref
57       contains two keys, "name" and "id". The known names are currently
58       "paypal", "wishlist", and "flattr". The id will be an appropriate id or
59       URL for the thing in question.
60
61       This may be empty if the author has not provided this information in
62       their MetaCPAN profile.
63
64       For example:
65
66           [
67               { "name" => "paypal",   "id" => "brian.d.foy@gmail.com" },
68               { "name" => "wishlist", "id" => "http://amzn.com/w/4O7IX9ZNQJR" },
69           ],
70
71   email
72       This is an arrayref containing zero or more email addresses that the
73       author has added to their MetaCPAN profile. Note that this does not
74       include the "AUTHOR@cpan.org" email address that all CPAN authors have.
75
76   website
77       This is an arrayref of website URLs provided by the author in their
78       MetaCPAN profile.
79
80   profile
81       This is an arrayref containing zero or more hashrefs. Each hashref
82       contains two keys, "name" and "id". The names are things like "github"
83       or "stackoverflow". The id will be an appropriate id for the site in
84       question.
85
86       For example:
87
88           [
89               { name => "amazon",        id => "B002MRC39U"  },
90               { name => "stackoverflow", id => "brian-d-foy" },
91           ]
92
93       This may be empty if the author has not provided this information in
94       their MetaCPAN profile.
95
96   perlmongers
97       This is an arrayref containing zero or more hashrefs. Each hashref
98       contains two keys, "name" and "url". The names are things like
99       "Minneapolis.pm".
100
101       This may be empty if the author has not provided this information in
102       their MetaCPAN profile.
103
104   links
105       This is a hashref where the keys are a link type, and the values are
106       URLs. The currently known keys are:
107
108       •   cpan_directory
109
110           The author's CPAN directory.
111
112       •   backpan_directory
113
114           The author's BackCPAN directory.
115
116       •   cpantesters_reports
117
118           The author's CPAN Testers Reports page.
119
120       •   cpantesters_matrix
121
122           The author's CPAN Testers matrix page.
123
124       •   cpants
125
126           The author's CPANTS page.
127
128       •   metacpan_explorer
129
130           A link to the MetaCPAN explorer site pre-populated with a request
131           for the author's profile.
132
133   blog
134       This is an arrayref containing zer or more hashrefs. Each hashref
135       contains two keys, "url" and "feed". For example:
136
137           {
138               url  => "http://blogs.perl.org/users/brian_d_foy/",
139               feed => "http://blogs.perl.org/users/brian_d_foy/atom.xml",
140           }
141
142   release_count
143       This is a hashref containing counts for various types of releases. The
144       known keys are:
145
146       •   cpan
147
148           The total number of distribution uplaods the author currently has
149           on CPAN.
150
151       •   latest
152
153           The total number of unique distributions the author currently has
154           on CPAN.
155
156       •   backpan-only
157
158           The number of distribution uploads currently only available via
159           BackPAN.
160
161   extra
162       Returns a hashref. The contents of this are entirely arbitrary and will
163       vary by author.
164

METHODS

166   BUILDARGS
167       Ensures format of the input.
168
169   releases
170           my $releases = $author->releases();
171
172       This method returns a MetaCPAN::Client::ResultSet of
173       MetaCPAN::Client::Release objects. It includes all of the author's
174       releases with the "latest" status.
175
176   metacpan_url
177       Returns a link to the author's page on MetaCPAN.
178

AUTHORS

180       •   Sawyer X <xsawyerx@cpan.org>
181
182       •   Mickey Nasriachi <mickey@cpan.org>
183

185       This software is copyright (c) 2016 by Sawyer X.
186
187       This is free software; you can redistribute it and/or modify it under
188       the same terms as the Perl 5 programming language system itself.
189
190
191
192perl v5.36.0                      2023-01-20       MetaCPAN::Client::Author(3)
Impressum