Files
openidea/java/jvm-inspect/build.py
T
ntbang0901 921378d531 feat(debugger): trace a Java stream chain while the program runs it (#3727)
Adds Debug > Trace Stream Chain: paused on a line with a java.util.stream chain, the program runs that chain once, for real, while every element is recorded at every step, and a Stream Trace tab shows it Flat (all steps side by side, an element followed through the chain) or Split. Nothing is evaluated twice; the editor stops right after the statement.

- java/jvm-inspect 1.1.0 gets openidea.jvm.stream.*: wraps each step with peek(recorder) (a class defined in the debuggee), runs the terminal operation by invokeMethod, keeps breakpoints off while the chain runs and restores them, then parks the thread. The jar is reproducible from build.py (JDT LS 1.63.0, JDK 25).
- New ide-streams crate finds the chains on the paused line (tree-sitter) and builds the plan; ide-dap drives continue, wait, step out, collect. IPC: debug_stream_chains, debug_stream_trace, debug_stream_trace_abort.
- No automatic timeout: a long chain shows progress with Stop Recording and Abort Operation. At most 50,000 records are kept; banners say when values were dropped, a parallel chain ran sequentially, or breakpoints were off.

Co-authored-by: ntbang0901 <121003585+ntbang0901@users.noreply.github.com>
2026-11-17 01:44:40 +08:00

54 lines
2.6 KiB
Python

"""Reproducible bundle build: python3 build.py /path/to/jdtls [--test] [--out JAR] (JDT LS 1.63.0, Java 25; target Java 21).
--test compiles tests/SelfTest.java with the sources and runs it; it does not write the jar.
--out writes the jar there instead of openidea-jvm-inspect.jar next to this file."""
import os
import pathlib
import subprocess
import sys
import tempfile
import zipfile
RECORDER = 'ai/openidea/jvminspect/OiRecorder.bin'
def run(command):
code = subprocess.run(command).returncode
if code:
sys.exit(f'{command[-1]} failed with exit status {code}')
root = pathlib.Path(__file__).resolve().parent
args = sys.argv[1:]
jar_path = root / 'openidea-jvm-inspect.jar'
if '--out' in args:
i = args.index('--out')
jar_path = pathlib.Path(args[i + 1]).resolve()
del args[i:i + 2]
test = '--test' in args
plugins = pathlib.Path(next(a for a in args if a != '--test')).resolve() / 'plugins'
with tempfile.TemporaryDirectory() as tmp:
tmp = pathlib.Path(tmp)
# org.eclipse.jdt.debug ships the JDI model as a nested jar, which javac cannot read in place.
with zipfile.ZipFile(next(plugins.glob('org.eclipse.jdt.debug_*.jar'))) as debug:
(tmp / 'jdimodel.jar').write_bytes(debug.read('jdimodel.jar'))
classpath = [str(p) for p in sorted(plugins.glob('*.jar'))] + [str(tmp / 'jdimodel.jar')]
out = tmp / 'classes'
sources = sorted((root / 'src').rglob('*.java')) + ([root / 'tests' / 'SelfTest.java'] if test else [])
run(['java', '-cp', str(plugins / '*'),
'org.eclipse.jdt.internal.compiler.batch.Main', '-21', '-proc:none',
'-classpath', os.pathsep.join(classpath),
'-d', str(out), *[str(p) for p in sources]])
# The recorder is defined in the debuggee, which may run Java 8: a resource, not a class of this bundle.
recorder = tmp / 'recorder'
run(['javac', '--release', '8', '-g:none', '-Xlint:-options', '-d', str(recorder), str(root / 'recorder' / 'OiRecorder.java')])
(out / RECORDER).write_bytes((recorder / 'OiRecorder.class').read_bytes())
if test:
run(['java', '-cp', os.pathsep.join([str(out), *classpath]), 'ai.openidea.jvminspect.SelfTest'])
sys.exit(0)
with zipfile.ZipFile(jar_path, 'w', zipfile.ZIP_DEFLATED) as jar:
files = {'META-INF/MANIFEST.MF': root / 'MANIFEST.MF', 'plugin.xml': root / 'plugin.xml', RECORDER: out / RECORDER}
files.update({p.relative_to(out).as_posix(): p for p in out.rglob('*.class')})
for name, path in sorted(files.items()):
jar.writestr(zipfile.ZipInfo(name, (2026, 1, 1, 0, 0, 0)), path.read_bytes())