// Copyright (c) 2019 Uber Technologies, Inc. // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN // THE SOFTWARE. package digreflect import ( "fmt" "net/url" "reflect" "runtime" "strings" ) // Func contains runtime information about a function. type Func struct { // Name of the function. Name string // Name of the package in which this function is defined. Package string // Path to the file in which this function is defined. File string // Line number in the file at which this function is defined. Line int } // String returns a string representation of the function. func (f *Func) String() string { return fmt.Sprint(f) } // Format implements fmt.Formatter for Func, printing a single-line // representation for %v and a multi-line one for %+v. func (f *Func) Format(w fmt.State, c rune) { if w.Flag('+') && c == 'v' { // "path/to/package".MyFunction // path/to/file.go:42 fmt.Fprintf(w, "%q.%v", f.Package, f.Name) fmt.Fprintf(w, "\n\t%v:%v", f.File, f.Line) } else { // "path/to/package".MyFunction (path/to/file.go:42) fmt.Fprintf(w, "%q.%v (%v:%v)", f.Package, f.Name, f.File, f.Line) } } // InspectFunc inspects and returns runtime information about the given // function. func InspectFunc(function interface{}) *Func { fptr := reflect.ValueOf(function).Pointer() return InspectFuncPC(fptr) } // InspectFuncPC inspects and returns runtime information about the function // at the given program counter address. func InspectFuncPC(pc uintptr) *Func { f := runtime.FuncForPC(pc) if f == nil { return nil } pkgName, funcName := splitFuncName(f.Name()) fileName, lineNum := f.FileLine(pc) return &Func{ Name: funcName, Package: pkgName, File: fileName, Line: lineNum, } } const _vendor = "/vendor/" func splitFuncName(function string) (pname string, fname string) { if len(function) == 0 { return } // We have something like "path.to/my/pkg.MyFunction". If the function is // a closure, it is something like, "path.to/my/pkg.MyFunction.func1". idx := 0 // Everything up to the first "." after the last "/" is the package name. // Everything after the "." is the full function name. if i := strings.LastIndex(function, "/"); i >= 0 { idx = i } if i := strings.Index(function[idx:], "."); i >= 0 { idx += i } pname, fname = function[:idx], function[idx+1:] // The package may be vendored. if i := strings.Index(pname, _vendor); i > 0 { pname = pname[i+len(_vendor):] } // Package names are URL-encoded to avoid ambiguity in the case where the // package name contains ".git". Otherwise, "foo/bar.git.MyFunction" would // mean that "git" is the top-level function and "MyFunction" is embedded // inside it. if unescaped, err := url.QueryUnescape(pname); err == nil { pname = unescaped } return }