(*  Title:      Pure/System/session.ML

     Author:     Markus Wenzel, TU Muenchen

 Session management -- maintain state of logic images.

 *)

 signature SESSION =

 sig

   val id: unit -> string list

   val name: unit -> string

   val welcome: unit -> string

   val finish: unit -> unit

   val init: bool -> bool -> bool -> string -> string -> bool -> string list ->

     string -> string -> string * string -> string -> bool -> unit

   val with_timing: string -> bool -> ('a -> 'b) -> 'a -> 'b

   val use_dir: string -> string -> bool -> string list -> bool -> bool -> string ->

     string -> bool -> string list -> string -> string -> bool * string ->

     string -> int -> bool -> bool -> int -> int -> int -> int -> unit

 end;

 structure Session: SESSION =

 struct

 (* session state *)

 val session = Unsynchronized.ref ([Context.PureN]: string list);

 val session_path = Unsynchronized.ref ([]: string list);

 val session_finished = Unsynchronized.ref false;

 val remote_path = Unsynchronized.ref (NONE: Url.T option);

 (* access path *)

 fun id () = ! session;

 fun path () = ! session_path;

 fun str_of [] = Context.PureN

   | str_of elems = space_implode "/" elems;

 fun name () = "Isabelle/" ^ str_of (path ());

 (* welcome *)

 fun welcome () =

   if Distribution.is_official then

     "Welcome to " ^ name () ^ " (" ^ Distribution.version ^ ")"

   else

     "Unofficial version of " ^ name () ^ " (" ^ Distribution.version ^ ")" ^

     (if Distribution.changelog <> "" then "\nSee also " ^ Distribution.changelog else "");

 val _ =

   Outer_Syntax.improper_command ("welcome", Keyword.diag) "print welcome message"

     (Scan.succeed (Toplevel.no_timing o Toplevel.imperative (writeln o welcome)));

 (* add_path *)

 fun add_path reset s =

   let val sess = ! session @ [s] in

     (case duplicates (op =) sess of

       [] => (session := sess; session_path := ((if reset then [] else ! session_path) @ [s]))

     | dups => error ("Duplicate session identifiers " ^ commas_quote dups ^ " in " ^ str_of sess))

   end;

 (* init_name *)

 fun init_name reset parent name =

   if not (member (op =) (! session) parent) orelse not (! session_finished) then

     error ("Unfinished parent session " ^ quote parent ^ " for " ^ quote name)

   else (add_path reset name; session_finished := false);

 (* finish *)

 fun finish () =

   (Thy_Info.finish ();

     Present.finish ();

     Outer_Syntax.check_syntax ();

     Future.shutdown ();

     session_finished := true);

 (* use_dir *)

 fun with_timing _ false f x = f x

   | with_timing item true f x =

       let

         val start = Timing.start ();

         val y = f x;

         val timing = Timing.result start;

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

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

         val _ =

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

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

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

       in y end;

 fun get_rpath rpath =

   (if rpath = "" then () else

      if is_some (! remote_path) then

        error "Path for remote theory browsing information may only be set once"

      else

        remote_path := SOME (Url.explode rpath);

    (! remote_path, rpath <> ""));

 fun init build reset info info_path doc doc_graph doc_variants parent name doc_dump rpath verbose =

  (init_name reset parent name;

   Present.init build info info_path (if doc = "false" then "" else doc) doc_graph doc_variants

     (path ()) name doc_dump (get_rpath rpath) verbose

     (map Thy_Info.get_theory (Thy_Info.get_names ())));

 local

 fun doc_dump (cp, dump) = (dump, if cp then "all" else "tex+sty");

 in

 fun use_dir item root build modes reset info info_path doc doc_graph doc_variants parent

     name dump rpath level timing verbose max_threads trace_threads

     parallel_proofs parallel_proofs_threshold =

   ((fn () =>

      (init build reset info info_path doc doc_graph doc_variants parent name

         (doc_dump dump) rpath verbose;

       with_timing item timing use root;

       finish ()))

     |> Unsynchronized.setmp Proofterm.proofs level

     |> Unsynchronized.setmp print_mode (modes @ print_mode_value ())

     |> Unsynchronized.setmp Goal.parallel_proofs parallel_proofs

     |> Unsynchronized.setmp Goal.parallel_proofs_threshold parallel_proofs_threshold

     |> Unsynchronized.setmp Multithreading.trace trace_threads

     |> Unsynchronized.setmp Multithreading.max_threads

       (if Multithreading.available then max_threads

        else (if max_threads = 1 then () else warning "Multithreading support unavailable"; 1))) ()

   handle exn => (Output.error_msg (ML_Compiler.exn_message exn); exit 1);

 end;

 end;