├── .gitignore
├── README.md
├── NOTICE
├── src
    └── main
    │   └── resources
    │       ├── archetype-resources
    │           ├── src
    │           │   ├── main
    │           │   │   ├── resources
    │           │   │   │   ├── grid2
    │           │   │   │   │   └── README.txt
    │           │   │   │   └── application.properties
    │           │   │   └── java
    │           │   │   │   ├── pages
    │           │   │   │       ├── Page.java
    │           │   │   │       └── HomePage.java
    │           │   │   │   └── util
    │           │   │   │       └── PropertyLoader.java
    │           │   └── test
    │           │   │   ├── resources
    │           │   │       └── testng.xml
    │           │   │   └── java
    │           │   │       ├── HomePageTest.java
    │           │   │       └── TestBase.java
    │           └── pom.xml
    │       └── META-INF
    │           └── maven
    │               └── archetype-metadata.xml
├── .gitattributes
├── pom.xml
└── LICENSE


/.gitignore:
--------------------------------------------------------------------------------
1 | /target
2 | /.project
3 | /.settings
4 | /.classpath
5 | /.idea
6 | /*.iml
7 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | Deprecated in favor of https://github.com/barancev/webdriver-testng-archetype and https://github.com/barancev/webdriver-junit-archetype
2 | 


--------------------------------------------------------------------------------
/NOTICE:
--------------------------------------------------------------------------------
1 | WebDriver Java QuickStart Archetype
2 | Copyright 2013-2014 Alexei Barantsev barancev@gmail.com
3 | 
4 | This product includes software developed by
5 | Sebastiano Armeli-Battana
6 | Licensed under the Apache License 2.0.


--------------------------------------------------------------------------------
/src/main/resources/archetype-resources/src/main/resources/grid2/README.txt:
--------------------------------------------------------------------------------
1 | #set( $symbol_pound = '#' )
2 | #set( $symbol_dollar = '$' )
3 | #set( $symbol_escape = '\' )
4 | Place in this folder the selenium-server-standalone jar to use for the Grid 2, if you need.


--------------------------------------------------------------------------------
/src/main/resources/archetype-resources/src/test/resources/testng.xml:
--------------------------------------------------------------------------------
 1 | #set( $symbol_pound = '#' )
 2 | #set( $symbol_dollar = '$' )
 3 | #set( $symbol_escape = '\' )
 4 | <?xml version="1.0" encoding="UTF-8"?>
 5 | <!DOCTYPE suite SYSTEM "http://testng.org/testng-1.0.dtd" >
 6 | <suite name="Tests" verbose="5" data-provider-thread-count="1">
 7 | 	<test name="Test1">
 8 | 		<parameter name="path" value="/"/>
 9 | 		<classes>
10 | 		    <class name="${groupId}.HomePageTest"/>
11 | 		</classes>
12 | 	</test>  
13 | </suite>


--------------------------------------------------------------------------------
/src/main/resources/archetype-resources/src/main/resources/application.properties:
--------------------------------------------------------------------------------
 1 | #set( $symbol_pound = '#' )
 2 | #set( $symbol_dollar = '$' )
 3 | #set( $symbol_escape = '\' )
 4 | user.username=${symbol_dollar}{user.username}
 5 | user.password=${symbol_dollar}{user.password}
 6 | 
 7 | grid2.hub=${symbol_dollar}{grid2.hub}
 8 | 
 9 | site.url=${symbol_dollar}{site.url}
10 | 
11 | browser.name=${symbol_dollar}{browser.name}
12 | browser.version=${symbol_dollar}{browser.version}
13 | browser.platform=${symbol_dollar}{browser.platform}
14 | 


--------------------------------------------------------------------------------
/.gitattributes:
--------------------------------------------------------------------------------
 1 | # Auto detect text files and perform LF normalization
 2 | * text=auto
 3 | 
 4 | # Custom for Visual Studio
 5 | *.cs     diff=csharp
 6 | *.sln    merge=union
 7 | *.csproj merge=union
 8 | *.vbproj merge=union
 9 | *.fsproj merge=union
10 | *.dbproj merge=union
11 | 
12 | # Standard to msysgit
13 | *.doc	 diff=astextplain
14 | *.DOC	 diff=astextplain
15 | *.docx diff=astextplain
16 | *.DOCX diff=astextplain
17 | *.dot  diff=astextplain
18 | *.DOT  diff=astextplain
19 | *.pdf  diff=astextplain
20 | *.PDF	 diff=astextplain
21 | *.rtf	 diff=astextplain
22 | *.RTF	 diff=astextplain
23 | 


--------------------------------------------------------------------------------
/src/main/resources/archetype-resources/src/main/java/pages/Page.java:
--------------------------------------------------------------------------------
 1 | #set( $symbol_pound = '#' )
 2 | #set( $symbol_dollar = '$' )
 3 | #set( $symbol_escape = '\' )
 4 | package ${groupId}.pages;
 5 | 
 6 | import org.openqa.selenium.WebDriver;
 7 | 
 8 | /**
 9 |  * Abstract class representation of a Page in the UI. Page object pattern
10 |  */
11 | public abstract class Page {
12 | 
13 | 	protected WebDriver webDriver;
14 | 
15 | 	/*
16 | 	 * Constructor injecting the WebDriver interface
17 | 	 * 
18 | 	 * @param webDriver
19 | 	 */
20 | 	public Page(WebDriver webDriver) {
21 | 		this.webDriver = webDriver;
22 | 	}
23 | 
24 | 	public WebDriver getWebDriver() {
25 | 		return webDriver;
26 | 	}
27 | 
28 | 	public String getTitle() {
29 | 		return webDriver.getTitle();
30 | 	}
31 | 
32 | }
33 | 


