mirror of https://github.com/moparisthebest/xeps
tools: Update tooling to support Last Calls
This commit is contained in:
Jonas Wielicki
parent
017ad29fdd
commit
711cf257b3
180
lastcall.py
180
lastcall.py
|
|
@ -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
|
||||
|
||||
|
|
@ -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):
|
|||
"shortname": shortname,
|
||||
"title": title,
|
||||
"approver": approver,
|
||||
"last_call": last_call,
|
||||
}
|
||||
|
||||
|
||||
|
|
@ -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:
|
||||
|
|
|
|||
|
|
@ -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):
|
|||
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)
|
||||
|
|
|
|||
|
|
@ -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):
|
|||
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):
|
|||
|
||||
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…
Reference in New Issue