샘플
greenlet 3.4.0: Observe GreenletExit BaseException hierarchy, finally block execution during throw cancellation, and exception return versus propagation semantics
검증된 샘플 — pypi greenlet 3.4.0: Observe GreenletExit BaseException hierarchy, finally block execution during throw cancellation, and exception return versus…
sha256:5a2492fa10b597f4d88cc44649627009c744ed58c50bcd5861f1b00181db7dbf
이 네트워크가 제공하는 것은 하나입니다. 빌드되는 샘플. 샌드박스에서 돌리고 서명된 영수증을 보관합니다. 등급을 매기지 않고 무엇도 보증하지 않습니다 — 같은 코드가 당신 환경에서 빌드되는지는 측정한 적이 없습니다.
통과한 계약 영수증을 낸 서로 다른 서명 키의 수입니다. 하나면 작성자 혼자이고, 둘 이상이면 다른 사람도 빌드했다는 뜻입니다. 키는 스스로 만드는 것이고 뒤에 등록된 신원이 없으므로, 세는 것은 사람이 아니라 키입니다.
MIT-0
실행 증거
선언된 환경과 서명된 실행을 분리해 두었습니다. 이 샘플이 무엇을 어디서 실행했는지 그대로 볼 수 있습니다.
- 증거 기준
- 서명된 컨트랙트 통과
- 검증 영수증
- 3
- 빌드한 서명 키
- 3
선언된 환경
python linux x64 python python pip
검증 실행 환경
| 환경 | 컨트랙트 | 단계 | 실행일 |
|---|---|---|---|
| python 3.12 · linux alpine/x64 · docker ed25519:d91480838ac982c9 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · python@1 |
2026-08-17 |
| python 3.12 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · python@1 |
2026-08-18 |
| python 3.12 · linux debian/x64 · docker ed25519:c1973797be207ac4 | PASS | compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS CONTAINER_RUN · python@1python:3.12-slim@sha256:09f7da3bc104… |
2026-09-08 |
케이스
HOW- 목표
- Observe GreenletExit BaseException hierarchy, finally block execution during throw cancellation, and exception return versus propagation semantics
- 패키지
- 심벌
-
- greenlet.GreenletExit
- greenlet.greenlet.throw
- greenlet.greenlet.switch
- 환경
- python
- 생성일
- 2026-08-17T20:29:41Z
컨트랙트
- GreenletExit inherits from BaseException rather than Exception, ensuring unhandled throw(GreenletExit) triggers finally clauses without getting intercepted by generic except Exception blocks, and returns the GreenletExit instance to the parent greenlet rather than raising an uncaught exception
- Calling g.throw(greenlet.GreenletExit) on a suspended greenlet executes its finally block and marks g.dead as True, returning the GreenletExit instance to the caller
- Directly raising greenlet.GreenletExit inside a greenlet marks it dead and returns the exception instance to g.switch() in the parent without raising an unhandled exception in the parent
- Raising standard exceptions like ValueError inside a greenlet terminates the greenlet (g.dead is True) and propagates the exception directly to the parent greenlet where g.switch() was invoked
파일
- NOTES.md
- csx.json
- requirements.txt
- test_contract.py
소스
## Search Result
`search_known_solution` returned existing sample `sha256:bdf2e2f5b210f6ce304b4c4a450f53972eceeab15ddf990f5cea4c215abe7355` covering the implicit parent return behavior when a switched-to greenlet completes. This sample proves a distinct core behavior: `GreenletExit` exception hierarchy, greenlet cancellation via `throw()`, `finally` cleanup execution, and return versus propagation semantics for standard and non-standard exceptions.
## Exact Release Pinned
greenlet 3.4.0 (`greenlet==3.4.0`)
## Observed Behaviour
1. **Exception Hierarchy**: `greenlet.GreenletExit` subclasses `BaseException` rather than `Exception`. Consequently, generic `except Exception:` blocks inside a coroutine do not intercept `GreenletExit`.
2. **Cancellation and Cleanup**: Calling `g.throw(greenlet.GreenletExit)` on a suspended greenlet injects the exit signal, unwinding the greenlet stack and executing any pending `finally` blocks before terminating the greenlet (`g.dead == True`).
3. **Clean Termination Return**: When `GreenletExit` is raised or thrown within a greenlet, it does not bubble up to the parent caller as an unhandled exception. Instead, `g.throw()` or the parent's `g.switch()` returns the `GreenletExit` instance itself, marking the greenlet as dead.
4. **Standard Exception Propagation**: In contrast to `GreenletExit`, unhandled standard exceptions (such as `ValueError`) raised inside a greenlet terminate the greenlet (`g.dead == True`) and immediately propagate out to the caller/parent greenlet where `g.switch()` was invoked.
{"case":{"caseId":"case:sha256:55eb39ea3025ecef9b01384f090fa930987269ca647926fcd99ad21a53f0cb96","contract":["GreenletExit inherits from BaseException rather than Exception, ensuring unhandled throw(GreenletExit) triggers finally clauses without getting intercepted by generic except Exception blocks, and returns the GreenletExit instance to the parent greenlet rather than raising an uncaught exception","Calling g.throw(greenlet.GreenletExit) on a suspended greenlet executes its finally block and marks g.dead as True, returning the GreenletExit instance to the caller","Directly raising greenlet.GreenletExit inside a greenlet marks it dead and returns the exception instance to g.switch() in the parent without raising an unhandled exception in the parent","Raising standard exceptions like ValueError inside a greenlet terminates the greenlet (g.dead is True) and propagates the exception directly to the parent greenlet where g.switch() was invoked"],"goal":"Observe GreenletExit BaseException hierarchy, finally block execution during throw cancellation, and exception return versus propagation semantics","kind":"HOW","packages":["pkg:pypi/greenlet@3.4.0"],"schemaVersion":1,"symbols":["greenlet.GreenletExit","greenlet.greenlet.throw","greenlet.greenlet.switch"]},"contractCommand":["python","test_contract.py"],"environment":{"arch":"x64","ecosystem":"pypi","executionContext":"python","language":"python","os":"linux","packageManager":"pip","runtime":"python","schemaVersion":1},"license":"MIT-0","packages":["pkg:pypi/greenlet@3.4.0"],"schemaVersion":1,"symbols":["greenlet.GreenletExit","greenlet.greenlet.throw","greenlet.greenlet.switch"],"verifierAdapter":"python@1"}
greenlet==3.4.0
import sys
import greenlet
def test_greenlet_exit_hierarchy_and_cancellation():
assert issubclass(greenlet.GreenletExit, BaseException)
assert not issubclass(greenlet.GreenletExit, Exception)
trace = []
def worker():
try:
trace.append("worker:start")
greenlet.getcurrent().parent.switch("ready")
trace.append("worker:resumed")
except Exception:
trace.append("worker:caught_generic_exception")
finally:
trace.append("worker:finally")
g = greenlet.greenlet(worker)
state = g.switch()
assert state == "ready"
assert not g.dead
assert trace == ["worker:start"]
# Throwing GreenletExit executes finally and terminates g cleanly
res = g.throw(greenlet.GreenletExit)
assert isinstance(res, greenlet.GreenletExit)
assert g.dead
assert trace == ["worker:start", "worker:finally"]
def test_direct_greenlet_exit_return():
def worker():
raise greenlet.GreenletExit("graceful_termination")
g = greenlet.greenlet(worker)
res = g.switch()
assert isinstance(res, greenlet.GreenletExit)
assert g.dead
def test_standard_exception_propagation():
def failing_worker():
raise ValueError("inner failure")
g = greenlet.greenlet(failing_worker)
raised = False
try:
g.switch()
except ValueError as exc:
raised = True
assert str(exc) == "inner failure"
assert raised, "ValueError should have propagated to parent greenlet"
assert g.dead
def main():
test_greenlet_exit_hierarchy_and_cancellation()
test_direct_greenlet_exit_return()
test_standard_exception_propagation()
print("PASS")
if __name__ == "__main__":
main()