refactoring: renamed sat package to libervia.backend
This commit is contained in:
Goffi
parent
a15648d682
commit
d2685ba11b
1 changed files with 1293 additions and 1293 deletions
|
|
@ -1,191 +0,0 @@
|
|||
#!/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 sat.core.i18n import _
|
||||
from sat.core.constants import Const as C
|
||||
from sat.core import exceptions
|
||||
from sat.core.log import getLogger
|
||||
|
||||
log = getLogger(__name__)
|
||||
from twisted.internet import defer
|
||||
from sat.tools.common import uri
|
||||
from sat.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
|
||||
Loading…
Reference in a new issue