/ 
WWW-Gitea-0.001
/ WWW::Gitea::API::Issues

NAME

WWW::Gitea::API::Issues - Gitea issues API (issues and issue comments)

VERSION

version 0.001

SYNOPSIS

my $issues = $gitea->issues->list('getty', 'p5-www-gitea', state => 'open');

my $issue = $gitea->issues->create('getty', 'p5-www-gitea',
    title => 'Bug', body => '...', labels => [1, 2],
);

my $c = $gitea->issues->create_comment('getty', 'p5-www-gitea',
    $issue->number, 'thanks for the report');

DESCRIPTION

Controller for the Gitea issues API, including issue comments. Reached via $gitea->issues. Issues are addressed by their per-repository index (the number you see in the UI).

client

The parent WWW::Gitea client providing HTTP transport.

openapi_operations

Pre-computed operation table (operationId → {method, path}).

list

my $issues = $gitea->issues->list('getty', 'p5-www-gitea',
    state => 'open', labels => 'bug', limit => 50);

Lists issues in a repository. Accepts the Gitea query parameters (state — open/closed/all, labels, q, type — issues/pulls, milestones, page, limit). Returns an ArrayRef of WWW::Gitea::Issue.

create

my $issue = $gitea->issues->create('getty', 'p5-www-gitea',
    title    => 'Bug report',
    body     => 'It broke',
    labels   => [1, 2],          # label IDs
    assignees => ['getty'],
    milestone => 42,
);

Creates an issue. title is required; other arguments are passed through as the JSON body. Returns a WWW::Gitea::Issue.

get

my $issue = $gitea->issues->get('getty', 'p5-www-gitea', 7);

Fetches an issue by its repository index. Returns a WWW::Gitea::Issue.

edit

$gitea->issues->edit('getty', 'p5-www-gitea', 7, state => 'closed');

Edits an issue (title, body, state — open/closed, assignees, milestone, ...). Arguments are passed through as the JSON body. Returns the updated WWW::Gitea::Issue.

my $issues = $gitea->issues->search(q => 'crash', state => 'open');

Searches issues across all accessible repositories (GET /repos/issues/search). Accepts the Gitea query parameters (state, labels, milestones, q, type, owner, team, page, limit). Returns an ArrayRef of WWW::Gitea::Issue.

comments

my $comments = $gitea->issues->comments('getty', 'p5-www-gitea', 7);

Lists the comments on an issue. Returns an ArrayRef of WWW::Gitea::Comment.

create_comment

my $comment = $gitea->issues->create_comment(
    'getty', 'p5-www-gitea', 7, 'thanks!');

Adds a comment to an issue. Returns the new WWW::Gitea::Comment.

SEE ALSO

SUPPORT

Issues

Please report bugs and feature requests on GitHub at https://codeberg.org/getty/p5-www-gitea/issues.

CONTRIBUTING

Contributions are welcome! Please fork the repository and submit a pull request.

AUTHOR

Torsten Raudssus <torsten@raudssus.de> https://raudssus.de/

COPYRIGHT AND LICENSE

This software is copyright (c) 2026 by Torsten Raudssus.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.