`python setup.py upload_docs` успешно, но ничего не меняется в сети

Question

Я пытаюсь опубликовать документацию по адресу pythonhosted.org с помощью setuptools, но в то время как python setup.py upload_docs преуспевает, ничто не меняется в Интернете, и в журнале моего пакета на PyPI не сообщается об обновлении документации ,

Тем не менее, я все еще могу вручную загрузить ZIP-файл с помощью веб-интерфейса PyPI, и это работает отлично.

Я использовал для создания и развертывания документации с использованием MkDocs:

$ mkdocs build --clean 
$ python setup.py upload_docs 

Ни один из них не сообщает каких-либо ошибок. Новый веб-сайт правильно создан и может обслуживаться локально MkDocs.

Я пробовал Python 3.4.2, 3.5 и 3.6, а также несколько версий setuptools. Я должен упустить что-то очевидное.

Ниже приведен вывод команды upload_docs (с информацией об отладке). Обратите внимание, что содержимое веб-сайта хранится в разделе «./site», как обнаружено. См. Также мои project configuration, особенно setup.py и setup.cfg.

$ python setup.py upload_docs 
options (after parsing config files): 
options (after parsing command line): 
option dict for 'aliases' command: 
{} 
option dict for 'metadata' command: 
{'description_file': ('setup.cfg', 'README.adoc')} 
option dict for 'upload_docs' command: 
{'upload_dir': ('setup.cfg', 'site')} 
running upload_docs 
Distribution.get_command_obj(): creating 'upload_docs' command object 
setting options for 'upload_docs' command: 
upload_dir = site (from setup.cfg) 
Upload_docs command is deprecated. Use RTD instead. 
Submitting documentation to https://pypi.python.org/pypi/ 
Server response (200): OK 

Заранее благодарим за любую помощь.

Answer 1

Никто из них не несет никакой ошибки.

Технически это правда, но вы, кажется, игнорируете простое предупреждение. С вашего вывода:

Команда Upload_docs устарела. Вместо этого используйте RTD.

«Устаревшая» часть is clear enough: эта команда больше не рекомендуется использовать.

Часть «Использовать RTD вместо» неясно, даю вам. Он должен быть более явным: он ссылается на услугу Read the Docs.

Это потому, что существует (poorly documented as of 2017-04-05) план до remove услуги по размещению документации PyPI.