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

Explorez les structures de données fondamentales du langage de programmation Python, y compris les listes, les dictionnaires, les tuples et les ensembles, et découvrez comment les appliquer efficacement pour résoudre des problèmes de programmation concrets.

Qu'est-ce qu'une liste ? Une liste est une collection ordonnée qui peut être modifiée. Elle permet également des éléments en double.

Qu'est-ce qu'un dictionnaire ? Un dictionnaire est une collection ordonnée qui peut être modifiée, mais qui n'autorise pas les entrées en double. Il se compose de paires `key:value`, qui sont utilisées pour optimiser sa structure.

Qu'est-ce qu'un tuple ? Un tuple est une collection ordonnée qui ne peut pas être modifiée. Il peut avoir des éléments en double. Bien qu'il soit similaire à une liste, les valeurs dans un tuple peuvent être de n'importe quel type et sont indexées par des entiers. Bien que non obligatoire, il est courant d'enfermer les valeurs d'un tuple entre parenthèses, ce qui les rend plus faciles à comprendre en Python.

Qu'est-ce qu'un ensemble ? En Python, un `set` est une collection non ordonnée qui est à la fois `iterable` et `mutable`, sans éléments répétés. Bien que l'ordre des éléments dans un ensemble ne soit pas fixe, il peut inclure une variété d'éléments. Un avantage clé de l'utilisation des ensembles par rapport aux listes est leur méthode très efficace pour déterminer si un élément existe dans l'ensemble.

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

Solution