def upload_local_artifacts(resource_id, resource_dict, property_name,
parent_dir, uploader):
"""
Upload local artifacts referenced by the property at given resource and
return S3 URL of the uploaded object. It is the responsibility of callers
to ensure property value is a valid string
If path refers to a file, this method will upload the file. If path refers
to a folder, this method will zip the folder and upload the zip to S3.
If path is omitted, this method will zip the current working folder and
upload.
If path is already a path to S3 object, this method does nothing.
:param resource_id: Id of the CloudFormation resource
:param resource_dict: Dictionary containing resource definition
:param property_name: Property name of CloudFormation resource where this
local path is present
:param parent_dir: Resolve all relative paths with respect to this
directory
:param uploader: Method to upload files to S3
:return: S3 URL of the uploaded object
:raise: ValueError if path is not a S3 URL or a local path
"""
local_path = resource_dict.get(property_name, None)
if local_path is None:
# Build the root directory and upload to S3
local_path = parent_dir
if is_s3_url(local_path):
# A valid CloudFormation template will specify artifacts as S3 URLs.
# This check is supporting the case where your resource does not
# refer to local artifacts
# Nothing to do if property value is an S3 URL
LOG.debug("Property {0} of {1} is already a S3 URL"
.format(property_name, resource_id))
return local_path
local_path = make_abs_path(parent_dir, local_path)
# Or, pointing to a folder. Zip the folder and upload
if is_local_folder(local_path):
return zip_and_upload(local_path, uploader)
# Path could be pointing to a file. Upload the file
elif is_local_file(local_path):
return uploader.upload_with_dedup(local_path)
raise exceptions.InvalidLocalPathError(
resource_id=resource_id,
property_name=property_name,
local_path=local_path)
def include_transform_export_handler(template_dict, uploader, parent_dir):
if template_dict.get("Name", None) != "AWS::Include":
return template_dict
include_location = template_dict.get("Parameters", {}).get("Location", None)
if not include_location or is_s3_url(include_location):
return template_dict
abs_include_location = os.path.join(parent_dir, include_location)
if is_local_file(abs_include_location):
template_dict["Parameters"]["Location"] = uploader.upload_with_dedup(abs_include_location)
else:
raise exceptions.InvalidLocalPathError(
resource_id="AWS::Include",
property_name="Location",
local_path=abs_include_location)
return template_dict
def include_transform_export_handler(template_dict, uploader, parent_dir):
if template_dict.get("Name", None) != "AWS::Include":
return template_dict
include_location = template_dict.get("Parameters", {}).get("Location", None)
if not include_location \
or not is_path_value_valid(include_location) \
or is_s3_url(include_location):
# `include_location` is either empty, or not a string, or an S3 URI
return template_dict
# We are confident at this point that `include_location` is a string containing the local path
abs_include_location = os.path.join(parent_dir, include_location)
if is_local_file(abs_include_location):
template_dict["Parameters"]["Location"] = uploader.upload_with_dedup(abs_include_location)
else:
raise exceptions.InvalidLocalPathError(
resource_id="AWS::Include",
property_name="Location",
local_path=abs_include_location)
return template_dict
