line |
stmt |
bran |
cond |
sub |
pod |
time |
code |
1
|
|
|
|
|
|
|
package JIRA::REST::Class::Issue; |
2
|
4
|
|
|
4
|
|
2197
|
use parent qw( JIRA::REST::Class::Abstract ); |
|
4
|
|
|
|
|
7
|
|
|
4
|
|
|
|
|
20
|
|
3
|
4
|
|
|
4
|
|
332
|
use strict; |
|
4
|
|
|
|
|
8
|
|
|
4
|
|
|
|
|
70
|
|
4
|
4
|
|
|
4
|
|
16
|
use warnings; |
|
4
|
|
|
|
|
8
|
|
|
4
|
|
|
|
|
74
|
|
5
|
4
|
|
|
4
|
|
51
|
use 5.010; |
|
4
|
|
|
|
|
10
|
|
6
|
|
|
|
|
|
|
|
7
|
|
|
|
|
|
|
our $VERSION = '0.11'; |
8
|
|
|
|
|
|
|
our $SOURCE = 'CPAN'; |
9
|
|
|
|
|
|
|
## $SOURCE = 'GitHub'; # COMMENT |
10
|
|
|
|
|
|
|
# the line above will be commented out by Dist::Zilla |
11
|
|
|
|
|
|
|
|
12
|
|
|
|
|
|
|
# ABSTRACT: A helper class for L<JIRA::REST::Class|JIRA::REST::Class> that represents an |
13
|
|
|
|
|
|
|
# individual JIRA issue as an object. |
14
|
|
|
|
|
|
|
|
15
|
4
|
|
|
4
|
|
26
|
use Carp; |
|
4
|
|
|
|
|
12
|
|
|
4
|
|
|
|
|
270
|
|
16
|
4
|
|
|
4
|
|
21
|
use Readonly 2.04; |
|
4
|
|
|
|
|
49
|
|
|
4
|
|
|
|
|
162
|
|
17
|
4
|
|
|
4
|
|
28
|
use Scalar::Util qw( weaken ); |
|
4
|
|
|
|
|
8
|
|
|
4
|
|
|
|
|
1003
|
|
18
|
|
|
|
|
|
|
|
19
|
|
|
|
|
|
|
# creating a bunch of read-only accessors |
20
|
|
|
|
|
|
|
|
21
|
|
|
|
|
|
|
# contextual returns lists or arrayrefs, depending on context |
22
|
|
|
|
|
|
|
Readonly my @CONTEXTUAL => qw( components versions ); |
23
|
|
|
|
|
|
|
|
24
|
|
|
|
|
|
|
__PACKAGE__->mk_contextual_ro_accessors( @CONTEXTUAL ); |
25
|
|
|
|
|
|
|
|
26
|
|
|
|
|
|
|
# fields that will be turned into JIRA::REST::Class::User objects |
27
|
|
|
|
|
|
|
Readonly my @USERS => qw( assignee creator reporter ); |
28
|
|
|
|
|
|
|
|
29
|
|
|
|
|
|
|
# fields that will be turned into DateTime objects |
30
|
|
|
|
|
|
|
Readonly my @DATES => qw( created duedate lastViewed resolutiondate updated ); |
31
|
|
|
|
|
|
|
|
32
|
|
|
|
|
|
|
# other fields we're objectifying and storing at the top level of the hash |
33
|
|
|
|
|
|
|
Readonly my @TOP_LEVEL => qw( project issuetype status url ); |
34
|
|
|
|
|
|
|
|
35
|
|
|
|
|
|
|
__PACKAGE__->mk_ro_accessors( @TOP_LEVEL, @USERS, @DATES ); |
36
|
|
|
|
|
|
|
|
37
|
|
|
|
|
|
|
# fields that are under $self->{data} |
38
|
|
|
|
|
|
|
Readonly my @DATA => qw( expand fields id key self ); |
39
|
|
|
|
|
|
|
__PACKAGE__->mk_data_ro_accessors( @DATA ); |
40
|
|
|
|
|
|
|
|
41
|
|
|
|
|
|
|
# fields that are under $self->{data}->{fields} |
42
|
|
|
|
|
|
|
Readonly my @FIELDS => qw( aggregateprogress aggregatetimeestimate |
43
|
|
|
|
|
|
|
aggregatetimeoriginalestimate aggregatetimespent |
44
|
|
|
|
|
|
|
description environment fixVersions issuelinks |
45
|
|
|
|
|
|
|
labels priority progress resolution summary |
46
|
|
|
|
|
|
|
timeestimate timeoriginalestimate timespent |
47
|
|
|
|
|
|
|
votes watches workratio ); |
48
|
|
|
|
|
|
|
|
49
|
|
|
|
|
|
|
__PACKAGE__->mk_field_ro_accessors( @FIELDS ); |
50
|
|
|
|
|
|
|
|
51
|
|
|
|
|
|
|
#pod =head1 DESCRIPTION |
52
|
|
|
|
|
|
|
#pod |
53
|
|
|
|
|
|
|
#pod This object represents a JIRA issue as an object. It is overloaded so it |
54
|
|
|
|
|
|
|
#pod returns the C<key> of the issue when stringified, and the C<id> of the issue |
55
|
|
|
|
|
|
|
#pod when it is used in a numeric context. If two of these objects are compared |
56
|
|
|
|
|
|
|
#pod I<as strings>, the C<key> of the issues will be used for the comparison, |
57
|
|
|
|
|
|
|
#pod while numeric comparison will compare the C<id>s of the issues. |
58
|
|
|
|
|
|
|
#pod |
59
|
|
|
|
|
|
|
#pod =cut |
60
|
|
|
|
|
|
|
|
61
|
|
|
|
|
|
|
#<<< |
62
|
|
|
|
|
|
|
use overload |
63
|
0
|
|
|
0
|
|
|
'""' => sub { shift->key }, |
64
|
0
|
|
|
0
|
|
|
'0+' => sub { shift->id }, |
65
|
|
|
|
|
|
|
'<=>' => sub { |
66
|
0
|
|
|
0
|
|
|
my( $A, $B ) = @_; |
67
|
0
|
0
|
|
|
|
|
my $AA = ref $A ? $A->id : $A; |
68
|
0
|
0
|
|
|
|
|
my $BB = ref $B ? $B->id : $B; |
69
|
0
|
|
|
|
|
|
$AA <=> $BB |
70
|
|
|
|
|
|
|
}, |
71
|
|
|
|
|
|
|
'cmp' => sub { |
72
|
0
|
|
|
0
|
|
|
my( $A, $B ) = @_; |
73
|
0
|
0
|
|
|
|
|
my $AA = ref $A ? $A->key : $A; |
74
|
0
|
0
|
|
|
|
|
my $BB = ref $B ? $B->key : $B; |
75
|
0
|
|
|
|
|
|
$AA cmp $BB |
76
|
4
|
|
|
4
|
|
27
|
}; |
|
4
|
|
|
|
|
8
|
|
|
4
|
|
|
|
|
41
|
|
77
|
|
|
|
|
|
|
#>>> |
78
|
|
|
|
|
|
|
|
79
|
|
|
|
|
|
|
sub init { |
80
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
81
|
0
|
|
|
|
|
|
$self->SUPER::init( @_ ); |
82
|
|
|
|
|
|
|
|
83
|
0
|
|
|
|
|
|
my $jira = $self->jira; |
84
|
0
|
|
|
|
|
|
$self->{url} = $jira->strip_protocol_and_host( $self->self ); |
85
|
|
|
|
|
|
|
|
86
|
|
|
|
|
|
|
# make user objects |
87
|
0
|
|
|
|
|
|
foreach my $field ( @USERS ) { |
88
|
0
|
|
|
|
|
|
$self->populate_scalar_field( $field, 'user', $field ); |
89
|
|
|
|
|
|
|
} |
90
|
|
|
|
|
|
|
|
91
|
|
|
|
|
|
|
# make date objects |
92
|
0
|
|
|
|
|
|
foreach my $field ( @DATES ) { |
93
|
0
|
|
|
|
|
|
$self->{$field} = $self->make_date( $self->fields->{$field} ); |
94
|
|
|
|
|
|
|
} |
95
|
|
|
|
|
|
|
|
96
|
0
|
|
|
|
|
|
$self->populate_list_field( 'components', 'projectcomp', 'components' ); |
97
|
0
|
|
|
|
|
|
$self->populate_list_field( 'versions', 'projectvers', 'versions' ); |
98
|
0
|
|
|
|
|
|
$self->populate_scalar_field( 'project', 'project', 'project' ); |
99
|
0
|
|
|
|
|
|
$self->populate_scalar_field( 'issuetype', 'issuetype', 'issuetype' ); |
100
|
0
|
|
|
|
|
|
$self->populate_scalar_field( 'status', 'status', 'status' ); |
101
|
0
|
|
|
|
|
|
$self->populate_scalar_field( # |
102
|
|
|
|
|
|
|
'timetracking', 'timetracking', 'timetracking', |
103
|
|
|
|
|
|
|
); |
104
|
|
|
|
|
|
|
|
105
|
0
|
0
|
|
|
|
|
unless ( defined &is_bug ) { |
106
|
|
|
|
|
|
|
|
107
|
|
|
|
|
|
|
# if we haven't defined booleans to determine whether or not this |
108
|
|
|
|
|
|
|
# issue is a particular type, define those methods now |
109
|
0
|
|
|
|
|
|
foreach my $type ( $jira->issue_types ) { |
110
|
0
|
|
|
|
|
|
( my $subname = lc 'is_' . $type->name ) =~ s/\s+|\-/_/xmsg; |
111
|
|
|
|
|
|
|
$self->make_subroutine( |
112
|
|
|
|
|
|
|
$subname, |
113
|
|
|
|
|
|
|
sub { |
114
|
0
|
|
|
0
|
|
|
shift->fields->{issuetype}->{id} == $type->id; |
115
|
|
|
|
|
|
|
} |
116
|
0
|
|
|
|
|
|
); |
117
|
|
|
|
|
|
|
} |
118
|
|
|
|
|
|
|
} |
119
|
0
|
|
|
|
|
|
return; |
120
|
|
|
|
|
|
|
} |
121
|
|
|
|
|
|
|
|
122
|
0
|
|
|
0
|
1
|
|
sub component_count { return scalar @{ shift->{components} } } |
|
0
|
|
|
|
|
|
|
123
|
|
|
|
|
|
|
|
124
|
|
|
|
|
|
|
# |
125
|
|
|
|
|
|
|
# rather than just use the minimal information in the issue's |
126
|
|
|
|
|
|
|
# parent hash, fetch the parent issue fully when someone first |
127
|
|
|
|
|
|
|
# uses the parent_accessor |
128
|
|
|
|
|
|
|
# |
129
|
|
|
|
|
|
|
|
130
|
0
|
|
|
0
|
1
|
|
sub has_parent { return exists shift->fields->{parent} } |
131
|
|
|
|
|
|
|
|
132
|
|
|
|
|
|
|
__PACKAGE__->mk_lazy_ro_accessor( |
133
|
|
|
|
|
|
|
'parent', |
134
|
|
|
|
|
|
|
sub { |
135
|
|
|
|
|
|
|
my $self = shift; |
136
|
|
|
|
|
|
|
return unless $self->has_parent; # some issues have no parent |
137
|
|
|
|
|
|
|
|
138
|
|
|
|
|
|
|
my $parent = $self->fields->{parent}->{self}; |
139
|
|
|
|
|
|
|
my $url = $self->jira->strip_protocol_and_host( $parent ); |
140
|
|
|
|
|
|
|
return $self->make_object( |
141
|
|
|
|
|
|
|
'issue', |
142
|
|
|
|
|
|
|
{ |
143
|
|
|
|
|
|
|
data => $self->jira->get( $url ) |
144
|
|
|
|
|
|
|
} |
145
|
|
|
|
|
|
|
); |
146
|
|
|
|
|
|
|
} |
147
|
|
|
|
|
|
|
); |
148
|
|
|
|
|
|
|
|
149
|
|
|
|
|
|
|
__PACKAGE__->mk_lazy_ro_accessor( |
150
|
|
|
|
|
|
|
'changelog', |
151
|
|
|
|
|
|
|
sub { |
152
|
|
|
|
|
|
|
my $self = shift; |
153
|
|
|
|
|
|
|
return $self->make_object( 'changelog' ); |
154
|
|
|
|
|
|
|
} |
155
|
|
|
|
|
|
|
); |
156
|
|
|
|
|
|
|
|
157
|
|
|
|
|
|
|
__PACKAGE__->mk_lazy_ro_accessor( |
158
|
|
|
|
|
|
|
'comments', |
159
|
|
|
|
|
|
|
sub { |
160
|
|
|
|
|
|
|
my $self = shift; |
161
|
|
|
|
|
|
|
my $data = $self->get( '/comment' ); |
162
|
|
|
|
|
|
|
return $self->{comments} = [ # |
163
|
|
|
|
|
|
|
map { # |
164
|
|
|
|
|
|
|
$self->make_object( 'comment', { data => $_ } ); |
165
|
|
|
|
|
|
|
} @{ $data->{comments} } |
166
|
|
|
|
|
|
|
]; |
167
|
|
|
|
|
|
|
} |
168
|
|
|
|
|
|
|
); |
169
|
|
|
|
|
|
|
|
170
|
|
|
|
|
|
|
__PACKAGE__->mk_lazy_ro_accessor( |
171
|
|
|
|
|
|
|
'worklog', |
172
|
|
|
|
|
|
|
sub { |
173
|
|
|
|
|
|
|
my $self = shift; |
174
|
|
|
|
|
|
|
return $self->make_object( 'worklog' ); |
175
|
|
|
|
|
|
|
} |
176
|
|
|
|
|
|
|
); |
177
|
|
|
|
|
|
|
|
178
|
|
|
|
|
|
|
__PACKAGE__->mk_lazy_ro_accessor( |
179
|
|
|
|
|
|
|
'transitions', |
180
|
|
|
|
|
|
|
sub { |
181
|
|
|
|
|
|
|
my $self = shift; |
182
|
|
|
|
|
|
|
return $self->make_object( 'transitions' ); |
183
|
|
|
|
|
|
|
} |
184
|
|
|
|
|
|
|
); |
185
|
|
|
|
|
|
|
|
186
|
|
|
|
|
|
|
__PACKAGE__->mk_lazy_ro_accessor( |
187
|
|
|
|
|
|
|
'timetracking', |
188
|
|
|
|
|
|
|
sub { |
189
|
|
|
|
|
|
|
my $self = shift; |
190
|
|
|
|
|
|
|
return $self->make_object( 'timetracking' ); |
191
|
|
|
|
|
|
|
} |
192
|
|
|
|
|
|
|
); |
193
|
|
|
|
|
|
|
|
194
|
|
|
|
|
|
|
#pod =internal_method B<make_object> |
195
|
|
|
|
|
|
|
#pod |
196
|
|
|
|
|
|
|
#pod A pass-through method that calls |
197
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::Factory::make_object()|JIRA::REST::Class::Factory/make_object>, |
198
|
|
|
|
|
|
|
#pod but adds a weakened link to this issue in the object as well. |
199
|
|
|
|
|
|
|
#pod |
200
|
|
|
|
|
|
|
#pod =cut |
201
|
|
|
|
|
|
|
|
202
|
|
|
|
|
|
|
sub make_object { |
203
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
204
|
0
|
|
|
|
|
|
my $type = shift; |
205
|
0
|
|
0
|
|
|
|
my $args = shift || {}; |
206
|
|
|
|
|
|
|
|
207
|
|
|
|
|
|
|
# if we weren't passed an issue, link to ourselves |
208
|
0
|
0
|
|
|
|
|
unless ( exists $args->{issue} ) { |
209
|
0
|
|
|
|
|
|
$args->{issue} = $self; |
210
|
|
|
|
|
|
|
} |
211
|
|
|
|
|
|
|
|
212
|
0
|
|
|
|
|
|
my $class = $self->factory->get_factory_class( $type ); |
213
|
0
|
|
|
|
|
|
my $obj = $class->new( $args ); |
214
|
|
|
|
|
|
|
|
215
|
0
|
0
|
|
|
|
|
if ( exists $obj->{issue} ) { |
216
|
0
|
|
|
|
|
|
weaken $obj->{issue}; # make the link to ourselves weak |
217
|
|
|
|
|
|
|
} |
218
|
|
|
|
|
|
|
|
219
|
0
|
|
|
|
|
|
$obj->init( $self->factory ); # NOW we call init |
220
|
|
|
|
|
|
|
|
221
|
0
|
|
|
|
|
|
return $obj; |
222
|
|
|
|
|
|
|
} |
223
|
|
|
|
|
|
|
|
224
|
|
|
|
|
|
|
########################################################################### |
225
|
|
|
|
|
|
|
|
226
|
|
|
|
|
|
|
#pod =method B<add_attachments> |
227
|
|
|
|
|
|
|
#pod |
228
|
|
|
|
|
|
|
#pod Accepts a list of filenames to be added to the issue as attachments. |
229
|
|
|
|
|
|
|
#pod |
230
|
|
|
|
|
|
|
#pod =cut |
231
|
|
|
|
|
|
|
|
232
|
|
|
|
|
|
|
sub add_attachments { |
233
|
0
|
|
|
0
|
1
|
|
my ( $self, @args ) = @_; |
234
|
|
|
|
|
|
|
|
235
|
0
|
|
|
|
|
|
foreach my $file ( @args ) { |
236
|
0
|
0
|
|
|
|
|
croak "unable to find attachment $file" |
237
|
|
|
|
|
|
|
unless -f $file; |
238
|
|
|
|
|
|
|
|
239
|
0
|
|
|
|
|
|
$self->JIRA_REST->attach_files( $self->key, $file ); |
240
|
|
|
|
|
|
|
} |
241
|
0
|
|
|
|
|
|
return; |
242
|
|
|
|
|
|
|
} |
243
|
|
|
|
|
|
|
|
244
|
|
|
|
|
|
|
#pod =method B<add_attachment> |
245
|
|
|
|
|
|
|
#pod |
246
|
|
|
|
|
|
|
#pod Accepts a single filename to be added to the issue as an attachment. |
247
|
|
|
|
|
|
|
#pod |
248
|
|
|
|
|
|
|
#pod =cut |
249
|
|
|
|
|
|
|
|
250
|
|
|
|
|
|
|
sub add_attachment { |
251
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
252
|
0
|
|
|
|
|
|
my $file = shift; |
253
|
|
|
|
|
|
|
|
254
|
0
|
0
|
|
|
|
|
croak "unable to find attachment $file" |
255
|
|
|
|
|
|
|
unless -f $file; |
256
|
|
|
|
|
|
|
|
257
|
0
|
|
|
|
|
|
return $self->JIRA_REST->attach_files( $self->key, $file ); |
258
|
|
|
|
|
|
|
} |
259
|
|
|
|
|
|
|
|
260
|
|
|
|
|
|
|
#pod =method B<add_data_attachment> |
261
|
|
|
|
|
|
|
#pod |
262
|
|
|
|
|
|
|
#pod Accepts a fake filename and a scalar representing the contents of a file and |
263
|
|
|
|
|
|
|
#pod adds it to the issue as an attachment. |
264
|
|
|
|
|
|
|
#pod |
265
|
|
|
|
|
|
|
#pod =cut |
266
|
|
|
|
|
|
|
|
267
|
|
|
|
|
|
|
sub add_data_attachment { |
268
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
269
|
0
|
|
|
|
|
|
my $name = shift; |
270
|
0
|
|
|
|
|
|
my $data = shift; |
271
|
0
|
|
|
|
|
|
my $url = q{/} . join q{/}, 'issue', $self->key, 'attachments'; |
272
|
|
|
|
|
|
|
|
273
|
0
|
|
|
|
|
|
return $self->jira->data_upload( |
274
|
|
|
|
|
|
|
{ |
275
|
|
|
|
|
|
|
url => $url, |
276
|
|
|
|
|
|
|
name => $name, |
277
|
|
|
|
|
|
|
data => $data |
278
|
|
|
|
|
|
|
} |
279
|
|
|
|
|
|
|
); |
280
|
|
|
|
|
|
|
} |
281
|
|
|
|
|
|
|
|
282
|
|
|
|
|
|
|
#pod =method B<add_comment> |
283
|
|
|
|
|
|
|
#pod |
284
|
|
|
|
|
|
|
#pod Adds whatever is passed in as a comment on the issue. |
285
|
|
|
|
|
|
|
#pod |
286
|
|
|
|
|
|
|
#pod =cut |
287
|
|
|
|
|
|
|
|
288
|
|
|
|
|
|
|
sub add_comment { |
289
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
290
|
0
|
|
|
|
|
|
my $text = shift; |
291
|
0
|
|
|
|
|
|
return $self->post( '/comment', { body => $text } ); |
292
|
|
|
|
|
|
|
} |
293
|
|
|
|
|
|
|
|
294
|
|
|
|
|
|
|
#pod =method B<add_label> |
295
|
|
|
|
|
|
|
#pod |
296
|
|
|
|
|
|
|
#pod Adds whatever is passed in as a label for the issue. |
297
|
|
|
|
|
|
|
#pod |
298
|
|
|
|
|
|
|
#pod =cut |
299
|
|
|
|
|
|
|
|
300
|
|
|
|
|
|
|
sub add_label { |
301
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
302
|
0
|
|
|
|
|
|
my $label = shift; |
303
|
0
|
|
|
|
|
|
return $self->update( labels => [ { add => $label } ] ); |
304
|
|
|
|
|
|
|
} |
305
|
|
|
|
|
|
|
|
306
|
|
|
|
|
|
|
#pod =method B<remove_label> |
307
|
|
|
|
|
|
|
#pod |
308
|
|
|
|
|
|
|
#pod Removes whatever is passed in from the labels for the issue. |
309
|
|
|
|
|
|
|
#pod |
310
|
|
|
|
|
|
|
#pod =cut |
311
|
|
|
|
|
|
|
|
312
|
|
|
|
|
|
|
sub remove_label { |
313
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
314
|
0
|
|
|
|
|
|
my $label = shift; |
315
|
0
|
|
|
|
|
|
return $self->update( labels => [ { remove => $label } ] ); |
316
|
|
|
|
|
|
|
} |
317
|
|
|
|
|
|
|
|
318
|
|
|
|
|
|
|
#pod =method B<has_label> |
319
|
|
|
|
|
|
|
#pod |
320
|
|
|
|
|
|
|
#pod Returns true if the issue has the specified label. |
321
|
|
|
|
|
|
|
#pod |
322
|
|
|
|
|
|
|
#pod =cut |
323
|
|
|
|
|
|
|
|
324
|
|
|
|
|
|
|
sub has_label { |
325
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
326
|
0
|
|
|
|
|
|
my $label = shift; |
327
|
0
|
|
|
|
|
|
foreach my $has ( $self->labels ) { |
328
|
0
|
0
|
|
|
|
|
return 1 if $label eq $has; |
329
|
|
|
|
|
|
|
} |
330
|
0
|
|
|
|
|
|
return 0; |
331
|
|
|
|
|
|
|
} |
332
|
|
|
|
|
|
|
|
333
|
|
|
|
|
|
|
#pod =method B<add_component> |
334
|
|
|
|
|
|
|
#pod |
335
|
|
|
|
|
|
|
#pod Adds whatever is passed in as a component for the issue. |
336
|
|
|
|
|
|
|
#pod |
337
|
|
|
|
|
|
|
#pod =cut |
338
|
|
|
|
|
|
|
|
339
|
|
|
|
|
|
|
sub add_component { |
340
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
341
|
0
|
|
|
|
|
|
my $comp = shift; |
342
|
0
|
|
|
|
|
|
return $self->update( components => [ { add => { name => $comp } } ] ); |
343
|
|
|
|
|
|
|
} |
344
|
|
|
|
|
|
|
|
345
|
|
|
|
|
|
|
#pod =method B<remove_component> |
346
|
|
|
|
|
|
|
#pod |
347
|
|
|
|
|
|
|
#pod Removes whatever is passed in from the components for the issue. |
348
|
|
|
|
|
|
|
#pod |
349
|
|
|
|
|
|
|
#pod =cut |
350
|
|
|
|
|
|
|
|
351
|
|
|
|
|
|
|
sub remove_component { |
352
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
353
|
0
|
|
|
|
|
|
my $comp = shift; |
354
|
0
|
|
|
|
|
|
return $self->update( components => [ { remove => { name => $comp } } ] ); |
355
|
|
|
|
|
|
|
} |
356
|
|
|
|
|
|
|
|
357
|
|
|
|
|
|
|
#pod =method B<set_assignee> |
358
|
|
|
|
|
|
|
#pod |
359
|
|
|
|
|
|
|
#pod Sets the assignee for the issue to be the user passed in. Can either be a |
360
|
|
|
|
|
|
|
#pod string representing the name or a |
361
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::User|JIRA::REST::Class::User> object. |
362
|
|
|
|
|
|
|
#pod |
363
|
|
|
|
|
|
|
#pod =cut |
364
|
|
|
|
|
|
|
|
365
|
|
|
|
|
|
|
sub set_assignee { |
366
|
0
|
|
|
0
|
1
|
|
my ( $self, @args ) = @_; |
367
|
0
|
|
|
|
|
|
my $name = $self->name_for_user( @args ); |
368
|
0
|
|
|
|
|
|
return $self->put_field( assignee => { name => $name } ); |
369
|
|
|
|
|
|
|
} |
370
|
|
|
|
|
|
|
|
371
|
|
|
|
|
|
|
#pod =method B<set_reporter> |
372
|
|
|
|
|
|
|
#pod |
373
|
|
|
|
|
|
|
#pod Sets the reporter for the issue to be the user passed in. Can either be a |
374
|
|
|
|
|
|
|
#pod string representing the name or a |
375
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::User|JIRA::REST::Class::User> object. |
376
|
|
|
|
|
|
|
#pod |
377
|
|
|
|
|
|
|
#pod =cut |
378
|
|
|
|
|
|
|
|
379
|
|
|
|
|
|
|
sub set_reporter { |
380
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
381
|
0
|
|
|
|
|
|
my $name = $self->name_for_user( shift ); |
382
|
0
|
|
|
|
|
|
return $self->put_field( reporter => { name => $name } ); |
383
|
|
|
|
|
|
|
} |
384
|
|
|
|
|
|
|
|
385
|
|
|
|
|
|
|
#pod =method B<add_issue_link> |
386
|
|
|
|
|
|
|
#pod |
387
|
|
|
|
|
|
|
#pod Adds a link from this issue to another one. Accepts the link type (either a |
388
|
|
|
|
|
|
|
#pod string representing the name or a |
389
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::Issue::LinkType|JIRA::REST::Class::Issue::LinkType>), |
390
|
|
|
|
|
|
|
#pod the issue to be linked to, and (optionally) the direction of the link |
391
|
|
|
|
|
|
|
#pod (inward/outward). If the direction cannot be determined from the name of |
392
|
|
|
|
|
|
|
#pod the link type, the default direction is 'inward'; |
393
|
|
|
|
|
|
|
#pod |
394
|
|
|
|
|
|
|
#pod =cut |
395
|
|
|
|
|
|
|
|
396
|
|
|
|
|
|
|
sub add_issue_link { |
397
|
0
|
|
|
0
|
1
|
|
my ( $self, $type, $key, $dir ) = @_; |
398
|
0
|
|
|
|
|
|
$key = $self->key_for_issue( $key ); |
399
|
0
|
|
|
|
|
|
( $type, $dir ) = $self->find_link_name_and_direction( $type, $dir ); |
400
|
|
|
|
|
|
|
|
401
|
0
|
|
|
|
|
|
my $links = [ |
402
|
|
|
|
|
|
|
{ |
403
|
|
|
|
|
|
|
add => { |
404
|
|
|
|
|
|
|
type => { name => $type }, |
405
|
|
|
|
|
|
|
$dir . 'Issue' => { key => $key }, |
406
|
|
|
|
|
|
|
}, |
407
|
|
|
|
|
|
|
} |
408
|
|
|
|
|
|
|
]; |
409
|
0
|
|
|
|
|
|
return $self->update( issuelinks => $links ); |
410
|
|
|
|
|
|
|
} |
411
|
|
|
|
|
|
|
|
412
|
|
|
|
|
|
|
#pod =method B<add_subtask> |
413
|
|
|
|
|
|
|
#pod |
414
|
|
|
|
|
|
|
#pod Adds a subtask to the current issue. Accepts a hashref with named parameters |
415
|
|
|
|
|
|
|
#pod C<summary> and C<description>. If the parameter C<issuetype> is specified, |
416
|
|
|
|
|
|
|
#pod then a subtask of the specified type is created. If no issuetype is |
417
|
|
|
|
|
|
|
#pod specified, then the project is queried for valid subtask types, and, if there |
418
|
|
|
|
|
|
|
#pod is only one, that type is used. If the project has more than one valid |
419
|
|
|
|
|
|
|
#pod subtask type, an issuetype B<MUST> be specified. |
420
|
|
|
|
|
|
|
#pod |
421
|
|
|
|
|
|
|
#pod The remaining named parameters are passed to the create issue call as fields. |
422
|
|
|
|
|
|
|
#pod |
423
|
|
|
|
|
|
|
#pod =cut |
424
|
|
|
|
|
|
|
|
425
|
|
|
|
|
|
|
sub add_subtask { |
426
|
0
|
|
|
0
|
1
|
|
my ( $self, @args ) = @_; |
427
|
|
|
|
|
|
|
|
428
|
0
|
|
|
|
|
|
my $fields; |
429
|
0
|
0
|
0
|
|
|
|
if ( @args == 1 && ref $args[0] && ref $args[0] eq 'HASH' ) { |
|
|
|
0
|
|
|
|
|
430
|
0
|
|
|
|
|
|
$fields = $args[0]; |
431
|
|
|
|
|
|
|
} |
432
|
|
|
|
|
|
|
else { ## backward compatibility |
433
|
0
|
|
0
|
|
|
|
$fields = $args[2] // {}; |
434
|
|
|
|
|
|
|
|
435
|
0
|
|
0
|
|
|
|
$fields->{summary} //= shift @args; |
436
|
0
|
|
0
|
|
|
|
$fields->{description} //= shift @args; |
437
|
|
|
|
|
|
|
} |
438
|
|
|
|
|
|
|
|
439
|
0
|
|
|
|
|
|
my $project = $self->_get_subtask_project( $fields ); |
440
|
0
|
|
|
|
|
|
my $parent = $self->_get_subtask_parent( $fields ); |
441
|
0
|
|
|
|
|
|
my $issuetype = $self->_get_subtask_issue_type( $project, $fields ); |
442
|
|
|
|
|
|
|
|
443
|
0
|
|
|
|
|
|
my $data = { |
444
|
|
|
|
|
|
|
fields => { |
445
|
|
|
|
|
|
|
project => { key => $project->key }, |
446
|
|
|
|
|
|
|
parent => { key => $parent->key }, |
447
|
|
|
|
|
|
|
issuetype => { id => $issuetype->id }, |
448
|
|
|
|
|
|
|
} |
449
|
|
|
|
|
|
|
}; |
450
|
|
|
|
|
|
|
|
451
|
0
|
0
|
|
|
|
|
if ( $fields ) { |
452
|
0
|
|
|
|
|
|
foreach my $field ( keys %$fields ) { |
453
|
|
|
|
|
|
|
next |
454
|
0
|
0
|
0
|
|
|
|
if $field eq 'project' |
|
|
|
0
|
|
|
|
|
455
|
|
|
|
|
|
|
|| $field eq 'parent' |
456
|
|
|
|
|
|
|
|| $field eq 'issuetype'; |
457
|
0
|
|
|
|
|
|
$data->{fields}->{$field} = $fields->{$field}; |
458
|
|
|
|
|
|
|
} |
459
|
|
|
|
|
|
|
} |
460
|
|
|
|
|
|
|
|
461
|
0
|
|
|
|
|
|
my $result = $self->jira->post( '/issue', $data ); |
462
|
0
|
|
|
|
|
|
my $url = '/issue/' . $result->{id}; |
463
|
|
|
|
|
|
|
|
464
|
0
|
|
|
|
|
|
return $self->factory->make_object( |
465
|
|
|
|
|
|
|
'issue', |
466
|
|
|
|
|
|
|
{ |
467
|
|
|
|
|
|
|
data => $self->jira->get( $url ) |
468
|
|
|
|
|
|
|
} |
469
|
|
|
|
|
|
|
); |
470
|
|
|
|
|
|
|
} |
471
|
|
|
|
|
|
|
|
472
|
|
|
|
|
|
|
sub _get_subtask_project { |
473
|
0
|
|
|
0
|
|
|
my ( $self, $fields ) = @_; |
474
|
|
|
|
|
|
|
|
475
|
|
|
|
|
|
|
return $self->project |
476
|
0
|
0
|
0
|
|
|
|
unless exists $fields->{project} && defined $fields->{project}; |
477
|
|
|
|
|
|
|
|
478
|
0
|
|
|
|
|
|
my $proj = $fields->{project}; |
479
|
|
|
|
|
|
|
|
480
|
0
|
0
|
|
|
|
|
if ( $self->obj_isa( $proj, 'project' ) ) { |
481
|
|
|
|
|
|
|
|
482
|
|
|
|
|
|
|
# we were passed an issue type object |
483
|
0
|
|
|
|
|
|
return $proj; |
484
|
|
|
|
|
|
|
} |
485
|
|
|
|
|
|
|
|
486
|
|
|
|
|
|
|
my ( $project ) = grep { ## |
487
|
0
|
0
|
|
|
|
|
$_->id eq $proj || $_->name eq $proj |
|
0
|
|
|
|
|
|
|
488
|
|
|
|
|
|
|
} $self->jira->projects; |
489
|
|
|
|
|
|
|
|
490
|
0
|
0
|
|
|
|
|
return $project if $project; |
491
|
|
|
|
|
|
|
|
492
|
0
|
|
|
|
|
|
local $Carp::CarpLevel = $Carp::CarpLevel + 1; |
493
|
0
|
|
|
|
|
|
confess "add_subtask() called with unknown project '$proj'"; |
494
|
|
|
|
|
|
|
} |
495
|
|
|
|
|
|
|
|
496
|
|
|
|
|
|
|
sub _get_subtask_parent { |
497
|
0
|
|
|
0
|
|
|
my ( $self, $fields ) = @_; |
498
|
|
|
|
|
|
|
|
499
|
|
|
|
|
|
|
# if we're not passed a parent parameter, we're the parent |
500
|
|
|
|
|
|
|
return $self |
501
|
0
|
0
|
0
|
|
|
|
unless exists $fields->{parent} && defined $fields->{parent}; |
502
|
|
|
|
|
|
|
|
503
|
0
|
|
|
|
|
|
my $issue = $fields->{parent}; |
504
|
0
|
0
|
|
|
|
|
if ( $self->obj_isa( $issue, 'issue' ) ) { |
505
|
|
|
|
|
|
|
|
506
|
|
|
|
|
|
|
# we were passed an issue type object |
507
|
0
|
|
|
|
|
|
return $issue; |
508
|
|
|
|
|
|
|
} |
509
|
|
|
|
|
|
|
|
510
|
0
|
|
|
|
|
|
my ( $parent ) = $self->jira->issues( $issue ); |
511
|
|
|
|
|
|
|
|
512
|
0
|
0
|
|
|
|
|
return $parent if $parent; |
513
|
|
|
|
|
|
|
|
514
|
0
|
|
|
|
|
|
local $Carp::CarpLevel = $Carp::CarpLevel + 2; |
515
|
0
|
|
|
|
|
|
confess "add_subtask() called with unknown parent '$issue'"; |
516
|
|
|
|
|
|
|
} |
517
|
|
|
|
|
|
|
|
518
|
|
|
|
|
|
|
sub _get_subtask_issue_type { |
519
|
0
|
|
|
0
|
|
|
my ( $self, $project, $fields ) = @_; |
520
|
|
|
|
|
|
|
|
521
|
|
|
|
|
|
|
# let's set this once in case we need to throw an exception |
522
|
0
|
|
|
|
|
|
local $Carp::CarpLevel = $Carp::CarpLevel + 2; |
523
|
|
|
|
|
|
|
|
524
|
0
|
0
|
0
|
|
|
|
if ( exists $fields->{issuetype} && defined $fields->{issuetype} ) { |
525
|
0
|
|
|
|
|
|
my $type = $fields->{issuetype}; |
526
|
|
|
|
|
|
|
|
527
|
0
|
0
|
|
|
|
|
if ( $self->obj_isa( $type, 'issuetype' ) ) { |
528
|
|
|
|
|
|
|
|
529
|
|
|
|
|
|
|
# we were passed an issue type object |
530
|
0
|
0
|
|
|
|
|
return $type if $type->subtask; |
531
|
|
|
|
|
|
|
|
532
|
0
|
|
|
|
|
|
confess |
533
|
|
|
|
|
|
|
"add_subtask() called with a non-subtask issue type: '$type'"; |
534
|
|
|
|
|
|
|
} |
535
|
|
|
|
|
|
|
|
536
|
|
|
|
|
|
|
my ( $issuetype ) = grep { ## |
537
|
0
|
0
|
|
|
|
|
$_->id eq $type || $_->name eq $type |
|
0
|
|
|
|
|
|
|
538
|
|
|
|
|
|
|
} $project->issueTypes; |
539
|
|
|
|
|
|
|
|
540
|
0
|
0
|
0
|
|
|
|
return $issuetype if $issuetype && $issuetype->subtask; |
541
|
|
|
|
|
|
|
|
542
|
0
|
0
|
|
|
|
|
if ( !defined $issuetype ) { |
543
|
0
|
|
|
|
|
|
confess 'add_subtask() called with a value that does not ' |
544
|
|
|
|
|
|
|
. "correspond to a known issue type: '$type'"; |
545
|
|
|
|
|
|
|
} |
546
|
|
|
|
|
|
|
|
547
|
|
|
|
|
|
|
confess |
548
|
0
|
|
|
|
|
|
"add_subtask() called with a non-subtask issue type: '$issuetype'"; |
549
|
|
|
|
|
|
|
} |
550
|
|
|
|
|
|
|
|
551
|
|
|
|
|
|
|
# we didn't get passed an issue type, so let's find one |
552
|
|
|
|
|
|
|
|
553
|
0
|
|
|
|
|
|
my @subtasks = $self->project->subtaskIssueTypes; |
554
|
|
|
|
|
|
|
|
555
|
0
|
0
|
|
|
|
|
if ( @subtasks == 1 ) { |
556
|
0
|
|
|
|
|
|
return $subtasks[0]; |
557
|
|
|
|
|
|
|
} |
558
|
|
|
|
|
|
|
|
559
|
0
|
|
|
|
|
|
my $count = scalar @subtasks; |
560
|
0
|
|
|
|
|
|
my $list = join q{, } => @subtasks; |
561
|
|
|
|
|
|
|
|
562
|
0
|
|
|
|
|
|
confess 'add_subtask() called without specifying a subtask type; ' |
563
|
|
|
|
|
|
|
. "there are $count subtask types: $list"; |
564
|
|
|
|
|
|
|
} |
565
|
|
|
|
|
|
|
|
566
|
|
|
|
|
|
|
########################################################################### |
567
|
|
|
|
|
|
|
|
568
|
|
|
|
|
|
|
#pod =method B<update> |
569
|
|
|
|
|
|
|
#pod |
570
|
|
|
|
|
|
|
#pod Puts an update to JIRA. Accepts a hash of fields => values to be put. |
571
|
|
|
|
|
|
|
#pod |
572
|
|
|
|
|
|
|
#pod =cut |
573
|
|
|
|
|
|
|
|
574
|
|
|
|
|
|
|
sub update { |
575
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
576
|
0
|
|
|
|
|
|
my $hash = {}; |
577
|
0
|
|
|
|
|
|
while ( @_ ) { |
578
|
0
|
|
|
|
|
|
my $field = shift; |
579
|
0
|
|
|
|
|
|
my $value = shift; |
580
|
0
|
|
|
|
|
|
$hash->{$field} = $value; |
581
|
|
|
|
|
|
|
} |
582
|
0
|
|
|
|
|
|
return $self->put( |
583
|
|
|
|
|
|
|
{ |
584
|
|
|
|
|
|
|
update => $hash, |
585
|
|
|
|
|
|
|
} |
586
|
|
|
|
|
|
|
); |
587
|
|
|
|
|
|
|
} |
588
|
|
|
|
|
|
|
|
589
|
|
|
|
|
|
|
#pod =method B<put_field> |
590
|
|
|
|
|
|
|
#pod |
591
|
|
|
|
|
|
|
#pod Puts a value to a field. Accepts the field name and the value as parameters. |
592
|
|
|
|
|
|
|
#pod |
593
|
|
|
|
|
|
|
#pod =cut |
594
|
|
|
|
|
|
|
|
595
|
|
|
|
|
|
|
sub put_field { |
596
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
597
|
0
|
|
|
|
|
|
my $field = shift; |
598
|
0
|
|
|
|
|
|
my $value = shift; |
599
|
0
|
|
|
|
|
|
return $self->put( |
600
|
|
|
|
|
|
|
{ |
601
|
|
|
|
|
|
|
fields => { $field => $value }, |
602
|
|
|
|
|
|
|
} |
603
|
|
|
|
|
|
|
); |
604
|
|
|
|
|
|
|
} |
605
|
|
|
|
|
|
|
|
606
|
|
|
|
|
|
|
#pod =method B<reload> |
607
|
|
|
|
|
|
|
#pod |
608
|
|
|
|
|
|
|
#pod Reload the issue from the JIRA server. |
609
|
|
|
|
|
|
|
#pod |
610
|
|
|
|
|
|
|
#pod =cut |
611
|
|
|
|
|
|
|
|
612
|
|
|
|
|
|
|
sub reload { |
613
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
614
|
0
|
|
|
|
|
|
$self->{data} = $self->get; |
615
|
0
|
|
|
|
|
|
$self->init( $self->factory ); |
616
|
0
|
|
|
|
|
|
return; |
617
|
|
|
|
|
|
|
} |
618
|
|
|
|
|
|
|
|
619
|
|
|
|
|
|
|
########################################################################### |
620
|
|
|
|
|
|
|
|
621
|
|
|
|
|
|
|
#pod =internal_method B<get> |
622
|
|
|
|
|
|
|
#pod |
623
|
|
|
|
|
|
|
#pod Wrapper around C<JIRA::REST::Class>' L<get|JIRA::REST::Class/get> method that |
624
|
|
|
|
|
|
|
#pod defaults to this issue's URL. Allows for extra parameters to be specified. |
625
|
|
|
|
|
|
|
#pod |
626
|
|
|
|
|
|
|
#pod =cut |
627
|
|
|
|
|
|
|
|
628
|
|
|
|
|
|
|
sub get { |
629
|
0
|
|
|
0
|
1
|
|
my ( $self, $extra, @args ) = @_; |
630
|
0
|
|
0
|
|
|
|
$extra //= q{}; |
631
|
0
|
|
|
|
|
|
return $self->jira->get( $self->url . $extra, @args ); |
632
|
|
|
|
|
|
|
} |
633
|
|
|
|
|
|
|
|
634
|
|
|
|
|
|
|
#pod =internal_method B<post> |
635
|
|
|
|
|
|
|
#pod |
636
|
|
|
|
|
|
|
#pod Wrapper around C<JIRA::REST::Class>' L<post|JIRA::REST::Class/post> method |
637
|
|
|
|
|
|
|
#pod that defaults to this issue's URL. Allows for extra parameters to be |
638
|
|
|
|
|
|
|
#pod specified. |
639
|
|
|
|
|
|
|
#pod |
640
|
|
|
|
|
|
|
#pod =cut |
641
|
|
|
|
|
|
|
|
642
|
|
|
|
|
|
|
sub post { |
643
|
0
|
|
|
0
|
1
|
|
my ( $self, $extra, @args ) = @_; |
644
|
0
|
|
0
|
|
|
|
$extra //= q{}; |
645
|
0
|
|
|
|
|
|
return $self->jira->post( $self->url . $extra, @args ); |
646
|
|
|
|
|
|
|
} |
647
|
|
|
|
|
|
|
|
648
|
|
|
|
|
|
|
#pod =internal_method B<put> |
649
|
|
|
|
|
|
|
#pod |
650
|
|
|
|
|
|
|
#pod Wrapper around C<JIRA::REST::Class>' L<put|JIRA::REST::Class/put> method that |
651
|
|
|
|
|
|
|
#pod defaults to this issue's URL. Allows for extra parameters to be specified. |
652
|
|
|
|
|
|
|
#pod |
653
|
|
|
|
|
|
|
#pod =cut |
654
|
|
|
|
|
|
|
|
655
|
|
|
|
|
|
|
sub put { |
656
|
0
|
|
|
0
|
1
|
|
my ( $self, @args ) = @_; |
657
|
0
|
|
|
|
|
|
return $self->jira->put( $self->url, @args ); |
658
|
|
|
|
|
|
|
} |
659
|
|
|
|
|
|
|
|
660
|
|
|
|
|
|
|
#pod =internal_method B<delete> |
661
|
|
|
|
|
|
|
#pod |
662
|
|
|
|
|
|
|
#pod Wrapper around C<JIRA::REST::Class>' L<delete|JIRA::REST::Class/delete> method |
663
|
|
|
|
|
|
|
#pod that defaults to this issue's URL. Allows for extra parameters to be |
664
|
|
|
|
|
|
|
#pod specified. |
665
|
|
|
|
|
|
|
#pod |
666
|
|
|
|
|
|
|
#pod =cut |
667
|
|
|
|
|
|
|
|
668
|
|
|
|
|
|
|
sub delete { ## no critic (ProhibitBuiltinHomonyms) |
669
|
0
|
|
|
0
|
1
|
|
my ( $self, $extra, @args ) = @_; |
670
|
0
|
|
0
|
|
|
|
$extra //= q{}; |
671
|
0
|
|
|
|
|
|
return $self->jira->delete( $self->url . $extra, @args ); |
672
|
|
|
|
|
|
|
} |
673
|
|
|
|
|
|
|
|
674
|
|
|
|
|
|
|
#pod =method B<sprints> |
675
|
|
|
|
|
|
|
#pod |
676
|
|
|
|
|
|
|
#pod Generates a list of L<JIRA::REST::Class::Sprint|JIRA::REST::Class::Sprint> |
677
|
|
|
|
|
|
|
#pod objects from the fields for an issue. Uses the field_name() accessor on the |
678
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::Project|JIRA::REST::Class::Project/"field_name |
679
|
|
|
|
|
|
|
#pod FIELD_KEY"> object to determine the name of the custom sprint |
680
|
|
|
|
|
|
|
#pod field. Currently, this only really works if you're using L<Atlassian |
681
|
|
|
|
|
|
|
#pod GreenHopper|https://www.atlassian.com/software/jira/agile>. |
682
|
|
|
|
|
|
|
#pod |
683
|
|
|
|
|
|
|
#pod =cut |
684
|
|
|
|
|
|
|
|
685
|
|
|
|
|
|
|
__PACKAGE__->mk_lazy_ro_accessor( |
686
|
|
|
|
|
|
|
'sprints', |
687
|
|
|
|
|
|
|
sub { |
688
|
|
|
|
|
|
|
my $self = shift; |
689
|
|
|
|
|
|
|
|
690
|
|
|
|
|
|
|
# in my configuration, 'Sprint' is a custom field |
691
|
|
|
|
|
|
|
my $sprint_field = $self->project->field_name( 'Sprint' ); |
692
|
|
|
|
|
|
|
|
693
|
|
|
|
|
|
|
my @sprints; |
694
|
|
|
|
|
|
|
foreach my $sprint ( @{ $self->fields->{$sprint_field} } ) { |
695
|
|
|
|
|
|
|
push @sprints, $self->make_object( 'sprint', { data => $sprint } ); |
696
|
|
|
|
|
|
|
} |
697
|
|
|
|
|
|
|
return \@sprints; |
698
|
|
|
|
|
|
|
} |
699
|
|
|
|
|
|
|
); |
700
|
|
|
|
|
|
|
|
701
|
|
|
|
|
|
|
#<<< |
702
|
|
|
|
|
|
|
|
703
|
|
|
|
|
|
|
#pod =method B<children> |
704
|
|
|
|
|
|
|
#pod |
705
|
|
|
|
|
|
|
#pod Returns a list of issue objects that are children of the issue. Currently |
706
|
|
|
|
|
|
|
#pod requires the L<ScriptRunner |
707
|
|
|
|
|
|
|
#pod plugin|https://marketplace.atlassian.com/plugins/com.onresolve.jira.groovy.groovyrunner/cloud/overview>. |
708
|
|
|
|
|
|
|
#pod |
709
|
|
|
|
|
|
|
#pod =cut |
710
|
|
|
|
|
|
|
|
711
|
|
|
|
|
|
|
#>>> |
712
|
|
|
|
|
|
|
|
713
|
|
|
|
|
|
|
sub children { |
714
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
715
|
0
|
|
|
|
|
|
my $key = $self->key; |
716
|
0
|
|
|
|
|
|
my $children = $self->jira->query( |
717
|
|
|
|
|
|
|
{ |
718
|
|
|
|
|
|
|
jql => qq{issueFunction in subtasksOf("key = $key")} |
719
|
|
|
|
|
|
|
} |
720
|
|
|
|
|
|
|
); |
721
|
|
|
|
|
|
|
|
722
|
0
|
0
|
|
|
|
|
return unless $children->issue_count; |
723
|
0
|
|
|
|
|
|
return $children->issues; |
724
|
|
|
|
|
|
|
} |
725
|
|
|
|
|
|
|
|
726
|
|
|
|
|
|
|
########################################################################### |
727
|
|
|
|
|
|
|
|
728
|
|
|
|
|
|
|
#pod =method B<start_progress> |
729
|
|
|
|
|
|
|
#pod |
730
|
|
|
|
|
|
|
#pod Moves the status of the issue to 'In Progress', regardless of what the current |
731
|
|
|
|
|
|
|
#pod status is. |
732
|
|
|
|
|
|
|
#pod |
733
|
|
|
|
|
|
|
#pod =cut |
734
|
|
|
|
|
|
|
|
735
|
|
|
|
|
|
|
sub start_progress { |
736
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
737
|
0
|
|
|
|
|
|
my $callback = shift; |
738
|
0
|
|
0
|
0
|
|
|
$callback //= sub { }; |
739
|
|
|
|
|
|
|
|
740
|
0
|
|
|
|
|
|
return $self->transitions->transition_walk( |
741
|
|
|
|
|
|
|
'In Progress', |
742
|
|
|
|
|
|
|
{ |
743
|
|
|
|
|
|
|
'Open' => 'In Progress', |
744
|
|
|
|
|
|
|
'Reopened' => 'In Progress', |
745
|
|
|
|
|
|
|
'In QA' => 'In Progress', |
746
|
|
|
|
|
|
|
'Blocked' => 'In Progress', |
747
|
|
|
|
|
|
|
'Resolved' => 'Reopened', |
748
|
|
|
|
|
|
|
'Verified' => 'Reopened', |
749
|
|
|
|
|
|
|
'Closed' => 'Reopened', |
750
|
|
|
|
|
|
|
}, |
751
|
|
|
|
|
|
|
$callback |
752
|
|
|
|
|
|
|
); |
753
|
|
|
|
|
|
|
} |
754
|
|
|
|
|
|
|
|
755
|
|
|
|
|
|
|
#pod =method B<start_qa> |
756
|
|
|
|
|
|
|
#pod |
757
|
|
|
|
|
|
|
#pod Moves the status of the issue to 'In QA', regardless of what the current |
758
|
|
|
|
|
|
|
#pod status is. |
759
|
|
|
|
|
|
|
#pod |
760
|
|
|
|
|
|
|
#pod =cut |
761
|
|
|
|
|
|
|
|
762
|
|
|
|
|
|
|
sub start_qa { |
763
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
764
|
0
|
|
|
|
|
|
my $callback = shift; |
765
|
0
|
|
0
|
0
|
|
|
$callback //= sub { }; |
766
|
|
|
|
|
|
|
|
767
|
0
|
|
|
|
|
|
return $self->transitions->transition_walk( |
768
|
|
|
|
|
|
|
'In QA', |
769
|
|
|
|
|
|
|
{ |
770
|
|
|
|
|
|
|
'Open' => 'In Progress', |
771
|
|
|
|
|
|
|
'In Progress' => 'Resolved', |
772
|
|
|
|
|
|
|
'Reopened' => 'Resolved', |
773
|
|
|
|
|
|
|
'Resolved' => 'In QA', |
774
|
|
|
|
|
|
|
'Blocked' => 'In QA', |
775
|
|
|
|
|
|
|
'Verified' => 'Reopened', |
776
|
|
|
|
|
|
|
'Closed' => 'Reopened', |
777
|
|
|
|
|
|
|
}, |
778
|
|
|
|
|
|
|
$callback |
779
|
|
|
|
|
|
|
); |
780
|
|
|
|
|
|
|
} |
781
|
|
|
|
|
|
|
|
782
|
|
|
|
|
|
|
#pod =method B<resolve> |
783
|
|
|
|
|
|
|
#pod |
784
|
|
|
|
|
|
|
#pod Moves the status of the issue to 'Resolved', regardless of what the current |
785
|
|
|
|
|
|
|
#pod status is. |
786
|
|
|
|
|
|
|
#pod |
787
|
|
|
|
|
|
|
#pod =cut |
788
|
|
|
|
|
|
|
|
789
|
|
|
|
|
|
|
sub resolve { |
790
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
791
|
0
|
|
|
|
|
|
my $callback = shift; |
792
|
0
|
|
0
|
0
|
|
|
$callback //= sub { }; |
793
|
|
|
|
|
|
|
|
794
|
0
|
|
|
|
|
|
return $self->transitions->transition_walk( |
795
|
|
|
|
|
|
|
'Resolved', |
796
|
|
|
|
|
|
|
{ |
797
|
|
|
|
|
|
|
'Open' => 'In Progress', |
798
|
|
|
|
|
|
|
'In Progress' => 'Resolved', |
799
|
|
|
|
|
|
|
'Reopened' => 'Resolved', |
800
|
|
|
|
|
|
|
'Blocked' => 'In Progress', |
801
|
|
|
|
|
|
|
'In QA' => 'In Progress', |
802
|
|
|
|
|
|
|
'Verified' => 'Reopened', |
803
|
|
|
|
|
|
|
'Closed' => 'Reopened', |
804
|
|
|
|
|
|
|
}, |
805
|
|
|
|
|
|
|
$callback |
806
|
|
|
|
|
|
|
); |
807
|
|
|
|
|
|
|
} |
808
|
|
|
|
|
|
|
|
809
|
|
|
|
|
|
|
#pod =method B<open> |
810
|
|
|
|
|
|
|
#pod |
811
|
|
|
|
|
|
|
#pod Moves the status of the issue to 'Open', regardless of what the current status is. |
812
|
|
|
|
|
|
|
#pod |
813
|
|
|
|
|
|
|
#pod =cut |
814
|
|
|
|
|
|
|
|
815
|
|
|
|
|
|
|
sub open { ## no critic (ProhibitBuiltinHomonyms) |
816
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
817
|
0
|
|
|
|
|
|
my $callback = shift; |
818
|
0
|
|
0
|
0
|
|
|
$callback //= sub { }; |
819
|
|
|
|
|
|
|
|
820
|
0
|
|
|
|
|
|
return $self->transitions->transition_walk( |
821
|
|
|
|
|
|
|
'Open', |
822
|
|
|
|
|
|
|
{ |
823
|
|
|
|
|
|
|
'In Progress' => 'Open', |
824
|
|
|
|
|
|
|
'Reopened' => 'In Progress', |
825
|
|
|
|
|
|
|
'Blocked' => 'In Progress', |
826
|
|
|
|
|
|
|
'In QA' => 'In Progress', |
827
|
|
|
|
|
|
|
'Resolved' => 'Reopened', |
828
|
|
|
|
|
|
|
'Verified' => 'Reopened', |
829
|
|
|
|
|
|
|
'Closed' => 'Reopened', |
830
|
|
|
|
|
|
|
}, |
831
|
|
|
|
|
|
|
$callback |
832
|
|
|
|
|
|
|
); |
833
|
|
|
|
|
|
|
} |
834
|
|
|
|
|
|
|
|
835
|
|
|
|
|
|
|
#pod =method B<close> |
836
|
|
|
|
|
|
|
#pod |
837
|
|
|
|
|
|
|
#pod Moves the status of the issue to 'Closed', regardless of what the current status is. |
838
|
|
|
|
|
|
|
#pod |
839
|
|
|
|
|
|
|
#pod =cut |
840
|
|
|
|
|
|
|
|
841
|
|
|
|
|
|
|
sub close { ## no critic (ProhibitBuiltinHomonyms ProhibitAmbiguousNames) |
842
|
0
|
|
|
0
|
1
|
|
my $self = shift; |
843
|
0
|
|
|
|
|
|
my $callback = shift; |
844
|
0
|
|
0
|
0
|
|
|
$callback //= sub { }; |
845
|
|
|
|
|
|
|
|
846
|
0
|
|
|
|
|
|
return $self->transitions->transition_walk( |
847
|
|
|
|
|
|
|
'Closed', |
848
|
|
|
|
|
|
|
{ |
849
|
|
|
|
|
|
|
'Open' => 'In Progress', |
850
|
|
|
|
|
|
|
'In Progress' => 'Resolved', |
851
|
|
|
|
|
|
|
'Reopened' => 'Resolved', |
852
|
|
|
|
|
|
|
'Blocked' => 'In Progress', |
853
|
|
|
|
|
|
|
'In QA' => 'Verified', |
854
|
|
|
|
|
|
|
'Resolved' => 'Closed', |
855
|
|
|
|
|
|
|
'Verified' => 'Closed', |
856
|
|
|
|
|
|
|
}, |
857
|
|
|
|
|
|
|
$callback |
858
|
|
|
|
|
|
|
); |
859
|
|
|
|
|
|
|
} |
860
|
|
|
|
|
|
|
|
861
|
|
|
|
|
|
|
1; |
862
|
|
|
|
|
|
|
|
863
|
|
|
|
|
|
|
#pod =accessor B<expand> |
864
|
|
|
|
|
|
|
#pod |
865
|
|
|
|
|
|
|
#pod A comma-separated list of fields in the issue that weren't expanded in the |
866
|
|
|
|
|
|
|
#pod initial REST call. |
867
|
|
|
|
|
|
|
#pod |
868
|
|
|
|
|
|
|
#pod =accessor B<fields> |
869
|
|
|
|
|
|
|
#pod |
870
|
|
|
|
|
|
|
#pod Returns a reference to the fields hash for the issue. |
871
|
|
|
|
|
|
|
#pod |
872
|
|
|
|
|
|
|
#pod =accessor B<aggregateprogress> |
873
|
|
|
|
|
|
|
#pod |
874
|
|
|
|
|
|
|
#pod Returns the aggregate progress for the issue as a hash reference. |
875
|
|
|
|
|
|
|
#pod |
876
|
|
|
|
|
|
|
#pod TODO: Turn this into an object. |
877
|
|
|
|
|
|
|
#pod |
878
|
|
|
|
|
|
|
#pod =accessor B<aggregatetimeestimate> |
879
|
|
|
|
|
|
|
#pod |
880
|
|
|
|
|
|
|
#pod Returns the aggregate time estimate for the issue. |
881
|
|
|
|
|
|
|
#pod |
882
|
|
|
|
|
|
|
#pod TODO: Turn this into an object that can return either seconds or a w/d/h/m/s |
883
|
|
|
|
|
|
|
#pod string. |
884
|
|
|
|
|
|
|
#pod |
885
|
|
|
|
|
|
|
#pod =accessor B<aggregatetimeoriginalestimate> |
886
|
|
|
|
|
|
|
#pod |
887
|
|
|
|
|
|
|
#pod Returns the aggregate time original estimate for the issue. |
888
|
|
|
|
|
|
|
#pod |
889
|
|
|
|
|
|
|
#pod TODO: Turn this into an object that can return either seconds or a w/d/h/m/s |
890
|
|
|
|
|
|
|
#pod string. |
891
|
|
|
|
|
|
|
#pod |
892
|
|
|
|
|
|
|
#pod =accessor B<aggregatetimespent> |
893
|
|
|
|
|
|
|
#pod |
894
|
|
|
|
|
|
|
#pod Returns the aggregate time spent for the issue. |
895
|
|
|
|
|
|
|
#pod |
896
|
|
|
|
|
|
|
#pod TODO: Turn this into an object that can return either seconds or a w/d/h/m/s |
897
|
|
|
|
|
|
|
#pod string. |
898
|
|
|
|
|
|
|
#pod |
899
|
|
|
|
|
|
|
#pod =accessor B<assignee> |
900
|
|
|
|
|
|
|
#pod |
901
|
|
|
|
|
|
|
#pod Returns the issue's assignee as a |
902
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::User|JIRA::REST::Class::User> object. |
903
|
|
|
|
|
|
|
#pod |
904
|
|
|
|
|
|
|
#pod =accessor B<changelog> |
905
|
|
|
|
|
|
|
#pod |
906
|
|
|
|
|
|
|
#pod Returns the issue's change log as a |
907
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::Issue::Changelog|JIRA::REST::Class::Issue::Changelog> |
908
|
|
|
|
|
|
|
#pod object. |
909
|
|
|
|
|
|
|
#pod |
910
|
|
|
|
|
|
|
#pod =accessor B<comments> |
911
|
|
|
|
|
|
|
#pod |
912
|
|
|
|
|
|
|
#pod Returns a list of the issue's comments as |
913
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::Issue::Comment|JIRA::REST::Class::Issue::Comment> |
914
|
|
|
|
|
|
|
#pod objects. If called in a scalar context, returns an array reference to the |
915
|
|
|
|
|
|
|
#pod list, not the number of elements in the list. |
916
|
|
|
|
|
|
|
#pod |
917
|
|
|
|
|
|
|
#pod =accessor B<components> |
918
|
|
|
|
|
|
|
#pod |
919
|
|
|
|
|
|
|
#pod Returns a list of the issue's components as |
920
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::Project::Component|JIRA::REST::Class::Project::Component> |
921
|
|
|
|
|
|
|
#pod objects. If called in a scalar context, returns an array reference to the |
922
|
|
|
|
|
|
|
#pod list, not the number of elements in the list. |
923
|
|
|
|
|
|
|
#pod |
924
|
|
|
|
|
|
|
#pod =accessor B<component_count> |
925
|
|
|
|
|
|
|
#pod |
926
|
|
|
|
|
|
|
#pod Returns a count of the issue's components. |
927
|
|
|
|
|
|
|
#pod |
928
|
|
|
|
|
|
|
#pod =accessor B<created> |
929
|
|
|
|
|
|
|
#pod |
930
|
|
|
|
|
|
|
#pod Returns the issue's creation date as a L<DateTime|DateTime> object. |
931
|
|
|
|
|
|
|
#pod |
932
|
|
|
|
|
|
|
#pod =accessor B<creator> |
933
|
|
|
|
|
|
|
#pod |
934
|
|
|
|
|
|
|
#pod Returns the issue's assignee as a |
935
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::User|JIRA::REST::Class::User> object. |
936
|
|
|
|
|
|
|
#pod |
937
|
|
|
|
|
|
|
#pod =accessor B<description> |
938
|
|
|
|
|
|
|
#pod |
939
|
|
|
|
|
|
|
#pod Returns the description of the issue. |
940
|
|
|
|
|
|
|
#pod |
941
|
|
|
|
|
|
|
#pod =accessor B<duedate> |
942
|
|
|
|
|
|
|
#pod |
943
|
|
|
|
|
|
|
#pod Returns the issue's due date as a L<DateTime|DateTime> object. |
944
|
|
|
|
|
|
|
#pod |
945
|
|
|
|
|
|
|
#pod =accessor B<environment> |
946
|
|
|
|
|
|
|
#pod |
947
|
|
|
|
|
|
|
#pod Returns the issue's environment as a hash reference. |
948
|
|
|
|
|
|
|
#pod |
949
|
|
|
|
|
|
|
#pod TODO: Turn this into an object. |
950
|
|
|
|
|
|
|
#pod |
951
|
|
|
|
|
|
|
#pod =accessor B<fixVersions> |
952
|
|
|
|
|
|
|
#pod |
953
|
|
|
|
|
|
|
#pod Returns a list of the issue's fixVersions. |
954
|
|
|
|
|
|
|
#pod |
955
|
|
|
|
|
|
|
#pod TODO: Turn this into a list of objects. |
956
|
|
|
|
|
|
|
#pod |
957
|
|
|
|
|
|
|
#pod =accessor B<issuelinks> |
958
|
|
|
|
|
|
|
#pod |
959
|
|
|
|
|
|
|
#pod Returns a list of the issue's links. |
960
|
|
|
|
|
|
|
#pod |
961
|
|
|
|
|
|
|
#pod TODO: Turn this into a list of objects. |
962
|
|
|
|
|
|
|
#pod |
963
|
|
|
|
|
|
|
#pod =accessor B<issuetype> |
964
|
|
|
|
|
|
|
#pod |
965
|
|
|
|
|
|
|
#pod Returns the issue type as a |
966
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::Issue::Type|JIRA::REST::Class::Issue::Type> object. |
967
|
|
|
|
|
|
|
#pod |
968
|
|
|
|
|
|
|
#pod =accessor B<labels> |
969
|
|
|
|
|
|
|
#pod |
970
|
|
|
|
|
|
|
#pod Returns the issue's labels as an array reference. |
971
|
|
|
|
|
|
|
#pod |
972
|
|
|
|
|
|
|
#pod =accessor B<lastViewed> |
973
|
|
|
|
|
|
|
#pod |
974
|
|
|
|
|
|
|
#pod Returns the issue's last view date as a L<DateTime|DateTime> object. |
975
|
|
|
|
|
|
|
#pod |
976
|
|
|
|
|
|
|
#pod =accessor B<parent> |
977
|
|
|
|
|
|
|
#pod |
978
|
|
|
|
|
|
|
#pod Returns the issue's parent as a |
979
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::Issue|JIRA::REST::Class::Issue> object. |
980
|
|
|
|
|
|
|
#pod |
981
|
|
|
|
|
|
|
#pod =accessor B<has_parent> |
982
|
|
|
|
|
|
|
#pod |
983
|
|
|
|
|
|
|
#pod Returns a boolean indicating whether the issue has a parent. |
984
|
|
|
|
|
|
|
#pod |
985
|
|
|
|
|
|
|
#pod =accessor B<priority> |
986
|
|
|
|
|
|
|
#pod |
987
|
|
|
|
|
|
|
#pod Returns the issue's priority as a hash reference. |
988
|
|
|
|
|
|
|
#pod |
989
|
|
|
|
|
|
|
#pod TODO: Turn this into an object. |
990
|
|
|
|
|
|
|
#pod |
991
|
|
|
|
|
|
|
#pod =accessor B<progress> |
992
|
|
|
|
|
|
|
#pod |
993
|
|
|
|
|
|
|
#pod Returns the issue's progress as a hash reference. |
994
|
|
|
|
|
|
|
#pod |
995
|
|
|
|
|
|
|
#pod TODO: Turn this into an object. |
996
|
|
|
|
|
|
|
#pod |
997
|
|
|
|
|
|
|
#pod =accessor B<project> |
998
|
|
|
|
|
|
|
#pod |
999
|
|
|
|
|
|
|
#pod Returns the issue's project as a |
1000
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::Project|JIRA::REST::Class::Project> object. |
1001
|
|
|
|
|
|
|
#pod |
1002
|
|
|
|
|
|
|
#pod =accessor B<reporter> |
1003
|
|
|
|
|
|
|
#pod |
1004
|
|
|
|
|
|
|
#pod Returns the issue's reporter as a |
1005
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::User|JIRA::REST::Class::User> object. |
1006
|
|
|
|
|
|
|
#pod |
1007
|
|
|
|
|
|
|
#pod =accessor B<resolution> |
1008
|
|
|
|
|
|
|
#pod |
1009
|
|
|
|
|
|
|
#pod Returns the issue's resolution. |
1010
|
|
|
|
|
|
|
#pod |
1011
|
|
|
|
|
|
|
#pod TODO: Turn this into an object. |
1012
|
|
|
|
|
|
|
#pod |
1013
|
|
|
|
|
|
|
#pod =accessor B<resolutiondate> |
1014
|
|
|
|
|
|
|
#pod |
1015
|
|
|
|
|
|
|
#pod Returns the issue's resolution date as a L<DateTime|DateTime> object. |
1016
|
|
|
|
|
|
|
#pod |
1017
|
|
|
|
|
|
|
#pod =accessor B<status> |
1018
|
|
|
|
|
|
|
#pod |
1019
|
|
|
|
|
|
|
#pod Returns the issue's status as a |
1020
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::Issue::Status|JIRA::REST::Class::Issue::Status> object. |
1021
|
|
|
|
|
|
|
#pod |
1022
|
|
|
|
|
|
|
#pod =accessor B<summary> |
1023
|
|
|
|
|
|
|
#pod |
1024
|
|
|
|
|
|
|
#pod Returns the summary of the issue. |
1025
|
|
|
|
|
|
|
#pod |
1026
|
|
|
|
|
|
|
#pod =accessor B<timeestimate> |
1027
|
|
|
|
|
|
|
#pod |
1028
|
|
|
|
|
|
|
#pod Returns the time estimate for the issue. |
1029
|
|
|
|
|
|
|
#pod |
1030
|
|
|
|
|
|
|
#pod TODO: Turn this into an object that can return either seconds or a w/d/h/m/s string. |
1031
|
|
|
|
|
|
|
#pod |
1032
|
|
|
|
|
|
|
#pod =accessor B<timeoriginalestimate> |
1033
|
|
|
|
|
|
|
#pod |
1034
|
|
|
|
|
|
|
#pod Returns the time original estimate for the issue. |
1035
|
|
|
|
|
|
|
#pod |
1036
|
|
|
|
|
|
|
#pod TODO: Turn this into an object that can return either seconds or a w/d/h/m/s string. |
1037
|
|
|
|
|
|
|
#pod |
1038
|
|
|
|
|
|
|
#pod =accessor B<timespent> |
1039
|
|
|
|
|
|
|
#pod |
1040
|
|
|
|
|
|
|
#pod Returns the time spent for the issue. |
1041
|
|
|
|
|
|
|
#pod |
1042
|
|
|
|
|
|
|
#pod TODO: Turn this into an object that can return either seconds or a w/d/h/m/s string. |
1043
|
|
|
|
|
|
|
#pod |
1044
|
|
|
|
|
|
|
#pod =accessor B<timetracking> |
1045
|
|
|
|
|
|
|
#pod |
1046
|
|
|
|
|
|
|
#pod Returns the time tracking of the issue as a |
1047
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::Issue::TimeTracking|JIRA::REST::Class::Issue::TimeTracking> |
1048
|
|
|
|
|
|
|
#pod object. |
1049
|
|
|
|
|
|
|
#pod |
1050
|
|
|
|
|
|
|
#pod =accessor B<transitions> |
1051
|
|
|
|
|
|
|
#pod |
1052
|
|
|
|
|
|
|
#pod Returns the valid transitions for the issue as a |
1053
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::Issue::Transitions|JIRA::REST::Class::Issue::Transitions> |
1054
|
|
|
|
|
|
|
#pod object. |
1055
|
|
|
|
|
|
|
#pod |
1056
|
|
|
|
|
|
|
#pod =accessor B<updated> |
1057
|
|
|
|
|
|
|
#pod |
1058
|
|
|
|
|
|
|
#pod Returns the issue's updated date as a L<DateTime|DateTime> object. |
1059
|
|
|
|
|
|
|
#pod |
1060
|
|
|
|
|
|
|
#pod =accessor B<versions> |
1061
|
|
|
|
|
|
|
#pod |
1062
|
|
|
|
|
|
|
#pod versions |
1063
|
|
|
|
|
|
|
#pod |
1064
|
|
|
|
|
|
|
#pod =accessor B<votes> |
1065
|
|
|
|
|
|
|
#pod |
1066
|
|
|
|
|
|
|
#pod votes |
1067
|
|
|
|
|
|
|
#pod |
1068
|
|
|
|
|
|
|
#pod =accessor B<watches> |
1069
|
|
|
|
|
|
|
#pod |
1070
|
|
|
|
|
|
|
#pod watches |
1071
|
|
|
|
|
|
|
#pod |
1072
|
|
|
|
|
|
|
#pod =accessor B<worklog> |
1073
|
|
|
|
|
|
|
#pod |
1074
|
|
|
|
|
|
|
#pod Returns the issue's change log as a |
1075
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class::Worklog|JIRA::REST::Class::Worklog> object. |
1076
|
|
|
|
|
|
|
#pod |
1077
|
|
|
|
|
|
|
#pod =accessor B<workratio> |
1078
|
|
|
|
|
|
|
#pod |
1079
|
|
|
|
|
|
|
#pod workratio |
1080
|
|
|
|
|
|
|
#pod |
1081
|
|
|
|
|
|
|
#pod =accessor B<id> |
1082
|
|
|
|
|
|
|
#pod |
1083
|
|
|
|
|
|
|
#pod Returns the issue ID. |
1084
|
|
|
|
|
|
|
#pod |
1085
|
|
|
|
|
|
|
#pod =accessor B<key> |
1086
|
|
|
|
|
|
|
#pod |
1087
|
|
|
|
|
|
|
#pod Returns the issue key. |
1088
|
|
|
|
|
|
|
#pod |
1089
|
|
|
|
|
|
|
#pod =accessor B<self> |
1090
|
|
|
|
|
|
|
#pod |
1091
|
|
|
|
|
|
|
#pod Returns the JIRA REST API's full URL for this issue. |
1092
|
|
|
|
|
|
|
#pod |
1093
|
|
|
|
|
|
|
#pod =accessor B<url> |
1094
|
|
|
|
|
|
|
#pod |
1095
|
|
|
|
|
|
|
#pod Returns the JIRA REST API's URL for this issue in a form used by |
1096
|
|
|
|
|
|
|
#pod L<JIRA::REST::Class|JIRA::REST::Class>. |
1097
|
|
|
|
|
|
|
#pod |
1098
|
|
|
|
|
|
|
#pod =for stopwords aggregatetimespent |
1099
|
|
|
|
|
|
|
#pod |
1100
|
|
|
|
|
|
|
#pod =cut |
1101
|
|
|
|
|
|
|
|
1102
|
|
|
|
|
|
|
__END__ |
1103
|
|
|
|
|
|
|
|
1104
|
|
|
|
|
|
|
=pod |
1105
|
|
|
|
|
|
|
|
1106
|
|
|
|
|
|
|
=encoding UTF-8 |
1107
|
|
|
|
|
|
|
|
1108
|
|
|
|
|
|
|
=for :stopwords Packy Anderson Alexandr Alexey Ciornii Melezhik aggregatetimespent |
1109
|
|
|
|
|
|
|
Atlassian GreenHopper JRC ScriptRunner TODO aggregateprogress |
1110
|
|
|
|
|
|
|
aggregatetimeestimate aggregatetimeoriginalestimate assigneeType avatar |
1111
|
|
|
|
|
|
|
avatarUrls completeDate displayName duedate emailAddress endDate fieldtype |
1112
|
|
|
|
|
|
|
fixVersions fromString genericized iconUrl isAssigneeTypeValid issueTypes |
1113
|
|
|
|
|
|
|
issuekeys issuelinks issuetype jira jql lastViewed maxResults |
1114
|
|
|
|
|
|
|
originalEstimate originalEstimateSeconds parentkey projectId rapidViewId |
1115
|
|
|
|
|
|
|
remainingEstimate remainingEstimateSeconds resolutiondate sprintlist |
1116
|
|
|
|
|
|
|
startDate subtaskIssueTypes timeSpent timeSpentSeconds timeestimate |
1117
|
|
|
|
|
|
|
timeoriginalestimate timespent timetracking toString updateAuthor worklog |
1118
|
|
|
|
|
|
|
workratio |
1119
|
|
|
|
|
|
|
|
1120
|
|
|
|
|
|
|
=head1 NAME |
1121
|
|
|
|
|
|
|
|
1122
|
|
|
|
|
|
|
JIRA::REST::Class::Issue - A helper class for L<JIRA::REST::Class|JIRA::REST::Class> that represents an |
1123
|
|
|
|
|
|
|
|
1124
|
|
|
|
|
|
|
=head1 VERSION |
1125
|
|
|
|
|
|
|
|
1126
|
|
|
|
|
|
|
version 0.11 |
1127
|
|
|
|
|
|
|
|
1128
|
|
|
|
|
|
|
=head1 DESCRIPTION |
1129
|
|
|
|
|
|
|
|
1130
|
|
|
|
|
|
|
This object represents a JIRA issue as an object. It is overloaded so it |
1131
|
|
|
|
|
|
|
returns the C<key> of the issue when stringified, and the C<id> of the issue |
1132
|
|
|
|
|
|
|
when it is used in a numeric context. If two of these objects are compared |
1133
|
|
|
|
|
|
|
I<as strings>, the C<key> of the issues will be used for the comparison, |
1134
|
|
|
|
|
|
|
while numeric comparison will compare the C<id>s of the issues. |
1135
|
|
|
|
|
|
|
|
1136
|
|
|
|
|
|
|
=head1 METHODS |
1137
|
|
|
|
|
|
|
|
1138
|
|
|
|
|
|
|
=head2 B<add_attachments> |
1139
|
|
|
|
|
|
|
|
1140
|
|
|
|
|
|
|
Accepts a list of filenames to be added to the issue as attachments. |
1141
|
|
|
|
|
|
|
|
1142
|
|
|
|
|
|
|
=head2 B<add_attachment> |
1143
|
|
|
|
|
|
|
|
1144
|
|
|
|
|
|
|
Accepts a single filename to be added to the issue as an attachment. |
1145
|
|
|
|
|
|
|
|
1146
|
|
|
|
|
|
|
=head2 B<add_data_attachment> |
1147
|
|
|
|
|
|
|
|
1148
|
|
|
|
|
|
|
Accepts a fake filename and a scalar representing the contents of a file and |
1149
|
|
|
|
|
|
|
adds it to the issue as an attachment. |
1150
|
|
|
|
|
|
|
|
1151
|
|
|
|
|
|
|
=head2 B<add_comment> |
1152
|
|
|
|
|
|
|
|
1153
|
|
|
|
|
|
|
Adds whatever is passed in as a comment on the issue. |
1154
|
|
|
|
|
|
|
|
1155
|
|
|
|
|
|
|
=head2 B<add_label> |
1156
|
|
|
|
|
|
|
|
1157
|
|
|
|
|
|
|
Adds whatever is passed in as a label for the issue. |
1158
|
|
|
|
|
|
|
|
1159
|
|
|
|
|
|
|
=head2 B<remove_label> |
1160
|
|
|
|
|
|
|
|
1161
|
|
|
|
|
|
|
Removes whatever is passed in from the labels for the issue. |
1162
|
|
|
|
|
|
|
|
1163
|
|
|
|
|
|
|
=head2 B<has_label> |
1164
|
|
|
|
|
|
|
|
1165
|
|
|
|
|
|
|
Returns true if the issue has the specified label. |
1166
|
|
|
|
|
|
|
|
1167
|
|
|
|
|
|
|
=head2 B<add_component> |
1168
|
|
|
|
|
|
|
|
1169
|
|
|
|
|
|
|
Adds whatever is passed in as a component for the issue. |
1170
|
|
|
|
|
|
|
|
1171
|
|
|
|
|
|
|
=head2 B<remove_component> |
1172
|
|
|
|
|
|
|
|
1173
|
|
|
|
|
|
|
Removes whatever is passed in from the components for the issue. |
1174
|
|
|
|
|
|
|
|
1175
|
|
|
|
|
|
|
=head2 B<set_assignee> |
1176
|
|
|
|
|
|
|
|
1177
|
|
|
|
|
|
|
Sets the assignee for the issue to be the user passed in. Can either be a |
1178
|
|
|
|
|
|
|
string representing the name or a |
1179
|
|
|
|
|
|
|
L<JIRA::REST::Class::User|JIRA::REST::Class::User> object. |
1180
|
|
|
|
|
|
|
|
1181
|
|
|
|
|
|
|
=head2 B<set_reporter> |
1182
|
|
|
|
|
|
|
|
1183
|
|
|
|
|
|
|
Sets the reporter for the issue to be the user passed in. Can either be a |
1184
|
|
|
|
|
|
|
string representing the name or a |
1185
|
|
|
|
|
|
|
L<JIRA::REST::Class::User|JIRA::REST::Class::User> object. |
1186
|
|
|
|
|
|
|
|
1187
|
|
|
|
|
|
|
=head2 B<add_issue_link> |
1188
|
|
|
|
|
|
|
|
1189
|
|
|
|
|
|
|
Adds a link from this issue to another one. Accepts the link type (either a |
1190
|
|
|
|
|
|
|
string representing the name or a |
1191
|
|
|
|
|
|
|
L<JIRA::REST::Class::Issue::LinkType|JIRA::REST::Class::Issue::LinkType>), |
1192
|
|
|
|
|
|
|
the issue to be linked to, and (optionally) the direction of the link |
1193
|
|
|
|
|
|
|
(inward/outward). If the direction cannot be determined from the name of |
1194
|
|
|
|
|
|
|
the link type, the default direction is 'inward'; |
1195
|
|
|
|
|
|
|
|
1196
|
|
|
|
|
|
|
=head2 B<add_subtask> |
1197
|
|
|
|
|
|
|
|
1198
|
|
|
|
|
|
|
Adds a subtask to the current issue. Accepts a hashref with named parameters |
1199
|
|
|
|
|
|
|
C<summary> and C<description>. If the parameter C<issuetype> is specified, |
1200
|
|
|
|
|
|
|
then a subtask of the specified type is created. If no issuetype is |
1201
|
|
|
|
|
|
|
specified, then the project is queried for valid subtask types, and, if there |
1202
|
|
|
|
|
|
|
is only one, that type is used. If the project has more than one valid |
1203
|
|
|
|
|
|
|
subtask type, an issuetype B<MUST> be specified. |
1204
|
|
|
|
|
|
|
|
1205
|
|
|
|
|
|
|
The remaining named parameters are passed to the create issue call as fields. |
1206
|
|
|
|
|
|
|
|
1207
|
|
|
|
|
|
|
=head2 B<update> |
1208
|
|
|
|
|
|
|
|
1209
|
|
|
|
|
|
|
Puts an update to JIRA. Accepts a hash of fields => values to be put. |
1210
|
|
|
|
|
|
|
|
1211
|
|
|
|
|
|
|
=head2 B<put_field> |
1212
|
|
|
|
|
|
|
|
1213
|
|
|
|
|
|
|
Puts a value to a field. Accepts the field name and the value as parameters. |
1214
|
|
|
|
|
|
|
|
1215
|
|
|
|
|
|
|
=head2 B<reload> |
1216
|
|
|
|
|
|
|
|
1217
|
|
|
|
|
|
|
Reload the issue from the JIRA server. |
1218
|
|
|
|
|
|
|
|
1219
|
|
|
|
|
|
|
=head2 B<sprints> |
1220
|
|
|
|
|
|
|
|
1221
|
|
|
|
|
|
|
Generates a list of L<JIRA::REST::Class::Sprint|JIRA::REST::Class::Sprint> |
1222
|
|
|
|
|
|
|
objects from the fields for an issue. Uses the field_name() accessor on the |
1223
|
|
|
|
|
|
|
L<JIRA::REST::Class::Project|JIRA::REST::Class::Project/"field_name |
1224
|
|
|
|
|
|
|
FIELD_KEY"> object to determine the name of the custom sprint |
1225
|
|
|
|
|
|
|
field. Currently, this only really works if you're using L<Atlassian |
1226
|
|
|
|
|
|
|
GreenHopper|https://www.atlassian.com/software/jira/agile>. |
1227
|
|
|
|
|
|
|
|
1228
|
|
|
|
|
|
|
=head2 B<children> |
1229
|
|
|
|
|
|
|
|
1230
|
|
|
|
|
|
|
Returns a list of issue objects that are children of the issue. Currently |
1231
|
|
|
|
|
|
|
requires the L<ScriptRunner |
1232
|
|
|
|
|
|
|
plugin|https://marketplace.atlassian.com/plugins/com.onresolve.jira.groovy.groovyrunner/cloud/overview>. |
1233
|
|
|
|
|
|
|
|
1234
|
|
|
|
|
|
|
=head2 B<start_progress> |
1235
|
|
|
|
|
|
|
|
1236
|
|
|
|
|
|
|
Moves the status of the issue to 'In Progress', regardless of what the current |
1237
|
|
|
|
|
|
|
status is. |
1238
|
|
|
|
|
|
|
|
1239
|
|
|
|
|
|
|
=head2 B<start_qa> |
1240
|
|
|
|
|
|
|
|
1241
|
|
|
|
|
|
|
Moves the status of the issue to 'In QA', regardless of what the current |
1242
|
|
|
|
|
|
|
status is. |
1243
|
|
|
|
|
|
|
|
1244
|
|
|
|
|
|
|
=head2 B<resolve> |
1245
|
|
|
|
|
|
|
|
1246
|
|
|
|
|
|
|
Moves the status of the issue to 'Resolved', regardless of what the current |
1247
|
|
|
|
|
|
|
status is. |
1248
|
|
|
|
|
|
|
|
1249
|
|
|
|
|
|
|
=head2 B<open> |
1250
|
|
|
|
|
|
|
|
1251
|
|
|
|
|
|
|
Moves the status of the issue to 'Open', regardless of what the current status is. |
1252
|
|
|
|
|
|
|
|
1253
|
|
|
|
|
|
|
=head2 B<close> |
1254
|
|
|
|
|
|
|
|
1255
|
|
|
|
|
|
|
Moves the status of the issue to 'Closed', regardless of what the current status is. |
1256
|
|
|
|
|
|
|
|
1257
|
|
|
|
|
|
|
=head1 READ-ONLY ACCESSORS |
1258
|
|
|
|
|
|
|
|
1259
|
|
|
|
|
|
|
=head2 B<expand> |
1260
|
|
|
|
|
|
|
|
1261
|
|
|
|
|
|
|
A comma-separated list of fields in the issue that weren't expanded in the |
1262
|
|
|
|
|
|
|
initial REST call. |
1263
|
|
|
|
|
|
|
|
1264
|
|
|
|
|
|
|
=head2 B<fields> |
1265
|
|
|
|
|
|
|
|
1266
|
|
|
|
|
|
|
Returns a reference to the fields hash for the issue. |
1267
|
|
|
|
|
|
|
|
1268
|
|
|
|
|
|
|
=head2 B<aggregateprogress> |
1269
|
|
|
|
|
|
|
|
1270
|
|
|
|
|
|
|
Returns the aggregate progress for the issue as a hash reference. |
1271
|
|
|
|
|
|
|
|
1272
|
|
|
|
|
|
|
TODO: Turn this into an object. |
1273
|
|
|
|
|
|
|
|
1274
|
|
|
|
|
|
|
=head2 B<aggregatetimeestimate> |
1275
|
|
|
|
|
|
|
|
1276
|
|
|
|
|
|
|
Returns the aggregate time estimate for the issue. |
1277
|
|
|
|
|
|
|
|
1278
|
|
|
|
|
|
|
TODO: Turn this into an object that can return either seconds or a w/d/h/m/s |
1279
|
|
|
|
|
|
|
string. |
1280
|
|
|
|
|
|
|
|
1281
|
|
|
|
|
|
|
=head2 B<aggregatetimeoriginalestimate> |
1282
|
|
|
|
|
|
|
|
1283
|
|
|
|
|
|
|
Returns the aggregate time original estimate for the issue. |
1284
|
|
|
|
|
|
|
|
1285
|
|
|
|
|
|
|
TODO: Turn this into an object that can return either seconds or a w/d/h/m/s |
1286
|
|
|
|
|
|
|
string. |
1287
|
|
|
|
|
|
|
|
1288
|
|
|
|
|
|
|
=head2 B<aggregatetimespent> |
1289
|
|
|
|
|
|
|
|
1290
|
|
|
|
|
|
|
Returns the aggregate time spent for the issue. |
1291
|
|
|
|
|
|
|
|
1292
|
|
|
|
|
|
|
TODO: Turn this into an object that can return either seconds or a w/d/h/m/s |
1293
|
|
|
|
|
|
|
string. |
1294
|
|
|
|
|
|
|
|
1295
|
|
|
|
|
|
|
=head2 B<assignee> |
1296
|
|
|
|
|
|
|
|
1297
|
|
|
|
|
|
|
Returns the issue's assignee as a |
1298
|
|
|
|
|
|
|
L<JIRA::REST::Class::User|JIRA::REST::Class::User> object. |
1299
|
|
|
|
|
|
|
|
1300
|
|
|
|
|
|
|
=head2 B<changelog> |
1301
|
|
|
|
|
|
|
|
1302
|
|
|
|
|
|
|
Returns the issue's change log as a |
1303
|
|
|
|
|
|
|
L<JIRA::REST::Class::Issue::Changelog|JIRA::REST::Class::Issue::Changelog> |
1304
|
|
|
|
|
|
|
object. |
1305
|
|
|
|
|
|
|
|
1306
|
|
|
|
|
|
|
=head2 B<comments> |
1307
|
|
|
|
|
|
|
|
1308
|
|
|
|
|
|
|
Returns a list of the issue's comments as |
1309
|
|
|
|
|
|
|
L<JIRA::REST::Class::Issue::Comment|JIRA::REST::Class::Issue::Comment> |
1310
|
|
|
|
|
|
|
objects. If called in a scalar context, returns an array reference to the |
1311
|
|
|
|
|
|
|
list, not the number of elements in the list. |
1312
|
|
|
|
|
|
|
|
1313
|
|
|
|
|
|
|
=head2 B<components> |
1314
|
|
|
|
|
|
|
|
1315
|
|
|
|
|
|
|
Returns a list of the issue's components as |
1316
|
|
|
|
|
|
|
L<JIRA::REST::Class::Project::Component|JIRA::REST::Class::Project::Component> |
1317
|
|
|
|
|
|
|
objects. If called in a scalar context, returns an array reference to the |
1318
|
|
|
|
|
|
|
list, not the number of elements in the list. |
1319
|
|
|
|
|
|
|
|
1320
|
|
|
|
|
|
|
=head2 B<component_count> |
1321
|
|
|
|
|
|
|
|
1322
|
|
|
|
|
|
|
Returns a count of the issue's components. |
1323
|
|
|
|
|
|
|
|
1324
|
|
|
|
|
|
|
=head2 B<created> |
1325
|
|
|
|
|
|
|
|
1326
|
|
|
|
|
|
|
Returns the issue's creation date as a L<DateTime|DateTime> object. |
1327
|
|
|
|
|
|
|
|
1328
|
|
|
|
|
|
|
=head2 B<creator> |
1329
|
|
|
|
|
|
|
|
1330
|
|
|
|
|
|
|
Returns the issue's assignee as a |
1331
|
|
|
|
|
|
|
L<JIRA::REST::Class::User|JIRA::REST::Class::User> object. |
1332
|
|
|
|
|
|
|
|
1333
|
|
|
|
|
|
|
=head2 B<description> |
1334
|
|
|
|
|
|
|
|
1335
|
|
|
|
|
|
|
Returns the description of the issue. |
1336
|
|
|
|
|
|
|
|
1337
|
|
|
|
|
|
|
=head2 B<duedate> |
1338
|
|
|
|
|
|
|
|
1339
|
|
|
|
|
|
|
Returns the issue's due date as a L<DateTime|DateTime> object. |
1340
|
|
|
|
|
|
|
|
1341
|
|
|
|
|
|
|
=head2 B<environment> |
1342
|
|
|
|
|
|
|
|
1343
|
|
|
|
|
|
|
Returns the issue's environment as a hash reference. |
1344
|
|
|
|
|
|
|
|
1345
|
|
|
|
|
|
|
TODO: Turn this into an object. |
1346
|
|
|
|
|
|
|
|
1347
|
|
|
|
|
|
|
=head2 B<fixVersions> |
1348
|
|
|
|
|
|
|
|
1349
|
|
|
|
|
|
|
Returns a list of the issue's fixVersions. |
1350
|
|
|
|
|
|
|
|
1351
|
|
|
|
|
|
|
TODO: Turn this into a list of objects. |
1352
|
|
|
|
|
|
|
|
1353
|
|
|
|
|
|
|
=head2 B<issuelinks> |
1354
|
|
|
|
|
|
|
|
1355
|
|
|
|
|
|
|
Returns a list of the issue's links. |
1356
|
|
|
|
|
|
|
|
1357
|
|
|
|
|
|
|
TODO: Turn this into a list of objects. |
1358
|
|
|
|
|
|
|
|
1359
|
|
|
|
|
|
|
=head2 B<issuetype> |
1360
|
|
|
|
|
|
|
|
1361
|
|
|
|
|
|
|
Returns the issue type as a |
1362
|
|
|
|
|
|
|
L<JIRA::REST::Class::Issue::Type|JIRA::REST::Class::Issue::Type> object. |
1363
|
|
|
|
|
|
|
|
1364
|
|
|
|
|
|
|
=head2 B<labels> |
1365
|
|
|
|
|
|
|
|
1366
|
|
|
|
|
|
|
Returns the issue's labels as an array reference. |
1367
|
|
|
|
|
|
|
|
1368
|
|
|
|
|
|
|
=head2 B<lastViewed> |
1369
|
|
|
|
|
|
|
|
1370
|
|
|
|
|
|
|
Returns the issue's last view date as a L<DateTime|DateTime> object. |
1371
|
|
|
|
|
|
|
|
1372
|
|
|
|
|
|
|
=head2 B<parent> |
1373
|
|
|
|
|
|
|
|
1374
|
|
|
|
|
|
|
Returns the issue's parent as a |
1375
|
|
|
|
|
|
|
L<JIRA::REST::Class::Issue|JIRA::REST::Class::Issue> object. |
1376
|
|
|
|
|
|
|
|
1377
|
|
|
|
|
|
|
=head2 B<has_parent> |
1378
|
|
|
|
|
|
|
|
1379
|
|
|
|
|
|
|
Returns a boolean indicating whether the issue has a parent. |
1380
|
|
|
|
|
|
|
|
1381
|
|
|
|
|
|
|
=head2 B<priority> |
1382
|
|
|
|
|
|
|
|
1383
|
|
|
|
|
|
|
Returns the issue's priority as a hash reference. |
1384
|
|
|
|
|
|
|
|
1385
|
|
|
|
|
|
|
TODO: Turn this into an object. |
1386
|
|
|
|
|
|
|
|
1387
|
|
|
|
|
|
|
=head2 B<progress> |
1388
|
|
|
|
|
|
|
|
1389
|
|
|
|
|
|
|
Returns the issue's progress as a hash reference. |
1390
|
|
|
|
|
|
|
|
1391
|
|
|
|
|
|
|
TODO: Turn this into an object. |
1392
|
|
|
|
|
|
|
|
1393
|
|
|
|
|
|
|
=head2 B<project> |
1394
|
|
|
|
|
|
|
|
1395
|
|
|
|
|
|
|
Returns the issue's project as a |
1396
|
|
|
|
|
|
|
L<JIRA::REST::Class::Project|JIRA::REST::Class::Project> object. |
1397
|
|
|
|
|
|
|
|
1398
|
|
|
|
|
|
|
=head2 B<reporter> |
1399
|
|
|
|
|
|
|
|
1400
|
|
|
|
|
|
|
Returns the issue's reporter as a |
1401
|
|
|
|
|
|
|
L<JIRA::REST::Class::User|JIRA::REST::Class::User> object. |
1402
|
|
|
|
|
|
|
|
1403
|
|
|
|
|
|
|
=head2 B<resolution> |
1404
|
|
|
|
|
|
|
|
1405
|
|
|
|
|
|
|
Returns the issue's resolution. |
1406
|
|
|
|
|
|
|
|
1407
|
|
|
|
|
|
|
TODO: Turn this into an object. |
1408
|
|
|
|
|
|
|
|
1409
|
|
|
|
|
|
|
=head2 B<resolutiondate> |
1410
|
|
|
|
|
|
|
|
1411
|
|
|
|
|
|
|
Returns the issue's resolution date as a L<DateTime|DateTime> object. |
1412
|
|
|
|
|
|
|
|
1413
|
|
|
|
|
|
|
=head2 B<status> |
1414
|
|
|
|
|
|
|
|
1415
|
|
|
|
|
|
|
Returns the issue's status as a |
1416
|
|
|
|
|
|
|
L<JIRA::REST::Class::Issue::Status|JIRA::REST::Class::Issue::Status> object. |
1417
|
|
|
|
|
|
|
|
1418
|
|
|
|
|
|
|
=head2 B<summary> |
1419
|
|
|
|
|
|
|
|
1420
|
|
|
|
|
|
|
Returns the summary of the issue. |
1421
|
|
|
|
|
|
|
|
1422
|
|
|
|
|
|
|
=head2 B<timeestimate> |
1423
|
|
|
|
|
|
|
|
1424
|
|
|
|
|
|
|
Returns the time estimate for the issue. |
1425
|
|
|
|
|
|
|
|
1426
|
|
|
|
|
|
|
TODO: Turn this into an object that can return either seconds or a w/d/h/m/s string. |
1427
|
|
|
|
|
|
|
|
1428
|
|
|
|
|
|
|
=head2 B<timeoriginalestimate> |
1429
|
|
|
|
|
|
|
|
1430
|
|
|
|
|
|
|
Returns the time original estimate for the issue. |
1431
|
|
|
|
|
|
|
|
1432
|
|
|
|
|
|
|
TODO: Turn this into an object that can return either seconds or a w/d/h/m/s string. |
1433
|
|
|
|
|
|
|
|
1434
|
|
|
|
|
|
|
=head2 B<timespent> |
1435
|
|
|
|
|
|
|
|
1436
|
|
|
|
|
|
|
Returns the time spent for the issue. |
1437
|
|
|
|
|
|
|
|
1438
|
|
|
|
|
|
|
TODO: Turn this into an object that can return either seconds or a w/d/h/m/s string. |
1439
|
|
|
|
|
|
|
|
1440
|
|
|
|
|
|
|
=head2 B<timetracking> |
1441
|
|
|
|
|
|
|
|
1442
|
|
|
|
|
|
|
Returns the time tracking of the issue as a |
1443
|
|
|
|
|
|
|
L<JIRA::REST::Class::Issue::TimeTracking|JIRA::REST::Class::Issue::TimeTracking> |
1444
|
|
|
|
|
|
|
object. |
1445
|
|
|
|
|
|
|
|
1446
|
|
|
|
|
|
|
=head2 B<transitions> |
1447
|
|
|
|
|
|
|
|
1448
|
|
|
|
|
|
|
Returns the valid transitions for the issue as a |
1449
|
|
|
|
|
|
|
L<JIRA::REST::Class::Issue::Transitions|JIRA::REST::Class::Issue::Transitions> |
1450
|
|
|
|
|
|
|
object. |
1451
|
|
|
|
|
|
|
|
1452
|
|
|
|
|
|
|
=head2 B<updated> |
1453
|
|
|
|
|
|
|
|
1454
|
|
|
|
|
|
|
Returns the issue's updated date as a L<DateTime|DateTime> object. |
1455
|
|
|
|
|
|
|
|
1456
|
|
|
|
|
|
|
=head2 B<versions> |
1457
|
|
|
|
|
|
|
|
1458
|
|
|
|
|
|
|
versions |
1459
|
|
|
|
|
|
|
|
1460
|
|
|
|
|
|
|
=head2 B<votes> |
1461
|
|
|
|
|
|
|
|
1462
|
|
|
|
|
|
|
votes |
1463
|
|
|
|
|
|
|
|
1464
|
|
|
|
|
|
|
=head2 B<watches> |
1465
|
|
|
|
|
|
|
|
1466
|
|
|
|
|
|
|
watches |
1467
|
|
|
|
|
|
|
|
1468
|
|
|
|
|
|
|
=head2 B<worklog> |
1469
|
|
|
|
|
|
|
|
1470
|
|
|
|
|
|
|
Returns the issue's change log as a |
1471
|
|
|
|
|
|
|
L<JIRA::REST::Class::Worklog|JIRA::REST::Class::Worklog> object. |
1472
|
|
|
|
|
|
|
|
1473
|
|
|
|
|
|
|
=head2 B<workratio> |
1474
|
|
|
|
|
|
|
|
1475
|
|
|
|
|
|
|
workratio |
1476
|
|
|
|
|
|
|
|
1477
|
|
|
|
|
|
|
=head2 B<id> |
1478
|
|
|
|
|
|
|
|
1479
|
|
|
|
|
|
|
Returns the issue ID. |
1480
|
|
|
|
|
|
|
|
1481
|
|
|
|
|
|
|
=head2 B<key> |
1482
|
|
|
|
|
|
|
|
1483
|
|
|
|
|
|
|
Returns the issue key. |
1484
|
|
|
|
|
|
|
|
1485
|
|
|
|
|
|
|
=head2 B<self> |
1486
|
|
|
|
|
|
|
|
1487
|
|
|
|
|
|
|
Returns the JIRA REST API's full URL for this issue. |
1488
|
|
|
|
|
|
|
|
1489
|
|
|
|
|
|
|
=head2 B<url> |
1490
|
|
|
|
|
|
|
|
1491
|
|
|
|
|
|
|
Returns the JIRA REST API's URL for this issue in a form used by |
1492
|
|
|
|
|
|
|
L<JIRA::REST::Class|JIRA::REST::Class>. |
1493
|
|
|
|
|
|
|
|
1494
|
|
|
|
|
|
|
=head1 INTERNAL METHODS |
1495
|
|
|
|
|
|
|
|
1496
|
|
|
|
|
|
|
=head2 B<make_object> |
1497
|
|
|
|
|
|
|
|
1498
|
|
|
|
|
|
|
A pass-through method that calls |
1499
|
|
|
|
|
|
|
L<JIRA::REST::Class::Factory::make_object()|JIRA::REST::Class::Factory/make_object>, |
1500
|
|
|
|
|
|
|
but adds a weakened link to this issue in the object as well. |
1501
|
|
|
|
|
|
|
|
1502
|
|
|
|
|
|
|
=head2 B<get> |
1503
|
|
|
|
|
|
|
|
1504
|
|
|
|
|
|
|
Wrapper around C<JIRA::REST::Class>' L<get|JIRA::REST::Class/get> method that |
1505
|
|
|
|
|
|
|
defaults to this issue's URL. Allows for extra parameters to be specified. |
1506
|
|
|
|
|
|
|
|
1507
|
|
|
|
|
|
|
=head2 B<post> |
1508
|
|
|
|
|
|
|
|
1509
|
|
|
|
|
|
|
Wrapper around C<JIRA::REST::Class>' L<post|JIRA::REST::Class/post> method |
1510
|
|
|
|
|
|
|
that defaults to this issue's URL. Allows for extra parameters to be |
1511
|
|
|
|
|
|
|
specified. |
1512
|
|
|
|
|
|
|
|
1513
|
|
|
|
|
|
|
=head2 B<put> |
1514
|
|
|
|
|
|
|
|
1515
|
|
|
|
|
|
|
Wrapper around C<JIRA::REST::Class>' L<put|JIRA::REST::Class/put> method that |
1516
|
|
|
|
|
|
|
defaults to this issue's URL. Allows for extra parameters to be specified. |
1517
|
|
|
|
|
|
|
|
1518
|
|
|
|
|
|
|
=head2 B<delete> |
1519
|
|
|
|
|
|
|
|
1520
|
|
|
|
|
|
|
Wrapper around C<JIRA::REST::Class>' L<delete|JIRA::REST::Class/delete> method |
1521
|
|
|
|
|
|
|
that defaults to this issue's URL. Allows for extra parameters to be |
1522
|
|
|
|
|
|
|
specified. |
1523
|
|
|
|
|
|
|
|
1524
|
|
|
|
|
|
|
=head1 RELATED CLASSES |
1525
|
|
|
|
|
|
|
|
1526
|
|
|
|
|
|
|
=over 2 |
1527
|
|
|
|
|
|
|
|
1528
|
|
|
|
|
|
|
=item * L<JIRA::REST::Class|JIRA::REST::Class> |
1529
|
|
|
|
|
|
|
|
1530
|
|
|
|
|
|
|
=item * L<JIRA::REST::Class::Abstract|JIRA::REST::Class::Abstract> |
1531
|
|
|
|
|
|
|
|
1532
|
|
|
|
|
|
|
=item * L<JIRA::REST::Class::Factory|JIRA::REST::Class::Factory> |
1533
|
|
|
|
|
|
|
|
1534
|
|
|
|
|
|
|
=item * L<JIRA::REST::Class::Factory::make_object|JIRA::REST::Class::Factory::make_object> |
1535
|
|
|
|
|
|
|
|
1536
|
|
|
|
|
|
|
=item * L<JIRA::REST::Class::Issue::Changelog|JIRA::REST::Class::Issue::Changelog> |
1537
|
|
|
|
|
|
|
|
1538
|
|
|
|
|
|
|
=item * L<JIRA::REST::Class::Issue::Comment|JIRA::REST::Class::Issue::Comment> |
1539
|
|
|
|
|
|
|
|
1540
|
|
|
|
|
|
|
=item * L<JIRA::REST::Class::Issue::LinkType|JIRA::REST::Class::Issue::LinkType> |
1541
|
|
|
|
|
|
|
|
1542
|
|
|
|
|
|
|
=item * L<JIRA::REST::Class::Issue::Status|JIRA::REST::Class::Issue::Status> |
1543
|
|
|
|
|
|
|
|
1544
|
|
|
|
|
|
|
=item * L<JIRA::REST::Class::Issue::TimeTracking|JIRA::REST::Class::Issue::TimeTracking> |
1545
|
|
|
|
|
|
|
|
1546
|
|
|
|
|
|
|
=item * L<JIRA::REST::Class::Issue::Transitions|JIRA::REST::Class::Issue::Transitions> |
1547
|
|
|
|
|
|
|
|
1548
|
|
|
|
|
|
|
=item * L<JIRA::REST::Class::Issue::Type|JIRA::REST::Class::Issue::Type> |
1549
|
|
|
|
|
|
|
|
1550
|
|
|
|
|
|
|
=item * L<JIRA::REST::Class::Project|JIRA::REST::Class::Project> |
1551
|
|
|
|
|
|
|
|
1552
|
|
|
|
|
|
|
=item * L<JIRA::REST::Class::Project::Component|JIRA::REST::Class::Project::Component> |
1553
|
|
|
|
|
|
|
|
1554
|
|
|
|
|
|
|
=item * L<JIRA::REST::Class::Sprint|JIRA::REST::Class::Sprint> |
1555
|
|
|
|
|
|
|
|
1556
|
|
|
|
|
|
|
=item * L<JIRA::REST::Class::User|JIRA::REST::Class::User> |
1557
|
|
|
|
|
|
|
|
1558
|
|
|
|
|
|
|
=item * L<JIRA::REST::Class::Worklog|JIRA::REST::Class::Worklog> |
1559
|
|
|
|
|
|
|
|
1560
|
|
|
|
|
|
|
=back |
1561
|
|
|
|
|
|
|
|
1562
|
|
|
|
|
|
|
=head1 AUTHOR |
1563
|
|
|
|
|
|
|
|
1564
|
|
|
|
|
|
|
Packy Anderson <packy@cpan.org> |
1565
|
|
|
|
|
|
|
|
1566
|
|
|
|
|
|
|
=head1 COPYRIGHT AND LICENSE |
1567
|
|
|
|
|
|
|
|
1568
|
|
|
|
|
|
|
This software is Copyright (c) 2017 by Packy Anderson. |
1569
|
|
|
|
|
|
|
|
1570
|
|
|
|
|
|
|
This is free software, licensed under: |
1571
|
|
|
|
|
|
|
|
1572
|
|
|
|
|
|
|
The Artistic License 2.0 (GPL Compatible) |
1573
|
|
|
|
|
|
|
|
1574
|
|
|
|
|
|
|
=cut |