Re: [Tools-discuss] [xml2rfc-dev] [xml2rfc] End of support for xml2rfc on Python 2.x is coming soon
Henrik Levkowetz <henrik@levkowetz.com> Wed, 09 October 2019 06:09 UTC
Return-Path: <henrik@levkowetz.com>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 4C22D120088; Tue, 8 Oct 2019 23:09:22 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.096
X-Spam-Level:
X-Spam-Status: No, score=-1.096 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, RDNS_NONE=0.793, SPF_HELO_NONE=0.001, T_SPF_PERMERROR=0.01] autolearn=no autolearn_force=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id QXoqMIwSv7yH; Tue, 8 Oct 2019 23:09:20 -0700 (PDT)
Received: from zinfandel.tools.ietf.org (unknown [IPv6:2001:1890:126c::1:2a]) (using TLSv1.2 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id DA6C7120019; Tue, 8 Oct 2019 23:09:20 -0700 (PDT)
Received: from h-202-242.a357.priv.bahnhof.se ([158.174.202.242]:56563 helo=tannat.localdomain) by zinfandel.tools.ietf.org with esmtpsa (TLS1.2:DHE_RSA_AES_128_CBC_SHA1:128) (Exim 4.80) (envelope-from <henrik@levkowetz.com>) id 1iI59w-0006IT-Tt; Tue, 08 Oct 2019 23:09:19 -0700
To: Job Snijders <job@instituut.net>
References: <082EE9F1-D4AA-487F-BB8C-08CDB59C5A2F@vigilsec.com> <858628DA-84DA-4982-89D7-D652E04ACA10@gmail.com> <da8ffcbf-33dd-6fe9-e251-0e3de47c611f@levkowetz.com> <CACWOCC-uuYGz54dExA5CwftowbpcBq4kQHJwCBWHNC1za_q70w@mail.gmail.com>
Cc: xml2rfc-dev@ietf.org, IETF <ietf@ietf.org>, Tools Team Discussion <tools-discuss@ietf.org>, Fred Baker <fredbaker.ietf@gmail.com>, xml2rfc@ietf.org, rfc-markdown@ietf.org
From: Henrik Levkowetz <henrik@levkowetz.com>
Message-ID: <c31ba05c-ba17-3f3b-e75d-167502aeb4f6@levkowetz.com>
Date: Wed, 09 Oct 2019 08:09:08 +0200
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.11; rv:45.0) Gecko/20100101 Thunderbird/45.8.0
MIME-Version: 1.0
In-Reply-To: <CACWOCC-uuYGz54dExA5CwftowbpcBq4kQHJwCBWHNC1za_q70w@mail.gmail.com>
Content-Type: multipart/signed; micalg="pgp-sha256"; protocol="application/pgp-signature"; boundary="WPra5w39DAUrBIQdUjTWnCXHsrFmi8132"
X-SA-Exim-Connect-IP: 158.174.202.242
X-SA-Exim-Rcpt-To: rfc-markdown@ietf.org, xml2rfc@ietf.org, fredbaker.ietf@gmail.com, tools-discuss@ietf.org, ietf@ietf.org, xml2rfc-dev@ietf.org, job@instituut.net
X-SA-Exim-Mail-From: henrik@levkowetz.com
X-SA-Exim-Version: 4.2.1 (built Mon, 26 Dec 2011 16:24:06 +0000)
X-SA-Exim-Scanned: Yes (on zinfandel.tools.ietf.org)
X-Clacks-Overhead: GNU Terry Pratchett
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/BcczTYHi8g9Mz_K-gy0ltCr1Izg>
Subject: Re: [Tools-discuss] [xml2rfc-dev] [xml2rfc] End of support for xml2rfc on Python 2.x is coming soon
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss/>
List-Post: <mailto:tools-discuss@ietf.org>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 09 Oct 2019 06:09:23 -0000
Hi Job, On 2019-10-09 02:00, Job Snijders wrote: > On Tue, Oct 8, 2019 at 10:23 PM Henrik Levkowetz <henrik@levkowetz.com> wrote: >> On 2019-10-08 23:47, Fred Baker wrote: >> > That all fine, and as predictable as you say. What would very helpful >> > would be a road map: if you’re using {windows X|Mac X|Linux >> > X|whatever}, we think you should look at tools {D,E,F}. >> > >> > Speaking personally, I am on a Mac and using XMLmind with Fenner’s >> > tools. They mostly worked (note the past tense) except when they >> > didn’t. Telling me “well, ABCDEF supports <IETF tools du jour if you >> > can read Sanskrit>“ doesn’t quite work. >> > >> > I used to write in NROFF. I’ll do what it takes. But really? >> >> I'm sorry if the text wasn't clear enough. The roadmap is this: Please >> install Python 3.5 or higher on your system, and install coming versions >> of xml2rfc using the 'pip3' command which is part of that Python install. >> >> When we got to the xml2rfc 3.0.0 release, I had planned to update the >> release note with the information about using pip3, but I'm perfectly >> happy saying it now, too. >> >> Of course, if your default python is Python 3.5 or higher already, then >> using plain 'pip' to install will continue to work. > > We should note that the potential for pip/pip3 confusion is a result > of how the python community approached this transition (acknowleding > what their options were in context of how the packaging eco system was > set up). Not ideal, but it is what it is. > > I think it would be good to update public facing documentation about > xml2rfc that pip3 must be used, to make it very clear that any version > of xml2rfc is not expected to work correctly on python2 systems. Right. > Perhaps the final update to xml2rfc 2.x series should be to add a > check at boot whether the python interpreter's major version is lower > than 3, and if so, exit the xml2rfc program with an informative > message and a non-zero exit code, inform the user that python3 must be > used? Sometimes it is better to just break fast & early. I think that message will come through clearly on first attempt at installing the first xml2rfc version requiring Python 3, as I expect that to tell the user that 'this version of xml2rfc requires Python 3', but I'll do some testing when I come to that point. Better to fail during that installation, but still leave the user and system with a working (though out-of date) version of xml2rfc, than to install a version that cannot be used to do work. > Between the name of the tool (note the 2 in "xlm2rfc"), the industry's > transition from python 2 to python 3, and IETF's transition from the > v2 to the v3 RFC XML format, it is no surprise to me end users easily > become confused. A simple strong message that python2 can't be used > might be helpful, even if it appears somewhat unforgiving. Yes. I'd still like to leave the user with a system which hasn't been robbed of the xml2rfc functionality as a result of installing 'the last 2.x release of xml2rfc'. Best regards, Henrik
- [Tools-discuss] End of support for xml2rfc on Pyt… Russ Housley
- Re: [Tools-discuss] [xml2rfc] End of support for … Fred Baker
- Re: [Tools-discuss] [Rfc-markdown] End of support… Carsten Bormann
- Re: [Tools-discuss] [xml2rfc] [Rfc-markdown] End … Henrik Levkowetz
- Re: [Tools-discuss] [xml2rfc-dev] [xml2rfc] End o… Henrik Levkowetz
- Re: [Tools-discuss] [xml2rfc] [Rfc-markdown] End … Carsten Bormann
- Re: [Tools-discuss] [xml2rfc] [Rfc-markdown] End … Henrik Levkowetz
- Re: [Tools-discuss] [xml2rfc-dev] [xml2rfc] End o… Job Snijders
- Re: [Tools-discuss] [xml2rfc-dev] [xml2rfc] End o… Henrik Levkowetz
- Re: [Tools-discuss] [xml2rfc-dev] [xml2rfc] End o… Martin J. Dürst
- Re: [Tools-discuss] [xml2rfc] [Rfc-markdown] End … Carsten Bormann
- Re: [Tools-discuss] [xml2rfc-dev] [xml2rfc] End o… Henrik Levkowetz
- Re: [Tools-discuss] [xml2rfc] [Rfc-markdown] End … Randy Bush
- Re: [Tools-discuss] [xml2rfc] [Rfc-markdown] End … Henrik Levkowetz
- Re: [Tools-discuss] [xml2rfc] [Rfc-markdown] End … Robert Moskowitz
- Re: [Tools-discuss] [xml2rfc] [Rfc-markdown] End … Henrik Levkowetz
- Re: [Tools-discuss] [xml2rfc] [xml2rfc-dev] End o… Robert Moskowitz
- Re: [Tools-discuss] [Rfc-markdown] [xml2rfc] End … Julian Reschke
- Re: [Tools-discuss] End of support for xml2rfc on… Henrik Levkowetz
- Re: [Tools-discuss] End of support for xml2rfc on… Henrik Levkowetz
- Re: [Tools-discuss] [xml2rfc] End of support for … Carsten Bormann