Re: setuptools API compatibility

Paul Ganssle <[email protected]> Thu, 11 Oct 2018 17:10:12 -0400
Newsgroups	gmane.comp.python.distutils.devel
Message-ID	<[email protected]>
Are you saying this is true of App Engine or of setuptools?

Setuptools is /pretty/ conservative, but I think there's still the
caveat that major versions may have backwards-incompatible changes in
it. For example, version 39.0 removed some symbols
<https://setuptools.readthedocs.io/en/latest/history.html#v39-0-0> after
a long deprecation period. Version 38
<https://setuptools.readthedocs.io/en/latest/history.html#v38-0-0>
started requiring ordered sequences for install_requires.

Regarding the "there isn't currently a way for a package to specify
build-time compatibility with a specific version of setuptools", is it
not possible to do this with pyproject.toml?

[build-system]
requires = ["setuptools>38.0", "wheel"]

Doing it this way will work with pip wheel or pip install, though it all
depends on how good the PEP 518 support is for the tools you're using to
build your package.

On 10/11/18 4:12 PM, Dustin Ingram wrote:
> Hi Brian, I work on the team that develops the App Engine Python 3.7
> runtime. You're correct, by default we use the latest versions of
> setuptools, pip and wheel for the runtime. We do this to ensure that
> the runtime is always compatible with the latest features that newly
> created packages may be using.
>
> Since there isn't currently a way for a package to specify build-time
> compatibility with a specific version of setuptools, new versions of
> setuptools are more or less fully backwards-compatible with older
> packages.
>
> That said, there is the potential for a bug in a new version of these
> tools to cause unexpected installation failure. We are able to detect
> issues with new releases of these tools, and if we see such a problem,
> we have the means to pin them back to an older version if necessary
> until the bug is fixed.
>
> Please let me know if you have any other questions!
>
> D.
>
>
> On Fri, Oct 5, 2018 at 6:16 PM <[email protected]
> <mailto:[email protected]>> wrote:
>
>     Hi,
>
>     Does setuptools make any API stability guarantees i.e. should all
>     setup.py files that work with setuptools version X also work with
>     setuptools version Y where  Y > X?
>
>     I'm asking because the App Engine Python 3.7 runtime keeps it's
>     version of setuptools up-to-date and I'm wondering if that is
>     problematic due to API compatibility i.e. that package
>     installation might fail due to an incompatibility introduced in
>     setuptools.
>
>     Cheers,
>     Brian
>     --
>     Distutils-SIG mailing list -- [email protected]
>     <mailto:[email protected]>
>     To unsubscribe send an email to [email protected]
>     <mailto:[email protected]>
>     https://mail.python.org/mm3/mailman3/lists/distutils-sig.python.org/
>     Message archived at
>     https://mail.python.org/mm3/archives/list/[email protected]/message/6UN6P7UCZVSS3XKM7CVNW7KRLQEYGPUW/
>
>
> --
> Distutils-SIG mailing list -- [email protected]
> To unsubscribe send an email to [email protected]
> https://mail.python.org/mm3/mailman3/lists/distutils-sig.python.org/
> Message archived at https://mail.python.org/mm3/archives/list/[email protected]/message/A3X24JNDG2FLM7JBV2MAZEQNXZHBZ2RA/

--
Distutils-SIG mailing list -- [email protected]
To unsubscribe send an email to [email protected]
https://mail.python.org/mm3/mailman3/lists/distutils-sig.python.org/
Message archived at https://mail.python.org/mm3/archives/list/[email protected]/message/XA5RMBDNTXIVMBNODYEKLJS2KR7NZ5LG/
signature.asc (application/pgp-signature, 833 B)