NAME

WWW::Restaurant::Menu - An abstract Perl base class for querying online menus of restaurants.

VERSION

0.11

SYNOPSIS

Online restaurant menu querying:

    use WWW::Restaurant::Menu;
    
    # Construction:
    my $menu = WWW::Restaurant::Menu->new(%options);
    
    # Get all menu items, in order:
    my @items       = $menu->items;
    
    # Get menu items by class:
    my @starters    = $menu->starters;
    my @meals       = $menu->meals;
    my @desserts    = $menu->desserts;
    my @drinks      = $menu->drinks;
    
    # Get currency of item prices:
    my $currency    = $menu->currency;

Deriving new restaurant menu classes:

    package WWW::Restaurant::<CC>::<City>::<Restaurant>::Menu[::<Submenu>];
    # CC          ISO 3166 "alpha 2" country code
    #             <http://ftp.ics.uci.edu/pub/ietf/http/related/iso3166.txt>.
    # City        Name of the city where the restaurant is located.
    # Restaurant  Name of the restaurant (unique within that city, if possible).
    # Submenu     A special menu, like "Breakfast", "Lunch", "HappyHour"...

    use base qw(WWW::Restaurant::Menu);
    
    sub currency {
        return "$some_currency";  # Return currency of item prices.
    }
    
    sub query {
        my ($self) = @_;
        # Populate $self->{items} with WWW::Restaurant::Menu::Item objects:
        ...
        return $self->{items};
    }

DESCRIPTION

This is an abstract Perl base class for querying online menus of restaurants. It should be sub-classed for functionality specific to restaurants.

Constructor

The following constructor is provided:

new(%options): RETURNS WWW::Restaurant::Menu

Creates a new WWW::Restaurant::Menu object from the given options. No options are supported by this base class.

Instance methods

The following instance methods are provided:

items: RETURNS (WWW::Restaurant::Menu::Item, ...)

Returns a list of WWW::Restaurant::Menu::Item (or derivative) objects representing all the items on this menu, in the order they appear on the menu.

starters: RETURNS (WWW::Restaurant::Menu::Item::Starter, ...)

meals: RETURNS (WWW::Restaurant::Menu::Item::Meal, ...)

desserts: RETURNS (WWW::Restaurant::Menu::Item::Dessert, ...)

drinks: RETURNS (WWW::Restaurand::Menu::Item::Drink, ...)

Returns a list of objects representing the items of the requested class that are on this menu, in the order they appear on the menu.

currency: RETURNS SCALAR

Returns a string denoting the currency of the item prices on the menu.

SEE ALSO

For COPYRIGHT and LICENSE information, see WWW::Restaurant::Menu::Overview.

AUTHOR

Julian Mehnle <julian@mehnle.net>