author  wenzelm 
Sun, 17 Sep 2000 22:22:11 +0200  
changeset 10009  45c1eb3d8ad4 
parent 9953  035a8288310a 
child 14774  d747c32e85e1 
permissions  rwrr 
3604
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

1 
(* Title: Pure/Thy/thy_info.ML 
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

2 
ID: $Id$ 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

3 
Author: Markus Wenzel, TU Muenchen 
8805  4 
License: GPL (GNU GENERAL PUBLIC LICENSE) 
3604
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

5 

6362  6 
Theory loader database, including theory and file dependencies. 
3976  7 
*) 
3604
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

8 

5209  9 
signature BASIC_THY_INFO = 
10 
sig 

11 
val theory: string > theory 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

12 
val theory_of_sign: Sign.sg > theory 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

13 
val theory_of_thm: thm > theory 
6241  14 
(*val use: string > unit*) (*exported later*) 
15 
val time_use: string > unit 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

16 
val touch_thy: string > unit 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

17 
val use_thy: string > unit 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

18 
val update_thy: string > unit 
6666  19 
val remove_thy: string > unit 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

20 
val time_use_thy: string > unit 
6527  21 
val use_thy_only: string > unit 
7099  22 
val update_thy_only: string > unit 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

23 
end; 
5209  24 

3604
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

25 
signature THY_INFO = 
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

26 
sig 
5209  27 
include BASIC_THY_INFO 
7099  28 
datatype action = Update  Outdate  Remove 
29 
val str_of_action: action > string 

30 
val add_hook: (action > string > unit) > unit 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

31 
val names: unit > string list 
7910  32 
val known_thy: string > bool 
7935  33 
val check_known_thy: string > bool 
34 
val if_known_thy: (string > unit) > string > unit 

7288  35 
val lookup_theory: string > theory option 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

36 
val get_theory: string > theory 
6654  37 
val get_preds: string > string list 
7935  38 
val loaded_files: string > Path.T list 
7910  39 
val touch_child_thys: string > unit 
7099  40 
val touch_all_thys: unit > unit 
7941  41 
val load_file: bool > Path.T > unit 
6241  42 
val use: string > unit 
7952  43 
val quiet_update_thy: bool > string > unit 
9822  44 
val pretend_use_thy_only: string > unit 
8805  45 
val begin_theory: (string > string list > (Path.T * bool) list > theory > theory) > 
46 
bool > string > string list > (Path.T * bool) list > theory 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

47 
val end_theory: theory > theory 
6666  48 
val finish: unit > unit 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

49 
val register_theory: theory > unit 
3604
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

50 
end; 
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

51 

6362  52 
structure ThyInfo: THY_INFO = 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

53 
struct 
3604
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

54 

6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

55 

7099  56 
(** theory loader actions and hooks **) 
57 

58 
datatype action = Update  Outdate  Remove; 

59 
val str_of_action = fn Update => "Update"  Outdate => "Outdate"  Remove => "Remove"; 

60 

61 
local 

62 
val hooks = ref ([]: (action > string > unit) list); 

63 
in 

64 
fun add_hook f = hooks := f :: ! hooks; 

7191  65 
fun perform action name = seq (fn f => (try (fn () => f action name) (); ())) (! hooks); 
7099  66 
end; 
67 

68 

69 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

70 
(** thy database **) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

71 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

72 
(* messages *) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

73 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

74 
fun gen_msg txt [] = txt 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

75 
 gen_msg txt names = txt ^ " " ^ commas_quote names; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

76 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

77 
fun loader_msg txt names = gen_msg ("Theory loader: " ^ txt) names; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

78 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

79 
val show_path = space_implode " via " o map quote; 
9332  80 
fun cycle_msg names = loader_msg ("cyclic dependency of " ^ show_path names) []; 
3604
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

81 

6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

82 

6666  83 
(* derived graph operations *) 
3604
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

84 

9327  85 
fun add_deps name parents G = Graph.add_deps_acyclic (name, parents) G 
9332  86 
handle Graph.CYCLES namess => error (cat_lines (map cycle_msg namess)); 
3604
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

