src/Pure/Thy/export.ML
author wenzelm
Thu, 06 Aug 2020 22:43:40 +0200
changeset 72103 7b318273a4aa
parent 71622 ab5009192ebb
child 72511 460d743010bc
permissions -rw-r--r--
discontinued old batch-build functionality;
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
68090
7c8ed28dd40a tuned signature;
wenzelm
parents:
diff changeset
     1
(*  Title:      Pure/Thy/export.ML
7c8ed28dd40a tuned signature;
wenzelm
parents:
diff changeset
     2
    Author:     Makarius
7c8ed28dd40a tuned signature;
wenzelm
parents:
diff changeset
     3
68102
813b5d0904c6 clarified signature;
wenzelm
parents: 68101
diff changeset
     4
Manage theory exports: compressed blobs.
68090
7c8ed28dd40a tuned signature;
wenzelm
parents:
diff changeset
     5
*)
7c8ed28dd40a tuned signature;
wenzelm
parents:
diff changeset
     6
7c8ed28dd40a tuned signature;
wenzelm
parents:
diff changeset
     7
signature EXPORT =
7c8ed28dd40a tuned signature;
wenzelm
parents:
diff changeset
     8
sig
70051
7a4dc1e60dc8 added command 'compile_generated_files';
wenzelm
parents: 70016
diff changeset
     9
  val report_export: theory -> Path.binding -> unit
70499
f389019024ce allow duplicate exports via strict = false;
wenzelm
parents: 70055
diff changeset
    10
  type params =
f389019024ce allow duplicate exports via strict = false;
wenzelm
parents: 70055
diff changeset
    11
    {theory: theory, binding: Path.binding, executable: bool, compress: bool, strict: bool}
70991
f9f7c34b7dd4 more scalable protocol_message: use XML.body directly (Output.output hook is not required);
wenzelm
parents: 70907
diff changeset
    12
  val export_params: params -> XML.body -> unit
f9f7c34b7dd4 more scalable protocol_message: use XML.body directly (Output.output hook is not required);
wenzelm
parents: 70907
diff changeset
    13
  val export: theory -> Path.binding -> XML.body -> unit
f9f7c34b7dd4 more scalable protocol_message: use XML.body directly (Output.output hook is not required);
wenzelm
parents: 70907
diff changeset
    14
  val export_executable: theory -> Path.binding -> XML.body -> unit
70015
c8e08d8ffb93 clarified signature: more explicit type Path.binding;
wenzelm
parents: 70013
diff changeset
    15
  val export_file: theory -> Path.binding -> Path.T -> unit
c8e08d8ffb93 clarified signature: more explicit type Path.binding;
wenzelm
parents: 70013
diff changeset
    16
  val export_executable_file: theory -> Path.binding -> Path.T -> unit
70009
435fb018e8ee "export_code ... file_prefix ..." is the preferred way to produce output within the logical file-system within the theory context, as well as session exports;
wenzelm
parents: 69788
diff changeset
    17
  val markup: theory -> Path.T -> Markup.T
435fb018e8ee "export_code ... file_prefix ..." is the preferred way to produce output within the logical file-system within the theory context, as well as session exports;
wenzelm
parents: 69788
diff changeset
    18
  val message: theory -> Path.T -> string
68090
7c8ed28dd40a tuned signature;
wenzelm
parents:
diff changeset
    19
end;
7c8ed28dd40a tuned signature;
wenzelm
parents:
diff changeset
    20
7c8ed28dd40a tuned signature;
wenzelm
parents:
diff changeset
    21
structure Export: EXPORT =
7c8ed28dd40a tuned signature;
wenzelm
parents:
diff changeset
    22
struct
7c8ed28dd40a tuned signature;
wenzelm
parents:
diff changeset
    23
69648
97ddaec3e2ae support hyperlink to theory exports;
wenzelm
parents: 69627
diff changeset
    24
(* export *)
97ddaec3e2ae support hyperlink to theory exports;
wenzelm
parents: 69627
diff changeset
    25
