/usr/share/perl5/Pithub/Repos/Statuses.pm is in libpithub-perl 0.01033-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 | package Pithub::Repos::Statuses;
$Pithub::Repos::Statuses::VERSION = '0.01033';
our $AUTHORITY = 'cpan:PLU';
# ABSTRACT: Github v3 repos / statuses API
use Moo;
use Carp qw(croak);
extends 'Pithub::Base';
sub list {
my ($self, %args) = @_;
$self->_validate_user_repo_args( \%args );
my $req = {
method => 'GET',
path => sprintf(
'/repos/%s/%s/statuses/%s',
delete $args{user}, delete $args{repo}, delete $args{ref}
),
%args
};
return $self->request(%$req);
}
sub create {
my ($self, %args) = @_;
$self->_validate_user_repo_args( \%args );
croak 'Missing state paramenter. Must be one of pending, success, error or failure'
unless $args{data}->{state};
unless ($args{data}->{state} =~ m/^(?:pending|success|error|failure)$/) {
croak 'state param must be one of pending, success, error, failure. Was ' .
$args{data}->{state};
}
my $req = {
method => 'POST',
path => sprintf(
'/repos/%s/%s/statuses/%s',
delete $args{user}, delete $args{repo}, delete $args{sha},
),
%args
};
return $self->request(%$req);
}
1;
__END__
=pod
=encoding UTF-8
=head1 NAME
Pithub::Repos::Statuses - Github v3 repos / statuses API
=head1 VERSION
version 0.01033
=head1 METHODS
=head2 list
Extra arguments
=over
=item * ref
The SHA, branch, or tag-name to get statuses for
=back
List statuses for a ref
GET /repos/:user/:repo/statuses/:ref
Examples:
my $statuses = Pithub::Repos::Statuses->new;
my $result = $statuses->list( ref => 'master' );
=head2 create
Extra arguments
=over
=item state (required)
The state of the status. Can be one of 'pending', 'success', 'error' or 'failure'.
=item target_url
This URL will be used to link from the status to some related page, for instance
the build result for this specific SHA.
=item description
A short description of the status
=back
Add a status to a SHA.
POST /repos/:user/:repo/statuses/:sha
Examples:
my $statuses = Pithub::Repos::Statuses->new;
my $result = $statuses->create( user => 'plu', repo => 'Pithub',
sha => '0123456',
data => {
state => 'error',
description => 'Build failed',
target_url => 'https://travis-ci.org/some/url/0123456',
},
);
=head1 AUTHOR
Johannes Plunien <plu@cpan.org>
=head1 COPYRIGHT AND LICENSE
This software is copyright (c) 2011 by Johannes Plunien.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
=cut
|