github.com/Konstantin8105/c4go@v0.0.0-20240505174241-768bb1c65a51/program/program.go

// Package program contains high-level orchestration and state of the input and
// output program during transpilation.
package program

import (
	"bytes"
	"fmt"
	"go/format"
	"go/token"
	"os"

	goast "go/ast"

	"strings"

	"github.com/Konstantin8105/c4go/ast"
	"github.com/Konstantin8105/c4go/preprocessor"
	"github.com/Konstantin8105/c4go/util"
)

// StructRegistry is a map of Struct for struct types and union type
type StructRegistry map[string]*Struct

// HasType method check if type exists
func (sr StructRegistry) HasType(typename string) bool {
	_, exists := sr[typename]

	return exists
}

// Program contains all of the input, output and transpition state of a C
// program to a Go program.
type Program struct {
	// All of the Go import paths required for this program.
	imports []string

	// These are for the output Go AST.
	FileSet *token.FileSet
	File    *goast.File

	// One a type is defined it will be ignored if a future type of the same
	// name appears.
	typesAlreadyDefined []string

	// Contains the current function name during the transpilation.
	Function *ast.FunctionDecl

	functionDefinitions                      map[string]DefinitionFunction
	builtInFunctionDefinitionsHaveBeenLoaded bool

	// These are used to setup the runtime before the application begins. An
	// example would be to setup globals with stdin file pointers on certain
	// platforms.
	startupStatements []goast.Stmt

	// This is used to generate globally unique names for temporary variables
	// and other generated code. See GetNextIdentifier().
	nextUniqueIdentifier int

	// The definitions for defined structs.
	// TODO: This field should be protected through proper getters and setters.
	Structs StructRegistry
	Unions  StructRegistry

	// If verbose is on progress messages will be printed immediately as code
	// comments (so that they do not interfere with the program output).
	Verbose bool

	// Contains the messages (for example, "// Warning") generated when
	// transpiling the AST. These messages, which are code comments, are
	// appended to the very top of the output file. See AddMessage().
	messages []string

	// messagePosition - position of slice messages, added like a comment
	// in output Go code
	messagePosition int

	// A map of all the global variables (variables that exist outside of a
	// function) and their types.
	GlobalVariables map[string]string

	// EnumConstantToEnum - a map with key="EnumConstant" and value="enum type"
	// clang don`t show enum constant with enum type,
	// so we have to use hack for repair the type
	EnumConstantToEnum map[string]string

	// EnumTypedefName - a map with key="Name of typedef enum" and
	// value="exist ot not"
	EnumTypedefName map[string]bool

	// TypedefType - map for type alias, for example:
	// C  : typedef int INT;
	// Map: key = INT, value = int
	// Important: key and value are C types
	TypedefType map[string]string

	// commentLine - a map with:
	// key    - filename
	// value  - last comment inserted in Go code
	commentLine map[string]commentPos

	// preprocessor file
	PreprocessorFile preprocessor.FilePP

	// UnsafeConvertValueToPointer - simplification for convert value to pointer
	UnsafeConvertValueToPointer map[string]bool

	// UnsafeConvertPointerArith - simplification for pointer arithmetic
	UnsafeConvertPointerArith map[string]bool

	// IsHaveVaList
	IsHaveVaList bool

	DoNotAddComments bool

	// for binding parse FunctionDecl one time
	Binding bool
}

type commentPos struct {
	pos  int // index in comments slice
	line int // line position
}

// NewProgram creates a new blank program.
func NewProgram() (p *Program) {
	defer func() {
		// Need for "stdbool.h"
		p.TypedefType["_Bool"] = "int"
		// Initialization c4go implementation of CSTD structs
		p.initializationStructs()
	}()
	return &Program{
		imports:             []string{},
		typesAlreadyDefined: []string{},
		startupStatements:   []goast.Stmt{},
		Structs:             StructRegistry(map[string]*Struct{
			// Structs without implementations inside system C headers
			// Example node for adding:
			// &ast.TypedefDecl{ ... Type:"struct __locale_struct *" ... }
		}),
		Unions:                                   make(StructRegistry),
		Verbose:                                  false,
		messages:                                 []string{},
		GlobalVariables:                          map[string]string{},
		EnumConstantToEnum:                       map[string]string{},
		EnumTypedefName:                          map[string]bool{},
		TypedefType:                              map[string]string{},
		commentLine:                              map[string]commentPos{},
		functionDefinitions:                      map[string]DefinitionFunction{},
		builtInFunctionDefinitionsHaveBeenLoaded: false,
		UnsafeConvertValueToPointer:              map[string]bool{},
		UnsafeConvertPointerArith:                map[string]bool{},
	}
}