87 

7952  88 
fun upd_deps name entry G = 
89 
foldl (fn (H, parent) => Graph.del_edge (parent, name) H) (G, Graph.imm_preds G name) 

90 
> Graph.map_node name (K entry); 

3976  91 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

92 
fun update_node name parents entry G = 
7952  93 
(if can (Graph.get_node G) name then upd_deps name entry G else Graph.new_node (name, entry) G) 
94 
> add_deps name parents; 

95 

3604
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

96 

6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

97 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

98 
(* thy database *) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

99 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

100 
type deps = 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

101 
{present: bool, outdated: bool, 
7941  102 
master: ThyLoad.master option, files: (Path.T * (Path.T * File.info) option) list}; 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

103 

6241  104 
fun make_deps present outdated master files = 
105 
{present = present, outdated = outdated, master = master, files = files}: deps; 

3604
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

106 

7211  107 
fun init_deps master files = Some (make_deps false true master (map (rpair None) files)); 
108 

109 

6362  110 
type thy = deps option * theory option; 
3604
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

111 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

112 
local 
6362  113 
val database = ref (Graph.empty: thy Graph.T); 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

114 
in 
6362  115 
fun get_thys () = ! database; 
9137  116 
val change_thys = Library.change database; 
3604
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

117 
end; 
5209  118 

119 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

120 
(* access thy graph *) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

121 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

122 
fun thy_graph f x = f (get_thys ()) x; 
9417  123 

124 
(*theory names in topological order*) 

125 
fun get_names () = 

126 
let val G = get_thys () 

127 
in Graph.all_succs G (filter (Library.null o Graph.imm_preds G) (Graph.keys G)) end; 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

128 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

129 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

130 
(* access thy *) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

131 

7935  132 
fun lookup_thy name = 
9327  133 
Some (thy_graph Graph.get_node name) handle Graph.UNDEF _ => None; 
7935  134 

7910  135 
val known_thy = is_some o lookup_thy; 
7935  136 
fun check_known_thy name = known_thy name orelse (warning ("Unknown theory " ^ quote name); false); 
137 
fun if_known_thy f name = if check_known_thy name then f name else (); 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

138 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

139 
fun get_thy name = 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

140 
(case lookup_thy name of 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

141 
Some thy => thy 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

142 
 None => error (loader_msg "nothing known about theory" [name])); 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

143 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

144 
fun change_thy name f = (get_thy name; change_thys (Graph.map_node name f)); 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

145 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

146 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

147 
(* access deps *) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

148 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

149 
val lookup_deps = apsome #1 o lookup_thy; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

150 
val get_deps = #1 o get_thy; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

151 
fun change_deps name f = change_thy name (fn (deps, x) => (f deps, x)); 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

152 

6666  153 
fun is_finished name = is_none (get_deps name); 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

154 
fun get_files name = (case get_deps name of Some {files, ...} => files  _ => []); 
7191  155 

156 
fun loaded_files name = 

