@seleniumhq/code-export-python-pytest 3.17.0 → 3.17.2

package/__test__/src/__snapshots__/command.spec.js.snap

@@ -123,9 +123,9 @@ actions = ActionChains(self.driver)
 actions.drag_and_drop(dragged, dropped).perform()"
 `;
 
-exports[`command code emitter should emit \`echo\` command 1`] = `"print(str(\\"blah\\"))"`;
+exports[`command code emitter should emit \`echo\` command 1`] = `"print(\\"blah\\")"`;
 
-exports[`command code emitter should emit \`echo\` command with variables 1`] = `"print(str(self.vars[\\"blah\\"]))"`;
+exports[`command code emitter should emit \`echo\` command with variables 1`] = `"print(\\"blah = {}\\".format(self.vars[\\"blah\\"]))"`;
 
 exports[`command code emitter should emit \`edit content\` command 1`] = `
 "element = self.driver.find_element(By.ID, \\"contentEditable\\")
@@ -225,7 +225,7 @@ actions.move_to_element(element).release().perform()"
 
 exports[`command code emitter should emit \`open\` with absolute url 1`] = `"self.driver.get(\\"https://www.seleniumhq.org/\\")"`;
 
-exports[`command code emitter should emit \`pause\` command 1`] = `"time.sleep(300)"`;
+exports[`command code emitter should emit \`pause\` command 1`] = `"time.sleep(0.3)"`;
 
 exports[`command code emitter should emit \`remove selection\` command 1`] = `
 "dropdown = self.driver.find_element(By.CSS_SELECTOR, \\"select\\")
@@ -348,19 +348,19 @@ assert value == \\"test\\""
 
 exports[`command code emitter should emit \`verify\` command 1`] = `"assert(self.vars[\\"varrrName\\"] == \\"blah\\")"`;
 
-exports[`command code emitter should emit \`waitForElementEditable\` command 1`] = `"WebDriverWait(self.driver, 5000).until(expected_conditions.element_to_be_clickable((By.CSS_SELECTOR, \\"#blah\\")))"`;
+exports[`command code emitter should emit \`waitForElementEditable\` command 1`] = `"WebDriverWait(self.driver, 5).until(expected_conditions.element_to_be_clickable((By.CSS_SELECTOR, \\"#blah\\")))"`;
 
-exports[`command code emitter should emit \`waitForElementNotEditable\` command 1`] = `"WebDriverWait(self.driver, 5000).until_not(expected_conditions.element_to_be_clickable((By.CSS_SELECTOR, \\"#blah\\")))"`;
+exports[`command code emitter should emit \`waitForElementNotEditable\` command 1`] = `"WebDriverWait(self.driver, 5).until_not(expected_conditions.element_to_be_clickable((By.CSS_SELECTOR, \\"#blah\\")))"`;
 
-exports[`command code emitter should emit \`waitForElementNotPresent\` command 1`] = `"WebDriverWait(self.driver, 5000).until(expected_conditions.invisibility_of_element_located((By.CSS_SELECTOR, \\"#blah\\")))"`;
+exports[`command code emitter should emit \`waitForElementNotPresent\` command 1`] = `"WebDriverWait(self.driver, 5).until(expected_conditions.invisibility_of_element_located((By.CSS_SELECTOR, \\"#blah\\")))"`;
 
-exports[`command code emitter should emit \`waitForElementNotVisible\` command 1`] = `"WebDriverWait(self.driver, 5000).until(expected_conditions.invisibility_of_element_located((By.CSS_SELECTOR, \\"#blah\\")))"`;
+exports[`command code emitter should emit \`waitForElementNotVisible\` command 1`] = `"WebDriverWait(self.driver, 5).until(expected_conditions.invisibility_of_element_located((By.CSS_SELECTOR, \\"#blah\\")))"`;
 
-exports[`command code emitter should emit \`waitForElementPresent\` command 1`] = `"WebDriverWait(self.driver, 5000).until(expected_conditions.presence_of_element_located((By.CSS_SELECTOR, \\"#blah\\")))"`;
+exports[`command code emitter should emit \`waitForElementPresent\` command 1`] = `"WebDriverWait(self.driver, 5).until(expected_conditions.presence_of_element_located((By.CSS_SELECTOR, \\"#blah\\")))"`;
 
