di / markdown-description-example Goto Github PK

Following the documentation, it may be useful to add a setup_requires=['setuptools>=38.6.0'], in case some developers find it relevant.

Of course, it is not a requirement that will prevent installation or upload to PyPI, only rendering. So it could go to a requirements.txt.

Also, 'twine>=1.11.0' could be mentioned in a dev_requirements.txt.

I cloned this repo, created a new virtualenv, and made sure to upgrade setuptools:

$ pip freeze --all
pip==10.0.0
setuptools==39.0.1
wheel==0.31.0

And yet when I run python setup.py, I get this warning or error:

$ python setup.py sdist
/usr/local/Cellar/python/3.6.5/Frameworks/Python.framework/Versions/3.6/lib/python3.6/distutils/dist.py:261: UserWarning: Unknown distribution option: 'long_description_content_type'
  warnings.warn(msg)
running sdist
# rest cut for brevity

Is this normal? Is the warning meant to be there? Why doesn't the new version of setuptools seem to support long_description_content_type?

If I run pyproject-build without having a MANIFEST.in (caps does seem to be mandatory) in the same directory as setup.py, and in it add the line include README.md, I will get an error saying that it can't find such a file when turning this into a package.

I followed the guide and upgraded setuptools and twine, but it didn't render markdown properly after uploading.

And python setup.py check says

python\lib\distutils\dist.py:261: UserWarning: Unknown distribution option: '
long_description_content_type'

Here is my project: https://pypi.org/project/qquiz/

I used twine version 1.11.0 (pkginfo: 1.4.2, requests: 2.18.4, setuptools: 39.0.1, requests-toolbelt: 0.8.0, tqdm: 4.19.8) on Windows.

I am trying to configure a pypi project markdown longdescription here: https://pypi.org/project/aioexponent/

I though I configured correctly my setup.py https://github.com/Chefclub/expo-server-sdk-asyncio/blob/0.5.0/setup.py#L19

But the description still doesn't show properly.