author  wenzelm 
Tue, 26 Oct 1999 19:04:55 +0200  
changeset 7935  ac62465ed06c 
parent 7910  e54db490c537 
child 7941  653964583bd3 
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 
3604
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

4 

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

7 

5209  8 
signature BASIC_THY_INFO = 
9 
sig 

10 
val theory: string > theory 

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

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

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

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

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

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

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

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

22 
end; 
5209  23 

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

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

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

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

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

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

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

35 
val get_theory: string > theory 
6654  36 
val get_preds: string > string list 
7935  37 
val loaded_files: string > Path.T list 
7910  38 
val touch_child_thys: string > unit 
7099  39 
val touch_all_thys: unit > unit 
7244  40 
val may_load_file: bool > bool > Path.T > unit 
6329  41 
val use_path: Path.T > unit 
6241  42 
val use: string > unit 
7191  43 
val pretend_use: string > unit 
7244  44 
val quiet_update_thy: string > unit 
6329  45 
val begin_theory: string > string list > (Path.T * bool) list > theory 
7244  46 
val begin_update_theory: 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; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

80 
fun cycle_msg name names = loader_msg ("cyclic dependency of " ^ show_path (name :: 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 

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

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

86 
foldl (fn (H, parent) => Graph.add_edge_acyclic (parent, name) H) (G, parents) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

87 
handle Graph.CYCLES namess => error (cat_lines (map (cycle_msg name) namess)); 
3604
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

88 

6666  89 
fun del_deps name G = 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

90 
foldl (fn (H, parent) => Graph.del_edge (parent, name) H) (G, Graph.imm_preds G name); 
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 = 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

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

94 
(if can (Graph.get_node G) name then del_deps name G else Graph.new_node (name, entry) G); 
3604
6bf9f09f3d61
Moved functions for theory information storage / retrieval
berghofe
parents:
diff
changeset

95 

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

96 

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

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

98 

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

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

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

102 

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

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

105 

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

108 

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

110 

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

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

113 
in 
6362  114 
fun get_thys () = ! database; 
115 
fun change_thys f = database := (f (! database)); 

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

116 
end; 
5209  117 

118 

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

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

120 

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

121 
fun thy_graph f x = f (get_thys ()) x; 
6666  122 
fun get_names () = Graph.keys (get_thys ()); 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

123 

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

124 

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

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

126 

7935  127 
fun lookup_thy name = 
128 
Some (thy_graph Graph.get_node name) handle Graph.UNDEFINED _ => None; 

129 

7910  130 
val known_thy = is_some o lookup_thy; 
7935  131 
fun check_known_thy name = known_thy name orelse (warning ("Unknown theory " ^ quote name); false); 
132 
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

133 

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

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

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

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

137 
 None => error (loader_msg "nothing known about theory" [name])); 
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 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

140 

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

141 

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

142 
(* access deps *) 
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 
val lookup_deps = apsome #1 o lookup_thy; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

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

146 
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

147 

6666  148 
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

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

151 
fun loaded_files name = 

152 
(case get_deps name of 

7935  153 
None => [] 
7910  154 
 Some {master, files, ...} => 
7935  155 
(case master of Some m => [#1 (ThyLoad.get_thy m)]  None => []) @ 
156 
map (#1 o #1) (mapfilter #2 files)); 

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

157 

6654  158 
fun get_preds name = 
159 
(thy_graph Graph.imm_preds name) handle Graph.UNDEFINED _ => 

160 
error (loader_msg "nothing known about theory" [name]); 

161 

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

162 

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

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

164 

7687  165 
fun lookup_theory name = 
166 
(case lookup_thy name of 

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

168 
 _ => None); 

7288  169 

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

170 
fun get_theory name = 
7288  171 
(case lookup_theory name of 
172 
(Some theory) => theory 

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

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

174 

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

175 
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

176 
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

177 

7099  178 
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

179 

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

180 

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

181 

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

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

183 

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

185 

7099  186 
local 
187 

6241  188 
fun is_outdated name = 
189 
(case lookup_deps name of 

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

191 
 _ => false); 

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

192 

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

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

197 

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

200 
else Some name; 

201 

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

203 

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

206 

207 
fun touch_thy name = touch_thys [name]; 

208 
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

209 

7099  210 
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

211 

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

213 

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

214 

7244  215 
(* check 'finished' state *) 
216 

217 
fun check_unfinished fail name = 

7910  218 
if known_thy name andalso is_finished name then 
7288  219 
fail (loader_msg "cannot update finished theory" [name]) 
7244  220 
else (); 
221 

222 

223 
(* may_load_file *) 

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

224 

7191  225 
local 
226 

227 
fun may_run_file really path = 

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

228 
let 
7191  229 
val load = ThyLoad.may_load_file really; 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

230 
fun provide name info (deps as Some {present, outdated, master, files}) = 
7910  231 
(if exists (equal path o #1) files then () 
232 
else warning (loader_msg "undeclared dependency of theory" [name] ^ 

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

7267  234 
Some (make_deps present outdated master 
7910  235 
(overwrite (files, (path, Some (info, really)))))) 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

236 
 provide _ _ None = None; 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

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

238 
(case apsome PureThy.get_name (Context.get_context ()) of 
7191  239 
None => (load path; ()) 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

240 
 Some name => 
7910  241 
if known_thy name then change_deps name (provide name (load path)) 
7191  242 
else (load path; ())) 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

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

244 

7191  245 
in 
246 

7244  247 
fun may_load_file really time path = 
248 
if really andalso time then 

249 
let val name = Path.pack path in 

250 
timeit (fn () => 

251 
(writeln ("\n**** Starting file " ^ quote name ^ " ****"); 

252 
may_run_file really path; 

253 
writeln ("**** Finished file " ^ quote name ^ " ****\n"))) 

254 
end 

255 
else may_run_file really path; 

7191  256 

257 
end; 

6233  258 

7244  259 
val use_path = may_load_file true false; 
260 
val use = use_path o Path.unpack; 

261 
val time_use = may_load_file true true o Path.unpack; 

262 
val pretend_use = may_load_file false false o Path.unpack; 

263 

6233  264 

7099  265 
(* load_thy *) 
266 

267 
fun required_by [] = "" 

268 
 required_by initiators = " (required by " ^ show_path (rev initiators) ^ ")"; 

269 

270 
fun load_thy ml time initiators dir name parents = 

271 
let 

272 
val _ = writeln ("Loading theory " ^ quote name ^ required_by initiators); 

273 

274 
val _ = touch_thy name; 

275 
val master = ThyLoad.load_thy dir name ml time; 

276 

277 
val files = get_files name; 

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

279 
in 

280 
if null missing_files then () 

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

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

286 

287 

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

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

289 

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

291 

7191  292 
fun load_deps dir name = 
293 
let val (master, (parents, files)) = ThyLoad.deps_thy dir name 

294 
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

295 

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

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

298 

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

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

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

303 
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

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

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

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

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

308 
else 
7191  309 
let val master' = Some (ThyLoad.check_thy dir name) in 
310 
if master <> master' then (false, load_deps dir name) 

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

311 
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

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

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

314 

7066  315 
fun require_thy 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

316 
let 
7066  317 
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

318 
val name = Path.pack (Path.base path); 
7066  319 
in 
7589  320 
if name mem_string initiators then error (cycle_msg name initiators) else (); 
7066  321 
if name mem_string visited then (visited, (true, name)) 
322 
else 

323 
let 

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

325 
val req_parent = 

7211  326 
require_thy true time (strict andalso keep_strict) keep_strict (name :: initiators) dir; 
6484
3f098b0ec683
use_thy etc.: may specify path prefix, which is temporarily used as load path;
wenzelm
parents:
6389
diff
changeset

327 

7191  328 
val (current, (new_deps, parents)) = current_deps strict dir name handle ERROR => 
7099  329 
error (loader_msg "the error(s) above occurred while examining theory" [name] ^ 
7066  330 
(if null initiators then "" else "\n" ^ required_by initiators)); 
331 
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

332 

7066  333 
val result = 
334 
if current andalso forall #1 parent_results then true 

335 
else 

336 
((case new_deps of 

7099  337 
Some deps => change_thys (update_node name parents (deps, None)) 
7066  338 
 None => ()); 
7099  339 
load_thy ml time initiators dir name parents; 
340 
false); 

7066  341 
in (visited', (result, name)) end 
342 
end; 

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

343 

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

346 
in Context.context (get_theory name) end; 

6241  347 

7244  348 
fun warn_finished f name = (check_unfinished warning name; f name); 
349 

7211  350 
in 
351 

7244  352 
val weak_use_thy = gen_use_thy (require_thy true false false false); 
353 
val quiet_update_thy = gen_use_thy (require_thy true false true true); 

354 

355 
val use_thy = warn_finished (gen_use_thy (require_thy true false true false)); 

356 
val time_use_thy = warn_finished (gen_use_thy (require_thy true true true false)); 

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

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

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

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

360 

7211  361 
end; 
362 

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

363 

6666  364 
(* remove_thy *) 
365 

366 
fun remove_thy name = 

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

370 
writeln (loader_msg "removing" succs); 

7191  371 
seq (perform Remove) succs; 
372 
change_thys (Graph.del_nodes succs) 

6666  373 
end; 
374 

375 

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

377 

7244  378 
fun gen_begin_theory check_thy name parents paths = 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

379 
let 
7244  380 
val _ = check_unfinished error name; 
381 
val _ = (map Path.basic parents; seq check_thy parents); 

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

382 
val theory = PureThy.begin_theory name (map get_theory parents); 
7191  383 
val _ = change_thys (update_node name parents (init_deps None [], Some theory)); 
6329  384 
val use_paths = mapfilter (fn (x, true) => Some x  _ => None) paths; 
385 
in Context.setmp (Some theory) (seq use_path) use_paths; theory end; 

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

386 

7244  387 
val begin_theory = gen_begin_theory weak_use_thy; 
388 
val begin_update_theory = gen_begin_theory quiet_update_thy; 

389 

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

390 
fun end_theory theory = 
7099  391 
let 
392 
val theory' = PureThy.end_theory theory; 

393 
val name = PureThy.get_name theory; 

394 
in put_theory name theory'; theory' end; 

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

395 

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

396 

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

398 

6666  399 
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

400 

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

401 

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

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

403 

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

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

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

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

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

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

409 

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

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

411 
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

412 

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

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

415 
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

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

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

418 

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

419 
fun register G = 
6362  420 
(Graph.new_node (name, (None, Some theory)) G 
6211
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

421 
handle Graph.DUPLICATE _ => err "duplicate theory entry" []) 
43d0efafa025
Theory loader database: theory and file dependencies, theory values
wenzelm
parents:
5211
diff
changeset

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

423 
in 
6666  424 
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

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

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

428 

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

429 

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

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

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

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

433 

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

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

435 

5209  436 
structure BasicThyInfo: BASIC_THY_INFO = ThyInfo; 
437 
open BasicThyInfo; 