PyPi twine check does not like my README.rst files anymore

[Barry Scott]

> On 16 Jul 2019, at 05:43, dieter <dieter at handshake.de> wrote:
> 
> Barry Scott <barry at barrys-emacs.org> writes:
>> I am update some PyPI projects and found that twine was refusing the upload.
>> ...
>> Failed
>> The project's long_description has invalid markup which will not be rendered on PyPI. The following syntax errors were detected:
>> line 1: Severe: Unexpected section title or transition.
>> ...
>> The other reason is the show stopper.
>> 
>> It does not allow me to have sections in my README.rst.
>> 
>> The README.rst starts with:
>> 
>> Module namedstruct
>> ------------------
>> 
>> namedstruct encapsulates struct.unpack() and struct.pack() with results accessed by name.
>> ...
> 
> It may not expect that your "README.rst" starts with a section:
> PyPI will provide a title; typical descriptions then have some
> introductory text and only then the section structuring begins.

I did that and only the first line of the file is rendered.


> 
> If this is not the cause, look at the source of the checking
> implementation. It should tell you what is does not like.

I was hoping to avoid reading the source that may well be a rabbit hole that keeps going down.

Barry

> 
> -- 
> https://mail.python.org/mailman/listinfo/python-list
>