123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687 |
- # -*- coding: utf-8 -*-
- # 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.
- from .upload_resource import UploadResource
- from .download_resource import DownloadResource
- from .thumbnail_resource import ThumbnailResource
- from .identicon_resource import IdenticonResource
- from .preview_url_resource import PreviewUrlResource
- from .filepath import MediaFilePaths
- from twisted.web.resource import Resource
- import logging
- logger = logging.getLogger(__name__)
- class MediaRepositoryResource(Resource):
- """File uploading and downloading.
- Uploads are POSTed to a resource which returns a token which is used to GET
- the download::
- => POST /_matrix/media/v1/upload HTTP/1.1
- Content-Type: <media-type>
- Content-Length: <content-length>
- <media>
- <= HTTP/1.1 200 OK
- Content-Type: application/json
- { "content_uri": "mxc://<server-name>/<media-id>" }
- => GET /_matrix/media/v1/download/<server-name>/<media-id> HTTP/1.1
- <= HTTP/1.1 200 OK
- Content-Type: <media-type>
- Content-Disposition: attachment;filename=<upload-filename>
- <media>
- Clients can get thumbnails by supplying a desired width and height and
- thumbnailing method::
- => GET /_matrix/media/v1/thumbnail/<server_name>
- /<media-id>?width=<w>&height=<h>&method=<m> HTTP/1.1
- <= HTTP/1.1 200 OK
- Content-Type: image/jpeg or image/png
- <thumbnail>
- The thumbnail methods are "crop" and "scale". "scale" trys to return an
- image where either the width or the height is smaller than the requested
- size. The client should then scale and letterbox the image if it needs to
- fit within a given rectangle. "crop" trys to return an image where the
- width and height are close to the requested size and the aspect matches
- the requested size. The client should scale the image if it needs to fit
- within a given rectangle.
- """
- def __init__(self, hs):
- Resource.__init__(self)
- filepaths = MediaFilePaths(hs.config.media_store_path)
- self.putChild("upload", UploadResource(hs, filepaths))
- self.putChild("download", DownloadResource(hs, filepaths))
- self.putChild("thumbnail", ThumbnailResource(hs, filepaths))
- self.putChild("identicon", IdenticonResource())
- if hs.config.url_preview_enabled:
- try:
- self.putChild("preview_url", PreviewUrlResource(hs, filepaths))
- except Exception as e:
- logger.warn("Failed to mount preview_url")
- logger.exception(e)
|