Summary  
This chapter explains how to use Python’s list.insert(index, element) method to add an item at a specific position in a list, causing all subsequent elements to shift right.

General domain of usage  
Travel planning

¿Qué sucede si queremos agregar un elemento no al final de la lista, sino en una posición específica? Para este propósito, utilizamos el método `insert()`.

La sintaxis para el método `insert()` es:
``` python
list.insert(index, element)
```
- `index`: la posición en la lista donde se desea agregar el nuevo elemento. Recuerda que Python utiliza índices **basados en cero**;
- `element`: el elemento que se desea insertar en la lista.

Imagina que estás planificando un viaje y tienes una lista de ciudades que deseas visitar.

travel_wishlist = ["Paris", "Oslo", "Kyoto", "Sydney"]

print(travel_wishlist)  # Output: ['Paris', 'Oslo', 'Kyoto', 'Sydney']

Sin embargo, tus planes cambian y decides ajustar el orden de los destinos.
Ahora, deseas priorizar "Chicago" como el primer destino.

travel_wishlist = ["Paris", "Oslo", "Kyoto", "Sydney"]

# Adding "Chicago" as the first destination
travel_wishlist.insert(0, "Chicago")
print(travel_wishlist)  # Output: ['Chicago', 'Paris', 'Oslo', 'Kyoto', 'Sydney']

Después de esto, "Chicago" ocupa el índice `0`. Ahora está en la parte superior, y el resto de los elementos se han desplazado hacia abajo. Así que ahora tenemos 5 elementos:





Con la función `insert()`, solo se puede agregar **un** elemento a la vez.

Nota

import unittest
from contextlib import redirect_stdout
import io
import importlib

def _dynamic_test(test_case, condition, success_message, failure_message):
    if condition:
        test_case._testMethodName = success_message
        test_case.assertTrue(True, success_message)
    else:
        test_case._testMethodName = failure_message
        test_case.fail(failure_message)

class TestUserCode(unittest.TestCase):

    def test_travel_wishlist_is_declared(self):
        import user_code
        _dynamic_test(
            self,
            hasattr(user_code, 'travel_wishlist'),
            "The `travel_wishlist` list is declared.",
            "Expected `travel_wishlist` to be declared."
        )

    def test_cities_prioritized_correctly(self):
        import user_code
        expected_list = ["London", "Paris", "Budapest", "Oslo", "Kyoto", "Sydney"]
        _dynamic_test(
            self,
            user_code.travel_wishlist == expected_list,
            f"The cities were prioritized correctly: {user_code.travel_wishlist}.",
            f"Expected travel_wishlist to be {expected_list}, but got {user_code.travel_wishlist}."
        )

    def test_insert_method_used(self):
        with open('user_code.py', 'r') as file:
            user_code_source = file.read()
        
        _dynamic_test(
            self,
            ".insert(" in user_code_source,
            "The `insert` method is used to prioritize cities.",
            "Expected the `insert` method to be used to prioritize cities."
        )

if __name__ == '__main__':
    unittest.main()


test_main.py

Explora las estructuras de datos fundamentales del lenguaje de programación Python, incluyendo listas, diccionarios, tuplas y conjuntos, y aprende cómo aplicarlas de manera efectiva para resolver desafíos de programación del mundo real.

¿Qué es una lista? Una lista es una colección ordenada que puede modificarse. También permite elementos duplicados.

¿Qué es un diccionario? Un diccionario es una colección ordenada que puede modificarse, pero no permite entradas duplicadas. Consiste en pares clave:valor, que se utilizan para optimizar su estructura.

¿Qué es una tupla? Una tupla es una colección ordenada que no puede ser modificada. Puede contener elementos duplicados. Aunque es similar a una lista, los valores en una tupla pueden ser de cualquier tipo y están indexados por enteros. Aunque no es obligatorio, es común encerrar los valores de una tupla entre paréntesis, lo que facilita su comprensión en Python.

¿Qué es un set? En Python, un set es una colección desordenada que es tanto iterable como mutable, sin elementos repetidos. Aunque el orden de los elementos en un set no está definido, puede incluir una variedad de elementos. Un beneficio clave de usar sets en lugar de listas es su método altamente eficiente para determinar si un elemento existe dentro del set.

Uso del Método insert()

Solución