// AddMessage adds a message (such as a warning or error) comment to the output
// file. Usually the message is generated from one of the Generate functions in
// the ast package.
//
// It is expected that the message already have the comment ("//") prefix.
//
// The message will not be appended if it is blank. This is because the Generate
// functions return a blank string conditionally when there is no error.
//
// The return value will be true if a message was added, otherwise false.
func (p *Program) AddMessage(message string) bool {
	if message == "" {
		return false
	}

	p.messages = append(p.messages, message)

	// Compactizarion warnings stack
	if len(p.messages) > 1 {
		var (
			new  = len(p.messages) - 1
			last = len(p.messages) - 2
		)
		// Warning collapsing for minimize warnings
		warning := "// Warning"
		if strings.HasPrefix(p.messages[last], warning) {
			l := p.messages[last][len(warning):]
			if strings.HasSuffix(p.messages[new], l) {
				p.messages[last] = p.messages[new]
				p.messages = p.messages[0:new]
			}
		}
	}

	return true
}

// GetMessageComments - get messages "Warnings", "Error" like a comment
// Location of comments only NEAR of error or warning and
// don't show directly location
func (p *Program) GetMessageComments() (_ *goast.CommentGroup) {
	var group goast.CommentGroup
	if p.messagePosition < len(p.messages) {
		for i := p.messagePosition; i < len(p.messages); i++ {
			group.List = append(group.List, &goast.Comment{
				Text: p.messages[i],
			})
		}
		p.messagePosition = len(p.messages)
	}
	return &group
}

// GetComments - return comments
func (p *Program) GetComments(n ast.Position) (out []*goast.Comment) {
	if p.DoNotAddComments {
		return
	}
	beginLine := p.commentLine[n.File]
	if n.Line < beginLine.line {
		return
	}
	comms := p.PreprocessorFile.GetComments()
	for i := beginLine.pos; i < len(comms); i++ {
		if comms[i].File != n.File {
			continue
		}
		if comms[i].Line <= beginLine.line {
			continue
		}
		if comms[i].Line > n.Line {
			break
		}
		// add comment
		out = append(out, &goast.Comment{
			Text: comms[i].Comment,
		})
		beginLine.pos = i
		if comms[i].Comment[1] == '*' {
			out = append(out, &goast.Comment{
				Text: "// ",
			})
		}
	}
	beginLine.line = n.Line
	p.commentLine[n.File] = beginLine
	return
}

// GetStruct returns a struct object (representing struct type or union type) or
// nil if doesn't exist. This method can get struct or union in the same way and
// distinguish only by the IsUnion field. `name` argument is the C like
// `struct a_struct`, it allow pointer type like `union a_union *`. Pointer
// types used in a DeclRefExpr in the case a deferenced structure by using `->`
// operator to access to a field like this: a_struct->member .
//
// This method is used in collaboration with the field
// "c4go/program".*Struct.IsUnion to simplify the code like in function
// "c4go/transpiler".transpileMemberExpr() where the same *Struct value returned
// by this method is used in the 2 cases, in the case where the value has a
// struct type and in the case where the value has an union type.
func (p *Program) GetStruct(name string) *Struct {
	if name == "" {
		return nil
	}

	// That allow to get struct from pointer type
	if last := len(name) - 1; name[last] == '*' {
		name = name[:last]
	}

	name = strings.TrimSpace(name)

	res, ok := p.Structs[name]
	if ok {
		return res
	}
	res, ok = p.Unions[name]
	if ok {
		return res
	}

	return nil
}

