add basic structure of the library

add general interfaces
update license file

Author: mialeska

.gitignore

@@ -0,0 +1,40 @@
+# Created by .ignore support plugin (hsz.mobi)
+### Java template
+# Compiled class file
+*.class
+
+# Log file
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Mobile Tools for Java (J2ME)
+.mtj.tmp/
+
+# Package Files #
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+### Maven template
+target/
+pom.xml.tag
+pom.xml.releaseBackup
+pom.xml.versionsBackup
+pom.xml.next
+release.properties
+dependency-reduced-pom.xml
+buildNumber.properties
+.mvn/timing.properties
+
+# Avoid ignoring Maven wrapper jar file (.jar files are usually ignored)
+!/.mvn/wrapper/maven-wrapper.jar
+.gitignore
+.idea/

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright [yyyy] [name of copyright owner]
+   Copyright 2019 Aquality Automation
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

pom.xml

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.github.aquality-automation</groupId>
+    <artifactId>aquality-appium</artifactId>
+    <version>1.0-SNAPSHOT</version>
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <configuration>
+                    <source>8</source>
+                    <target>8</target>
+                </configuration>
+            </plugin>
+        </plugins>
+    </build>
+    <dependencies>
+        <dependency>
+            <groupId>com.fasterxml.jackson.core</groupId>
+            <artifactId>jackson-databind</artifactId>
+            <version>2.9.9</version>
+        </dependency>
+        <dependency>
+            <groupId>log4j</groupId>
+            <artifactId>log4j</artifactId>
+            <version>1.2.17</version>
+        </dependency>
+        <dependency>
+            <groupId>io.appium</groupId>
+            <artifactId>java-client</artifactId>
+            <version>4.1.2</version>
+        </dependency>
+    </dependencies>
+
+
+</project>

src/main/java/aquality/appium/application/Application.java

@@ -0,0 +1,44 @@
+package aquality.appium.application;
+
+import aquality.appium.configuration.IConfiguration;
+import aquality.appium.configuration.ITimeoutConfiguration;
+import aquality.appium.logger.Logger;
+import io.appium.java_client.AppiumDriver;
+
+public class Application {
+
+    private final Logger logger = Logger.getInstance();
+    private final IConfiguration configuration;
+    private final ITimeoutConfiguration timeouts;
+    private Long timeoutImpl;
+    private final AppiumDriver appiumDriver;
+
+    public Application(AppiumDriver appiumDriver, IConfiguration configuration) {
+        this.appiumDriver = appiumDriver;
+        this.configuration = configuration;
+        this.timeouts = configuration.getTimeoutConfiguration();
+        this.timeoutImpl = timeouts.getImplicit();
+        /*
+        todo: determine if all of these timeouts are necessary to be set this way
+        getDriver().manage().timeouts().implicitlyWait(timeoutImpl, TimeUnit.SECONDS);
+        setPageLoadTimeout(timeouts.getPageLoad());
+        setScriptTimeout(timeouts.getScript());
+         */
+    }
+
+    /**
+     * Provides AppiumDriver instance for current application session
+     * @return web driver instance
+     */
+    public AppiumDriver getDriver() {
+        return appiumDriver;
+    }
+
+    /**
+     * Returns platform of current application
+     * @return name
+     */
+    public final ApplicationPlatform geApplicationPlatform() {
+        return configuration.getApplicationProfile().getApplicationName();
+    }
+}

src/main/java/aquality/appium/application/ApplicationManager.java

@@ -0,0 +1,52 @@
+package aquality.appium.application;
+
+import aquality.appium.configuration.IConfiguration;
+
+public class ApplicationManager {
+    private static final ThreadLocal<Application> applicationContainer = new ThreadLocal<>();
+    private static final ThreadLocal<IApplicationFactory> factoryContainer = new ThreadLocal<>();
+
+    private ApplicationManager() {
+    }
+
+
+    public static Application getApplication(){
+        if(applicationContainer.get() == null || applicationContainer.get().getDriver().getSessionId() == null) {
+            setDefaultApplication();
+        }
+        return applicationContainer.get();
+    }
+
+    public static void setDefaultFactory(){
+        /*
+        todo: to be implemented
+        IConfiguration configuration = Configuration.getInstance();
+        IApplicationFactory applicationFactory = Configuration.getInstance().getApplicationProfile().isRemote()
+                ? new RemoteApplicationFactory(configuration) : new LocalApplicationFactory(configuration);
+
+        setFactory(applicationFactory);*/
+    }
+
+    public static void setFactory(IApplicationFactory applicationFactory){
+        remove(factoryContainer);
+        ApplicationManager.factoryContainer.set(applicationFactory);
+    }
+
+    private static void setDefaultApplication(){
+        if(factoryContainer.get() == null){
+            setDefaultFactory();
+        }
+        setApplication(factoryContainer.get().getApplication());
+    }
+
+    public static void setApplication(Application application){
+        remove(applicationContainer);
+        ApplicationManager.applicationContainer.set(application);
+    }
+
+    private static void remove(ThreadLocal<?> container){
+        if(container.get() != null){
+            container.remove();
+        }
+    }
+}

src/main/java/aquality/appium/application/ApplicationPlatform.java

@@ -0,0 +1,6 @@
+package aquality.appium.application;
+
+public enum  ApplicationPlatform {
+    ANDROID,
+    IOS
+}

src/main/java/aquality/appium/application/IApplicationFactory.java

@@ -0,0 +1,6 @@
+package aquality.appium.application;
+
+public interface IApplicationFactory {
+
+    Application getApplication();
+}

src/main/java/aquality/appium/configuration/IApplicationProfile.java

@@ -0,0 +1,19 @@
+package aquality.appium.configuration;
+
+import aquality.appium.application.ApplicationPlatform;
+import aquality.appium.configuration.driversettings.IDriverSettings;
+
+import java.net.URL;
+
+public interface IApplicationProfile {
+
+    ApplicationPlatform getApplicationName();
+
+    boolean isRemote();
+
+    boolean isElementHighlightEnabled();
+
+    IDriverSettings getDriverSettings();
+
+    URL getRemoteConnectionUrl();
+}

src/main/java/aquality/appium/configuration/IConfiguration.java

@@ -0,0 +1,12 @@
+package aquality.appium.configuration;
+
+public interface IConfiguration {
+
+    IApplicationProfile getApplicationProfile();
+
+    ITimeoutConfiguration getTimeoutConfiguration();
+
+    IRetryConfiguration getRetryConfiguration();
+
+    ILoggerConfiguration getLoggerConfiguration();
+}

src/main/java/aquality/appium/configuration/ILoggerConfiguration.java

@@ -0,0 +1,6 @@
+package aquality.appium.configuration;
+
+public interface ILoggerConfiguration {
+
+    //todo: SupportedLanguage getLanguage();
+}