author  wenzelm 
Thu, 18 Oct 2012 13:57:27 +0200  
changeset 49911  262c36fd5f26 
parent 49895  03871053cdba 
child 49931  85780e6f8fd2 
permissions  rwrr 
30173
eabece26b89b
moved isabelle_process.ML, isabelle_process.scala, isar.ML, session.ML to Pure/System/ (together with associated Isar commands);
wenzelm
parents:
29435
diff
changeset

1 
(* Title: Pure/System/session.ML 
6346  2 
Author: Markus Wenzel, TU Muenchen 
3 

4 
Session management  maintain state of logic images. 

5 
*) 

6 

7 
signature SESSION = 

8 
sig 

25840  9 
val id: unit > string list 
11509  10 
val name: unit > string 
6346  11 
val welcome: unit > string 
48457  12 
val finish: unit > unit 
48805
c3ea910b3581
explicit document_output directory, without implicit purge of default in ISABELLE_BROWSER_INFO;
wenzelm
parents:
48804
diff
changeset

13 
val init: bool > bool > bool > string > string > bool > string > (string * string) list > 
48543  14 
string > string > string * Present.dump_mode > string > bool > unit 
48457  15 
val with_timing: string > bool > ('a > 'b) > 'a > 'b 
48445  16 
val use_dir: string > string > bool > string list > bool > bool > string > 
31688  17 
string > bool > string list > string > string > bool * string > 
41703
d27950860514
parallelization of nested Isar proofs is subject to Goal.parallel_proofs_threshold;
wenzelm
parents:
39733
diff
changeset

18 
string > int > bool > bool > int > int > int > int > unit 
6346  19 
end; 
20 

21 
structure Session: SESSION = 

22 
struct 

23 

24 
(* session state *) 

25 

32738  26 
val session = Unsynchronized.ref ([Context.PureN]: string list); 
27 
val session_finished = Unsynchronized.ref false; 

48542  28 

29 
fun id () = ! session; 

30 
fun name () = "Isabelle/" ^ List.last (! session); 

9414  31 

32 

33 
(* access path *) 

6346  34 

48542  35 
val session_path = Unsynchronized.ref ([]: string list); 
36 
val remote_path = Unsynchronized.ref (NONE: Url.T option); 

6346  37 

48542  38 
fun path () = ! session_path; 
26109
c69c3559355b
more elaborate structure Distribution (filledin by makedist);
wenzelm
parents:
25840
diff
changeset

39 

30173
eabece26b89b
moved isabelle_process.ML, isabelle_process.scala, isar.ML, session.ML to Pure/System/ (together with associated Isar commands);
wenzelm
parents:
29435
diff
changeset

40 

eabece26b89b
moved isabelle_process.ML, isabelle_process.scala, isar.ML, session.ML to Pure/System/ (together with associated Isar commands);
wenzelm
parents:
29435
diff
changeset

41 
(* welcome *) 
eabece26b89b
moved isabelle_process.ML, isabelle_process.scala, isar.ML, session.ML to Pure/System/ (together with associated Isar commands);
wenzelm
parents:
29435
diff
changeset

42 

26109
c69c3559355b
more elaborate structure Distribution (filledin by makedist);
wenzelm
parents:
25840
diff
changeset

43 
fun welcome () = 
26134  44 
if Distribution.is_official then 
45 
"Welcome to " ^ name () ^ " (" ^ Distribution.version ^ ")" 

48990  46 
else "Unofficial version of " ^ name () ^ " (" ^ Distribution.version ^ ")"; 
6346  47 

48 

9414  49 
(* add_path *) 
50 

51 
fun add_path reset s = 

52 
let val sess = ! session @ [s] in 

18964  53 
(case duplicates (op =) sess of 
9414  54 
[] => (session := sess; session_path := ((if reset then [] else ! session_path) @ [s])) 
48542  55 
 dups => error ("Duplicate session identifiers " ^ commas_quote dups)) 
9414  56 
end; 
57 

58 

48457  59 
(* init_name *) 
6346  60 

48457  61 
fun init_name reset parent name = 
20664  62 
if not (member (op =) (! session) parent) orelse not (! session_finished) then 
6346  63 
error ("Unfinished parent session " ^ quote parent ^ " for " ^ quote name) 
64 
else (add_path reset name; session_finished := false); 

65 

66 

67 
(* finish *) 

68 

69 
fun finish () = 

49911
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

