add python docs

2026-05-23 01:37:11 +00:00 · 2025-03-01 20:25:47 +03:00
parent 70cd9ea261
commit 7836ded139
15 changed files with 575 additions and 2 deletions
@@ -0,0 +1,5 @@
 # Начало!
 В этом модуле вы изучите основу основ - **Excel**!
 [Давайте же начнем](/docs/Excel/first.md)
@@ -0,0 +1 @@
 # Начала!
@@ -0,0 +1,126 @@
 ---
 sidebar_position: 3
 ---
 # Основы синтаксиса Python
 Python отличается чистым и интуитивно понятным синтаксисом. Давайте рассмотрим основные элементы синтаксиса Python.
 **Переменные:**
 Переменные используются для хранения данных. В Python не нужно явно объявлять тип переменной. Тип переменной определяется автоматически в зависимости от присвоенного значения.
 ```python
 # Объявление переменных
 name = "Иван"  # Строковая переменная
 age = 30       # Целочисленная переменная
 salary = 50000.50 # Число с плавающей точкой
 is_student = False # Булевая переменная
 # Вывод значений переменных
 print(name)
 print(age)
 print(salary)
 print(is_student)
 ```
 **Типы данных:**
 Python поддерживает различные встроенные типы данных, включая:
  * **Целые числа (int):**  `10`, `-5`, `0`
  * **Числа с плавающей точкой (float):** `3.14`, `-2.5`, `0.0`
  * **Строки (str):** `"Привет"`, `'Python'`, `"123"`
  * **Булевы значения (bool):** `True`, `False`
  * **Списки (list):**  Упорядоченные изменяемые коллекции элементов. `[1, 2, 3]`, `["apple", "banana", "cherry"]`
  * **Кортежи (tuple):**  Упорядоченные неизменяемые коллекции элементов. `(1, 2, 3)`, `("red", "green", "blue")`
  * **Словари (dict):**  Неупорядоченные коллекции пар "ключ-значение". `{"name": "Иван", "age": 30}`
  * **Множества (set):**  Неупорядоченные коллекции уникальных элементов. `{1, 2, 3}`, `{"apple", "banana", "cherry"}`
 **Операторы:**
 Python поддерживает различные виды операторов:
  * **Арифметические операторы:** `+` (сложение), `-` (вычитание), `*` (умножение), `/` (деление), `//` (целочисленное деление), `%` (остаток от деления), `**` (возведение в степень).
 <!-- end list -->
 ```python
 x = 10
 y = 3
 print(x + y)  # 13
 print(x - y)  # 7
 print(x * y)  # 30
 print(x / y)  # 3.333...
 print(x // y) # 3
 print(x % y)  # 1
 print(x ** y) # 1000
 ```
  * **Операторы сравнения:** `==` (равно), `!=` (не равно), `>` (больше), `<` (меньше), `>=` (больше или равно), `<=` (меньше или равно).
 <!-- end list -->
 ```python
 x = 5
 y = 10
 print(x == y) # False
 print(x != y) # True
 print(x > y)  # False
 print(x < y)  # True
 print(x >= y) # False
 print(x <= y) # True
 ```
  * **Логические операторы:** `and` (логическое И), `or` (логическое ИЛИ), `not` (логическое НЕ).
 <!-- end list -->
 ```python
 is_adult = True
 has_license = False
 print(is_adult and has_license) # False
 print(is_adult or has_license)  # True
 print(not is_adult)           # False
 ```
  * **Операторы присваивания:** `=` (присваивание), `+=`, `-=`, `*=`, `/=`, `//=`, `%=`, `**=` (комбинированные операторы присваивания).
 <!-- end list -->
 ```python
 x = 5
 x += 2  # Эквивалентно x = x + 2 (x станет 7)
 print(x)
 ```
 **Комментарии:**
 Комментарии используются для добавления пояснений к коду. Python игнорирует комментарии при выполнении программы.
  * **Однострочные комментарии:** Начинаются с символа `#`.
 <!-- end list -->
 ```python
 # Это однострочный комментарий
 x = 10 # Это комментарий в конце строки
 ```
  * **Многострочные комментарии:**  Заключаются в тройные кавычки `"""Комментарий"""` или `'''Комментарий'''`.
 <!-- end list -->
 ```python
 """
 Это многострочный комментарий.
 Он может занимать несколько строк.
 """
 '''
 Это еще один многострочный комментарий,
 использующий одинарные кавычки.
 '''
 ```