--------------------------------------------------------------------------------
/src/main/resources/archetype-resources/src/main/java/pages/HomePage.java:
--------------------------------------------------------------------------------
 1 | #set( $symbol_pound = '#' )
 2 | #set( $symbol_dollar = '$' )
 3 | #set( $symbol_escape = '\' )
 4 | package ${groupId}.pages;
 5 | 
 6 | import org.openqa.selenium.WebDriver;
 7 | import org.openqa.selenium.WebElement;
 8 | import org.openqa.selenium.support.CacheLookup;
 9 | import org.openqa.selenium.support.FindBy;
10 | import org.openqa.selenium.support.How;
11 | 
12 | /**
13 |  * Sample page
14 |  */
15 | public class HomePage extends Page {
16 | 
17 | 	private final String H1_TAG = "h1";
18 | 	
19 | 	@FindBy(how = How.TAG_NAME, using = H1_TAG)
20 | 	@CacheLookup
21 | 	private WebElement h1Element;
22 | 	
23 | 	public HomePage(WebDriver webDriver) {
24 | 		super(webDriver);
25 | 	}
26 | 	
27 | 	public String getH1() {
28 | 		return h1Element.getText();
29 | 	}
30 | 
31 | }
32 | 


--------------------------------------------------------------------------------
/src/main/resources/archetype-resources/src/main/java/util/PropertyLoader.java:
--------------------------------------------------------------------------------
 1 | #set( $symbol_pound = '#' )
 2 | #set( $symbol_dollar = '$' )
 3 | #set( $symbol_escape = '\' )
 4 | package ${groupId}.util;
 5 | 
 6 | import java.io.IOException;
 7 | import java.util.Properties;
 8 | 
 9 | /**
10 |  * Class that extracts properties from the prop file.
11 |  */
12 | public class PropertyLoader {
13 | 
14 | 	private static final String PROP_FILE = "/application.properties";
15 | 
16 | 	public static String loadProperty(String name) {
17 | 		Properties props = new Properties();
18 | 		try {
19 | 			props.load(PropertyLoader.class.getResourceAsStream(PROP_FILE));
20 | 		} catch (IOException e) {
21 | 			e.printStackTrace();
22 | 		}
23 | 
24 | 		String value = null;
25 | 
26 | 		if (name != null) {
27 | 			value = props.getProperty(name);
28 | 		}
29 | 		return value;
30 | 	}
31 | }


