Source code for cardinal_pythonlib.pyramid.responses

#!/usr/bin/env python
# cardinal_pythonlib/pyramid/responses.py

"""
===============================================================================

    Original code copyright (C) 2009-2022 Rudolf Cardinal (rudolf@pobox.com).

    This file is part of cardinal_pythonlib.

    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

        https://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.

===============================================================================

**Specialized response types for Pyramid (which implement MIME types and
suggested download methods, etc.).**

"""

# noinspection PyUnresolvedReferences
from pyramid.response import Response

from cardinal_pythonlib.httpconst import MimeType


# =============================================================================
# Character sets
# =============================================================================

UTF8 = "UTF-8"


# =============================================================================
# Responses
# =============================================================================


[docs]class BinaryResponse(Response): """ Base class for creating binary HTTP responses. """ def __init__( self, body: bytes, filename: str, content_type: str, as_inline: bool = False, **kwargs, ) -> None: """ Args: body: binary data filename: filename to associate with the download content_type: MIME content type as_inline: inline, rather than as an attachment? Inline: display within browser, if possible. Attachment: download. """ disp = "inline" if as_inline else "attachment" super().__init__( content_type=content_type, content_disposition=f"{disp}; filename={filename}", content_encoding="binary", content_length=len(body), body=body, **kwargs, )
[docs]class JsonAttachmentResponse(Response): """ Response class for returning a JSON file to the user as an attachment. """ def __init__(self, body: str, filename: str, **kwargs) -> None: super().__init__( content_type=MimeType.JSON, content_disposition=f"attachment; filename={filename}", body=body, charset=UTF8, **kwargs, )
[docs]class JsonResponse(Response): """ Response class for showing JSON in the browser. """ def __init__(self, body: str, **kwargs) -> None: # Watch out here. # TypeError: You cannot set the body to a text value without a charset # https://github.com/Pylons/webob/issues/298 super().__init__( content_type=MimeType.JSON, body=body, charset=UTF8, **kwargs )
[docs]class OdsResponse(BinaryResponse): """ Response class for returning an ODS (OpenOffice Spreadsheet) file to the user. """ def __init__(self, body: bytes, filename: str, **kwargs) -> None: super().__init__( content_type=MimeType.ODS, body=body, filename=filename, **kwargs )
[docs]class PdfResponse(BinaryResponse): """ Response class for returning a PDF to the user. """ def __init__( self, body: bytes, filename: str, as_inline: bool = True, **kwargs ) -> None: super().__init__( content_type=MimeType.PDF, filename=filename, as_inline=as_inline, body=body, **kwargs, )
[docs]class SqliteBinaryResponse(BinaryResponse): """ Response class for returning a SQLite binary database to the user. """ def __init__(self, body: bytes, filename: str, **kwargs) -> None: super().__init__( content_type=MimeType.SQLITE3, filename=filename, body=body, **kwargs, )
[docs]class TextAttachmentResponse(Response): """ Response class for returning text to the user as an attachment. """ def __init__(self, body: str, filename: str, **kwargs) -> None: # Will default to UTF-8 super().__init__( content_type=MimeType.TEXT, content_disposition=f"attachment; filename={filename}", body=body, **kwargs, )
[docs]class TextResponse(Response): """ Response class for returning text to the user, viewed in the browser. """ def __init__(self, body: str, **kwargs) -> None: super().__init__(content_type=MimeType.TEXT, body=body, **kwargs)
[docs]class TsvResponse(Response): """ Response class for returning a TSV file to the user. """ def __init__(self, body: str, filename: str, **kwargs) -> None: super().__init__( content_type=MimeType.TSV, content_disposition=f"attachment; filename={filename}", body=body, **kwargs, )
[docs]class XlsxResponse(BinaryResponse): """ Response class for returning an XLSX (Excel) file to the user. """ def __init__(self, body: bytes, filename: str, **kwargs) -> None: super().__init__( content_type=MimeType.XLSX, body=body, filename=filename, **kwargs )
[docs]class XmlResponse(Response): """ Response class for returning XML to the user. """ def __init__(self, body: str, **kwargs) -> None: # application/xml versus text/xml: # https://stackoverflow.com/questions/4832357 super().__init__(content_type=MimeType.XML, body=body, **kwargs)
[docs]class ZipResponse(BinaryResponse): """ Response class for returning a ZIP file to the user. """ def __init__(self, body: bytes, filename: str, **kwargs) -> None: # For ZIP, "inline" and "attachment" dispositions are equivalent, since # browsers don't display ZIP files inline. # https://stackoverflow.com/questions/1395151 super().__init__( content_type=MimeType.ZIP, filename=filename, body=body, **kwargs )