# euptron/dependency-haven architecture

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

- Interactive diagram: https://gitdiagram.com/euptron/dependency-haven
- Repository: https://github.com/euptron/dependency-haven

## Overview

##### Project type and purpose
- This is a dual-module project:
– “haven” is an open-source Java/Android dependency-management library (resolves/caches Maven POMs and artifacts).
– “app” is an Android demo app that integrates and exercises that library.
- The library resolves direct and transitive dependencies, parses POM files, caches results, and exposes a simple API. The demo app provides a UI to trigger dependency resolution, display results and logs.

##### File structure
- Top-level modules:
– app/ – Android application (Gradle module)
– haven/ – library module with core packages
- app/:
– src/main/java/io/thorenkoder/android/… – Activities, Fragments, Adapters, Utility classes
– api/ & api/library/ – wrappers around the dependency-haven library (LocalLibraryManager, LocalLibrary)
– logging/ – UI logging via LogViewModel, adapters
– util/ – shared helpers, preferences, SDK utilities
- haven/:
– api/ & callback/async/ – public API interfaces, callbacks, AsyncTaskExecutor
– model/ & parser/ – Pom, Dependency, Exclusion models; PomParser
– repository/ – interfaces and implementations for LocalRepository (file system) and RemoteRepository (HTTP/Maven)
– resolver/ – DependencyResolver orchestrates resolution, handles skipping transitive lookups
– versioning/ – ComparableVersion for version comparisons

##### Key insights from README
- The library’s responsibilities:
– Reading repository definitions (JSON or default Maven Central/jitpack)
– Downloading POMs, resolving parent and transitive dependencies
– Caching POMs and artifacts locally
– Exposing a callback-based async API

– Android Demo App
- UI Layer (Activities / Fragments)
- Logging Layer (LogViewModel, LogAdapter)
- Library Adapter (LocalLibraryManager, LocalLibrary)
– Dependency-Haven Library Core
- API Facade (DependencyResolver, AsyncTaskExecutor, Callbacks)
- Parser (PomParser, model classes)
- Repository Layer
· RemoteRepository (HTTP client to Maven Central/JitPack)
· LocalRepository (file storage via LocalStorageFactory)
- Versioning Module (ComparableVersion)
– UI → Library Adapter: “startResolve(dependencies)”
– Adapter → API Facade: “resolveAsync(…)”
– API Facade → Repository Layer:
- RemoteRepository.downloadPom() → returns raw POM bytes
- LocalRepository.loadCachedPom() / saveCachedPom()
– API Facade → Parser: “PomParser.parse(rawPom)” → returns Dependency model graph
– API Facade → Versioning: compare versions for conflict resolution
– API Facade → Callback: “onSuccess(resolvedTree)” or “onError(exception)”
– Callback → UI / Logging Layer: update results, print logs
c. Architectural patterns & design principles:
– Separation of concerns: UI vs. networking vs. parsing vs. caching
– Callback-based async execution (AsyncTaskExecutor)
– Repository pattern for remote vs. local storage
– Model–View–ViewModel in the demo app (Fragments + LogViewModel)
– Modular packaging inside the “haven” library
d. Key technologies & frameworks:
– Java 8, Android SDK, Gradle
– HTTP client (e.g., URLConnection or OkHttp behind RemoteRepository)
– XML parsing in PomParser
– File I/O for caching (LocalRepository)
– AsyncTask or ThreadPool in AsyncTaskExecutor

##### Detail without overcomplicating
- Interactions at the API boundary, the parser, the repository, and the UI.

## Diagram (Mermaid)

