Python-Dream-It-s-MyGO 0.1.0

A Python package for MyGO(Simple Goto)

MyGO - Interactive Toolset Supporting Multi-directional Yielding Goto Operations

Implementation That Simulates Mind-bending Yet Glorious Operations - A Python package that provides simple label/goto capabilities within the same function using AST transformation.

查看中文版README请点击：中文文档

⚠️ Warning: This library is for research and educational purposes only. Do not use in production environments.

Features

• label("NAME"): Records a jumpable "label line".
• goto("NAME"): Jumps to the label line on the next line event through a one-time sys.settrace.

This implementation uses AST (Abstract Syntax Tree) transformation to:

• Collect label locations during the first pass
• Rewrite goto statements to target line numbers during the second pass
• Compile the transformed AST back to executable code

Limitations are the same as pdb j:

• Can only jump within the same function, not across functions/stacks.
• Cannotc ross with/try/except/finally/yield/await and other structural boundaries.
• Target line must have real bytecode (this implementation changes the label line to a constant expression to ensure it can be landed).

Installation

You can install mygo from PyPI:

pip install mygo

Or, install from source:

git clone https://github.com/AndreaFrederica/Python-Dream-It-s-MyGO.git
cd Python-Dream-It-s-MyGO
uv sync

Usage

from mygo import enable_goto, label, goto

@enable_goto
def demo():
    print("A")
    label("L")
    print("B-before")
    goto("L")
    print("C-after")  # This line will never execute

demo()

More examples can be found in the examples/ directory.

Contributing

Issues and Pull Requests are welcome!

License

This project is open source under Mozilla Public License 2.0. See LICENSE file for details.

Contact Author

Email: [e-mail]