docs: def build_swagger_12_api_declaration(resource_name, api_declaration):
      """
      :param resource_name: The `path` parameter from the resource listing for
          this resource.
      :type resource_name: string
      :param api_declaration: JSON representing a Swagger 1.2 api declaration
      :type api_declaration: dict
      :rtype: :class:`pyramid_swagger.model.PyramidEndpoint`
      """
      # NOTE: This means our resource paths are currently constrained to be valid
      # pyramid routes! (minus the leading /)
      route_name = 'pyramid_swagger.swagger12.apidocs-{0}'.format(resource_name)
      return PyramidEndpoint(
          path='/{0}'.format(resource_name),
          route_name=route_name,
          view=build_swagger_12_api_declaration_view(api_declaration),
          renderer='json')