```mermaid
graph TD
    %% Android Demo App Module
    subgraph "Android Demo App"
        direction TB
        subgraph "UI Layer"
            direction TB
            MainActivity["MainActivity"]:::ui
            Fragments["Fragments Container"]:::ui
        end
        subgraph "Logging Layer"
            direction TB
            LogViewModel["LogViewModel"]:::ui
            LogAdapter["LogAdapter"]:::ui
            Logger["Logger"]:::ui
            LogPrinter["LogPrinter"]:::ui
        end
        subgraph "Library Adapter"
            direction TB
            LocalLibraryManager["LocalLibraryManager"]:::library
            LocalLibrary["LocalLibrary"]:::library
        end
    end

    %% Dependency-Haven Library Module
    subgraph "Dependency-Haven Library"
        direction TB
        subgraph "API Facade"
            direction TB
            LibraryIface["Library"]:::library
            CachedLibrary["CachedLibrary"]:::library
            AsyncTaskExecutor["AsyncTaskExecutor"]:::library
            DependencyResolutionCallback["DependencyResolutionCallback"]:::library
            DownloadCallback["DownloadCallback"]:::library
        end
        subgraph "Resolver"
            direction TB
            DependencyResolver["DependencyResolver"]:::library
            DependencyResolutionSkipper["DependencyResolutionSkipper"]:::library
        end
        subgraph "Parser & Models"
            direction TB
            PomParser["PomParser"]:::library
            Coordinates["Coordinates"]:::library
            DependencyModel["Dependency"]:::library
            Exclusion["Exclusion"]:::library
            PomModel["Pom"]:::library
        end
        subgraph "Repository Layer"
            direction TB
            RepositoryIface["Repository"]:::library
            ArtifactRepository["ArtifactRepository"]:::library
            StorageFactory["StorageFactory"]:::library
            RemoteRepository["RemoteRepository"]:::library
            LocalRepository["LocalRepository"]:::library
            LocalStorageFactory["LocalStorageFactory"]:::library
            DefaultArtifactRepository["DefaultArtifactRepository"]:::library
            LocalMaven["LocalMaven"]:::library
        end
        subgraph "Versioning Module"
            direction TB
            ComparableVersion["ComparableVersion"]:::library
        end
    end

    %% External Systems and Data Stores
    MavenCentral["Maven Central / JitPack"]:::external
    LocalDeviceStorage["Local Device Storage"]:::datastore

    %% Flows within Demo App
    MainActivity -->|"uses fragments"| Fragments
    Fragments -->|"startResolve(dependencies)"| LocalLibraryManager
    LocalLibraryManager -->|"binds to"| LocalLibrary
    LocalLibrary -->|"resolveAsync()"| LibraryIface

    %% Flows within Library
    LibraryIface -->|"execute async"| AsyncTaskExecutor
    AsyncTaskExecutor -->|"invoke callback"| DependencyResolutionCallback
    LibraryIface -->|"downloadPom()"| RemoteRepository
    LibraryIface -->|"load/save cache"| LocalRepository
    RemoteRepository -->|"/api fetch"| MavenCentral
    LocalRepository -->|"file IO"| LocalDeviceStorage
    LibraryIface -->|"parse rawPom"| PomParser
    PomParser -->|"produce model"| DependencyModel
    PomParser -->|"produce model"| PomModel
    PomParser -->|"produce model"| Coordinates
    PomParser -->|"produce model"| Exclusion
    LibraryIface -->|"compare versions"| ComparableVersion
    DependencyResolver -->|"skip transitive"| DependencyResolutionSkipper
    RepositoryIface -->|"implemented by"| RemoteRepository
    RepositoryIface -->|"implemented by"| LocalRepository
    ArtifactRepository -->|"default"| DefaultArtifactRepository
    StorageFactory -->|"provides"| LocalStorageFactory
    DefaultArtifactRepository -->|"config uses"| LocalMaven

    %% Callbacks back to UI
    DependencyResolutionCallback -->|"onSuccess/tree"| LogViewModel
    DependencyResolutionCallback -->|"onError/exception"| LogViewModel
    LogViewModel -->|"update UI"| LogAdapter
    LogAdapter -->|"print logs"| LogPrinter

    %% Click events
    click MainActivity "https://github.com/euptron/dependency-haven/blob/main/app/src/main/java/io/thorenkoder/android/MainActivity.java"
    click Fragments "https://github.com/euptron/dependency-haven/tree/main/app/src/main/java/io/thorenkoder/android/fragments/"
    click LogViewModel "https://github.com/euptron/dependency-haven/blob/main/app/src/main/java/io/thorenkoder/android/logging/LogViewModel.java"
    click LogAdapter "https://github.com/euptron/dependency-haven/blob/main/app/src/main/java/io/thorenkoder/android/logging/LogAdapter.java"
    click Logger "https://github.com/euptron/dependency-haven/blob/main/app/src/main/java/io/thorenkoder/android/logging/Logger.java"
    click LogPrinter "https://github.com/euptron/dependency-haven/blob/main/app/src/main/java/io/thorenkoder/android/logging/LogPrinter.java"
    click LocalLibraryManager "https://github.com/euptron/dependency-haven/blob/main/app/src/main/java/io/thorenkoder/android/api/library/LocalLibraryManager.java"
    click LocalLibrary "https://github.com/euptron/dependency-haven/blob/main/app/src/main/java/io/thorenkoder/android/api/library/LocalLibrary.java"
    click LibraryIface "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/api/Library.java"
    click CachedLibrary "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/api/CachedLibrary.java"
    click AsyncTaskExecutor "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/async/AsyncTaskExecutor.java"
    click DependencyResolutionCallback "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/callback/DependencyResolutionCallback.java"
    click DownloadCallback "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/callback/DownloadCallback.java"
    click DependencyResolver "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/resolver/DependencyResolver.java"
    click DependencyResolutionSkipper "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/resolver/internal/DependencyResolutionSkipper.java"
    click PomParser "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/parser/PomParser.java"
    click Coordinates "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/model/Coordinates.java"
    click DependencyModel "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/model/Dependency.java"
    click Exclusion "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/model/Exclusion.java"
    click PomModel "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/model/Pom.java"
    click RepositoryIface "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/repository/Repository.java"
    click ArtifactRepository "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/repository/ArtifactRepository.java"
    click StorageFactory "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/repository/StorageFactory.java"
    click RemoteRepository "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/repository/RemoteRepository.java"
    click LocalRepository "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/repository/LocalRepository.java"
    click LocalStorageFactory "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/repository/LocalStorageFactory.java"
    click DefaultArtifactRepository "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/repository/DefaultArtifactRepository.java"
    click LocalMaven "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/repository/configured/LocalMaven.java"
    click ComparableVersion "https://github.com/euptron/dependency-haven/blob/main/haven/src/main/java/eup/dependency/haven/versioning/ComparableVersion.java"

    %% Styles
    classDef ui fill:#e0ffe0,stroke:#008000,stroke-width:1px
    classDef library fill:#e0f0ff,stroke:#0066cc,stroke-width:1px
    classDef external fill:#f0f0f0,stroke:#888888,stroke-width:1px
    classDef datastore fill:#fff4cc,stroke:#ccaa00,stroke-width:1px
```
