# chochanaresh/filepicker architecture

> Architecture diagram of the GitHub repository chochanaresh/filepicker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/chochanaresh/filepicker
- Repository: https://github.com/chochanaresh/filepicker

## Overview

##### Project type and purpose
- This is an Android library module (“filepickerlibrary”) plus a sample application (“sample”) demonstrating its usage.
- Purpose: expose a simple Builder-based API for selecting files (documents, images, video) or capturing media via Android system Intents, then returning URIs and file-paths back to the host app.

##### File structure
- Top level: Gradle configs, Git workflows, `filepickerlibrary` module, and `sample` module.
- `filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary`: houses core code, subdivided into
- initializer – sets up logging (TimberInitializer)
- models – configuration and data classes (BaseConfig, PickerData)
- permission – utilities for runtime permissions
- picker – helpers for Intent creation
- ui – activity implementations that wrap Android Intents (DocumentFilePickerActivity, ImageCaptureActivity, etc.) and adapter/UI widgets (PopUpAdapter)
- utilities – file-provider setup, file/path helpers, constants, extensions
- `sample/src`: a host Android app calling the library via `FilePicker.Builder`, demonstrating usage in Java/Kotlin and including its own adapter, activities, tests.

##### README for additional insights
- Confirms Builder pattern, modular add-on methods (addPickDocumentFile, addImageCapture, etc.).
- Highlights supported flows (single/multiple pick, camera capture).
- Enumerates customization hooks via config objects.
- Mentions ProGuard rules, API level, dependency resolution.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Sample App Module
    subgraph "Sample App" 
        direction TB
        Sample_MainActivity["MainActivity"]:::external
        Sample_JavaExampleActivity["JavaExampleActivity"]:::external
        Sample_MediaAdapter["MediaAdapter"]:::external
    end

    %% FilePicker Library Module
    subgraph "FilePicker Library"
        direction TB

        %% API Layer
        FilePicker["FilePicker (Builder API)"]:::api

        %% Initializer
        TimberInit["TimberInitializer"]:::util

        %% Models
        BaseConfig["BaseConfig"]:::model
        PickerData["PickerData"]:::model

        %% Permission Utility
        PermissionUtils["PermissionUtils"]:::util

        %% Intent Helpers
        PickerUtils["PickerUtils"]:::util

        %% UI Activities
        subgraph "UI Activities"
            direction TB
            DocPicker["DocumentFilePickerActivity"]:::ui
            MediaPicker["MediaFilePickerActivity"]:::ui
            ImageCapture["ImageCaptureActivity"]:::ui
            VideoCapture["VideoCaptureActivity"]:::ui
            PopUpAct["PopUpActivity"]:::ui
        end

        %% UI Adapter
        PopUpAdapter["PopUpAdapter"]:::ui

        %% Utilities
        CustomProvider["CustomFileProvider"]:::util
        FileUtils["FileUtils"]:::util
        Consts["Const"]:::util
        Extentions["Extentions"]:::util
        FilePathExtent["FilePathExtentions"]:::util
    end

    %% Android System
    subgraph "Android System"
        direction TB
        PermissionDialog["Runtime Permission Dialog"]:::external
        ContentResolver["ContentResolver"]:::external
        MediaStore["MediaStore Intent"]:::external
        SystemFileProvider["Android FileProvider"]:::external
        ActivityResult["ActivityResultCallback"]:::external
    end

    %% Relationships
    Sample_MainActivity -->|uses| FilePicker
    Sample_JavaExampleActivity -->|uses| FilePicker

    FilePicker -->|initializes| TimberInit
    FilePicker -->|builds config| BaseConfig
    FilePicker -->|holds data| PickerData

    FilePicker -->|startActivityForResult| DocPicker
    FilePicker -->|startActivityForResult| MediaPicker
    FilePicker -->|startActivityForResult| ImageCapture
    FilePicker -->|startActivityForResult| VideoCapture
    FilePicker -->|startActivityForResult| PopUpAct

    DocPicker -->|requestPermission| PermissionUtils
    MediaPicker -->|requestPermission| PermissionUtils
    ImageCapture -->|requestPermission| PermissionUtils
    VideoCapture -->|requestPermission| PermissionUtils
    PopUpAct -->|requestPermission| PermissionUtils

    PermissionUtils -->|invoke| PermissionDialog

    DocPicker -->|createIntent| PickerUtils
    MediaPicker -->|createIntent| PickerUtils
    ImageCapture -->|createIntent| PickerUtils
    VideoCapture -->|createIntent| PickerUtils

    PickerUtils -->|use| ContentResolver
    PickerUtils -->|use| MediaStore

    ImageCapture -->|use| CustomProvider
    VideoCapture -->|use| CustomProvider
    CustomProvider -->|extends| SystemFileProvider

    PopUpAct -->|useAdapter| PopUpAdapter

    DocPicker -->|returnResult| ActivityResult
    MediaPicker -->|returnResult| ActivityResult
    ImageCapture -->|returnResult| ActivityResult
    VideoCapture -->|returnResult| ActivityResult
    PopUpAct -->|returnResult| ActivityResult

    ActivityResult -->|callbackTo| Sample_MainActivity
    ActivityResult -->|callbackTo| Sample_JavaExampleActivity

    %% Click Events
    click Sample_MainActivity "https://github.com/chochanaresh/filepicker/blob/master/sample/src/main/java/com/nareshchocha/filepicker/MainActivity.kt"
    click Sample_JavaExampleActivity "https://github.com/chochanaresh/filepicker/blob/master/sample/src/main/java/com/nareshchocha/filepicker/JavaExampleActivity.java"
    click Sample_MediaAdapter "https://github.com/chochanaresh/filepicker/blob/master/sample/src/main/java/com/nareshchocha/filepicker/adapter/MediaAdapter.kt"

    click FilePicker "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/ui/FilePicker.kt"
    click BaseConfig "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/models/BaseConfig.kt"
    click PickerData "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/models/PickerData.kt"

    click PermissionUtils "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/permission/PermissionUtils.kt"
    click PickerUtils "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/picker/PickerUtils.kt"

    click DocPicker "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/ui/activitys/DocumentFilePickerActivity.kt"
    click MediaPicker "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/ui/activitys/MediaFilePickerActivity.kt"
    click ImageCapture "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/ui/activitys/ImageCaptureActivity.kt"
    click VideoCapture "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/ui/activitys/VideoCaptureActivity.kt"
    click PopUpAct "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/ui/activitys/PopUpActivity.kt"

    click PopUpAdapter "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/ui/adapter/PopUpAdapter.kt"

    click CustomProvider "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/utilities/CustomFileProvider.kt"
    click FileUtils "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/utilities/FileUtils.kt"
    click Consts "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/utilities/appConst/Const.kt"
    click Extentions "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/utilities/extentions/Extentions.kt"
    click FilePathExtent "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/utilities/extentions/FilePathExtentions.kt"

    click TimberInit "https://github.com/chochanaresh/filepicker/blob/master/filepickerlibrary/src/main/java/com/nareshchocha/filepickerlibrary/initializer/TimberInitializer.kt"

    %% Styles
    classDef api fill:#e0f7fa,stroke:#00796b,color:#004d40
    classDef ui fill:#e8f5e9,stroke:#2e7d32,color:#1b5e20
    classDef util fill:#fff8e1,stroke:#f9a825,color:#795548
    classDef model fill:#fff3e0,stroke:#ff6f00,color:#e65100
    classDef external fill:#eceff1,stroke:#546e7a,color:#263238
```
