mirror of
https://github.com/Mercury-Language/mercury.git
synced 2026-04-19 19:33:46 +00:00
eeb69f14ba
browser/browse.m:
browser/browser_info.m:
browser/collect_lib.m:
browser/declarative_debugger.m:
browser/declarative_oracle.m:
browser/declarative_user.m:
browser/diff.m:
browser/help.m:
browser/interactive_query.m:
browser/parse.m:
browser/util.m:
Replace implicit streams with explicit streams.
Shorten lines longer than 79 chars.
In some places, simplify some code, often using constructs such as
string.format that either did not exist or were too expensive to use
when the original code was written.
In some places, change predicate names that were not meaningful
without module qualification by *including* the module qualification
in the name (e.g. init -> browser_info_init).
In some places, add XXXs.
In browser_info.m, make the output stream *part* of the debugger type,
because without this, having the debugger type belong to the stream
typeclass does NOT make sense. (The typeclass instance for debugger
used to always write to the current output stream, which this diff
is replacing with the use of explicitly specified streams.)
In browse.m, consistently put stream arguments before other arguments.
In browse.m, when exporting Mercury predicates to C, export them
under names with the standard ML_BROWSE_ prefix, NOT under the name
of a *different* predicate with that prefix.
In diff.m, eliminate an unnecessary difference between what we print
when the difference between two terms is at the root, vs what we print
when the difference between two terms is lower down.
In interactive_query.m, when trying to write a program out to a file,
do NOT write the program to the current output stream if we cannot open
the file, since that would accomplish nothing useful.
Also in interactive_query.m, cleanup .dylib instead of .so on MacOS.
In util.m, delete some unused predicates.
In collect_lib.m, document why some code is not worth updating.
In declarative_oracle.m, rename predicates with previously-ambiguous
names.
browser/MDBFLAGS.in:
Specify --warn-implicit-stream-calls for all Mercury modules
in the browser directory from now.
trace/mercury_trace_browse.c:
trace/mercury_trace_cmd_browsing.c:
ssdb/ssdb.m:
Conform to the changes in browser/*.m.
tests/debugger/queens.{exp,exp2}:
Expect the extra output from browser/diff.m.
1321 lines
47 KiB
Mathematica
1321 lines
47 KiB
Mathematica
%---------------------------------------------------------------------------%
|
|
% vim: ft=mercury ts=4 sw=4 et
|
|
%---------------------------------------------------------------------------%
|
|
% Copyright (C) 1999-2007, 2009, 2011 The University of Melbourne.
|
|
% Copyright (C) 2014-2018 The Mercury team.
|
|
% This file is distributed under the terms specified in COPYING.LIB.
|
|
%---------------------------------------------------------------------------%
|
|
%
|
|
% File: declarative_user.m.
|
|
% Author: Mark Brown.
|
|
%
|
|
% This module performs all the user interaction of the front end of the
|
|
% declarative debugger. It is responsible for displaying questions and bugs
|
|
% in a human-readable format, and for getting responses to debugger queries
|
|
% from the user.
|
|
%
|
|
%---------------------------------------------------------------------------%
|
|
%---------------------------------------------------------------------------%
|
|
|
|
:- module mdb.declarative_user.
|
|
:- interface.
|
|
|
|
:- import_module mdb.browser_info.
|
|
:- import_module mdb.declarative_debugger.
|
|
:- import_module mdb.help.
|
|
|
|
:- import_module io.
|
|
|
|
%---------------------------------------------------------------------------%
|
|
|
|
:- type user_question(T)
|
|
---> plain_question(decl_question(T))
|
|
; question_with_default(decl_question(T), decl_truth).
|
|
|
|
:- type user_response(T)
|
|
---> user_response_answer(decl_question(T), decl_answer(T))
|
|
; user_response_trust_predicate(decl_question(T))
|
|
; user_response_trust_module(decl_question(T))
|
|
|
|
; user_response_show_info(io.output_stream)
|
|
% Request that the analyser display some information about the
|
|
% state of the search and the current question to the given output
|
|
% stream.
|
|
|
|
; user_response_change_search(user_search_mode)
|
|
% Request that a new search strategy be used.
|
|
|
|
; user_response_undo
|
|
% The user wants to undo the last answer they gave.
|
|
|
|
; user_response_exit_diagnosis(T)
|
|
; user_response_abort_diagnosis.
|
|
|
|
:- type user_search_mode
|
|
---> user_top_down
|
|
; user_divide_and_query
|
|
; user_suspicion_divide_and_query
|
|
; user_binary.
|
|
|
|
:- type user_state.
|
|
|
|
:- pred user_state_init(io.input_stream::in, io.output_stream::in,
|
|
browser_info.browser_persistent_state::in, help_system::in,
|
|
user_state::out) is det.
|
|
|
|
% This predicate handles the interactive part of the declarative
|
|
% debugging process. The user is presented with a question,
|
|
% possibly with a default answer, and is asked to respond about the
|
|
% truth of it in the intended interpretation.
|
|
%
|
|
:- pred query_user(user_question(T)::in, user_response(T)::out,
|
|
user_state::in, user_state::out, io::di, io::uo) is cc_multi.
|
|
|
|
% Confirm that the node found is indeed an e_bug or an i_bug.
|
|
%
|
|
:- pred user_confirm_bug(decl_bug::in, decl_confirmation::out,
|
|
user_state::in, user_state::out, io::di, io::uo) is cc_multi.
|
|
|
|
% Returns the state of the term browser.
|
|
%
|
|
:- func get_browser_state(user_state) = browser_info.browser_persistent_state.
|
|
|
|
% Sets the state of the term browser.
|
|
%
|
|
:- pred set_browser_state(browser_info.browser_persistent_state::in,
|
|
user_state::in, user_state::out) is det.
|
|
|
|
% Return the output stream used for interacting with the user.
|
|
%
|
|
:- func get_user_output_stream(user_state) = io.output_stream.
|
|
|
|
% Return the input stream used for interacting with the user.
|
|
%
|
|
:- func get_user_input_stream(user_state) = io.input_stream.
|
|
|
|
:- type are_we_testing
|
|
---> we_are_not_testing
|
|
; we_are_testing.
|
|
|
|
% Set the testing flag of the user_state.
|
|
%
|
|
:- pred set_user_testing_flag(are_we_testing::in,
|
|
user_state::in, user_state::out) is det.
|
|
|
|
%---------------------------------------------------------------------------%
|
|
%---------------------------------------------------------------------------%
|
|
|
|
:- implementation.
|
|
|
|
:- import_module mdb.browse.
|
|
:- import_module mdb.browser_term.
|
|
:- import_module mdb.declarative_execution.
|
|
:- import_module mdb.declarative_tree.
|
|
:- import_module mdb.io_action.
|
|
:- import_module mdb.parse.
|
|
:- import_module mdb.term_rep.
|
|
:- import_module mdb.util.
|
|
:- import_module mdbcomp.
|
|
:- import_module mdbcomp.prim_data.
|
|
:- import_module mdbcomp.program_representation.
|
|
:- import_module mdbcomp.rtti_access.
|
|
:- import_module mdbcomp.sym_name.
|
|
|
|
:- import_module bool.
|
|
:- import_module char.
|
|
:- import_module deconstruct.
|
|
:- import_module exception.
|
|
:- import_module getopt.
|
|
:- import_module int.
|
|
:- import_module list.
|
|
:- import_module map.
|
|
:- import_module maybe.
|
|
:- import_module string.
|
|
:- import_module univ.
|
|
|
|
%---------------------------------------------------------------------------%
|
|
|
|
:- type user_command
|
|
---> user_cmd_yes
|
|
% The node is correct.
|
|
|
|
; user_cmd_no
|
|
% The node is erroneous.
|
|
|
|
; user_cmd_inadmissible
|
|
% The node is inadmissible.
|
|
|
|
; user_cmd_skip
|
|
% The user has no answer.
|
|
|
|
; user_cmd_browse_arg(maybe(int))
|
|
% Browse the nth argument before answering. Or browse
|
|
% the whole predicate/function if the maybe is no.
|
|
|
|
; user_cmd_browse_io(int)
|
|
% Browse the nth IO action before answering.
|
|
|
|
; user_cmd_print_arg(int, int)
|
|
% Print the nth to the mth arguments before answering.
|
|
|
|
; user_cmd_print_io(int, int)
|
|
% Print the nth to the mth IO actions before answering.
|
|
|
|
; user_cmd_pd
|
|
% Commence procedural debugging from this point.
|
|
|
|
; user_cmd_param_command(param_cmd)
|
|
|
|
; user_cmd_trust_predicate
|
|
% Trust the predicate being asked about.
|
|
|
|
; user_cmd_trust_module
|
|
% Trust the module being asked about.
|
|
|
|
; user_cmd_info
|
|
% Print some information about the current question.
|
|
|
|
; user_cmd_undo
|
|
% Undo the user's last answer.
|
|
|
|
; user_cmd_ask
|
|
% The user wants the current question re-asked.
|
|
|
|
; user_cmd_change_search(user_search_mode)
|
|
% Change the current search strategy.
|
|
|
|
; user_cmd_quit
|
|
% Abort this diagnosis session.
|
|
|
|
; user_cmd_help(maybe(string))
|
|
% Request help before answering. If the maybe argument is `no',
|
|
% then we display a general help message is displayed, otherwise
|
|
% we display help on the given command.
|
|
|
|
; user_cmd_empty
|
|
% User just pressed return.
|
|
|
|
; user_cmd_illegal.
|
|
% None of the above.
|
|
|
|
:- type maybe_display_question
|
|
---> do_not_display_question
|
|
; display_question.
|
|
|
|
:- type user_state
|
|
---> user_state(
|
|
instream :: io.input_stream,
|
|
outstream :: io.output_stream,
|
|
browser :: browser_persistent_state,
|
|
|
|
% Control whether the question should be displayed
|
|
% when querying the user. This is used to suppress
|
|
% the displaying of the question after the user issues
|
|
% a command which does not answer the question (such as
|
|
% an `info' command).
|
|
display_question :: maybe_display_question,
|
|
|
|
% If this is set we_are_testing, then user responses
|
|
% will be simulated and will always be `no', except when
|
|
% confirming a bug in which case, the response will be `yes'.
|
|
testing :: are_we_testing,
|
|
|
|
help_system :: help_system
|
|
).
|
|
|
|
user_state_init(InStr, OutStr, Browser, HelpSystem, State) :-
|
|
State = user_state(InStr, OutStr, Browser, display_question,
|
|
we_are_not_testing, HelpSystem).
|
|
|
|
%---------------------------------------------------------------------------%
|
|
|
|
query_user(UserQuestion, Response, !User, !IO) :-
|
|
Question = get_decl_question(UserQuestion),
|
|
(
|
|
!.User ^ testing = we_are_testing,
|
|
Node = get_decl_question_node(Question),
|
|
Response = user_response_answer(Question,
|
|
truth_value(Node, truth_erroneous))
|
|
;
|
|
!.User ^ testing = we_are_not_testing,
|
|
(
|
|
!.User ^ display_question = display_question,
|
|
write_decl_question(Question, !.User, !IO),
|
|
user_question_prompt(UserQuestion, Prompt),
|
|
!User ^ display_question := do_not_display_question
|
|
;
|
|
!.User ^ display_question = do_not_display_question,
|
|
Prompt = "dd> "
|
|
),
|
|
get_command(Prompt, Command, !User, !IO),
|
|
handle_command(Command, UserQuestion, Response, !User, !IO),
|
|
( if Response \= user_response_show_info(_) then
|
|
!User ^ display_question := display_question
|
|
else
|
|
true
|
|
)
|
|
).
|
|
|
|
:- pred handle_command(user_command::in, user_question(T)::in,
|
|
user_response(T)::out, user_state::in, user_state::out,
|
|
io::di, io::uo) is cc_multi.
|
|
|
|
handle_command(Cmd, UserQuestion, Response, !User, !IO) :-
|
|
(
|
|
Cmd = user_cmd_yes,
|
|
Question = get_decl_question(UserQuestion),
|
|
Node = get_decl_question_node(Question),
|
|
Response = user_response_answer(Question,
|
|
truth_value(Node, truth_correct))
|
|
;
|
|
Cmd = user_cmd_no,
|
|
Question = get_decl_question(UserQuestion),
|
|
Node = get_decl_question_node(Question),
|
|
Response = user_response_answer(Question,
|
|
truth_value(Node, truth_erroneous))
|
|
;
|
|
Cmd = user_cmd_inadmissible,
|
|
Question = get_decl_question(UserQuestion),
|
|
Node = get_decl_question_node(Question),
|
|
Response = user_response_answer(Question,
|
|
truth_value(Node, truth_inadmissible))
|
|
;
|
|
Cmd = user_cmd_skip,
|
|
Question = get_decl_question(UserQuestion),
|
|
Node = get_decl_question_node(Question),
|
|
Response = user_response_answer(Question, skip(Node))
|
|
;
|
|
Cmd = user_cmd_browse_arg(MaybeArgNum),
|
|
Question = get_decl_question(UserQuestion),
|
|
edt_node_trace_atoms(Question, InitAtom, FinalAtom),
|
|
(
|
|
MaybeArgNum = yes(ArgNum),
|
|
browse_atom_argument(InitAtom, FinalAtom, ArgNum, MaybeTrack,
|
|
!User, !IO),
|
|
(
|
|
MaybeTrack = no_track,
|
|
query_user(UserQuestion, Response, !User, !IO)
|
|
;
|
|
MaybeTrack = track(HowTrack, ShouldAssertInvalid, TermPath),
|
|
ArgPos = arg_num_to_arg_pos(ArgNum),
|
|
Node = get_decl_question_node(Question),
|
|
Answer = suspicious_subterm(Node, ArgPos, TermPath, HowTrack,
|
|
ShouldAssertInvalid),
|
|
Response = user_response_answer(Question, Answer)
|
|
)
|
|
;
|
|
MaybeArgNum = no,
|
|
browse_atom(InitAtom, FinalAtom, MaybeTrack, !User, !IO),
|
|
(
|
|
MaybeTrack = no_track,
|
|
query_user(UserQuestion, Response, !User, !IO)
|
|
;
|
|
MaybeTrack = track(HowTrack, ShouldAssertInvalid,
|
|
[ArgNum | TermPath]),
|
|
ArgPos = arg_num_to_arg_pos(ArgNum),
|
|
Node = get_decl_question_node(Question),
|
|
Answer = suspicious_subterm(Node, ArgPos, TermPath,
|
|
HowTrack, ShouldAssertInvalid),
|
|
Response = user_response_answer(Question, Answer)
|
|
;
|
|
% Tracking the entire atom doesn't make sense.
|
|
MaybeTrack = track(_, _, []),
|
|
io.write_string(!.User ^ outstream,
|
|
"Cannot track the entire atom. " ++
|
|
"Please select a subterm to track.\n", !IO),
|
|
query_user(UserQuestion, Response, !User, !IO)
|
|
)
|
|
)
|
|
;
|
|
Cmd = user_cmd_print_arg(From, To),
|
|
Question = get_decl_question(UserQuestion),
|
|
edt_node_trace_atoms(Question, _, TraceAtom),
|
|
print_atom_arguments(TraceAtom, From, To, !.User, !IO),
|
|
query_user(UserQuestion, Response, !User, !IO)
|
|
;
|
|
Cmd = user_cmd_param_command(ParamCommand),
|
|
Browser0 = !.User ^ browser,
|
|
DummyTerm = synthetic_term("", [], no),
|
|
Info0 = browser_info(DummyTerm, [], print, no, Browser0, no_track, no),
|
|
run_param_command(debugger_internal(!.User ^ outstream), ParamCommand,
|
|
no, Info0, Info, !IO),
|
|
Info = browser_info(_, _, _, _, Browser, _, _),
|
|
!User ^ browser := Browser,
|
|
query_user(UserQuestion, Response, !User, !IO)
|
|
;
|
|
Cmd = user_cmd_trust_predicate,
|
|
Question = get_decl_question(UserQuestion),
|
|
Response = user_response_trust_predicate(Question)
|
|
;
|
|
Cmd = user_cmd_trust_module,
|
|
Question = get_decl_question(UserQuestion),
|
|
Response = user_response_trust_module(Question)
|
|
;
|
|
Cmd = user_cmd_info,
|
|
Response = user_response_show_info(!.User ^ outstream)
|
|
;
|
|
Cmd = user_cmd_undo,
|
|
Response = user_response_undo
|
|
;
|
|
Cmd = user_cmd_browse_io(ActionNum),
|
|
Question = get_decl_question(UserQuestion),
|
|
edt_node_io_actions(Question, MaybeIoActions),
|
|
% We don't have code yet to trace a marked I/O action.
|
|
browse_chosen_io_action(MaybeIoActions, ActionNum, _MaybeTrack,
|
|
!User, !IO),
|
|
query_user(UserQuestion, Response, !User, !IO)
|
|
;
|
|
Cmd = user_cmd_print_io(From, To),
|
|
Question = get_decl_question(UserQuestion),
|
|
edt_node_io_actions(Question, MaybeIoActions),
|
|
print_chosen_io_actions(MaybeIoActions, From, To, !.User, !IO),
|
|
query_user(UserQuestion, Response, !User, !IO)
|
|
;
|
|
Cmd = user_cmd_change_search(Mode),
|
|
Response = user_response_change_search(Mode)
|
|
;
|
|
Cmd = user_cmd_ask,
|
|
!User ^ display_question := display_question,
|
|
query_user(UserQuestion, Response, !User, !IO)
|
|
;
|
|
Cmd = user_cmd_pd,
|
|
Question = get_decl_question(UserQuestion),
|
|
Node = get_decl_question_node(Question),
|
|
Response = user_response_exit_diagnosis(Node)
|
|
;
|
|
Cmd = user_cmd_quit,
|
|
Response = user_response_abort_diagnosis
|
|
;
|
|
Cmd = user_cmd_help(MaybeCmd),
|
|
(
|
|
MaybeCmd = yes(CmdName),
|
|
Path = ["decl", CmdName]
|
|
;
|
|
MaybeCmd = no,
|
|
Path = ["concepts", "decl_debug"]
|
|
),
|
|
help.print_help_node_at_path(!.User ^ outstream, !.User ^ help_system,
|
|
Path, Res, !IO),
|
|
(
|
|
Res = help_ok
|
|
;
|
|
Res = help_error(Message),
|
|
io.format(!.User ^ outstream, "%s\n", [s(Message)], !IO)
|
|
),
|
|
query_user(UserQuestion, Response, !User, !IO)
|
|
;
|
|
Cmd = user_cmd_empty,
|
|
(
|
|
UserQuestion = plain_question(_),
|
|
Command = user_cmd_skip
|
|
;
|
|
UserQuestion = question_with_default(_, Truth),
|
|
(
|
|
Truth = truth_correct,
|
|
Command = user_cmd_yes
|
|
;
|
|
Truth = truth_erroneous,
|
|
Command = user_cmd_no
|
|
;
|
|
Truth = truth_inadmissible,
|
|
Command = user_cmd_inadmissible
|
|
)
|
|
),
|
|
handle_command(Command, UserQuestion, Response, !User, !IO)
|
|
;
|
|
Cmd = user_cmd_illegal,
|
|
io.write_string(!.User ^ outstream, "Unknown command, 'h' for help.\n",
|
|
!IO),
|
|
query_user(UserQuestion, Response, !User, !IO)
|
|
).
|
|
|
|
:- func arg_num_to_arg_pos(int) = arg_pos.
|
|
|
|
arg_num_to_arg_pos(ArgNum) = ArgPos :-
|
|
Which = chosen_head_vars_presentation,
|
|
(
|
|
Which = only_user_headvars,
|
|
ArgPos = user_head_var(ArgNum)
|
|
;
|
|
Which = all_headvars,
|
|
ArgPos = any_head_var(ArgNum)
|
|
).
|
|
|
|
:- func get_decl_question(user_question(T)) = decl_question(T).
|
|
|
|
get_decl_question(plain_question(Q)) = Q.
|
|
get_decl_question(question_with_default(Q, _)) = Q.
|
|
|
|
:- pred user_question_prompt(user_question(T)::in, string::out) is det.
|
|
|
|
user_question_prompt(UserQuestion, Prompt) :-
|
|
(
|
|
UserQuestion = plain_question(Question),
|
|
decl_question_prompt(Question, Prompt)
|
|
;
|
|
UserQuestion = question_with_default(Question, DefaultTruth),
|
|
decl_question_prompt(Question, QuestionPrompt),
|
|
default_prompt(DefaultTruth, DefaultPrompt),
|
|
Prompt = QuestionPrompt ++ DefaultPrompt
|
|
).
|
|
|
|
:- pred decl_question_prompt(decl_question(T)::in, string::out) is det.
|
|
|
|
decl_question_prompt(wrong_answer(_, _, _), "Valid? ").
|
|
decl_question_prompt(missing_answer(_, _, [_ | _]), "Complete? ").
|
|
decl_question_prompt(missing_answer(_, _, []), "Unsatisfiable? ").
|
|
decl_question_prompt(unexpected_exception(_, _, _), "Expected? ").
|
|
|
|
:- pred default_prompt(decl_truth::in, string::out) is det.
|
|
|
|
default_prompt(truth_correct, "[yes] ").
|
|
default_prompt(truth_erroneous, "[no] ").
|
|
default_prompt(truth_inadmissible, "[inadmissible] ").
|
|
|
|
% Find the initial and final atoms for a question. For all questions
|
|
% besides wrong answer questions, the initial and final atoms
|
|
% will be the same.
|
|
%
|
|
:- pred edt_node_trace_atoms(decl_question(T)::in, trace_atom::out,
|
|
trace_atom::out) is det.
|
|
|
|
edt_node_trace_atoms(wrong_answer(_, InitDeclAtom, FinalDeclAtom),
|
|
InitDeclAtom ^ init_atom, FinalDeclAtom ^ final_atom).
|
|
edt_node_trace_atoms(missing_answer(_, InitDeclAtom, _),
|
|
InitDeclAtom ^ init_atom, InitDeclAtom ^ init_atom).
|
|
edt_node_trace_atoms(unexpected_exception(_, InitDeclAtom, _),
|
|
InitDeclAtom ^ init_atom, InitDeclAtom ^ init_atom).
|
|
|
|
:- pred edt_node_io_actions(decl_question(T)::in, maybe(io_action_range)::out)
|
|
is det.
|
|
|
|
edt_node_io_actions(wrong_answer(_, _, FinalDeclAtom),
|
|
FinalDeclAtom ^ final_io_actions).
|
|
edt_node_io_actions(missing_answer(_, _, _), no).
|
|
edt_node_io_actions(unexpected_exception(_, _, _), no).
|
|
|
|
:- pred decl_bug_trace_atom(decl_bug::in, trace_atom::out, trace_atom::out)
|
|
is det.
|
|
|
|
decl_bug_trace_atom(e_bug(incorrect_contour(InitDeclAtom, FinalDeclAtom, _,
|
|
_)), InitDeclAtom ^ init_atom, FinalDeclAtom ^ final_atom).
|
|
decl_bug_trace_atom(e_bug(partially_uncovered_atom(InitDeclAtom, _)),
|
|
InitDeclAtom ^ init_atom, InitDeclAtom ^ init_atom).
|
|
decl_bug_trace_atom(e_bug(unhandled_exception(InitDeclAtom, _, _)),
|
|
InitDeclAtom ^ init_atom, InitDeclAtom ^ init_atom).
|
|
decl_bug_trace_atom(i_bug(inadmissible_call(_, _, InitDeclAtom, _)),
|
|
InitDeclAtom ^ init_atom, InitDeclAtom ^ init_atom).
|
|
|
|
:- pred decl_bug_io_actions(decl_bug::in, maybe(io_action_range)::out) is det.
|
|
|
|
decl_bug_io_actions(e_bug(incorrect_contour(_, FinalDeclAtom, _, _)),
|
|
FinalDeclAtom ^ final_io_actions).
|
|
decl_bug_io_actions(e_bug(partially_uncovered_atom(_, _)), no).
|
|
decl_bug_io_actions(e_bug(unhandled_exception(_, _, _)), no).
|
|
decl_bug_io_actions(i_bug(inadmissible_call(_, _, _, _)), no).
|
|
|
|
:- pred browse_chosen_io_action(maybe(io_action_range)::in, int::in,
|
|
maybe_track_subterm(term_path)::out, user_state::in, user_state::out,
|
|
io::di, io::uo) is cc_multi.
|
|
|
|
browse_chosen_io_action(MaybeIoActions, ActionNum, MaybeTrack, !User, !IO) :-
|
|
(
|
|
MaybeIoActions = yes(IoActions),
|
|
find_tabled_io_action(IoActions, ActionNum, MaybeIoAction, !IO),
|
|
(
|
|
MaybeIoAction = yes(IoAction),
|
|
browse_io_action(IoAction, MaybeTrack, !User, !IO)
|
|
;
|
|
MaybeIoAction = no,
|
|
MaybeTrack = no_track
|
|
)
|
|
;
|
|
MaybeIoActions = no,
|
|
io.write_string(!.User ^ outstream, "No such IO action.\n", !IO),
|
|
MaybeTrack = no_track
|
|
).
|
|
|
|
:- pred find_tabled_io_action(io_action_range::in, int::in,
|
|
maybe(io_action)::out, io::di, io::uo) is det.
|
|
|
|
find_tabled_io_action(io_action_range(Cur, End), TabledActionNum,
|
|
MaybeIoAction, !IO) :-
|
|
( if Cur = End then
|
|
MaybeIoAction = no
|
|
else
|
|
get_maybe_io_action(Cur, MaybeTabledIoAction, !IO),
|
|
(
|
|
MaybeTabledIoAction = tabled(IoAction),
|
|
( if TabledActionNum = 1 then
|
|
MaybeIoAction = yes(IoAction)
|
|
else
|
|
find_tabled_io_action(io_action_range(Cur + 1, End),
|
|
TabledActionNum - 1, MaybeIoAction, !IO)
|
|
)
|
|
;
|
|
MaybeTabledIoAction = untabled,
|
|
find_tabled_io_action(io_action_range(Cur + 1, End),
|
|
TabledActionNum, MaybeIoAction, !IO)
|
|
)
|
|
).
|
|
|
|
:- pred print_chosen_io_actions(maybe(io_action_range)::in, int::in, int::in,
|
|
user_state::in, io::di, io::uo) is cc_multi.
|
|
|
|
print_chosen_io_actions(MaybeIoActions, From, To, User0, !IO) :-
|
|
print_chosen_io_action(MaybeIoActions, From, User0, OK, !IO),
|
|
( if
|
|
OK = yes,
|
|
From + 1 =< To
|
|
then
|
|
print_chosen_io_actions(MaybeIoActions, From + 1, To, User0, !IO)
|
|
else
|
|
true
|
|
).
|
|
|
|
:- pred print_chosen_io_action(maybe(io_action_range)::in, int::in,
|
|
user_state::in, bool::out, io::di, io::uo) is cc_multi.
|
|
|
|
print_chosen_io_action(MaybeIoActions, ActionNum, User0, OK, !IO) :-
|
|
(
|
|
MaybeIoActions = yes(IoActions),
|
|
find_tabled_io_action(IoActions, ActionNum, MaybeIoAction, !IO),
|
|
(
|
|
MaybeIoAction = yes(IoAction),
|
|
print_tabled_io_action(User0, tabled(IoAction), !IO),
|
|
OK = yes
|
|
;
|
|
MaybeIoAction = no,
|
|
io.write_string(User0 ^ outstream, "No such IO action.\n", !IO),
|
|
OK = no
|
|
)
|
|
;
|
|
MaybeIoActions = no,
|
|
io.write_string(User0 ^ outstream, "No such IO action.\n", !IO),
|
|
OK = no
|
|
).
|
|
|
|
:- pred browse_io_action(io_action::in, maybe_track_subterm(term_path)::out,
|
|
user_state::in, user_state::out, io::di, io::uo) is cc_multi.
|
|
|
|
browse_io_action(IoAction, no_track, !User, !IO) :-
|
|
Term = io_action_to_browser_term(IoAction),
|
|
browse_browser_term(!.User ^ instream, !.User ^ outstream, no,
|
|
Term, MaybeTrackDirs, !.User ^ browser, Browser, !IO),
|
|
(
|
|
MaybeTrackDirs = track(_, _, _),
|
|
io.write_string(!.User ^ outstream,
|
|
"Sorry, tracking of I/O actions is not yet supported.\n", !IO),
|
|
browse_io_action(IoAction, _, !User, !IO)
|
|
;
|
|
MaybeTrackDirs = no_track
|
|
),
|
|
!User ^ browser := Browser.
|
|
|
|
:- pred browse_decl_bug(decl_bug::in, maybe(int)::in, user_state::in,
|
|
user_state::out, io::di, io::uo) is cc_multi.
|
|
|
|
browse_decl_bug(Bug, MaybeArgNum, !User, !IO) :-
|
|
decl_bug_trace_atom(Bug, InitAtom, FinalAtom),
|
|
(
|
|
MaybeArgNum = yes(ArgNum),
|
|
browse_atom_argument(InitAtom, FinalAtom, ArgNum, _, !User, !IO)
|
|
;
|
|
MaybeArgNum = no,
|
|
browse_atom(InitAtom, FinalAtom, _, !User, !IO)
|
|
).
|
|
|
|
:- pred browse_atom_argument(trace_atom::in, trace_atom::in, int::in,
|
|
maybe_track_subterm(term_path)::out, user_state::in, user_state::out,
|
|
io::di, io::uo) is cc_multi.
|
|
|
|
browse_atom_argument(InitAtom, FinalAtom, ArgNum, MaybeTrack, !User, !IO) :-
|
|
FinalAtom = atom(_, Args0),
|
|
maybe_filter_headvars(chosen_head_vars_presentation, Args0, Args),
|
|
( if
|
|
list.index1(Args, ArgNum, ArgInfo),
|
|
ArgInfo = arg_info(_, _, MaybeArg),
|
|
MaybeArg = yes(ArgRep),
|
|
term_rep.rep_to_univ(ArgRep, Arg)
|
|
then
|
|
SubTermMode = get_subterm_mode_from_atoms_for_arg(ArgNum,
|
|
InitAtom, FinalAtom),
|
|
browse_browser_term(!.User ^ instream, !.User ^ outstream,
|
|
yes(SubTermMode), univ_to_browser_term(Arg), MaybeTrackDirs,
|
|
!.User ^ browser, Browser, !IO),
|
|
convert_maybe_track_dirs_to_term_path_from_arg(ArgRep,
|
|
MaybeTrackDirs, MaybeTrack),
|
|
!User ^ browser := Browser
|
|
else
|
|
io.write_string(!.User ^ outstream, "Invalid argument number\n", !IO),
|
|
MaybeTrack = no_track
|
|
).
|
|
|
|
:- pred browse_atom(trace_atom::in, trace_atom::in,
|
|
maybe_track_subterm(term_path)::out,
|
|
user_state::in, user_state::out, io::di, io::uo) is cc_multi.
|
|
|
|
browse_atom(InitAtom, FinalAtom, MaybeTrack, !User, !IO) :-
|
|
FinalAtom = atom(ProcLayout, Args),
|
|
ProcLabel = get_proc_label_from_layout(ProcLayout),
|
|
get_user_arg_values(Args, ArgValues),
|
|
get_pred_attributes(ProcLabel, Module, Name, _, PredOrFunc),
|
|
IsFunction = pred_to_bool(unify(PredOrFunc, pf_function)),
|
|
ModuleStr = sym_name_to_string(Module),
|
|
BrowserTerm = synthetic_term_to_browser_term(ModuleStr ++ "." ++ Name,
|
|
ArgValues, IsFunction),
|
|
browse_browser_term(!.User ^ instream, !.User ^ outstream,
|
|
yes(get_subterm_mode_from_atoms(InitAtom, FinalAtom)),
|
|
BrowserTerm, MaybeTrackDirs, !.User ^ browser, Browser, !IO),
|
|
convert_maybe_track_dirs_to_term_path_from_atom(FinalAtom,
|
|
MaybeTrackDirs, MaybeTrack),
|
|
!User ^ browser := Browser.
|
|
|
|
:- func get_subterm_mode_from_atoms(trace_atom::in, trace_atom::in,
|
|
list(down_dir)::in) = (browser_term_mode::out) is det.
|
|
|
|
get_subterm_mode_from_atoms(InitAtom, FinalAtom, Dirs) = Mode :-
|
|
convert_dirs_to_term_path_from_atom(FinalAtom, Dirs, Path),
|
|
(
|
|
Path = [ArgNum | TermPath],
|
|
ArgPos = arg_num_to_arg_pos(ArgNum),
|
|
Mode = get_subterm_mode_from_atoms_and_term_path(InitAtom,
|
|
FinalAtom, ArgPos, TermPath)
|
|
;
|
|
Path = [],
|
|
Mode = btm_not_applicable
|
|
).
|
|
|
|
:- func get_subterm_mode_from_atoms_and_term_path(trace_atom, trace_atom,
|
|
arg_pos, term_path) = browser_term_mode.
|
|
|
|
get_subterm_mode_from_atoms_and_term_path(InitAtom, FinalAtom, ArgPos,
|
|
TermPath) = Mode :-
|
|
( if trace_atom_subterm_is_ground(InitAtom, ArgPos, TermPath) then
|
|
Mode = btm_input
|
|
else if trace_atom_subterm_is_ground(FinalAtom, ArgPos, TermPath) then
|
|
Mode = btm_output
|
|
else
|
|
Mode = btm_unbound
|
|
).
|
|
|
|
:- func get_subterm_mode_from_atoms_for_arg(int::in, trace_atom::in,
|
|
trace_atom::in, list(down_dir)::in) = (browser_term_mode::out) is det.
|
|
|
|
get_subterm_mode_from_atoms_for_arg(ArgNum, InitAtom, FinalAtom, Dirs)
|
|
= Mode :-
|
|
convert_dirs_to_term_path_from_atom(FinalAtom, Dirs, TermPath),
|
|
ArgPos = arg_num_to_arg_pos(ArgNum),
|
|
Mode = get_subterm_mode_from_atoms_and_term_path(InitAtom, FinalAtom,
|
|
ArgPos, TermPath).
|
|
|
|
:- pred get_user_arg_values(list(trace_atom_arg)::in, list(univ)::out) is det.
|
|
|
|
get_user_arg_values([], []).
|
|
get_user_arg_values([arg_info(UserVisible, _, MaybeValue) | Args], Values) :-
|
|
get_user_arg_values(Args, Values0),
|
|
(
|
|
UserVisible = yes,
|
|
(
|
|
MaybeValue = yes(ValueRep),
|
|
term_rep.rep_to_univ(ValueRep, Value)
|
|
;
|
|
MaybeValue = no,
|
|
Value = univ('_'`with_type`unbound)
|
|
),
|
|
Values = [Value | Values0]
|
|
;
|
|
UserVisible = no,
|
|
Values = Values0
|
|
).
|
|
|
|
:- pred print_atom_arguments(trace_atom::in, int::in, int::in, user_state::in,
|
|
io::di, io::uo) is cc_multi.
|
|
|
|
print_atom_arguments(Atom, From, To, User, !IO) :-
|
|
print_atom_argument(Atom, From, User, OK, !IO),
|
|
( if
|
|
OK = yes,
|
|
From + 1 =< To
|
|
then
|
|
print_atom_arguments(Atom, From + 1, To, User, !IO)
|
|
else
|
|
true
|
|
).
|
|
|
|
:- pred print_atom_argument(trace_atom::in, int::in, user_state::in, bool::out,
|
|
io::di, io::uo) is cc_multi.
|
|
|
|
print_atom_argument(Atom, ArgNum, User, OK, !IO) :-
|
|
Atom = atom(_, Args0),
|
|
maybe_filter_headvars(chosen_head_vars_presentation, Args0, Args),
|
|
( if
|
|
list.index1(Args, ArgNum, ArgInfo),
|
|
ArgInfo = arg_info(_, _, MaybeArg),
|
|
MaybeArg = yes(ArgRep),
|
|
term_rep.rep_to_univ(ArgRep, Arg)
|
|
then
|
|
print_browser_term(User ^ outstream, decl_caller_type,
|
|
univ_to_browser_term(Arg), User ^ browser, !IO),
|
|
OK = yes
|
|
else
|
|
io.write_string(User ^ outstream, "Invalid argument number\n", !IO),
|
|
OK = no
|
|
).
|
|
|
|
:- pred convert_maybe_track_dirs_to_term_path_from_atom(trace_atom::in,
|
|
maybe_track_subterm(list(down_dir))::in,
|
|
maybe_track_subterm(term_path)::out) is det.
|
|
|
|
convert_maybe_track_dirs_to_term_path_from_atom(_, no_track, no_track).
|
|
convert_maybe_track_dirs_to_term_path_from_atom(Atom, TrackDirs, TrackPath) :-
|
|
TrackDirs = track(HowTrack, ShouldAssertInvalid, Dirs),
|
|
convert_dirs_to_term_path_from_atom(Atom, Dirs, TermPath),
|
|
TrackPath = track(HowTrack, ShouldAssertInvalid, TermPath).
|
|
|
|
:- pred convert_maybe_track_dirs_to_term_path_from_arg(term_rep::in,
|
|
maybe_track_subterm(list(down_dir))::in,
|
|
maybe_track_subterm(term_path)::out) is det.
|
|
|
|
convert_maybe_track_dirs_to_term_path_from_arg(_, no_track, no_track).
|
|
convert_maybe_track_dirs_to_term_path_from_arg(Term, TrackDirs, TrackPath) :-
|
|
TrackDirs = track(HowTrack, ShouldAssertInvalid, Dirs),
|
|
convert_dirs_to_term_path(Term, Dirs, TermPath),
|
|
TrackPath = track(HowTrack, ShouldAssertInvalid, TermPath).
|
|
|
|
%---------------------------------------------------------------------------%
|
|
|
|
:- pred user_confirm_bug_help(user_state::in, io::di, io::uo) is det.
|
|
|
|
user_confirm_bug_help(User, !IO) :-
|
|
io.write_strings(User ^ outstream, [
|
|
"Answer one of:\n",
|
|
"\ty\tyes\t\tconfirm that the suspect is a bug\n",
|
|
"\tn\tno\t\tdo not accept that the suspect is a bug\n",
|
|
"\tb\tbrowse\t\tbrowse the suspect\n",
|
|
"\tq\tquit\t\t",
|
|
"abort this diagnosis session and return to mdb\n",
|
|
"\th, ?\thelp\t\tthis help message\n"
|
|
], !IO).
|
|
|
|
:- pred get_command(string::in, user_command::out,
|
|
user_state::in, user_state::out, io::di, io::uo) is det.
|
|
|
|
get_command(Prompt, Command, User, User, !IO) :-
|
|
util.trace_getline(User ^ instream, User ^ outstream, Prompt, Result, !IO),
|
|
(
|
|
Result = ok(String),
|
|
Words = string.words_separator(char.is_whitespace, String),
|
|
(
|
|
Words = [CmdWord | CmdArgs],
|
|
( if
|
|
cmd_handler(CmdWord, CmdHandler),
|
|
CmdHandler(CmdArgs, CommandPrime)
|
|
then
|
|
Command = CommandPrime
|
|
else
|
|
Command = user_cmd_illegal
|
|
)
|
|
;
|
|
Words = [],
|
|
Command = user_cmd_empty
|
|
)
|
|
;
|
|
Result = error(Error),
|
|
io.error_message(Error, Msg),
|
|
io.format(User ^ outstream, "%s\n", [s(Msg)], !IO),
|
|
Command = user_cmd_quit
|
|
;
|
|
Result = eof,
|
|
Command = user_cmd_quit
|
|
).
|
|
|
|
:- pred cmd_handler(string::in,
|
|
(pred(list(string), user_command)::out(pred(in, out) is semidet)))
|
|
is semidet.
|
|
|
|
cmd_handler("y", one_word_cmd(user_cmd_yes)).
|
|
cmd_handler("yes", one_word_cmd(user_cmd_yes)).
|
|
cmd_handler("n", one_word_cmd(user_cmd_no)).
|
|
cmd_handler("no", one_word_cmd(user_cmd_no)).
|
|
cmd_handler("i", one_word_cmd(user_cmd_inadmissible)).
|
|
cmd_handler("inadmissible", one_word_cmd(user_cmd_inadmissible)).
|
|
cmd_handler("s", one_word_cmd(user_cmd_skip)).
|
|
cmd_handler("skip", one_word_cmd(user_cmd_skip)).
|
|
cmd_handler("pd", one_word_cmd(user_cmd_pd)).
|
|
% `abort' is a synonym for `quit' and is just here for backwards compatibility.
|
|
cmd_handler("a", one_word_cmd(user_cmd_quit)).
|
|
cmd_handler("abort", one_word_cmd(user_cmd_quit)).
|
|
cmd_handler("q", one_word_cmd(user_cmd_quit)).
|
|
cmd_handler("quit", one_word_cmd(user_cmd_quit)).
|
|
cmd_handler("?", help_cmd).
|
|
cmd_handler("h", help_cmd).
|
|
cmd_handler("help", help_cmd).
|
|
cmd_handler("info", one_word_cmd(user_cmd_info)).
|
|
cmd_handler("b", browse_arg_cmd).
|
|
cmd_handler("browse", browse_arg_cmd).
|
|
cmd_handler("p", print_arg_cmd).
|
|
cmd_handler("print", print_arg_cmd).
|
|
cmd_handler("format", format_arg_cmd).
|
|
cmd_handler("depth", format_param_arg_cmd("depth")).
|
|
cmd_handler("size", format_param_arg_cmd("size")).
|
|
cmd_handler("width", format_param_arg_cmd("width")).
|
|
cmd_handler("lines", format_param_arg_cmd("lines")).
|
|
cmd_handler("actions", num_io_actions_cmd).
|
|
cmd_handler("t", trust_arg_cmd).
|
|
cmd_handler("trust", trust_arg_cmd).
|
|
cmd_handler("mode", search_mode_cmd).
|
|
cmd_handler("m", search_mode_cmd).
|
|
cmd_handler("undo", one_word_cmd(user_cmd_undo)).
|
|
cmd_handler("params", one_word_cmd(user_cmd_param_command(print_params))).
|
|
|
|
:- pred one_word_cmd(user_command::in, list(string)::in, user_command::out)
|
|
is semidet.
|
|
|
|
one_word_cmd(Cmd, [], Cmd).
|
|
|
|
:- pred browse_arg_cmd(list(string)::in, user_command::out) is semidet.
|
|
|
|
browse_arg_cmd([], user_cmd_browse_arg(no)).
|
|
browse_arg_cmd([Arg], BrowseCmd) :-
|
|
string.to_int(Arg, ArgNum),
|
|
BrowseCmd = user_cmd_browse_arg(yes(ArgNum)).
|
|
browse_arg_cmd(["io", Arg], user_cmd_browse_io(ArgNum)) :-
|
|
string.to_int(Arg, ArgNum).
|
|
|
|
:- pred print_arg_cmd(list(string)::in, user_command::out) is semidet.
|
|
|
|
print_arg_cmd([], user_cmd_ask).
|
|
print_arg_cmd([Arg], user_cmd_print_arg(From, To)) :-
|
|
string_to_range(Arg, From, To).
|
|
print_arg_cmd(["io", Arg], user_cmd_print_io(From, To)) :-
|
|
string_to_range(Arg, From, To).
|
|
|
|
:- pred format_arg_cmd(list(string)::in, user_command::out) is semidet.
|
|
|
|
format_arg_cmd(ArgWords, UserCommand) :-
|
|
ArgWords = [_ | _],
|
|
parse.parse(["format" | ArgWords], Command),
|
|
Command = cmd_param(FormatCmd),
|
|
FormatCmd = format(MaybeOptionTable, Setting),
|
|
UserCommand = user_cmd_param_command(format(MaybeOptionTable, Setting)).
|
|
|
|
:- pred format_param_arg_cmd(string::in, list(string)::in,
|
|
user_command::out) is semidet.
|
|
|
|
format_param_arg_cmd(Cmd, ArgWords0, Command) :-
|
|
( if ArgWords0 = ["io" | ArgWords1] then
|
|
ArgWords = ArgWords1,
|
|
HasIOArg = yes : bool
|
|
else
|
|
ArgWords = ArgWords0,
|
|
HasIOArg = no : bool
|
|
),
|
|
ArgWords = [_ | _],
|
|
parse.parse([Cmd | ArgWords], ParsedCommand),
|
|
ParsedCommand = cmd_param(FormatCmd),
|
|
FormatCmd = format_param(MaybeOptionTable0, Setting),
|
|
(
|
|
HasIOArg = yes,
|
|
% Since the command was invoked with the `io' argument we want to
|
|
% change the settings for the `print all' configuration parameter,
|
|
% rather than the ones for `print'.
|
|
some [!OptionTable] (
|
|
MaybeOptionTable0 = ok(!:OptionTable),
|
|
map.det_update(set_print, bool(no), !OptionTable),
|
|
map.det_update(set_print_all, bool(yes), !OptionTable),
|
|
MaybeOptionTable = ok(!.OptionTable)
|
|
)
|
|
;
|
|
HasIOArg = no,
|
|
MaybeOptionTable = MaybeOptionTable0
|
|
),
|
|
Command = user_cmd_param_command(format_param(MaybeOptionTable, Setting)).
|
|
|
|
:- pred num_io_actions_cmd(list(string)::in, user_command::out) is semidet.
|
|
|
|
num_io_actions_cmd([Arg], user_cmd_param_command(num_io_actions(N))) :-
|
|
string.to_int(Arg, N).
|
|
|
|
:- pred trust_arg_cmd(list(string)::in, user_command::out) is semidet.
|
|
|
|
trust_arg_cmd([], user_cmd_trust_predicate).
|
|
trust_arg_cmd(["module"], user_cmd_trust_module).
|
|
|
|
:- pred search_mode_cmd(list(string)::in, user_command::out) is semidet.
|
|
|
|
search_mode_cmd(["top-down"], user_cmd_change_search(user_top_down)).
|
|
search_mode_cmd(["top_down"], user_cmd_change_search(user_top_down)).
|
|
search_mode_cmd(["td"], user_cmd_change_search(user_top_down)).
|
|
search_mode_cmd(["divide-and-query"],
|
|
user_cmd_change_search(user_divide_and_query)).
|
|
search_mode_cmd(["divide_and_query"],
|
|
user_cmd_change_search(user_divide_and_query)).
|
|
search_mode_cmd(["dq"], user_cmd_change_search(user_divide_and_query)).
|
|
search_mode_cmd(["binary"], user_cmd_change_search(user_binary)).
|
|
search_mode_cmd(["b"], user_cmd_change_search(user_binary)).
|
|
search_mode_cmd(["suspicion-divide-and-query"],
|
|
user_cmd_change_search(user_suspicion_divide_and_query)).
|
|
search_mode_cmd(["suspicion_divide_and_query"],
|
|
user_cmd_change_search(user_suspicion_divide_and_query)).
|
|
search_mode_cmd(["sdq"],
|
|
user_cmd_change_search(user_suspicion_divide_and_query)).
|
|
|
|
:- pred help_cmd(list(string)::in, user_command::out) is semidet.
|
|
|
|
help_cmd([], user_cmd_help(no)).
|
|
help_cmd([Cmd], user_cmd_help(yes(Cmd))).
|
|
|
|
:- pred string_to_range(string::in, int::out, int::out) is semidet.
|
|
|
|
string_to_range(Arg, From, To) :-
|
|
( if string.to_int(Arg, Num) then
|
|
From = Num,
|
|
To = Num
|
|
else
|
|
[FirstStr, SecondStr] = string.words_separator(is_dash, Arg),
|
|
string.to_int(FirstStr, First),
|
|
string.to_int(SecondStr, Second),
|
|
( if First =< Second then
|
|
From = First,
|
|
To = Second
|
|
else
|
|
From = Second,
|
|
To = First
|
|
)
|
|
).
|
|
|
|
:- pred is_dash(char::in) is semidet.
|
|
|
|
is_dash('-').
|
|
|
|
%---------------------------------------------------------------------------%
|
|
|
|
user_confirm_bug(Bug, Response, !User, !IO) :-
|
|
(
|
|
!.User ^ testing = we_are_testing,
|
|
Response = confirm_bug
|
|
;
|
|
!.User ^ testing = we_are_not_testing,
|
|
write_decl_bug(Bug, !.User, !IO),
|
|
get_command("Is this a bug? ", Command, !User, !IO),
|
|
(
|
|
Command = user_cmd_yes,
|
|
Response = confirm_bug
|
|
;
|
|
Command = user_cmd_no,
|
|
Response = overrule_bug
|
|
;
|
|
Command = user_cmd_quit,
|
|
Response = abort_diagnosis
|
|
;
|
|
Command = user_cmd_browse_arg(MaybeArgNum),
|
|
browse_decl_bug(Bug, MaybeArgNum, !User, !IO),
|
|
user_confirm_bug(Bug, Response, !User, !IO)
|
|
;
|
|
Command = user_cmd_browse_io(ActionNum),
|
|
decl_bug_io_actions(Bug, MaybeIoActions),
|
|
browse_chosen_io_action(MaybeIoActions, ActionNum, _MaybeTrack,
|
|
!User, !IO),
|
|
user_confirm_bug(Bug, Response, !User, !IO)
|
|
;
|
|
( Command = user_cmd_ask
|
|
; Command = user_cmd_change_search(_)
|
|
; Command = user_cmd_empty
|
|
; Command = user_cmd_help(_)
|
|
; Command = user_cmd_illegal
|
|
; Command = user_cmd_inadmissible
|
|
; Command = user_cmd_info
|
|
; Command = user_cmd_param_command(_)
|
|
; Command = user_cmd_pd
|
|
; Command = user_cmd_print_arg(_, _)
|
|
; Command = user_cmd_print_io(_, _)
|
|
; Command = user_cmd_skip
|
|
; Command = user_cmd_trust_module
|
|
; Command = user_cmd_trust_predicate
|
|
; Command = user_cmd_undo
|
|
),
|
|
user_confirm_bug_help(!.User, !IO),
|
|
user_confirm_bug(Bug, Response, !User, !IO)
|
|
)
|
|
).
|
|
|
|
%---------------------------------------------------------------------------%
|
|
|
|
% Returns the caller type we want to use throughout the
|
|
% declarative debugger.
|
|
%
|
|
:- func decl_caller_type = browse_caller_type.
|
|
|
|
decl_caller_type = print.
|
|
|
|
% Display the node in user readable form on the current output stream.
|
|
%
|
|
:- pred write_decl_question(decl_question(T)::in, user_state::in,
|
|
io::di, io::uo) is cc_multi.
|
|
|
|
write_decl_question(Question, User, !IO) :-
|
|
(
|
|
Question = wrong_answer(_, _, Atom),
|
|
write_decl_final_atom(User, "", decl_caller_type, Atom, !IO)
|
|
;
|
|
Question = missing_answer(_, Call, Solns),
|
|
write_decl_init_atom(User, "Call ", decl_caller_type, Call, !IO),
|
|
(
|
|
Solns = []
|
|
;
|
|
Solns = [_ | _],
|
|
io.write_string(User ^ outstream, "Solutions:\n", !IO),
|
|
list.foldl(write_decl_final_atom(User, "\t", print_all), Solns,
|
|
!IO)
|
|
)
|
|
;
|
|
Question = unexpected_exception(_, Call, ExceptionRep),
|
|
write_decl_init_atom(User, "Call ", decl_caller_type, Call, !IO),
|
|
io.write_string(User ^ outstream, "Throws ", !IO),
|
|
term_rep.rep_to_univ(ExceptionRep, Exception),
|
|
io.write(User ^ outstream, include_details_cc, univ_value(Exception),
|
|
!IO),
|
|
io.nl(User ^ outstream, !IO)
|
|
).
|
|
|
|
:- pred write_decl_bug(decl_bug::in, user_state::in, io::di, io::uo)
|
|
is cc_multi.
|
|
|
|
write_decl_bug(e_bug(EBug), User, !IO) :-
|
|
(
|
|
EBug = incorrect_contour(_, Atom, Contour, _),
|
|
io.write_string(User ^ outstream, "Found incorrect contour:\n", !IO),
|
|
list.foldl(write_decl_final_atom(User, "", decl_caller_type),
|
|
Contour, !IO),
|
|
write_decl_final_atom(User, "", decl_caller_type, Atom, !IO)
|
|
;
|
|
EBug = partially_uncovered_atom(Atom, _),
|
|
io.write_string(User ^ outstream,
|
|
"Found partially uncovered atom:\n", !IO),
|
|
write_decl_init_atom(User, "", decl_caller_type, Atom, !IO)
|
|
;
|
|
EBug = unhandled_exception(Atom, ExceptionRep, _),
|
|
io.write_string(User ^ outstream,
|
|
"Found unhandled or incorrect exception:\n", !IO),
|
|
write_decl_init_atom(User, "", decl_caller_type, Atom, !IO),
|
|
term_rep.rep_to_univ(ExceptionRep, Exception),
|
|
io.write(User ^ outstream, include_details_cc,
|
|
univ_value(Exception), !IO),
|
|
io.nl(User ^ outstream, !IO)
|
|
).
|
|
|
|
write_decl_bug(i_bug(IBug), User, !IO) :-
|
|
IBug = inadmissible_call(Parent, _, Call, _),
|
|
io.write_string(User ^ outstream, "Found inadmissible call:\n", !IO),
|
|
write_decl_atom(User, "Parent ", decl_caller_type, init(Parent), !IO),
|
|
write_decl_atom(User, "Call ", decl_caller_type, init(Call), !IO).
|
|
|
|
:- pred write_decl_init_atom(user_state::in, string::in,
|
|
browse_caller_type::in, init_decl_atom::in,
|
|
io::di, io::uo) is cc_multi.
|
|
|
|
write_decl_init_atom(User, Indent, CallerType, InitAtom, !IO) :-
|
|
write_decl_atom(User, Indent, CallerType, init(InitAtom), !IO).
|
|
|
|
:- pred write_decl_final_atom(user_state::in, string::in,
|
|
browse_caller_type::in, final_decl_atom::in,
|
|
io::di, io::uo) is cc_multi.
|
|
|
|
write_decl_final_atom(User, Indent, CallerType, FinalAtom, !IO) :-
|
|
write_decl_atom(User, Indent, CallerType, final(FinalAtom), !IO).
|
|
|
|
:- pred write_decl_atom(user_state::in, string::in, browse_caller_type::in,
|
|
some_decl_atom::in, io::di, io::uo) is cc_multi.
|
|
|
|
write_decl_atom(User, Indent, CallerType, DeclAtom, !IO) :-
|
|
io.write_string(User ^ outstream, Indent, !IO),
|
|
unravel_decl_atom(DeclAtom, TraceAtom, MaybeIoActions),
|
|
TraceAtom = atom(ProcLayout, Args0),
|
|
ProcLabel = get_proc_label_from_layout(ProcLayout),
|
|
get_pred_attributes(ProcLabel, _, Functor, _, PredOrFunc),
|
|
Which = chosen_head_vars_presentation,
|
|
maybe_filter_headvars(Which, Args0, Args1),
|
|
list.map(trace_atom_arg_to_univ, Args1, Args),
|
|
% Call the term browser to print the atom (or part of it up to
|
|
% a size limit) as a goal.
|
|
BrowserTerm = synthetic_term_to_browser_term(Functor, Args,
|
|
is_function(PredOrFunc)),
|
|
browse.print_browser_term(User ^ outstream, CallerType, BrowserTerm,
|
|
User ^ browser, !IO),
|
|
write_maybe_tabled_io_actions(User, MaybeIoActions, !IO).
|
|
|
|
:- pred write_maybe_tabled_io_actions(user_state::in,
|
|
maybe(io_action_range)::in, io::di, io::uo) is cc_multi.
|
|
|
|
write_maybe_tabled_io_actions(User, MaybeIoActions, !IO) :-
|
|
(
|
|
MaybeIoActions = yes(IoActions),
|
|
count_tabled_io_actions(IoActions, NumTabled, NumUntabled, !IO),
|
|
write_io_actions(User, NumTabled, IoActions, !IO),
|
|
( if NumUntabled > 0 then
|
|
io.write_string(User ^ outstream, "Warning: some IO " ++
|
|
"actions for this atom are not tabled.\n", !IO)
|
|
else
|
|
true
|
|
)
|
|
;
|
|
MaybeIoActions = no
|
|
).
|
|
|
|
:- pred count_tabled_io_actions(io_action_range::in, int::out, int::out,
|
|
io::di, io::uo) is det.
|
|
|
|
count_tabled_io_actions(io_action_range(Start, End), NumTabled,
|
|
NumUntabled, !IO) :-
|
|
count_tabled_io_actions_2(Start, End, 0, NumTabled, 0,
|
|
NumUntabled, !IO).
|
|
|
|
:- pred count_tabled_io_actions_2(io_seq_num::in,
|
|
io_seq_num::in, int::in, int::out, int::in, int::out, io::di, io::uo)
|
|
is det.
|
|
|
|
count_tabled_io_actions_2(Cur, End, PrevTabled, Tabled,
|
|
PrevUntabled, Untabled, !IO) :-
|
|
( if Cur = End then
|
|
Untabled = PrevUntabled,
|
|
Tabled = PrevTabled
|
|
else
|
|
get_maybe_io_action(Cur, MaybeIoAction, !IO),
|
|
(
|
|
MaybeIoAction = tabled(_),
|
|
NewPrevUntabled = PrevUntabled,
|
|
NewPrevTabled = PrevTabled + 1
|
|
;
|
|
MaybeIoAction = untabled,
|
|
NewPrevUntabled = PrevUntabled + 1,
|
|
NewPrevTabled = PrevTabled
|
|
),
|
|
count_tabled_io_actions_2(Cur + 1, End,
|
|
NewPrevTabled, Tabled, NewPrevUntabled, Untabled, !IO)
|
|
).
|
|
|
|
:- pred trace_atom_arg_to_univ(trace_atom_arg::in, univ::out) is det.
|
|
|
|
trace_atom_arg_to_univ(TraceAtomArg, Univ) :-
|
|
MaybeUniv = TraceAtomArg ^ arg_value,
|
|
(
|
|
MaybeUniv = yes(Rep),
|
|
term_rep.rep_to_univ(Rep, Univ)
|
|
;
|
|
MaybeUniv = no,
|
|
Univ = univ('_' `with_type` unbound)
|
|
).
|
|
|
|
:- pred write_io_actions(user_state::in, int::in, io_action_range::in,
|
|
io::di, io::uo) is cc_multi.
|
|
|
|
write_io_actions(User, NumTabled, IoActions, !IO) :-
|
|
( if NumTabled = 0 then
|
|
true
|
|
else
|
|
( if NumTabled = 1 then
|
|
io.write_string(User ^ outstream, "1 tabled IO action:", !IO)
|
|
else
|
|
io.write_int(User ^ outstream, NumTabled, !IO),
|
|
io.write_string(User ^ outstream, " tabled IO actions:", !IO)
|
|
),
|
|
NumPrinted = get_num_printed_io_actions(User ^ browser),
|
|
( if NumTabled =< NumPrinted then
|
|
io.nl(User ^ outstream, !IO),
|
|
print_tabled_io_actions(User, IoActions, !IO)
|
|
else
|
|
io.write_string(User ^ outstream, " too many to show", !IO),
|
|
io.nl(User ^ outstream, !IO)
|
|
)
|
|
).
|
|
|
|
:- pred print_tabled_io_actions(user_state::in, io_action_range::in,
|
|
io::di, io::uo) is cc_multi.
|
|
|
|
print_tabled_io_actions(User, IoActions, !IO) :-
|
|
IoActions = io_action_range(Start, End),
|
|
print_tabled_io_actions_2(User, Start, End, !IO).
|
|
|
|
:- pred print_tabled_io_actions_2(user_state::in,
|
|
io_seq_num::in, io_seq_num::in, io::di, io::uo) is cc_multi.
|
|
|
|
print_tabled_io_actions_2(User, Cur, End, !IO) :-
|
|
( if Cur = End then
|
|
true
|
|
else
|
|
get_maybe_io_action(Cur, MaybeIoAction, !IO),
|
|
print_tabled_io_action(User, MaybeIoAction, !IO),
|
|
print_tabled_io_actions_2(User, Cur + 1, End, !IO)
|
|
).
|
|
|
|
:- pred print_tabled_io_action(user_state::in, maybe_tabled_io_action::in,
|
|
io::di, io::uo) is cc_multi.
|
|
|
|
print_tabled_io_action(_, untabled, !IO).
|
|
print_tabled_io_action(User, tabled(IoAction), !IO) :-
|
|
Term = io_action_to_browser_term(IoAction),
|
|
browse.print_browser_term(User ^ outstream, print_all, Term,
|
|
User ^ browser, !IO).
|
|
|
|
%---------------------------------------------------------------------------%
|
|
|
|
get_browser_state(User) = User ^ browser.
|
|
|
|
set_browser_state(Browser, !User) :-
|
|
!User ^ browser := Browser.
|
|
|
|
get_user_output_stream(User) = User ^ outstream.
|
|
|
|
get_user_input_stream(User) = User ^ instream.
|
|
|
|
set_user_testing_flag(Testing, User, User ^ testing := Testing).
|
|
|
|
%---------------------------------------------------------------------------%
|
|
|
|
:- pred convert_dirs_to_term_path_from_atom(trace_atom::in,
|
|
list(down_dir)::in, term_path::out) is det.
|
|
|
|
convert_dirs_to_term_path_from_atom(_, [], []).
|
|
convert_dirs_to_term_path_from_atom(atom(_, Args), [Dir | Dirs], TermPath) :-
|
|
(
|
|
Dir = down_child_num(Pos),
|
|
Arg = list.det_index1(Args, Pos),
|
|
Arg = arg_info(_, _, MaybeValue)
|
|
;
|
|
Dir = down_child_name(Name),
|
|
( if string_is_return_value_alias(Name) then
|
|
( if list.last(Args, LastArg) then
|
|
LastArg = arg_info(_, _, MaybeValue),
|
|
Pos = list.length(Args)
|
|
else
|
|
throw(internal_error("convert_dirs_to_term_path_from_atom",
|
|
"argument list empty"))
|
|
)
|
|
else
|
|
throw(internal_error("convert_dirs_to_term_path_from_atom",
|
|
"argument of atom cannot be named"))
|
|
)
|
|
),
|
|
(
|
|
MaybeValue = yes(TermRep),
|
|
convert_dirs_to_term_path(TermRep, Dirs, TermPath0),
|
|
TermPath = [Pos | TermPath0]
|
|
;
|
|
MaybeValue = no,
|
|
(
|
|
% The user can cd to an unbound argument, but they
|
|
% can't cd into subterms of an unbound argument.
|
|
(
|
|
Dirs = [],
|
|
TermPath = [Pos]
|
|
;
|
|
Dirs = [_ | _],
|
|
throw(internal_error("convert_dirs_to_term_path_from_atom",
|
|
"no value for first position in path"))
|
|
)
|
|
)
|
|
).
|
|
|
|
%---------------------------------------------------------------------------%
|