ну мэйн квест

а я на него насрал

и пошел становится магистром в колледже

вон в эрдель скроллс онлайн пока играл, тоже по мейн квесту шел

Я в TES вообще на хую вертел мейн квесты. Хотя история с Нереварином по итогу меня покорила. Сильнейшая тема. Очень взрослая и глубокая

Знакомый вообще в Морровинде книжки читал 8)

Парни, есть ли у питона стандарт описания функций? Что то вроде: def func(arg1, arg2): """The func Args: arg1 (str): This is the first argument arg2 (dict): This is the second argument """ pass Изучил кучу популярных библиотек - везде свой формат.

Эм

У тебя же в doc первый коммент записывается

https://www.python.org/dev/peps/pep-0257/

и http://www.sphinx-doc.org/en/stable/ext/autodoc.html

официально докстринги питона должны быть в плейнтексте или ресте

https://www.python.org/dev/peps/pep-0257/

Т.е. вот это и есть стандарт? """Form a complex number. Keyword arguments: real -- the real part (default 0.0) imag -- the imaginary part (default 0.0) """

конвеншены = соглашения

если ты будешь генерить апи доки - тогда надо следовать генератору доков

Первый коммент записывается в __doc__.

сфинкс сейчас стандарт де факто, раньше докутилсы юзали

Первый коммент записывается в __doc__.

полагаю он и так это знает, но вопрос не об этом же

у 257 статус информационного, а не нормативного

сфинкс сейчас стандарт де факто, раньше докутилсы юзали

А стандартная документация чем сгенерирована?

сфинксом

Для чего тогда существует pydoc?

Считается ли хорошим тоном использование type hints?

в морровинде я по мэйнквесту дошел только до излечения от корпруса. Зато был лидером дома телвани

сфинксом

А что он делает, если в двух словах? Мне чет казалось, что вся документация выдирается из __doc__

Для чего тогда существует pydoc?

пидок страшен как ядерная война

сфинкс жрёт на входе набор файликов в текстовом формате и на выходе генерирует доки в хуевой туче форматов - хтмл, пдф, епаб, цхм

пидок страшен как ядерная война

Ага, глянул уже скриншоты:)

плюс умеет кучу всячины, например дёргать инфу из исходников и генерировать апи доки

Какие айлики?

Пайтоновские?

текстовые

вот например родная дока самого питона - https://hg.python.org/cpython/file/tip/Doc все *.rst файлы там

А как генерят вот такие штуки? http://docs.python-guide.org/en/latest/

это всё тот же сфинкс

только другая тема натянута

по quick search палиццо

Понял, спасибо!

Ну текст то не он пишет

вот например родная дока самого питона - https://hg.python.org/cpython/file/tip/Doc все *.rst файлы там

А *.md он понимает?

нахуй это говно

мд заточен под хтмл

рест лучше

Зарт, откуда текст?

какой?

По ссылке, что ты скинул. Я так понял, там сгенерено всё

что? *.rst файлы написаны от руки. это не генерация

А сфинкс тогда причем?

сфинкс натравливается на эти исходники, и генерирует хтмлки - те что выложены на doc.python.org

в виндовом питоне эти же доки сгенерены в.chm файлик и их пакует инсталлятор питона

https://hg.python.org/cpython/file/tip/Doc/contents.rst вот это мастер файл, с которого вся дока питона танцует

сравни с https://docs.python.org/3/

http://www.wilfred.me.uk/blog/2012/07/30/why-markdown-is-not-my-favourite-language/ а вот тут про кучу мелочей которые делают маркдаун полным говном для документации и не только

если после чтения тех примеров кто-то еще хочет писать доки в маркдауне... безумству храбрых поем мы песню

http://www.wilfred.me.uk/blog/2012/07/30/why-markdown-is-not-my-favourite-language/ а вот тут про кучу мелочей которые делают маркдаун полным говном для документации и не только

читаю

только надо учесть что этот пост рассматривает язык разметки на вебе. рест же делался под документацию изначально, в отличие от маркдауна, который клепали под вебовскую <textarea>

omg, не знал что rst был создан для python документации

ну да..

https://mail.python.org/pipermail/doc-sig/2001-June/001858.html