@@ -0,0 +1,66 @@
 ---
 sidebar_position: 4
 ---
 # Управление потоком выполнения
 Управление потоком выполнения позволяет программе принимать решения и выполнять различные блоки кода в зависимости от определенных условий или повторять определенные действия.
 **Условные операторы (if, elif, else):**
 Оператор `if` позволяет выполнить блок кода, только если условие истинно. Операторы `elif` (else if) и `else` позволяют задать альтернативные блоки кода для выполнения, если основное условие ложно.
 ```python
 age = 20
 if age >= 18:
    print("Вы совершеннолетний")
 elif age >= 16:
    print("Вы почти совершеннолетний")
 else:
    print("Вы несовершеннолетний")
 ```
 **Циклы (for, while):**
 Циклы позволяют повторять блок кода несколько раз.
  * **Цикл `for`:** Используется для итерации по последовательности (списку, кортежу, строке и т.д.).
 <!-- end list -->
 ```python
 fruits = ["apple", "banana", "cherry"]
 for fruit in fruits:
    print(fruit)
 ```
  * **Цикл `while`:** Выполняет блок кода, пока условие истинно.
 <!-- end list -->
 ```python
 count = 0
 while count < 5:
    print(count)
    count += 1
 ```
 **Операторы `break` и `continue`:**
  * **`break`:** Прерывает выполнение цикла.
  * **`continue`:**  Переходит к следующей итерации цикла, пропуская оставшуюся часть текущей итерации.
 <!-- end list -->
 ```python
 for i in range(10):
    if i == 3:
        break  # Прерываем цикл, когда i равно 3
    print(i) # Выведет 0, 1, 2
 for i in range(5):
    if i == 2:
        continue # Переходим к следующей итерации, когда i равно 2
    print(i) # Выведет 0, 1, 3, 4
 ```
@@ -0,0 +1,28 @@
 ---
 sidebar_position: 8
 ---
 # Обработка исключений
 Исключения — это ошибки, которые возникают во время выполнения программы. Python предоставляет механизм обработки исключений, который позволяет предотвратить аварийное завершение программы и корректно обработать ошибки.
 **Блок `try-except`:**
 Для обработки исключений используется блок `try-except`. Код, который может вызвать исключение, помещается в блок `try`. Если в блоке `try` возникает исключение, выполнение кода в блоке `try` прерывается, и управление передается в блок `except`, который обрабатывает исключение.
 ```python
 try:
    result = 10 / 0 # Попытка деления на ноль (вызовет исключение ZeroDivisionError)
 except ZeroDivisionError:
    print("Ошибка: деление на ноль!")
 except TypeError: # Можно обрабатывать разные типы исключений
    print("Ошибка типа данных!")
 except Exception as e: # Можно обрабатывать все исключения (не рекомендуется для продакшна)
    print(f"Произошла ошибка: {e}")
 else: # Блок else выполняется, если в блоке try не было исключений
    print("Результат операции:", result)
 finally: # Блок finally выполняется в любом случае, даже если было исключение
    print("Блок finally выполнен")
 ```
 Обработка исключений делает программы более надежными и устойчивыми к ошибкам.