// IsTypeAlreadyDefined will return true if the typeName has already been
// defined.
//
// A type could be defined:
//
// 1. Initially. That is, before the transpilation starts (hard-coded).
// 2. By calling DefineType throughout the transpilation.
func (p *Program) IsTypeAlreadyDefined(typeName string) bool {
	return util.InStrings(typeName, p.typesAlreadyDefined)
}

// DefineType will record a type as having already been defined. The purpose for
// this is to not generate Go for a type more than once. C allows variables and
// other entities (such as function prototypes) to be defined more than once in
// some cases. An example of this would be static variables or functions.
func (p *Program) DefineType(typeName string) {
	p.typesAlreadyDefined = append(p.typesAlreadyDefined, typeName)
}

// UndefineType undefine defined type
func (p *Program) UndefineType(typeName string) {
check_again:
	for i := range p.typesAlreadyDefined {
		if typeName == p.typesAlreadyDefined[i] {
			if len(p.typesAlreadyDefined) == 1 {
				p.typesAlreadyDefined = make([]string, 0)
			} else if i == len(p.typesAlreadyDefined)-1 {
				p.typesAlreadyDefined = p.typesAlreadyDefined[:len(p.typesAlreadyDefined)-1]
			} else {
				p.typesAlreadyDefined = append(
					p.typesAlreadyDefined[:i],
					p.typesAlreadyDefined[i+1:]...)
			}
			goto check_again
		}
	}
}

// GetNextIdentifier generates a new globally unique identifier name. This can
// be used for variables and functions in generated code.
//
// The value of prefix is only useful for readability in the code. If the prefix
// is an empty string then the prefix "__temp" will be used.
func (p *Program) GetNextIdentifier(prefix string) string {
	if prefix == "" {
		prefix = "temp"
	}

	identifierName := fmt.Sprintf("%s%d", prefix, p.nextUniqueIdentifier)
	p.nextUniqueIdentifier++

	return identifierName
}

type nilWalker struct {
}

func (n nilWalker) Visit(node goast.Node) (w goast.Visitor) {
	fmt.Fprintf(os.Stdout, "\n---------\n")
	fmt.Fprintf(os.Stdout, "Node: %#v\n", node)
	switch v := node.(type) {
	case *goast.IndexExpr:
		fmt.Fprintf(os.Stdout, "IndexExpr\n")
		fmt.Fprintf(os.Stdout, "\tx     = %#v\n", v.X)
		fmt.Fprintf(os.Stdout, "\tindex = %#v\n", v.Index)
		if v.Index == nil {
			goast.Print(token.NewFileSet(), v)
			panic("")
		}

	case *goast.GenDecl:
		fmt.Fprintf(os.Stdout, "%#v\n", v)
		for i, s := range v.Specs {
			fmt.Fprintf(os.Stdout, "Spec%d:   %#v\n", i, s)
			if vs, ok := s.(*goast.ValueSpec); ok {
				for j := range vs.Names {
					fmt.Fprintf(os.Stdout, "IDS : %#v\n", vs.Names[j])
				}
			}
		}
	}
	return n
}

type simpleDefer struct {
}