70051
7a4dc1e60dc8 added command 'compile_generated_files';
wenzelm
parents: 70016
diff changeset
    26
fun report_export thy binding =
7a4dc1e60dc8 added command 'compile_generated_files';
wenzelm
parents: 70016
diff changeset
    27
  let
7a4dc1e60dc8 added command 'compile_generated_files';
wenzelm
parents: 70016
diff changeset
    28
    val theory_name = Context.theory_long_name thy;
7a4dc1e60dc8 added command 'compile_generated_files';
wenzelm
parents: 70016
diff changeset
    29
    val (path, pos) = Path.dest_binding binding;
7a4dc1e60dc8 added command 'compile_generated_files';
wenzelm
parents: 70016
diff changeset
    30
    val markup = Markup.export_path (Path.implode (Path.append (Path.basic theory_name) path));
7a4dc1e60dc8 added command 'compile_generated_files';
wenzelm
parents: 70016
diff changeset
    31
  in Context_Position.report_generic (Context.Theory thy) pos markup end;
7a4dc1e60dc8 added command 'compile_generated_files';
wenzelm
parents: 70016
diff changeset
    32
70499
f389019024ce allow duplicate exports via strict = false;
wenzelm
parents: 70055
diff changeset
    33
type params =
f389019024ce allow duplicate exports via strict = false;
wenzelm
parents: 70055
diff changeset
    34
  {theory: theory, binding: Path.binding, executable: bool, compress: bool, strict: bool};
68105
577072a0ceed more checks;
wenzelm
parents: 68102
diff changeset
    35
70991
f9f7c34b7dd4 more scalable protocol_message: use XML.body directly (Output.output hook is not required);
wenzelm
parents: 70907
diff changeset
    36
fun export_params ({theory = thy, binding, executable, compress, strict}: params) body =
70051
7a4dc1e60dc8 added command 'compile_generated_files';
wenzelm
parents: 70016
diff changeset
    37
 (report_export thy binding;
7a4dc1e60dc8 added command 'compile_generated_files';
wenzelm
parents: 70016
diff changeset
    38
  (Output.try_protocol_message o Markup.export)
7a4dc1e60dc8 added command 'compile_generated_files';
wenzelm
parents: 70016
diff changeset
    39
   {id = Position.get_id (Position.thread_data ()),
7a4dc1e60dc8 added command 'compile_generated_files';
wenzelm
parents: 70016
diff changeset
    40
    serial = serial (),
7a4dc1e60dc8 added command 'compile_generated_files';
wenzelm
parents: 70016
diff changeset
    41
    theory_name = Context.theory_long_name thy,
70055
36fb663145e5 type Path.binding may be empty: check later via proper_binding;
wenzelm
parents: 70051
diff changeset
    42
    name = Path.implode_binding (tap Path.proper_binding binding),
70051
7a4dc1e60dc8 added command 'compile_generated_files';
wenzelm
parents: 70016
diff changeset
    43
    executable = executable,
70499
f389019024ce allow duplicate exports via strict = false;
wenzelm
parents: 70055
diff changeset
    44
    compress = compress,
70991
f9f7c34b7dd4 more scalable protocol_message: use XML.body directly (Output.output hook is not required);
wenzelm
parents: 70907
diff changeset
    45
    strict = strict} body);
68090
7c8ed28dd40a tuned signature;
wenzelm
parents:
diff changeset
    46
70991
f9f7c34b7dd4 more scalable protocol_message: use XML.body directly (Output.output hook is not required);
wenzelm
parents: 70907
diff changeset
    47
fun export thy binding body =
70499
f389019024ce allow duplicate exports via strict = false;
wenzelm
parents: 70055
diff changeset
    48
  export_params
70991
f9f7c34b7dd4 more scalable protocol_message: use XML.body directly (Output.output hook is not required);
wenzelm
parents: 70907
diff changeset
    49
    {theory = thy, binding = binding, executable = false, compress = true, strict = true} body;
69788
c175499a7537 added executable flag for exports;
wenzelm
parents: 69784
diff changeset
    50
