Как сгенерировать доку для одного файла?

python

Есть скрипт на питоне состоящий из одного файла. Пытаюсь сгененировать для него доку (html страничку), но sphinx брыкается и не хочет ничего делать. Провозился уже больше часа - толку 0. Уже ошибок 10 разных видел. Что не так с этим питоном?

Даже doxygen более вменяемый. И уже тем более cargo doc --open.

Ссылка

← Посетуйте окружение для сборки пакетов (appimage)

Как в сериализаторе проверить, что все field пусты? →

pydoc?

~~a1batross~~ ★★★★★
(22.02.20 02:29:03 MSK)

А ошибки мы гадать должны? Мало-ли что рукопопы накрутили в твоём файле.

peregrine ★★★★★
(22.02.20 04:22:15 MSK)

Ответ на: комментарий от peregrine 22.02.20 04:22:15 MSK

Вангую питонофайл сгенерирован и весит гигабайт =)

LINUX-ORG-RU ★★★★★
(22.02.20 05:29:02 MSK)

Ссылка

Ответ на: комментарий от a1batross 22.02.20 02:29:03 MSK

No Python documentation found for ‘app.py’.

Как не пытался.

~~RazrFalcon~~ ★★★★★
(22.02.20 12:51:58 MSK) автор топика

Ответ на: комментарий от RazrFalcon 22.02.20 12:51:58 MSK

https://www.reddit.com/r/learnpython/comments/8qp2nr/pydoc_no_python_document...

peregrine ★★★★★
(22.02.20 20:09:22 MSK)

Ответ на: комментарий от peregrine 22.02.20 20:09:22 MSK

> pydoc app
problem in app - FileNotFoundError: [Errno 2] No such file or directory: 'app'
> pydoc app.py
Error: Input file is not set (это моя ошибка)
problem in app - SystemExit: 1

~~RazrFalcon~~ ★★★★★
(22.02.20 20:27:12 MSK) автор топика
Последнее исправление: RazrFalcon 22.02.20 20:27:18 MSK (всего исправлений: 1)

Ответ на: комментарий от RazrFalcon 22.02.20 20:27:12 MSK

ls что говорит? может у тебя не app.py, а какой-нибудь аpp.py

peregrine ★★★★★
(22.02.20 20:36:09 MSK)
Последнее исправление: peregrine 22.02.20 20:37:42 MSK (всего исправлений: 1)

Ответ на: комментарий от peregrine 22.02.20 20:36:09 MSK

ls | grep "[a-z]" подсветит косяк именования echo "cсcсcс" | grep "[a-z]"

LINUX-ORG-RU ★★★★★
(22.02.20 20:44:08 MSK)

Ответ на: комментарий от LINUX-ORG-RU 22.02.20 20:44:08 MSK

Удобно. Спасибо за совет, не задумывался что так можно.

peregrine ★★★★★
(22.02.20 20:48:43 MSK)

Ссылка

Ответ на: комментарий от peregrine 22.02.20 20:36:09 MSK

Говорит, что файл есть.

~~RazrFalcon~~ ★★★★★
(22.02.20 20:50:48 MSK) автор топика

Ответ на: комментарий от RazrFalcon 22.02.20 20:50:48 MSK

А какая версия питона в том файле и в системе?

peregrine ★★★★★
(22.02.20 20:54:38 MSK)

Ответ на: комментарий от peregrine 22.02.20 20:54:38 MSK

Везде тройка.

~~RazrFalcon~~ ★★★★★
(22.02.20 20:55:49 MSK) автор топика

Ответ на: комментарий от RazrFalcon 22.02.20 20:55:49 MSK

pydoc3 -w app

Вроде так, если я ничего не попутал. На всякий случай имей бэкап

peregrine ★★★★★
(22.02.20 21:52:24 MSK)
Последнее исправление: peregrine 22.02.20 21:52:34 MSK (всего исправлений: 1)

Ответ на: комментарий от peregrine 22.02.20 21:52:24 MSK

> pydoc3.6 -w app
usage: pydoc3.6 [-h] [FONT]
pydoc3.6: error: unrecognized arguments: -w
problem in app - SystemExit: 2

~~RazrFalcon~~ ★★★★★
(22.02.20 22:15:43 MSK) автор топика

Ответ на: комментарий от RazrFalcon 22.02.20 22:15:43 MSK

Хм, а дистрибутив какой?

peregrine ★★★★★
(22.02.20 23:33:58 MSK)

Ответ на: комментарий от peregrine 22.02.20 23:33:58 MSK

gentoo

~~RazrFalcon~~ ★★★★★
(23.02.20 00:33:28 MSK) автор топика

Ссылка

Вы не можете добавлять комментарии в эту тему: топик перемещен в архив.

← Посетуйте окружение для сборки пакетов (appimage)

Development

Как в сериализаторе проверить, что все field пусты? →

Похожие темы