Mercurial > hg > truffle

comparison truffle/com.oracle.truffle.tools.debug.shell/src/com/oracle/truffle/tools/debug/shell/client/REPLClientContext.java @ 21951:9c8c0937da41

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Moving all sources into truffle subdirectory
author Jaroslav Tulach <jaroslav.tulach@oracle.com>
date Wed, 17 Jun 2015 10:58:08 +0200
parents graal/com.oracle.truffle.tools.debug.shell/src/com/oracle/truffle/tools/debug/shell/client/REPLClientContext.java@3b8bbf51d320
children dc83cc1f94f2
comparison
equal deleted inserted replaced
21950:2a5011c7e641 21951:9c8c0937da41
1 /*
2 * Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved.
3 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
4 *
5 * This code is free software; you can redistribute it and/or modify it
6 * under the terms of the GNU General Public License version 2 only, as
7 * published by the Free Software Foundation. Oracle designates this
8 * particular file as subject to the "Classpath" exception as provided
9 * by Oracle in the LICENSE file that accompanied this code.
10 *
11 * This code is distributed in the hope that it will be useful, but WITHOUT
12 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 * version 2 for more details (a copy is included in the LICENSE file that
15 * accompanied this code).
16 *
17 * You should have received a copy of the GNU General Public License version
18 * 2 along with this work; if not, write to the Free Software Foundation,
19 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
20 *
21 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
22 * or visit www.oracle.com if you need additional information or have any
23 * questions.
24 */
25 package com.oracle.truffle.tools.debug.shell.client;
26
27 import java.util.*;
28
29 import com.oracle.truffle.api.source.*;
30 import com.oracle.truffle.tools.debug.shell.*;
31
32 /**
33 * Client context for interaction with a program halted by the {@link REPLServer}.
34 */
35 public interface REPLClientContext {
36
37 /**
38 * The source code halted in this context.
39 */
40 Source source();
41
42 /**
43 * The 1-based line at which execution is halted in this context; 0 means unknown.
44 */
45 int lineNumber();
46
47 /**
48 * The Truffle stack where execution is halted in this context.
49 */
50 List<REPLFrame> frames();
51
52 /**
53 * The nesting level of the execution context: 0 means evaluating shell commands outside any
54 * executing program.
55 */
56 int level();
57
58 /**
59 * The source currently selected by the user; defaults to where halted.
60 */
61 Source getSelectedSource();
62
63 /**
64 * The frame number in this execution context currently selected by the user; defaults to 0.
65 */
66 int getSelectedFrameNumber();
67
68 /**
69 * Issue a command to the REPLServer that
70 * <ul>
71 * <li>can be specified by a single "op",</li>
72 * <li>produces information in the form of a single string, and</li>
73 * <li>has no effect on the execution state.</li>
74 * </ul>
75 */
76 String stringQuery(String op);
77
78 /**
79 * Sets a new "default" frame number for frame-related commands.
80 */
81 void selectFrameNumber(int frameNumber);
82
83 /**
84 * Sends an information message.
85 */
86 void displayInfo(String message);
87
88 void displayStack();
89
90 /**
91 * Send a message related to handling a command in this context.
92 */
93 void displayReply(String message);
94
95 /**
96 * Send a message related to failure while handling a command in this context.
97 */
98 void displayFailReply(String message);
99
100 }