--------------------------------------------------------------------------------
/src/main/resources/archetype-resources/src/test/java/HomePageTest.java:
--------------------------------------------------------------------------------
 1 | #set( $symbol_pound = '#' )
 2 | #set( $symbol_dollar = '$' )
 3 | #set( $symbol_escape = '\' )
 4 | package ${groupId};
 5 | 
 6 | import org.openqa.selenium.support.PageFactory;
 7 | import org.testng.Assert;
 8 | import org.testng.annotations.BeforeClass;
 9 | import org.testng.annotations.Parameters;
10 | import org.testng.annotations.Test;
11 | 
12 | import ${groupId}.pages.HomePage;
13 | 
14 | public class HomePageTest extends TestBase {
15 | 
16 | 	HomePage homepage;
17 | 	
18 | 	@Parameters({ "path" })
19 | 	@BeforeClass
20 | 	public void testInit(String path) {
21 | 
22 | 		// Load the page in the browser
23 | 		driver.get(baseUrl + path);
24 | 		homepage = PageFactory.initElements(driver, HomePage.class);
25 | 	}
26 | 
27 | 	@Test
28 | 	public void testH1Existing() throws InterruptedException {
29 | 		Assert.assertTrue(homepage.getH1() != null);
30 | 	}
31 | 
32 | 	@Test
33 | 	public void test2() throws InterruptedException {
34 | 		Assert.assertTrue(true);
35 | 	}
36 | }
37 | 


--------------------------------------------------------------------------------
/src/main/resources/META-INF/maven/archetype-metadata.xml:
--------------------------------------------------------------------------------
 1 | <!-- Licensed under the Apache License, Version 2.0 (the "License"); you 
 2 | 	may not use this file except in compliance with the License. You may obtain 
 3 | 	a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless 
 4 | 	required by applicable law or agreed to in writing, software distributed 
 5 | 	under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES 
 6 | 	OR CONDITIONS OF ANY KIND, either express or implied. See the License for 
 7 | 	the specific language governing permissions and limitations under the License. -->
 8 | <archetype-descriptor name="selenium2-java-quickstart-archetype">
 9 | 	<fileSets>
10 | 		<fileSet filtered="true" encoding="UTF-8">
11 | 			<directory></directory>
12 | 			<includes>
13 | 				<include>*.xml</include>
14 | 			</includes>
15 | 		</fileSet>
16 | 		<fileSet filtered="true" packaged="true" encoding="UTF-8">
17 | 			<directory>src/main/java</directory>
18 | 		</fileSet>
19 | 		<fileSet filtered="true" packaged="true" encoding="UTF-8">
20 | 			<directory>src/test/java</directory>
21 | 		</fileSet>
22 | 		<fileSet filtered="true" encoding="UTF-8">
23 | 			<directory>src/main/resources</directory>
24 | 		</fileSet>
25 | 		<fileSet>
26 | 			<directory>src/main/resources/grid2</directory>
27 | 		</fileSet>
28 | 		<fileSet filtered="true" encoding="UTF-8">
29 | 			<directory>src/test/resources</directory>
30 | 		</fileSet>
31 | 	</fileSets>
32 | </archetype-descriptor>


--------------------------------------------------------------------------------
/src/main/resources/archetype-resources/src/test/java/TestBase.java:
--------------------------------------------------------------------------------
 1 | #set( $symbol_pound = '#' )
 2 | #set( $symbol_dollar = '$' )
 3 | #set( $symbol_escape = '\' )
 4 | package ${groupId};
 5 | 
 6 | import java.util.concurrent.TimeUnit;
 7 | 
 8 | import org.openqa.selenium.Platform;
 9 | import org.openqa.selenium.WebDriver;