func (s simpleDefer) Visit(node goast.Node) (w goast.Visitor) {
	// 	var s int32 = func() int32 {
	// 		if int32(sstr_s[0]) == int32(sstr_bufs[sstr_n]) {
	// 			return 1
	// 		}
	// 		return 0
	// 	}()

	// from :
	//		{
	//			...
	//			li = func() int32 {
	//				if booled {
	//					return result1
	//				}
	//				return result2
	//			}()
	//			...
	//		}
	// to   :
	//		{
	//			...
	//			if booled {
	//				li = result1
	//			} else {
	//				li = result2
	//			}
	//			...
	//		}
	if eb, ok := node.(*goast.BlockStmt); ok && 0 < len(eb.List) {
		for i := range eb.List {
			if eb.List[i] == nil {
				continue
			}
			es, ok := eb.List[i].(*goast.ExprStmt)
			if !ok {
				continue
			}
			be, ok := es.X.(*goast.BinaryExpr)
			if !ok {
				continue
			}

			valueName := be.X
			if be.Op != token.ASSIGN {
				continue
			}
			cl, ok := be.Y.(*goast.CallExpr)
			if !ok {
				continue
			}
			fl, ok := cl.Fun.(*goast.FuncLit)
			if !ok {
				continue
			}
			b := fl.Body
			if 2 != len(b.List) {
				continue
			}
			ifd, ok := b.List[0].(*goast.IfStmt)
			if !ok {
				continue
			}

			condition := ifd.Cond

			ifbod := ifd.Body
			if 1 != len(ifbod.List) {
				continue
			}

			ret1, ok := ifbod.List[0].(*goast.ReturnStmt)
			if !ok {
				continue
			}

			result1 := ret1.Results

			ret2, ok := b.List[1].(*goast.ReturnStmt)
			if !ok {
				continue
			}

			result2 := ret2.Results

			eb.List[i] = &goast.IfStmt{
				Cond: condition,
				Body: &goast.BlockStmt{
					List: []goast.Stmt{
						&goast.AssignStmt{
							Lhs: []goast.Expr{valueName},
							Tok: token.ASSIGN,
							Rhs: result1,
						},
					},
				},
				Else: &goast.BlockStmt{
					List: []goast.Stmt{
						&goast.AssignStmt{
							Lhs: []goast.Expr{valueName},
							Tok: token.ASSIGN,
							Rhs: result2,
						},
					},
				},
			}
		}
	}

	// from :
	//		if ... {
	//			{
	//				...
	//			}
	//		} else {
	//			{
	//				...
	//			}
	//		}
	// to   :
	//		if ... {
	//				...
	//		} else {
	//				...
	//		}
	if fb, ok := node.(*goast.IfStmt); ok {
		if len(fb.Body.List) == 1 {
			if ib, ok := fb.Body.List[0].(*goast.BlockStmt); ok {
				fb.Body = ib
			}
		}
		if fb.Else != nil {
			if b1, ok := fb.Else.(*goast.BlockStmt); ok && 1 == len(b1.List) {
				if b2, ok := b1.List[0].(*goast.BlockStmt); ok {
					fb.Else = b2
				}
			}
		}
	}

	// from :
	//		return func() int32 {
	//			if int32(sstr_s[0]) == int32(sstr_bufs[sstr_n]) {
	//				return 1
	//			}
	//			return 0
	//		}()
	// or   :
	//		return func() int32 {
	//			...
	//		}()
	// to   :
	//		if int32(sstr_s[0]) == int32(sstr_bufs[sstr_n]) {
	//			return 1
	//		}
	//		return 0
	// or   :
	//		...
	if eb, ok := node.(*goast.BlockStmt); ok && 0 < len(eb.List) {
		if ret, ok := eb.List[len(eb.List)-1].(*goast.ReturnStmt); ok && 1 == len(ret.Results) {
			if c, ok := ret.Results[0].(*goast.CallExpr); ok {
				if fl, ok := c.Fun.(*goast.FuncLit); ok {
					if 1 < len(eb.List) {
						eb.List = eb.List[:len(eb.List)-1]
					} else {
						eb.List = []goast.Stmt{}
					}
					eb.List = append(eb.List, fl.Body.List...)
				}
			}
		}
	}

	// from :
	//		{
	//			.....
	//			func() []byte {
	//				tempVarUnary := sstr_s
	//				defer func() {
	//					sstr_s = f(sstr_s, int(-1))
	//				}()
	//				return tempVarUnary
	//			}()
	//			.....
	//		}
	// to   :
	//		{
	//			.....
	//			sstr_s = f(sstr_s, int(-1))
	//			.....
	//		}
	if eb, ok := node.(*goast.BlockStmt); ok {
		for i := range eb.List {
			es, ok := eb.List[i].(*goast.ExprStmt)
			if !ok {
				continue
			}
			cl, ok := es.X.(*goast.CallExpr)
			if !ok {
				continue
			}
			fl, ok := cl.Fun.(*goast.FuncLit)
			if !ok {
				continue
			}
			ft := fl.Type // .(*goast.FuncType)
			if 1 != len(ft.Results.List) {
				continue
			}

			if 3 != len(fl.Body.List) {
				continue
			}

			body := fl.Body.List

			as, ok := body[0].(*goast.AssignStmt)
			if !ok {
				continue
			}
			if 1 != len(as.Lhs) {
				continue
			}
			in, ok := as.Lhs[0].(*goast.Ident)
			if !ok {
				continue
			}
			if in.Name != "tempVarUnary" {
				continue
			}

			rt, ok := body[2].(*goast.ReturnStmt)
			if !ok {
				continue
			}
			if 1 != len(rt.Results) {
				continue
			}
			id, ok := rt.Results[0].(*goast.Ident)
			if !ok {
				continue
			}
			if id.Name != "tempVarUnary" {
				continue
			}

			def, ok := body[1].(*goast.DeferStmt)
			if !ok {
				continue
			}

			fl, ok = def.Call.Fun.(*goast.FuncLit)
			if !ok {
				continue
			}

			body = fl.Body.List
			if 1 != len(body) {
				continue
			}

			eb.List[i] = body[0]
		}
	}

	// 	from:
	//		func f4() {
	//			{
	//				var i int32
	//				for ; i < 10; i++ {
	//				}
	//			}
	//		}
	// to   :
	//		func f4() {
	//			var i int32
	//			for ; i < 10; i++ {
	//			}
	//		}
	if fd, ok := node.(*goast.FuncDecl); ok && len(fd.Body.List) == 1 {
		if ib, ok := fd.Body.List[0].(*goast.BlockStmt); ok {
			fd.Body = ib // internal body
		}
	}
	// 	from:
	//		 {
	//			{
	//				var i int32
	//				for ; i < 10; i++ {
	//				}
	//			}
	//		}
	// to   :
	//		{
	//			var i int32
	//			for ; i < 10; i++ {
	//			}
	//		}
	if eb, ok := node.(*goast.BlockStmt); ok && len(eb.List) == 1 {
		if ib, ok := eb.List[0].(*goast.BlockStmt); ok {
			eb = ib // internal body
		}
	}
	// Simplification from :
	//	var cc int32 = int32(uint8((func() []byte {
	//		defer func() {
	//			func() []byte {
	//				tempVarUnary := ss
	//				defer func() {
	//					ss = ss[0+1:]
	//				}()
	//				return tempVarUnary
	//			}()
	//		}()
	//		return ss
	//	}())[0]))
	//
	// to:
	//	var cc int32 = int32(uint8((func() []byte {
	//		defer func() {
	//			ss = ss[0+1:]
	//		}()
	//		return ss
	//	}())[0]))
	if f0, ok := node.(*goast.FuncLit); ok && f0.Body != nil {
		if len(f0.Body.List) == 2 {
			if df, ok := f0.Body.List[0].(*goast.DeferStmt); ok {
				cl := df.Call
				if fl, ok := cl.Fun.(*goast.FuncLit); ok && len(fl.Body.List) == 1 {
					if es, ok := fl.Body.List[0].(*goast.ExprStmt); ok {
						if cl, ok := es.X.(*goast.CallExpr); ok {
							if fl, ok := cl.Fun.(*goast.FuncLit); ok && len(fl.Body.List) == 3 {
								if _, ok := fl.Body.List[0].(*goast.AssignStmt); ok {
									if df, ok := fl.Body.List[1].(*goast.DeferStmt); ok {
										if _, ok := fl.Body.List[2].(*goast.ReturnStmt); ok {
											f0.Body.List[0] = df
										}
									}
								}
							}
						}
					}
				}
			}
		}
	}

	return s
}

