# Пример правильного открытия текстового файла для чтения
# Мы явно указываем режим 'r' и кодировку 'utf-8'

try:
    # Функция open() возвращает файловый объект, который мы сохраняем в переменную file
    file = open('example.txt', mode='r', encoding='utf-8')
    print("Файл успешно открыт!")
    print(f"Тип файлового объекта: {type(file)}")
    
    # Обязательно закрываем файл после использования!
    file.close()
except FileNotFoundError:
    print("Ошибка: Файл 'example.txt' не найден в текущей директории.")
except PermissionError:
    print("Ошибка: Нет прав на чтение файла.")

# Устаревший и громоздкий способ (try-finally)
file = open('data.txt', 'r', encoding='utf-8')
try:
    content = file.read()
    # Если тут произойдет ошибка, блок finally все равно закроет файл
    result = 10 / 0  # Искусственная ошибка
finally:
    file.close()

# ==========================================================
# Современный подход (Pythonic way) с использованием 'with'
# ==========================================================
with open('data.txt', 'r', encoding='utf-8') as file:
    content = file.read()
    # Файл автоматически закроется при выходе из этого блока с отступом.
    # Нам больше не нужно явно писать file.close()!

# Пример работы с файловым курсором и методом read()

with open('sample.txt', 'r', encoding='utf-8') as f:
    print(f"Начальная позиция курсора: {f.tell()}")
    
    # Читаем первые 5 символов
    chunk1 = f.read(5)
    print(f"Первые 5 символов: '{chunk1}'")
    print(f"Позиция курсора после чтения: {f.tell()}")
    
    # Читаем следующие 10 символов
    chunk2 = f.read(10)
    print(f"Следующие 10 символов: '{chunk2}'")
    
    # Читаем весь оставшийся текст до конца файла
    rest_of_file = f.read()
    
    # Пытаемся прочитать снова (курсор в конце)
    empty_read = f.read()
    print(f"Чтение в конце файла вернет пустую строку. Длина: {len(empty_read)}")
    
    # Сброс курсора в начало
    f.seek(0)
    print(f"Курсор сброшен. Позиция: {f.tell()}")
    start_again = f.read(3)
    print(f"Снова читаем с начала: '{start_again}'")

# Паттерн чтения файла построчно с помощью readline() и цикла while
# Этот подход экономит память (Memory Efficient)

print("--- Чтение лога построчно ---")
with open('server_log.txt', 'r', encoding='utf-8') as log_file:
    line_number = 1
    while True:
        # Читаем одну строку
        line = log_file.readline()
        
        # Если line пустая (''), значит мы достигли конца файла (EOF)
        if not line:
            break
            
        # Очищаем строку от невидимых символов (в т.ч. от \n на конце)
        clean_line = line.strip()
        
        # Обрабатываем строку (например, ищем ошибки)
        if 'ERROR' in clean_line:
            print(f"Строка {line_number} содержит ОШИБКУ: {clean_line}")
            
        line_number += 1

# Пример работы с методом readlines() (только для малых файлов!)

with open('shopping_list.txt', 'r', encoding='utf-8') as f:
    # Читаем все строки в список памяти
    lines_list = f.readlines()
    
print(f"Тип данных результата: {type(lines_list)}")
print(f"Всего строк в файле: {len(lines_list)}")

# Теперь мы можем обращаться по индексу (что невозможно с обычным readline)
if len(lines_list) > 2:
    print(f"Третья строка: {lines_list[2].strip()}")
    
# Сортировка строк по алфавиту
sorted_lines = sorted(lines_list)
for item in sorted_lines:
    print(item.strip())

# ==========================================================
# АБСОЛЮТНЫЙ СТАНДАРТ: Прямая итерация циклом for (Pythonic Way)
# ==========================================================

# Файл любого размера (хоть 100 Гигабайт) будет обработан без падения по памяти
with open('huge_data.csv', 'r', encoding='utf-8') as data_file:
    # Пропускаем заголовок CSV-файла, вызвав next() вручную один раз
    header = next(data_file)
    print(f"Заголовки колонок: {header.strip()}")
    
    # Итерируемся по оставшимся строкам. 
    # Переменная 'line' автоматически получает новую строку на каждом шаге
    for line in data_file:
        clean_line = line.strip()
        # Игнорируем пустые строки
        if not clean_line:
            continue
            
        # Обработка данных...
        # print(clean_line)

import os

# Безопасный паттерн работы с файловой системой
file_path = 'config/database_settings.json'

try:
    with open(file_path, 'r', encoding='utf-8') as config_file:
        settings = config_file.read()
        print("Конфигурация успешно загружена.")
        # парсинг JSON...
        
except FileNotFoundError:
    print(f"КРИТИЧЕСКАЯ ОШИБКА: Файл '{file_path}' не найден.")
    print("Пожалуйста, проверьте наличие директории 'config/' и файла конфигурации.")
    # Здесь можно применить значения по умолчанию или завершить программу
    
except PermissionError:
    print(f"ОШИБКА ДОСТУПА: У программы нет прав на чтение файла '{file_path}'.")
    print("Попробуйте запустить скрипт от имени Администратора (sudo).")
    
except UnicodeDecodeError:
    print("ОШИБКА КОДИРОВКИ: Файл не является валидным UTF-8 документом.")

from pathlib import Path

# 1. Получаем абсолютный путь к директории, где лежит этот скрипт
BASE_DIR = Path(__file__).resolve().parent
print(f"Базовая директория: {BASE_DIR}")

# 2. Формируем путь к файлу с данными (кроссплатформенно!)
# Оператор '/' в pathlib переопределен для склеивания путей
target_file = BASE_DIR / 'data' / 'dataset.csv'
print(f"Абсолютный путь к файлу: {target_file}")

# 3. Безопасная проверка существования и открытие
if target_file.exists() and target_file.is_file():
    # Объект Path передается прямо в open()
    with open(target_file, 'r', encoding='utf-8') as f:
        print("Файл найден и открыт!")
else:
    print(f"ОШИБКА: Файл не найден по пути {target_file}")