k07. Файлы, JSON, CSV, YAML

Код целиком.

# Пример: путь к файлу рядом со скриптом
from pathlib import Path

here = Path(__file__).resolve().parent
out_dir = here / "k07_data"
out_dir.mkdir(exist_ok=True)
note_path = out_dir / "hello_note.txt"
print(note_path)
print("exists before write:", note_path.exists())

• Построчный разбор

  Ниже приведён тот же фрагмент с пояснением после каждой смысловой строки. Строки, которые начинаются с последовательности символов «# →», содержат комментарий преподавателя. Эти строки не являются обязательной частью программы, которую вы будете сдавать как готовый производственный код.

  from pathlib import Path
  # → Подключаем стандартный модуль для работы с путями как с объектами.
  
  here = Path(__file__).resolve().parent
  # → Path(__file__) — путь к текущему .py-файлу. resolve() делает путь полным. parent — каталог, где лежит файл.
  
  out_dir = here / "k07_data"
  # → Оператор «/» у Path добавляет часть пути. Получается папка k07_data рядом со скриптом.
  
  out_dir.mkdir(exist_ok=True)
  # → Создаём папку. Если она уже есть, ошибки не будет.
  
  note_path = out_dir / "hello_note.txt"
  # → Собираем полный путь к файлу hello_note.txt внутри этой папки.
  
  print(note_path)
  # → Печатаем путь, чтобы увидеть, куда программа будет писать.
  
  print("exists before write:", note_path.exists())
  # → exists() отвечает True/False: есть ли уже такой файл на диске.

Код целиком.

# Пример: запись и чтение текста в UTF-8
from pathlib import Path

path = Path("k07_data") / "hello_note.txt"
path.parent.mkdir(exist_ok=True)
path.write_text("Строка один\nСтрока два\n", encoding="utf-8")
text = path.read_text(encoding="utf-8")
print(text)

• Построчный разбор

  Ниже приведён тот же фрагмент с пояснением после каждой смысловой строки. Строки, которые начинаются с последовательности символов «# →», содержат комментарий преподавателя. Эти строки не являются обязательной частью программы, которую вы будете сдавать как готовый производственный код.

  from pathlib import Path
  # → Снова импортируем Path, чтобы указать путь к текстовому файлу.
  
  path = Path("k07_data") / "hello_note.txt"
  # → Путь относительно текущей рабочей папки запуска (в практике task1 путь привязан к __file__).
  
  path.parent.mkdir(exist_ok=True)
  # → parent — каталог файла; создаём его при необходимости.
  
  path.write_text("Строка один\nСтрока два\n", encoding="utf-8")
  # → write_text записывает весь текст целиком. encoding="utf-8" сохраняет кириллицу предсказуемо.
  
  text = path.read_text(encoding="utf-8")
  # → read_text читает весь файл в одну строку Python.
  
  print(text)
  # → Печатаем прочитанное, чтобы убедиться, что запись удалась.

Код целиком.

# Пример: with гарантирует закрытие файла
from pathlib import Path

path = Path("k07_data") / "lines.txt"
with path.open("w", encoding="utf-8") as f:
    f.write("first\n")
    f.write("second\n")

• Построчный разбор

  Ниже приведён тот же фрагмент с пояснением после каждой смысловой строки. Строки, которые начинаются с последовательности символов «# →», содержат комментарий преподавателя. Эти строки не являются обязательной частью программы, которую вы будете сдавать как готовый производственный код.

  from pathlib import Path
  # → Импортируем класс Path из модуля pathlib.
  
  path = Path("k07_data") / "lines.txt"
  # → Задаём путь к файлу, который будет создан.
  
  with path.open("w", encoding="utf-8") as f:
  # → open открывает файл на запись («w»). with закроет файл даже при ошибке внутри блока.
  
      f.write("first\n")
  # → Пишем первую строку. \n — перевод строки.
  
      f.write("second\n")
  # → Пишем вторую строку.
  
  # здесь файл уже закрыт
  # → После выхода из with дескриптор файла закрыт автоматически.

Код целиком.

# Пример: dict → JSON → dict
import json
from pathlib import Path

sample = {
    "mode": "GUIDED",
    "altitude_m": 12.5,
    "link_ok": True,
}
path = Path("k07_data") / "telemetry_sample.json"
text = json.dumps(sample, ensure_ascii=False, indent=2)
path.write_text(text, encoding="utf-8")
loaded = json.loads(path.read_text(encoding="utf-8"))
print(loaded["mode"], loaded["altitude_m"])

• Построчный разбор

  Ниже приведён тот же фрагмент с пояснением после каждой смысловой строки. Строки, которые начинаются с последовательности символов «# →», содержат комментарий преподавателя. Эти строки не являются обязательной частью программы, которую вы будете сдавать как готовый производственный код.

  import json
  # → Стандартный модуль для JSON.
  
  from pathlib import Path
  # → Импортируем pathlib для указания пути к файлу.
  
  sample = {
  # → Обычный словарь Python — учебный снимок телеметрии.
  
      "mode": "GUIDED",
  # → Ключ mode — строка с режимом.
  
      "altitude_m": 12.5,
  # → Высота числом float.
  
      "link_ok": True,
  # → Логический флаг.
  
  }
  # → Конец словаря.
  
  path = Path("k07_data") / "telemetry_sample.json"
  # → Куда сохраним JSON-файл.
  
  text = json.dumps(sample, ensure_ascii=False, indent=2)
  # → dumps: объект Python → текст JSON. ensure_ascii=False оставляет кириллицу читаемой. indent=2 делает отступы.
  
  path.write_text(text, encoding="utf-8")
  # → Записываем JSON-текст на диск.
  
  loaded = json.loads(path.read_text(encoding="utf-8"))
  # → loads: текст JSON → снова dict/list в Python.
  
  print(loaded["mode"], loaded["altitude_m"])
  # → Проверяем, что поля на месте после круглого пути запись→чтение.

