Summary  
This chapter explains how to use the insert() method to place an element at a specific index in a list, causing subsequent elements to shift positions.  

General domain of usage  
Travel itinerary planning

What if we want to add an item not at the end of the list, but at a specific position? For this purpose, we use the `insert()` method.

The syntax for the `insert()` method is:
``` python
list.insert(index, element)
```
- `index`: the position in the list where you want to add the new element. Remember, Python uses **zero-based** indexing;
- `element`: the item you want to insert into the list.

Imagine planning a trip and having a list of cities you want to visit.

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

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

However, your plans change, and you decide to adjust the order of destinations.
Now, you want to prioritize "Chicago" as the first destination.

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']

After this, "Chicago" takes the `0` index. It's now at the top, and the rest of the items have shifted down. So, we now have 5 items:





With the `insert()` function, you can add **only one** item at once.

Note

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

Esplora le strutture dati fondamentali del linguaggio di programmazione Python, tra cui liste, dizionari, tuple e set, e apprendi come applicarle efficacemente per risolvere sfide di programmazione reali.

Cos'è una lista? Una lista è una collezione ordinata che può essere modificata. Consente anche elementi duplicati.

Cos'è un dizionario? Un dizionario è una raccolta ordinata che può essere modificata, ma non consente voci duplicate. Consiste in coppie `key:value`, che vengono utilizzate per ottimizzare la sua struttura.

Cos'è una tupla? Una tupla è una collezione ordinata che non può essere modificata. Può avere elementi duplicati. Anche se è simile a una lista, i valori in una tupla possono essere di qualsiasi tipo e sono indicizzati da numeri interi. Anche se non è obbligatorio, è comune racchiudere i valori di una tupla tra parentesi, rendendoli più facili da comprendere in Python.

Cos'è un set? In Python, un `set` è una collezione non ordinata che è sia `iterable` che `mutable`, senza elementi ripetuti. Sebbene l'ordine degli elementi in un set non sia fisso, può includere una varietà di elementi. Un vantaggio chiave dell'utilizzo dei set rispetto alle liste è il loro metodo altamente efficiente per determinare se un elemento esiste all'interno del set.

Using the insert() Method: Placing Elements at Specific Positions

Soluzione