Scroll to navigation

Pithub::Issues::Labels(3pm) User Contributed Perl Documentation Pithub::Issues::Labels(3pm)

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.

2023-09-02 perl v5.36.0