vshnv / adapt

Adapt is a Kotlin DSL for writing efficient RecyclerView adapters with better usability.

Adapt

What is Adapt?

Adapt is an Android Library written in Kotlin with an aim to provide a clean, well-integrated and easy-to-use experience in writing RecyclerView adapters.

It leverages Kotlin to create a typesafe DSL that makes writing Adapters simple.

Documentation: https://vshnv.github.io/adapt/#adapt

Getting Started

Gradle:

dependencies {
    implementation("io.github.vshnv:adapt:0.0.6")
}

Make sure you have Maven Central added as a repository. In your settings.gradle file, verify that mavenCentral() is added as a repository

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral() // <---- Make sure this is present
    }
}

Sample Usage

Assume we have some data class Person to be shown in a RecyclerView.

data class Person(
    val name: String,
    val age: Int,
    val avatarUrl: String
)

Also assume we create a layout file layout_person.xml .

Now we can create a simple adapter for this using adapt:

fun createPersonAdapter() = adapt<Person> {
    create {
        // Inflating view for element
        val personBinding = LayoutPersonBinding.inflate(LayoutInflater.from(it.context), it, false)
        ViewSource.BindingViewSource(personBinding, ViewBinding::getRoot)
    }.bind {
        binding.name.text = data.name
        binding.age.text = "Aged ${data.age}"
    }.withLifecycle { lifecycleOwner ->
        lifecycleOwner.lifecycleScope.launch(Dispatchers.IO) {
            val avatar = fetchAvatar(avatarUrl) // Some long running task required for this specific binding
            binding.avatar.setImageBitmap(avatar)
        }
    }
}

While the above example uses ViewBinding, you can use DataBinding or just views for the same.

You can now submit values to the adapter created using your function.

val myData = listOf(
    Person("Person A", 31),
    Person("Person B", 25),
    Person("Person C", 52),
)

val adapter = createPersonAdapter()
recyclerView.adapter = adapter
adapter.submitData(myData)

And thats it!

submitData handles async diffing and publishes only changes to your data. For better performance it is recommended to include itemEquals and contentEquals in your adapter config. This is further explained a few sections below.

adapt's Issues

Not an issue, just wanna ask about adapter

Hey, Thanks you for the library, it's easy to use.

but, how can I add custom functions in adapter?
Can I also add Filterable?

If, YES then how can i add to it.
Thanks in advance.

Type mismatch on ViewSource

i don't know why this is coming.
Any help would be greatly appreciated.

note: No error & running successfully in older version of Android Studio (hedgehog).

Users should be able to use lifecycle dependant computation within bindings

Currently Adapt does not support lifecycle management for binders which leads to having to use too many adapter invalidations to update bindings. Lifecycle support would allow easy bindings with LiveData and make binding much simpler where extra LiveData sources exist.