Kaffeine

Kaffeine is a Kotlin-flavored Android library for accelerating development.

Several Words of Caution

Besides the obvious productivity advantages, if you are using this project - be prepared to shoot yourself in the foot or to blow your legs off. This is an experimental project that I am working on while I learn Kotlin and functional programming. Some of the lucrative approaches used in this project may not be best practices and I don't have any guarantees over the API. Don't be surprised if the API changes for every SNAPSHOT. If you are trending along a safe path, this project is definitely not for you. I may highlight caveats in some of the approaches if I am smart enough to figure them out. But, feel free to throw some light if you spot some dumbness (or a lot) along the lane.

Activities & Services

Example: Start an Activity

Java

Intent intent = new Intent(this, SuperPowersActivity.class);
intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
startActivity(intent);

Kotlin

val flags = flags(Intent.FLAG_ACTIVITY_NEW_TASK, Intent.FLAG_ACTIVITY_CLEAR_TOP)
startActivity<SuperPowersActivity>(flags)

Layout Inflation

Java

LayoutInflater layoutInflater = LayoutInflater.from(this);
View awesomeView = layoutInflater.inflate(R.layout.my_awesome_layout, null);

Kotlin

val awesomeView = inflateLayout(R.layout.my_awesome_layout)

Logs

Example: Logging

Java

String tag = this.getClass().getName();
Log.i(tag, "Howdy! Info");
Log.d(tag, "Knock knock! Debug");
Log.e(tag, "Grim, Error");
Log.wtf(tag, "Damn! WTF"); // Nope, not what you think. Refer the docs :P

Kotlin

i("Howdy! Info")
d("Knock knock! Debug")
e("Grim, Error")
wtf("Damn! WTF")

Preferences

Example: Single Preference

Java

SharedPreferences preferences = PreferenceManager.getDefaultSharedPreferences(this);
Editor editor = preferences.edit();
editor.putBoolean("KEY_WALKTHROUGH_COMPLETE", complete);
if (Build.VERSION.SDK_INT < Build.VERSION_CODES.GINGERBREAD) {
  editor.commit();
} else {
  editor.apply();
}

Kotlin

getDefaultSharedPreferences().putBoolean("KEY_WALKTHROUGH_COMPLETE", complete)

Example: Bulk Preferences

Kotlin

getDefaultSharedPreferences()
  .bulk()
  .putBoolean("KEY_WALKTHROUGH_COMPLETE", complete)
  .putString("KEY_LAST_USED", lastUsedIso8601Date)
  .applyBulk()

Toasts

Example: Short Message

Java

Toast.makeText(this, R.string.welcome, Toast.LENGTH_SHORT).show();

Kotlin

showShortToast(R.string.welcome)

Example: Custom Toast

Java

Toast toast = new Toast(this);
toast.setView(view);
toast.setDuration(Toast.LENGTH_LONG);
toast.show();

Kotlin

showShortToast(view)

System Services

Java

AlarmManager alarmManager = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
NotificationManager notificationManager = (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);

Kotlin

val alarmManager = context.alarmManager()
val notificationManager = context.notificationManager()

Resources

Example: Typeface from Assets

Java

AssetManager assetManager = getAssets();
Typeface sourceSansPro = Typeface.createFromAsset(assetManager, "fonts/source-sans-pro.ttf");

Kotlin

val sourceSansPro = typefaceFromAssets("fonts/source-sans-pro.ttf")

More...

More extensions under development.

Maven

<dependency>
    <groupId>com.mobsandgeeks</groupId>
    <artifactId>kaffeine</artifactId>
    <version>0.1-SNAPSHOT</version>
</dependency>

Gradle

dependencies {
    compile 'com.mobsandgeeks:kaffeine:0.1-SNAPSHOT'
}

Snapshots

In your {project_base}/build.gradle file, include the following.

allprojects {
    repositories {
        mavenCentral()
        maven {
            url "https://oss.sonatype.org/content/repositories/snapshots/"
        }
    }
}

License

Copyright 2015 Mobs & Geeks

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.