README.uk-UA.md

Пісочниця та шпаргалка для вивчення Python

🇺🇦 УКРАЇНА ЗАЗНАЄ ЗБРОЙНОЇ АГРЕСІЇ З БОКУ РОСІЙСЬКОЇ АРМІЇ. ГИНУТЬ МИРНІ ЖИТЕЛІ. ЖИТЛОВІ КВАРТАЛИ ЗАЗНАЮТЬ БОМБАРДУВАНЬ.

• Допоможіть Україні:
  • Благодійний фонд Сергія Притули
  • Благодійний фонд «Повернись живим»
  • Національний банк України
• Більше інформації на war.ukraine.ua та МЗС України

---

Це колекція скриптів мовою Python, розподілених за темами, що містять приклади коду з поясненнями, різними варіантами використання та посиланнями на додаткові матеріали.

Читати іншими мовами: English, Português, Español, 繁體中文.

Це пісочниця, тому що ви можете змінювати або доповнювати код, щоб побачити, як він працює, і тестувати його за допомогою тверджень. Також ви можете перевіряти код, який ви написали, і з'ясувати, чи відповідає він настановам зі стилю Python. Усе це може зробити процес навчання інтерактивнішим і допоможе підтримувати високу якість коду від самого початку.

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

Вас також може зацікавити 🤖 Interactive Machine Learning Experiments

Як користуватися цим репозиторієм

Кожен скрипт Python у цьому репозиторії має таку структуру:

"""Lists  <--- Назва теми

# @see: https://www.learnpython.org/en/Lists  <-- Посилання на додаткові матеріали

Тут може бути детальніше пояснення поточної теми (наприклад, загальна інформація про списки).
"""


def test_list_type():
    """Пояснення підтеми.

    Кожен файл містить тестові функції, які ілюструють підтеми (наприклад, тип списку, методи списків).
    """

    # Ось приклад побудови списку.  <-- Коментарі пояснюють дію
    squares = [1, 4, 9, 16, 25]

    # Списки можна індексувати та зрізати (sliced).
    # Індексування повертає елемент.
    assert squares[0] == 1  # <-- Твердження ілюструють результат.
    # Зрізання повертає новий список.
    assert squares[-3:] == [9, 16, 25]  # <-- Твердження ілюструють результат.

Зазвичай ви можете зробити наступне:

• Знайти тему, яку хочете вивчити або повторити.
• Прочитати коментарі та/або документацію, на яку є посилання в docstring кожного скрипта (як у прикладі вище).
• Переглянути приклади коду та твердження, щоб побачити варіанти використання й очікуваний результат.
• Змінити код або додати нові твердження, щоб побачити, як усе працює.
• Запустити тести та перевірити код, щоб переконатися, що він працює і написаний правильно.

Зміст

1. Початок роботи
   • Що таке Python
   • Синтаксис Python
   • Змінні
2. Оператори
   • Арифметичні оператори (+, -, *, /, //, %, **)
   • Побітові оператори (&, |, ^, >>, <<, ~)
   • Оператори присвоєння (=, +=, -=, /=, //= тощо)
   • Оператори порівняння (==, !=, >, <, >=, <=)
   • Логічні оператори (and, or, not)
   • Оператори ідентичності (is, is not)
   • Оператори належності (in, not in)
3. Типи даних
   • Числа (включно з булевими значеннями)
   • Рядки та їхні методи
   • Списки та їхні методи (включно з генераторами списків)
   • Кортежі
   • Множини та їхні методи
   • Словники
   • Перетворення типів
4. Керування потоком виконання
   • Інструкція if
   • Інструкція for (і функція range())
   • Інструкція while
   • Інструкція try
   • Інструкція break
   • Інструкція continue
5. Функції
   • Визначення функції (інструкції def і return)
   • Області видимості змінних у функціях (інструкції global і nonlocal)
   • Стандартні значення аргументів
   • Іменовані аргументи
   • Довільні списки аргументів
   • Розпакування списків аргументів (інструкції * і **)
   • Лямбда-вирази (інструкція lambda)
   • Рядки документації
   • Анотації функцій
   • Декоратори функцій
6. Класи
   • Визначення класу (інструкція class)
   • Об'єкти класу
   • Об'єкти екземплярів
   • Об'єкти методів
   • Змінні класу та екземпляра
   • Успадкування
   • Множинне успадкування
7. Модулі
   • Модулі (інструкція import)
   • Пакети
8. Помилки та винятки
   • Обробка винятків (інструкція try)
   • Генерування винятків (інструкція raise)
9. Файли
   • Читання та записування (інструкція with)
   • Методи файлових об'єктів
10. Додатково
    • Інструкція pass
    • Генератори (інструкція yield)
11. Короткий огляд стандартних бібліотек
    • Серіалізація (бібліотека json)
    • Шаблони пошуку файлів (бібліотека glob)
    • Пошук за шаблоном у рядках (бібліотека re)
    • Математика (бібліотеки math, random, statistics)
    • Дата і час (бібліотека datetime)
    • Стиснення даних (бібліотека zlib)
12. Введення користувача
    • Введення з терміналу (інструкція input)

Передумови

Встановлення Python

Переконайтеся, що на вашому комп'ютері встановлено Python 3.

Ви можете використовувати стандартну бібліотеку Python venv для створення віртуальних середовищ, щоб Python, pip та всі залежні пакети встановлювалися й працювали з локальної теки проєкту, а не впливали на системні пакети та їхні версії.

Залежно від вашої інсталяції, доступ до інтерпретатора Python 3 можна отримати, виконавши команду python або python3. Те саме стосується менеджера пакетів pip — він може бути доступний через pip або pip3.

Перевірити версію Python можна, виконавши:

python --version

Зверніть увагу, що в цьому репозиторії, коли ви бачите python, мається на увазі Python 3.

Встановлення залежностей

Встановіть усі необхідні залежності проєкту, виконавши:

pip install -r requirements.txt

Тестування коду

Тести написані з використанням фреймворку pytest.

Ви можете додавати власні тести, створюючи файли та функції з префіксом test_ (наприклад, test_topic.py з функцією def test_sub_topic() всередині).

Щоб запустити всі тести, виконайте з кореневої теки проєкту:

pytest

Щоб запустити окремі тести, виконайте:

pytest ./path/to/the/test_file.py

Перевірка коду

Перевірка коду виконується за допомогою бібліотек pylint та flake8.

PyLint

Щоб перевірити, чи написаний код відповідно до настанов зі стилю PEP 8, виконайте:

pylint ./src/

Якщо лінтер виявить помилку (наприклад, missing-docstring), ви можете дізнатися про неї більше, виконавши:

pylint --help-msg=missing-docstring

Детальніше про PyLint

Flake8

Щоб перевірити, чи написаний код відповідно до настанов зі стилю PEP 8, виконайте:

flake8 ./src

Або, якщо ви хочете отримати детальніший вивід:

flake8 ./src --statistics --show-source --count

Детальніше про Flake8

Автор

• @trekhleb