Merge pull request #3 from Hi-Fi/release/2.48.2.0

Release/2.48.2.0

Author: Hi-Fi

.travis.yml

@@ -0,0 +1,25 @@
+language: java
+jdk:
+  - oraclejdk8
+install:
+  - mvn --settings .travis/settings.xml install -Dgpg.skip -B -V
+before_install:
+  - if [ ! -z "$GPG_SECRET_KEYS" ]; then echo $GPG_SECRET_KEYS | base64 --decode | $GPG_EXECUTABLE --import; fi
+  - if [ ! -z "$GPG_OWNERTRUST" ]; then echo $GPG_OWNERTRUST | base64 --decode | $GPG_EXECUTABLE --import-ownertrust; fi
+deploy:
+  -
+    provider: script
+    script: .travis/deploy.sh
+    skip_cleanup: true
+    on:
+      repo: Hi-Fi/robotframework-seleniumlibrary-java
+      branch: master
+      jdk: oraclejdk8
+  -
+    provider: script
+    script: .travis/deploy.sh
+    skip_cleanup: true
+    on:
+      repo: Hi-Fi/robotframework-seleniumlibrary-java
+      tags: true
+      jdk: oraclejdk8

.travis/deploy.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+
+if [ -z "$SONATYPE_USERNAME" ]
+then
+    echo "error: please set SONATYPE_USERNAME and SONATYPE_PASSWORD environment variable"
+    exit 1
+fi
+
+if [ -z "$SONATYPE_PASSWORD" ]
+then
+    echo "error: please set SONATYPE_PASSWORD environment variable"
+    exit 1
+fi
+
+mvn clean deploy --settings .travis/settings.xml -DskipTests=true -B -U -Prelease

.travis/settings.xml

@@ -0,0 +1,25 @@
+<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+ xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
+                      http://maven.apache.org/xsd/settings-1.0.0.xsd">
+    <servers>
+        <server>
+            <!-- Maven Central Deployment -->
+            <id>ossrh</id>
+            <username>${env.SONATYPE_USERNAME}</username>
+            <password>${env.SONATYPE_PASSWORD}</password>
+        </server>
+    </servers>
+    <profiles>
+      <profile>
+        <id>ossrh</id>
+        <activation>
+          <activeByDefault>true</activeByDefault>
+        </activation>
+        <properties>
+          <gpg.executable>${env.GPG_EXECUTABLE}</gpg.executable>
+          <gpg.passphrase>${env.GPG_PASSPHRASE}</gpg.passphrase>
+        </properties>
+      </profile>
+    </profiles>
+</settings>

DEPENDENCIES.md

@@ -1,69 +1,49 @@
-Java port of the Selenium 2 (WebDriver) Python library for Robot Framework
+Java port of the Python based SeleniumLibrary for Robot Framework
 ==========================================================================
 
 Introduction
 ------------
 
