Path: csiph.com!usenet.pasdenom.info!gegeweb.org!usenet-fr.net!nerim.net!novso.com!newsfeed.xs4all.nl!newsfeed2a.news.xs4all.nl!xs4all!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail
Return-Path: <rosuav@gmail.com>
X-Original-To: python-list@python.org
Delivered-To: python-list@mail.python.org
X-Spam-Status: OK 0.003
X-Spam-Evidence: '*H*': 0.99; '*S*': 0.00; 'third-party': 0.04; 'repository': 0.05; 'transform': 0.07; 'consistency': 0.09; 'created,': 0.09; 'library?': 0.09; 'occasionally': 0.09; 'release,': 0.09; 'says.': 0.09; 'cc:addr:python-list': 0.11; 'python': 0.11; 'jan': 0.12; 'clone': 0.16; 'downloaded.': 0.16; 'finney': 0.16; 'from:addr:rosuav': 0.16; 'from:name:chris angelico': 0.16; 'maintainer': 0.16; "someone's": 0.16; 'alpha': 0.16; 'wrote:': 0.18; 'library': 0.18; 'cc:addr:python.org': 0.22; 'install': 0.23; 'instance,': 0.24; 'issue,': 0.24; 'cc:2**0': 0.24; "i've": 0.25; 'source': 0.25; 'extension': 0.26; 'header:In- Reply-To:1': 0.27; 'rest': 0.29; 'am,': 0.29; 'generally': 0.29; 'message-id:@mail.gmail.com': 0.30; "i'm": 0.30; 'code': 0.31; 'that.': 0.31; 'this.': 0.32; 'fri,': 0.33; 'there,': 0.34; 'could': 0.34; 'subject: (': 0.35; "can't": 0.35; 'knows': 0.35; 'something': 0.35; 'but': 0.35; 'received:google.com': 0.35; 'version': 0.36; 'entry': 0.36; 'useful': 0.36; 'easily': 0.37; 'ben': 0.38; 'others.': 0.38; 'version,': 0.38; 'that,': 0.38; 'anything': 0.39; 'expect': 0.39; 'how': 0.40; 'new': 0.61; 'show': 0.63; 'latest': 0.67; 'between': 0.67; 'user,': 0.69; 'obvious': 0.74; 'guaranteed': 0.75; '2015': 0.84; 'subject:Using': 0.84; 'subject:source': 0.84; 'favour': 0.91; 'to:none': 0.92
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:cc :content-type; bh=cuICN3+P9W7QqWyvNsyTMzADyRREKTMXUYQFPj9W0zM=; b=N16HysaK94cLI37Z7llSgDDPVccF/jo+V2Cq44+4Ws7+3orGimOIVuB03og5ezvZv0 onav1h3IBxDMYl25aOlPIoY2otg+kx+0ZUHqE/5h8pyoDyCDU7cB4ry7NIluD1ErkaRp ICSkWhEe6n6eLKmE4Vx23RXX/QuLzy3jdWcYp6lEUbv8/jNB74BNcc1fN0epsRLPS2ko Edoyl+/qm6b0AYqDEngfMiIhT9E68JDoCrxm02dOxClxloEsh+Qp3PP+1YLONNVIp/Jd pqWcArnpIzmdpJKPIJwRRtIwgzzdhyok8lhiaa7GmHo68bwCU+65YU+GDVK/Nt/5zMvu yOWQ==
MIME-Version: 1.0
X-Received: by 10.107.160.143 with SMTP id j137mr12247269ioe.43.1420762588376; Thu, 08 Jan 2015 16:16:28 -0800 (PST)
In-Reply-To: <85fvbkx1fc.fsf_-_@benfinney.id.au>
References: <54ae0917$0$2738$c3e8da3$76491128@news.astraweb.com> <mailman.17465.1420701187.18130.python-list@python.org> <54ae6715$0$12987$c3e8da3$5496439d@news.astraweb.com> <85fvbkx1fc.fsf_-_@benfinney.id.au>
Date: Fri, 9 Jan 2015 11:16:28 +1100
Subject: Re: Using a ChangeLog as a canonical source of package metadata (was: Announce: PyPrimes 0.2.1a)
From: Chris Angelico <rosuav@gmail.com>
Cc: "python-list@python.org" <python-list@python.org>
Content-Type: text/plain; charset=UTF-8
X-BeenThere: python-list@python.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe: <https://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive: <http://mail.python.org/pipermail/python-list/>
List-Post: <mailto:python-list@python.org>
List-Help: <mailto:python-list-request@python.org?subject=help>
List-Subscribe: <https://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups: comp.lang.python
Message-ID: <mailman.17489.1420762590.18130.python-list@python.org>
Lines: 25
NNTP-Posting-Host: 2001:888:2000:d::a6
X-Trace: 1420762590 news.xs4all.nl 2842 [2001:888:2000:d::a6]:40605
X-Complaints-To: abuse@xs4all.nl
Xref: csiph.com comp.lang.python:83375

On Fri, Jan 9, 2015 at 11:06 AM, Ben Finney <ben+python@benfinney.id.au> wrote:
> I've now produced a small Python library which knows how to transform a
> reST Changelog to package metadata; and how to get that package metadata
> into and out of a Python distribution with Distutils.
>
> The result is that I will never again upload the package with a mismatch
> between what the Changelog claims is the latest version, and what the
> package metadata says.
>
>
> This may be generally useful to others. I'm interested to know how
> people would expect to use this. As an extension to Distutils? As a
> third-party library? Something else?

I can't speak as a package maintainer (because I'm not one), but
speaking as an end user, I'm in favour of anything that guarantees
consistency like that. It's only occasionally an issue, but for
instance, if I clone someone's source code repository and then install
a package from there, it's not necessarily obvious from 'pip freeze'
that I have something that can't so easily be downloaded. If the
Changelog were guaranteed to show that, then I could easily see what's
going on (eg if a new entry is created, immediately after the version
release, adding an alpha version tag).

ChrisA