context manager と with 文とは何ですか？

Question

Accepted Answer

**context manager** は、セットアップとティアダウンのロジックを定義するオブジェクトで、**`with`** 文とともに使います。エラーが発生した場合でも、後始末（ファイルのクローズ、ロックの解放、トランザクションのロールバック）が自動的に行われることを保証します。

## これが解決する問題

```python
# ❌ manual cleanup — error-prone; if processing throws, the file never closes
f = open("file.txt")
data = f.read()
process(data)        # if this raises, f.close() below is skipped → leaked file handle
f.close()

# ✅ with statement — guarantees the file is closed, no matter what
with open("file.txt") as f:
    data = f.read()
    process(data)
# f is automatically closed here — even if process() raised an exception
```

`with` ブロックは、通常終了でも例外による終了でも、ブロックを抜けるときに `f.close()` が実行されることを保証し、忘れたりスキップされたりした後始末によるリソースリークを排除します。

## よく使われる context manager

```python
with open("f.txt") as f: ...           # files (auto-close)
with lock:                              # threading locks (auto-release)
    shared_resource += 1
with db.transaction():                  # DB transactions (auto-commit/rollback)
    ...
with open("a") as a, open("b") as b:    # multiple at once
    ...
```

## 自作する — クラスによる方法

```python
class Timer:
    def __enter__(self):                 # SETUP — runs at `with` entry
        self.start = time.perf_counter()
        return self                       # the value bound to `as`
    def __exit__(self, exc_type, exc_val, tb):  # TEARDOWN — runs at exit (even on error)
        print(f"took {time.perf_counter() - self.start:.3f}s")
        # return False → propagate any exception; True → suppress it

with Timer():
    do_work()
```

context manager は `__enter__`（セットアップ）と `__exit__`（後始末。例外情報を受け取る）を実装します。

## より簡単な方法 — contextlib

```python
from contextlib import contextmanager

@contextmanager
def timer():
    start = time.perf_counter()
    try:
        yield                            # everything before yield = setup; after = teardown
    finally:
        print(f"took {time.perf_counter() - start:.3f}s")

with timer():
    do_work()
```

`@contextmanager` decorator は generator を context manager に変えます。`yield` の前がセットアップ、後が後始末（安全のため `finally` 内）です。

## なぜ重要なのか

context manager と `with` は、**リソースを安全に管理する** Python 流の方法です。例外が発生した場合でも、ファイルがクローズされ、ロックが解放され、コネクションが返却され、トランザクションが確定されることを保証します。

これにより、手動の後始末でよくあるバグの原因であるリソースリークや不整合な状態を防げます。

これらは絶えず使われており（すべてのファイル操作は `with` を使うべきです）、自作の方法（`__enter__`／`__exit__`、あるいはより簡単な `@contextmanager`）を知っておくと、あらゆるセットアップ／ティアダウンのパターンをきれいかつ確実にカプセル化できます。