-Selenium2Library is a web testing library for Robot Framework that leverages
-the [Selenium 2 (WebDriver)](http://docs.seleniumhq.org/docs/03_webdriver.jsp)
-libraries from the [Selenium](http://docs.seleniumhq.org) project.
-It is modeled after (and forked from) the Robot Framework
-[SeleniumLibrary](http://code.google.com/p/robotframework-seleniumlibrary/)
-library, but re-implemented to use Selenium 2 and WebDriver technologies.
+SeleniumLibrary is a web testing library for Robot Framework that leverages
+the Selenium libraries from the [Selenium](http://docs.seleniumhq.org) project.
+
+Version number follows Selenium's version numbers (first 3 numbers), and 4th number is reserved for e.g. issue fixes.
 * More information about this library can be found in the
-  [Keyword Documentation](http://search.maven.org/remotecontent?filepath=com/github/markusbernhardt/robotframework-selenium2library-java/1.4.0.8/robotframework-selenium2library-java-1.4.0.8-libdoc.html).
+  [Keyword Documentation](http://search.maven.org/remotecontent?filepath=com/github/hi_fi/robotframework-seleniumlibrary-java/2.48.2.0/robotframework-seleniumlibrary-java-2.48.2.0-libdoc.html).
 * For keyword completion in RIDE you can download this
-  [Library Specs](http://search.maven.org/remotecontent?filepath=com/github/markusbernhardt/robotframework-selenium2library-java/1.4.0.8/robotframework-selenium2library-java-1.4.0.8-libdoc.xml)
+  [Library Specs](http://search.maven.org/remotecontent?filepath=com/github/hi_fi/robotframework-seleniumlibrary-java/2.48.2.0/robotframework-seleniumlibrary-java-2.48.2.0-libdoc.xml)
   and place it in your PYTHONPATH.
 
-This Java port of the existing Selenium2Library was created to enable
-the usage of a Selenium 2 library with Jython.
-* Python Selenium2Library needs Python 2.6 upwards
-* The latests stable release of Jython is 2.5.3
-* Jython 2.7b2 is a beta version
-* There seems to be only slow development of a stable Jython 2.7
+This Java version of SeleniumLibrary exists because of easier dependency management when Robot Framework is used in Java-projects.
 
 Usage
 -----
 
-This library is a direct replacement to the Python Selenium2Library.
-There are almost no changes necesssary to the existing code. You 
-can execute the same testcases and keywords with Python and Jython.
+This library is a quite direct alternative to the Python SeleniumLibrary.
 
 If you are using the robotframework-maven-plugin you can
 use this library by adding the following dependency to 
 your pom.xml:
 
     <dependency>
-        <groupId>com.github.markusbernhardt</groupId>
-        <artifactId>robotframework-selenium2library-java</artifactId>
-        <version>1.4.0.8</version>
+        <groupId>com.github.hi_fi</groupId>
+        <artifactId>robotframework-seleniumlibrary-java</artifactId>
+        <version>2.48.2.0</version>
         <scope>test</scope>
     </dependency>
 
 If you cannot use the robotframework-maven-plugin you can use the
-[jar-with-dependencies](http://search.maven.org/remotecontent?filepath=com/github/markusbernhardt/robotframework-selenium2library-java/1.4.0.8/robotframework-selenium2library-java-1.4.0.8-jar-with-dependencies.jar),
+[jar-with-dependencies](http://search.maven.org/remotecontent?filepath=com/github/hi_fi/robotframework-seleniumlibrary-java/2.48.2.0/robotframework-seleniumlibrary-java-2.48.2.0-jar-with-dependencies.jar),
 which contains all required libraries.
 
 If you want more control and feel adventurous you could you use this
-[jar](http://search.maven.org/remotecontent?filepath=com/github/markusbernhardt/robotframework-selenium2library-java/1.4.0.8/robotframework-selenium2library-java-1.4.0.8.jar)
+[jar](http://search.maven.org/remotecontent?filepath=com/github/hi_fi/robotframework-seleniumlibrary-java/2.48.2.0/robotframework-seleniumlibrary-java-2.48.2.0.jar)
 and provide all required libraries from this [list](DEPENDENCIES.md) on your own.
 
 Differences
 -----------
 
-* Selenium Speed not implemented
-
-  Setting the Selenium Speed is deprecated several years and not
-  implemented in WebDriver. The Python Selenium2Library tries to
-  emulate the old behavior. I have not implemented this emulation
-  for the following reasons.
-  
-  * As far as I understand the emulation is broken and only works
-    with RemoteWebDriver
-  * I do not know how to implement that in a correct way with Java 
-  * There is a reason, why this is not implemented in WebDriver.
-    It's a bad idea.
+* Some keyword differences between this and [Python version](https://github.com/robotframework/SeleniumLibrary) exists. (Same) keywords should be aligned in upcoming versions.
 
 Demo
 ----
@@ -79,5 +59,5 @@ Getting Help
 The [user group for Robot Framework](https://groups.google.com/forum/#!forum/robotframework-users)
 is the best place to get help. Consider including in the post:
 * Full description of what you are trying to do and expected outcome
-* Version number of Selenium2Library, Robot Framework, and Selenium
+* Version number of SeleniumLibrary, Robot Framework, and Selenium
 * StackTraces or other debug output containing error information