70 
(Future.shutdown (); 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

71 
Goal.finish_futures (); 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

72 
Thy_Info.finish (); 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

73 
Present.finish (); 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

74 
Keyword.status (); 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

75 
Outer_Syntax.check_syntax (); 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

76 
Goal.cancel_futures (); 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

77 
Future.shutdown (); 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

78 
Options.reset_default (); 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

79 
session_finished := true); 
6346  80 

81 

82 
(* use_dir *) 

83 

48457  84 
fun with_timing _ false f x = f x 
85 
 with_timing item true f x = 

86 
let 

87 
val start = Timing.start (); 

88 
val y = f x; 

89 
val timing = Timing.result start; 

90 
val factor = Time.toReal (#cpu timing) / Time.toReal (#elapsed timing) 

91 
> Real.fmt (StringCvt.FIX (SOME 2)); 

92 
val _ = 

93 
Output.physical_stderr ("Timing " ^ item ^ " (" ^ 

94 
string_of_int (Multithreading.max_threads_value ()) ^ " threads, " ^ 

95 
Timing.message timing ^ ", factor " ^ factor ^ ")\n"); 

96 
in y end; 

97 

48516
c5d0f19ef7cb
refined "document_dump_mode": "all", "tex+sty", "tex";
wenzelm
parents:
48467
diff
changeset

98 
fun get_rpath rpath = 
c5d0f19ef7cb
refined "document_dump_mode": "all", "tex+sty", "tex";
wenzelm
parents:
48467
diff
changeset

99 
(if rpath = "" then () else 
c5d0f19ef7cb
refined "document_dump_mode": "all", "tex+sty", "tex";
wenzelm
parents:
48467
diff
changeset

100 
if is_some (! remote_path) then 
c5d0f19ef7cb
refined "document_dump_mode": "all", "tex+sty", "tex";
wenzelm
parents:
48467
diff
changeset

101 
error "Path for remote theory browsing information may only be set once" 
c5d0f19ef7cb
refined "document_dump_mode": "all", "tex+sty", "tex";
wenzelm
parents:
48467
diff
changeset

102 
else 
c5d0f19ef7cb
refined "document_dump_mode": "all", "tex+sty", "tex";
wenzelm
parents:
48467
diff
changeset

103 
remote_path := SOME (Url.explode rpath); 
c5d0f19ef7cb
refined "document_dump_mode": "all", "tex+sty", "tex";
wenzelm
parents:
48467
diff
changeset

104 
(! remote_path, rpath <> "")); 
c5d0f19ef7cb
refined "document_dump_mode": "all", "tex+sty", "tex";
wenzelm
parents:
48467
diff
changeset

105 

48805
c3ea910b3581
explicit document_output directory, without implicit purge of default in ISABELLE_BROWSER_INFO;
wenzelm
parents:
48804
diff
changeset

106 
fun init build reset info info_path doc doc_graph doc_output doc_variants 
c3ea910b3581
explicit document_output directory, without implicit purge of default in ISABELLE_BROWSER_INFO;
wenzelm
parents:
48804
diff
changeset

107 
parent name doc_dump rpath verbose = 
48457  108 
(init_name reset parent name; 
48805
c3ea910b3581
explicit document_output directory, without implicit purge of default in ISABELLE_BROWSER_INFO;
wenzelm
parents:
48804
diff
changeset

109 
Present.init build info info_path (if doc = "false" then "" else doc) doc_graph doc_output 
c3ea910b3581
explicit document_output directory, without implicit purge of default in ISABELLE_BROWSER_INFO;
wenzelm
parents:
48804
diff
changeset

110 
doc_variants (path ()) name doc_dump (get_rpath rpath) verbose 
48467
a4318c36a829
more precise propagation of options: build, session, theories;
wenzelm
parents:
48457
diff
changeset

111 
(map Thy_Info.get_theory (Thy_Info.get_names ()))); 
48457  112 

48516
c5d0f19ef7cb
refined "document_dump_mode": "all", "tex+sty", "tex";
wenzelm
parents:
48467
diff
changeset

113 
local 
c5d0f19ef7cb
refined "document_dump_mode": "all", "tex+sty", "tex";
wenzelm
parents:
48467
diff
changeset

114 

48543  115 
fun doc_dump (cp, dump) = (dump, if cp then Present.Dump_all else Present.Dump_tex_sty); 
48516
c5d0f19ef7cb
refined "document_dump_mode": "all", "tex+sty", "tex";
wenzelm
parents:
48467
diff
changeset

116 

48804
6348e5fca42e
more direct interpretation of document_variants for build (unchanged for usedir);
wenzelm
parents:
48709
diff
changeset

117 
fun read_variants strs = 
6348e5fca42e
more direct interpretation of document_variants for build (unchanged for usedir);
wenzelm
parents:
48709
diff
changeset

118 
rev (distinct (eq_fst (op =)) (rev (("document", "") :: map Present.read_variant strs))) 
6348e5fca42e
more direct interpretation of document_variants for build (unchanged for usedir);
wenzelm
parents:
48709
diff
changeset

119 
> filter_out (fn (_, s) => s = ""); 
6348e5fca42e
more direct interpretation of document_variants for build (unchanged for usedir);
wenzelm
parents:
48709
diff
changeset

120 

48516
c5d0f19ef7cb
refined "document_dump_mode": "all", "tex+sty", "tex";
wenzelm
parents:
48467
diff
changeset

121 
in 
c5d0f19ef7cb
refined "document_dump_mode": "all", "tex+sty", "tex";
wenzelm
parents:
48467
diff
changeset

122 

48445  123 
fun use_dir item root build modes reset info info_path doc doc_graph doc_variants parent 
41703
d27950860514
parallelization of nested Isar proofs is subject to Goal.parallel_proofs_threshold;
wenzelm
parents:
39733
diff
changeset

124 
name dump rpath level timing verbose max_threads trace_threads 
d27950860514
parallelization of nested Isar proofs is subject to Goal.parallel_proofs_threshold;
wenzelm
parents:
39733
diff
changeset

125 
parallel_proofs parallel_proofs_threshold = 
23972  126 
((fn () => 
49911
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

127 
let 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

128 
val _ = 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

129 
Output.physical_stderr 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

130 
"### Legacy feature: old \"isabelle usedir\"  use \"isabelle build\" instead!\n"; 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

131 
val _ = 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

132 
init build reset info info_path doc doc_graph "" (read_variants doc_variants) parent name 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

133 
(doc_dump dump) rpath verbose; 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

134 
val res1 = (use > with_timing item timing > Exn.capture) root; 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

135 
val res2 = Exn.capture finish (); 
262c36fd5f26
collective errors from use_thys and Session.finish/Goal.finish_futures  avoid uninformative interrupts stemming from failure of goal forks that are not registered in the theory (e.g. unnamed theorems);
wenzelm
parents:
49895
diff
changeset

136 
in ignore (Par_Exn.release_all [res1, res2]) end) 
39616
8052101883c3
renamed setmp_noncritical to Unsynchronized.setmp to emphasize its meaning;
wenzelm
parents:
37216
diff
changeset

137 
> Unsynchronized.setmp Proofterm.proofs level 
8052101883c3
renamed setmp_noncritical to Unsynchronized.setmp to emphasize its meaning;
wenzelm
parents:
37216
diff
changeset

138 
> Unsynchronized.setmp print_mode (modes @ print_mode_value ()) 
8052101883c3
renamed setmp_noncritical to Unsynchronized.setmp to emphasize its meaning;
wenzelm
parents:
37216
diff
changeset

139 
> Unsynchronized.setmp Goal.parallel_proofs parallel_proofs 
41703
d27950860514
parallelization of nested Isar proofs is subject to Goal.parallel_proofs_threshold;
wenzelm
parents:
39733
diff
changeset

140 
> Unsynchronized.setmp Goal.parallel_proofs_threshold parallel_proofs_threshold 
39616
8052101883c3
renamed setmp_noncritical to Unsynchronized.setmp to emphasize its meaning;
wenzelm
parents:
37216
diff
changeset

141 
> Unsynchronized.setmp Multithreading.trace trace_threads 
8052101883c3
renamed setmp_noncritical to Unsynchronized.setmp to emphasize its meaning;
wenzelm
parents:
37216
diff
changeset

142 
> Unsynchronized.setmp Multithreading.max_threads 
23979  143 
(if Multithreading.available then max_threads 
144 
else (if max_threads = 1 then () else warning "Multithreading support unavailable"; 1))) () 

31478  145 
handle exn => (Output.error_msg (ML_Compiler.exn_message exn); exit 1); 
6346  146 

147 
end; 

48516
c5d0f19ef7cb
refined "document_dump_mode": "all", "tex+sty", "tex";
wenzelm
parents:
48467
diff
changeset

148 

c5d0f19ef7cb
refined "document_dump_mode": "all", "tex+sty", "tex";
wenzelm
parents:
48467
diff
changeset

149 
end; 