-exports[`command code emitter should emit \`waitForElementVisible\` command 1`] = `"WebDriverWait(self.driver, 5000).until(expected_conditions.visibility_of_element_located((By.CSS_SELECTOR, \\"#blah\\")))"`;
+exports[`command code emitter should emit \`waitForElementVisible\` command 1`] = `"WebDriverWait(self.driver, 5).until(expected_conditions.visibility_of_element_located((By.CSS_SELECTOR, \\"#blah\\")))"`;
 
-exports[`command code emitter should emit \`waitForText\` command 1`] = `"WebDriverWait(self.driver, 30000).until(expected_conditions.text_to_be_present_in_element((By.CSS_SELECTOR, \\"#blah\\"), \\"text\\"))"`;
+exports[`command code emitter should emit \`waitForText\` command 1`] = `"WebDriverWait(self.driver, 30).until(expected_conditions.text_to_be_present_in_element((By.CSS_SELECTOR, \\"#blah\\"), \\"text\\"))"`;
 
 exports[`command code emitter should emit \`while\` command 1`] = `
 Object {

package/__test__/src/__snapshots__/index.spec.js.snap

@@ -127,7 +127,7 @@ from selenium.webdriver.support.wait import WebDriverWait
 from selenium.webdriver.common.keys import Keys
 from selenium.webdriver.common.desired_capabilities import DesiredCapabilities
 
-class TestLogin():
+class TestReusedmethods():
   def setup_method(self, method):
     self.driver = webdriver.Chrome()
     self.vars = {}
@@ -140,7 +140,11 @@ class TestLogin():
     self.driver.find_element(By.LINK_TEXT, \\"Form Authentication\\").click()
     self.driver.find_element(By.ID, \\"username\\").send_keys(self.vars[\\"username\\"])
     self.driver.find_element(By.ID, \\"password\\").send_keys(self.vars[\\"password\\"])
-    self.driver.find_element(By.CSS_SELECTOR, \\".fa\\").click()
+    if self.driver.execute_script(\\"return (true)\\"):
+      self.driver.find_element(By.CSS_SELECTOR, \\".fa\\").click()
+  
+  def tinymethod(self):
+    self.vars[\\"value\\"] = \\"field\\"
   
   def test_invalidcredentials(self):
     self.vars[\\"username\\"] = \\"blah\\"
@@ -152,6 +156,12 @@ class TestLogin():
     self.vars[\\"password\\"] = \\"SuperSecretPassword!\\"
     self.login()
   
+  def test_twomethods(self):
+    self.vars[\\"username\\"] = \\"blah\\"
+    self.vars[\\"password\\"] = \\"blah\\"
+    self.login()
+    self.tinymethod()
+  
 "
 `;
 
@@ -305,7 +315,8 @@ class TestValidcredentials():
     self.driver.find_element(By.LINK_TEXT, \\"Form Authentication\\").click()
     self.driver.find_element(By.ID, \\"username\\").send_keys(self.vars[\\"username\\"])
     self.driver.find_element(By.ID, \\"password\\").send_keys(self.vars[\\"password\\"])
-    self.driver.find_element(By.CSS_SELECTOR, \\".fa\\").click()
+    if self.driver.execute_script(\\"return (true)\\"):
+      self.driver.find_element(By.CSS_SELECTOR, \\".fa\\").click()
   
   def test_validcredentials(self):
     self.vars[\\"username\\"] = \\"tomsmith\\"

package/__test__/src/command.spec.js

