README.md

KPotpourri

About

KPotpourri is a collection of several tools and libraries covering different aspects of a programmer's life. Mostly they introduce a more Kotlin-ish API over existing libraries like Logback, TestNG, Wiremock and others. It tries to reduce the need of repeating yourself, filling the gaps and simplify usage by taking advantage Kotlin's language features.

• Common
  • Common4k ... Common extensions to the standard library (like Guava for Java).
  • Test4k ... Test extensions for TestNG, Hamkrest and Mockito-Kotlin.
  • Swing4k ... Common Swing extensions.
  • Github4k ... SDK for Github's ReST API.
  • Logback4k ... Programmatic Logback configuration.
• Tools
  • Markdown4k ... Automatically check if Kotlin code snippets in markdown files are compilable.
  • Release4k ... High level build/release/deploy script abstraction.
• Web
  • Jackson4k ... Simplify configuration of Jackson Kotlin module.
  • Http4k ... HTTP client abstraction.
  • Web4k ... Ready to use Jetty server using ReST Easy for rapid setup.
  • Wiremock4k ... Wiremock extensions.

Setup

Register the custom repository in your build.gradle file:

repositories { 
  maven { 
    url "http://dl.bintray.com/christophpickl/cpickl" 
  }
}

Now feel free to add any dependency in its latest version:

dependencies {
  compile 'com.github.christophpickl.kpotpourri:common4k:$versionKPotpourri'
  
  testCompile 'com.github.christophpickl.kpotpourri:test4k:$versionKPotpourri'
}

Maven users please visit the Maven setup page.

Notes

Every KPotpourri library comes with some default dependencies:

compile "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
compile "org.jetbrains.kotlin:kotlin-reflect:$kotlin_version"

compile "com.google.guava:guava:$version_guava"

compile "io.github.microutils:kotlin-logging:$version_kotlin_logging"
runtime "org.slf4j:jcl-over-slf4j:$version_jcl"