Mitä ovat kontekstinhallintaohjelmat ja with-lause?

Question

Accepted Answer

**Kontekstinhallintaohjelma** on objekti, joka määrittää alustus- ja puhdistuslogiikan, joita käytetään **`with`**-lauseen kanssa. Se takaa, että puhdistus (tiedostojen sulkeminen, lukkojen vapauttaminen, transaktioiden palautus) tapahtuu automaattisesti — jopa virheenä.

## Ongelma, jonka se ratkaisee

```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`-lohko varmistaa, että `f.close()` suoritetaan lohkon poistumisessa, joko normaalisti tai poikkeuksen kautta — poistaen resurssivarojen vuodot unohdetusta tai ohitetusta puhdistuksesta.

## Yleiset kontekstinhallintaohjelmat

```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
    ...
```

## Omasi kirjoittaminen — luokkamenetelmä

```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()
```

Kontekstinhallintaohjelma toteuttaa `__enter__` (alustus) ja `__exit__` (puhdistus, joka vastaanottaa poikkeustiedot).

## Helpompi tapa — 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`-koristin muuttaa generaattorin kontekstinhallintaohjelmaksi — alustus ennen `yield`, puhdistus jälkeen (turvaa varten `finally`).

## Miksi sillä on merkitystä

Kontekstinhallintaohjelmat ja `with` ovat Pythonic-tapa käsitellä **resurssien hallintaa turvallisesti** — takaamaan tiedostojen sulkeminen, lukkojen vapauttaminen, yhteyksien palauttaminen ja transaktioiden viimeisteleminen, vaikka poikkeuksia esiintyykin.

Tämä estää resurssivarojen vuodot ja epäyhtenäisen tilan, manuaalisen puhdistuksen yleisen virheiden lähteen.

Niitä käytetään jatkuvasti (jokaisen tiedostooperaation pitäisi käyttää `with`), ja tietäen kuinka kirjoittaa omia (`__enter__`/`__exit__` tai yksinkertaisemman `@contextmanager` kautta) voit kapseloida minkä tahansa alustus/puhdistus-mallin siististi ja luotettavasti.