src/Pure/Tools/update_cartouches.scala
author paulson <lp15@cam.ac.uk>
Wed, 24 Apr 2024 20:56:26 +0100
changeset 80149 40a3fc07a587
parent 75906 2167b9e3157a
permissions -rw-r--r--
More tidying of proofs
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
58610
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
     1
/*  Title:      Pure/Tools/update_cartouches.scala
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
     2
    Author:     Makarius
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
     3
61579
634cd44bb1d3 symbolic syntax "\<comment> text";
wenzelm
parents: 61492
diff changeset
     4
Update theory syntax to use cartouches etc.
58610
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
     5
*/
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
     6
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
     7
package isabelle
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
     8
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
     9
71601
97ccf48c2f0c misc tuning based on hints by IntelliJ IDEA;
wenzelm
parents: 69271
diff changeset
    10
import scala.util.matching.Regex
97ccf48c2f0c misc tuning based on hints by IntelliJ IDEA;
wenzelm
parents: 69271
diff changeset
    11
97ccf48c2f0c misc tuning based on hints by IntelliJ IDEA;
wenzelm
parents: 69271
diff changeset
    12
75393
87ebf5a50283 clarified formatting, for the sake of scala3;
wenzelm
parents: 74887
diff changeset
    13
object Update_Cartouches {
58610
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
    14
  /* update cartouches */
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
    15
71601
97ccf48c2f0c misc tuning based on hints by IntelliJ IDEA;
wenzelm
parents: 69271
diff changeset
    16
  val Text_Antiq: Regex = """(?s)@\{\s*text\b\s*(.+)\}""".r
61492
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    17
75393
87ebf5a50283 clarified formatting, for the sake of scala3;
wenzelm
parents: 74887
diff changeset
    18
  def update_text(content: String): String = {
61492
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    19
    (try { Some(Antiquote.read(content)) } catch { case ERROR(_) => None }) match {
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    20
      case Some(ants) =>
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    21
        val ants1: List[Antiquote.Antiquote] =
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    22
          ants.map(ant =>
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    23
            ant match {
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    24
              case Antiquote.Antiq(Text_Antiq(body)) =>
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    25
                Token.explode(Keyword.Keywords.empty, body).filterNot(_.is_space) match {
67131
85d10959c2e4 tuned signature;
wenzelm
parents: 62836
diff changeset
    26
                  case List(tok) => Antiquote.Control(Symbol.cartouche(tok.content))
61492
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    27
                  case _ => ant
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    28
                }
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    29
              case _ => ant
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    30
            })
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    31
        if (ants == ants1) content else ants1.map(_.source).mkString
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    32
      case None => content
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    33
    }
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    34
  }
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    35
75393
87ebf5a50283 clarified formatting, for the sake of scala3;
wenzelm
parents: 74887
diff changeset
    36
  def update_cartouches(replace_text: Boolean, path: Path): Unit = {
58610
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
    37
    val text0 = File.read(path)
61492
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    38
67433
e0c0c1f0e3e7 more specific tool "isabelle update_comments", for uniformity with formal comments in embedded languages;
wenzelm
parents: 67131
diff changeset
    39
    // outer syntax cartouches
58610
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
    40
    val text1 =
59083
88b0b1f28adc tuned signature;
wenzelm
parents: 58610
diff changeset
    41
      (for (tok <- Token.explode(Keyword.Keywords.empty, text0).iterator)
58610
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
    42
        yield {
67131
85d10959c2e4 tuned signature;
wenzelm
parents: 62836
diff changeset
    43
          if (tok.kind == Token.Kind.ALT_STRING) Symbol.cartouche(tok.content)
58610
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
    44
          else tok.source
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
    45
        }
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
    46
      ).mkString
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
    47
61492
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    48
    // cartouches within presumed text tokens
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    49
    val text2 =
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    50
      if (replace_text) {
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    51
        (for (tok <- Token.explode(Keyword.Keywords.empty, text1).iterator)
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    52
          yield {
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    53
            if (tok.kind == Token.Kind.STRING || tok.kind == Token.Kind.CARTOUCHE) {
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    54
              val content = tok.content
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    55
              val content1 = update_text(content)
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    56
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    57
              if (content == content1) tok.source
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    58
              else if (tok.kind == Token.Kind.STRING) Outer_Syntax.quote_string(content1)
67131
85d10959c2e4 tuned signature;
wenzelm
parents: 62836
diff changeset
    59
              else Symbol.cartouche(content1)
61492
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    60
            }
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    61
            else tok.source
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    62
          }).mkString
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    63
      }
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    64
      else text1
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    65
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    66
    if (text0 != text2) {
58610
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
    67
      Output.writeln("changing " + path)
61492
3480725c71d2 added isabelle update_cartouches option -t;
wenzelm
parents: 59083
diff changeset
    68
      File.write_backup2(path, text2)
58610
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
    69
    }
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
    70
  }
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
    71
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
    72
62836
98dbed6cfa44 prefer internal tool;
wenzelm
parents: 62454
diff changeset
    73
  /* Isabelle tool wrapper */
58610
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
    74
62836
98dbed6cfa44 prefer internal tool;
wenzelm
parents: 62454
diff changeset
    75
  val isabelle_tool =
72763
3cc73d00553c added document antiquotation @{tool};
wenzelm
parents: 71601
diff changeset
    76
    Isabelle_Tool("update_cartouches", "update theory syntax to use cartouches",
75393
87ebf5a50283 clarified formatting, for the sake of scala3;
wenzelm
parents: 74887
diff changeset
    77
      Scala_Project.here,
75394
42267c650205 tuned formatting;
wenzelm
parents: 75393
diff changeset
    78
      { args =>
42267c650205 tuned formatting;
wenzelm
parents: 75393
diff changeset
    79
        var replace_text = false
62445
91902961184c moved getopts to Scala;
wenzelm
parents: 61579
diff changeset
    80
75394
42267c650205 tuned formatting;
wenzelm
parents: 75393
diff changeset
    81
        val getopts = Getopts("""
62445
91902961184c moved getopts to Scala;
wenzelm
parents: 61579
diff changeset
    82
Usage: isabelle update_cartouches [FILES|DIRS...]
91902961184c moved getopts to Scala;
wenzelm
parents: 61579
diff changeset
    83
91902961184c moved getopts to Scala;
wenzelm
parents: 61579
diff changeset
    84
  Options are:
91902961184c moved getopts to Scala;
wenzelm
parents: 61579
diff changeset
    85
    -t           replace @{text} antiquotations within text tokens
91902961184c moved getopts to Scala;
wenzelm
parents: 61579
diff changeset
    86
69271
4cb70e7e36b9 update ROOT files as well: treated like .thy in Isabelle/jEdit;
wenzelm
parents: 68994
diff changeset
    87
  Recursively find .thy or ROOT files and update theory syntax to use
74887
56247fdb8bbb discontinued old-style {* verbatim *} tokens;
wenzelm
parents: 73340
diff changeset
    88
  cartouches instead of `alt_string` tokens.
62445
91902961184c moved getopts to Scala;
wenzelm
parents: 61579
diff changeset
    89
91902961184c moved getopts to Scala;
wenzelm
parents: 61579
diff changeset
    90
  Old versions of files are preserved by appending "~~".
91902961184c moved getopts to Scala;
wenzelm
parents: 61579
diff changeset
    91
""",
75394
42267c650205 tuned formatting;
wenzelm
parents: 75393
diff changeset
    92
          "t" -> (_ => replace_text = true))
62445
91902961184c moved getopts to Scala;
wenzelm
parents: 61579
diff changeset
    93
75394
42267c650205 tuned formatting;
wenzelm
parents: 75393
diff changeset
    94
        val specs = getopts(args)
42267c650205 tuned formatting;
wenzelm
parents: 75393
diff changeset
    95
        if (specs.isEmpty) getopts.usage()
62445
91902961184c moved getopts to Scala;
wenzelm
parents: 61579
diff changeset
    96
75394
42267c650205 tuned formatting;
wenzelm
parents: 75393
diff changeset
    97
        for {
42267c650205 tuned formatting;
wenzelm
parents: 75393
diff changeset
    98
          spec <- specs
42267c650205 tuned formatting;
wenzelm
parents: 75393
diff changeset
    99
          file <- File.find_files(Path.explode(spec).file,
75906
2167b9e3157a clarified signature: support for adhoc file types;
wenzelm
parents: 75394
diff changeset
   100
            file => File.is_thy(file.getName) || file.getName == "ROOT")
75394
42267c650205 tuned formatting;
wenzelm
parents: 75393
diff changeset
   101
        } update_cartouches(replace_text, File.path(file))
42267c650205 tuned formatting;
wenzelm
parents: 75393
diff changeset
   102
      })
58610
fffdbce036db added update_cartouches tool;
wenzelm
parents:
diff changeset
   103
}