summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorNaveed Massjouni <naveedm9@gmail.com>2011-03-22 11:46:00 -0400
committerNaveed Massjouni <naveedm9@gmail.com>2011-03-22 11:46:00 -0400
commit4e33ab9fc16d580fbcf57da8e6e2228ad27cc1af (patch)
tree97b6ae63d94a066591d63e78d685950d8446ee57
parent59cb754cc37635f79fc26d4596699705143f4544 (diff)
downloadnova-4e33ab9fc16d580fbcf57da8e6e2228ad27cc1af.tar.gz
nova-4e33ab9fc16d580fbcf57da8e6e2228ad27cc1af.tar.xz
nova-4e33ab9fc16d580fbcf57da8e6e2228ad27cc1af.zip
Adding more docstrings. image_id and instance_type fields of an instance will
always exist, so no reason to check if keys exist.
-rw-r--r--nova/api/openstack/__init__.py4
-rw-r--r--nova/api/openstack/views/servers.py25
2 files changed, 16 insertions, 13 deletions
diff --git a/nova/api/openstack/__init__.py b/nova/api/openstack/__init__.py
index 35b04f863..21d354f1c 100644
--- a/nova/api/openstack/__init__.py
+++ b/nova/api/openstack/__init__.py
@@ -131,6 +131,8 @@ class APIRouter(wsgi.Router):
class APIRouterV10(APIRouter):
+ ''' Defines routes specific to OpenStack API V1.0 '''
+
def _setup_routes(self, mapper):
APIRouter._setup_routes(self, mapper)
mapper.resource("server", "servers",
@@ -140,6 +142,8 @@ class APIRouterV10(APIRouter):
class APIRouterV11(APIRouter):
+ ''' Defines routes specific to OpenStack API V1.1 '''
+
def _setup_routes(self, mapper):
APIRouter._setup_routes(self, mapper)
mapper.resource("server", "servers",
diff --git a/nova/api/openstack/views/servers.py b/nova/api/openstack/views/servers.py
index 078d5d484..3100c46b5 100644
--- a/nova/api/openstack/views/servers.py
+++ b/nova/api/openstack/views/servers.py
@@ -34,19 +34,18 @@ class ViewBuilder(object):
self.addresses_builder = addresses_builder
def build(self, inst, is_detail):
- """
- Coerces into dictionary format, mapping everything to
- Rackspace-like attributes for return
- """
+ ''' Returns a dict that represenst a server '''
if is_detail:
return self._build_detail(inst)
else:
return self._build_simple(inst)
def _build_simple(self, inst):
- return dict(server=dict(id=inst['id'], name=inst['display_name']))
+ ''' Returns a simple model of a server '''
+ return dict(server=dict(id=inst['id'], name=inst['display_name']))
def _build_detail(self, inst):
+ ''' Returns a detailed model of a server '''
power_mapping = {
None: 'build',
power_state.NOSTATE: 'build',
@@ -81,36 +80,36 @@ class ViewBuilder(object):
return dict(server=inst_dict)
def _build_image(self, response, inst):
+ ''' Returns the image sub-resource of a server '''
raise NotImplementedError()
def _build_flavor(self, response, inst):
+ ''' Returns the flavor sub-resource of a server '''
raise NotImplementedError()
class ViewBuilderV10(ViewBuilder):
+ ''' Models an Openstack API V1.0 server response '''
+
def _build_image(self, response, inst):
- if inst.get('image_id') != None:
- response['imageId'] = inst['image_id']
+ response['imageId'] = inst['image_id']
def _build_flavor(self, response, inst):
- if inst.get('instance_type') != None:
- response['flavorId'] = inst['instance_type']
+ response['flavorId'] = inst['instance_type']
class ViewBuilderV11(ViewBuilder):
+ ''' Models an Openstack API V1.0 server response '''
+
def __init__(self, addresses_builder, flavor_builder, image_builder):
ViewBuilder.__init__(self, addresses_builder)
self.flavor_builder = flavor_builder
self.image_builder = image_builder
def _build_image(self, response, inst):
- if inst.get('image_id') == None:
- return
image_id = inst["image_id"]
response["imageRef"] = self.image_builder.generate_href(image_id)
def _build_flavor(self, response, inst):
- if inst.get('instance_type') == None:
- return
flavor_id = inst["instance_type"]
response["flavorRef"] = self.flavor_builder.generate_href(flavor_id)