src/Pure/Tools/build.ML
author wenzelm
Thu Apr 17 12:03:15 2014 +0200 (2014-04-17 ago)
changeset 56615 47c1dbeec36a
parent 56614 d80f43dab30e
child 56631 89269bb8e7ca
permissions -rw-r--r--
tuned comments;
wenzelm@50686
     1
(*  Title:      Pure/Tools/build.ML
wenzelm@48418
     2
    Author:     Makarius
wenzelm@48418
     3
wenzelm@48418
     4
Build Isabelle sessions.
wenzelm@48418
     5
*)
wenzelm@48418
     6
wenzelm@48418
     7
signature BUILD =
wenzelm@48418
     8
sig
wenzelm@48731
     9
  val build: string -> unit
wenzelm@48418
    10
end;
wenzelm@48418
    11
wenzelm@48418
    12
structure Build: BUILD =
wenzelm@48418
    13
struct
wenzelm@48418
    14
wenzelm@51662
    15
(* command timings *)
wenzelm@51662
    16
wenzelm@56615
    17
type timings = ((string * Time.time) Inttab.table) Symtab.table;  (*file -> offset -> name, time*)
wenzelm@51662
    18
wenzelm@51662
    19
val empty_timings: timings = Symtab.empty;
wenzelm@51662
    20
wenzelm@51662
    21
fun update_timings props =
wenzelm@51662
    22
  (case Markup.parse_command_timing_properties props of
wenzelm@51662
    23
    SOME ({file, offset, name}, time) =>
wenzelm@51666
    24
      Symtab.map_default (file, Inttab.empty)
wenzelm@51666
    25
        (Inttab.map_default (offset, (name, time)) (fn (_, t) => (name, Time.+ (t, time))))
wenzelm@51662
    26
  | NONE => I);
wenzelm@51662
    27
wenzelm@51662
    28
fun approximative_id name pos =
wenzelm@51662
    29
  (case (Position.file_of pos, Position.offset_of pos) of
wenzelm@51662
    30
    (SOME file, SOME offset) =>
wenzelm@51662
    31
      if name = "" then NONE else SOME {file = file, offset = offset, name = name}
wenzelm@51662
    32
  | _ => NONE);
wenzelm@51662
    33
wenzelm@51662
    34
