synapse-old/synapse/rest/media/v1/filepath.py

214 lines
7.3 KiB
Python
Raw Normal View History

# -*- coding: utf-8 -*-
2016-01-06 21:26:29 -07:00
# Copyright 2014-2016 OpenMarket Ltd
#
# 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
import re
2017-10-12 10:31:24 -06:00
import functools
NEW_FORMAT_ID_RE = re.compile(r"^\d\d\d\d-\d\d-\d\d")
2017-10-12 10:31:24 -06:00
def _wrap_in_base_path(func):
"""Takes a function that returns a relative path and turns it into an
absolute path based on the location of the primary media store
"""
@functools.wraps(func)
def _wrapped(self, *args, **kwargs):
path = func(self, *args, **kwargs)
2017-10-13 04:42:07 -06:00
return os.path.join(self.base_path, path)
2017-10-12 10:31:24 -06:00
return _wrapped
class MediaFilePaths(object):
2017-10-12 10:31:24 -06:00
"""Describes where files are stored on disk.
2017-10-12 11:16:25 -06:00
Most of the functions have a `*_rel` variant which returns a file path that
2017-10-12 10:31:24 -06:00
is relative to the base media store path. This is mainly used when we want
to write to the backup media store (when one is configured)
"""
2017-10-12 10:31:24 -06:00
def __init__(self, primary_base_path):
2017-10-13 04:42:07 -06:00
self.base_path = primary_base_path
2017-10-12 10:31:24 -06:00
def default_thumbnail_rel(self, default_top_level, default_sub_type, width,
height, content_type, method):
2014-12-10 07:46:55 -07:00
top_level_type, sub_type = content_type.split("/")
file_name = "%i-%i-%s-%s-%s" % (
width, height, top_level_type, sub_type, method
)
return os.path.join(
2017-10-12 10:31:24 -06:00
"default_thumbnails", default_top_level,
2014-12-10 07:46:55 -07:00
default_sub_type, file_name
)
2017-10-12 10:31:24 -06:00
default_thumbnail = _wrap_in_base_path(default_thumbnail_rel)
def local_media_filepath_rel(self, media_id):
return os.path.join(
2017-10-12 10:31:24 -06:00
"local_content",
media_id[0:2], media_id[2:4], media_id[4:]
)
2017-10-12 10:31:24 -06:00
local_media_filepath = _wrap_in_base_path(local_media_filepath_rel)
def local_media_thumbnail_rel(self, media_id, width, height, content_type,
method):
top_level_type, sub_type = content_type.split("/")
2014-12-10 07:46:55 -07:00
file_name = "%i-%i-%s-%s-%s" % (
width, height, top_level_type, sub_type, method
)
return os.path.join(
2017-10-12 10:31:24 -06:00
"local_thumbnails",
media_id[0:2], media_id[2:4], media_id[4:],
file_name
)
2017-10-12 10:31:24 -06:00
local_media_thumbnail = _wrap_in_base_path(local_media_thumbnail_rel)
def remote_media_filepath_rel(self, server_name, file_id):
return os.path.join(
2017-10-12 10:31:24 -06:00
"remote_content", server_name,
file_id[0:2], file_id[2:4], file_id[4:]
)
2017-10-12 10:31:24 -06:00
remote_media_filepath = _wrap_in_base_path(remote_media_filepath_rel)
def remote_media_thumbnail_rel(self, server_name, file_id, width, height,
content_type, method):
top_level_type, sub_type = content_type.split("/")
file_name = "%i-%i-%s-%s" % (width, height, top_level_type, sub_type)
return os.path.join(
2017-10-12 10:31:24 -06:00
"remote_thumbnail", server_name,
file_id[0:2], file_id[2:4], file_id[4:],
file_name
)
2016-06-29 07:57:59 -06:00
2017-10-12 10:31:24 -06:00
remote_media_thumbnail = _wrap_in_base_path(remote_media_thumbnail_rel)
2016-06-29 07:57:59 -06:00
def remote_media_thumbnail_dir(self, server_name, file_id):
return os.path.join(
2017-10-13 04:42:07 -06:00
self.base_path, "remote_thumbnail", server_name,
2016-06-29 07:57:59 -06:00
file_id[0:2], file_id[2:4], file_id[4:],
)
2017-10-12 10:31:24 -06:00
def url_cache_filepath_rel(self, media_id):
if NEW_FORMAT_ID_RE.match(media_id):
# Media id is of the form <DATE><RANDOM_STRING>
# E.g.: 2017-09-28-fsdRDt24DS234dsf
return os.path.join(
2017-10-12 10:31:24 -06:00
"url_cache",
media_id[:10], media_id[11:]
)
else:
return os.path.join(
2017-10-12 10:31:24 -06:00
"url_cache",
media_id[0:2], media_id[2:4], media_id[4:],
)
2017-10-12 10:31:24 -06:00
url_cache_filepath = _wrap_in_base_path(url_cache_filepath_rel)
2017-09-28 05:18:06 -06:00
def url_cache_filepath_dirs_to_delete(self, media_id):
"The dirs to try and remove if we delete the media_id file"
if NEW_FORMAT_ID_RE.match(media_id):
return [
os.path.join(
2017-10-13 04:42:07 -06:00
self.base_path, "url_cache",
media_id[:10],
),
]
else:
return [
os.path.join(
2017-10-13 04:42:07 -06:00
self.base_path, "url_cache",
media_id[0:2], media_id[2:4],
),
os.path.join(
2017-10-13 04:42:07 -06:00
self.base_path, "url_cache",
media_id[0:2],
),
]
2017-09-28 05:18:06 -06:00
2017-10-12 10:31:24 -06:00
def url_cache_thumbnail_rel(self, media_id, width, height, content_type,
method):
2017-09-28 05:18:06 -06:00
# Media id is of the form <DATE><RANDOM_STRING>
# E.g.: 2017-09-28-fsdRDt24DS234dsf
top_level_type, sub_type = content_type.split("/")
file_name = "%i-%i-%s-%s-%s" % (
width, height, top_level_type, sub_type, method
)
2017-09-28 05:18:06 -06:00
if NEW_FORMAT_ID_RE.match(media_id):
return os.path.join(
2017-10-12 10:31:24 -06:00
"url_cache_thumbnails",
media_id[:10], media_id[11:],
file_name
)
else:
return os.path.join(
2017-10-12 10:31:24 -06:00
"url_cache_thumbnails",
media_id[0:2], media_id[2:4], media_id[4:],
file_name
)
2017-09-28 05:18:06 -06:00
2017-10-12 10:31:24 -06:00
url_cache_thumbnail = _wrap_in_base_path(url_cache_thumbnail_rel)
2017-09-28 05:18:06 -06:00
def url_cache_thumbnail_directory(self, media_id):
# Media id is of the form <DATE><RANDOM_STRING>
# E.g.: 2017-09-28-fsdRDt24DS234dsf
if NEW_FORMAT_ID_RE.match(media_id):
return os.path.join(
2017-10-13 04:42:07 -06:00
self.base_path, "url_cache_thumbnails",
media_id[:10], media_id[11:],
)
else:
return os.path.join(
2017-10-13 04:42:07 -06:00
self.base_path, "url_cache_thumbnails",
media_id[0:2], media_id[2:4], media_id[4:],
)
2017-09-28 05:18:06 -06:00
def url_cache_thumbnail_dirs_to_delete(self, media_id):
"The dirs to try and remove if we delete the media_id thumbnails"
# Media id is of the form <DATE><RANDOM_STRING>
# E.g.: 2017-09-28-fsdRDt24DS234dsf
if NEW_FORMAT_ID_RE.match(media_id):
return [
os.path.join(
2017-10-13 04:42:07 -06:00
self.base_path, "url_cache_thumbnails",
media_id[:10], media_id[11:],
),
os.path.join(
2017-10-13 04:42:07 -06:00
self.base_path, "url_cache_thumbnails",
media_id[:10],
),
]
else:
return [
os.path.join(
2017-10-13 04:42:07 -06:00
self.base_path, "url_cache_thumbnails",
media_id[0:2], media_id[2:4], media_id[4:],
),
os.path.join(
2017-10-13 04:42:07 -06:00
self.base_path, "url_cache_thumbnails",
media_id[0:2], media_id[2:4],
),
os.path.join(
2017-10-13 04:42:07 -06:00
self.base_path, "url_cache_thumbnails",
media_id[0:2],
),
]