10 | import org.openqa.selenium.remote.DesiredCapabilities;
11 | 
12 | import org.testng.annotations.AfterSuite;
13 | import org.testng.annotations.BeforeClass;
14 | 
15 | import ru.stqa.selenium.factory.WebDriverFactory;
16 | 
17 | import ${groupId}.util.PropertyLoader;
18 | 
19 | /**
20 |  * Base class for all the TestNG-based test classes
21 |  */
22 | public class TestBase {
23 | 	protected WebDriver driver;
24 | 
25 | 	protected String gridHubUrl;
26 | 
27 | 	protected String baseUrl;
28 | 
29 | 	@BeforeClass
30 | 	public void init() {
31 | 		baseUrl = PropertyLoader.loadProperty("site.url");
32 | 		gridHubUrl = PropertyLoader.loadProperty("grid2.hub");
33 | 
34 | 		DesiredCapabilities capabilities = new DesiredCapabilities();
35 | 		capabilities.setBrowserName(PropertyLoader.loadProperty("browser.name"));
36 | 		capabilities.setVersion(PropertyLoader.loadProperty("browser.version"));
37 | 		String platform = PropertyLoader.loadProperty("browser.platform");
38 | 		if (!(null == platform || "".equals(platform))) {
39 | 			capabilities.setPlatform(Platform.valueOf(PropertyLoader.loadProperty("browser.platform")));
40 | 		}
41 | 
42 | 		if (!(null == gridHubUrl || "".equals(gridHubUrl))) {
43 | 			driver = WebDriverFactory.getDriver(gridHubUrl, capabilities);
44 | 		} else {
45 | 			driver = WebDriverFactory.getDriver(capabilities);
46 | 		}
47 | 		driver.manage().timeouts().implicitlyWait(30, TimeUnit.SECONDS);
48 | 	}
49 | 
50 | 	@AfterSuite(alwaysRun = true)
51 | 	public void tearDown() {
52 | 		if (driver != null) {
53 | 			WebDriverFactory.dismissDriver(driver);
54 | 		}
55 | 	}
56 | }
57 | 


--------------------------------------------------------------------------------
/pom.xml:
--------------------------------------------------------------------------------
 1 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 2 |   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
 3 |   <modelVersion>4.0.0</modelVersion>
 4 | 
 5 |   <groupId>ru.stqa.selenium</groupId>
 6 |   <artifactId>webdriver-java-quickstart-archetype</artifactId>
 7 |   <version>0.8</version>
 8 |   <packaging>maven-archetype</packaging>
 9 | 
10 |   <name>WebDriver Java QuickStart Archetype</name>
11 |   <description>Generates a QuickStart project with WebDriver and TestNG</description>
12 |     <url>https://github.com/barancev/webdriver-java-quickstart-archetype</url>
13 | 
14 |   <properties>
15 |     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
16 |     <archetype.version>2.2</archetype.version>
17 |   </properties>
18 | 
19 |   <licenses>
20 |     <license>
21 |       <name>The Apache Software License, Version 2.0</name>
22 |       <url>http://www.apache.org/licenses/LICENSE-2.0.txt</url>
23 |     </license>
24 |   </licenses>
25 | 
26 |   <scm>
27 |     <connection>scm:git:https://github.com/barancev/webdriver-java-quickstart-archetype</connection>
28 |     <developerConnection>scm:git:https://github.com/barancev/webdriver-java-quickstart-archetype</developerConnection>
29 |     <url>https://github.com/barancev/webdriver-java-quickstart-archetype</url>
30 |   </scm>
31 | 
32 |   <developers>
33 |     <developer>
34 |       <id>barancev</id>
35 |       <name>Alexei Barantsev</name>
36 |       <roles>
37 |         <role>Owner</role>
38 |       </roles>
39 |     </developer>
40 |   </developers>
41 | 
42 |   <build>
43 |     <extensions>
44 |       <extension>
45 |         <groupId>org.apache.maven.archetype</groupId>
46 |         <artifactId>archetype-packaging</artifactId>
47 |         <version>${archetype.version}</version>
48 |       </extension>
49 |     </extensions>
50 |     <pluginManagement>
51 |       <plugins>
52 |         <plugin>
53 |           <artifactId>maven-archetype-plugin</artifactId>
54 |           <version>${archetype.version}</version>
55 |           <extensions>true</extensions>
56 |         </plugin>
57 |       </plugins>
58 |     </pluginManagement>
59 |   </build>
60 | 
61 |   <distributionManagement>
62 |     <snapshotRepository>
63 |       <id>sonatype-nexus-snapshots</id>
64 |       <url>http://oss.sonatype.org/content/repositories/snapshots</url>
65 |     </snapshotRepository>
66 |     <repository>
67 |       <id>sonatype-nexus-staging</id>
68 |       <url>http://oss.sonatype.org/service/local/staging/deploy/maven2</url>
69 |     </repository>
70 |   </distributionManagement>
71 | 
72 | </project>
73 | 


