Files
gerrit/polygerrit-ui
Andrew Bonventre 5d700e3625 Fix CSS layout issues on the change view screen
+ When the related changes list has a very long change
  description, it would overflow the window. The flex spec[1]
  says that by default, flex items won’t shring below their
  minimum content size (the length of the longest word or
  fixed size element). The solution set forth by the spec
  is to set the min-width or min-height property. In this
  case, setting the min-width property is the solution.
+ Set a max width for gr-account-link within the metadata
  column with appropriate overflow. This was considered as
  a project-wide change but caused too much jank in other
  areas. The gr-account-link element should be re-evaluated.

[1] https://www.w3.org/TR/css-flexbox-1/#flex-initial

Bug: Issue 4835
Bug: Issue 4604
Change-Id: Ie8d4f84b5f832e0a6d311dc6e235619358cf7a08
2016-10-28 12:31:16 -07:00
..
2016-09-13 15:14:32 +00:00
2016-10-24 11:19:20 +02:00

PolyGerrit

Installing Node.js

# Debian/Ubuntu
sudo apt-get install nodejs-legacy

# OS X with Homebrew
brew install node

All other platforms: download from nodejs.org.

Installing Buck

Follow the instructions here to get and install Buck.

Local UI, Production Data

This is a quick and easy way to test your local changes against real data. Unfortunately, you can't sign in, so testing certain features will require you to use the "test data" technique described below.

Installing go

This is required for running the run-server.sh script below.

# Debian/Ubuntu
sudo apt-get install golang

# OS X with Homebrew
brew install go

All other platforms: download from golang.org

Then add go to your path:

PATH=$PATH:/usr/local/go/bin

Running the server

To test the local UI against gerrit-review.googlesource.com:

./run-server.sh

Then visit http://localhost:8081

Local UI, Test Data

One-time setup:

  1. Build Gerrit
  2. Set up a local test site. Docs here and here.

When your project is set up and works using the classic UI, run a test server that serves PolyGerrit:

buck build polygerrit && \
java -jar buck-out/gen/polygerrit/polygerrit.war daemon --polygerrit-dev \
-d ../gerrit_testsite --console-log --show-stack-trace

Running Tests

One-time setup:

# Debian/Ubuntu
sudo apt-get install npm

# OS X with Homebrew
brew install npm

# All platforms (including those above)
sudo npm install -g web-component-tester

Run all web tests:

buck test --no-results-cache --include web

The --no-results-cache flag prevents flaky test failures from being cached.

If you need to pass additional arguments to wct:

WCT_ARGS='-p --some-flag="foo bar"' buck test --no-results-cache --include web

For interactively working on a single test file, do the following:

./polygerrit-ui/run-server.sh

Then visit http://localhost:8081/elements/foo/bar_test.html

Style guide

We follow the Google JavaScript Style Guide with a few exceptions. When in doubt, remain consistent with the code around you.