helper methods for context and improved readme.

README.md

@@ -9,13 +9,15 @@ A multiplatform Dependency Injection library.
 
 ## Artifacts
 
-| Artifact                  | Description                                                                          |
-|---------------------------|--------------------------------------------------------------------------------------|
-| kinject                   | Provides core DI functionality.                                                      |
-| kinject-android           |                                                                                      |
-| kinject-compose           | Provides the ability to provide an ObjectGraph in a Compose hierarchy.               |
-| kinject-compose-viewmodel | Provides the ability to get a ViewModel in a compose hierarchy.                      |
-| kinject-viewmodel         | Provides the ability to declare a view model dependency, and a factory to create it. |
+| Artifact                  | Description                                                                                                                                    |
+|---------------------------|------------------------------------------------------------------------------------------------------------------------------------------------|
+| kinject                   | Provides core DI functionality.                                                                                                                |
+| kinject-android           | Provides helper methods for working with `ObjectGraph`s embedded in `Context`s, and helper classes for embedding `ObjectGraph`s in `Contexts`. |
+| kinject-android-appcompat | Provides `KinjectAppCompatActivity`.                                                                                                           |
+| kinject-android-compose   | Provides `KinjectComponentActivity`.                                                                                                           |
+| kinject-compose           | Provides the ability to provide an ObjectGraph in a Compose hierarchy.                                                                         |
+| kinject-compose-viewmodel | Provides the ability to get a ViewModel in a compose hierarchy.                                                                                |
+| kinject-viewmodel         | Provides the ability to declare a view model dependency, and a factory to create it.                                                           |
 
 
 ## Usage

kinject-android/src/main/kotlin/kinject/android/ContextExt.kt

@@ -0,0 +1,12 @@
+package kinject.android
+
+import android.content.Context
+import kinject.ObjectGraph
+
+fun Context.objectGraphOrNull(): ObjectGraph? {
+    return getSystemService(KinjectApplication.KINJECT_SERVICE) as ObjectGraph?
+}
+
+fun Context.objectGraph(): ObjectGraph {
+    return objectGraphOrNull() ?: error("ObjectGraph not found in Context.")
+}

kinject-android/src/main/kotlin/kinject/android/KinjectContextWrapper.kt

@@ -0,0 +1,27 @@
+package kinject.android
+
+import android.content.Context
+import android.content.ContextWrapper
+import kinject.HasObjectGraph
+import kinject.ObjectGraph
+import kinject.android.KinjectApplication.Companion.KINJECT_SERVICE
+
+class KinjectContextWrapper(
+    base: Context,
+    override val objectGraph: ObjectGraph,
+) : ContextWrapper(base), HasObjectGraph {
+    override fun getSystemService(name: String): Any {
+        return when (name) {
+            KINJECT_SERVICE -> objectGraph
+            else -> super.getSystemService(name)
+        }
+    }
+
+    override fun getSystemServiceName(serviceClass: Class<*>): String? {
+        return if (serviceClass === ObjectGraph::class.java) {
+            KINJECT_SERVICE
+        } else {
+            super.getSystemServiceName(serviceClass)
+        }
+    }
+}