This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author rbricheno
Recipients dstufft, eric.araujo, rbricheno
Date 2018-04-29.18:51:58
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1525027919.12.0.682650639539.issue33388@psf.upfronthosting.co.za>
In-reply-to
Content
PEP 566 added the metadata fields 'Description-Content-Type' and 'Provides-Extra':

https://www.python.org/dev/peps/pep-0566/
http://setuptools.readthedocs.io/en/latest/setuptools.html#metadata

Currently dist.py in CPython distutils will warn if they are set, e.g.:

`dist.py:261: UserWarning: Unknown distribution option: 'long_description_content_type'`

The warnings are emitted when using setuptools to build a wheel (say) if either of the fields are defined. They seem spurious (I can still build wheels even if I see this warning...). But they looked a bit scary to me as a new user.

There are a few possible ways to fix this. Long-term they should be fully supported by distutils I suppose. In the short term, there are a few different ways to make these warnings go away.

My preferred option would be to simply declare fields for these variables in dist.py (as per setuptools). By declaring these variables, the warnings are no longer displayed. long_description_content_type, at least, is being used in the wild since:

pypa/sampleproject@5be0970
History
Date User Action Args
2018-04-29 18:51:59rbrichenosetrecipients: + rbricheno, eric.araujo, dstufft
2018-04-29 18:51:59rbrichenosetmessageid: <1525027919.12.0.682650639539.issue33388@psf.upfronthosting.co.za>
2018-04-29 18:51:59rbrichenolinkissue33388 messages
2018-04-29 18:51:58rbrichenocreate