78 lines
2.5 KiB
Python
78 lines
2.5 KiB
Python
# Copyright 2017 AT&T Intellectual Property. All other 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.
|
|
|
|
import falcon
|
|
|
|
from promenade.control.base import BaseResource, PromenadeRequest
|
|
from promenade.control.health_api import HealthResource
|
|
from promenade.control.join_scripts import JoinScriptsResource
|
|
from promenade.control.middleware import (AuthMiddleware, ContextMiddleware,
|
|
LoggingMiddleware)
|
|
from promenade import exceptions as exc
|
|
from promenade import logging
|
|
|
|
LOG = logging.getLogger(__name__)
|
|
|
|
|
|
def start_api():
|
|
middlewares = [
|
|
AuthMiddleware(),
|
|
ContextMiddleware(),
|
|
LoggingMiddleware(),
|
|
]
|
|
control_api = falcon.API(
|
|
request_type=PromenadeRequest, middleware=middlewares)
|
|
|
|
# v1.0 of Promenade API
|
|
v1_0_routes = [
|
|
# API for managing region data
|
|
('/health', HealthResource()),
|
|
('/join-scripts', JoinScriptsResource()),
|
|
]
|
|
|
|
# Set up the 1.0 routes
|
|
route_v1_0_prefix = '/api/v1.0'
|
|
for path, res in v1_0_routes:
|
|
route = '{}{}'.format(route_v1_0_prefix, path)
|
|
LOG.info('Adding route: %s Handled by %s', route,
|
|
res.__class__.__name__)
|
|
control_api.add_route(route, res)
|
|
|
|
control_api.add_route('/versions', VersionsResource())
|
|
|
|
# Error handlers (FILO handling)
|
|
control_api.add_error_handler(Exception, exc.default_exception_handler)
|
|
control_api.add_error_handler(exc.PromenadeException,
|
|
exc.PromenadeException.handle)
|
|
|
|
# built-in error serializer
|
|
control_api.set_error_serializer(exc.default_error_serializer)
|
|
|
|
return control_api
|
|
|
|
|
|
class VersionsResource(BaseResource):
|
|
"""
|
|
Lists the versions supported by this API
|
|
"""
|
|
|
|
def on_get(self, req, resp):
|
|
resp.body = self.to_json({
|
|
'v1.0': {
|
|
'path': '/api/v1.0',
|
|
'status': 'stable'
|
|
}
|
|
})
|
|
resp.status = falcon.HTTP_200
|