--------------------------------------------------------------------------------
/src/main/resources/archetype-resources/pom.xml:
--------------------------------------------------------------------------------
  1 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  2 |   xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  3 |   <modelVersion>4.0.0</modelVersion>
  4 |   <groupId>${groupId}</groupId>
  5 |   <artifactId>${artifactId}</artifactId>
  6 |   <version>${version}</version>
  7 |   <packaging>jar</packaging>
  8 | 
  9 |   <dependencies>
 10 |     <dependency>
 11 |       <groupId>org.testng</groupId>
 12 |       <artifactId>testng</artifactId>
 13 |       <version>6.9.4</version>
 14 |     </dependency>
 15 |     <dependency>
 16 |       <groupId>junit</groupId>
 17 |       <artifactId>junit</artifactId>
 18 |       <version>4.12</version>
 19 |     </dependency>
 20 |     <dependency>
 21 |       <groupId>ru.stqa.selenium</groupId>
 22 |       <artifactId>webdriver-factory</artifactId>
 23 |       <version>1.1.46</version>
 24 |     </dependency>
 25 |   </dependencies>
 26 |   <build>
 27 |     <resources> 
 28 |       <resource>
 29 |         <directory>src/main/resources</directory>
 30 |         <filtering>true</filtering>
 31 |       </resource>
 32 |     </resources>
 33 |     <plugins>
 34 |       <plugin>
 35 |         <groupId>org.apache.maven.plugins</groupId>
 36 |         <artifactId>maven-resources-plugin</artifactId>
 37 |         <version>2.6</version>
 38 |         <configuration>
 39 |           <encoding>UTF-8</encoding>
 40 |         </configuration>
 41 |       </plugin> 
 42 |       <plugin>
 43 |         <artifactId>maven-surefire-plugin</artifactId>
 44 |         <version>2.16</version>
 45 |         <configuration>
 46 |           <suiteXmlFiles>
 47 |             <suiteXmlFile>src/test/resources/testng.xml</suiteXmlFile>
 48 |           </suiteXmlFiles>
 49 |         </configuration>
 50 |       </plugin>
 51 |       <plugin>
 52 |         <artifactId>maven-compiler-plugin</artifactId>
 53 |         <version>3.1</version>
 54 |         <configuration>
 55 |           <source>1.6</source>
 56 |           <target>1.6</target>
 57 |         </configuration>
 58 |       </plugin>
 59 |     </plugins>
 60 |   </build>
 61 |   <!-- profiles -->
 62 |   <profiles>
 63 |     <profile>
 64 |       <id>local</id>
 65 |       <properties>
 66 |         <env>local</env>
 67 |         <user.username></user.username>
 68 |         <user.password></user.password>
 69 |         <grid2.hub></grid2.hub>
 70 |         <site.url>http://localhost/</site.url>
 71 |         <browser.name>firefox</browser.name>
 72 |         <browser.version></browser.version>
 73 |         <browser.platform></browser.platform>
 74 |       </properties>
 75 |       <activation>
 76 |         <activeByDefault>true</activeByDefault>
 77 |       </activation>
 78 |     </profile>
 79 |     <profile>
 80 |       <id>dev</id>
 81 |       <properties>
 82 |         <env>dev</env>
 83 |         <user.username></user.username>
 84 |         <user.password></user.password>
 85 |         <grid2.hub></grid2.hub>
 86 |         <site.url>http://devhost/</site.url>
 87 |         <browser.name>firefox</browser.name>
 88 |         <browser.version></browser.version>
 89 |         <browser.platform></browser.platform>
 90 |       </properties>
 91 |     </profile>
 92 |     <profile>
 93 |       <id>test</id>
 94 |       <properties>
 95 |         <env>test</env>
 96 |         <user.username></user.username>
 97 |         <user.password></user.password>
 98 |         <grid2.hub></grid2.hub>
 99 |         <site.url>http://testhost/</site.url>
