The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Net::Async::Trello - low-level Trello API access

DESCRIPTION

Provides a basic interface for interacting with the Trello webservice.

It's currently a very crude implementation, implementing a small subset of the available API features.

me

Returns profile information for the current user.

boards

Returns a Ryu::Source representing the available boards.

board

Resolves to the board with the corresponding ID.

Takes the following named parameters:

  • id - the board ID to request

Returns a Future.

card

Returns information about a specific card.

Takes the following named parameters:

  • id - the card ID to retrieve

Resolves to a Net::Async::Trello::Card instance.

member

Returns information about a specific person (board/card member).

Takes the following named parameters:

  • id - the ID to retrieve

Resolves to a Net::Async::Trello::Member instance.

Performs a search for Trello objects by string, see https://developers.trello.com/reference/#search for details on search options available.

Example:

 my (%result) = await $trello->search(
  card_fields => [ qw(name url dateLastActivity) ],
  query       => 'Shopping List',
 );
 # print the url of the first card returned.
 my $card = $result{cards}->[0];
 # This should be a Net::Async::Trello::Card instance, so we have a ->url method:
 printf "Card %s url\n", $card->url;

Takes the arguments as shown in the Trello API documentation as named parameters.

The only compulsory argument is query, the text string to search for.

Returns a Future which resolves to a list of key-value pairs. The value will be an instance of the appropriate type, with the exception of options which is a plain hashref.

METHODS - Internal

None of these are likely to be stable or of much use to external callers.

endpoints

endpoint

INHERITED METHODS

IO::Async::Notifier

add_child, adopt_future, adopted_futures, can_event, children, configure_unknown, debug_printf, get_loop, invoke_error, invoke_event, loop, make_event_cb, maybe_invoke_event, maybe_make_event_cb, new, notifier_name, parent, remove_child, remove_from_parent

AUTHOR

Tom Molesworth <TEAM@cpan.org> with contributions from @michaelmueller-binary.

LICENSE

Copyright Tom Molesworth 2014-2020. Licensed under the same terms as Perl itself.