Mercurial > libervia-backend
view sat/plugins/plugin_xep_0082.py @ 3922:0ff265725489
plugin XEP-0447: handle attachment and download:
- plugin XEP-0447 can now be used in message attachments and to retrieve an attachment
- plugin attach: `attachment` being processed is added to `extra` so the handler can inspect it
- plugin attach: `size` is added to attachment
- plugin download: a whole attachment dict is now used in `download` and
`file_download`/`file_download_complete`. `download_uri` can be used as a shortcut when
just a URI is used. In addition to URI scheme handler, whole attachment handlers can now
be registered with `register_download_handler`
- plugin XEP-0363: `file_http_upload` `XEP-0363_upload_size` triggers have been renamed to
`XEP-0363_upload_pre_slot` and is now using a dict with arguments, allowing for the size
but also the filename to be modified, which is necessary for encryption (filename may
be hidden from URL this way).
- plugin XEP-0446: fix wrong element name
- plugin XEP-0447: source handler can now be registered (`url-data` is registered by
default)
- plugin XEP-0447: source parsing has been put in a separated `parse_sources_elt` method,
as it may be useful to do it independently (notably with XEP-0448)
- plugin XEP-0447: parse received message and complete attachments when suitable
- plugin XEP-0447: can now be used with message attachments
- plugin XEP-0447: can now be used with attachments download
- renamed `options` arguments to `extra` for consistency
- some style change (progressive move from legacy camelCase to PEP8 snake_case)
- some typing
rel 379
author | Goffi <goffi@goffi.org> |
---|---|
date | Thu, 06 Oct 2022 16:02:05 +0200 |
parents | 8289ac1b34f4 |
children |
line wrap: on
line source
#!/usr/bin/env python3 # Libervia plugin for XMPP Date and Time Profile formatting and parsing with Python's # datetime package # Copyright (C) 2022-2022 Tim Henkes (me@syndace.dev) # This program is free software: you can redistribute it and/or modify # it under the terms of the GNU Affero General Public License as published by # the Free Software Foundation, either version 3 of the License, or # (at your option) any later version. # This program is distributed in the hope that it will be useful, # but WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the # GNU Affero General Public License for more details. # You should have received a copy of the GNU Affero General Public License # along with this program. If not, see <http://www.gnu.org/licenses/>. from sat.core.constants import Const as C from sat.core.i18n import D_ from sat.core.sat_main import SAT from sat.tools import xmpp_datetime __all__ = [ # pylint: disable=unused-variable "PLUGIN_INFO", "XEP_0082" ] PLUGIN_INFO = { C.PI_NAME: "XMPP Date and Time Profiles", C.PI_IMPORT_NAME: "XEP-0082", C.PI_TYPE: C.PLUG_TYPE_MISC, C.PI_PROTOCOLS: [ "XEP-0082" ], C.PI_DEPENDENCIES: [], C.PI_RECOMMENDATIONS: [], C.PI_MAIN: "XEP_0082", C.PI_HANDLER: "no", C.PI_DESCRIPTION: D_("Date and Time Profiles for XMPP"), } class XEP_0082: # pylint: disable=invalid-name """ Implementation of the date and time profiles specified in XEP-0082 using Python's datetime module. The legacy format described in XEP-0082 section "4. Migration" is not supported. Reexports of the functions in :mod:`sat.tools.xmpp_datetime`. This is a passive plugin, i.e. it doesn't hook into any triggers to process stanzas actively, but offers API for other plugins to use. """ def __init__(self, sat: SAT) -> None: """ @param sat: The SAT instance. """ format_date = staticmethod(xmpp_datetime.format_date) parse_date = staticmethod(xmpp_datetime.parse_date) format_datetime = staticmethod(xmpp_datetime.format_datetime) parse_datetime = staticmethod(xmpp_datetime.parse_datetime) format_time = staticmethod(xmpp_datetime.format_time) parse_time = staticmethod(xmpp_datetime.parse_time)