70991
f9f7c34b7dd4 more scalable protocol_message: use XML.body directly (Output.output hook is not required);
wenzelm
parents: 70907
diff changeset
    51
fun export_executable thy binding body =
70499
f389019024ce allow duplicate exports via strict = false;
wenzelm
parents: 70055
diff changeset
    52
  export_params
70991
f9f7c34b7dd4 more scalable protocol_message: use XML.body directly (Output.output hook is not required);
wenzelm
parents: 70907
diff changeset
    53
    {theory = thy, binding = binding, executable = true, compress = true, strict = true} body;
70013
6de8b7a5cd44 tuned signature -- more operations;
wenzelm
parents: 70011
diff changeset
    54
70991
f9f7c34b7dd4 more scalable protocol_message: use XML.body directly (Output.output hook is not required);
wenzelm
parents: 70907
diff changeset
    55
fun export_file thy binding file =
f9f7c34b7dd4 more scalable protocol_message: use XML.body directly (Output.output hook is not required);
wenzelm
parents: 70907
diff changeset
    56
  export thy binding [XML.Text (File.read file)];
f9f7c34b7dd4 more scalable protocol_message: use XML.body directly (Output.output hook is not required);
wenzelm
parents: 70907
diff changeset
    57
f9f7c34b7dd4 more scalable protocol_message: use XML.body directly (Output.output hook is not required);
wenzelm
parents: 70907
diff changeset
    58
fun export_executable_file thy binding file =
f9f7c34b7dd4 more scalable protocol_message: use XML.body directly (Output.output hook is not required);
wenzelm
parents: 70907
diff changeset
    59
  export_executable thy binding [XML.Text (File.read file)];
68090
7c8ed28dd40a tuned signature;
wenzelm
parents:
diff changeset
    60
69648
97ddaec3e2ae support hyperlink to theory exports;
wenzelm
parents: 69627
diff changeset
    61
97ddaec3e2ae support hyperlink to theory exports;
wenzelm
parents: 69627
diff changeset
    62
(* information message *)
97ddaec3e2ae support hyperlink to theory exports;
wenzelm
parents: 69627
diff changeset
    63
70009
435fb018e8ee "export_code ... file_prefix ..." is the preferred way to produce output within the logical file-system within the theory context, as well as session exports;
wenzelm
parents: 69788
diff changeset
    64
fun markup thy path =
435fb018e8ee "export_code ... file_prefix ..." is the preferred way to produce output within the logical file-system within the theory context, as well as session exports;
wenzelm
parents: 69788
diff changeset
    65
  let
435fb018e8ee "export_code ... file_prefix ..." is the preferred way to produce output within the logical file-system within the theory context, as well as session exports;
wenzelm
parents: 69788
diff changeset
    66
    val thy_path = Path.append (Path.basic (Context.theory_long_name thy)) path;
435fb018e8ee "export_code ... file_prefix ..." is the preferred way to produce output within the logical file-system within the theory context, as well as session exports;
wenzelm
parents: 69788
diff changeset
    67
    val name = (Markup.nameN, Path.implode thy_path);
69650
c95edf19133b clarified message;
wenzelm
parents: 69648
diff changeset
    68
  in Active.make_markup Markup.theory_exportsN {implicit = false, properties = [name]} end;
69648
97ddaec3e2ae support hyperlink to theory exports;
wenzelm
parents: 69627
diff changeset
    69
70009
435fb018e8ee "export_code ... file_prefix ..." is the preferred way to produce output within the logical file-system within the theory context, as well as session exports;
wenzelm
parents: 69788
diff changeset
    70
fun message thy path =
435fb018e8ee "export_code ... file_prefix ..." is the preferred way to produce output within the logical file-system within the theory context, as well as session exports;
wenzelm
parents: 69788
diff changeset
    71
  "See " ^ Markup.markup (markup thy path) "theory exports";
69648
97ddaec3e2ae support hyperlink to theory exports;
wenzelm
parents: 69627
diff changeset
    72
68090
7c8ed28dd40a tuned signature;
wenzelm
parents:
diff changeset
    73
end;