pytest-sugar icon indicating copy to clipboard operation
pytest-sugar copied to clipboard

Markdown on PyPI

Open MartinThoma opened this issue 5 years ago • 5 comments

When I go to the pytest-sugar page on PyPI, I see that markdown is not rendered. The version there is 0.9.4 and if there were no other changes, this version was introduced with 92ae9dee - the latest commit.

I'm uncertain why markdown is not rendered, though. I have a similar setup for my packages and they look fine. Does anybody here have an idea?

MartinThoma avatar Aug 23 '20 07:08 MartinThoma

Interesting, I don't know what's going on with that. I read the documentations and I have the markdown tag correctly there.

Teemu avatar Aug 25 '20 18:08 Teemu

@Teemu Could you please answer the questions in the other issue? pypa/warehouse is the official repository of pypi.org; so the folks there should be able to give awesome support :-)

MartinThoma avatar Aug 25 '20 21:08 MartinThoma

From my previous encounters with this kind of problem, you need a few things in order to use Markdown descriptions on PyPI:

  • a long_description_content_type="text/markdown" in your setup.py (which you have)
  • a sufficiently recent setuptools version used to build the sdist (can't find an exact version number, sorry!)
  • a sufficiently recent twine version (>= 1.11) used to upload the sdist to PyPI

If you're uploading wheels, it might also be a good idea that you have the most recent wheel version as well.

Anyway I've looked at the two PKG-INFO files inside pytest-sugar-0.9.4.tar.gz and neither of them has the

Description-Content-Type: text/markdown

field, which indicates that you used a too-old setuptools version to generate the sdist.

(and now I see that I merely repeated the information already provided on the linked warehouse issue)

mgedmin avatar Sep 03 '20 12:09 mgedmin

@Teemu Could you answer the questions in https://github.com/pypa/warehouse/issues/8472 about the pytest-sugar build? Maybe they can help us to fix it.

MartinThoma avatar Sep 03 '20 18:09 MartinThoma

field, which indicates that you used a too-old setuptools version to generate the sdist.

I'm 100% sure that this was the case. :)

I suggest running twine check on the distributions before uploading them (which prints the warning about the lack of this information).

pradyunsg avatar Sep 12 '20 15:09 pradyunsg

It appears Markdown is rendering properly for the pytest-sugar README on its PyPI page, so I believe this issue can be closed.

justinmayer avatar Nov 08 '22 16:11 justinmayer

Closing as per previous comment.

blueyed avatar Nov 09 '22 11:11 blueyed