coding-style ×6
Создан 09.01.2025
0
голоса
4
ответов
34
просмотров
JavaDoc: где добавлять заметки/пояснения в документацию?

Вопрос на StackOverflow:

Я всегда находил тег remarks в C# очень полезным для предоставления замечаний о реализации класса или метода, а также для передачи информации о теории того, что я реализовывал. Сейчас я перешёл на Java, но не могу найти соответствующий тег JavaDoc для этой цели. Может...

0
голоса
3
ответов
16
просмотров
Следует ли добавлять запятую после последнего аргумента в вызове функции? [закрыто]

Проблема с использованием запятой в вызовах функций в Python

Я столкнулся с вопросом о том, как правильно форматировать вызов функции в Python, особенно в отношении использования завершающей запятой. Рассмотрим следующие примеры:

  1. Что лучше использовать?
    self.call(1, True,...
    
0
голоса
5
ответов
15
просмотров
Хорошая ли практика использовать порядковый номер enum?

У меня есть перечисление (enum):

public enum Persons {

    CHILD,
    PARENT,
    GRANDPARENT;

}

Есть ли какие-либо проблемы с использованием метода ordinal() для проверки "иерархии" между членами перечисления? Я имею в виду - есть ли какие-то недостатки при использовании этого...

0
голоса
1
ответов
18
просмотров
Инициализация/декларация атрибутов в классе Python: где их размещать?

Я задумался, какой способ инициализации атрибутов объектов в Python считается наилучшей практикой: делать это в теле класса или внутри функции __init__?

Например, есть такой подход:

class A(object):
    foo = None

или такой:

class A(object):
    def __init__(self):
  ...
7
голоса
5
ответов
32
просмотров
Одинарные и двойные кавычки в Python [закрыто]

Проблема заключается в том, что согласно документации, рассматриваемые термины в значительной степени взаимозаменяемы. Однако у меня возникает вопрос: существуют ли стилистические причины предпочитать один термин другому?

11
голоса
0
ответов
52
просмотров
Какие самые распространенные форматы docstring в Python? [закрыт]

Проблема:

Я столкнулся с вопросом о различных стилях написания docstring'ов в Python. В сообществе обсуждаются разные подходы, и мне хотелось бы узнать, какие из них являются наиболее популярными и общепринятыми. Например, существуют ли какие-то стандарты или рекомендации по форматированию...