     1: <?php
     2: /**
     3:  * Copyright 2012-2014 Rackspace US, Inc.
     4:  *
     5:  * Licensed under the Apache License, Version 2.0 (the "License");
     6:  * you may not use this file except in compliance with the License.
     7:  * You may obtain a copy of the License at
     8:  *
     9:  * http://www.apache.org/licenses/LICENSE-2.0
    10:  *
    11:  * Unless required by applicable law or agreed to in writing, software
    12:  * distributed under the License is distributed on an "AS IS" BASIS,
    13:  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    14:  * See the License for the specific language governing permissions and
    15:  * limitations under the License.
    16:  */
    17:
    18: namespace OpenCloud\Common\Service;
    19:
    20: use OpenCloud\Common\Exceptions\InvalidArgumentError;
    21:
    22: /**
    23:  * This object represents the service catalog returned by the Rackspace API. It contains all the services available
    24:  * to the end-user, including specific information for each service.
    25:  */
    26: class Catalog
    27: {
    28:     /**
    29:      * @var array Service items
    30:      */
    31:     private $items = array();
    32:
    33:     /**
    34:      * Produces a Catalog from a mixed input.
    35:      *
    36:      * @param  $config
    37:      * @return Catalog
    38:      * @throws \OpenCloud\Common\Exceptions\InvalidArgumentError
    39:      */
    40:     public static function factory($config)
    41:     {
    42:         if (is_array($config)) {
    43:             $catalog = new self();
    44:             foreach ($config as $item) {
    45:                 $catalog->items[] = CatalogItem::factory($item);
    46:             }
    47:         } elseif ($config instanceof Catalog) {
    48:             $catalog = $config;
    49:         } else {
    50:             throw new InvalidArgumentError(sprintf(
    51:                 'Argument for Catalog::factory must be either an array or an '
    52:                 . 'instance of %s. You passed in: %s',
    53:                 get_class(),
    54:                 print_r($config, true)
    55:             ));
    56:         }
    57:
    58:         return $catalog;
    59:     }
    60:
    61:     /**
    62:      * @return array
    63:      */
    64:     public function getItems()
    65:     {
    66:         return $this->items;
    67:     }
    68: }
    69: