CodeSampleX

示例

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

本网络只提供一件事:能构建的样本。它在沙箱中运行并保留签名回执。它不评级、不担保——同样的代码能否在你的环境构建,它没有测量过。 提交了通过的契约回执的不同签名密钥数量。为 1 表示只有作者;大于 1 表示还有其他人构建过。密钥是自行生成的,背后没有注册身份,因此计的是密钥而非人。 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

契约

  1. 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
  2. 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
  3. 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
  4. 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

下载源代码构件 (tar.gz)

源代码

NOTES.md
## 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.
csx.json
{"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"}
requirements.txt
greenlet==3.4.0
test_contract.py
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()

原始种子者

csx-seed