NAME

WWW::Gitea::API::Milestones - Gitea repository milestones API

VERSION

version 0.001

SYNOPSIS

my $milestones = $gitea->milestones->list('getty', 'p5-www-gitea');

my $ms = $gitea->milestones->create('getty', 'p5-www-gitea',
    title => 'v1.0', description => 'First stable release',
);

DESCRIPTION

Controller for the Gitea repository milestones API. Reached via $gitea->milestones. Milestones are addressed by their numeric id.

client

The parent WWW::Gitea client providing HTTP transport.

openapi_operations

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

list

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

Lists milestones. Accepts the Gitea query parameters (stateopen/closed/all, name, page, limit). Returns an ArrayRef of WWW::Gitea::Milestone.

create

my $ms = $gitea->milestones->create('getty', 'p5-www-gitea',
    title => 'v1.0', description => '...', due_on => '2026-12-31T00:00:00Z');

Creates a milestone. title is required. Returns a WWW::Gitea::Milestone.

get

my $ms = $gitea->milestones->get('getty', 'p5-www-gitea', 1);

Fetches a milestone by id. Returns a WWW::Gitea::Milestone.

edit

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

Edits a milestone (title, description, state, due_on). Returns the updated WWW::Gitea::Milestone.

delete

$gitea->milestones->delete('getty', 'p5-www-gitea', 1);

Deletes a milestone. Returns a true value on success.

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.