db4400bfe9
- Updating documentation for chromedp-gen to point to standard versions
of easyjson/quicktemplate (qtc) and added information about goimports
- Replaced {% end %} non-standard quicktemplate tags with the
appropriate closing tags
- Updated to latest chrome protocol.json definition
- Regenerated cdp protocol after switching to standard easyjson/qtc
91 lines
4.3 KiB
Markdown
91 lines
4.3 KiB
Markdown
# About chromedp-gen
|
|
|
|
`chromedp-gen` is a standalone cli tool for the [chromedp](https://github.com/knq/chromedp)
|
|
package that generates the types for the chrome domain APIs as defined in
|
|
Chrome's `protocol.json`.
|
|
|
|
## Updating protocol.json
|
|
|
|
Run [`update.sh`](update.sh) to retrieve and combine the latest
|
|
[`browser_protocol.json`](https://chromium.googlesource.com/chromium/src/+/master/third_party/WebKit/Source/core/inspector/browser_protocol.json) and
|
|
[`js_protocol.json`](https://chromium.googlesource.com/v8/v8/+/master/src/inspector/js_protocol.json)
|
|
from the [Chromium source tree](https://chromium.googlesource.com/) into [`protocol.json`](protocol.json).
|
|
|
|
## Installing dependencies
|
|
|
|
`chromedp-gen` uses the cli tools [qtc](https://github.com/valyala/quicktemplate) for
|
|
code generation templates, [easyjson](https://github.com/mailru/easyjson) for
|
|
JSON marshaling/unmarshaling, and [goimports](https://golang.org/x/tools/cmd/goimports)
|
|
for formatting generated code (and fixing import statements).
|
|
|
|
The cli commands (and their associated dependencies) can be installed in the
|
|
usual Go way:
|
|
|
|
```sh
|
|
go get -u github.com/valyala/quicktemplate/qtc github.com/mailru/easyjson/easyjson golang.org/x/tools/cmd/goimports
|
|
```
|
|
|
|
Please make sure that `$GOPATH/bin` is somewhere on your `$PATH`.
|
|
|
|
## Generating types for chromedp
|
|
|
|
Assuming the `qtc`, `easyjson`, and `goimports` commands are available on
|
|
`$PATH` (see above), one can then run the [`build.sh`](build.sh) which will
|
|
handle generating template files, and building/invoking the `chromedp-gen`
|
|
command.
|
|
|
|
## Reference Output
|
|
|
|
The output of running `update.sh` and `build.sh` is below:
|
|
```sh
|
|
ken@ken-desktop:~/src/go/src/github.com/knq/chromedp/cmd/chromedp-gen$ ./update.sh
|
|
# download
|
|
curl -s $BROWSER_PROTO | base64 -d > $BROWSER_TMP
|
|
curl -s $JS_PROTO | base64 -d > $JS_TMP
|
|
|
|
# merge browser_protocol.json and js_protocol.json
|
|
jq -s '[.[] | to_entries] | flatten | reduce .[] as $dot ({}; .[$dot.key] += $dot.value)' $BROWSER_TMP $JS_TMP > $OUT
|
|
|
|
# convert boolean values listed as strings to real booleans
|
|
# (this is not used in favor of using the custom Bool type that correctly JSON unmarshals the value)
|
|
# left here for completeness
|
|
#perl -pi -e 's/"\s*:\s*"(true|false)"/": \1/g' $OUT
|
|
ken@ken-desktop:~/src/go/src/github.com/knq/chromedp/cmd/chromedp-gen$ ./build.sh
|
|
go generate
|
|
qtc: 2017/01/29 09:10:16 Compiling *.qtpl template files in directory "templates"
|
|
qtc: 2017/01/29 09:10:16 Compiling "templates/domain.qtpl" to "templates/domain.qtpl.go"...
|
|
qtc: 2017/01/29 09:10:16 Compiling "templates/extra.qtpl" to "templates/extra.qtpl.go"...
|
|
qtc: 2017/01/29 09:10:16 Compiling "templates/file.qtpl" to "templates/file.qtpl.go"...
|
|
qtc: 2017/01/29 09:10:16 Compiling "templates/type.qtpl" to "templates/type.qtpl.go"...
|
|
qtc: 2017/01/29 09:10:16 Total files compiled: 4
|
|
|
|
go build
|
|
|
|
time ./chromedp-gen
|
|
2017/01/29 09:10:17 skipping command Page.getCookies [redirect:Network]
|
|
2017/01/29 09:10:17 skipping command Page.deleteCookie [redirect:Network]
|
|
2017/01/29 09:10:17 skipping command Page.setDeviceMetricsOverride [redirect:Emulation]
|
|
2017/01/29 09:10:17 skipping command Page.clearDeviceMetricsOverride [redirect:Emulation]
|
|
2017/01/29 09:10:17 skipping command Page.setGeolocationOverride [redirect:Emulation]
|
|
2017/01/29 09:10:17 skipping command Page.clearGeolocationOverride [redirect:Emulation]
|
|
2017/01/29 09:10:17 skipping command Page.setDeviceOrientationOverride [redirect:DeviceOrientation]
|
|
2017/01/29 09:10:17 skipping command Page.clearDeviceOrientationOverride [redirect:DeviceOrientation]
|
|
2017/01/29 09:10:17 skipping command Page.setTouchEmulationEnabled [redirect:Emulation]
|
|
2017/01/29 09:10:17 skipping command param Emulation.setDeviceMetricsOverride.offsetX [deprecated]
|
|
2017/01/29 09:10:17 skipping command param Emulation.setDeviceMetricsOverride.offsetY [deprecated]
|
|
2017/01/29 09:10:17 skipping command param Tracing.start.categories [deprecated]
|
|
2017/01/29 09:10:17 skipping command param Tracing.start.options [deprecated]
|
|
2017/01/29 09:10:17 skipping domain Console (console) [deprecated]
|
|
2017/01/29 09:10:17 running goimports
|
|
2017/01/29 09:10:31 running easyjson (stubs)
|
|
2017/01/29 09:10:31 running easyjson
|
|
2017/01/29 09:10:39 done.
|
|
|
|
real 0m22.318s
|
|
user 1m15.132s
|
|
sys 0m53.592s
|
|
|
|
go install ../../cdp/...
|
|
ken@ken-desktop:~/src/go/src/github.com/knq/chromedp/cmd/chromedp-gen$
|
|
```
|