// String generates the whole output Go file as a string. This will include the
// messages at the top of the file and all the rendered Go code.
func (p *Program) String() string {
	var buf bytes.Buffer

	buf.WriteString(fmt.Sprintf(`//
//	Package - transpiled by c4go
//
//	If you have found any issues, please raise an issue at:
//	https://github.com/Konstantin8105/c4go/
//

`))

	// Simplification from :
	//	var cc int32 = int32(uint8((func() []byte {
	//		defer func() {
	//			func() []byte {
	//				tempVarUnary := ss
	//				defer func() {
	//					ss = ss[0+1:]
	//				}()
	//				return tempVarUnary
	//			}()
	//		}()
	//		return ss
	//	}())[0]))
	//
	// to:
	//	var cc int32 = int32(uint8((func() []byte {
	//		defer func() {
	//			ss = ss[0+1:]
	//		}()
	//		return ss
	//	}())[0]))
	goast.Walk(new(simpleDefer), p.File)

	// Only for debugging
	// goast.Walk(new(nilWalker), p.File)

	// First write all the messages. The double newline afterwards is important
	// so that the package statement has a newline above it so that the warnings
	// are not part of the documentation for the package.
	buf.WriteString(strings.Join(p.messages, "\n") + "\n\n")

	if err := format.Node(&buf, p.FileSet, p.File); err != nil {
		// Printing the entire AST will generate a lot of output. However, it is
		// the only way to debug this type of error. Hopefully the error
		// (printed immediately afterwards) will give a clue.
		//
		// You may see an error like:
		//
		//     panic: format.Node internal error (692:23: expected selector or
		//     type assertion, found '[')
		//
		// This means that when Go was trying to convert the Go AST to source
		// code it has come across a value or attribute that is illegal.
		//
		// The line number it is referring to (in this case, 692) is not helpful
		// as it references the internal line number of the Go code which you
		// will never see.
		//
		// The "[" means that there is a bracket in the wrong place. Almost
		// certainly in an identifer, like:
		//
		//     noarch.IntTo[]byte("foo")
		//
		// The "[]" which is obviously not supposed to be in the function name
		// is causing the syntax error. However, finding the original code that
		// produced this can be tricky.
		//
		// The first step is to filter down the AST output to probably lines.
		// In the error message it said that there was a misplaced "[" so that's
		// what we will search for. Using the original command (that generated
		// thousands of lines) we will add two grep filters:
		//
		//     go test ... | grep "\[" | grep -v '{$'
		//     #                   |     |
		//     #                   |     ^ This excludes lines that end with "{"
		//     #                   |       which almost certainly won't be what
		//     #                   |       we are looking for.
		//     #                   |
		//     #                   ^ This is the character we are looking for.
		//
		// Hopefully in the output you should see some lines, like (some lines
		// removed for brevity):
		//
		//     9083  .  .  .  .  .  .  .  .  .  .  Name: "noarch.[]byteTo[]int"
		//     9190  .  .  .  .  .  .  .  .  .  Name: "noarch.[]intTo[]byte"
		//
		// These two lines are clearly the error because a name should not look
		// like this.
		//
		// Looking at the full output of the AST (thousands of lines) and
		// looking at those line numbers should give you a good idea where the
		// error is coming from; by looking at the parents of the bad lines.
		_ = goast.Print(p.FileSet, p.File)

		panic(err)
	}

	// Add comments at the end C file
	for file, beginLine := range p.commentLine {
		for i := range p.PreprocessorFile.GetComments() {
			if p.PreprocessorFile.GetComments()[i].File == file {
				if beginLine.line < p.PreprocessorFile.GetComments()[i].Line {
					buf.WriteString(
						fmt.Sprintln(
							p.PreprocessorFile.GetComments()[i].Comment))
				}
			}
		}
	}

	// simplify Go code. Example :
	// Before:
	// func compare(a interface {
	// }, b interface {
	// }) (c4goDefaultReturn int) {
	// After :
	// func compare(a interface {}, b interface {}) (c4goDefaultReturn int) {
	reg := util.GetRegex("interface( )?{(\r*)\n(\t*)}")
	s := string(reg.ReplaceAll(buf.Bytes(), []byte("interface {}")))

	sp := strings.Split(s, "\n")
	for i := range sp {
		if strings.HasSuffix(sp[i], "-= 1") {
			sp[i] = strings.TrimSuffix(sp[i], "-= 1") + "--"
		}
		if strings.HasSuffix(sp[i], "+= 1") {
			sp[i] = strings.TrimSuffix(sp[i], "+= 1") + "++"
		}
	}

	return strings.Join(sp, "\n")
}

// IncludeHeaderIsExists return true if C #include header is inside list
func (p *Program) IncludeHeaderIsExists(includeHeader string) bool {
	for _, inc := range p.PreprocessorFile.GetIncludeFiles() {
		if strings.HasSuffix(inc.HeaderName, includeHeader) {
			return true
		}
	}
	return false
}