Add Presto container (testcontainers#2196)

* Add Presto container

* Add incubating note to module docs

Co-authored-by: Richard North <rich.north@gmail.com>

docs/modules/databases/index.md

@@ -69,6 +69,10 @@ Insert `tc:` after `jdbc:` as follows. Note that the hostname, port and database
 
 `jdbc:tc:postgis:9.6:///databasename`
 
+### Using Presto
+
+`jdbc:tc:presto:329://localhost/memory/default`
+
 ## Using a classpath init script
 
 Testcontainers can run an init script after the database container is started, but before your code is given a connection to it. The script must be on the classpath, and is referenced as follows:

docs/modules/databases/presto.md

@@ -0,0 +1,88 @@
+# Presto Module
+
+!!! note
+    This module is INCUBATING. While it is ready for use and operational in the current version of Testcontainers, it is possible that it may receive breaking changes in the future. See [our contributing guidelines](/contributing/#incubating-modules) for more information on our incubating modules policy.
+
+See [Database containers](./index.md) for documentation and usage that is common to all database container types.
+
+## Usage example
+
+Running Presto as a stand-in for in a test:
+
+```java
+public class SomeTest {
+
+    @Rule
+    public PrestoContainer presto = new PrestoContainer();
+
+    @Test
+    public void someTestMethod() {
+        String url = presto.getJdbcUrl();
+
+        ... create a connection and run test as normal
+```
+
+Presto comes with several catalogs preconfigured. Most useful ones for testing are
+
+* `tpch` catalog using the [Presto TPCH Connector](https://prestosql.io/docs/current/connector/tpch.html).
+  This is a read-only catalog that defines standard TPCH schema, so is available for querying without a need
+  to create any tables.
+* `memory` catalog using the [Presto Memory Connector](https://prestosql.io/docs/current/connector/memory.html).
+  This catalog can be used for creating schemas and tables and does not require any storage, as everything
+  is stored fully in-memory.
+
+Example test using the `tpch` and `memory` catalogs:
+
+```java
+public class SomeTest {
+    @Rule
+    public PrestoContainer prestoSql = new PrestoContainer();
+
+    @Test
+    public void queryMemoryAndTpchConnectors() throws SQLException {
+        try (Connection connection = prestoSql.createConnection();
+             Statement statement = connection.createStatement()) {
+            // Prepare data
+            statement.execute("CREATE TABLE memory.default.table_with_array AS SELECT 1 id, ARRAY[1, 42, 2, 42, 4, 42] my_array");
+
+            // Query Presto using newly created table and a builtin connector
+            try (ResultSet resultSet = statement.executeQuery("" +
+                "SELECT nationkey, element " +
+                "FROM tpch.tiny.nation " +
+                "JOIN memory.default.table_with_array twa ON nationkey = twa.id " +
+                "LEFT JOIN UNNEST(my_array) a(element) ON true " +
+                "ORDER BY element OFFSET 1 FETCH NEXT 3 ROWS WITH TIES ")) {
+                List<Integer> actualElements = new ArrayList<>();
+                while (resultSet.next()) {
+                    actualElements.add(resultSet.getInt("element"));
+                }
+                Assert.assertEquals(Arrays.asList(2, 4, 42, 42, 42), actualElements);
+            }
+        }
+    }
+}
+```
+
+## Adding this module to your project dependencies
+
+Add the following dependency to your `pom.xml`/`build.gradle` file:
+
+```groovy tab='Gradle'
+testCompile "org.testcontainers:presto:{{latest_version}}"
+```
+
+```xml tab='Maven'
+<dependency>
+    <groupId>org.testcontainers</groupId>
+    <artifactId>presto</artifactId>
+    <version>{{latest_version}}</version>
+    <scope>test</scope>
+</dependency>
+```
+
+!!! hint
+    Adding this Testcontainers library JAR will not automatically add the Presto JDBC driver JAR to your project.
+    You should ensure that your project has the Presto JDBC driver as a dependency, if you plan on using it.
+    Refer to [Presto project download page](https://prestosql.io/download.html) for instructions.
+
+

mkdocs.yml

@@ -53,6 +53,7 @@ nav:
                 - modules/databases/neo4j.md
                 - modules/databases/oraclexe.md
                 - modules/databases/postgres.md
+                - modules/databases/presto.md
           - modules/docker_compose.md
           - modules/elasticsearch.md
           - modules/kafka.md

modules/jdbc-test/build.gradle

@@ -7,6 +7,7 @@ repositories {
 dependencies {
     compile project(':mysql')
     compile project(':postgresql')
+    compile project(':presto')
     compile project(':cockroachdb')
     compile project(':mariadb')
     compile project(':oracle-xe')
@@ -16,6 +17,7 @@ dependencies {
 
     testCompile 'com.google.guava:guava:18.0'
     testCompile 'org.postgresql:postgresql:42.0.0'
+    testCompile 'io.prestosql:presto-jdbc:329'
     testCompile 'mysql:mysql-connector-java:8.0.14'
     testCompile 'org.mariadb.jdbc:mariadb-java-client:1.4.6'
     testCompile 'com.oracle:ojdbc6:12.1.0.1-atlassian-hosted'

modules/jdbc-test/src/test/java/org/testcontainers/jdbc/JDBCDriverTest.java

@@ -53,6 +53,7 @@ public static Iterable<Object[]> data() {
                 {"jdbc:tc:postgresql:9.6.8://hostname/databasename?user=someuser&password=somepwd", EnumSet.of(Options.JDBCParams)},
                 {"jdbc:tc:postgis://hostname/databasename?user=someuser&password=somepwd", EnumSet.of(Options.JDBCParams)},
                 {"jdbc:tc:postgis:9.6://hostname/databasename?user=someuser&password=somepwd", EnumSet.of(Options.JDBCParams)},
+                {"jdbc:tc:presto:329://hostname/", EnumSet.of(Options.PmdKnownBroken)},
                 {"jdbc:tc:mysql:5.6://hostname/databasename?TC_MY_CNF=somepath/mysql_conf_override", EnumSet.of(Options.CustomIniFile)},
                 {"jdbc:tc:mariadb://hostname/databasename", EnumSet.noneOf(Options.class)},
                 {"jdbc:tc:mariadb://hostname/databasename?user=someuser&TC_INITSCRIPT=somepath/init_mariadb.sql", EnumSet.of(Options.ScriptedSchema, Options.JDBCParams)},

modules/presto/build.gradle

@@ -0,0 +1,8 @@
+description = "Testcontainers :: JDBC :: Presto"
+
+dependencies {
+    compile project(':jdbc')
+
+    testCompile 'io.prestosql:presto-jdbc:329'
+    testCompile 'commons-dbutils:commons-dbutils:1.7'
+}

modules/presto/src/main/java/org/testcontainers/containers/PrestoContainer.java

@@ -0,0 +1,104 @@
+package org.testcontainers.containers;
+
+import org.jetbrains.annotations.NotNull;
+import org.testcontainers.containers.wait.strategy.LogMessageWaitStrategy;
+
+import java.sql.Connection;
+import java.sql.SQLException;
+import java.time.Duration;
+import java.util.HashSet;
+import java.util.Set;
+
+import static com.google.common.base.Strings.nullToEmpty;
+import static java.lang.String.format;
+import static java.time.temporal.ChronoUnit.SECONDS;
+
+public class PrestoContainer<SELF extends PrestoContainer<SELF>> extends JdbcDatabaseContainer<SELF> {
+    public static final String NAME = "presto";
+    public static final String IMAGE = "prestosql/presto";
+    public static final String DEFAULT_TAG = "329";
+
+    public static final Integer PRESTO_PORT = 8080;
+
+    private String username = "test";
+    private String catalog = null;
+
+    public PrestoContainer() {
+        this(IMAGE + ":" + DEFAULT_TAG);
+    }
+
+    public PrestoContainer(final String dockerImageName) {
+        super(dockerImageName);
+        this.waitStrategy = new LogMessageWaitStrategy()
+            .withRegEx(".*io.prestosql.server.PrestoServer\\s+======== SERVER STARTED ========.*")
+            .withStartupTimeout(Duration.of(60, SECONDS));
+    }
+
+    @NotNull
+    @Override
+    protected Set<Integer> getLivenessCheckPorts() {
+        return new HashSet<>(getMappedPort(PRESTO_PORT));
+    }
+
+    @Override
+    protected void configure() {
+        addExposedPort(PRESTO_PORT);
+    }
+
+    @Override
+    public String getDriverClassName() {
+        return "io.prestosql.jdbc.PrestoDriver";
+    }
+
+    @Override
+    public String getJdbcUrl() {
+        return format("jdbc:presto://%s:%s/%s", getContainerIpAddress(), getMappedPort(PRESTO_PORT), nullToEmpty(catalog));
+    }
+
+    @Override
+    public String getUsername() {
+        return username;
+    }
+
+    @Override
+    public String getPassword() {
+        return "";
+    }
+
+    @Override
+    public String getDatabaseName() {
+        return catalog;
+    }
+
+    @Override
+    public String getTestQueryString() {
+        return "SELECT count(*) FROM tpch.tiny.nation";
+    }
+
+    @Override
+    public SELF withUsername(final String username) {
+        this.username = username;
+        return self();
+    }
+
+    /**
+     * @deprecated This operation is not supported.
+     */
+    @Override
+    @Deprecated
+    public SELF withPassword(final String password) {
+        // ignored, Presto does not support password authentication without TLS
+        // TODO: make JDBCDriverTest not pass a password unconditionally and remove this method
+        return self();
+    }
+
+    @Override
+    public SELF withDatabaseName(String dbName) {
+        this.catalog = dbName;
+        return self();
+    }
+
+    public Connection createConnection() throws SQLException, NoDriverFoundException {
+        return createConnection("");
+    }
+}

modules/presto/src/main/java/org/testcontainers/containers/PrestoContainerProvider.java

@@ -0,0 +1,35 @@
+package org.testcontainers.containers;
+
+import org.testcontainers.jdbc.ConnectionUrl;
+
+import java.util.Objects;
+
+/**
+ * Factory for Presto containers.
+ */
+public class PrestoContainerProvider extends JdbcDatabaseContainerProvider {
+
+    public static final String USER_PARAM = "user";
+    public static final String PASSWORD_PARAM = "password";
+
+    @Override
+    public boolean supports(String databaseType) {
+        return databaseType.equals(PrestoContainer.NAME);
+    }
+
+    @Override
+    public JdbcDatabaseContainer newInstance() {
+        return newInstance(PrestoContainer.DEFAULT_TAG);
+    }
+
+    @Override
+    public JdbcDatabaseContainer newInstance(String tag) {
+        return new PrestoContainer(PrestoContainer.IMAGE + ":" + tag);
+    }
+
+    @Override
+    public JdbcDatabaseContainer newInstance(ConnectionUrl connectionUrl) {
+        return newInstanceFromConnectionUrl(connectionUrl, USER_PARAM, PASSWORD_PARAM);
+    }
+
+}

modules/presto/src/main/resources/META-INF/services/org.testcontainers.containers.JdbcDatabaseContainerProvider

@@ -0,0 +1 @@
+org.testcontainers.containers.PrestoContainerProvider