Файлы и pathlib

from pathlib import Path
import tempfile

folder = Path(tempfile.mkdtemp())
path = folder / "notes.txt"

with open(path, "w", encoding="utf-8") as f:     # запись (файл создаётся или очищается)
    f.write("Первая строка\n")
    f.write("Вторая строка\n")
    print("третья строка", file=f)              # print тоже умеет писать в файл

with open(path, encoding="utf-8") as f:          # чтение (режим "r" по умолчанию)
    print(repr(f.read()))

with open(path, "a", encoding="utf-8") as f:     # дописать в конец
    f.writelines(["четвёртая\n", "пятая\n"])

with open(path, encoding="utf-8") as f:
    for number, line in enumerate(f, start=1):   # построчно, лениво
        print(number, line.rstrip("\n"))

from pathlib import Path
import tempfile

path = Path(tempfile.mkdtemp()) / "data.txt"
path.write_text("один\nдва\nтри\n", encoding="utf-8")

with open(path, encoding="utf-8") as f:
    print(repr(f.readline()))          # одна строка
    print(f.readlines())               # остальные строки списком
with open(path, encoding="utf-8") as f:
    print(repr(f.read(6)))             # первые 6 символов
    print(f.tell())                    # позиция в байтах (кириллица — 2 байта на букву)
    f.seek(0)                          # вернуться в начало
    print(f.read().splitlines())

from pathlib import Path
import tempfile

path = Path(tempfile.mkdtemp()) / "ru.txt"
path.write_text("Привет", encoding="utf-8")
print(path.read_bytes())                               # 12 байт: по 2 на букву
print(path.read_text(encoding="utf-8"))
try:
    path.read_text(encoding="ascii")
except UnicodeDecodeError as e:
    print("UnicodeDecodeError:", e.reason)
print(path.read_text(encoding="cp1251"))               # не та кодировка — «кракозябры»
print(path.read_text(encoding="ascii", errors="replace"))

from pathlib import Path
import tempfile, hashlib

path = Path(tempfile.mkdtemp()) / "blob.bin"
path.write_bytes(bytes(range(256)) * 1000)

sha = hashlib.sha256()
with open(path, "rb") as f:
    while chunk := f.read(64 * 1024):          # блоками по 64 КБ — для файлов любого размера
        sha.update(chunk)
print(path.stat().st_size, "байт, sha256 =", sha.hexdigest()[:16], "...")

from pathlib import Path, PurePosixPath, PureWindowsPath

p = Path("/home/anna/projects/shop/src/main.py")
print(p.name, p.stem, p.suffix)           # main.py main .py
print(p.parent, p.parent.parent.name)
print(p.parts[:3])
print(p.with_suffix(".txt").name, p.with_name("app.py").name)
print(Path("data") / "2026" / "report.csv")
print(p.relative_to("/home/anna"))
print(PureWindowsPath(r"C:\Users\Anna\file.txt").parts)
print(Path.home(), Path.cwd())

from pathlib import Path
import tempfile

root = Path(tempfile.mkdtemp())
(root / "src" / "utils").mkdir(parents=True, exist_ok=True)   # как mkdir -p
(root / "src" / "main.py").write_text("print('hi')\n", encoding="utf-8")
(root / "src" / "utils" / "text.py").write_text("", encoding="utf-8")
(root / "README.md").write_text("# Проект", encoding="utf-8")

print(sorted(p.name for p in root.iterdir()))                 # содержимое папки
print(sorted(p.name for p in root.glob("*.md")))              # шаблон в папке
print(sorted(str(p.relative_to(root)) for p in root.rglob("*.py")))   # рекурсивно
f = root / "src" / "main.py"
print(f.exists(), f.is_file(), f.is_dir(), f.stat().st_size)
f.rename(root / "src" / "app.py")
(root / "README.md").unlink()                                 # удалить файл
print(sorted(str(p.relative_to(root)) for p in root.rglob("*")))

import tempfile
from pathlib import Path

with tempfile.TemporaryDirectory() as tmp:          # папка удалится после блока
    p = Path(tmp) / "report.csv"
    p.write_text("a,b\n1,2\n", encoding="utf-8")
    print(p.exists())
print(p.exists())

with tempfile.NamedTemporaryFile("w+", suffix=".txt", encoding="utf-8") as f:
    f.write("временные данные")
    f.seek(0)
    print(f.name.endswith(".txt"), f.read())

import os, tempfile, json
from pathlib import Path

def atomic_write(path: Path, text: str):
    fd, tmp = tempfile.mkstemp(dir=path.parent, suffix=".tmp")
    try:
        with os.fdopen(fd, "w", encoding="utf-8") as f:
            f.write(text)
            f.flush()
            os.fsync(f.fileno())            # гарантировать запись на диск
        os.replace(tmp, path)               # атомарная замена
    except BaseException:
        os.unlink(tmp)
        raise

target = Path(tempfile.mkdtemp()) / "state.json"
atomic_write(target, json.dumps({"version": 2}))
print(target.read_text(encoding="utf-8"))

from pathlib import Path

UPLOADS = Path("/srv/uploads").resolve()

def safe_path(user_filename: str) -> Path:
    candidate = (UPLOADS / user_filename).resolve()
    if not candidate.is_relative_to(UPLOADS):        # защита от ../../etc/passwd
        raise PermissionError(f"выход за пределы папки: {user_filename}")
    return candidate

print(safe_path("avatar.png"))
try:
    safe_path("../../etc/passwd")
except PermissionError as e:
    print("PermissionError:", e)