src/Pure/General/pretty.scala
author wenzelm
Sun, 30 May 2010 14:14:30 +0200
changeset 37192 8cdddd689ea9
parent 36820 0cdfce0bf956
child 37374 d66e6cc47fab
permissions -rw-r--r--
markup non-identifier keyword as operator;
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
36683
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
     1
/*  Title:      Pure/General/pretty.scala
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
     2
    Author:     Makarius
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
     3
36687
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
     4
Generic pretty printing module.
36683
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
     5
*/
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
     6
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
     7
package isabelle
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
     8
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
     9
36820
0cdfce0bf956 clarified Pretty.font_metrics;
wenzelm
parents: 36818
diff changeset
    10
import java.awt.FontMetrics
0cdfce0bf956 clarified Pretty.font_metrics;
wenzelm
parents: 36818
diff changeset
    11
0cdfce0bf956 clarified Pretty.font_metrics;
wenzelm
parents: 36818
diff changeset
    12
36683
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    13
object Pretty
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    14
{
36687
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
    15
  /* markup trees with physical blocks and breaks */
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
    16
36683
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    17
  object Block
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    18
  {
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    19
    def apply(indent: Int, body: List[XML.Tree]): XML.Tree =
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    20
      XML.Elem(Markup.BLOCK, List((Markup.INDENT, indent.toString)), body)
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    21
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    22
    def unapply(tree: XML.Tree): Option[(Int, List[XML.Tree])] =
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    23
      tree match {
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    24
        case XML.Elem(Markup.BLOCK, List((Markup.INDENT, indent)), body) =>
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    25
          Markup.parse_int(indent) match {
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    26
            case Some(i) => Some((i, body))
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    27
            case None => None
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    28
          }
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    29
        case _ => None
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    30
      }
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    31
  }
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    32
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    33
  object Break
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    34
  {
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    35
    def apply(width: Int): XML.Tree =
36763
096ebe74aeaf static Symbol.spaces;
wenzelm
parents: 36745
diff changeset
    36
      XML.Elem(Markup.BREAK, List((Markup.WIDTH, width.toString)),
096ebe74aeaf static Symbol.spaces;
wenzelm
parents: 36745
diff changeset
    37
        List(XML.Text(Symbol.spaces(width))))
36683
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    38
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    39
    def unapply(tree: XML.Tree): Option[Int] =
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    40
      tree match {
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    41
        case XML.Elem(Markup.BREAK, List((Markup.WIDTH, width)), _) => Markup.parse_int(width)
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    42
        case _ => None
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    43
      }
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    44
  }
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
    45
36689
379f5b1e7f91 replaced slightly odd fbreak markup by plain "\n", which also coincides with regular linebreaks produced outside the ML pretty engine;
wenzelm
parents: 36687
diff changeset
    46
  val FBreak = XML.Text("\n")
36687
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
    47
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
    48
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
    49
  /* formatted output */
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
    50
36734
d9b10c173330 Pretty.formatted operates directly on XML trees, treating XML.Elem like a pro-forma block of indentation 0, like the ML version;
wenzelm
parents: 36689
diff changeset
    51
  private def standard_format(tree: XML.Tree): List[XML.Tree] =
36689
379f5b1e7f91 replaced slightly odd fbreak markup by plain "\n", which also coincides with regular linebreaks produced outside the ML pretty engine;
wenzelm
parents: 36687
diff changeset
    52
    tree match {
36734
d9b10c173330 Pretty.formatted operates directly on XML trees, treating XML.Elem like a pro-forma block of indentation 0, like the ML version;
wenzelm
parents: 36689
diff changeset
    53
      case XML.Elem(name, atts, body) => List(XML.Elem(name, atts, body.flatMap(standard_format)))
36689
379f5b1e7f91 replaced slightly odd fbreak markup by plain "\n", which also coincides with regular linebreaks produced outside the ML pretty engine;
wenzelm
parents: 36687
diff changeset
    54
      case XML.Text(text) =>
379f5b1e7f91 replaced slightly odd fbreak markup by plain "\n", which also coincides with regular linebreaks produced outside the ML pretty engine;
wenzelm
parents: 36687
diff changeset
    55
        Library.separate(FBreak,
379f5b1e7f91 replaced slightly odd fbreak markup by plain "\n", which also coincides with regular linebreaks produced outside the ML pretty engine;
wenzelm
parents: 36687
diff changeset
    56
          Library.chunks(text).toList.map((s: CharSequence) => XML.Text(s.toString)))
379f5b1e7f91 replaced slightly odd fbreak markup by plain "\n", which also coincides with regular linebreaks produced outside the ML pretty engine;
wenzelm
parents: 36687
diff changeset
    57
    }
379f5b1e7f91 replaced slightly odd fbreak markup by plain "\n", which also coincides with regular linebreaks produced outside the ML pretty engine;
wenzelm
parents: 36687
diff changeset
    58
36817
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    59
  case class Text(tx: List[XML.Tree] = Nil, val pos: Double = 0.0, val nl: Int = 0)
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    60
  {
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    61
    def newline: Text = copy(tx = FBreak :: tx, pos = 0.0, nl = nl + 1)
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    62
    def string(s: String, len: Double): Text = copy(tx = XML.Text(s) :: tx, pos = pos + len)
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    63
    def blanks(wd: Int): Text = string(Symbol.spaces(wd), wd.toDouble)
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    64
    def content: List[XML.Tree] = tx.reverse
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    65
  }
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    66
36745
403585a89772 unified/simplified Pretty.margin_default;
wenzelm
parents: 36736
diff changeset
    67
  private val margin_default = 76
36818
wenzelm
parents: 36817
diff changeset
    68
  private def metric_default(s: String) = s.length.toDouble
36734
d9b10c173330 Pretty.formatted operates directly on XML trees, treating XML.Elem like a pro-forma block of indentation 0, like the ML version;
wenzelm
parents: 36689
diff changeset
    69
36820
0cdfce0bf956 clarified Pretty.font_metrics;
wenzelm
parents: 36818
diff changeset
    70
  def font_metric(metrics: FontMetrics): String => Double =
0cdfce0bf956 clarified Pretty.font_metrics;
wenzelm
parents: 36818
diff changeset
    71
    if (metrics == null) ((s: String) => s.length.toDouble)
0cdfce0bf956 clarified Pretty.font_metrics;
wenzelm
parents: 36818
diff changeset
    72
    else {
0cdfce0bf956 clarified Pretty.font_metrics;
wenzelm
parents: 36818
diff changeset
    73
      val unit = metrics.charWidth(Symbol.spc).toDouble
0cdfce0bf956 clarified Pretty.font_metrics;
wenzelm
parents: 36818
diff changeset
    74
      ((s: String) => if (s == "\n") 1.0 else metrics.stringWidth(s) / unit)
0cdfce0bf956 clarified Pretty.font_metrics;
wenzelm
parents: 36818
diff changeset
    75
    }
0cdfce0bf956 clarified Pretty.font_metrics;
wenzelm
parents: 36818
diff changeset
    76
36817
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    77
  def formatted(input: List[XML.Tree], margin: Int = margin_default,
36818
wenzelm
parents: 36817
diff changeset
    78
    metric: String => Double = metric_default): List[XML.Tree] =
36687
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
    79
  {
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
    80
    val breakgain = margin / 20
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
    81
    val emergencypos = margin / 2
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
    82
36817
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    83
    def content_length(tree: XML.Tree): Double =
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    84
      tree match {
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    85
        case XML.Elem(_, _, body) => (0.0 /: body)(_ + content_length(_))
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    86
        case XML.Text(s) => metric(s)
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    87
      }
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    88
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    89
    def breakdist(trees: List[XML.Tree], after: Double): Double =
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    90
      trees match {
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    91
        case Break(_) :: _ => 0.0
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    92
        case FBreak :: _ => 0.0
36818
wenzelm
parents: 36817
diff changeset
    93
        case t :: ts => content_length(t) + breakdist(ts, after)
36817
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    94
        case Nil => after
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    95
      }
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    96
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    97
    def forcenext(trees: List[XML.Tree]): List[XML.Tree] =
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    98
      trees match {
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
    99
        case Nil => Nil
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
   100
        case FBreak :: _ => trees
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
   101
        case Break(_) :: ts => FBreak :: ts
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
   102
        case t :: ts => t :: forcenext(ts)
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
   103
      }
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
   104
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
   105
    def format(trees: List[XML.Tree], blockin: Double, after: Double, text: Text): Text =
36687
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   106
      trees match {
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   107
        case Nil => text
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   108
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   109
        case Block(indent, body) :: ts =>
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   110
          val pos1 = text.pos + indent
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   111
          val pos2 = pos1 % emergencypos
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   112
          val blockin1 =
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   113
            if (pos1 < emergencypos) pos1
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   114
            else pos2
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   115
          val btext = format(body, blockin1, breakdist(ts, after), text)
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   116
          val ts1 = if (text.nl < btext.nl) forcenext(ts) else ts
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   117
          format(ts1, blockin, after, btext)
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   118
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   119
        case Break(wd) :: ts =>
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   120
          if (text.pos + wd <= (margin - breakdist(ts, after)).max(blockin + breakgain))
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   121
            format(ts, blockin, after, text.blanks(wd))
36817
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
   122
          else format(ts, blockin, after, text.newline.blanks(blockin.toInt))
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
   123
        case FBreak :: ts => format(ts, blockin, after, text.newline.blanks(blockin.toInt))
36687
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   124
36734
d9b10c173330 Pretty.formatted operates directly on XML trees, treating XML.Elem like a pro-forma block of indentation 0, like the ML version;
wenzelm
parents: 36689
diff changeset
   125
        case XML.Elem(name, atts, body) :: ts =>
d9b10c173330 Pretty.formatted operates directly on XML trees, treating XML.Elem like a pro-forma block of indentation 0, like the ML version;
wenzelm
parents: 36689
diff changeset
   126
          val btext = format(body, blockin, breakdist(ts, after), text.copy(tx = Nil))
d9b10c173330 Pretty.formatted operates directly on XML trees, treating XML.Elem like a pro-forma block of indentation 0, like the ML version;
wenzelm
parents: 36689
diff changeset
   127
          val ts1 = if (text.nl < btext.nl) forcenext(ts) else ts
d9b10c173330 Pretty.formatted operates directly on XML trees, treating XML.Elem like a pro-forma block of indentation 0, like the ML version;
wenzelm
parents: 36689
diff changeset
   128
          val btext1 = btext.copy(tx = XML.Elem(name, atts, btext.content) :: text.tx)
d9b10c173330 Pretty.formatted operates directly on XML trees, treating XML.Elem like a pro-forma block of indentation 0, like the ML version;
wenzelm
parents: 36689
diff changeset
   129
          format(ts1, blockin, after, btext1)
36817
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
   130
        case XML.Text(s) :: ts => format(ts, blockin, after, text.string(s, metric(s)))
36687
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   131
      }
36817
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
   132
    format(input.flatMap(standard_format), 0.0, 0.0, Text()).content
36687
58020b59baf7 basic formatting of pretty trees;
wenzelm
parents: 36683
diff changeset
   133
  }
36734
d9b10c173330 Pretty.formatted operates directly on XML trees, treating XML.Elem like a pro-forma block of indentation 0, like the ML version;
wenzelm
parents: 36689
diff changeset
   134
36818
wenzelm
parents: 36817
diff changeset
   135
  def string_of(input: List[XML.Tree], margin: Int = margin_default,
wenzelm
parents: 36817
diff changeset
   136
      metric: String => Double = metric_default): String =
36736
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   137
    formatted(input).iterator.flatMap(XML.content).mkString
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   138
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   139
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   140
  /* unformatted output */
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   141
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   142
  def unformatted(input: List[XML.Tree]): List[XML.Tree] =
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   143
  {
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   144
    def fmt(tree: XML.Tree): List[XML.Tree] =
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   145
      tree match {
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   146
        case Block(_, body) => body.flatMap(fmt)
36763
096ebe74aeaf static Symbol.spaces;
wenzelm
parents: 36745
diff changeset
   147
        case Break(wd) => List(XML.Text(Symbol.spaces(wd)))
36817
ed97e877ff2d more precise pretty printing based on actual font metrics;
wenzelm
parents: 36763
diff changeset
   148
        case FBreak => List(XML.Text(Symbol.space))
36736
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   149
        case XML.Elem(name, atts, body) => List(XML.Elem(name, atts, body.flatMap(fmt)))
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   150
        case XML.Text(_) => List(tree)
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   151
      }
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   152
    input.flatMap(standard_format).flatMap(fmt)
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   153
  }
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   154
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   155
  def str_of(input: List[XML.Tree]): String =
93753a8c9550 unformatted output;
wenzelm
parents: 36734
diff changeset
   156
    unformatted(input).iterator.flatMap(XML.content).mkString
36683
41a1210519fd basic support for symbolic pretty printing;
wenzelm
parents:
diff changeset
   157
}