NAME

WWW::Gitea::Issue - Gitea issue entity

VERSION

version 0.001

SYNOPSIS

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

print $issue->number, " ", $issue->title, " [", $issue->state, "]\n";

$issue->add_comment('looking into it');
$issue->close;

DESCRIPTION

Lightweight wrapper around the JSON returned for a Gitea issue. Lifecycle methods ("edit", "close", "add_comment", ...) delegate back to the client's WWW::Gitea::API::Issues controller. The owning repository is taken from the explicit "owner"/"repo" passed at construction, falling back to the repository block embedded in the issue JSON. The raw decoded data is always available via "data".

data

Raw decoded JSON for the issue. Writable so "refresh" and "edit" can update it in place.

owner

Owner of the repository this issue belongs to. Optional; falls back to the embedded data->{repository}{owner}.

repo

Name of the repository this issue belongs to. Optional; falls back to the embedded data->{repository}{name}.

id

Global numeric issue ID.

number

Per-repository issue index (the number shown in the UI).

title

Issue title.

body

Issue body (Markdown).

state

open or closed.

html_url

Web URL of the issue.

created_at

ISO-8601 creation timestamp.

updated_at

ISO-8601 last-update timestamp.

comments_count

Number of comments on the issue.

user_login

Login name of the issue's author.

label_names

my $names = $issue->label_names;

Returns an ArrayRef of the issue's label names.

assignee_logins

my $logins = $issue->assignee_logins;

Returns an ArrayRef of the assignees' login names.

refresh

$issue->refresh;

Re-fetches the issue and updates "data" in place.

edit

$issue->edit(title => 'New title');

Edits the issue and updates "data" in place.

close

$issue->close;

Closes the issue (shortcut for $issue->edit(state => 'closed')).

reopen

$issue->reopen;

Reopens the issue (shortcut for $issue->edit(state => 'open')).

add_comment

my $comment = $issue->add_comment('thanks for the report');

Adds a comment to the 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.