📦 Репозиторий занятия 50

### Абсолютный путь

**Абсолютный путь** — это путь к файлу или папке, который начинается **от корня файловой системы**.  
Он всегда однозначно указывает, где находится файл.

**Пример (Windows):**

```python
path = "C:\\Users\\User\\Documents\\project\\data.txt"
```

**Пример (Linux / Mac):**

```python
path = "/home/user/project/data.txt"
```

### Относительный путь

**Относительный путь** — это путь **относительно текущей рабочей директории программы** (т.е. места, где запущен скрипт).

* Если файл лежит в той же папке, что и программа:

```python
file = "data.txt"
```

* Если файл лежит на уровень ниже (в другой папку внутри текущей директории):

```python
file = "folder/data.txt"
```

* Если нужно подняться на уровень выше:

```python
file = "../data.txt"      # ../ означает 'выйти в родительскую папку'
```

## Основные методы модуля `os`

| Метод                     | Назначение                                  | Пример                                      | Ожидаемый результат                                       |
|---------------------------|---------------------------------------------|---------------------------------------------|-----------------------------------------------------------|
| `os.getcwd()`             | Возвращает текущую рабочую директорию       | `print(os.getcwd())`                        | Например: `C:\Users\User\project`                         |
| `os.chdir(path)`          | Меняет текущую рабочую директорию           | `os.chdir("folder")`                        | Текущая директория становится `folder`                    |
| `os.listdir(path)`        | Возвращает список файлов/папок в директории | `print(os.listdir("."))`                    | `['main.py', 'data', 'readme.txt']`                       |
| `os.mkdir(path)`          | Создаёт папку (1 уровень)                   | `os.mkdir("new_folder")`                    | Создаст каталог `new_folder`                              |
| `os.makedirs(path)`       | Создаёт вложенные папки                     | `os.makedirs("a/b/c")`                      | Создаст каталоги `a`, `a/b`, `a/b/c`                      |
| `os.rmdir(path)`          | Удаляет **пустую** папку                    | `os.rmdir("new_folder")`                    | Папка удаляется, если она пуста                           |
| `os.remove(path)`         | Удаляет файл                                | `os.remove("file.txt")`                     | Файл будет удалён                                         |
| `os.rename(src, dst)`     | Переименовывает файл или папку              | `os.rename("old.txt", "new.txt")`           | `old.txt` → `new.txt`                                     |
| `os.path.abspath(path)`   | Возвращает абсолютный путь                  | `print(os.path.abspath("data.txt"))`        | Например: `C:\Users\User\project\data.txt`                |
| `os.path.exists(path)`    | Проверяет существование пути                | `print(os.path.exists("data.txt"))`         | `True` или `False`                                        |
| `os.path.isdir(path)`     | Проверяет, является ли путь папкой          | `print(os.path.isdir("docs"))`              | `True` / `False`                                          |
| `os.path.isfile(path)`    | Проверяет, является ли путь файлом          | `print(os.path.isfile("main.py"))`          | `True` / `False`                                          |
| `os.path.join(a, b, ...)` | Правильно соединяет части пути              | `print(os.path.join("folder", "file.txt"))` | `folder/file.txt` (Linux) или `folder\file.txt` (Windows) |
| `os.sep`                  | Символ разделителя путей OS (зависит от ОС) | `print(os.sep)`                             | `/` (Linux/Mac) или `\` (Windows)                         |
| `os.path.split(path)`    | Разделяет путь на директорию и имя файла     | `os.path.split("folder/file.txt")`          | `('folder', 'file.txt')`               |
| `os.path.basename(path)` | Возвращает только имя файла или папки        | `os.path.basename("folder/file.txt")`       | `'file.txt'`                           |
| `os.path.dirname(path)`  | Возвращает только директорию без имени файла | `os.path.dirname("folder/file.txt")`        | `'folder'`                             |


## Отличие `os.mkdir` от `os.makedirs`

| Возможности                                        | Пример                                  | `os.mkdir` | `os.makedirs`             |
|----------------------------------------------------|-----------------------------------------| ---------- | ------------------------- |
| Может создать ТОЛЬКО одну вложенную папку          | `os.mkdir('folder1')`                   | ✅          | ❌                         |
| Может создавать вложенные папки                    | `os.makedirs('a/b/c')`                  | ❌          | ✅                         |
| Может не выбрасывать ошибку, если папка существует | `os.makedirs('folder2', exist_ok=True)` | ❌          | ✅ (`exist_ok=True`)       |
| Генерирует `FileExistsError`, если папка уже есть  | `os.mkdir('folder1')`                   | ✅          | ✅ (если `exist_ok=False`) |

"""
os.walk - удобная рекурсивная функция, которая сама рекурсивно
обходит все директории, начиная от текущей
"""
import os

def print_tree(start_path="."):
    for root, dirs, files in os.walk(start_path):
        level = root.replace(start_path, "").count(os.sep)
        indent = "│   " * level
        folder_name = os.path.basename(root) if os.path.basename(root) else root
        print(f"{indent}├── [{folder_name}]")

        # Сортируем, чтобы порядок был аккуратный
        files = sorted(files)
        dirs[:] = sorted(dirs)

        for i, file in enumerate(files):
            is_last = (i == len(files) - 1 and not dirs)  # последний только если нет подпапок ниже
            sub_indent = "│   " * (level + 1)
            branch = "└──" if is_last else "├──"
            print(f"{sub_indent}{branch} {file}")

print_tree(".")

#
# ├── [.]
# │   ├── homework_33_01.py
# │   ├── homework_33_02.py
# │   ├── homework_36_03.py
# │   ├── practice_work_35_01.py
# │   ├── practice_work_35_02.py
# │   ├── practice_work_03.py
# │   ├── theory_01__absolute_and_relative.md
# │   ├── theory_02__os_methods.md
# │   ├── theory_03__os_walk.py
# │   ├── theory_04__sys_argv.py
# │   ├── theory_05__PRACTICE_getting_parameters_in_endpoints.md
# │   ├── [project]
# │   │   ├── homework_33_01.py
# │   │   ├── homework_33_02.py
# │   │   └── homework_36_03.py

import os

# Поиск всех .txt файлов
for root, dirs, files in os.walk("."):
    for file in files:
        if file.endswith(".txt"):
            print(f"Найден файл: {os.path.join(root, file)}")

## Функция `open()` 

Используется для открытия файлов и работы с ними: 
* чтения, 
* записи, 
* добавления данных

### Синтаксис

```python
open(filename, mode='r', encoding=None)
```

### Параметры

* `filename` — путь к файлу.
* `mode` — режим открытия файла.
* `encoding` — кодировка файла (обычно `utf-8` для текстовых файлов).

### Основные режимы открытия

| Режим | Описание                                               |
| ----- | ------------------------------------------------------ |
| `r`   | Чтение файла (по умолчанию)                            |
| `w`   | Запись (создаёт новый файл или очищает существующий)   |
| `a`   | Добавление данных в конец файла                        |
| `x`   | Создание нового файла, ошибка если файл уже существует |
| `b`   | Бинарный режим                                         |
| `t`   | Текстовый режим (по умолчанию)                         |
| `+`   | Чтение и запись одновременно                           |

### Пример чтения файла

```python
file = open("data.txt", "r", encoding="utf-8")
text = file.read()
file.close()  # ⚠️ Открытый файл ОБЯЗАТЕЛЬНО должен быть закрыт

print(text)
```

### Пример записи в файл

```python
file = open("data.txt", "w", encoding="utf-8")
file.write("Привет, мир!")
file.close()
```

### Контекстный менеджер

Конструкция `with` автоматически закрывает файл после завершения работы.

```python
with open("data.txt", "r", encoding="utf-8") as file:
    text = file.read()

print(text)
```

"""
sys.argv`— это список аргументов, которые были переданы скрипту при запуске из командной строки.

- Первый элемент (`sys.argv[0]`) - всегда содержит имя скрипта.
- Все последующие элементы (`sys.argv[1:]`) — это аргументы, переданные в командной строке


КОМАНДА ДЛЯ ПРИМЕРА:

python theory_06__sys_argv.py аргумент_1 второй третий 4-й и 5

"""

import sys

print("Имя скрипта:", sys.argv[0])

print("Все переданные аргументы:")
for i, value in enumerate(sys.argv[1:]):
    print(f"{i+1}. {value} {type(value)}")