/ 
Webservice-Rosary-API-0.1.7
/ Webservice::Rosary::Tradition

NAME

Webservice::Rosary::Tradition - local devotional metadata for the Rosary client

SYNOPSIS

use Webservice::Rosary::Tradition qw/opening_intention pope_name/;

say pope_name();
say opening_intention('our__father_1');
say opening_intention('hail__mary_1');

DESCRIPTION

The upstream Rosary API supplies the prayer text and detailed information for individual Mysteries, including their titles and fruits. Some traditional presentation metadata used by the avemaria commandline client is not part of the upstream API response.

This module keeps that local devotional metadata separate from Webservice::Rosary::API so the API wrapper continues to represent the remote service accurately.

At present the introductory Our Father is identified as being offered for the intentions and well-being of Pope Leo XIV, and the first three Hail Marys are offered for an increase in Faith, Hope, and Charity.

FUNCTIONS

pope_name

Returns the name used by the client when presenting the introductory papal intention. Keeping the name here makes a future update a single, explicit change.

opening_intention

my $text = opening_intention('hail__mary_2');

Returns the local intention associated with an introductory prayer key, or an empty string when the prayer has no local introductory intention.

The currently recognized keys are our__father_1, hail__mary_1, hail__mary_2, and hail__mary_3.

LICENSE AND COPYRIGHT

Same as Perl.