100 |         <browser.name>firefox</browser.name>
101 |         <browser.version></browser.version>
102 |         <browser.platform></browser.platform>
103 |       </properties>
104 |     </profile>
105 |     <profile>
106 |       <id>prod</id>
107 |       <properties>
108 |         <env>prod</env>
109 |         <user.username></user.username>
110 |         <user.password></user.password>
111 |         <grid2.hub></grid2.hub>
112 |         <site.url>http://prodhost/</site.url>
113 |         <browser.name>firefox</browser.name>
114 |         <browser.version></browser.version>
115 |         <browser.platform></browser.platform>
116 |       </properties>
117 |     </profile>
118 |     <profile>
119 |       <id>force-local-driver</id>
120 |       <properties>
121 |         <grid2.hub></grid2.hub>
122 |       </properties>
123 |     </profile>
124 |   </profiles>
125 | </project>
126 | 


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
  1 |                                  Apache License
  2 |                            Version 2.0, January 2004
  3 |                         http://www.apache.org/licenses/
  4 | 
  5 |    TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
  6 | 
  7 |    1. Definitions.
  8 | 
  9 |       "License" shall mean the terms and conditions for use, reproduction,
 10 |       and distribution as defined by Sections 1 through 9 of this document.
 11 | 
 12 |       "Licensor" shall mean the copyright owner or entity authorized by
 13 |       the copyright owner that is granting the License.
 14 | 
 15 |       "Legal Entity" shall mean the union of the acting entity and all
 16 |       other entities that control, are controlled by, or are under common
 17 |       control with that entity. For the purposes of this definition,
 18 |       "control" means (i) the power, direct or indirect, to cause the
 19 |       direction or management of such entity, whether by contract or
 20 |       otherwise, or (ii) ownership of fifty percent (50%) or more of the
 21 |       outstanding shares, or (iii) beneficial ownership of such entity.
 22 | 
 23 |       "You" (or "Your") shall mean an individual or Legal Entity
 24 |       exercising permissions granted by this License.
 25 | 
 26 |       "Source" form shall mean the preferred form for making modifications,
 27 |       including but not limited to software source code, documentation
 28 |       source, and configuration files.
 29 | 
 30 |       "Object" form shall mean any form resulting from mechanical
 31 |       transformation or translation of a Source form, including but
 32 |       not limited to compiled object code, generated documentation,
 33 |       and conversions to other media types.
 34 | 
 35 |       "Work" shall mean the work of authorship, whether in Source or
 36 |       Object form, made available under the License, as indicated by a
 37 |       copyright notice that is included in or attached to the work
 38 |       (an example is provided in the Appendix below).
 39 | 
 40 |       "Derivative Works" shall mean any work, whether in Source or Object
 41 |       form, that is based on (or derived from) the Work and for which the
 42 |       editorial revisions, annotations, elaborations, or other modifications
 43 |       represent, as a whole, an original work of authorship. For the purposes
 44 |       of this License, Derivative Works shall not include works that remain
 45 |       separable from, or merely link (or bind by name) to the interfaces of,
 46 |       the Work and Derivative Works thereof.
 47 | 
 48 |       "Contribution" shall mean any work of authorship, including
 49 |       the original version of the Work and any modifications or additions
 50 |       to that Work or Derivative Works thereof, that is intentionally
 51 |       submitted to Licensor for inclusion in the Work by the copyright owner
 52 |       or by an individual or Legal Entity authorized to submit on behalf of
 53 |       the copyright owner. For the purposes of this definition, "submitted"
 54 |       means any form of electronic, verbal, or written communication sent
 55 |       to the Licensor or its representatives, including but not limited to
 56 |       communication on electronic mailing lists, source code control systems,
 57 |       and issue tracking systems that are managed by, or on behalf of, the
 58 |       Licensor for the purpose of discussing and improving the Work, but
 59 |       excluding communication that is conspicuously marked or otherwise
 60 |       designated in writing by the copyright owner as "Not a Contribution."
 61 | 
 62 |       "Contributor" shall mean Licensor and any individual or Legal Entity
 63 |       on behalf of whom a Contribution has been received by Licensor and
 64 |       subsequently incorporated within the Work.
 65 | 
 66 |    2. Grant of Copyright License. Subject to the terms and conditions of
 67 |       this License, each Contributor hereby grants to You a perpetual,
 68 |       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 69 |       copyright license to reproduce, prepare Derivative Works of,
 70 |       publicly display, publicly perform, sublicense, and distribute the
 71 |       Work and such Derivative Works in Source or Object form.
 72 | 
 73 |    3. Grant of Patent License. Subject to the terms and conditions of
 74 |       this License, each Contributor hereby grants to You a perpetual,
 75 |       worldwide, non-exclusive, no-charge, royalty-free, irrevocable
 76 |       (except as stated in this section) patent license to make, have made,
 77 |       use, offer to sell, sell, import, and otherwise transfer the Work,
 78 |       where such license applies only to those patent claims licensable
 79 |       by such Contributor that are necessarily infringed by their
 80 |       Contribution(s) alone or by combination of their Contribution(s)
 81 |       with the Work to which such Contribution(s) was submitted. If You
 82 |       institute patent litigation against any entity (including a
 83 |       cross-claim or counterclaim in a lawsuit) alleging that the Work
 84 |       or a Contribution incorporated within the Work constitutes direct
 85 |       or contributory patent infringement, then any patent licenses
 86 |       granted to You under this License for that Work shall terminate
 87 |       as of the date such litigation is filed.
 88 | 
 89 |    4. Redistribution. You may reproduce and distribute copies of the
 90 |       Work or Derivative Works thereof in any medium, with or without
 91 |       modifications, and in Source or Object form, provided that You
 92 |       meet the following conditions:
 93 | 
 94 |       (a) You must give any other recipients of the Work or
 95 |           Derivative Works a copy of this License; and
 96 | 
 97 |       (b) You must cause any modified files to carry prominent notices
 98 |           stating that You changed the files; and
 99 | 
