plugeth/vendor/gopkg.in/olebedev/go-duktape.v3
Péter Szilágyi 5258785c81
cmd, core, eth/tracers: support fancier js tracing (#15516)
* cmd, core, eth/tracers: support fancier js tracing

* eth, internal/web3ext: rework trace API, concurrency, chain tracing

* eth/tracers: add three more JavaScript tracers

* eth/tracers, vendor: swap ottovm to duktape for tracing

* core, eth, internal: finalize call tracer and needed extras

* eth, tests: prestate tracer, call test suite, rewinding

* vendor: fix windows builds for tracer js engine

* vendor: temporary duktape fix

* eth/tracers: fix up 4byte and evmdis tracer

* vendor: pull in latest duktape with my upstream fixes

* eth: fix some review comments

* eth: rename rewind to reexec to make it more obvious

* core/vm: terminate tracing using defers
2017-12-21 13:56:11 +02:00
..
api.go cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
appveyor.yml cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
conts.go cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_alloc_pool.c cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_alloc_pool.h cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_config.h cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_console.c cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_console.h cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_logging.c cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_logging.h cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_minimal_printf.c cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_minimal_printf.h cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_module_duktape.c cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_module_duktape.h cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_module_node.c cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_module_node.h cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_print_alert.c cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_print_alert.h cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_v1_compat.c cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duk_v1_compat.h cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duktape.c cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duktape.go cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
duktape.h cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
Gopkg.lock cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
Gopkg.toml cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
LICENSE.md cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
README.md cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
timers.go cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
utils.go cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00
wercker.yml cmd, core, eth/tracers: support fancier js tracing (#15516) 2017-12-21 13:56:11 +02:00

Duktape bindings for Go(Golang)

wercker status Travis status Appveyor status Gitter

Duktape is a thin, embeddable javascript engine. Most of the api is implemented. The exceptions are listed here.

Usage

The package is fully go-getable, no need to install any external C libraries.
So, just type go get gopkg.in/olebedev/go-duktape.v3 to install.

package main

import "fmt"
import "gopkg.in/olebedev/go-duktape.v3"

func main() {
  ctx := duktape.New()
  ctx.PevalString(`2 + 3`)
  result := ctx.GetNumber(-1)
  ctx.Pop()
  fmt.Println("result is:", result)
  // To prevent memory leaks, don't forget to clean up after
  // yourself when you're done using a context.
  ctx.DestroyHeap()
}

Go specific notes

Bindings between Go and Javascript contexts are not fully functional. However, binding a Go function to the Javascript context is available:

package main

import "fmt"
import "gopkg.in/olebedev/go-duktape.v3"

func main() {
  ctx := duktape.New()
  ctx.PushGlobalGoFunction("log", func(c *duktape.Context) int {
    fmt.Println(c.SafeToString(-1))
    return 0
  })
  ctx.PevalString(`log('Go lang Go!')`)
}

then run it.

$ go run *.go
Go lang Go!
$

Timers

There is a method to inject timers to the global scope:

package main

import "fmt"
import "gopkg.in/olebedev/go-duktape.v3"

func main() {
  ctx := duktape.New()

  // Let's inject `setTimeout`, `setInterval`, `clearTimeout`,
  // `clearInterval` into global scope.
  ctx.PushTimers()

  ch := make(chan string)
  ctx.PushGlobalGoFunction("second", func(_ *Context) int {
    ch <- "second step"
    return 0
  })
  ctx.PevalString(`
    setTimeout(second, 0);
    print('first step');
  `)
  fmt.Println(<-ch)
}

then run it

$ go run *.go
first step
second step
$

Also you can FlushTimers().

Command line tool

Install go get gopkg.in/olebedev/go-duktape.v3/....
Execute file.js: $GOPATH/bin/go-duk file.js.

Benchmarks

prog time
otto 200.13s
anko 231.19s
agora 149.33s
GopherLua 8.39s
go-duktape 9.80s

More details are here.

Status

The package is not fully tested, so be careful.

Contribution

Pull requests are welcome! Also, if you want to discuss something send a pull request with proposal and changes. Convention: fork the repository and make changes on your fork in a feature branch.