Код целиком.

# Пример: list[dict] → CSV → чтение с float()
import csv
from pathlib import Path

path = Path("k07_data") / "track_demo.csv"
rows = [
    {"t_s": 0.0, "alt_m": 0.5, "mode": "STABILIZE"},
    {"t_s": 1.0, "alt_m": 5.0, "mode": "GUIDED"},
]
fieldnames = ["t_s", "alt_m", "mode"]

with path.open("w", encoding="utf-8", newline="") as f:
    writer = csv.DictWriter(f, fieldnames=fieldnames)
    writer.writeheader()
    for row in rows:
        writer.writerow(row)

with path.open("r", encoding="utf-8", newline="") as f:
    reader = csv.DictReader(f)
    for row in reader:
        alt_m = float(row["alt_m"])
        print(row["mode"], alt_m)

• Построчный разбор

  Ниже приведён тот же фрагмент с пояснением после каждой смысловой строки. Строки, которые начинаются с последовательности символов «# →», содержат комментарий преподавателя. Эти строки не являются обязательной частью программы, которую вы будете сдавать как готовый производственный код.

  import csv
  # → Стандартный модуль таблиц CSV.
  
  from pathlib import Path
  # → Импортируем pathlib для построения путей к файлам.
  
  path = Path("k07_data") / "track_demo.csv"
  # → Задаём путь к CSV-файлу таблицы.
  
  rows = [
  # → Список словарей — одна строка таблицы = один dict.
  
      {"t_s": 0.0, "alt_m": 0.5, "mode": "STABILIZE"},
  # → Первая точка траектории.
  
      {"t_s": 1.0, "alt_m": 5.0, "mode": "GUIDED"},
  # → Вторая точка траектории.
  
  ]
  # → Конец списка.
  
  fieldnames = ["t_s", "alt_m", "mode"]
  # → Порядок и имена столбцов.
  
  with path.open("w", encoding="utf-8", newline="") as f:
  # → Открываем на запись. newline="" — рекомендация для csv на Windows.
  
      writer = csv.DictWriter(f, fieldnames=fieldnames)
  # → Писатель, который понимает dict.
  
      writer.writeheader()
  # → Первая строка файла — заголовки столбцов.
  
      for row in rows:
  # → Для каждой записи…
  
          writer.writerow(row)
  # → …пишем строку таблицы.
  
  with path.open("r", encoding="utf-8", newline="") as f:
  # → Открываем тот же файл на чтение.
  
      reader = csv.DictReader(f)
  # → Читатель отдаёт каждую строку как dict.
  
      for row in reader:
  # → Обходим строки данных.
  
          alt_m = float(row["alt_m"])
  # → Важно: из CSV числа приходят строками. float() делает число.
  
          print(row["mode"], alt_m)
  # → Печатаем режим и высоту.

Код целиком.

# Пример: запись через временный файл и os.replace
from pathlib import Path
import json
import os

final_path = Path("k07_data") / "settings.json"
tmp_path = Path("k07_data") / "settings.json.tmp"
final_path.parent.mkdir(exist_ok=True)

payload = json.dumps({"version": 1, "ok": True}, ensure_ascii=False, indent=2)
tmp_path.write_text(payload, encoding="utf-8")
os.replace(tmp_path, final_path)

• Построчный разбор

  Ниже приведён тот же фрагмент с пояснением после каждой смысловой строки. Строки, которые начинаются с последовательности символов «# →», содержат комментарий преподавателя. Эти строки не являются обязательной частью программы, которую вы будете сдавать как готовый производственный код.

  from pathlib import Path
  # → Импортируем pathlib для построения путей к файлам.
  
  import json
  # → Импортируем json, чтобы сформировать учебный JSON-текст.
  
  import os
  # → Импортируем os: функция os.replace заместит целевой файл временным.
  
  final_path = Path("k07_data") / "settings.json"
  # → Итоговое имя, которое должна видеть программа.
  
  tmp_path = Path("k07_data") / "settings.json.tmp"
  # → Временное имя на время записи.
  
  final_path.parent.mkdir(exist_ok=True)
  # → Каталог должен существовать.
  
  payload = json.dumps({"version": 1, "ok": True}, ensure_ascii=False, indent=2)
  # → Готовим полное содержимое в памяти.
  
  tmp_path.write_text(payload, encoding="utf-8")
  # → Шаг 1: полностью записываем временный файл.
  
  os.replace(tmp_path, final_path)
  # → Шаг 2: заменяем целевой файл готовым временным. Так меньше шанс «обрезанного» конфига.