Шпаргалка по Python 3

Самое нужное на одной странице. Актуально для Python 3.12+.

Основы

x, y = 1, 2            # множественное присваивание
x, y = y, x            # обмен
a, *rest = [1, 2, 3]   # a=1, rest=[2, 3]
n = 1_000_000          # разделители в числах
7 // 2, 7 % 2, 2 ** 10 # 3, 1, 1024
divmod(7, 2)           # (3, 1)
if (n := len(data)) > 10: ...   # моржовый оператор
val = a if cond else b

Строки

name, pi = "Ann", 3.14159
f"{name!r:>8} {pi:.2f} {1e6:,.0f}"  # "   'Ann' 3.14 1,000,000"
f"{x=}"                  # отладка: "x=1"
s.strip() s.split(",") ",".join(lst)
s.startswith(("http", "ftp"))
s.removeprefix("v")      # 3.9+
s.replace("a", "b", 1)
s[::-1]                  # разворот
"abc".encode()           # b'abc'

Списки и срезы

lst = [3, 1, 2]
lst.append(4); lst.extend([5, 6]); lst.insert(0, 9)
lst.pop(); lst.remove(9)
sorted(lst, key=abs, reverse=True)
lst[1:4], lst[::2], lst[-1]
for i, v in enumerate(lst, start=1): ...
for a, b in zip(xs, ys, strict=True): ...
any(x > 0 for x in lst), all(...)

Словари и множества

d = {"a": 1}
d.get("b", 0)
d.setdefault("b", []).append(1)
d | {"c": 3}              # слияние, 3.9+
for k, v in d.items(): ...
{k: v for k, v in pairs if v}

from collections import Counter, defaultdict
Counter("abracadabra").most_common(2)
g = defaultdict(list); g[key].append(x)

a, b = {1, 2}, {2, 3}
a | b, a & b, a - b, a ^ b

Генераторы и включения

[x * x for x in range(10) if x % 2]
{x % 3 for x in data}
(x for x in big)           # ленивый генератор
[[0] * 3 for _ in range(3)] # НЕ [[0]*3]*3

def chunks(seq, n):
    for i in range(0, len(seq), n):
        yield seq[i:i + n]

Функции

def f(a, b=2, /, c=3, *args, d, **kw): ...
# / — только позиционные, после * — только именованные

def append(x, acc=None):   # не используйте [] по умолчанию
    acc = acc or []
    acc.append(x)
    return acc

sq = lambda x: x * x
from functools import cache, partial, wraps
@cache
def fib(n): return n if n < 2 else fib(n-1) + fib(n-2)

Декораторы

import time
from functools import wraps

def timed(fn):
    @wraps(fn)
    def wrapper(*a, **kw):
        t = time.perf_counter()
        try:
            return fn(*a, **kw)
        finally:
            print(f"{fn.__name__}: {time.perf_counter() - t:.3f}s")
    return wrapper

Классы и dataclass

from dataclasses import dataclass, field

@dataclass(slots=True, frozen=True)
class Point:
    x: float
    y: float = 0.0
    tags: list[str] = field(default_factory=list)

    @property
    def norm(self) -> float:
        return (self.x ** 2 + self.y ** 2) ** 0.5

    @classmethod
    def origin(cls): return cls(0, 0)

match / case

match cmd.split():
    case ["go", direction]:
        move(direction)
    case ["drop", *items]:
        drop(items)
    case {"type": "error", "code": int(code)}:
        handle(code)
    case _:
        print("unknown")

Файлы и pathlib

from pathlib import Path
p = Path("data") / "log.txt"
p.parent.mkdir(parents=True, exist_ok=True)
p.write_text("hi", encoding="utf-8")
text = p.read_text(encoding="utf-8")
for f in Path(".").rglob("*.py"): ...
p.stem, p.suffix, p.exists()

with open(p, encoding="utf-8") as fh:
    for line in fh: ...

import json
json.loads(s); json.dumps(obj, ensure_ascii=False, indent=2)

Исключения

try:
    risky()
except (ValueError, KeyError) as e:
    log.warning("bad input: %s", e)
except Exception:
    log.exception("unexpected")
    raise
else:
    ok()
finally:
    cleanup()

raise RuntimeError("fail") from err
from contextlib import suppress
with suppress(FileNotFoundError): os.remove(tmp)

itertools

from itertools import chain, groupby, islice, product, pairwise, batched
list(chain([1, 2], [3]))          # [1, 2, 3]
list(islice(gen, 5))              # первые 5
list(pairwise("abc"))             # [('a','b'), ('b','c')]
list(batched(range(7), 3))        # 3.12+: (0,1,2) (3,4,5) (6,)
for k, grp in groupby(sorted(xs, key=f), key=f): ...

Типизация

from typing import Protocol, TypedDict, Literal

def first[T](xs: list[T]) -> T | None:   # 3.12+ generics
    return xs[0] if xs else None

type Json = dict[str, "Json"] | list["Json"] | str | int | None

class Reader(Protocol):
    def read(self, n: int = -1) -> bytes: ...

Mode = Literal["r", "w"]

asyncio

import asyncio

async def fetch(i: int) -> int:
    await asyncio.sleep(0.1)
    return i

async def main():
    async with asyncio.TaskGroup() as tg:   # 3.11+
        tasks = [tg.create_task(fetch(i)) for i in range(5)]
    print([t.result() for t in tasks])
    async with asyncio.timeout(2): await fetch(9)

asyncio.run(main())

Окружение и пакеты

python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
python -m pip freeze > requirements.txt

uv venv && uv pip install httpx   # быстрее pip
python -m http.server 8000        # раздать текущую папку
python -m json.tool file.json     # форматировать JSON

Отладка и профилирование

breakpoint()                       # pdb в нужном месте
python -m cProfile -s cumtime app.py
python -m timeit "sum(range(1000))"
import logging
logging.basicConfig(level=logging.INFO,
    format="%(asctime)s %(levelname)s %(name)s: %(message)s")