aboutsummaryrefslogtreecommitdiffstats
path: root/app/src/main/java/dev/msfjarvis/aps/injection/context/ContextModule.kt
diff options
context:
space:
mode:
Diffstat (limited to 'app/src/main/java/dev/msfjarvis/aps/injection/context/ContextModule.kt')
-rw-r--r--app/src/main/java/dev/msfjarvis/aps/injection/context/ContextModule.kt8
1 files changed, 8 insertions, 0 deletions
diff --git a/app/src/main/java/dev/msfjarvis/aps/injection/context/ContextModule.kt b/app/src/main/java/dev/msfjarvis/aps/injection/context/ContextModule.kt
index 6399781e..0f1acac8 100644
--- a/app/src/main/java/dev/msfjarvis/aps/injection/context/ContextModule.kt
+++ b/app/src/main/java/dev/msfjarvis/aps/injection/context/ContextModule.kt
@@ -11,6 +11,14 @@ import dagger.hilt.components.SingletonComponent
@InstallIn(SingletonComponent::class)
class ContextModule {
+ /**
+ * A method which provides the path of app-specific files directory. This is useful where we want
+ * to perform file operations but we do not want to depend on the [Context]. Injecting this in
+ * place of [Context] allows the method/class to be unit-tested without any mocks/fakes.
+ *
+ * @param context [ApplicationContext]
+ * @return the path of app-specific files directory.
+ */
@Provides
@FilesDirPath
fun providesFilesDirPath(@ApplicationContext context: Context): String {