more content

Signed-off-by: Kirill Mokevnin <mokevnin@gmail.com>

Author: mokevnin

…/40-define-functions/200-return/Makefile modules/33-data-types/45-tuples/Makefilemodules/40-define-functions/200-return/Makefile renamed to modules/33-data-types/45-tuples/Makefile modules/40-define-functions/200-return/Makefile renamed to modules/33-data-types/45-tuples/Makefile

@@ -0,0 +1,87 @@
+---
+
+name: Tuplas
+theory: |
+
+  Además de los tipos primitivos, Python tiene tipos de datos compuestos que almacenan varios valores a la vez. Un estudiante universitario se describe con nombre, edad y promedio. Una película tiene título, año de estreno y calificación. Estos grupos de valores es natural almacenarlos juntos.
+
+  Una tupla es más simple que cualquier otro tipo compuesto. Almacena varios valores en un orden estrictamente definido. Una vez creada, no se puede modificar.
+
+  Una tupla es adecuada para datos que siempre van juntos.
+
+  ```python
+  student = ('Alice', 20, 4.8)       # nombre, edad, promedio
+  film = ('Inception', 2010, 8.8)    # título, año, calificación
+  ```
+
+  Una tupla se escribe entre paréntesis con los valores separados por comas.
+
+  ```python
+  point = (10, 20)
+  colors = ('red', 'green', 'blue')
+  mixed = (42, 'hello', 3.14)
+  ```
+
+  Una tupla de un solo elemento requiere una coma al final. Sin ella, Python interpreta los paréntesis como agrupación de una expresión.
+
+  ```python
+  single = (42,)    # una tupla con un elemento
+  not_tuple = (42)  # simplemente el número 42
+  ```
+
+  Los elementos de una tupla se numeran desde cero. Se accede a ellos por índice.
+
+  ```python
+  point = (10, 20)
+  print(point[0])  # => 10
+  print(point[1])  # => 20
+  ```
+
+  Una tupla no se puede modificar después de su creación. Intentar reemplazar un elemento produce un error.
+
+  ```python
+  point = (10, 20)
+  point[0] = 5  # TypeError: 'tuple' object does not support item assignment
+  ```
+
+  La inmutabilidad está incorporada en las tuplas de forma deliberada. Sin importar dónde se pase una tupla, sus datos permanecen iguales.
+
+  Los elementos de una tupla se pueden asignar a varias variables a la vez.
+
+  ```python
+  point = (10, 20)
+  x, y = point
+
+  print(x)  # => 10
+  print(y)  # => 20
+  ```
+
+  Python asigna los valores a las variables en orden. El número de variables debe coincidir con el número de elementos.
+
+instructions: |
+  Dos ciudades están en la misma carretera. Cada una se describe con una tupla que contiene el nombre y la posición en kilómetros desde el inicio de la ruta:
+
+  ```python
+  city_a = ('Moscow', 10)
+  city_b = ('Saint Petersburg', 644)
+  ```
+
+  Calcula la distancia entre las ciudades y muestra el resultado en este formato:
+
+  ```
+  From: Moscow
+  To: Saint Petersburg
+  Distance: 634 km
+  ```
+
+tips:
+  - |
+    [Tuplas y Secuencias](https://docs.python.org/3/tutorial/datastructures.html#tuples-and-sequences)
+
+definitions:
+  - name: "Tupla (tuple)"
+    description: "una secuencia ordenada e inmutable de valores. Se crea con paréntesis: `(1, 2, 3)`."
+  - name: "Desempaquetado (unpacking)"
+    description: "asignación de los elementos de una tupla a varias variables a la vez, por ejemplo `x, y = (10, 20)`."
+  - name: "Indexación"
+    description: "acceso a un elemento por su posición, comenzando desde cero: `t[0]` es el primer elemento de la tupla `t`."

modules/33-data-types/45-tuples/description.es.yml

@@ -0,0 +1,14 @@
+Two cities lie on the same road. Each is described by a tuple with a name and a position in kilometers from the start of the route:
+
+```python
+city_a = ('Moscow', 10)
+city_b = ('Saint Petersburg', 644)
+```
+
+Calculate the distance between the cities and print the result in this format:
+
+```
+From: Moscow
+To: Saint Petersburg
+Distance: 634 km
+```

modules/33-data-types/45-tuples/en/EXERCISE.md

@@ -0,0 +1,69 @@
+Besides primitive types, Python has composite data types that store multiple values at once. A university student is described by a name, age, and GPA. A film has a title, release year, and rating. These groups of values are natural to store together.
+
+A tuple is simpler than any other composite type. It stores several values in a strictly defined order. Once created, it cannot be changed.
+
+A tuple works well for data that always belongs together.
+
+```python
+student = ('Alice', 20, 4.8)       # name, age, GPA
+film = ('Inception', 2010, 8.8)    # title, year, rating
+```
+
+## Creating a tuple
+
+A tuple is written in parentheses with values separated by commas.
+
+```python
+point = (10, 20)
+colors = ('red', 'green', 'blue')
+mixed = (42, 'hello', 3.14)
+```
+
+A single-element tuple requires a trailing comma. Without it, Python treats the parentheses as grouping an expression.
+
+```python
+single = (42,)    # a tuple with one element
+not_tuple = (42)  # just the number 42
+```
+
+The parentheses are optional. Python recognizes a tuple by the commas.
+
+```python
+point = 10, 20
+print(type(point))  # => <class 'tuple'>
+```
+
+## Accessing elements
+
+Tuple elements are numbered from zero. They are accessed by index.
+
+```python
+point = (10, 20)
+print(point[0])  # => 10
+print(point[1])  # => 20
+```
+
+## Tuples are immutable
+
+A tuple cannot be modified after creation. Attempting to replace an element raises an error.
+
+```python
+point = (10, 20)
+point[0] = 5  # TypeError: 'tuple' object does not support item assignment
+```
+
+Immutability is built into tuples deliberately. No matter where a tuple is passed, its data stays the same.
+
+## Unpacking
+
+Tuple elements can be assigned to multiple variables at once.
+
+```python
+point = (10, 20)
+x, y = point
+
+print(x)  # => 10
+print(y)  # => 20
+```
+
+Python matches values to variables in order. The number of variables must equal the number of elements.

modules/33-data-types/45-tuples/en/README.md

@@ -0,0 +1,15 @@
+---
+name: Tuples
+tips:
+  - |
+    [Tuples and Sequences](https://docs.python.org/3/tutorial/datastructures.html#tuples-and-sequences)
+definitions:
+  - name: Tuple
+    description: >-
+      an ordered immutable sequence of values. Created with parentheses: `(1, 2, 3)`.
+  - name: Unpacking
+    description: >-
+      assigning the elements of a tuple to multiple variables at once, e.g. `x, y = (10, 20)`.
+  - name: Indexing
+    description: >-
+      accessing an element by its position, starting from zero: `t[0]` is the first element of tuple `t`.

modules/33-data-types/45-tuples/en/data.yml

@@ -0,0 +1,14 @@
+Dos ciudades están en la misma carretera. Cada una se describe con una tupla que contiene el nombre y la posición en kilómetros desde el inicio de la ruta:
+
+```python
+city_a = ('Moscow', 10)
+city_b = ('Saint Petersburg', 644)
+```
+
+Calcula la distancia entre las ciudades y muestra el resultado en este formato:
+
+```
+From: Moscow
+To: Saint Petersburg
+Distance: 634 km
+```

modules/33-data-types/45-tuples/es/EXERCISE.md

@@ -0,0 +1,69 @@
+Además de los tipos primitivos, Python tiene tipos de datos compuestos que almacenan varios valores a la vez. Un estudiante universitario se describe con nombre, edad y promedio. Una película tiene título, año de estreno y calificación. Estos grupos de valores es natural almacenarlos juntos.
+
+Una tupla es más simple que cualquier otro tipo compuesto. Almacena varios valores en un orden estrictamente definido. Una vez creada, no se puede modificar.
+
+Una tupla es adecuada para datos que siempre van juntos.
+
+```python
+student = ('Alice', 20, 4.8)       # nombre, edad, promedio
+film = ('Inception', 2010, 8.8)    # título, año, calificación
+```
+
+## Cómo crear una tupla
+
+Una tupla se escribe entre paréntesis con los valores separados por comas.
+
+```python
+point = (10, 20)
+colors = ('red', 'green', 'blue')
+mixed = (42, 'hello', 3.14)
+```
+
+Una tupla de un solo elemento requiere una coma al final. Sin ella, Python interpreta los paréntesis como agrupación de una expresión.
+
+```python
+single = (42,)    # una tupla con un elemento
+not_tuple = (42)  # simplemente el número 42
+```
+
+Los paréntesis son opcionales. Python reconoce una tupla por las comas.
+
+```python
+point = 10, 20
+print(type(point))  # => <class 'tuple'>
+```
+
+## Acceso a los elementos
+
+Los elementos de una tupla se numeran desde cero. Se accede a ellos por índice.
+
+```python
+point = (10, 20)
+print(point[0])  # => 10
+print(point[1])  # => 20
+```
+
+## Las tuplas son inmutables
+
+Una tupla no se puede modificar después de su creación. Intentar reemplazar un elemento produce un error.
+
+```python
+point = (10, 20)
+point[0] = 5  # TypeError: 'tuple' object does not support item assignment
+```
+
+La inmutabilidad está incorporada en las tuplas de forma deliberada. Sin importar dónde se pase una tupla, sus datos permanecen iguales.
+
+## Desempaquetado
+
+Los elementos de una tupla se pueden asignar a varias variables a la vez.
+
+```python
+point = (10, 20)
+x, y = point
+
+print(x)  # => 10
+print(y)  # => 20
+```
+
+Python asigna los valores a las variables en orden. El número de variables debe coincidir con el número de elementos.

modules/33-data-types/45-tuples/es/README.md

@@ -0,0 +1,15 @@
+---
+name: Tuplas
+tips:
+  - |
+    [Tuplas y Secuencias](https://docs.python.org/3/tutorial/datastructures.html#tuples-and-sequences)
+definitions:
+  - name: Tupla (tuple)
+    description: >-
+      una secuencia ordenada e inmutable de valores. Se crea con paréntesis: `(1, 2, 3)`.
+  - name: Desempaquetado (unpacking)
+    description: >-
+      asignación de los elementos de una tupla a varias variables a la vez, por ejemplo `x, y = (10, 20)`.
+  - name: Indexación
+    description: >-
+      acceso a un elemento por su posición, comenzando desde cero: `t[0]` es el primer elemento de la tupla `t`.

modules/33-data-types/45-tuples/es/data.yml

@@ -0,0 +1,11 @@
+city_a = ('Moscow', 10)
+city_b = ('Saint Petersburg', 644)
+
+name1, km1 = city_a
+name2, km2 = city_b
+
+distance = km2 - km1
+
+print(f'From: {name1}')
+print(f'To: {name2}')
+print(f'Distance: {distance} km')

modules/33-data-types/45-tuples/index.py

@@ -0,0 +1,14 @@
+Два города лежат на одной трассе. Каждый описан кортежем с названием и позицией в километрах от начала маршрута:
+
+```python
+city_a = ('Moscow', 10)
+city_b = ('Saint Petersburg', 644)
+```
+
+Вычислите расстояние между городами и выведите результат в таком формате:
+
+```
+From: Moscow
+To: Saint Petersburg
+Distance: 634 km
+```