@@ -272,7 +272,7 @@ describe('command code emitter', () => {
   it('should emit `echo` command with variables', () => {
     const command = {
       command: 'echo',
-      target: '${blah}',
+      target: 'blah = ${blah}',
       value: '',
     }
     return expect(prettify(command)).resolves.toMatchSnapshot()

package/__test__/src/index.spec.js

@@ -17,7 +17,13 @@
 
 import fs from 'fs'
 import path from 'path'
-import { emitTest, emitSuite, _emitMethod, _findTestByName } from '../../src'
+import codeExport, {
+  emitTest,
+  emitSuite,
+  _emitMethod,
+  _findTestByName,
+} from '../../src'
+import Command from '../../src/command'
 import { project as projectProcessor } from '@seleniumhq/side-utils'
 
 function readFile(filename) {
@@ -132,6 +138,9 @@ describe('Code Export Python pytest', () => {
     expect(results.body).toBeDefined()
     expect(results.body).toMatchSnapshot()
   })
+  it('should export the command emitter', () => {
+    expect(Command.emit).toStrictEqual(codeExport.emit.command)
+  })
 })
 
 function normalizeProject(project) {

package/__test__/src/selection.spec.js

@@ -35,6 +35,13 @@ describe('selection location code emitter', () => {
       `By.XPATH, "//option[. = '${selector}']"`
     )
   })
+  it('should emit label locator with variable', () => {
+    const type = 'label'
+    const selector = 'self.vars["label"]'
+    return expect(emit(`${type}=${selector}`)).resolves.toEqual(
+      `By.XPATH, "//option[. = '{}']".format(${selector})`
+    )
+  })
   it('should emit id locator', () => {
     const type = 'id'
     const selector = 'someId'

package/dist/command.js

@@ -399,10 +399,22 @@ async function emitDragAndDrop(dragged, dropped) {
   });
 }
 
+function translateToPythonString(str) {
+  const regExp = /self.vars\["\w+"]/;
+  const vars = str.match(regExp);
+
+  if (vars && vars.length > 0) {
+    const fmtStr = str.replace(regExp, '{}');
+    return `"${fmtStr}".format(${vars.join(', ')})`;
+  }
+
+  return `"${str}"`;
+}
+
 async function emitEcho(message) {
-  const _message = message.startsWith('self.vars[') ? message : `"${message}"`;
+  const _message = translateToPythonString(message);
 
-  return Promise.resolve(`print(str(${_message}))`);
+  return Promise.resolve(`print(${_message})`);
 }
 
 async function emitEditContent(locator, content) {
@@ -499,9 +511,10 @@ function emitOpen(target) {
 }
 
 async function emitPause(time) {
+  const sec = time / 1000;
   const commands = [{
     level: 0,
-    statement: `time.sleep(${time})`
+    statement: `time.sleep(${sec})`
   }];
   return Promise.resolve({
     commands
@@ -809,9 +822,10 @@ async function emitVerifyTitle(title) {
 }
 
 async function emitWaitForElementEditable(locator, timeout) {
+  const sec = timeout / 1000;
   const commands = [{
     level: 0,
-    statement: `WebDriverWait(self.driver, ${timeout}).until(expected_conditions.element_to_be_clickable((${await _location.default.emit(locator)})))`
+    statement: `WebDriverWait(self.driver, ${sec}).until(expected_conditions.element_to_be_clickable((${await _location.default.emit(locator)})))`
   }];
   return Promise.resolve({
     commands
@@ -820,9 +834,10 @@ async function emitWaitForElementEditable(locator, timeout) {
 
 async function emitWaitForText(locator, text) {
   const timeout = 30000;
+  const sec = timeout / 1000;
   const commands = [{
     level: 0,
-    statement: `WebDriverWait(self.driver, ${timeout}).until(expected_conditions.text_to_be_present_in_element((${await _location.default.emit(locator)}), "${text}"))`
+    statement: `WebDriverWait(self.driver, ${sec}).until(expected_conditions.text_to_be_present_in_element((${await _location.default.emit(locator)}), "${text}"))`
   }];
   return Promise.resolve({
     commands
@@ -834,9 +849,10 @@ function skip() {
 }
 
 async function emitWaitForElementPresent(locator, timeout) {
+  const sec = timeout / 1000;
   const commands = [{
     level: 0,
-    statement: `WebDriverWait(self.driver, ${timeout}).until(expected_conditions.presence_of_element_located((${await _location.default.emit(locator)})))`
+    statement: `WebDriverWait(self.driver, ${sec}).until(expected_conditions.presence_of_element_located((${await _location.default.emit(locator)})))`
   }];
   return Promise.resolve({
     commands
@@ -844,9 +860,10 @@ async function emitWaitForElementPresent(locator, timeout) {
 }
 
 async function emitWaitForElementVisible(locator, timeout) {
+  const sec = timeout / 1000;
   const commands = [{
     level: 0,
-    statement: `WebDriverWait(self.driver, ${timeout}).until(expected_conditions.visibility_of_element_located((${await _location.default.emit(locator)})))`
+    statement: `WebDriverWait(self.driver, ${sec}).until(expected_conditions.visibility_of_element_located((${await _location.default.emit(locator)})))`
   }];
   return Promise.resolve({
     commands
@@ -854,9 +871,10 @@ async function emitWaitForElementVisible(locator, timeout) {
 }
 
 async function emitWaitForElementNotEditable(locator, timeout) {
+  const sec = timeout / 1000;
   const commands = [{
     level: 0,
-    statement: `WebDriverWait(self.driver, ${timeout}).until_not(expected_conditions.element_to_be_clickable((${await _location.default.emit(locator)})))`
+    statement: `WebDriverWait(self.driver, ${sec}).until_not(expected_conditions.element_to_be_clickable((${await _location.default.emit(locator)})))`
   }];
   return Promise.resolve({
     commands
@@ -864,9 +882,10 @@ async function emitWaitForElementNotEditable(locator, timeout) {
 }
 
 async function emitWaitForElementNotPresent(locator, timeout) {
+  const sec = timeout / 1000;
   const commands = [{
     level: 0,
-    statement: `WebDriverWait(self.driver, ${timeout}).until(expected_conditions.invisibility_of_element_located((${await _location.default.emit(locator)})))`
+    statement: `WebDriverWait(self.driver, ${sec}).until(expected_conditions.invisibility_of_element_located((${await _location.default.emit(locator)})))`
   }];
   return Promise.resolve({
     commands
@@ -874,9 +893,10 @@ async function emitWaitForElementNotPresent(locator, timeout) {
 }
 
 async function emitWaitForElementNotVisible(locator, timeout) {
+  const sec = timeout / 1000;
   const commands = [{
     level: 0,
-    statement: `WebDriverWait(self.driver, ${timeout}).until(expected_conditions.invisibility_of_element_located((${await _location.default.emit(locator)})))`
+    statement: `WebDriverWait(self.driver, ${sec}).until(expected_conditions.invisibility_of_element_located((${await _location.default.emit(locator)})))`
   }];
   return Promise.resolve({
     commands

package/dist/index.js

@@ -120,7 +120,8 @@ var _default = {
   emit: {
     test: emitTest,
     suite: emitSuite,
-    locator: _location.default.emit
+    locator: _location.default.emit,
+    command: _command.default.emit
   },
   register: {
     command: _command.default.register,

package/dist/selection.js

@@ -49,6 +49,10 @@ function emitValue(value) {
 }
 
 function emitLabel(label) {
+  if (label.startsWith('self.vars[')) {
+    return Promise.resolve(`By.XPATH, "//option[. = '{}']".format(${label})`);
+  }
+
   return Promise.resolve(`By.XPATH, "//option[. = '${label}']"`);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seleniumhq/code-export-python-pytest",
-  "version": "3.17.0",
+  "version": "3.17.2",
   "description": "Export Selenium IDE project contents to Python pytest",
   "repository": "https://github.com/SeleniumHQ/selenium-ide",
   "keywords": [
@@ -21,7 +21,6 @@
     "@babel/preset-env": "^7.4.5"
   },
   "dependencies": {
-    "@seleniumhq/side-utils": "^3.17.0"
-  },
-  "gitHead": "b484b959037301c1d2383046a49449cd0def45d7"
+    "@seleniumhq/side-utils": "^3.17.2"
+  }
 }

package/src/command.js

@@ -381,9 +381,21 @@ async function emitDragAndDrop(dragged, dropped) {
   return Promise.resolve({ commands })
 }
 
+function translateToPythonString(str) {
+  const regExp = /self.vars\["\w+"]/
+  const vars = str.match(regExp)
+
+  if (vars && vars.length > 0) {
+    const fmtStr = str.replace(regExp, '{}')
+    return `"${fmtStr}".format(${vars.join(', ')})`
+  }
+
+  return `"${str}"`
+}
+
 async function emitEcho(message) {
-  const _message = message.startsWith('self.vars[') ? message : `"${message}"`
-  return Promise.resolve(`print(str(${_message}))`)
+  const _message = translateToPythonString(message)
+  return Promise.resolve(`print(${_message})`)
 }
 
 async function emitEditContent(locator, content) {
@@ -485,7 +497,8 @@ function emitOpen(target) {
 }
 
 async function emitPause(time) {
-  const commands = [{ level: 0, statement: `time.sleep(${time})` }]
+  const sec = time / 1000
+  const commands = [{ level: 0, statement: `time.sleep(${sec})` }]
   return Promise.resolve({ commands })
 }
 
@@ -855,10 +868,11 @@ async function emitVerifyTitle(title) {
 }
 
 async function emitWaitForElementEditable(locator, timeout) {
+  const sec = timeout / 1000
   const commands = [
     {
       level: 0,
-      statement: `WebDriverWait(self.driver, ${timeout}).until(expected_conditions.element_to_be_clickable((${await location.emit(
+      statement: `WebDriverWait(self.driver, ${sec}).until(expected_conditions.element_to_be_clickable((${await location.emit(
         locator
       )})))`,
     },
@@ -868,10 +882,11 @@ async function emitWaitForElementEditable(locator, timeout) {
 
 async function emitWaitForText(locator, text) {
   const timeout = 30000
+  const sec = timeout / 1000
   const commands = [
     {
       level: 0,
-      statement: `WebDriverWait(self.driver, ${timeout}).until(expected_conditions.text_to_be_present_in_element((${await location.emit(
+      statement: `WebDriverWait(self.driver, ${sec}).until(expected_conditions.text_to_be_present_in_element((${await location.emit(
         locator
       )}), "${text}"))`,
     },
@@ -884,10 +899,11 @@ function skip() {
 }
 
 async function emitWaitForElementPresent(locator, timeout) {
+  const sec = timeout / 1000
   const commands = [
     {
       level: 0,
-      statement: `WebDriverWait(self.driver, ${timeout}).until(expected_conditions.presence_of_element_located((${await location.emit(
+      statement: `WebDriverWait(self.driver, ${sec}).until(expected_conditions.presence_of_element_located((${await location.emit(
         locator
       )})))`,
     },
@@ -896,10 +912,11 @@ async function emitWaitForElementPresent(locator, timeout) {
 }
 
 async function emitWaitForElementVisible(locator, timeout) {
+  const sec = timeout / 1000
   const commands = [
     {
       level: 0,
-      statement: `WebDriverWait(self.driver, ${timeout}).until(expected_conditions.visibility_of_element_located((${await location.emit(
+      statement: `WebDriverWait(self.driver, ${sec}).until(expected_conditions.visibility_of_element_located((${await location.emit(
         locator
       )})))`,
     },
@@ -910,10 +927,11 @@ async function emitWaitForElementVisible(locator, timeout) {
 }
 
 async function emitWaitForElementNotEditable(locator, timeout) {
+  const sec = timeout / 1000
   const commands = [
     {
       level: 0,
-      statement: `WebDriverWait(self.driver, ${timeout}).until_not(expected_conditions.element_to_be_clickable((${await location.emit(
+      statement: `WebDriverWait(self.driver, ${sec}).until_not(expected_conditions.element_to_be_clickable((${await location.emit(
         locator
       )})))`,
     },
@@ -924,10 +942,11 @@ async function emitWaitForElementNotEditable(locator, timeout) {
 }
 
 async function emitWaitForElementNotPresent(locator, timeout) {
+  const sec = timeout / 1000
   const commands = [
     {
       level: 0,
-      statement: `WebDriverWait(self.driver, ${timeout}).until(expected_conditions.invisibility_of_element_located((${await location.emit(
+      statement: `WebDriverWait(self.driver, ${sec}).until(expected_conditions.invisibility_of_element_located((${await location.emit(
         locator
       )})))`,
     },
@@ -938,10 +957,11 @@ async function emitWaitForElementNotPresent(locator, timeout) {
 }
 
 async function emitWaitForElementNotVisible(locator, timeout) {
+  const sec = timeout / 1000
   const commands = [
     {
       level: 0,
-      statement: `WebDriverWait(self.driver, ${timeout}).until(expected_conditions.invisibility_of_element_located((${await location.emit(
+      statement: `WebDriverWait(self.driver, ${sec}).until(expected_conditions.invisibility_of_element_located((${await location.emit(
         locator
       )})))`,
     },

package/src/index.js

@@ -124,6 +124,7 @@ export default {
     test: emitTest,
     suite: emitSuite,
     locator: location.emit,
+    command: emitter.emit,
   },
   register: {
     command: emitter.register,

package/src/selection.js

@@ -41,6 +41,9 @@ function emitValue(value) {
 }
 
 function emitLabel(label) {
+  if (label.startsWith('self.vars[')) {
+    return Promise.resolve(`By.XPATH, "//option[. = '{}']".format(${label})`)
+  }
   return Promise.resolve(`By.XPATH, "//option[. = '${label}']"`)
 }
 

package/LICENSE

@@ -1,202 +0,0 @@
-
-                                 Apache License
-                           Version 2.0, January 2004
-                        http://www.apache.org/licenses/
-
-   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-
-   1. Definitions.
-
-      "License" shall mean the terms and conditions for use, reproduction,
-      and distribution as defined by Sections 1 through 9 of this document.
-
-      "Licensor" shall mean the copyright owner or entity authorized by
-      the copyright owner that is granting the License.
-
-      "Legal Entity" shall mean the union of the acting entity and all
-      other entities that control, are controlled by, or are under common
-      control with that entity. For the purposes of this definition,
-      "control" means (i) the power, direct or indirect, to cause the
-      direction or management of such entity, whether by contract or
-      otherwise, or (ii) ownership of fifty percent (50%) or more of the
-      outstanding shares, or (iii) beneficial ownership of such entity.
-
-      "You" (or "Your") shall mean an individual or Legal Entity
-      exercising permissions granted by this License.
-
-      "Source" form shall mean the preferred form for making modifications,
-      including but not limited to software source code, documentation
-      source, and configuration files.
-
-      "Object" form shall mean any form resulting from mechanical
-      transformation or translation of a Source form, including but
-      not limited to compiled object code, generated documentation,
-      and conversions to other media types.
-
-      "Work" shall mean the work of authorship, whether in Source or
-      Object form, made available under the License, as indicated by a
-      copyright notice that is included in or attached to the work
-      (an example is provided in the Appendix below).
-
-      "Derivative Works" shall mean any work, whether in Source or Object
-      form, that is based on (or derived from) the Work and for which the
-      editorial revisions, annotations, elaborations, or other modifications
-      represent, as a whole, an original work of authorship. For the purposes
-      of this License, Derivative Works shall not include works that remain
-      separable from, or merely link (or bind by name) to the interfaces of,
-      the Work and Derivative Works thereof.
-
-      "Contribution" shall mean any work of authorship, including
-      the original version of the Work and any modifications or additions
-      to that Work or Derivative Works thereof, that is intentionally
-      submitted to Licensor for inclusion in the Work by the copyright owner
-      or by an individual or Legal Entity authorized to submit on behalf of
-      the copyright owner. For the purposes of this definition, "submitted"
-      means any form of electronic, verbal, or written communication sent
-      to the Licensor or its representatives, including but not limited to
-      communication on electronic mailing lists, source code control systems,
-      and issue tracking systems that are managed by, or on behalf of, the
-      Licensor for the purpose of discussing and improving the Work, but
-      excluding communication that is conspicuously marked or otherwise
-      designated in writing by the copyright owner as "Not a Contribution."
-
-      "Contributor" shall mean Licensor and any individual or Legal Entity
-      on behalf of whom a Contribution has been received by Licensor and
-      subsequently incorporated within the Work.
-
-   2. Grant of Copyright License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      copyright license to reproduce, prepare Derivative Works of,
-      publicly display, publicly perform, sublicense, and distribute the
-      Work and such Derivative Works in Source or Object form.
-
-   3. Grant of Patent License. Subject to the terms and conditions of
-      this License, each Contributor hereby grants to You a perpetual,
-      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-      (except as stated in this section) patent license to make, have made,
-      use, offer to sell, sell, import, and otherwise transfer the Work,
-      where such license applies only to those patent claims licensable
-      by such Contributor that are necessarily infringed by their
-      Contribution(s) alone or by combination of their Contribution(s)
-      with the Work to which such Contribution(s) was submitted. If You
-      institute patent litigation against any entity (including a
-      cross-claim or counterclaim in a lawsuit) alleging that the Work
-      or a Contribution incorporated within the Work constitutes direct
-      or contributory patent infringement, then any patent licenses
-      granted to You under this License for that Work shall terminate
-      as of the date such litigation is filed.
-
-   4. Redistribution. You may reproduce and distribute copies of the
-      Work or Derivative Works thereof in any medium, with or without
-      modifications, and in Source or Object form, provided that You
-      meet the following conditions:
-
-      (a) You must give any other recipients of the Work or
-          Derivative Works a copy of this License; and
-
-      (b) You must cause any modified files to carry prominent notices
-          stating that You changed the files; and
-
-      (c) You must retain, in the Source form of any Derivative Works
-          that You distribute, all copyright, patent, trademark, and
-          attribution notices from the Source form of the Work,
-          excluding those notices that do not pertain to any part of
-          the Derivative Works; and
-
-      (d) If the Work includes a "NOTICE" text file as part of its
-          distribution, then any Derivative Works that You distribute must
-          include a readable copy of the attribution notices contained
-          within such NOTICE file, excluding those notices that do not
-          pertain to any part of the Derivative Works, in at least one
-          of the following places: within a NOTICE text file distributed
-          as part of the Derivative Works; within the Source form or
-          documentation, if provided along with the Derivative Works; or,
-          within a display generated by the Derivative Works, if and
-          wherever such third-party notices normally appear. The contents
-          of the NOTICE file are for informational purposes only and
-          do not modify the License. You may add Your own attribution
-          notices within Derivative Works that You distribute, alongside
-          or as an addendum to the NOTICE text from the Work, provided
-          that such additional attribution notices cannot be construed
-          as modifying the License.
-
-      You may add Your own copyright statement to Your modifications and
-      may provide additional or different license terms and conditions
-      for use, reproduction, or distribution of Your modifications, or
-      for any such Derivative Works as a whole, provided Your use,
-      reproduction, and distribution of the Work otherwise complies with
-      the conditions stated in this License.
-
-   5. Submission of Contributions. Unless You explicitly state otherwise,
-      any Contribution intentionally submitted for inclusion in the Work
-      by You to the Licensor shall be under the terms and conditions of
-      this License, without any additional terms or conditions.
-      Notwithstanding the above, nothing herein shall supersede or modify
-      the terms of any separate license agreement you may have executed
-      with Licensor regarding such Contributions.
-
-   6. Trademarks. This License does not grant permission to use the trade
-      names, trademarks, service marks, or product names of the Licensor,
-      except as required for reasonable and customary use in describing the
-      origin of the Work and reproducing the content of the NOTICE file.
-
-   7. Disclaimer of Warranty. Unless required by applicable law or
-      agreed to in writing, Licensor provides the Work (and each
-      Contributor provides its Contributions) on an "AS IS" BASIS,
-      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-      implied, including, without limitation, any warranties or conditions
-      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-      PARTICULAR PURPOSE. You are solely responsible for determining the
-      appropriateness of using or redistributing the Work and assume any
-      risks associated with Your exercise of permissions under this License.
-
-   8. Limitation of Liability. In no event and under no legal theory,
-      whether in tort (including negligence), contract, or otherwise,
-      unless required by applicable law (such as deliberate and grossly
-      negligent acts) or agreed to in writing, shall any Contributor be
-      liable to You for damages, including any direct, indirect, special,
-      incidental, or consequential damages of any character arising as a
-      result of this License or out of the use or inability to use the
-      Work (including but not limited to damages for loss of goodwill,
-      work stoppage, computer failure or malfunction, or any and all
-      other commercial damages or losses), even if such Contributor
-      has been advised of the possibility of such damages.
-
-   9. Accepting Warranty or Additional Liability. While redistributing
-      the Work or Derivative Works thereof, You may choose to offer,
-      and charge a fee for, acceptance of support, warranty, indemnity,
-      or other liability obligations and/or rights consistent with this
-      License. However, in accepting such obligations, You may act only
-      on Your own behalf and on Your sole responsibility, not on behalf
-      of any other Contributor, and only if You agree to indemnify,
-      defend, and hold each Contributor harmless for any liability
-      incurred by, or claims asserted against, such Contributor by reason
-      of your accepting any such warranty or additional liability.
-
-   END OF TERMS AND CONDITIONS
-
-   APPENDIX: How to apply the Apache License to your work.
-
-      To apply the Apache License to your work, attach the following
-      boilerplate notice, with the fields enclosed by brackets "[]"
-      replaced with your own identifying information. (Don't include
-      the brackets!)  The text should be enclosed in the appropriate
-      comment syntax for the file format. We also recommend that a
-      file or class name and description of purpose be included on the
-      same "printed page" as the copyright notice for easier
-      identification within third-party archives.
-
-   Copyright [yyyy] [name of copyright owner]
-
-   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.