testing_project/Documentation: dev_guide/python_style_guide — Russian @ Weblate: my

The translation is temporarily closed for contributions due to maintenance, please come back later.
The translation was automatically locked due to following alerts: Could not merge the repository.

Zen

Translation

English

Russian

Needs editing

Skip

	English	Russian	Actions
	Two good reasons to break a particular rule:	Правила можно нарушить по одной из этих причин:
	When applying the rule would make the code less readable, even for someone who is used to reading code that follows the rules.	Если применение правила сделает код менее читаемым даже для того, кто привык читать код, написанный по правилам.
	To be consistent with surrounding code that also breaks it (maybe for historic reasons) -- although this is also an opportunity to clean up someone else's mess (in true XP style).	Чтобы не отступать по стилю от уже написанного не по правилам кода (возможно, в силу исторических причин) -- впрочем, это может быть возможность причесать чужой код (в стиле XP).
	Code lay-out	Размещение кода
	Indentation	Отступы
	Use 4 spaces per indentation level.	Используйте 4 пробела на каждый уровень отступа.
	For really old code that you don't want to mess up, you can continue to use 8-space tabs.	Если вы не хотите наводить путаницу в очень старом коде, можете продолжать использовать отступы в 8 пробелов.
	Continuation lines should align wrapped elements either vertically using Python's implicit line joining inside parentheses, brackets and braces, or using a hanging indent. When using a hanging indent the following considerations should be applied; there should be no arguments on the first line and further indentation should be used to clearly distinguish itself as a continuation line.	Продолжения строк должны выравнивать переносимые элементы либо вертикально, используя подразумевающееся объединение строк в скобках (круглых, квадратных или фигурных), либо с использованием висячего отступа. При использовании висячего отступа необходимо применять следующие соображения: на первой строке не должно быть аргументов, а остальные строки должны четко восприниматься как продолжение строки.
	Yes::	Правильно::
	# Aligned with opening delimiter foo = long_function_name(var_one, var_two, var_three, var_four) # More indentation included to distinguish this from the rest. def long_function_name( var_one, var_two, var_three, var_four): print(var_one)	# выравнивание по открывающему разделителю foo = long_function_name(var_one, var_two, var_three, var_four) # больше отступов, чтобы данный сегмент отличался от остальных. def long_function_name( var_one, var_two, var_three, var_four): print(var_one)
	No::	Неправильно::
	# Arguments on first line forbidden when not using vertical alignment foo = long_function_name(var_one, var_two, var_three, var_four) # Further indentation required as indentation is not distinguishable def long_function_name( var_one, var_two, var_three, var_four): print(var_one)	# запрещены аргументы на первой строке, если не используется вертикальное выравнивание foo = long_function_name(var_one, var_two, var_three, var_four) # необходимы дополнительные отступы для четких отличий def long_function_name( var_one, var_two, var_three, var_four): print(var_one)
	Optional::	Возможно::
	# Extra indentation is not necessary. foo = long_function_name( var_one, var_two, var_three, var_four)	# Нет необходимости в дополнительных отступах. foo = long_function_name( var_one, var_two, var_three, var_four)
	The closing brace/bracket/parenthesis on multi-line constructs may either line up under the first non-whitespace character of the last line of list, as in::	Закрывающие круглые/квадратные/фигурные скобки в многострочных конструкциях могут находиться либо под первым символом последней строки списка (не пробелом), например:
	my_list = [ 1, 2, 3, 4, 5, 6, ] result = some_function_that_takes_arguments( 'a', 'b', 'c', 'd', 'e', 'f', )	my_list = [ 1, 2, 3, 4, 5, 6, ] result = some_function_that_takes_arguments( 'a', 'b', 'c', 'd', 'e', 'f', )
	or it may be lined up under the first character of the line that starts the multi-line construct, as in::	либо под первым символом строки, с которой начинается многострочная конструкция:
	my_list = [ 1, 2, 3, 4, 5, 6, ] result = some_function_that_takes_arguments( 'a', 'b', 'c', 'd', 'e', 'f', )	my_list = [ 1, 2, 3, 4, 5, 6, ] result = some_function_that_takes_arguments( 'a', 'b', 'c', 'd', 'e', 'f', )
	Tabs or Spaces?	Табуляция или пробелы?
	Never mix tabs and spaces.	Никогда не смешивайте символы табуляции и пробелы.
	The most popular way of indenting Python is with spaces only. The second-most popular way is with tabs only. Code indented with a mixture of tabs and spaces should be converted to using spaces exclusively. When invoking the Python command line interpreter with the ``-t`` option, it issues warnings about code that illegally mixes tabs and spaces. When using ``-tt`` these warnings become errors. These options are highly recommended!	Самый распространенный способ отступов в Python -- пробелы. На втором месте -- отступы только с использованием табуляции. Код, в котором используются и те, и другие типы отступов, следует исправить так, чтобы отступы в нем были расставлены только с помощью пробелов. При вызове интерпретатора в командной строке с параметром ``-t`` он выдаст предупреждение в случае использовании смешанного стиля в отступах. Запустив интерпретатор с параметром -tt, вы получите в этих местах ошибки. Рекомендуем использовать эти опции!
	For new projects, spaces-only are strongly recommended over tabs. Most editors have features that make this easy to do.	В новых проектах для отступов настоятельно рекомендуется использовать только пробелы. Во многих редакторах можно легко это делать.
	Maximum Line Length	Максимальная длина строки
	Limit all lines to a maximum of 79 characters.	Ограничьте максимальную длину строки 79 символами.
	There are still many devices around that are limited to 80 character lines; plus, limiting windows to 80 characters makes it possible to have several windows side-by-side. The default wrapping on such devices disrupts the visual structure of the code, making it more difficult to understand. Therefore, please limit all lines to a maximum of 79 characters. For flowing long blocks of text (docstrings or comments), limiting the length to 72 characters is recommended.	Пока еще есть немало устройств, где длина строки ограничена 80 символами; к тому же, ограничив ширину окна 80 символами, мы можем расположить несколько окон рядом друг с другом. Автоматический перенос строк на таких устройствах нарушит форматирование, и код будет труднее понять. Поэтому ограничьте длину строки 79 символами. Для длинных блоков текста (строки документации или комментарии) рекомендуется ограничиваться 72 символами.
	The preferred way of wrapping long lines is by using Python's implied line continuation inside parentheses, brackets and braces. Long lines can be broken over multiple lines by wrapping expressions in parentheses. These should be used in preference to using a backslash for line continuation.	Предпочтительный способ переноса длинных строк -- использование подразумевающегося продолжения строки между обычными, квадратными и фигурными скобками. Длинные строки можно разбить на несколько строк в скобках. Это лучше, чем использовать обратную косую черту для продолжения строки.
	Backslashes may still be appropriate at times. For example, long, multiple ``with``-statements cannot use implicit continuation, so backslashes are acceptable::	Обратную косую черту можно использовать время от времени. Например, длинный оператор with не может работать с неявными продолжениями, так что обратная косая черта здесь подойдет:
	with open('/path/to/some/file/you/want/to/read') as file_1, \ open('/path/to/some/file/being/written', 'w') as file_2: file_2.write(file_1.read())	with open('/path/to/some/file/you/want/to/read') as file_1, \ open('/path/to/some/file/being/written', 'w') as file_2: file_2.write(file_1.read())
	Another such case is with ``assert`` statements.	Еще один такой случай -- операторы ``assert``.
	Make sure to indent the continued line appropriately. The preferred place to break around a binary operator is after the operator, not before it. Some examples::	Делайте правильные отступы для перенесенной строки. Предпочтительнее вставить перенос строки после логического оператора, а не перед ним. Например:
	class Rectangle(Blob): def __init__(self, width, height, color='black', emphasis=None, highlight=0): if (width == 0 and height == 0 and color == 'red' and emphasis == 'strong' or highlight > 100): raise ValueError("sorry, you lose") if width == 0 and height == 0 and (color == 'red' or emphasis is None): raise ValueError("I don't think so -- values are %s, %s" % (width, height)) Blob.__init__(self, width, height, color, emphasis, highlight)	class Rectangle(Blob): def __init__(self, width, height, color='black', emphasis=None, highlight=0): if (width == 0 and height == 0 and color == 'red' and emphasis == 'strong' or highlight > 100): raise ValueError("sorry, you lose") if width == 0 and height == 0 and (color == 'red' or emphasis is None): raise ValueError("I don't think so -- values are %s, %s" % (width, height)) Blob.__init__(self, width, height, color, emphasis, highlight)