Source code for ironic_python_agent.api.controllers.v1.link

# Copyright 2014 Rackspace, Inc.
# All Rights Reserved.
#
#    Licensed under the Apache License, Version 2.0 (the "License"); you may
#    not use this file except in compliance with the License. You may obtain
#    a copy of the License at
#
#         http://www.apache.org/licenses/LICENSE-2.0
#
#    Unless required by applicable law or agreed to in writing, software
#    distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
#    WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
#    License for the specific language governing permissions and limitations
#    under the License.

from wsme import types as wtypes

from ironic_python_agent.api.controllers.v1 import base


class Link(base.APIBase):
    """A link representation."""

    href = wtypes.text
    "The url of a link."

    rel = wtypes.text
    "The name of a link."

    type = wtypes.text
    "Indicates the type of document/link."

    @classmethod
    def make_link(cls, rel_name, url, resource, resource_args,
                  bookmark=False, type=wtypes.Unset):
        template = '%s/%s' if bookmark else '%s/v1/%s'
        # FIXME(lucasagomes): I'm getting a 404 when doing a GET on
        # a nested resource that the URL ends with a  '/'.
        # https://groups.google.com/forum/#!topic/pecan-dev/QfSeviLg5qs
        template += '%s' if resource_args.startswith('?') else '/%s'

        return Link(href=(template) % (url, resource, resource_args),
                    rel=rel_name, type=type)