NAME

Pithub::Issues::Labels - Github v3 Issue Labels API

VERSION

version 0.01041

METHODS

add

• Add labels to an issue

  
              
  
                
                
  POST /repos/:user/:repo/issues/:id/labels
              
            

  Examples:

  
              
  
                
                
  my $l = Pithub::Issues::Labels->new;
  my $result = $l->add(
      repo     => 'Pithub',
      user     => 'plu',
      issue_id => 1,
      data     => ['Label1', 'Label2'],
  );
              
            

create

• Create a label

  
              
  
                
                
  POST /repos/:user/:repo/labels
              
            

  Examples:

  
              
  
                
                
  my $l = Pithub::Issues::Labels->new;
  my $result = $l->create(
      repo => 'Pithub',
      user => 'plu',
      data => {
          color => 'FFFFFF',
          name  => 'some label',
      }
  );
              
            

delete

• Delete a label

  
              
  
                
                
  DELETE /repos/:user/:repo/labels/:id
              
            

  Examples:

  
              
  
                
                
  my $l = Pithub::Issues::Labels->new;
  my $result = $l->delete(
      repo     => 'Pithub',
      user     => 'plu',
      label => 1,
  );
              
            

get

• Get a single label

  
              
  
                
                
  GET /repos/:user/:repo/labels/:id
              
            

  Examples:

  
              
  
                
                
  my $l = Pithub::Issues::Labels->new;
  my $result = $l->get(
      repo => 'Pithub',
      user => 'plu',
      label => 1,
  );
              
            

list

• List all labels for this repository

  
              
  
                
                
  GET /repos/:user/:repo/labels
              
            

  Examples:

  
              
  
                
                
  my $l = Pithub::Issues::Labels->new;
  my $result = $l->list(
      repo => 'Pithub',
      user => 'plu'
  );
              
            

• List labels on an issue

  
              
  
                
                
  GET /repos/:user/:repo/issues/:id/labels
              
            

  Examples:

  
              
  
                
                
  my $l = Pithub::Issues::Labels->new;
  my $result = $l->list(
      repo     => 'Pithub',
      user     => 'plu',
      issue_id => 1,
  );
              
            

• Get labels for every issue in a milestone

  
              
  
                
                
  GET /repos/:user/:repo/milestones/:id/labels
              
            

  Examples:

  
              
  
                
                
  my $l = Pithub::Issues::Labels->new;
  my $result = $l->get(
      repo         => 'Pithub',
      user         => 'plu',
      milestone_id => 1
  );
              
            

remove

• Remove a label from an issue

  
              
  
                
                
  DELETE /repos/:user/:repo/issues/:id/labels/:id
              
            

  Examples:

  
              
  
                
                
  my $l = Pithub::Issues::Labels->new;
  my $result = $l->delete(
      repo     => 'Pithub',
      user     => 'plu',
      issue_id => 1,
      label => 1,
  );
              
            

• Remove all labels from an issue

  
              
  
                
                
  DELETE /repos/:user/:repo/issues/:id/labels
              
            

  Examples:

  
              
  
                
                
  my $l = Pithub::Issues::Labels->new;
  my $result = $l->delete(
      repo     => 'Pithub',
      user     => 'plu',
      issue_id => 1,
  );
              
            

replace

• Replace all labels for an issue

  
              
  
                
                
  PUT /repos/:user/:repo/issues/:id/labels
              
            

  Examples:

  
              
  
                
                
  my $l = Pithub::Issues::Labels->new;
  my $result = $l->replace(
      repo     => 'Pithub',
      user     => 'plu',
      issue_id => 1,
      data     => [qw(label3 label4)],
  );
              
            

update

• Update a label

  
              
  
                
                
  PATCH /repos/:user/:repo/labels/:id
              
            

  Examples:

  
              
  
                
                
  my $l = Pithub::Issues::Labels->new;
  my $result = $l->update(
      repo     => 'Pithub',
      user     => 'plu',
      label => 1,
      data     => {
          color => 'FFFFFF',
          name  => 'API',
      }
  );
              
            

AUTHOR

Johannes Plunien <plu@cpan.org>

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.