@@ -0,0 +1,81 @@
 ---
 sidebar_position: 9
 ---
 # Работа с файлами
 Python предоставляет простые и удобные способы для работы с файлами.
 **Открытие файла:**
 Для открытия файла используется функция `open()`. Функция `open()` возвращает файловый объект, который можно использовать для чтения или записи данных.
 ```python
 # Открытие файла для чтения ('r')
 file = open("myfile.txt", "r")
 # Открытие файла для записи ('w') - перезапишет существующий файл или создаст новый
 file = open("output.txt", "w")
 # Открытие файла для добавления ('a') - добавит данные в конец существующего файла или создаст новый
 file = open("log.txt", "a")
 # Открытие файла в бинарном режиме ('rb', 'wb', 'ab') - для работы с бинарными файлами (например, изображениями)
 file = open("image.jpg", "rb")
 # Открытие файла для чтения и записи ('r+')
 file = open("data.txt", "r+")
 ```
 **Чтение из файла:**
  * **`read()`:** Читает все содержимое файла в виде строки.
  * **`readline()`:** Читает одну строку из файла.
  * **`readlines()`:** Читает все строки файла и возвращает их в виде списка строк.
 <!-- end list -->
 ```python
 file = open("myfile.txt", "r")
 content = file.read() # Чтение всего содержимого
 print(content)
 file.seek(0) # Возвращает курсор в начало файла
 line = file.readline() # Чтение одной строки
 print(line)
 lines = file.readlines() # Чтение всех строк в список
 print(lines)
 file.close() # Обязательно закрыть файл после работы
 ```
 **Запись в файл:**
  * **`write()`:** Записывает строку в файл.
  * **`writelines()`:** Записывает список строк в файл.
 <!-- end list -->
 ```python
 file = open("output.txt", "w")
 file.write("Это строка для записи в файл.\n")
 lines_to_write = ["Первая строка\n", "Вторая строка\n"]
 file.writelines(lines_to_write)
 file.close() # Обязательно закрыть файл после работы
 ```
 **Конструкция `with open()`:**
 Рекомендуется использовать конструкцию `with open()`, которая автоматически закрывает файл после завершения работы, даже если произошла ошибка.
 ```python
 with open("myfile.txt", "r") as file:
    content = file.read()
    print(content)
 # Файл будет автоматически закрыт после выхода из блока with
 ```