100 |       (c) You must retain, in the Source form of any Derivative Works
101 |           that You distribute, all copyright, patent, trademark, and
102 |           attribution notices from the Source form of the Work,
103 |           excluding those notices that do not pertain to any part of
104 |           the Derivative Works; and
105 | 
106 |       (d) If the Work includes a "NOTICE" text file as part of its
107 |           distribution, then any Derivative Works that You distribute must
108 |           include a readable copy of the attribution notices contained
109 |           within such NOTICE file, excluding those notices that do not
110 |           pertain to any part of the Derivative Works, in at least one
111 |           of the following places: within a NOTICE text file distributed
112 |           as part of the Derivative Works; within the Source form or
113 |           documentation, if provided along with the Derivative Works; or,
114 |           within a display generated by the Derivative Works, if and
115 |           wherever such third-party notices normally appear. The contents
116 |           of the NOTICE file are for informational purposes only and
117 |           do not modify the License. You may add Your own attribution
118 |           notices within Derivative Works that You distribute, alongside
119 |           or as an addendum to the NOTICE text from the Work, provided
120 |           that such additional attribution notices cannot be construed
121 |           as modifying the License.
122 | 
123 |       You may add Your own copyright statement to Your modifications and
124 |       may provide additional or different license terms and conditions
125 |       for use, reproduction, or distribution of Your modifications, or
126 |       for any such Derivative Works as a whole, provided Your use,
127 |       reproduction, and distribution of the Work otherwise complies with
128 |       the conditions stated in this License.
129 | 
130 |    5. Submission of Contributions. Unless You explicitly state otherwise,
131 |       any Contribution intentionally submitted for inclusion in the Work
132 |       by You to the Licensor shall be under the terms and conditions of
133 |       this License, without any additional terms or conditions.
134 |       Notwithstanding the above, nothing herein shall supersede or modify
135 |       the terms of any separate license agreement you may have executed
136 |       with Licensor regarding such Contributions.
137 | 
138 |    6. Trademarks. This License does not grant permission to use the trade
139 |       names, trademarks, service marks, or product names of the Licensor,
140 |       except as required for reasonable and customary use in describing the
141 |       origin of the Work and reproducing the content of the NOTICE file.
142 | 
143 |    7. Disclaimer of Warranty. Unless required by applicable law or
144 |       agreed to in writing, Licensor provides the Work (and each
145 |       Contributor provides its Contributions) on an "AS IS" BASIS,
146 |       WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
147 |       implied, including, without limitation, any warranties or conditions
148 |       of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
149 |       PARTICULAR PURPOSE. You are solely responsible for determining the
150 |       appropriateness of using or redistributing the Work and assume any
151 |       risks associated with Your exercise of permissions under this License.
152 | 
153 |    8. Limitation of Liability. In no event and under no legal theory,
154 |       whether in tort (including negligence), contract, or otherwise,
155 |       unless required by applicable law (such as deliberate and grossly
156 |       negligent acts) or agreed to in writing, shall any Contributor be
157 |       liable to You for damages, including any direct, indirect, special,
158 |       incidental, or consequential damages of any character arising as a
159 |       result of this License or out of the use or inability to use the
160 |       Work (including but not limited to damages for loss of goodwill,
161 |       work stoppage, computer failure or malfunction, or any and all
162 |       other commercial damages or losses), even if such Contributor
163 |       has been advised of the possibility of such damages.
164 | 
165 |    9. Accepting Warranty or Additional Liability. While redistributing
166 |       the Work or Derivative Works thereof, You may choose to offer,
167 |       and charge a fee for, acceptance of support, warranty, indemnity,
168 |       or other liability obligations and/or rights consistent with this
169 |       License. However, in accepting such obligations, You may act only
170 |       on Your own behalf and on Your sole responsibility, not on behalf
171 |       of any other Contributor, and only if You agree to indemnify,
172 |       defend, and hold each Contributor harmless for any liability
173 |       incurred by, or claims asserted against, such Contributor by reason
174 |       of your accepting any such warranty or additional liability.
175 | 
176 |    END OF TERMS AND CONDITIONS
177 | 
178 |    APPENDIX: How to apply the Apache License to your work.
179 | 
180 |       To apply the Apache License to your work, attach the following
181 |       boilerplate notice, with the fields enclosed by brackets "[]"
182 |       replaced with your own identifying information. (Don't include
183 |       the brackets!)  The text should be enclosed in the appropriate
184 |       comment syntax for the file format. We also recommend that a
185 |       file or class name and description of purpose be included on the
186 |       same "printed page" as the copyright notice for easier
187 |       identification within third-party archives.
188 | 
189 |    Copyright [yyyy] [name of copyright owner]
190 | 
191 |    Licensed under the Apache License, Version 2.0 (the "License");
192 |    you may not use this file except in compliance with the License.
193 |    You may obtain a copy of the License at
194 | 
195 |        http://www.apache.org/licenses/LICENSE-2.0
196 | 
197 |    Unless required by applicable law or agreed to in writing, software
198 |    distributed under the License is distributed on an "AS IS" BASIS,
199 |    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
200 |    See the License for the specific language governing permissions and
201 |    limitations under the License.


--------------------------------------------------------------------------------