/** * @license * Copyright (C) 2018 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ (function() { 'use strict'; const MSG_EMPTY_BLAME = 'No blame information for this diff.'; const EVENT_AGAINST_PARENT = 'diff-against-parent'; const EVENT_ZERO_REBASE = 'rebase-percent-zero'; const EVENT_NONZERO_REBASE = 'rebase-percent-nonzero'; const DiffViewMode = { SIDE_BY_SIDE: 'SIDE_BY_SIDE', UNIFIED: 'UNIFIED_DIFF', }; const WHITESPACE_IGNORE_NONE = 'IGNORE_NONE'; /** * @param {Object} diff * @return {boolean} */ function isImageDiff(diff) { if (!diff) { return false; } const isA = diff.meta_a && diff.meta_a.content_type.startsWith('image/'); const isB = diff.meta_b && diff.meta_b.content_type.startsWith('image/'); return !!(diff.binary && (isA || isB)); } /** * Wrapper around gr-diff. * * Webcomponent fetching diffs and related data from restAPI and passing them * to the presentational gr-diff for rendering. */ // TODO(oler): Move all calls to restAPI from gr-diff here. Polymer({ is: 'gr-diff-host', /** * Fired when the user selects a line. * @event line-selected */ /** * Fired if being logged in is required. * * @event show-auth-required */ /** * Fired when a comment is saved or discarded * * @event diff-comments-modified */ properties: { changeNum: String, noAutoRender: { type: Boolean, value: false, }, /** @type {?} */ patchRange: Object, path: String, prefs: { type: Object, }, projectConfig: { type: Object, }, projectName: String, displayLine: { type: Boolean, value: false, }, isImageDiff: { type: Boolean, computed: '_computeIsImageDiff(_diff)', notify: true, }, commitRange: Object, filesWeblinks: { type: Object, value() { return {}; }, notify: true, }, hidden: { type: Boolean, reflectToAttribute: true, }, noRenderOnPrefsChange: { type: Boolean, value: false, }, comments: Object, lineWrapping: { type: Boolean, value: false, }, viewMode: { type: String, value: DiffViewMode.SIDE_BY_SIDE, }, /** * Special line number which should not be collapsed into a shared region. * @type {{ * number: number, * leftSide: {boolean} * }|null} */ lineOfInterest: Object, /** * If the diff fails to load, show the failure message in the diff rather * than bubbling the error up to the whole page. This is useful for when * loading inline diffs because one diff failing need not mark the whole * page with a failure. */ showLoadFailure: Boolean, isBlameLoaded: { type: Boolean, notify: true, computed: '_computeIsBlameLoaded(_blame)', }, _loggedIn: { type: Boolean, value: false, }, _loading: { type: Boolean, value: false, }, /** @type {?string} */ _errorMessage: { type: String, value: null, }, /** @type {?Object} */ _baseImage: Object, /** @type {?Object} */ _revisionImage: Object, _diff: Object, /** @type {?Object} */ _blame: { type: Object, value: null, }, _loadedWhitespaceLevel: String, }, listeners: { 'draft-interaction': '_handleDraftInteraction', }, observers: [ '_whitespaceChanged(prefs.ignore_whitespace, _loadedWhitespaceLevel,' + ' noRenderOnPrefsChange)', ], ready() { if (this._canReload()) { this.reload(); } }, attached() { this._getLoggedIn().then(loggedIn => { this._loggedIn = loggedIn; }); }, /** @return {!Promise} */ reload() { this._loading = true; this._errorMessage = null; const whitespaceLevel = this._getIgnoreWhitespace(); const diffRequest = this._getDiff() .then(diff => { this._loadedWhitespaceLevel = whitespaceLevel; this._reportDiff(diff); if (this._getIgnoreWhitespace() !== WHITESPACE_IGNORE_NONE) { return this._translateChunksToIgnore(diff); } return diff; }) .catch(e => { this._handleGetDiffError(e); return null; }); const assetRequest = diffRequest.then(diff => { // If the diff is null, then it's failed to load. if (!diff) { return null; } return this._loadDiffAssets(diff); }); return Promise.all([diffRequest, assetRequest]) .then(results => { const diff = results[0]; if (!diff) { return Promise.resolve(); } this.filesWeblinks = this._getFilesWeblinks(diff); return new Promise(resolve => { const callback = () => { resolve(); this.removeEventListener('render', callback); }; this.addEventListener('render', callback); this._diff = diff; }); }) .catch(err => { console.warn('Error encountered loading diff:', err); }) .then(() => { this._loading = false; }); }, _getFilesWeblinks(diff) { if (!this.commitRange) { return {}; } return { meta_a: Gerrit.Nav.getFileWebLinks( this.projectName, this.commitRange.baseCommit, this.path, {weblinks: diff && diff.meta_a && diff.meta_a.web_links}), meta_b: Gerrit.Nav.getFileWebLinks( this.projectName, this.commitRange.commit, this.path, {weblinks: diff && diff.meta_b && diff.meta_b.web_links}), }; }, /** Cancel any remaining diff builder rendering work. */ cancel() { this.$.diff.cancel(); }, /** @return {!Array} */ getCursorStops() { return this.$.diff.getCursorStops(); }, /** @return {boolean} */ isRangeSelected() { return this.$.diff.isRangeSelected(); }, toggleLeftDiff() { this.$.diff.toggleLeftDiff(); }, /** * Load and display blame information for the base of the diff. * @return {Promise} A promise that resolves when blame finishes rendering. */ loadBlame() { return this.$.restAPI.getBlame(this.changeNum, this.patchRange.patchNum, this.path, true) .then(blame => { if (!blame.length) { this.fire('show-alert', {message: MSG_EMPTY_BLAME}); return Promise.reject(MSG_EMPTY_BLAME); } this._blame = blame; }); }, /** Unload blame information for the diff. */ clearBlame() { this._blame = null; }, /** @return {!Array} */ getThreadEls() { return this.$.diff.getThreadEls(); }, /** @param {HTMLElement} el */ addDraftAtLine(el) { this.$.diff.addDraftAtLine(el); }, clearDiffContent() { this.$.diff.clearDiffContent(); }, expandAllContext() { this.$.diff.expandAllContext(); }, /** @return {!Promise} */ _getLoggedIn() { return this.$.restAPI.getLoggedIn(); }, /** @return {boolean}} */ _canReload() { return !!this.changeNum && !!this.patchRange && !!this.path && !this.noAutoRender; }, /** @return {!Promise} */ _getDiff() { // Wrap the diff request in a new promise so that the error handler // rejects the promise, allowing the error to be handled in the .catch. return new Promise((resolve, reject) => { this.$.restAPI.getDiff( this.changeNum, this.patchRange.basePatchNum, this.patchRange.patchNum, this.path, this._getIgnoreWhitespace(), reject) .then(resolve); }); }, _handleGetDiffError(response) { // Loading the diff may respond with 409 if the file is too large. In this // case, use a toast error.. if (response.status === 409) { this.fire('server-error', {response}); return; } if (this.showLoadFailure) { this._errorMessage = [ 'Encountered error when loading the diff:', response.status, response.statusText, ].join(' '); return; } this.fire('page-error', {response}); }, /** * Report info about the diff response. */ _reportDiff(diff) { if (!diff || !diff.content) { return; } // Count the delta lines stemming from normal deltas, and from // due_to_rebase deltas. let nonRebaseDelta = 0; let rebaseDelta = 0; diff.content.forEach(chunk => { if (chunk.ab) { return; } const deltaSize = Math.max( chunk.a ? chunk.a.length : 0, chunk.b ? chunk.b.length : 0); if (chunk.due_to_rebase) { rebaseDelta += deltaSize; } else { nonRebaseDelta += deltaSize; } }); // Find the percent of the delta from due_to_rebase chunks rounded to two // digits. Diffs with no delta are considered 0%. const totalDelta = rebaseDelta + nonRebaseDelta; const percentRebaseDelta = !totalDelta ? 0 : Math.round(100 * rebaseDelta / totalDelta); // Report the due_to_rebase percentage in the "diff" category when // applicable. if (this.patchRange.basePatchNum === 'PARENT') { this.$.reporting.reportInteraction(EVENT_AGAINST_PARENT); } else if (percentRebaseDelta === 0) { this.$.reporting.reportInteraction(EVENT_ZERO_REBASE); } else { this.$.reporting.reportInteraction(EVENT_NONZERO_REBASE, percentRebaseDelta); } }, /** * @param {Object} diff * @return {!Promise} */ _loadDiffAssets(diff) { if (isImageDiff(diff)) { return this._getImages(diff).then(images => { this._baseImage = images.baseImage; this._revisionImage = images.revisionImage; }); } else { this._baseImage = null; this._revisionImage = null; return Promise.resolve(); } }, /** * @param {Object} diff * @return {boolean} */ _computeIsImageDiff(diff) { return isImageDiff(diff); }, /** * @param {Object} blame * @return {boolean} */ _computeIsBlameLoaded(blame) { return !!blame; }, /** * @param {Object} diff * @return {!Promise} */ _getImages(diff) { return this.$.restAPI.getImagesForDiff(this.changeNum, diff, this.patchRange); }, _handleDraftInteraction() { this.$.reporting.recordDraftInteraction(); }, /** * Take a diff that was loaded with a ignore-whitespace other than * IGNORE_NONE, and convert delta chunks labeled as common into shared * chunks. * @param {!Object} diff * @returns {!Object} */ _translateChunksToIgnore(diff) { const newDiff = Object.assign({}, diff); const mergedContent = []; // Was the last chunk visited a shared chunk? let lastWasShared = false; for (const chunk of diff.content) { if (lastWasShared && chunk.common && chunk.b) { // The last chunk was shared and this chunk should be ignored, so // add its revision content to the previous chunk. mergedContent[mergedContent.length - 1].ab.push(...chunk.b); } else if (chunk.common && !chunk.b) { // If the chunk should be ignored, but it doesn't have revision // content, then drop it and continue without updating lastWasShared. continue; } else if (lastWasShared && chunk.ab) { // Both the last chunk and the current chunk are shared. Merge this // chunk's shared content into the previous shared content. mergedContent[mergedContent.length - 1].ab.push(...chunk.ab); } else if (!lastWasShared && chunk.common && chunk.b) { // If the previous chunk was not shared, but this one should be // ignored, then add it as a shared chunk. mergedContent.push({ab: chunk.b}); } else { // Otherwise add the chunk as is. mergedContent.push(chunk); } lastWasShared = !!mergedContent[mergedContent.length - 1].ab; } newDiff.content = mergedContent; return newDiff; }, _getIgnoreWhitespace() { if (!this.prefs || !this.prefs.ignore_whitespace) { return WHITESPACE_IGNORE_NONE; } return this.prefs.ignore_whitespace; }, _whitespaceChanged(preferredWhitespaceLevel, loadedWhitespaceLevel, noRenderOnPrefsChange) { if (preferredWhitespaceLevel !== loadedWhitespaceLevel && !noRenderOnPrefsChange) { this.reload(); } }, }); })();