[python-ru] Updating Russian translation of the Python 2.x tutorial

ru-ru/python-ru.html.markdown

@@ -5,25 +5,29 @@ contributors:
     - ["Louie Dinh", "http://ldinh.ca"]
 translators:
     - ["Yury Timofeev", "http://twitter.com/gagar1n"]
+    - ["Andre Polykanine", "https://github.com/Oire"]
 filename: learnpython-ru.py
 ---
 
-Язык Python был создан Гвидо ван Россумом в начале 90-х. Сейчас это один из самых популярных 
+Язык Python был создан Гвидо ван Россумом в начале 90-х. Сейчас это один из
-языков. Я люблю его за его понятный и доходчивый синтаксис - это почти что исполняемый псевдокод.
+самых популярных языков. Я люблю его за понятный и доходчивый синтаксис  — это
+почти что исполняемый псевдокод.
 
-С благодарностью жду ваших отзывов: [@louiedinh](http://twitter.com/louiedinh) или louiedinh [at] [google's email service]
+С благодарностью жду ваших отзывов: [@louiedinh](http://twitter.com/louiedinh)
+или louiedinh [at] [почтовый сервис Google]
 
-Замечание: Эта статья относится к Python 2.7, но должно работать и в Python 2.x. Скоро будет версия и для Python 3!
+Замечание: Эта статья относится к Python 2.7, но должно работать и в Python 2.x.
+Скоро будет версия и для Python 3!
 
 ```python
-# Однострочные комментарии начинаются с hash-символа.
+# Однострочные комментарии начинаются с символа решётки.
 """ Многострочный текст может быть 
     записан, используя 3 знака " и обычно используется
     в качестве комментария
 """
 
 ####################################################
-## 1. Примитивные типы данных и операторов
+## 1. Примитивные типы данных и операторы
 ####################################################
 
 # У вас есть числа
@@ -36,17 +40,31 @@ filename: learnpython-ru.py
 35 / 5 #=> 7
 
 # А вот деление немного сложнее. В этом случае происходит деление 
-# целых чисел и результат автоматически округляется в меньшую сторону.
+# целых чисел, и результат автоматически округляется в меньшую сторону.
 5 / 2 #=> 2
 
-# Чтобы научиться делить, сначала нужно немного узнать о дробных числах.
+# Чтобы научиться делить, сначала нужно немного узнать о числах
-2.0     # Это дробное число
+# с плавающей запятой.
+2.0     # Это число с плавающей запятой
 11.0 / 4.0 #=> 2.75 Вооот... Так гораздо лучше
 
+# Результат целочисленного деления округляется в меньшую сторону
+# как для положительных, так и для отрицательных чисел.
+5 // 3     # => 1
+5.0 // 3.0 # => 1.0 # работает и для чисел с плавающей запятой
+-5 // 3  # => -2
+-5.0 // 3.0 # => -2.0
+
+# Остаток от деления
+7 % 3 # => 1
+
+# Возведение в степень
+2 ** 4 # => 16
+
 # Приоритет операций указывается скобками
 (1 + 3) * 2 #=> 8
 
-# Логические значения являются примитивами
+# Логические (булевы) значения являются примитивами
 True
 False
 
@@ -54,15 +72,15 @@ False
 not True #=> False
 not False #=> True
 
-# Равенство это ==
+# Равенство — это ==
 1 == 1 #=> True
 2 == 1 #=> False
 
-# Неравенство это !=
+# Неравенство — это !=
 1 != 1 #=> False
 2 != 1 #=> True
 
-# Еще немного сравнений
+# Ещё немного сравнений
 1 < 10 #=> True
 1 > 10 #=> False
 2 <= 2 #=> True
@@ -85,9 +103,10 @@ not False #=> True
 # Символ % используется для форматирования строк, например:
 "%s могут быть %s" % ("строки", "интерполированы")
 
-# Новый метод форматирования строк - использование метода format.
+# Новый способ форматирования строк — использование метода format.
 # Это предпочитаемый способ.
 "{0} могут быть {1}".format("строки", "форматированы")
+
 # Если вы не хотите считать, можете использовать ключевые слова.
 "{name} хочет есть {food}".format(name="Боб", food="лазанью")
 
@@ -95,7 +114,7 @@ not False #=> True
 None #=> None
 
 # Не используйте оператор равенства '=='' для сравнения 
-# объектов с None. Используйте для этого 'is'
+# объектов с None. Используйте для этого «is»
 "etc" is None #=> False
 None is None  #=> True
 
@@ -113,17 +132,18 @@ None is None  #=> True
 ## 2. Переменные и коллекции
 ####################################################
 
-# Печатать довольно просто
+# У Python есть функция Print, доступная в версиях 2.7 и 3,
-print "Я Python. Приятно познакомиться!"
+print("Я Python. Приятно познакомиться!")
-
+# ...и старый оператор print, доступный в версиях 2.x, но удалённый в версии 3.
+print "И я тоже Python!"
 
 # Необязательно объявлять переменные перед их инициализацией.
-some_var = 5    # По соглашению используется нижний_регистр_с_подчеркиваниями
+some_var = 5    # По соглашению используется нижний_регистр_с_подчёркиваниями
 some_var #=> 5
 
-# При попытке доступа к неинициализированной переменной,
+# При попытке доступа к неинициализированной переменной
 # выбрасывается исключение.
-# См. раздел "Поток управления" для информации об исключениях.
+# См. раздел «Поток управления» для информации об исключениях.
 some_other_var  # Выбрасывает ошибку именования
 
 # if может быть использован как выражение
@@ -149,24 +169,30 @@ li[0] #=> 1
 # Обратимся к последнему элементу
 li[-1] #=> 3
 
-# Попытка выйти за границы массива приведет к IndexError
+# Попытка выйти за границы массива приведёт к ошибке индекса
-li[4] # Выдает IndexError
+li[4] # Выдаёт IndexError
 
 # Можно обращаться к диапазону, используя "кусочный синтаксис" (slice syntax)
-# (Для тех, кто любит математику, это называется замкнуто/открытый интервал.)
+# (Для тех, кто любит математику, это называется замкнуто-открытый интервал).
 li[1:3] #=> [2, 4]
 # Опускаем начало
 li[2:] #=> [4, 3]
 # Опускаем конец
 li[:3] #=> [1, 2, 4]
+# Выбираем каждый второй элемент
+li[::2]   # =>[1, 4]
+# Переворачиваем список
+li[::-1]   # => [3, 4, 2, 1]
+# Используйте сочетания всего вышеназванного для выделения более сложных кусков
+# li[начало:конец:шаг]
 
 # Удаляем произвольные элементы из списка оператором del
 del li[2] # [1, 2, 3]
 
 # Вы можете складывать списки
-li + other_li #=> [1, 2, 3, 4, 5, 6] - Замечание: li и other_li остаются нетронутыми
+li + other_li #=> [1, 2, 3, 4, 5, 6]  — Замечание: li и other_li не изменяются
 
-# Конкатенировать списки можно методом extend
+# Объединять списки можно методом extend
 li.extend(other_li) # Теперь li содержит [1, 2, 3, 4, 5, 6]
 
 # Проверить элемент на вхождение в список можно оператором in
@@ -176,12 +202,12 @@ li.extend(other_li) # Теперь li содержит [1, 2, 3, 4, 5, 6]
 len(li) #=> 6
 
 
-# Кортежи - это такие списки, только неизменяемые
+# Кортежи — это такие списки, только неизменяемые
 tup = (1, 2, 3)
 tup[0] #=> 1
-tup[0] = 3  # Выдает TypeError
+tup[0] = 3  # Выдаёт TypeError
 
-# Все то же самое можно делать и с кортежами
+# Всё то же самое можно делать и с кортежами
 len(tup) #=> 3
 tup + (4, 5, 6) #=> (1, 2, 3, 4, 5, 6)
 tup[:2] #=> (1, 2)
@@ -203,33 +229,33 @@ filled_dict = {"one": 1, "two": 2, "three": 3}
 # Значения ищутся по ключу с помощью оператора []
 filled_dict["one"] #=> 1
 
-# Можно получить все ключи в виде списка
+# Можно получить все ключи в виде списка с помощью метода keys
 filled_dict.keys() #=> ["three", "two", "one"]
-# Замечание - сохранение порядка ключей в словаре не гарантируется
+# Замечание: сохранение порядка ключей в словаре не гарантируется
 # Ваши результаты могут не совпадать с этими.
 
-# Можно получить и все значения в виде списка
+# Можно получить и все значения в виде списка, используйте метод values
 filled_dict.values() #=> [3, 2, 1]
-# То же самое замечание насчет порядка ключей справедливо и здесь
+# То же самое замечание насчёт порядка ключей справедливо и здесь
 
 # При помощи оператора in можно проверять ключи на вхождение в словарь
 "one" in filled_dict #=> True
 1 in filled_dict #=> False
 
-# Попытка получить значение по несуществующему ключу выбросит KeyError
+# Попытка получить значение по несуществующему ключу выбросит ошибку ключа
 filled_dict["four"] # KeyError
 
 # Чтобы избежать этого, используйте метод get
 filled_dict.get("one") #=> 1
 filled_dict.get("four") #=> None
-# Метод get также принимает аргумент default, значение которого будет
+# Метод get также принимает аргумент по умолчанию, значение которого будет
 # возвращено при отсутствии указанного ключа
 filled_dict.get("one", 4) #=> 1
 filled_dict.get("four", 4) #=> 4
 
-# Метод setdefault - это безопасный способ добавить новую пару ключ-значение в словарь
+# Метод setdefault вставляет пару ключ-значение, только если такого ключа нет
 filled_dict.setdefault("five", 5) #filled_dict["five"] возвращает 5
-filled_dict.setdefault("five", 6) #filled_dict["five"] по прежнему возвращает 5
+filled_dict.setdefault("five", 6) #filled_dict["five"] по-прежнему возвращает 5
 
 
 # Множества содержат... ну, в общем, множества
@@ -237,8 +263,8 @@ empty_set = set()
 # Инициализация множества набором значений
 some_set = set([1,2,2,3,4]) # some_set теперь равно set([1, 2, 3, 4])
 
-# Начиная с Python 2.7, вы можете использовать {} чтобы обьявить множество
+# Начиная с Python 2.7, вы можете использовать {}, чтобы объявить множество
-filled_set = {1, 2, 2, 3, 4} # => {1 2 3 4}
+filled_set = {1, 2, 2, 3, 4} # => {1, 2, 3, 4}
 
 # Добавление новых элементов в множество
 filled_set.add(5) # filled_set равно {1, 2, 3, 4, 5}
@@ -262,33 +288,33 @@ filled_set | other_set #=> {1, 2, 3, 4, 5, 6}
 ## 3. Поток управления
 ####################################################
 
-# Для начала заведем переменную
+# Для начала заведём переменную
 some_var = 5
 
 # Так выглядит выражение if. Отступы в python очень важны!
-# результат: "some_var меньше, чем 10"
+# результат: «some_var меньше, чем 10»
 if some_var > 10:
-    print "some_var намного больше, чем 10."
+    print("some_var намного больше, чем 10.")
 elif some_var < 10:    # Выражение elif необязательно.
-    print "some_var меньше, чем 10."
+    print("some_var меньше, чем 10.")
 else:           # Это тоже необязательно.
-    print "some_var равно 10."
+    print("some_var равно 10.")
 
 
 """
 Циклы For проходят по спискам
 
 Результат:
-    собака это млекопитающее
+    собака — это млекопитающее
-    кошка это млекопитающее
+    кошка — это млекопитающее
-    мышь это млекопитающее
+    мышь — это млекопитающее
 """
 for animal in ["собака", "кошка", "мышь"]:
     # Можете использовать оператор % для интерполяции форматированных строк
-    print "%s это млекопитающее" % animal
+    print("%s — это млекопитающее" % animal)
     
 """
-`range(number)` возвращает список чисел
+«range(число)» возвращает список чисел
 от нуля до заданного числа
 Результат:
     0
@@ -297,7 +323,7 @@ for animal in ["собака", "кошка", "мышь"]:
     3
 """
 for i in range(4):
-    print i
+    print(i)
 
 """
 Циклы while продолжаются до тех пор, пока указанное условие не станет ложным.
@@ -309,19 +335,24 @@ for i in range(4):
 """
 x = 0
 while x < 4:
-    print x
+    print(x)
-    x += 1  # То же самое, что x = x + 1
+    x += 1  # Краткая запись для x = x + 1
 
-# Обрабывайте исключения блоками try/except
+# Обрабатывайте исключения блоками try/except
 
 # Работает в Python 2.6 и выше:
 try:
-    # Для выбора ошибки используется raise
+    # Чтобы выбросить ошибку, используется raise
-    raise IndexError("Это IndexError")
+    raise IndexError("Это ошибка индекса")
 except IndexError as e:
     # pass это просто отсутствие оператора. Обычно здесь происходит
-    # восстановление от ошибки.
+    # восстановление после ошибки.
     pass
+except (TypeError, NameError):
+    pass    # Несколько исключений можно обработать вместе, если нужно.
+else:   # Необязательное выражение. Должно следовать за последним блоком except
+    print("Всё хорошо!")   # Выполнится, только если не было никаких исключений
+
 
 
 ####################################################
@@ -330,23 +361,23 @@ except IndexError as e:
 
 # Используйте def для создания новых функций
 def add(x, y):
-    print "x равен %s, а y равен %s" % (x, y)
+    print("x равен %s, а y равен %s" % (x, y))
     return x + y    # Возвращайте результат выражением return
 
 # Вызов функции с аргументами
-add(5, 6) #=> prints out "x равен 5, а y равен 6" и возвращает 11
+add(5, 6) #=> выводит «x равен 5, а y равен 6» и возвращает 11
 
-# Другой способ вызова функции с аргументами
+# Другой способ вызова функции — вызов с именованными аргументами
 add(y=6, x=5)   # Именованные аргументы можно указывать в любом порядке.
 
-# Вы можете определить функцию, принимающую неизвестное количество аргументов
+# Вы можете определить функцию, принимающую изменяемое число аргументов
 def varargs(*args):
     return args
 
 varargs(1, 2, 3) #=> (1,2,3)
 
 
-# А также можете определить функцию, принимающую изменяющееся количество 
+# А также можете определить функцию, принимающую изменяемое число
 # именованных аргументов
 def keyword_args(**kwargs):
     return kwargs
@@ -356,8 +387,8 @@ keyword_args(big="foot", loch="ness") #=> {"big": "foot", "loch": "ness"}
 
 # Если хотите, можете использовать оба способа одновременно
 def all_the_args(*args, **kwargs):
-    print args
+    print(args)
-    print kwargs
+    print(kwargs)
 """
 all_the_args(1, 2, a=3, b=4) выводит:
     (1, 2)
@@ -368,11 +399,28 @@ all_the_args(1, 2, a=3, b=4) выводит:
 # Используйте символ * для передачи кортежей и ** для передачи словарей
 args = (1, 2, 3, 4)
 kwargs = {"a": 3, "b": 4}
-all_the_args(*args) # эквивалент foo(1, 2, 3, 4)
+all_the_args(*args) # эквивалентно foo(1, 2, 3, 4)
-all_the_args(**kwargs) # эквивалент foo(a=3, b=4)
+all_the_args(**kwargs) # эквивалентно foo(a=3, b=4)
-all_the_args(*args, **kwargs) # эквивалент foo(1, 2, 3, 4, a=3, b=4)
+all_the_args(*args, **kwargs) # эквивалентно foo(1, 2, 3, 4, a=3, b=4)
 
-# Python имеет функции первого класса
+# Область определения функций
+x = 5
+
+def setX(num):
+    # Локальная переменная x — это не то же самое, что глобальная переменная x
+    x = num # => 43
+    print (x) # => 43
+    
+def setGlobalX(num):
+    global x
+    print (x) # => 5
+    x = num # Глобальная переменная x теперь равна 6
+    print (x) # => 6
+
+setX(43)
+setGlobalX(6)
+
+# В Python есть функции первого класса
 def create_adder(x):
     def adder(y):
         return x + y
@@ -388,7 +436,7 @@ add_10(3) #=> 13
 map(add_10, [1,2,3]) #=> [11, 12, 13]
 filter(lambda x: x > 5, [3, 4, 5, 6, 7]) #=> [6, 7]
 
-# Мы можем использовать списки для удобного отображения и фильтрации
+# Для удобного отображения и фильтрации можно использовать списочные включения
 [add_10(i) for i in [1, 2, 3]]  #=> [11, 12, 13]
 [x for x in [3, 4, 5, 6, 7] if x > 5] #=> [6, 7]
 
@@ -402,7 +450,11 @@ class Human(object):
     # Атрибут класса. Он разделяется всеми экземплярами этого класса
     species = "H. sapiens"
 
-    # Обычный конструктор
+    # Обычный конструктор, вызывается при инициализации экземпляра класса
+    # Обратите внимание, что двойное подчёркивание в начале и в конце имени
+    # означает объекты и атрибуты, которые используются Python, но находятся
+    # в пространствах имён, управляемых пользователем.
+    # Не придумывайте им имена самостоятельно.
     def __init__(self, name):
         # Присваивание значения аргумента атрибуту класса name
         self.name = name
@@ -423,17 +475,17 @@ class Human(object):
         return "*grunt*"
 
 
-# Инстанцирование класса
+# Инициализация экземпляра класса
 i = Human(name="Иван")
-print i.say("привет")     # "Иван: привет"
+print(i.say("привет"))     # Выводит: «Иван: привет»
 
-j = Human("Петр")
+j = Human("Пётр")
-print j.say("Привет")  # "Петр: привет"
+print(j.say("Привет"))  # Выводит: «Пётр: привет»
 
 # Вызов метода класса
 i.get_species() #=> "H. sapiens"
 
-# Присвоение разделяемому атрибуту
+# Изменение разделяемого атрибута
 Human.species = "H. neanderthalensis"
 i.get_species() #=> "H. neanderthalensis"
 j.get_species() #=> "H. neanderthalensis"
@@ -448,12 +500,12 @@ Human.grunt() #=> "*grunt*"
 
 # Вы можете импортировать модули
 import math
-print math.sqrt(16) #=> 4
+print(math.sqrt(16)) #=> 4
 
 # Вы можете импортировать отдельные функции модуля
 from math import ceil, floor
-print ceil(3.7)  #=> 4.0
+print(ceil(3.7))  #=> 4.0
-print floor(3.7) #=> 3.0
+print(floor(3.7)) #=> 3.0
 
 # Можете импортировать все функции модуля.
 # (Хотя это и не рекомендуется)
@@ -463,7 +515,7 @@ from math import *
 import math as m
 math.sqrt(16) == m.sqrt(16) #=> True
 
-# Модули в Python это обычные файлы с кодом python. Вы
+# Модули в Python — это обычные Python-файлы. Вы
 # можете писать свои модули и импортировать их. Название
 # модуля совпадает с названием файла.
 
@@ -472,18 +524,72 @@ math.sqrt(16) == m.sqrt(16) #=> True
 import math
 dir(math)
 
+####################################################
+## 7. Дополнительно
+####################################################
+
+# Генераторы помогут выполнить ленивые вычисления
+def double_numbers(iterable):
+    for i in iterable:
+        yield i + i
+
+# Генератор создаёт значения на лету.
+# Он не возвращает все значения разом, а создаёт каждое из них при каждой
+# итерации.  Это значит, что значения больше 15 в double_numbers
+# обработаны не будут.
+# Обратите внимание: xrange — это генератор, который делает то же, что и range.
+# Создание списка чисел от 1 до 900000000 требует много места и времени.
+# xrange создаёт объект генератора, а не список сразу, как это делает range.
+# Если нам нужно имя переменной, совпадающее с ключевым словом Python,
+# мы используем подчёркивание в конце
+xrange_ = xrange(1, 900000000)
+
+# Будет удваивать все числа, пока результат не будет >= 30
+for i in double_numbers(xrange_):
+    print(i)
+    if i >= 30:
+        break
+
+
+# Декораторы
+# В этом примере beg оборачивает say
+# Метод beg вызовет say. Если say_please равно True,
+# он изменит возвращаемое сообщение
+from functools import wraps
+
+
+def beg(target_function):
+    @wraps(target_function)
+    def wrapper(*args, **kwargs):
+        msg, say_please = target_function(*args, **kwargs)
+        if say_please:
+            return "{} {}".format(msg, " Пожалуйста! У меня нет денег :(")
+        return msg
+
+    return wrapper
+
+
+@beg
+def say(say_please=False):
+    msg = "Вы не купите мне пива?"
+    return msg, say_please
+
+
+print(say())  # Вы не купите мне пива?
+print(say(say_please=True)) # Вы не купите мне пива? Пожалуйста! У меня нет денег :(
 
 ```
 
-## Хотите еще?
+## Хотите ещё?
 
 ### Бесплатные онлайн-материалы
 
 * [Learn Python The Hard Way](http://learnpythonthehardway.org/book/)
 * [Dive Into Python](http://www.diveintopython.net/)
-* [The Official Docs](http://docs.python.org/2.6/)
+* [Официальная документация](http://docs.python.org/2.6/)
 * [Hitchhiker's Guide to Python](http://docs.python-guide.org/en/latest/)
 * [Python Module of the Week](http://pymotw.com/2/)
+* [A Crash Course in Python for Scientists](http://nbviewer.ipython.org/5920182)
 
 ### Платные