aafanasev / chuck-client

Chuck Norris - RxJava API client

Chuck Norris - RxJava API Client

https://chucknorris.io is a free JSON API for hand curated Chuck Norris facts

Plain Java client is here

Usage

Kotlin

// create api client
val api = ChuckNorrisApiFactory().create()

// get random
api.getRandomJoke().subscribe { 
    randomJoke -> println(randomJoke.value) 
}

// search
api.searchJokes("php").subscribe { result ->
    println("""
            Found: ${result.total}
            First fact: ${result.jokes[0].value}
            """.trimIndent())
}

Java

// create api client
ChuckNorrisApiService api = new ChuckNorrisApiFactory().create()

// get random from category
api.getRandomJoke("dev").subscribe(joke -> {
    System.out.println(joke.getValue());
});

// get all available categories
api.getCategories().subscribe(categories -> {
    System.out.println(categories);
});

More info in samples and docs

Install

Gradle

// add repository
repositories {
    maven {
        url 'https://dl.bintray.com/aafanasev/maven'
    }
}

// add dependency
compile 'com.aafanasev:chuck-norris:1.1'

Maven

<dependency>
  <groupId>com.aafanasev</groupId>
  <artifactId>chuck-norris</artifactId>
  <version>1.1</version>
  <type>pom</type>
</dependency>