Style Guide for Python Code

→Always decide whether a class's methods and instance variables (collectively: "attributes") should be public or non-public. If in doubt, choose non-public; it's easier to make it public later than to make a public attribute non-public.
0 Всегда (необходимо, прим. пер.) решить, публичными или не публичными должны быть методы класса и переменные экземпляра (далее: "атрибуты"). В случае сомнений, выберите не публичный, ведь проще потом сделать его публичным, чем публичный атрибут не публичным.
→Designing for inheritance
0 Наследование
→Constants are usually declared on a module level and written in all capital letters with underscores separating words. Examples include MAX_OVERFLOW and TOTAL.
0 Константы обычно определяются на уровне модуля и пишутся целиком прописными буквами с символом подчеркивания в качестве разделителя слов. Как пример: MAX_OVERFLOW и TOTAL.
→Generally, double leading underscores should be used only to avoid name conflicts with attributes in classes designed to be subclassed.
0 Как правило, двойные подчеркивания в начале (имени, прим. пер.) должны использоваться только, чтобы избежать конфликтов имен с атрибутами внутри классов наследников.
→Python mangles these names with the class name: if class Foo has an attribute named __a, it cannot be accessed by Foo.__a. (An insistent user could still gain access by calling Foo._Foo__a.)
0 Python обрабатывает эти имена с именем класса: если класс Foo имеет атрибут с именем __a, он не будет доступен по (вызову, прим. пер.) Foo.__a. (Упорный пользователь может получить доступ вызовом Foo._Foo__a.)
→Use one leading underscore only for non-public methods and instance variables.
0 Символ подчеркивания в начале (имени, прим. пер.) используйте только для непубличных методов и переменных экземпляра.
→Use the function naming rules: lowercase with words separated by underscores as necessary to improve readability.
0 Используйте правила именования функций: слова состоящие из строчных букв, разделенные символом подчеркивания, в количестве необходимом для повышения читабельности.
→If a function argument's name clashes with a reserved keyword, it is generally better to append a single trailing underscore rather than use an abbreviation or spelling corruption. Thus "print_" is better than "prnt". (Perhaps better is to avoid such clashes by using a synonym.)
0 Если имя аргумента функции совпадает с зарезервированным ключевым словом, как правило, лучше добавить одно нижнее подчеркивание, чем использовать сокращение или орфографические коррупции. Таким образом, "print_" лучше, чем "prnt". (Возможно, лучше избегать таких совпадений, используя синонимы.)
Резюме
Пол:
мужчина
Родной язык:
русский
С нами:
с 22 июня 2011 г. (5598 дней)
Не является членом клуба.
Деятельность:
8 версий перевода с общим рейтингом 0
Карма: 1 (оценок: 1)
Написать Equilibrious личное сообщение