*****************
Top-level objects
*****************

Every web service has a top-level "root" object.

    >>> from lazr.restfulclient.tests.example import CookbookWebServiceClient
    >>> service = CookbookWebServiceClient()

The root object provides access to service-wide objects.

    >>> sorted(service.lp_entries)
    ['featured_cookbook']

    >>> sorted(service.lp_collections)
    ['cookbooks', 'dishes', 'recipes']


Top-level entries
=================

You can access a top-level entry through attribute access.

    >>> print service.featured_cookbook.name
    Mastering the Art of French Cooking


Top-level collections
=====================

You can access a top-level collection through attribute access.

    >>> len(service.dishes)
    3

Specific top-level collections may support key-based lookups. For
instance, the recipe collection does lookups by recipe ID. This is
custom code written for this specific web service, and it won't work
in general.

    >>> print service.recipes[1].dish.name
    Roast chicken
