Merge branch 'init-source'

Author: bvenners

.gitignore

@@ -0,0 +1,4 @@
+*.class
+*.log
+target/
+.idea/

README.md

@@ -0,0 +1,10 @@
+# ScalaTest + Selenium
+ScalaTest + Selenium provides integration support between ScalaTest and Selenium.
+
+**Publishing**
+
+Please use the following commands to publish to Sonatype: 
+
+```
+$ sbt +publishSigned
+```

build.sbt

@@ -0,0 +1,78 @@
+name := "scalatestplus-selenium"
+
+organization := "org.scalatestplus"
+
+version := "1.0.0-SNAP1"
+
+homepage := Some(url("https://github.com/scalatest/scalatestplus-selenium"))
+
+licenses := List("Apache-2.0" -> url("http://www.apache.org/licenses/LICENSE-2.0"))
+
+developers := List(
+  Developer(
+    "bvenners",
+    "Bill Venners",
+    "[email protected]",
+    url("https://github.com/bvenners")
+  ),
+  Developer(
+    "cheeseng",
+    "Chua Chee Seng",
+    "[email protected]",
+    url("https://github.com/cheeseng")
+  )
+)
+
+crossScalaVersions := List("2.10.7", "2.11.12", "2.12.8", "2.13.0-M5")
+
+libraryDependencies ++= Seq(
+  "org.scalatest" %% "scalatest" % "3.1.0-SNAP8",
+  "org.seleniumhq.selenium" % "selenium-java" % "2.45.0",
+  "org.eclipse.jetty" % "jetty-server" % "9.4.12.v20180830" % "test",
+  "org.eclipse.jetty" % "jetty-webapp" % "9.4.12.v20180830" % "test"
+)
+
+testOptions in Test :=
+  Seq(
+    Tests.Argument(TestFrameworks.ScalaTest,
+    "-l", "org.scalatest.tags.Slow"
+  ))
+
+enablePlugins(SbtOsgi)
+
+osgiSettings
+
+OsgiKeys.exportPackage := Seq(
+  "org.scalatestplus.selenium.*"
+)
+
+OsgiKeys.importPackage := Seq(
+  "org.scalatest.*",
+  "org.scalactic.*", 
+  "scala.*;version=\"$<range;[==,=+);$<replace;"+scalaBinaryVersion.value+";-;.>>\"",
+  "*;resolution:=optional"
+)
+
+OsgiKeys.additionalHeaders:= Map(
+  "Bundle-Name" -> "ScalaTestPlusSelenium",
+  "Bundle-Description" -> "ScalaTest+Selenium is an open-source integration library between ScalaTest and Selenium for Scala projects.",
+  "Bundle-DocURL" -> "http://www.scalatest.org/",
+  "Bundle-Vendor" -> "Artima, Inc."
+)
+
+publishTo := {
+  val nexus = "https://oss.sonatype.org/"
+  Some("publish-releases" at nexus + "service/local/staging/deploy/maven2")
+}
+
+publishMavenStyle := true
+
+publishArtifact in Test := false
+
+pomIncludeRepository := { _ => false }
+
+credentials += Credentials(Path.userHome / ".ivy2" / ".credentials")
+
+pgpSecretRing := file((Path.userHome / ".gnupg" / "secring.gpg").getAbsolutePath)
+
+pgpPassphrase := None

project/build.properties

@@ -0,0 +1 @@
+sbt.version=1.2.8

project/plugins.sbt

@@ -0,0 +1,5 @@
+addSbtPlugin("com.jsuereth" % "sbt-pgp" % "1.1.1")
+
+addSbtPlugin("com.geirsson" % "sbt-ci-release" % "1.2.2")
+
+addSbtPlugin("com.typesafe.sbt" % "sbt-osgi" % "0.9.4")

src/main/scala/org/scalatestplus/selenium/Page.scala

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2001-2014 Artima, Inc.
+ *
+ * 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.
+ */
+package org.scalatestplus.selenium
+
+/**
+ * Trait that facilitates using the <em>page object pattern</em> with the ScalaTest Selenium DSL.
+ *
+ * <p>
+ * If you use the page object pattern, mixing trait <code>Page</code> into your page classes will allow you to use the <code>go to</code>
+ * syntax with your page objects. Here's an example:
+ * </p>
+ *
+ * <pre class="stHighlight">
+ * class HomePage extends Page {
+ *   val url = "localhost:9000/index.html"
+ * }
+ *
+ * val homePage = new HomePage
+ * go to homePage
+ * </pre>
+ */
+trait Page {
+  /**
+   * The URL of the page represented by this page object.
+   */
+  val url: String
+}

src/main/scala/org/scalatestplus/selenium/ScreenshotCapturer.scala

@@ -0,0 +1,28 @@
+/*
+ * Copyright 2001-2013 Artima, Inc.
+ *
+ * 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.
+ */
+package org.scalatestplus.selenium
+
+
+/**
+ * Trait containing one abstract method that can capture a screenshot and save it as a file to a given directory.
+ */
+private[selenium] trait ScreenshotCapturer {
+
+  /**
+   * Captures a screenshot and saves it as a file in the specified directory.
+   */
+  def captureScreenshot(directory: String)
+}

src/main/scala/org/scalatestplus/selenium/ScreenshotOnFailure.scala

@@ -0,0 +1,65 @@
+/*
+ * Copyright 2001-2013 Artima, Inc.
+ *
+ * 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.
+ */
+package org.scalatestplus.selenium
+
+import org.scalatest.{TestSuiteMixin, TestSuite, Outcome, Failed}
+
+/**
+ * Stackable trait that when mixed into a <code>Suite with ScreenshotCapturer</code> ensures a screenshot
+ * is captured for every failed test.
+ *
+ * <p>
+ * The screenshot is file is placed in a directory whose name is defined by <code>screenshotDir</code>. By
+ * default, <code>screenshotDir</code> returns the value of the <code>java.io.tmpdir</code> system property.
+ * To change this, override <code>screenshotDir</code>.
+ * </p>
+ */
+private[selenium] trait ScreenshotOnFailure extends TestSuiteMixin { this: TestSuite with ScreenshotCapturer => 
+  
+  /**
+   * The name of the directory into which screenshots will be captured.
+   *
+   * <p>
+   * By default, this method returns the value of the <code>java.io.tmpdir</code> system property.
+   * To change this, override <code>screenshotDir</code>.
+   * </p>
+   */
+  val screenshotDir: String = System.getProperty("java.io.tmpdir")
+  
+  /**
+   * Delegates to <code>super.withFixture</code> to execute the passed <code>NoArgTest</code>, and if the test fails,
+   * captures a screenshot to the directory name defined by <code>screenshotDir</code>.
+   *
+   * <p>
+   * This method captures screenshots by invoking <code>captureScreenshot</code>, defined in trait <code>ScreenshotCapturer</code>.
+   * If <code>captureScreenshot</code> completes abruptly with an exception, information about that exception, including the full
+   * stack trace, is printed to the standard error stream, and the original exception that indicated a failed test is rethrown.
+   * </p>
+   */
+  abstract override def withFixture(test: NoArgTest): Outcome = {
+    super.withFixture(test) match {
+      case failed: Failed =>
+        try captureScreenshot(screenshotDir)
+        catch {
+          case innerE: Throwable =>
+            Console.err.println("Unable to capture screenshot to " + screenshotDir)
+            innerE.printStackTrace(Console.err)
+        }
+        failed
+      case other => other
+    }
+  }
+}