@@ -0,0 +1,29 @@
 ---
 sidebar_position: 10
 ---
 # Что дальше?
 Изучение основ Python — это только первый шаг в вашем пути программиста.  После освоения базовых концепций, вы можете двигаться дальше в различных направлениях, в зависимости от ваших интересов и целей.
 **Рекомендации для дальнейшего изучения:**
  * **Углубленное изучение ООП:**  Изучите более продвинутые концепции ООП, такие как наследование, полиморфизм, абстракция, интерфейсы, принципы SOLID.
  * **Веб-разработка:**  Изучите фреймворки Django или Flask для создания веб-приложений.
  * **Наука о данных и машинное обучение:**  Углубитесь в библиотеки Pandas, NumPy, Scikit-learn, TensorFlow, PyTorch.  Изучите статистику, машинное обучение, глубокое обучение.
  * **Фреймворки для GUI (графический интерфейс пользователя):**  Изучите Tkinter, PyQt, Kivy для создания настольных приложений с графическим интерфейсом.
  * **Разработка игр:**  Изучите Pygame или другие игровые движки на Python.
  * **Автоматизация и скрипты:**  Практикуйтесь в создании скриптов для автоматизации различных задач, администрирования систем, парсинга веб-сайтов.
 **Ресурсы для дальнейшего обучения:**
  * **Официальная документация Python:** [https://docs.python.org/](https://www.google.com/url?sa=E&source=gmail&q=https://docs.python.org/) - исчерпывающий ресурс по всем аспектам Python.
  * **Онлайн-курсы и платформы:** Coursera, Udemy, Stepik, Hexlet, GeekBrains и многие другие предлагают курсы по Python для разных уровней подготовки.
  * **Книги по Python:** "Python Crash Course" Эрика Мэтиза, "Automate the Boring Stuff with Python" Эла Свейгарта, "Fluent Python" Лучано Рамальо и другие.
  * **Практика и проекты:**  Решайте задачи на платформах Codewars, HackerRank, LeetCode.  Создавайте собственные проекты, чтобы закрепить полученные знания.
 Python — это мощный и перспективный язык, который открывает множество возможностей.  Не останавливайтесь на достигнутом, продолжайте учиться и практиковаться, и вы сможете добиться больших успехов в мире программирования\!
 -----
 Этот лонгрид предоставляет обзор основ Python. Надеюсь, он будет полезен вам в начале вашего изучения Python\! Удачи\!
@@ -0,0 +1,72 @@
 ---
 sidebar_position: 5
 ---
 # Функции
 Функции — это блоки кода, которые выполняют определенную задачу. Функции позволяют разбить программу на более мелкие, логически связанные части, что улучшает читаемость и переиспользуемость кода.
 **Определение функции:**
 Функция определяется с помощью ключевого слова `def`, за которым следует имя функции, круглые скобки `()` для параметров и двоеточие `:`. Тело функции должно быть с отступом.
 ```python
 def greet(name):
    """Эта функция приветствует человека, имя которого передается в качестве аргумента."""
    print("Привет, " + name + "!")
 # Вызов функции
 greet("Алиса") # Выведет "Привет, Алиса!"
 greet("Боб")   # Выведет "Привет, Боб!"
 ```
 **Аргументы и параметры:**
 Параметры — это переменные, указанные в скобках при определении функции. Аргументы — это значения, которые передаются функции при ее вызове.
 ```python
 def add_numbers(x, y): # x и y - параметры
    """Эта функция возвращает сумму двух чисел."""
    return x + y
 result = add_numbers(5, 3) # 5 и 3 - аргументы
 print(result) # Выведет 8
 ```
 **Возвращаемое значение:**
 Функция может возвращать значение с помощью ключевого слова `return`. Если функция не содержит `return`, она неявно возвращает `None`.
 ```python
 def is_even(number):
    """Эта функция проверяет, является ли число четным."""
    if number % 2 == 0:
        return True
    else:
        return False
 print(is_even(4)) # Выведет True
 print(is_even(7)) # Выведет False
 ```
 **Область видимости переменных (Scope):**
 Область видимости переменной определяет, в какой части программы переменная доступна. В Python есть глобальная и локальная области видимости.
  * **Локальные переменные:**  Объявлены внутри функции и доступны только внутри этой функции.
  * **Глобальные переменные:**  Объявлены вне функций и доступны во всей программе.
 <!-- end list -->
 ```python
 global_var = 10 # Глобальная переменная
 def my_function():
    local_var = 5 # Локальная переменная
    print(local_var)
    print(global_var)
 my_function() # Выведет 5 и 10
 # print(local_var) # Вызовет ошибку, local_var не доступна вне функции
 print(global_var)  # Выведет 10, global_var доступна вне функции
 ```
@@ -0,0 +1,9 @@
 ---
 sidebar_position: 1
 ---
 # Начало!
 Python — это мощный и универсальный язык программирования, который пользуется огромной популярностью как среди новичков, так и среди опытных разработчиков. Его лаконичный и читаемый синтаксис делает его отличным выбором для тех, кто только начинает свой путь в программировании. В этом лонгриде мы рассмотрим основные концепции Python, которые помогут вам сделать первые шаги в этом увлекательном мире.
 Давайте же начнем!
@@ -0,0 +1,43 @@
 ---
 sidebar_position: 2
 ---
 # Установка Python и настройка окружения
 Для начала работы с Python необходимо установить его интерпретатор на ваш компьютер.
 **Шаги установки Python:**
 1.  **Перейдите на официальный сайт Python:** [https://www.python.org/downloads/](https://www.google.com/url?sa=E&source=gmail&q=https://www.python.org/downloads/)
 2.  **Выберите версию Python для вашей операционной системы:** Обычно рекомендуется использовать последнюю стабильную версию Python 3.x.
 3.  **Скачайте установщик:** Запустите скачанный файл установщика и следуйте инструкциям.
 4.  **Важно:**  На этапе установки убедитесь, что вы отметили опцию "Add Python to PATH". Это позволит вам запускать Python из командной строки.
 **Проверка установки:**
 Откройте командную строку (или терминал на macOS/Linux) и введите команду:
 ```bash
 python --version
 ```
 или
 ```bash
 python3 --version
 ```
 Если Python установлен правильно, вы увидите версию Python, установленную на вашем компьютере.
 **Выбор интегрированной среды разработки (IDE):**
 IDE (Integrated Development Environment) — это программное обеспечение, которое предоставляет инструменты для разработки программ, включая редактор кода, отладчик, средства сборки и многое другое. Использование IDE значительно упрощает процесс разработки.
 **Популярные IDE для Python:**
  * **VS Code (Visual Studio Code):** Бесплатный, легкий и очень мощный редактор кода с отличной поддержкой Python через расширения.  [Image of VS Code with Python extension]
  * **PyCharm:**  Мощная IDE, специально разработанная для Python-разработки. Доступны как платная Professional, так и бесплатная Community версии. [Image of PyCharm IDE]
  * **Jupyter Notebook:**  Веб-приложение для создания и обмена документами, содержащими код, уравнения, визуализации и текст. Идеально подходит для науки о данных и обучения. [Image of Jupyter Notebook]
  * **Thonny:**  IDE, разработанная специально для начинающих изучать Python. Проста в использовании и включает отладчик. [Image of Thonny IDE]
 Выбор IDE — дело вкуса. Для начала можно использовать VS Code или Thonny, так как они просты в освоении и предоставляют все необходимые инструменты для изучения Python.
@@ -0,0 +1,51 @@
 ---
 sidebar_position: 6
 ---
 # Модули и пакеты
 Модули и пакеты в Python используются для организации кода и переиспользования функциональности.
 **Модули:**
 Модуль — это файл, содержащий определения функций, классов и переменных Python. Модули позволяют разбить код на логические блоки и переиспользовать код в разных частях программы или в других программах.
 **Импорт модулей:**
 Для использования модуля его необходимо импортировать с помощью оператора `import`.
 ```python
 import math # Импорт модуля math
 print(math.sqrt(16)) # Вызов функции sqrt из модуля math (выведет 4.0)
 print(math.pi)     # Доступ к константе pi из модуля math (выведет 3.1415...)
 ```
 Можно импортировать только определенные функции или константы из модуля:
 ```python
 from math import sqrt, pi # Импорт только sqrt и pi из модуля math
 print(sqrt(25)) # Вызов sqrt напрямую (выведет 5.0)
 print(pi)      # Доступ к pi напрямую (выведет 3.1415...)
 ```
 Можно присвоить модулю или импортированной части псевдоним:
 ```python
 import math as m # Импорт модуля math с псевдонимом m
 from math import sqrt as sq # Импорт sqrt с псевдонимом sq
 print(m.cos(0)) # Вызов функции cos через псевдоним m
 print(sq(36))   # Вызов функции sqrt через псевдоним sq
 ```
 **Пакеты:**
 Пакет — это способ организации модулей в иерархическую структуру. Пакет представляет собой директорию, содержащую модули Python и специальный файл `__init__.py`, который указывает, что директория является пакетом.
 Пакеты позволяют лучше структурировать большие проекты и избегать конфликтов имен модулей.
 **Стандартная библиотека Python:**
 Python поставляется с богатой стандартной библиотекой, которая включает модули для работы с операционной системой, файлами, сетью, датой и временем, регулярными выражениями и многим другим. Использование стандартной библиотеки значительно ускоряет разработку, так как предоставляет готовые решения для многих задач.
@@ -0,0 +1,40 @@
 ---
 sidebar_position: 7
 ---
 # Основы объектно-ориентированного программирования (ООП)
 Python поддерживает парадигму объектно-ориентированного программирования (ООП).  ООП позволяет организовывать код в виде объектов, которые сочетают в себе данные (атрибуты) и поведение (методы).
 **Классы и объекты:**
  * **Класс:**  Это шаблон или чертеж для создания объектов. Класс определяет структуру и поведение объектов.
  * **Объект (экземпляр класса):**  Это конкретный экземпляр класса.
 <!-- end list -->
 ```python
 class Dog: # Определение класса Dog
    def __init__(self, name, breed): # Конструктор класса (метод __init__)
        self.name = name # Атрибут name
        self.breed = breed # Атрибут breed
    def bark(self): # Метод bark
        print("Гав!")
 # Создание объектов (экземпляров класса Dog)
 my_dog = Dog("Рекс", "Немецкая овчарка")
 your_dog = Dog("Белка", "Дворняга")
 print(my_dog.name)  # Доступ к атрибуту name объекта my_dog (выведет "Рекс")
 print(your_dog.breed) # Доступ к атрибуту breed объекта your_dog (выведет "Дворняга")
 my_dog.bark()       # Вызов метода bark объекта my_dog (выведет "Гав!")
 ```
 **Основные принципы ООП:**
  * **Инкапсуляция:** Сокрытие внутренних данных объекта и предоставление доступа к ним через методы.
  * **Наследование:**  Создание новых классов на основе существующих классов, наследуя их атрибуты и методы.
  * **Полиморфизм:**  Возможность объектов разных классов реагировать на один и тот же метод по-разному.
 ООП — это мощная парадигма, которая позволяет создавать более структурированный, модульный и переиспользуемый код.
@@ -0,0 +1,23 @@
 ---
 sidebar_position: 1
 ---
 # Что такое Python и почему его стоит изучать?
 **Python** — это высокоуровневый, интерпретируемый, объектно-ориентированный язык программирования.  Разработанный Гвидо ван Россумом и впервые выпущенный в 1991 году, Python был создан с акцентом на читаемость кода.
 **Почему Python так популярен?**
  * **Простота и читаемость:** Синтаксис Python максимально приближен к английскому языку, что делает его легким для понимания и изучения. Код на Python часто выглядит как псевдокод, что облегчает разработку и сопровождение.
  * **Большое и активное сообщество:**  Огромное сообщество Python-разработчиков означает, что вы всегда сможете найти помощь, ресурсы и библиотеки для решения практически любых задач.
  * **Универсальность:** Python применяется в самых разных областях: веб-разработка (Django, Flask), наука о данных и машинное обучение (Pandas, NumPy, Scikit-learn, TensorFlow), автоматизация, скрипты, игры и многое другое.
  * **Кроссплатформенность:** Python работает на различных операционных системах (Windows, macOS, Linux), что позволяет разрабатывать приложения, которые можно запускать на разных платформах без изменений кода.
  * **Огромное количество библиотек и фреймворков:** Python располагает богатой стандартной библиотекой и огромным количеством сторонних библиотек и фреймворков, которые значительно ускоряют процесс разработки и предоставляют готовые решения для множества задач.
 **Примеры применения Python:**
  * **Веб-разработка:** Создание веб-сайтов и веб-приложений с использованием фреймворков Django и Flask.
  * **Наука о данных и машинное обучение:** Анализ данных, визуализация, построение моделей машинного обучения с использованием библиотек Pandas, NumPy, Scikit-learn, TensorFlow и PyTorch.
  * **Автоматизация и скрипты:** Автоматизация рутинных задач, создание скриптов для управления системами и приложениями.
  * **Разработка игр:**  Создание простых игр с использованием библиотек Pygame.
  * **Встраиваемые системы и IoT:** Программирование микроконтроллеров и устройств интернета вещей.
@@ -1 +0,0 @@
 12323131231231
@@ -1 +1 @@
-# хуй
+# Начала!