2001й год, гм

http://nshipster.com/swift-documentation/ бгыг... а эпл перешла с собственного формата сперва на рест, а потом на очередной диалект маркдауна..

На днях задался вопросом: стоит ли явно указывать return None в функциях, если она по умолчанию возвращает None?

я использую просто return если надо выйти раньше

return и return None по факту имеют одинаковый результат

для лентяев и не любителей панелей https://github.com/RoverWire/virtualhost

ERROR: S client not available

я использую просто return если надо выйти раньше

У меня много кейсов такого типа: if status == 'OK': return {'result': True} else: return None И вот тут я не решил, стоит ли указавать явно (дзен питона) или же оставить только первую часть конструкции, т.к. если условие не выполняется функция вернет None по умолчанию

я бы тот елсе выкинул

Вот и я склоняюсь к такому варианту

А я бы исключение бросал, если status is not 'OK'

result = None if status == 'OK': result = {'result': True} return result

Кстати, кто то знает почему определение списка вот так [] работает медленнее чем вот так list(), при этом вот это [1, 2, 3] работает быстрее чем это list(1, 2, 3)

result = None if status == 'OK': result = {'result': True} return result

Иногда использую это решение

[] не должен быть медленее...

этот вариант обычно рождается в процессе рефакторинга, когда вариантов больше двух. Иногда таким и остается, потому что он читабелен и не вызывает никаких сомнений в том, что именно тут происходит

>>> dis.dis(compile('[]', '', 'eval')) 1 0 BUILD_LIST 0 3 RETURN_VALUE None >>> dis.dis(compile('list()', '', 'eval')) 1 0 LOAD_NAME 0 (list) 3 CALL_FUNCTION 0 6 RETURN_VALUE

[] - это встроенный опкод, а list() - это вызов функции

[] не должен быть медленее...

Тестировал с помощью timeit, [] действительно медленнее

на практике разницы будет никакой

вдобавок разные версии питона могут иметь разную скорость, в зависимости от изменений в реализации

Чето не понял как я так тестировал, но сейчас получил следующие результаты:

Какую книгу начать читать по пайтону?) с Лутца нормально будет?) посоветуйте, плз)

>>> dis.dis(compile('[]', '', 'eval')) 1 0 BUILD_LIST 0 3 RETURN_VALUE None >>> dis.dis(compile('list()', '', 'eval')) 1 0 LOAD_NAME 0 (list) 3 CALL_FUNCTION 0 6 RETURN_VALUE

dis - это дизассемблирование?

Какую книгу начать читать по пайтону?) с Лутца нормально будет?) посоветуйте, плз)

С документации:)

да, в байткоды

что за мода постить текст картинками в даунлоадах...

Даж если вообще нулячий?)

С документации:)

что за мода постить текст картинками в даунлоадах...

Десктоп клиент так грузит, если слать без сжатия

слать что, бля, текст?

Даж если вообще нулячий?)

если проблеммы с мотивацией и усидчивостью, возьми доусена

Знаю только как через вайл подбросить 100 раз монету и чтобы рандомно выпадал орел или решок?

Даж если вообще нулячий?)

Да

D:\>py -2.7 -m timeit "[]" 10000000 loops, best of 3: 0.0303 usec per loop D:\>py -2.7 -m timeit "list()" 10000000 loops, best of 3: 0.131 usec per loop D:\>py -3.5 -m timeit "[]" 10000000 loops, best of 3: 0.0314 usec per loop D:\>py -3.5 -m timeit "list()" 10000000 loops, best of 3: 0.151 usec per loop list() в пять раз медленее

D:\>py -2.7 -m timeit "[]" 10000000 loops, best of 3: 0.0303 usec per loop D:\>py -2.7 -m timeit "list()" 10000000 loops, best of 3: 0.131 usec per loop D:\>py -3.5 -m timeit "[]" 10000000 loops, best of 3: 0.0314 usec per loop D:\>py -3.5 -m timeit "list()" 10000000 loops, best of 3: 0.151 usec per loop list() в пять раз медленее

У меня в 3 раза получилось.

ну плюс минус скорость компа, я хз... плюс это тест был 64-бит версии