package loader // This file extracts the `import "C"` statement from the source and modifies // the AST for Cgo. It does not use libclang directly (see libclang.go). import ( "go/ast" "go/token" "strconv" ) // fileInfo holds all Cgo-related information of a given *ast.File. type fileInfo struct { *ast.File filename string functions []*functionInfo types []string importCPos token.Pos } // functionInfo stores some information about a Cgo function found by libclang // and declared in the AST. type functionInfo struct { name string args []paramInfo result string } // paramInfo is a parameter of a Cgo function (see functionInfo). type paramInfo struct { name string typeName string } // aliasInfo encapsulates aliases between C and Go, like C.int32_t -> int32. See // addTypeAliases. type aliasInfo struct { typeName string goTypeName string } // processCgo extracts the `import "C"` statement from the AST, parses the // comment with libclang, and modifies the AST to use this information. func (p *Package) processCgo(filename string, f *ast.File) error { info := &fileInfo{ File: f, filename: filename, } // Find `import "C"` statements in the file. for i := 0; i < len(f.Decls); i++ { decl := f.Decls[i] genDecl, ok := decl.(*ast.GenDecl) if !ok { continue } if len(genDecl.Specs) != 1 { continue } spec, ok := genDecl.Specs[0].(*ast.ImportSpec) if !ok { continue } path, err := strconv.Unquote(spec.Path.Value) if err != nil { panic("could not parse import path: " + err.Error()) } if path != "C" { continue } cgoComment := genDecl.Doc.Text() // Stored for later use by generated functions, to use a somewhat sane // source location. info.importCPos = spec.Path.ValuePos err = info.parseFragment(cgoComment) if err != nil { return err } // Remove this import declaration. f.Decls = append(f.Decls[:i], f.Decls[i+1:]...) i-- } // Print the AST, for debugging. //ast.Print(p.fset, f) // Declare functions found by libclang. info.addFuncDecls() // Forward C types to Go types (like C.uint32_t -> uint32). info.addTypeAliases() // Patch the AST to use the declared types and functions. ast.Inspect(f, info.walker) return nil } // addFuncDecls adds the C function declarations found by libclang in the // comment above the `import "C"` statement. func (info *fileInfo) addFuncDecls() { // TODO: replace all uses of importCPos with the real locations from // libclang. for _, fn := range info.functions { obj := &ast.Object{ Kind: ast.Fun, Name: "C." + fn.name, } args := make([]*ast.Field, len(fn.args)) decl := &ast.FuncDecl{ Name: &ast.Ident{ NamePos: info.importCPos, Name: "C." + fn.name, Obj: obj, }, Type: &ast.FuncType{ Func: info.importCPos, Params: &ast.FieldList{ Opening: info.importCPos, List: args, Closing: info.importCPos, }, Results: &ast.FieldList{ List: []*ast.Field{ &ast.Field{ Type: &ast.Ident{ NamePos: info.importCPos, Name: "C." + fn.result, }, }, }, }, }, } obj.Decl = decl for i, arg := range fn.args { args[i] = &ast.Field{ Names: []*ast.Ident{ &ast.Ident{ NamePos: info.importCPos, Name: arg.name, Obj: &ast.Object{ Kind: ast.Var, Name: "C." + arg.name, Decl: decl, }, }, }, Type: &ast.Ident{ NamePos: info.importCPos, Name: "C." + arg.typeName, }, } } info.Decls = append(info.Decls, decl) } } // addTypeAliases aliases some built-in Go types with their equivalent C types. // It adds code like the following to the AST: // // type ( // C.int8_t = int8 // C.int16_t = int16 // // ... // ) func (info *fileInfo) addTypeAliases() { aliases := []aliasInfo{ aliasInfo{"C.int8_t", "int8"}, aliasInfo{"C.int16_t", "int16"}, aliasInfo{"C.int32_t", "int32"}, aliasInfo{"C.int64_t", "int64"}, aliasInfo{"C.uint8_t", "uint8"}, aliasInfo{"C.uint16_t", "uint16"}, aliasInfo{"C.uint32_t", "uint32"}, aliasInfo{"C.uint64_t", "uint64"}, aliasInfo{"C.uintptr_t", "uintptr"}, } gen := &ast.GenDecl{ TokPos: info.importCPos, Tok: token.TYPE, Lparen: info.importCPos, Rparen: info.importCPos, } for _, alias := range aliases { obj := &ast.Object{ Kind: ast.Typ, Name: alias.typeName, } typeSpec := &ast.TypeSpec{ Name: &ast.Ident{ NamePos: info.importCPos, Name: alias.typeName, Obj: obj, }, Assign: info.importCPos, Type: &ast.Ident{ NamePos: info.importCPos, Name: alias.goTypeName, }, } obj.Decl = typeSpec gen.Specs = append(gen.Specs, typeSpec) } info.Decls = append(info.Decls, gen) } // walker replaces all "C". call expressions to literal // "C." expressions. This is impossible to write in Go (a dot cannot // be used in the middle of a name) so is used as a new namespace for C call // expressions. func (info *fileInfo) walker(node ast.Node) bool { switch node := node.(type) { case *ast.CallExpr: fun, ok := node.Fun.(*ast.SelectorExpr) if !ok { return true } x, ok := fun.X.(*ast.Ident) if !ok { return true } if x.Name == "C" { node.Fun = &ast.Ident{ NamePos: x.NamePos, Name: "C." + fun.Sel.Name, } } } return true }