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

Що робити, якщо потрібно додати елемент не в кінець списку, а на певну позицію? Для цього використовується метод `insert()`.

Синтаксис методу `insert()`:
``` python
list.insert(index, element)
```
- `index`: позиція у списку, куди потрібно додати новий елемент. Зверніть увагу, що Python використовує **нульову** індексацію;
- `element`: елемент, який потрібно вставити у список.

Уявіть, що ви плануєте подорож і маєте список міст, які хочете відвідати.

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

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

Цей список містить чотири елементи:

Однак ваші плани змінюються, і ви вирішуєте скоригувати порядок пунктів призначення.
Тепер ви хочете надати пріоритет "Chicago" як першому пункту призначення.

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

Після цього "Chicago" займає індекс `0`. Тепер він знаходиться на початку, а решта елементів змістилися вниз. Отже, зараз у нас 5 елементів:





За допомогою функції `insert()` можна додати **лише один** елемент за раз.

Примітка

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

Ознайомлення з основними структурами даних мови програмування Python, зокрема списками, словниками, кортежами та множинами, а також їх ефективне застосування для вирішення реальних програмних задач.

Що таке список? Список — це впорядкована колекція, яку можна змінювати. Він також допускає наявність дубльованих елементів.

Що таке словник? Словник — це впорядкована змінювана колекція, яка не допускає дубльованих елементів. Складається з пар ключ:значення, які використовуються для оптимізації його структури.

Що таке кортеж? Кортеж — це впорядкована колекція, яку не можна змінити. Він може містити дублікати елементів. Хоча кортеж схожий на список, його значення можуть бути будь-якого типу та індексуються цілими числами. Хоча це не є обов'язковим, зазвичай значення кортежу беруть у круглі дужки, що полегшує їх розуміння в Python.

Що таке множина? У Python множина — це неупорядкована колекція, яка є ітерованою та змінною, без повторюваних елементів. Хоча порядок елементів у множині не фіксований, вона може містити різноманітні елементи. Основна перевага використання множин порівняно зі списками — це високоефективний спосіб перевірки наявності елемента у множині.

Використання методу insert()

Рішення