Browse Source

tools: Update tooling to support Last Calls

hacx
Jonas Wielicki 6 years ago
parent
commit
711cf257b3
  1. 180
      lastcall.py
  2. 12
      tools/extract-metadata.py
  3. 31
      tools/send-updates.py
  4. 6
      tools/xeplib.py

180
lastcall.py

@ -1,180 +0,0 @@ @@ -1,180 +0,0 @@
#!/usr/bin/env python
# File: lastcall.py
# Version: 0.5
# Description: a script for announcing Last Calls
# Last Modified: 2007-05-16
# Author: Peter Saint-Andre (stpeter@jabber.org)
# License: public domain
# HowTo: ./lastcall.py xepnum enddate
## LICENSE ##
#
# Copyright (c) 1999 - 2010 XMPP Standards Foundation
#
# Permission is hereby granted, free of charge, to any person obtaining a copy
# of this software and associated documentation files (the "Software"), to deal
# in the Software without restriction, including without limitation the rights
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
# copies of the Software, and to permit persons to whom the Software is
# furnished to do so, subject to the following conditions:
#
# The above copyright notice and this permission notice shall be included in
# all copies or substantial portions of the Software.
#
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
# THE SOFTWARE.
#
## END LICENSE ##
# IMPORTS:
#
import glob
import os
from select import select
import smtplib
import socket
from string import split,strip,join,find
import sys
import time
from xml.dom.minidom import parse,parseString,Document
def getText(nodelist):
thisText = ""
for node in nodelist:
if node.nodeType == node.TEXT_NODE:
thisText = thisText + node.data
return thisText
# get the seconds in the Unix era
now = int(time.time())
# READ IN ARGS:
#
# 1. XEP number
# 2. end date
xepnum = sys.argv[1];
enddate = sys.argv[2];
xepfile = 'xep-' + xepnum + '.xml'
# PARSE XEP HEADERS:
#
# - title
# - abstract
# - version
# - date
# - initials
# - remark
thexep = parse(xepfile)
xepNode = (thexep.getElementsByTagName("xep")[0])
headerNode = (xepNode.getElementsByTagName("header")[0])
titleNode = (headerNode.getElementsByTagName("title")[0])
title = getText(titleNode.childNodes)
abstractNode = (headerNode.getElementsByTagName("abstract")[0])
abstract = getText(abstractNode.childNodes)
statusNode = (headerNode.getElementsByTagName("status")[0])
xepstatus = getText(statusNode.childNodes)
typeNode = (headerNode.getElementsByTagName("type")[0])
xeptype = getText(typeNode.childNodes)
revNode = (headerNode.getElementsByTagName("revision")[0])
versionNode = (revNode.getElementsByTagName("version")[0])
version = getText(versionNode.childNodes)
dateNode = (revNode.getElementsByTagName("date")[0])
date = getText(dateNode.childNodes)
initialsNode = (revNode.getElementsByTagName("initials")[0])
initials = getText(initialsNode.childNodes)
remarkNode = (revNode.getElementsByTagName("remark")[0])
remark = getText(remarkNode.childNodes)
# SEND MAIL:
#
# From: editor@xmpp.org
# To: standards@xmpp.org
# Subject: LAST CALL: XEP-$xepnum ($title)
# Body:
# This message constitutes notice of a Last Call
# for comments on XEP-$xepnum ($title).
#
# Abstract: $abstract
#
# URL: https://xmpp.org/extensions/xep-$xepnum.html
#
# This Last Call begins today and shall end at the close
# of business on $enddate.
#
# Please consider the following questions during this Last Call and
# send your feedback to the standards@xmpp.org discussion list:
#
# 1. Is this specification needed to fill gaps in the XMPP
# protocol stack or to clarify an existing protocol?
# 2. Does the specification solve the problem stated in the
# introduction and requirements?
# 3. Do you plan to implement this specification in your code?
# If not, why not?
# 4. Do you have any security concerns related to this specification?
# 5. Is the specification accurate and clearly written?
#
# Your feedback is appreciated!
#
fromaddr = "editor@xmpp.org"
# for testing...
# toaddrs = "stpeter@jabber.org"
# for real...
toaddrs = "standards@xmpp.org"
thesubject = 'LAST CALL: XEP-' + xepnum + " (" + title + ")"
introline = 'This message constitutes notice of a Last Call for comments on XEP-' + xepnum + ' (' + title + ').'
abstractline = 'Abstract: ' + abstract
urlline = 'URL: https://xmpp.org/extensions/xep-' + xepnum + '.html'
schedline = 'This Last Call begins today and shall end at the close of business on ' + enddate + '.'
qline0 = 'Please consider the following questions during this Last Call and send your feedback to the standards@xmpp.org discussion list:'
qline1 = '1. Is this specification needed to fill gaps in the XMPP protocol stack or to clarify an existing protocol?'
qline2 = '2. Does the specification solve the problem stated in the introduction and requirements?'
qline3 = '3. Do you plan to implement this specification in your code? If not, why not?'
qline4 = '4. Do you have any security concerns related to this specification?'
qline5 = '5. Is the specification accurate and clearly written?'
feedline = 'Your feedback is appreciated!'
#msg = "From: %s\r\n" % fromaddr
msg = "From: XMPP Extensions Editor <%s>\r\n" % fromaddr
msg = msg + "To: %s\r\n" % toaddrs
msg = msg + "Subject: %s\r\n" % thesubject
msg = msg + introline
msg = msg + "\r\n\n"
msg = msg + abstractline
msg = msg + "\r\n\n"
msg = msg + urlline
msg = msg + "\r\n\n"
msg = msg + schedline
msg = msg + "\r\n\n"
msg = msg + qline0
msg = msg + "\r\n\n"
msg = msg + qline1
msg = msg + "\r\n"
msg = msg + qline2
msg = msg + "\r\n"
msg = msg + qline3
msg = msg + "\r\n"
msg = msg + qline4
msg = msg + "\r\n"
msg = msg + qline5
msg = msg + "\r\n\n"
msg = msg + feedline
msg = msg + "\r\n"
server = smtplib.SMTP('localhost')
server.set_debuglevel(1)
server.sendmail(fromaddr, toaddrs, msg)
server.quit()
# END

