[perf] Update FORMAT docs.

Also update the output from validating a JSON file
to also include the supplied links.

Change-Id: I2953961dc1ad5ca8d82f7a9f9061cbc33b903658
Reviewed-on: https://skia-review.googlesource.com/c/buildbot/+/540095
Auto-Submit: Joe Gregorio <jcgregorio@google.com>
Commit-Queue: Joe Gregorio <jcgregorio@google.com>
Commit-Queue: Leandro Lovisolo <lovisolo@google.com>
Reviewed-by: Leandro Lovisolo <lovisolo@google.com>
3 files changed
tree: 98a0d94d4fdb70a063fdfa6b91921c67126846c5
  1. am/
  2. android_ingest/
  3. android_stats/
  4. api/
  5. autoroll/
  6. bash/
  7. bazel/
  8. blamer/
  9. bugs-central/
  10. cd/
  11. cherrypick-watcher/
  12. codereview-watcher/
  13. codesize/
  14. comments/
  15. comp-ui/
  16. contestk/
  17. cq_watcher/
  18. ct/
  19. datahopper/
  20. debugger-app/
  21. demos/
  22. docker/
  23. docker_pushes_watcher/
  24. docs/
  25. docsyserver/
  26. dot/
  27. ds/
  28. external/
  29. fiddlek/
  30. firestore/
  31. get_service_account/
  32. gitsync/
  33. go/
  34. gold-client/
  35. golden/
  36. hashtag/
  37. infra/
  38. infra-sk/
  39. jsdoc/
  40. jsfiddle/
  41. k8s-checker/
  42. k8s-deployer/
  43. kube/
  44. leasing/
  45. licenses/
  46. machine/
  47. make/
  48. modules/
  49. named-fiddles/
  50. new_element/
  51. npm-audit-mirror/
  52. particles/
  53. perdiff/
  54. perf/
  55. periodic-trigger/
  56. proberk/
  57. promk/
  58. puppeteer-tests/
  59. sa-keys-checker/
  60. scrap/
  61. scripts/
  62. shaders/
  63. sk/
  64. skbug/
  65. skcq/
  66. skfe/
  67. skolo/
  68. skottie/
  69. status/
  70. switchboard/
  71. task_driver/
  72. task_scheduler/
  73. test-service/
  74. third_party/
  75. tools/
  76. tree_status/
  77. trybot_updater/
  78. velero/
  79. .bazelignore
  80. .bazelrc
  81. .bazelversion
  82. .eslintrc.js
  83. .gitattributes
  84. .gitignore
  85. .mocharc.json
  86. .npmrc
  87. .vpython
  88. BAZEL_CHEATSHEET.md
  89. BUILD.bazel
  90. build_infra_prod.sh
  91. cipd.ensure
  92. codereview.settings
  93. DATASTORE.md
  94. demopage.sh
  95. DEPS
  96. elements-sk-scss.bzl
  97. go.mod
  98. go.sum
  99. go_repositories.bzl
  100. launch.md
  101. LICENSE
  102. Makefile
  103. OWNERS
  104. package-lock.json
  105. package.json
  106. PRESUBMIT.py
  107. PRIVACY_POLICY.md
  108. README.md
  109. run_unittests
  110. run_unittests.go
  111. STYLEGUIDE.md
  112. tools.go
  113. tsconfig.json
  114. whitespace.txt
  115. WORKSPACE
README.md

Skia-Buildbot Repository

This repo contains infrastructure code for Skia.

Getting the Source Code

The main source code repository is a Git repository hosted at https://skia.googlesource.com/buildbot.git. It is possible to check out this repository directly with git clone or via go get.

Using git clone allows you to work in whatever directory you want. You will still need to set GOPATH in order to build some apps (recommended to put this in a cache dir). E.g.:

$ cd ${WORKDIR}
$ git clone https://skia.googlesource.com/buildbot.git
$ export GOPATH=${HOME}/.cache/gopath/$(basename ${WORKDIR})
$ mkdir $GOPATH
$ cd buildbot

Using go get will fetch the repository into your GOPATH directory along with all the Go dependencies. You will need to set GOPATH and GO111MODULE=on. E.g.:

$ export GOPATH=${WORKDIR}
$ export GO111MODULE=on
$ go get -u -t go.skia.org/infra/...
$ cd ${GOPATH}/src/go.skia.org/infra/

Note: go.skia.org is a custom import path and will only work if used like the examples here.

Install Node.js (not as root) and add the bin dir to your path. Optionally run npm install npm -g, as suggested by the npm getting started doc.

Install other dependencies:

$ sudo apt-get install \
    jq \
    python-django
$ go get -u \
    github.com/kisielk/errcheck \
    golang.org/x/tools/cmd/goimports \
    go.chromium.org/luci/client/cmd/isolate \
    go get github.com/mikefarah/yq/v4

Build ~everything:

$ make all

Generated Code

Some code is generated using go generate with external binaries. First, install the version of protoc referenced in the asset creation script and ensure it is on your PATH before other versions of protoc.

Install the necessary go packages:

$ go get -u \
  github.com/golang/protobuf/protoc-gen-go \
  golang.org/x/tools/cmd/stringer \
  google.golang.org/grpc \

To generate code run in this directory:

$ go generate ./...

Running unit tests

Install Cloud SDK.

Use this command to run the presubmit tests:

$ ./run_unittests --small