old_contents: # -*- coding: utf-8 -*-
  # Copyright 2014 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 .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>
  
             <media>
  
          <= HTTP/1.1 200 OK
             Content-Type: application/json
  
             { "token": <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))
  
new_contents: # -*- coding: utf-8 -*-
  # Copyright 2014 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 .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>
  
             <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))
  
subject: Update docs in media_repository