12
tools/extract-metadata.py

@ -79,6 +79,12 @@ def extract_xep_metadata(document): @@ -79,6 +79,12 @@ def extract_xep_metadata(document):
else:
approver = "Board" if type_ == "Procedural" else "Council"
last_call_el = minidom_find_child(header, "lastcall")
if last_call_el is not None:
last_call = minidom_get_text(last_call_el)
else:
last_call = None
return {
"last_revision": {
"version": last_revision_version,
@ -93,6 +99,7 @@ def extract_xep_metadata(document): @@ -93,6 +99,7 @@ def extract_xep_metadata(document):
"shortname": shortname,
"title": title,
"approver": approver,
"last_call": last_call,
}
@ -132,6 +139,11 @@ def make_metadata_element(number, metadata, accepted, *, protoname=None): @@ -132,6 +139,11 @@ def make_metadata_element(number, metadata, accepted, *, protoname=None):
text_element("sig", metadata["sig"])
)
if metadata["last_call"] is not None:
result.append(
text_element("lastcall", metadata["last_call"])
)
if accepted:
result.set("accepted", "true")
else:

31
tools/send-updates.py

@ -55,6 +55,35 @@ proposal as an official XEP.""" @@ -55,6 +55,35 @@ proposal as an official XEP."""
SUBJECT_PROTO_TEMPLATE = "Proposed XMPP Extension: {info[title]}"
MAIL_LAST_CALL_TEMPLATE = """\
This message constitutes notice of a Last Call for comments on \
XEP-{info[number]:04d}.
Abstract:
{info[abstract]}
This Last Call begins today and shall end at the close of business on \
{info[last_call]}.
Please consider the following questions during this Last Call and send your \
feedback to the standards@xmpp.org discussion list:
1. Is this specification needed to fill gaps in the XMPP protocol stack or to \
clarify an existing protocol?
2. Does the specification solve the problem stated in the introduction and \
requirements?
3. Do you plan to implement this specification in your code? If not, why not?
4. Do you have any security concerns related to this specification?
5. Is the specification accurate and clearly written?
Your feedback is appreciated!
"""
MAIL_NONPROTO_TEMPLATE = """\
Version {info[last_revision][version]} of XEP-{info[number]:04d} \
({info[title]}) has been released.
@ -171,6 +200,8 @@ def make_nonproto_mail(action, info): @@ -171,6 +200,8 @@ def make_nonproto_mail(action, info):
body_template = MAIL_NONPROTO_TEMPLATE
if action == Action.DEFER:
body_template = MAIL_DEFER_TEMPLATE
elif action == Action.LAST_CALL:
body_template = MAIL_LAST_CALL_TEMPLATE
mail = email.message.EmailMessage()
mail["Subject"] = SUBJECT_NONPROTO_TEMPLATE.format(**kwargs)

6
tools/xeplib.py

@ -36,6 +36,7 @@ class Action(enum.Enum): @@ -36,6 +36,7 @@ class Action(enum.Enum):
DEFER = "DEFERRED"
UPDATE = "UPDATED"
DEPRECATE = "DEPRECATED"
LAST_CALL = "LAST CALL"
@classmethod
def fromstatus(cls, status):
@ -48,6 +49,7 @@ class Action(enum.Enum): @@ -48,6 +49,7 @@ class Action(enum.Enum):
Status.OBSOLETE: cls.OBSOLETE,
Status.DEPRECATED: cls.DEPRECATE,
Status.DEFERRED: cls.DEFER,
Status.PROPOSED: cls.LAST_CALL,
}[status]
@ -85,6 +87,10 @@ def load_xepinfo(el): @@ -85,6 +87,10 @@ def load_xepinfo(el):
info["last_revision"] = last_revision
last_call_el = el.find("lastcall")
if last_call_el is not None:
info["last_call"] = last_call_el.text
sig = el.find("sig")
if sig is not None:
info["sig"] = sig.text

Loading…
Cancel
Save