fun lookup_timings timings tr =
wenzelm@51662
    35
  (case approximative_id (Toplevel.name_of tr) (Toplevel.pos_of tr) of
wenzelm@51662
    36
    SOME {file, offset, name} =>
wenzelm@51662
    37
      (case Symtab.lookup timings file of
wenzelm@51662
    38
        SOME offsets =>
wenzelm@51662
    39
          (case Inttab.lookup offsets offset of
wenzelm@51662
    40
            SOME (name', time) => if name = name' then SOME time else NONE
wenzelm@51662
    41
          | NONE => NONE)
wenzelm@51662
    42
      | NONE => NONE)
wenzelm@51662
    43
  | NONE => NONE);
wenzelm@51662
    44
wenzelm@51662
    45
wenzelm@52052
    46
(* session timing *)
wenzelm@52052
    47
wenzelm@52052
    48
fun session_timing name verbose f x =
wenzelm@52052
    49
  let
wenzelm@52052
    50
    val start = Timing.start ();
wenzelm@52052
    51
    val y = f x;
wenzelm@52052
    52
    val timing = Timing.result start;
wenzelm@52052
    53
wenzelm@52052
    54
    val threads = string_of_int (Multithreading.max_threads_value ());
wenzelm@52052
    55
    val factor = Time.toReal (#cpu timing) / Time.toReal (#elapsed timing)
wenzelm@52052
    56
      |> Real.fmt (StringCvt.FIX (SOME 2));
wenzelm@52052
    57
wenzelm@52052
    58
    val timing_props =
wenzelm@52052
    59
      [("threads", threads)] @ Markup.timing_properties timing @ [("factor", factor)];
wenzelm@52052
    60
    val _ = writeln ("\fTiming = " ^ YXML.string_of_body (XML.Encode.properties timing_props));
wenzelm@52052
    61
    val _ =
wenzelm@52052
    62
      if verbose then
wenzelm@52052
    63
        Output.physical_stderr ("Timing " ^ name ^ " (" ^
wenzelm@52052
    64
          threads ^ " threads, " ^ Timing.message timing ^ ", factor " ^ factor ^ ")\n")
wenzelm@52052
    65
      else ();
wenzelm@52052
    66
  in y end;
wenzelm@52052
    67
wenzelm@52052
    68
wenzelm@50683
    69
(* protocol messages *)
wenzelm@50683
    70
wenzelm@51662
    71
fun inline_message a args =
wenzelm@51662
    72
  writeln ("\f" ^ a ^ " = " ^ YXML.string_of_body (XML.Encode.properties args));
wenzelm@50683
    73
wenzelm@50683
    74
fun protocol_message props output =
wenzelm@51216
    75
  (case props of
wenzelm@51216
    76
    function :: args =>
wenzelm@51662
    77
      if function = Markup.ML_statistics orelse function = Markup.task_statistics then
wenzelm@51662
    78
        inline_message (#2 function) args
wenzelm@51662
    79
      else if function = Markup.command_timing then
wenzelm@51662
    80
        let
wenzelm@51662
    81
          val name = the_default "" (Properties.get args Markup.nameN);
wenzelm@51662
    82
          val pos = Position.of_properties args;
wenzelm@51662
    83
          val {elapsed, ...} = Markup.parse_timing_properties args;
wenzelm@51662
    84
        in
wenzelm@51662
    85
          (case approximative_id name pos of
wenzelm@51662
    86
            SOME id => inline_message (#2 function) (Markup.command_timing_properties id elapsed)
wenzelm@51662
    87
          | NONE => ())
wenzelm@51662
    88
        end
wenzelm@51216
    89
      else
wenzelm@51216
    90
        (case Markup.dest_loading_theory props of
wenzelm@51216
    91
          SOME name => writeln ("\floading_theory = " ^ name)
wenzelm@51661
    92
        | NONE => raise Output.Protocol_Message props)
wenzelm@51661
    93
  | [] => raise Output.Protocol_Message props);
wenzelm@51045
    94
wenzelm@50683
    95
wenzelm@50683
    96
(* build *)
wenzelm@50683
    97
wenzelm@48465
    98
local
wenzelm@48465
    99
wenzelm@51217
   100
fun use_theories last_timing options =
wenzelm@54458
   101
  Thy_Info.use_theories {
wenzelm@56614
   102
      document = Present.document_enabled (Options.string options "document"),
wenzelm@54458
   103
      last_timing = last_timing,
wenzelm@54458
   104
      master_dir = Path.current}
wenzelm@48457
   105
    |> Unsynchronized.setmp print_mode
wenzelm@48457
   106
        (space_explode "," (Options.string options "print_mode") @ print_mode_value ())
wenzelm@48457
   107
    |> Unsynchronized.setmp Goal.parallel_proofs (Options.int options "parallel_proofs")
wenzelm@48457
   108
    |> Unsynchronized.setmp Multithreading.trace (Options.int options "threads_trace")
wenzelm@54717
   109
    |> Multithreading.max_threads_setmp (Options.int options "threads")
wenzelm@50698
   110
    |> Unsynchronized.setmp Future.ML_statistics true
wenzelm@48527
   111
    |> Unsynchronized.setmp Pretty.margin_default (Options.int options "pretty_margin")
wenzelm@48492
   112
    |> Unsynchronized.setmp Toplevel.timing (Options.bool options "timing");
wenzelm@48457
   113
wenzelm@51217
   114
fun use_theories_condition last_timing (options, thys) =
wenzelm@48465
   115
  let val condition = space_explode "," (Options.string options "condition") in
wenzelm@48465
   116
    (case filter_out (can getenv_strict) condition of
wenzelm@51941
   117
      [] =>
wenzelm@51941
   118
        (Options.set_default options;
wenzelm@51941
   119
         use_theories last_timing options (map (rpair Position.none) thys))
wenzelm@48465
   120
    | conds =>
wenzelm@48512
   121
        Output.physical_stderr ("Skipping theories " ^ commas_quote thys ^
wenzelm@48477
   122
          " (undefined " ^ commas conds ^ ")\n"))
wenzelm@48465
   123
  end;
wenzelm@48465
   124
wenzelm@48465
   125
in
wenzelm@48465
   126
wenzelm@48681
   127
fun build args_file = Command_Line.tool (fn () =>
wenzelm@48672
   128
    let
wenzelm@53212
   129
      val _ = SHA1_Samples.test ();
wenzelm@53212
   130
wenzelm@51220
   131
      val (command_timings, (do_output, (options, (verbose, (browser_info,
wenzelm@56533
   132
          (document_files, (parent_name, (chapter, (name, theories))))))))) =
wenzelm@48672
   133
        File.read (Path.explode args_file) |> YXML.parse_body |>
wenzelm@48672
   134
          let open XML.Decode in
wenzelm@51218
   135
            pair (list properties) (pair bool (pair Options.decode (pair bool (pair string
wenzelm@56533
   136
              (pair (list (pair string string)) (pair string (pair string (pair string
wenzelm@56533
   137
                ((list (pair Options.decode (list string))))))))))))
wenzelm@48672
   138
          end;
wenzelm@48418
   139
wenzelm@51941
   140
      val _ = Options.set_default options;
wenzelm@51941
   141
wenzelm@50982
   142
      val _ = writeln ("\fSession.name = " ^ name);
wenzelm@49242
   143
      val _ =
wenzelm@51399
   144
        Session.init do_output
wenzelm@51399
   145
          (Options.bool options "browser_info")
wenzelm@51399
   146
          (Path.explode browser_info)
wenzelm@48672
   147
          (Options.string options "document")
wenzelm@48672
   148
          (Options.bool options "document_graph")
wenzelm@48805
   149
          (Options.string options "document_output")
wenzelm@56612
   150
          (Present.document_variants (Options.string options "document_variants"))
wenzelm@56533
   151
          (map (pairself Path.explode) document_files)
wenzelm@51399
   152
          parent_name (chapter, name)
wenzelm@50121
   153
          verbose;
wenzelm@49911
   154
wenzelm@51228
   155
      val last_timing = lookup_timings (fold update_timings command_timings empty_timings);
wenzelm@51218
   156
wenzelm@49911
   157
      val res1 =
wenzelm@48673
   158
        theories |>
wenzelm@51218
   159
          (List.app (use_theories_condition last_timing)
wenzelm@52052
   160
            |> session_timing name verbose
wenzelm@55448
   161
            |> Unsynchronized.setmp Outer_Syntax.batch_mode true
wenzelm@55387
   162
            |> Unsynchronized.setmp Output.protocol_message_fn protocol_message
wenzelm@54717
   163
            |> Multithreading.max_threads_setmp (Options.int options "threads")
wenzelm@49911
   164
            |> Exn.capture);
wenzelm@49911
   165
      val res2 = Exn.capture Session.finish ();
wenzelm@49911
   166
      val _ = Par_Exn.release_all [res1, res2];
wenzelm@48673
   167
wenzelm@51941
   168
      val _ = Options.reset_default ();
wenzelm@48734
   169
      val _ = if do_output then () else exit 0;
wenzelm@48681
   170
    in 0 end);
wenzelm@48418
   171
wenzelm@48418
   172
end;
wenzelm@48465
   173
wenzelm@48465
   174
end;