rnorth

Testcontainers general principles

Tips for developing/maintaining Testcontainers forks:

• Some general tips (most important at the top):
  • Have an easy-to-use API that is simple for people to use and read
  • Make common tasks intuitive and nice to use. Make less common tasks possible, but not at the expense of the common tasks. It's better not to support a niche feature than to degrade the common features.
  • Guide people towards doing sensible things, rather than letting them fall into traps.
  • Be idiomatic for the language and framework
• Give users coarse-grained tools rather than a fine-grained bag of components to figure out how to assemble

rnorth

import co.paralleluniverse.fibers.Fiber;
import co.paralleluniverse.fibers.SuspendExecution;
import co.paralleluniverse.strands.SuspendableRunnable;
import co.paralleluniverse.strands.channels.Channel;
import co.paralleluniverse.strands.channels.Channels;
import jsr166e.ForkJoinPool;

import java.util.concurrent.ExecutionException;

import static java.lang.String.format;

rnorth

cat cp.txt | grep /Users | while read line                                                                                                                    115ms
    tr ":" "\n"
end | sort | uniq | sed 's/.jar/-sources.jar/g' | while read jar
    unzip -p $jar
end | wc -l

rnorth

Testcontainers v2.0 API changes - idea 1

This is a rough sketch of how a revised API for Testcontainers could look - don't read too much into it.

Key goals:

• How it works should be simple and obvious for the benefit of users and contributors
• Don't lose too much in-IDE 'discoverability' of the API when compared with the current implementation
• Break dependency on JUnit to allow usage with other testing frameworks
• Have separate APIs for configuring containers and using a running container

rnorth

package com.example;

import org.junit.Before;
import org.junit.ClassRule;
import org.junit.Rule;
import org.junit.Test;
import org.openqa.selenium.WebElement;
import org.openqa.selenium.remote.RemoteWebDriver;
import org.testcontainers.containers.BrowserWebDriverContainer;
import org.testcontainers.containers.DockerComposeContainer;

rnorth

#!/usr/bin/env bash
# Maven release helper. Copyright (c) 2016 Richard North <rich.north@gmail.com>
# Usage: mvn-release.sh PROFILES
#  where PROFILES should be any maven profile activations to pass through, e.g. `-PprofileA` 
#
# Based on this article: https://axelfontaine.com/blog/final-nail.html
# 
# IMPORTANT: follow setup steps in that article for required POM configuration settings

set -o errexit

rnorth

#!/bin/bash

# Sends a Boxcar push notification through the Boxcar HTTP API
# Usage examples
#  $ bc 			  # Just sends a notification with title 'bc'
#  $ bc "Done"			  # Sends a notification with title 'Done'
#  $ echo foobar | bc 		  # Sends a notification with title 'bc' and message body 'foobar'
#  $ echo foobar | bc "Done"      # Sends a notification with title 'Done' and message body 'foobar'
#
# Expects a file ~/.boxcar to exist with content like

rnorth

###########################################
# Copyright (c) 2014 Jonathan Barronville #
# Minor tweaks by Richard North           #
# License: MIT.                           #
###########################################

function fish_prompt
	set last_command_status $status

	echo ''

rnorth

#!/usr/bin/env bash
# qmvn (quick maven)
#
# Maven wrapper script to accelerate the build of multi-module projects
# This script detects which modules have been modified since the last build, and executes maven in `-amd -pl ...` mode.
# This means only modules with changes to source code or their POMs, or which depend on a changed module, get built.
# See this page for details of how these flags accelerate the build:
#   http://blog.sonatype.com/2009/10/maven-tips-and-tricks-advanced-reactor-options/
#
# Authors:

rnorth

#!/usr/bin/env groovy

@GrabResolver("http://oss.jfrog.org/artifactory/libs-snapshot")
@Grab("org.ratpack-framework:ratpack-groovy:0.9.0-SNAPSHOT")
import static org.ratpackframework.groovy.RatpackScript.ratpack

ratpack {
  handlers {
    get {
      response.send "Hello ratpack!"