157 
(case get_deps name of 

7935  158 
None => [] 
7910  159 
 Some {master, files, ...} => 
7935  160 
(case master of Some m => [#1 (ThyLoad.get_thy m)]  None => []) @ 
7941  161 
(mapfilter (apsome #1 o #2) files)); 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

162 

6654  163 
fun get_preds name = 
9327  164 
(thy_graph Graph.imm_preds name) handle Graph.UNDEF _ => 
6654  165 
error (loader_msg "nothing known about theory" [name]); 
166 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

167 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

168 
(* access theory *) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

169 

7687  170 
fun lookup_theory name = 
171 
(case lookup_thy name of 

172 
Some (_, Some thy) => Some thy 

173 
 _ => None); 

7288  174 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

175 
fun get_theory name = 
7288  176 
(case lookup_theory name of 
177 
(Some theory) => theory 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

178 
 _ => error (loader_msg "undefined theory entry for" [name])); 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

179 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

180 
val theory_of_sign = get_theory o Sign.name_of; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

181 
val theory_of_thm = theory_of_sign o Thm.sign_of_thm; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

182 

7099  183 
fun put_theory name theory = change_thy name (fn (deps, _) => (deps, Some theory)); 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

184 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

185 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

186 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

187 
(** thy operations **) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

188 

6241  189 
(* maintain 'outdated' flag *) 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

190 

7099  191 
local 
192 

6241  193 
fun is_outdated name = 
194 
(case lookup_deps name of 

195 
Some (Some {outdated, ...}) => outdated 

196 
 _ => false); 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

197 

6241  198 
fun outdate_thy name = 
7099  199 
if is_finished name orelse is_outdated name then () 
200 
else (change_deps name (apsome (fn {present, outdated = _, master, files} => 

201 
make_deps present true master files)); perform Outdate name); 

202 

7910  203 
fun check_unfinished name = 
204 
if is_finished name then (warning (loader_msg "tried to touch finished theory" [name]); None) 

205 
else Some name; 

206 

7099  207 
in 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

208 

7910  209 
fun touch_thys names = 
210 
seq outdate_thy (thy_graph Graph.all_succs (mapfilter check_unfinished names)); 

211 

212 
fun touch_thy name = touch_thys [name]; 

213 
fun touch_child_thys name = touch_thys (thy_graph Graph.imm_succs name); 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

214 

7099  215 
fun touch_all_thys () = seq outdate_thy (get_names ()); 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

216 

7099  217 
end; 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

218 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

219 

7244  220 
(* check 'finished' state *) 
221 

222 
fun check_unfinished fail name = 

7910  223 
if known_thy name andalso is_finished name then 
7288  224 
fail (loader_msg "cannot update finished theory" [name]) 
7244  225 
else (); 
226 

227 

7941  228 
(* load_file *) 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

229 

7191  230 
local 
231 

7941  232 
fun provide path name info (deps as Some {present, outdated, master, files}) = 
233 
(if exists (equal path o #1) files then () 

234 
else warning (loader_msg "undeclared dependency of theory" [name] ^ 

235 
" on file: " ^ quote (Path.pack path)); 

236 
Some (make_deps present outdated master (overwrite (files, (path, Some info))))) 

237 
 provide _ _ _ None = None; 

238 

239 
fun run_file path = 

240 
(case apsome PureThy.get_name (Context.get_context ()) of 

241 
None => (ThyLoad.load_file path; ()) 

242 
 Some name => 

243 
if known_thy name then change_deps name (provide path name (ThyLoad.load_file path)) 

244 
else (ThyLoad.load_file path; ())); 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

245 

7191  246 
in 
247 

7941  248 
fun load_file time path = 
249 
if time then 

7244  250 
let val name = Path.pack path in 
251 
timeit (fn () => 

9778  252 
(priority ("\n**** Starting file " ^ quote name ^ " ****"); 
9036  253 
run_file path; 
9778  254 
priority ("**** Finished file " ^ quote name ^ " ****\n"))) 
7244  255 
end 
7941  256 
else run_file path; 
257 

258 
val use = load_file false o Path.unpack; 

259 
val time_use = load_file true o Path.unpack; 

7191  260 

261 
end; 

6233  262 

263 

7099  264 
(* load_thy *) 
265 

9490  266 
fun required_by _ [] = "" 
267 
 required_by s initiators = s ^ "(required by " ^ show_path (rev initiators) ^ ")"; 

7099  268 

9822  269 
fun load_thy really ml time initiators dir name parents = 
7099  270 
let 
9822  271 
val _ = 
272 
if really then priority ("Loading theory " ^ quote name ^ required_by " " initiators) 

273 
else priority ("Registering theory " ^ quote name); 

7099  274 

275 
val _ = touch_thy name; 

9822  276 
val master = 
277 
if really then ThyLoad.load_thy dir name ml time 

278 
else #1 (ThyLoad.deps_thy dir name ml); 

7099  279 

280 
val files = get_files name; 

281 
val missing_files = mapfilter (fn (path, None) => Some (Path.pack path)  _ => None) files; 

282 
in 

283 
if null missing_files then () 

284 
else warning (loader_msg "unresolved dependencies of theory" [name] ^ 

7223  285 
" on file(s): " ^ commas_quote missing_files); 
7191  286 
change_deps name (fn _ => Some (make_deps true false (Some master) files)); 
7099  287 
perform Update name 
288 
end; 

289 

290 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

291 
(* require_thy *) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

292 

7211  293 
local 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

294 

7941  295 
fun load_deps ml dir name = 
296 
let val (master, (parents, files)) = ThyLoad.deps_thy dir name ml 

7191  297 
in (Some (init_deps (Some master) files), parents) end; 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

298 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

299 
fun file_current (_, None) = false 
7941  300 
 file_current (path, info) = (info = ThyLoad.check_file path); 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

301 

7941  302 
fun current_deps ml strict dir name = 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

303 
(case lookup_deps name of 
7941  304 
None => (false, load_deps ml dir name) 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

305 
 Some deps => 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

306 
let val same_deps = (None, thy_graph Graph.imm_preds name) in 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

307 
(case deps of 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

308 
None => (true, same_deps) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

309 
 Some {present, outdated, master, files} => 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

310 
if present andalso not strict then (true, same_deps) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

311 
else 
7941  312 
let val master' = Some (ThyLoad.check_thy dir name ml) in 
313 
if master <> master' then (false, load_deps ml dir name) 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

314 
else (not outdated andalso forall file_current files, same_deps) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

315 
end) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

316 
end); 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

317 

9822  318 
fun require_thy really ml time strict keep_strict initiators prfx (visited, str) = 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

319 
let 
7066  320 
val path = Path.expand (Path.unpack str); 
6484
3f098b0ec683
use_thy etc.: may specify path prefix, which is temporarily used as load path;
wenzelm
parents:
6389
diff
changeset

321 
val name = Path.pack (Path.base path); 
7066  322 
in 
9332  323 
if name mem_string initiators then error (cycle_msg initiators) else (); 
7952  324 
if known_thy name andalso is_finished name orelse name mem_string visited then 
325 
(visited, (true, name)) 

7066  326 
else 
327 
let 

328 
val dir = Path.append prfx (Path.dir path); 

9822  329 
val req_parent = require_thy true true time (strict andalso keep_strict) keep_strict 
330 
(name :: initiators) dir; 

6484
3f098b0ec683
use_thy etc.: may specify path prefix, which is temporarily used as load path;
wenzelm
parents:
6389
diff
changeset

331 

7941  332 
val (current, (new_deps, parents)) = current_deps ml strict dir name handle ERROR => 
7099  333 
error (loader_msg "the error(s) above occurred while examining theory" [name] ^ 
9490  334 
(if null initiators then "" else required_by "\n" initiators)); 
7066  335 
val (visited', parent_results) = foldl_map req_parent (name :: visited, parents); 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

336 

9822  337 
val thy = if not really then Some (get_theory name) else None; 
7066  338 
val result = 
339 
if current andalso forall #1 parent_results then true 

340 
else 

341 
((case new_deps of 

9822  342 
Some deps => change_thys (update_node name parents (deps, thy)) 
7066  343 
 None => ()); 
9822  344 
load_thy really ml (time orelse ! Library.timing) initiators dir name parents; 
7099  345 
false); 
7066  346 
in (visited', (result, name)) end 
347 
end; 

6484
3f098b0ec683
use_thy etc.: may specify path prefix, which is temporarily used as load path;
wenzelm
parents:
6389
diff
changeset

348 

7066  349 
fun gen_use_thy req s = 
350 
let val (_, (_, name)) = req [] Path.current ([], s) 

351 
in Context.context (get_theory name) end; 

6241  352 

7244  353 
fun warn_finished f name = (check_unfinished warning name; f name); 
354 

7211  355 
in 
356 

9822  357 
val weak_use_thy = gen_use_thy (require_thy true true false false false); 
358 
fun quiet_update_thy ml = gen_use_thy (require_thy true ml false true true); 

7244  359 

9822  360 
val use_thy = warn_finished (gen_use_thy (require_thy true true false true false)); 
361 
val time_use_thy = warn_finished (gen_use_thy (require_thy true true true true false)); 

362 
val use_thy_only = warn_finished (gen_use_thy (require_thy true false false true false)); 

363 
val update_thy = warn_finished (gen_use_thy (require_thy true true false true true)); 

364 
val update_thy_only = warn_finished (gen_use_thy (require_thy true false false true true)); 

365 
val pretend_use_thy_only = warn_finished (gen_use_thy (require_thy false false false true false)); 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

366 

7211  367 
end; 
368 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

369 

6666  370 
(* remove_thy *) 
371 

372 
fun remove_thy name = 

7910  373 
if is_finished name then error (loader_msg "cannot remove finished theory" [name]) 
6666  374 
else 
375 
let val succs = thy_graph Graph.all_succs [name] in 

9778  376 
priority (loader_msg "removing" succs); 
7191  377 
seq (perform Remove) succs; 
378 
change_thys (Graph.del_nodes succs) 

6666  379 
end; 
380 

381 

7066  382 
(* begin / end theory *) 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

383 

8805  384 
fun begin_theory present upd name parents paths = 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

385 
let 
8805  386 
val assert_thy = if upd then quiet_update_thy true else weak_use_thy; 
7244  387 
val _ = check_unfinished error name; 
7941  388 
val _ = (map Path.basic parents; seq assert_thy parents); 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

389 
val theory = PureThy.begin_theory name (map get_theory parents); 
7952  390 
val deps = 
391 
if known_thy name then get_deps name 

392 
else (init_deps None (map #1 paths)); (*records additional ML files only!*) 

6329  393 
val use_paths = mapfilter (fn (x, true) => Some x  _ => None) paths; 
9451  394 

395 
val _ = change_thys (update_node name parents (deps, Some (Theory.copy theory))); 

8805  396 
val theory' = theory > present name parents paths; 
9451  397 
val _ = put_theory name (Theory.copy theory'); 
8805  398 
val ((), theory'') = Context.pass_theory theory' (seq (load_file false)) use_paths; 
9451  399 
val _ = put_theory name (Theory.copy theory''); 
8805  400 
in theory'' end; 
7244  401 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

402 
fun end_theory theory = 
7099  403 
let 
404 
val theory' = PureThy.end_theory theory; 

405 
val name = PureThy.get_name theory; 

406 
in put_theory name theory'; theory' end; 

6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

407 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

408 

6666  409 
(* finish all theories *) 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

410 

6666  411 
fun finish () = change_thys (Graph.map_nodes (fn (_, entry) => (None, entry))); 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

412 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

413 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

414 
(* register existing theories *) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

415 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

416 
fun register_theory theory = 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

417 
let 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

418 
val name = PureThy.get_name theory; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

419 
val parents = Theory.parents_of theory; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

420 
val parent_names = map PureThy.get_name parents; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

421 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

422 
fun err txt bads = 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

423 
error (loader_msg txt bads ^ "\n" ^ gen_msg "cannot register theory" [name]); 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

424 

6666  425 
val nonfinished = filter_out is_finished parent_names; 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

426 
fun get_variant (x, y_name) = 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

427 
if Theory.eq_thy (x, get_theory y_name) then None 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

428 
else Some y_name; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

429 
val variants = mapfilter get_variant (parents ~~ parent_names); 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

430 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

431 
fun register G = 
6362  432 
(Graph.new_node (name, (None, Some theory)) G 
9327  433 
handle Graph.DUP _ => err "duplicate theory entry" []) 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

434 
> add_deps name parent_names; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

435 
in 
6666  436 
if not (null nonfinished) then err "nonfinished parent theories" nonfinished 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

437 
else if not (null variants) then err "different versions of parent theories" variants 
7099  438 
else (change_thys register; perform Update name) 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

439 
end; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

440 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

441 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

442 
(*final declarations of this structure*) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

443 
val theory = get_theory; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

444 
val names = get_names; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

445 

43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

446 
end; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

447 

5209  448 
structure BasicThyInfo: BASIC_THY_INFO = ThyInfo; 
449 
open BasicThyInfo; 