98 lines
3.7 KiB
Python
Raw Normal View History

# 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 os.path
import yaml
import zipfile
from toscaparser.common.exception import ValidationError
from toscaparser.utils.gettextutils import _
class CSAR(object):
def __init__(self, csar_file):
self.csar_file = csar_file
self.is_validated = False
def validate(self):
"""Validate the provided CSAR file."""
self.is_validated = True
# validate that the file exists
if not os.path.isfile(self.csar_file):
err_msg = (_('The file %s does not exist.') % self.csar_file)
raise ValidationError(message=err_msg)
# validate that it is a valid zip file
if not zipfile.is_zipfile(self.csar_file):
err_msg = (_('The file %s is not a valid zip file.')
% self.csar_file)
raise ValidationError(message=err_msg)
# validate that it contains the metadata file in the correct location
self.zfile = zipfile.ZipFile(self.csar_file, 'r')
filelist = self.zfile.namelist()
if 'TOSCA-Metadata/TOSCA.meta' not in filelist:
err_msg = (_('The file %s is not a valid CSAR as it does not '
'contain the required file "TOSCA.meta" in the '
'folder "TOSCA-Metadata".') % self.csar_file)
raise ValidationError(message=err_msg)
# validate that 'Entry-Definitions' property exists in TOSCA.meta
data = self.zfile.read('TOSCA-Metadata/TOSCA.meta')
meta = yaml.load(data)
if type(meta) is not dict:
err_msg = (_('The file "TOSCA-Metadata/TOSCA.meta" in %s does not '
'contain valid YAML content.') % self.csar_file)
raise ValidationError(message=err_msg)
self.metadata = meta
if 'Entry-Definitions' not in self.metadata:
err_msg = (_('The CSAR file "%s" is missing the required metadata '
'"Entry-Definitions" in "TOSCA-Metadata/TOSCA.meta".')
% self.csar_file)
raise ValidationError(message=err_msg)
# validate that 'Entry-Definitions' metadata value points to an
# existing file in the CSAR
entry = self.metadata['Entry-Definitions']
if entry not in filelist:
err_msg = (_('The "Entry-Definitions" file defined in the CSAR '
'"%s" does not exist.') % self.csar_file)
raise ValidationError(message=err_msg)
def get_metadata(self):
"""Return the metadata dictionary."""
# validate the csar if not already validated
if not self.is_validated:
self.validate()
# return a copy to avoid changes overwrite the original
return dict(self.metadata) if self.metadata else None
def _get_metadata(self, key):
if not self.is_validated:
self.validate()
return self.metadata[key] if key in self.metadata else None
def get_author(self):
return self._get_metadata('Created-By')
def get_version(self):
return self._get_metadata('CSAR-Version')
def get_main_template(self):
return self._get_metadata('Entry-Definitions')