Mercurial > libervia-backend
view libervia/backend/plugins/plugin_tickets_import.py @ 4304:92a886f31581 default tip @
doc (components): new Email gateway documentation:
fix 449
author | Goffi <goffi@goffi.org> |
---|---|
date | Fri, 06 Sep 2024 18:07:44 +0200 |
parents | 4b842c1fb686 |
children |
line wrap: on
line source
#!/usr/bin/env python3 # SàT plugin for import external ticketss # Copyright (C) 2009-2021 Jérôme Poisson (goffi@goffi.org) # 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 libervia.backend.core.i18n import _ from libervia.backend.core.constants import Const as C from libervia.backend.core import exceptions from libervia.backend.core.log import getLogger log = getLogger(__name__) from twisted.internet import defer from libervia.backend.tools.common import uri from libervia.backend.tools import utils PLUGIN_INFO = { C.PI_NAME: "tickets import", C.PI_IMPORT_NAME: "TICKETS_IMPORT", C.PI_TYPE: C.PLUG_TYPE_IMPORT, C.PI_DEPENDENCIES: ["IMPORT", "XEP-0060", "XEP-0277", "XEP-0346"], C.PI_MAIN: "TicketsImportPlugin", C.PI_HANDLER: "no", C.PI_DESCRIPTION: _( """Tickets import management: This plugin manage the different tickets importers which can register to it, and handle generic importing tasks.""" ), } OPT_MAPPING = "mapping" FIELDS_LIST = ("labels", "cc_emails") # fields which must have a list as value FIELDS_DATE = ("created", "updated") NS_TICKETS = "fdp/submitted/org.salut-a-toi.tickets:0" class TicketsImportPlugin(object): BOOL_OPTIONS = () JSON_OPTIONS = (OPT_MAPPING,) OPT_DEFAULTS = {} def __init__(self, host): log.info(_("plugin Tickets import initialization")) self.host = host self._importers = {} self._p = host.plugins["XEP-0060"] self._m = host.plugins["XEP-0277"] self._s = host.plugins["XEP-0346"] host.plugins["IMPORT"].initialize(self, "tickets") @defer.inlineCallbacks def import_item( self, client, item_import_data, session, options, return_data, service, node ): """ @param item_import_data(dict): no key is mandatory, but if a key doesn't exists in dest form, it will be ignored. Following names are recommendations which should be used where suitable in importers. except if specified in description, values are unicode 'id': unique id (must be unique in the node) of the ticket 'title': title (or short description/summary) of the ticket 'body': main description of the ticket 'created': date of creation (unix time) 'updated': date of last update (unix time) 'author': full name of reporter 'author_jid': jid of reporter 'author_email': email of reporter 'assigned_to_name': full name of person working on it 'assigned_to_email': email of person working on it 'cc_emails': list of emails subscribed to the ticket 'priority': priority of the ticket 'severity': severity of the ticket 'labels': list of unicode values to use as label 'product': product concerned by this ticket 'component': part of the product concerned by this ticket 'version': version of the product/component concerned by this ticket 'platform': platform converned by this ticket 'os': operating system concerned by this ticket 'status': current status of the ticket, values: - "queued": ticket is waiting - "started": progress is ongoing - "review": ticket is fixed and waiting for review - "closed": ticket is finished or invalid 'milestone': target milestone for this ticket 'comments': list of microblog data (comment metadata, check [XEP_0277.send] data argument) @param options(dict, None): Below are the generic options, tickets importer can have specific ones. All options are serialized unicode values generic options: - OPT_MAPPING (json): dict of imported ticket key => exported ticket key e.g.: if you want to map "component" to "labels", you can specify: {'component': 'labels'} If you specify several import ticket key to the same dest key, the values will be joined with line feeds """ if "comments_uri" in item_import_data: raise exceptions.DataError( _("comments_uri key will be generated and must not be used by importer") ) for key in FIELDS_LIST: if not isinstance(item_import_data.get(key, []), list): raise exceptions.DataError(_("{key} must be a list").format(key=key)) for key in FIELDS_DATE: try: item_import_data[key] = utils.xmpp_date(item_import_data[key]) except KeyError: continue if session["root_node"] is None: session["root_node"] = NS_TICKETS if not "schema" in session: session["schema"] = yield self._s.get_schema_form( client, service, node or session["root_node"] ) defer.returnValue(item_import_data) @defer.inlineCallbacks def import_sub_items(self, client, item_import_data, ticket_data, session, options): # TODO: force "open" permission (except if private, check below) # TODO: handle "private" metadata, to have non public access for node # TODO: node access/publish model should be customisable comments = ticket_data.get("comments", []) service = yield self._m.get_comments_service(client) node = self._m.get_comments_node(session["root_node"] + "_" + ticket_data["id"]) node_options = { self._p.OPT_ACCESS_MODEL: self._p.ACCESS_OPEN, self._p.OPT_PERSIST_ITEMS: 1, self._p.OPT_DELIVER_PAYLOADS: 1, self._p.OPT_SEND_ITEM_SUBSCRIBE: 1, self._p.OPT_PUBLISH_MODEL: self._p.ACCESS_OPEN, } yield self._p.create_if_new_node(client, service, node, options=node_options) ticket_data["comments_uri"] = uri.build_xmpp_uri( "pubsub", subtype="microblog", path=service.full(), node=node ) for comment in comments: if "updated" not in comment and "published" in comment: # we don't want an automatic update date comment["updated"] = comment["published"] yield self._m.send(client, comment, service, node) def publish_item(self, client, ticket_data, service, node, session): if node is None: node = NS_TICKETS id_ = ticket_data.pop("id", None) log.debug( "uploading item [{id}]: {title}".format( id=id_, title=ticket_data.get("title", "") ) ) return defer.ensureDeferred( self._s.send_data_form_item( client, service, node, ticket_data, session["schema"], id_ ) ) def item_filters(self, client, ticket_data, session, options): mapping = options.get(OPT_MAPPING) if mapping is not None: if not isinstance(mapping, dict): raise exceptions.DataError(_("mapping option must be a dictionary")) for source, dest in mapping.items(): if not isinstance(source, str) or not isinstance(dest, str): raise exceptions.DataError( _( "keys and values of mapping must be sources and destinations ticket fields" ) ) if source in ticket_data: value = ticket_data.pop(source) if dest in FIELDS_LIST: values = ticket_data[dest] = ticket_data.get(dest, []) values.append(value) else: if dest in ticket_data: ticket_data[dest] = ticket_data[dest] + "\n" + value else: ticket_data[dest] = value