mirror of
https://github.com/golang/go
synced 2024-11-20 10:54:49 -07:00
732b53a1fe
way to integrate comments into the generated output - various simplificatins and cleanups throughout R=r OCL=20062 CL=20062
682 lines
12 KiB
Go
682 lines
12 KiB
Go
// Copyright 2009 The Go Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
package Printer
|
|
|
|
import (
|
|
"os";
|
|
"array";
|
|
"tabwriter";
|
|
"flag";
|
|
"fmt";
|
|
Scanner "scanner";
|
|
AST "ast";
|
|
)
|
|
|
|
var (
|
|
tabwidth = flag.Int("tabwidth", 4, nil, "tab width");
|
|
usetabs = flag.Bool("usetabs", true, nil, "align with tabs instead of blanks");
|
|
comments = flag.Bool("comments", false, nil, "enable printing of comments");
|
|
)
|
|
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// Support
|
|
|
|
func assert(p bool) {
|
|
if !p {
|
|
panic("assert failed");
|
|
}
|
|
}
|
|
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// Printer
|
|
|
|
type Printer struct {
|
|
// output
|
|
writer *tabwriter.Writer;
|
|
|
|
// comments
|
|
comments *array.Array;
|
|
cindex int;
|
|
cpos int;
|
|
|
|
// formatting control
|
|
lastpos int; // pos after last string
|
|
level int; // true scope level
|
|
indent int; // indentation level
|
|
semi bool; // pending ";"
|
|
newl int; // pending "\n"'s
|
|
}
|
|
|
|
|
|
func (P *Printer) NextComment() {
|
|
P.cindex++;
|
|
if P.comments != nil && P.cindex < P.comments.Len() {
|
|
P.cpos = P.comments.At(P.cindex).(*AST.Comment).pos;
|
|
} else {
|
|
P.cpos = 1<<30; // infinite
|
|
}
|
|
}
|
|
|
|
|
|
func (P *Printer) Init(writer *tabwriter.Writer, comments *array.Array) {
|
|
// writer
|
|
padchar := byte(' ');
|
|
if usetabs.BVal() {
|
|
padchar = '\t';
|
|
}
|
|
P.writer = tabwriter.New(os.Stdout, int(tabwidth.IVal()), 1, padchar, true);
|
|
|
|
// comments
|
|
P.comments = comments;
|
|
P.cindex = -1;
|
|
P.NextComment();
|
|
|
|
// formatting control initialized correctly by default
|
|
}
|
|
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// Printing support
|
|
|
|
func (P *Printer) Printf(format string, s ...) {
|
|
n, err := fmt.fprintf(P.writer, format, s);
|
|
if err != nil {
|
|
panic("print error - exiting");
|
|
}
|
|
P.lastpos += n;
|
|
}
|
|
|
|
|
|
func (P *Printer) String(pos int, s string) {
|
|
if pos == 0 {
|
|
pos = P.lastpos; // estimate
|
|
}
|
|
P.lastpos = pos;
|
|
|
|
if P.semi && P.level > 0 { // no semicolons at level 0
|
|
P.Printf(";");
|
|
}
|
|
|
|
//print("--", pos, "[", s, "]\n");
|
|
|
|
src_nl := 0;
|
|
at_line_begin := false;
|
|
for comments.BVal() && P.cpos < pos {
|
|
//print("cc", P.cpos, "\n");
|
|
|
|
// we have a comment/newline that comes before s
|
|
comment := P.comments.At(P.cindex).(*AST.Comment);
|
|
ctext := comment.text;
|
|
|
|
if ctext == "\n" {
|
|
// found a newline in src
|
|
src_nl++;
|
|
|
|
} else {
|
|
// classify comment
|
|
assert(len(ctext) >= 3); // classification char + "//" or "/*"
|
|
//-style comment
|
|
if src_nl > 0 || P.cpos == 0 {
|
|
// only white space before comment on this line
|
|
// or file starts with comment
|
|
// - indent
|
|
P.Printf("\n");
|
|
for i := P.indent; i > 0; i-- {
|
|
P.Printf("\t");
|
|
}
|
|
P.Printf("%s", ctext);
|
|
} else {
|
|
// black space before comment on this line
|
|
if ctext[1] == '/' {
|
|
//-style comment
|
|
// - put in next cell
|
|
P.Printf("\t%s", ctext);
|
|
} else {
|
|
/*-style comment */
|
|
// - print surrounded by blanks
|
|
P.Printf(" %s ", ctext);
|
|
}
|
|
}
|
|
|
|
if ctext[1] == '/' {
|
|
//-style comments must end in newline
|
|
if P.newl == 0 {
|
|
P.newl = 1;
|
|
}
|
|
/*
|
|
// TODO should we set P.newl instead?
|
|
P.Printf("\n");
|
|
for i := P.indent; i > 0; i-- {
|
|
P.Printf("\t");
|
|
}
|
|
at_line_begin = true;
|
|
*/
|
|
}
|
|
|
|
src_nl = 0;
|
|
}
|
|
|
|
P.NextComment();
|
|
}
|
|
|
|
if at_line_begin && P.newl > 0 {
|
|
P.newl--;
|
|
}
|
|
|
|
if src_nl > P.newl {
|
|
P.newl = src_nl;
|
|
}
|
|
|
|
if P.newl > 2 {
|
|
P.newl = 2;
|
|
}
|
|
|
|
if P.newl > 0 {
|
|
P.Printf("\n");
|
|
if P.newl > 1 {
|
|
for i := P.newl; i > 1; i-- {
|
|
P.Printf("\n");
|
|
}
|
|
}
|
|
for i := P.indent; i > 0; i-- {
|
|
P.Printf("\t");
|
|
}
|
|
}
|
|
|
|
P.Printf("%s", s);
|
|
|
|
P.semi, P.newl = false, 0;
|
|
}
|
|
|
|
|
|
func (P *Printer) Blank() {
|
|
P.String(0, " ");
|
|
}
|
|
|
|
|
|
func (P *Printer) Token(pos int, tok int) {
|
|
P.String(pos, Scanner.TokenString(tok));
|
|
}
|
|
|
|
|
|
func (P *Printer) OpenScope(paren string) {
|
|
//P.semi, P.newl = false, 0;
|
|
P.String(0, paren);
|
|
P.level++;
|
|
P.indent++;
|
|
P.newl = 1;
|
|
}
|
|
|
|
|
|
func (P *Printer) CloseScope(paren string) {
|
|
P.indent--;
|
|
P.semi = false;
|
|
P.String(0, paren);
|
|
P.level--;
|
|
P.semi, P.newl = false, 1;
|
|
}
|
|
|
|
|
|
func (P *Printer) Error(pos int, tok int, msg string) {
|
|
P.String(0, "<");
|
|
P.Token(pos, tok);
|
|
P.String(0, " " + msg + ">");
|
|
}
|
|
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// Types
|
|
|
|
func (P *Printer) Type(t *AST.Type)
|
|
func (P *Printer) Expr(x *AST.Expr)
|
|
|
|
func (P *Printer) Parameters(pos int, list *array.Array) {
|
|
P.String(pos, "(");
|
|
if list != nil {
|
|
var prev int;
|
|
for i, n := 0, list.Len(); i < n; i++ {
|
|
x := list.At(i).(*AST.Expr);
|
|
if i > 0 {
|
|
if prev == x.tok || prev == Scanner.TYPE {
|
|
P.String(0, ", ");
|
|
} else {
|
|
P.Blank();
|
|
}
|
|
}
|
|
P.Expr(x);
|
|
prev = x.tok;
|
|
}
|
|
}
|
|
P.String(0, ")");
|
|
}
|
|
|
|
|
|
func (P *Printer) Fields(list *array.Array) {
|
|
P.OpenScope("{");
|
|
if list != nil {
|
|
var prev int;
|
|
for i, n := 0, list.Len(); i < n; i++ {
|
|
x := list.At(i).(*AST.Expr);
|
|
if i > 0 {
|
|
if prev == Scanner.TYPE && x.tok != Scanner.STRING || prev == Scanner.STRING {
|
|
P.semi, P.newl = true, 1;
|
|
} else if prev == x.tok {
|
|
P.String(0, ", ");
|
|
} else {
|
|
P.String(0, "\t");
|
|
}
|
|
}
|
|
P.Expr(x);
|
|
prev = x.tok;
|
|
}
|
|
P.newl = 1;
|
|
}
|
|
P.CloseScope("}");
|
|
}
|
|
|
|
|
|
func (P *Printer) Type(t *AST.Type) {
|
|
switch t.tok {
|
|
case Scanner.IDENT:
|
|
P.Expr(t.expr);
|
|
|
|
case Scanner.LBRACK:
|
|
P.String(t.pos, "[");
|
|
if t.expr != nil {
|
|
P.Expr(t.expr);
|
|
}
|
|
P.String(0, "]");
|
|
P.Type(t.elt);
|
|
|
|
case Scanner.STRUCT, Scanner.INTERFACE:
|
|
P.Token(t.pos, t.tok);
|
|
if t.list != nil {
|
|
P.Blank();
|
|
P.Fields(t.list);
|
|
}
|
|
|
|
case Scanner.MAP:
|
|
P.String(t.pos, "map [");
|
|
P.Type(t.key);
|
|
P.String(0, "]");
|
|
P.Type(t.elt);
|
|
|
|
case Scanner.CHAN:
|
|
var m string;
|
|
switch t.mode {
|
|
case AST.FULL: m = "chan ";
|
|
case AST.RECV: m = "<-chan ";
|
|
case AST.SEND: m = "chan <- ";
|
|
}
|
|
P.String(t.pos, m);
|
|
P.Type(t.elt);
|
|
|
|
case Scanner.MUL:
|
|
P.String(t.pos, "*");
|
|
P.Type(t.elt);
|
|
|
|
case Scanner.LPAREN:
|
|
P.Parameters(t.pos, t.list);
|
|
if t.elt != nil {
|
|
P.Blank();
|
|
P.Parameters(0, t.elt.list);
|
|
}
|
|
|
|
case Scanner.ELLIPSIS:
|
|
P.String(t.pos, "...");
|
|
|
|
default:
|
|
P.Error(t.pos, t.tok, "type");
|
|
}
|
|
}
|
|
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// Expressions
|
|
|
|
func (P *Printer) Block(list *array.Array, indent bool);
|
|
|
|
func (P *Printer) Expr1(x *AST.Expr, prec1 int) {
|
|
if x == nil {
|
|
return; // empty expression list
|
|
}
|
|
|
|
switch x.tok {
|
|
case Scanner.TYPE:
|
|
// type expr
|
|
P.Type(x.t);
|
|
|
|
case Scanner.IDENT, Scanner.INT, Scanner.STRING, Scanner.FLOAT:
|
|
// literal
|
|
P.String(x.pos, x.s);
|
|
|
|
case Scanner.FUNC:
|
|
// function literal
|
|
P.String(x.pos, "func");
|
|
P.Type(x.t);
|
|
P.Block(x.block, true);
|
|
P.newl = 0;
|
|
|
|
case Scanner.COMMA:
|
|
// list
|
|
// (don't use binary expression printing because of different spacing)
|
|
P.Expr(x.x);
|
|
P.String(x.pos, ", ");
|
|
P.Expr(x.y);
|
|
|
|
case Scanner.PERIOD:
|
|
// selector or type guard
|
|
P.Expr1(x.x, Scanner.HighestPrec);
|
|
P.String(x.pos, ".");
|
|
if x.y != nil {
|
|
P.Expr1(x.y, Scanner.HighestPrec);
|
|
} else {
|
|
P.String(0, "(");
|
|
P.Type(x.t);
|
|
P.String(0, ")");
|
|
}
|
|
|
|
case Scanner.LBRACK:
|
|
// index
|
|
P.Expr1(x.x, Scanner.HighestPrec);
|
|
P.String(x.pos, "[");
|
|
P.Expr1(x.y, 0);
|
|
P.String(0, "]");
|
|
|
|
case Scanner.LPAREN:
|
|
// call
|
|
P.Expr1(x.x, Scanner.HighestPrec);
|
|
P.String(x.pos, "(");
|
|
P.Expr(x.y);
|
|
P.String(0, ")");
|
|
|
|
case Scanner.LBRACE:
|
|
// composite
|
|
P.Type(x.t);
|
|
P.String(x.pos, "{");
|
|
P.Expr(x.y);
|
|
P.String(0, "}");
|
|
|
|
default:
|
|
// unary and binary expressions including ":" for pairs
|
|
prec := Scanner.UnaryPrec;
|
|
if x.x != nil {
|
|
prec = Scanner.Precedence(x.tok);
|
|
}
|
|
if prec < prec1 {
|
|
P.String(0, "(");
|
|
}
|
|
if x.x == nil {
|
|
// unary expression
|
|
P.Token(x.pos, x.tok);
|
|
} else {
|
|
// binary expression
|
|
P.Expr1(x.x, prec);
|
|
P.Blank();
|
|
P.Token(x.pos, x.tok);
|
|
P.Blank();
|
|
}
|
|
P.Expr1(x.y, prec);
|
|
if prec < prec1 {
|
|
P.String(0, ")");
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
func (P *Printer) Expr(x *AST.Expr) {
|
|
P.Expr1(x, Scanner.LowestPrec);
|
|
}
|
|
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// Statements
|
|
|
|
func (P *Printer) Stat(s *AST.Stat)
|
|
|
|
func (P *Printer) StatementList(list *array.Array) {
|
|
if list != nil {
|
|
for i, n := 0, list.Len(); i < n; i++ {
|
|
P.Stat(list.At(i).(*AST.Stat));
|
|
P.newl = 1;
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
func (P *Printer) Block(list *array.Array, indent bool) {
|
|
P.OpenScope("{");
|
|
if !indent {
|
|
P.indent--;
|
|
}
|
|
P.StatementList(list);
|
|
if !indent {
|
|
P.indent++;
|
|
}
|
|
P.CloseScope("}");
|
|
}
|
|
|
|
|
|
func (P *Printer) ControlClause(s *AST.Stat) {
|
|
has_post := s.tok == Scanner.FOR && s.post != nil; // post also used by "if"
|
|
if s.init == nil && !has_post {
|
|
// no semicolons required
|
|
if s.expr != nil {
|
|
P.Blank();
|
|
P.Expr(s.expr);
|
|
}
|
|
} else {
|
|
// all semicolons required
|
|
P.Blank();
|
|
if s.init != nil {
|
|
P.Stat(s.init);
|
|
}
|
|
P.semi = true;
|
|
P.Blank();
|
|
if s.expr != nil {
|
|
P.Expr(s.expr);
|
|
}
|
|
if s.tok == Scanner.FOR {
|
|
P.semi = true;
|
|
if has_post {
|
|
P.Blank();
|
|
P.Stat(s.post);
|
|
P.semi = false
|
|
}
|
|
}
|
|
}
|
|
P.Blank();
|
|
}
|
|
|
|
|
|
func (P *Printer) Declaration(d *AST.Decl, parenthesized bool);
|
|
|
|
func (P *Printer) Stat(s *AST.Stat) {
|
|
switch s.tok {
|
|
case Scanner.EXPRSTAT:
|
|
// expression statement
|
|
P.Expr(s.expr);
|
|
P.semi = true;
|
|
|
|
case Scanner.COLON:
|
|
// label declaration
|
|
P.indent--;
|
|
P.Expr(s.expr);
|
|
P.Token(s.pos, s.tok);
|
|
P.indent++;
|
|
P.semi = false;
|
|
|
|
case Scanner.CONST, Scanner.TYPE, Scanner.VAR:
|
|
// declaration
|
|
P.Declaration(s.decl, false);
|
|
|
|
case Scanner.INC, Scanner.DEC:
|
|
P.Expr(s.expr);
|
|
P.Token(s.pos, s.tok);
|
|
P.semi = true;
|
|
|
|
case Scanner.LBRACE:
|
|
// block
|
|
P.Block(s.block, true);
|
|
|
|
case Scanner.IF:
|
|
P.String(s.pos, "if");
|
|
P.ControlClause(s);
|
|
P.Block(s.block, true);
|
|
if s.post != nil {
|
|
P.newl = 0;
|
|
P.String(0, " else ");
|
|
P.Stat(s.post);
|
|
}
|
|
|
|
case Scanner.FOR:
|
|
P.String(s.pos, "for");
|
|
P.ControlClause(s);
|
|
P.Block(s.block, true);
|
|
|
|
case Scanner.SWITCH, Scanner.SELECT:
|
|
P.Token(s.pos, s.tok);
|
|
P.ControlClause(s);
|
|
P.Block(s.block, false);
|
|
|
|
case Scanner.CASE, Scanner.DEFAULT:
|
|
P.Token(s.pos, s.tok);
|
|
if s.expr != nil {
|
|
P.Blank();
|
|
P.Expr(s.expr);
|
|
}
|
|
P.String(0, ":");
|
|
P.indent++;
|
|
P.newl = 1;
|
|
P.StatementList(s.block);
|
|
P.indent--;
|
|
P.newl = 1;
|
|
|
|
case Scanner.GO, Scanner.RETURN, Scanner.FALLTHROUGH, Scanner.BREAK, Scanner.CONTINUE, Scanner.GOTO:
|
|
P.Token(s.pos, s.tok);
|
|
if s.expr != nil {
|
|
P.Blank();
|
|
P.Expr(s.expr);
|
|
}
|
|
P.semi = true;
|
|
|
|
default:
|
|
P.Error(s.pos, s.tok, "stat");
|
|
}
|
|
}
|
|
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// Declarations
|
|
|
|
|
|
func (P *Printer) Declaration(d *AST.Decl, parenthesized bool) {
|
|
if !parenthesized {
|
|
if d.exported {
|
|
P.String(d.pos, "export ");
|
|
}
|
|
P.Token(d.pos, d.tok);
|
|
P.Blank();
|
|
}
|
|
|
|
if d.tok != Scanner.FUNC && d.list != nil {
|
|
P.OpenScope("(");
|
|
for i := 0; i < d.list.Len(); i++ {
|
|
P.Declaration(d.list.At(i).(*AST.Decl), true);
|
|
P.semi, P.newl = true, 1;
|
|
}
|
|
P.CloseScope(")");
|
|
|
|
} else {
|
|
if d.tok == Scanner.FUNC && d.typ.key != nil {
|
|
P.Parameters(0, d.typ.key.list);
|
|
P.Blank();
|
|
}
|
|
|
|
P.Expr(d.ident);
|
|
|
|
if d.typ != nil {
|
|
if d.tok != Scanner.FUNC {
|
|
P.Blank();
|
|
}
|
|
P.Type(d.typ);
|
|
}
|
|
|
|
if d.val != nil {
|
|
P.String(0, "\t");
|
|
if d.tok != Scanner.IMPORT {
|
|
P.String(0, "= ");
|
|
}
|
|
P.Expr(d.val);
|
|
}
|
|
|
|
if d.list != nil {
|
|
if d.tok != Scanner.FUNC {
|
|
panic("must be a func declaration");
|
|
}
|
|
P.Blank();
|
|
P.Block(d.list, true);
|
|
}
|
|
|
|
if d.tok != Scanner.TYPE {
|
|
P.semi = true;
|
|
}
|
|
}
|
|
|
|
P.newl = 1;
|
|
|
|
// extra newline after a function declaration
|
|
if d.tok == Scanner.FUNC {
|
|
P.newl++;
|
|
}
|
|
|
|
// extra newline at the top level
|
|
if P.level == 0 {
|
|
P.newl++;
|
|
}
|
|
}
|
|
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// Program
|
|
|
|
func (P *Printer) Program(p *AST.Program) {
|
|
P.String(p.pos, "package ");
|
|
P.Expr(p.ident);
|
|
P.newl = 2;
|
|
for i := 0; i < p.decls.Len(); i++ {
|
|
P.Declaration(p.decls.At(i), false);
|
|
}
|
|
|
|
// end program with '\n'
|
|
P.newl = 1;
|
|
}
|
|
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// External interface
|
|
|
|
export func Print(prog *AST.Program) {
|
|
// setup
|
|
padchar := byte(' ');
|
|
if usetabs.BVal() {
|
|
padchar = '\t';
|
|
}
|
|
writer := tabwriter.New(os.Stdout, int(tabwidth.IVal()), 1, padchar, true);
|
|
var P Printer;
|
|
P.Init(writer, prog.comments);
|
|
|
|
P.Program(prog);
|
|
|
|
// flush
|
|
P.String(0, "");
|
|
err := P.writer.Flush();
|
|
if err != nil {
|
|
panic("print error - exiting");
|
|
}
|
|
}
|