Вопросы по теме 'docstring'

Добавление строк документации в namedtuples?
Можно ли простым способом добавить строку документации в namedtuple? Я пытался from collections import namedtuple Point = namedtuple("Point", ["x", "y"]) """ A point in 2D space """ # Yet another test """ A(nother) point in 2D space """...
14684 просмотров
schedule 11.04.2022

Как изменить строку документации класса TestCase в Python?
В Python 2.5 (на самом деле Jython) для класса UnitTest TestCase - нет метода SetUpClass, и __init__ на самом деле неприемлемо (без ссылки на себя). Когда я пытаюсь изменить строку документации внутри TestCase: import os fileName =...
1303 просмотров

Как я могу распечатать строку документации файла Python при его выполнении?
У меня есть скрипт Python со строкой документации. Когда синтаксический анализ аргументов командной строки не удается, я хочу распечатать строку документации для информации пользователя. Есть какой-либо способ сделать это? Минимальный пример...
32431 просмотров
schedule 05.03.2023

Математическое выражение в строке документации неправильно отображается Sphinx
Я пытался выяснить, что не так с этим выражением в моей строке документации. Я использую расширение sphinx.ext.mathjax в python sphinx v1.2b. Строка документации: .. math:: w_k^* = \min_{w_k} \ell_k(w_k) + \lambda\left(\alpha||w_k||_1...
2702 просмотров
schedule 03.07.2022

Python — использование decorator.py для сохранения строки документации метода
Меня интересует вызов метода экземпляра как метода класса, так и метода экземпляра. Это можно сделать с помощью декоратора class_or_instance следующим образом: class class_or_instance(object): def __init__(self, fn): self.fn = fn...
974 просмотров
schedule 11.06.2023

Как запретить PyCharm заполнять строки документации?
Если я добавлю строку документации к методу, используя тройную кавычку, как только я наберу пробел после тройной кавычки, PyCharm заполнит строку документации параметрами, которые принимает метод, и возвращаемым значением, например так: def...
3444 просмотров
schedule 20.09.2022

Доступ к комментарию пакета из программы Go?
Можно ли получить комментарий к пакету изнутри программы Go? Эквивалентный код Python: #!/usr/bin/env python """ Program v1.0 """ print(__doc__)
391 просмотров
schedule 24.02.2023

Автоматическое создание строк документации Python в Visual Studio Express 2013
Есть ли способ автоматически генерировать строки документации для python в Visual Studio Express 2013? Если я правильно помню, в PyCharm, если вы вводите «»» после заголовка функции/класса, он автоматически генерирует строку документации, похожую на...
763 просмотров

Могу ли я отформатировать строку документации в python3
Я пытаюсь создать строку документации, которая будет принимать поля замены следующим образом. def run_tests(args): """run tests on methods in {0} usage: {0} --tests """.format(__file__) pass но когда я запускаю...
2089 просмотров
schedule 08.07.2022

Создание API из строк документации Python, написанных в PEP8
Я написал код на Python. Я старался следовать общепринятым правилам написания полезных комментариев в начале функций. Мой стиль - PEP8, например. def __init__(self, f_name=None, list_=None, cut_list=None, n_events=None, description=None):...
144 просмотров
schedule 17.06.2022

Что отличает аргумент с ключевым словом от аргумента без ключевого слова в Python?
Я пытаюсь понять разницу между аргументами, не являющимися ключевыми словами, и аргументами ключевого слова. Мне кажется, что каждый аргумент можно использовать и как ключевой аргумент. def print_employee_details(name, age=0, location=None):...
59 просмотров

Как можно хранить три двойных кавычки в строке документации Python?
У меня есть большой логотип ASCII, который я хочу сохранить в строке документации. Этот логотип содержит несколько экземпляров трех последовательных двойных кавычек. Размер и сложность таковы, что экранирование отдельных символов нереально....
103 просмотров
schedule 22.12.2022

Как установить и получить строку документации с несколькими методами в clojure?
Я использую мультиметоды для анализа команд командной строки и их аргументов. (defmulti run (fn [command args] command)) (defmethod run :default [& _] ...) ^{:args "[command]"} (defmethod run "help" [_ & [args]] "Display command...
183 просмотров
schedule 04.06.2023

Документирование назначенных функций первого класса
У меня есть функция, определенная с использованием первоклассной природы функций Python, а именно: add_relative = np.frompyfunc(lambda a, b: (1 + a) * (1 + b) - 1, 2, 1) Либо мне нужен способ добавить строку документации к функции,...
116 просмотров

Измените формат reStructuredText в PyCharm для автоматического создания комментариев
В документации JetBrains говорится, что существует два формата для создания reStructuredText комментарии с подсказками : :param param_type param_name: parameter description (type description is on the same line as the parameter description)....
429 просмотров

PyDev не показывает строку документации
Я работаю с PyDev в Eclipse, и по какой-то причине он не показывает строку документации, когда я наводил курсор на функцию. Что также не работает, так это переход к функции при нажатии F3. Обе функции работают на компьютере моего коллеги. Мы...
256 просмотров

Какой стиль PyCharm/IntelliJ использует для строк документации Python?
Я пытаюсь понять «экосистему решений» в отношении создания строк документации, а затем создания хорошей справочной документации с помощью PyCharm/IntelliJ. Я привык к строкам документации в стиле Google, и меня смущает формат/стиль скелета строки...
1407 просмотров
schedule 12.10.2023

как отобразить строку документации Unicode, вызвав help () в режиме ожидания
Когда функция определена в Python, тройные кавычки представляют строку документации. Но азиатские символы, используемые в строке документации, неправильно отображаются в IDLE для MacOS. Они отображаются в виде строки Unicode, например '\ uc778 \...
288 просмотров
schedule 14.05.2022

Убедитесь, что проект Python правильно задокументирован
У меня есть куча проектов Python v3.6. Я использую codestyle, чтобы убедиться, что они совместимы с PEP8. Есть ли способ использовать стиль кода (или любой другой инструмент), чтобы проверить, что все функции, классы и методы в моих модулях...
45 просмотров
schedule 10.10.2022

Утверждение и документация в классе для методов, ожидаемых в производных классах [дубликаты]
Скажем, я создаю класс с именем Bird, который я хочу использовать только как родительский класс, а производные классы должны иметь метод flap_wings : class Bird: def fly(self): self.flap_wings() Ожидаемый производный класс может...
303 просмотров