A Gradle plugin to generate a Mermaid graph for module dependencies

Introducing the Gradle Module Graph Plugin! 🌟

This plugin generates a Mermaid graph for your Gradle project, providing a visual representation of your project’s module relationships. By illustrating the connections between modules, it makes it easier to grasp your project’s structure and interdependencies.

A diagram about the current system is only useful if it’s generated. If it is produced by hand it documents the author’s belief, not the system. Still, important, but not an input for decision making. Development is primarily decision making. Enable it through custom tools. source

You can read more about the background story of this plugin here.

Features

• Generate a Mermaid dependency graph of the modules in your Gradle project
• Automatically append the generated graph to your project’s README file

Getting Started

You’ll just need to add it to your project’s root build.gradle or build.gradle.kts file.build.gradle (Groovy DSL)

build.gradle.kts (Kotlin DSL)

Using the plugins DSL

plugins {
  id("dev.iurysouza.modulegraph") version "0.2.2"
}

Using legacy plugin application

buildscript {
  repositories {
    maven {
      url = uri("https://plugins.gradle.org/m2/")
    }
  }
  dependencies {
    classpath("dev.iurysouza:modulegraph:0.2.2")
  }
}

apply(plugin = "dev.iurysouza:modulegraph")

Configuring the plugin

moduleGraphConfig {
    readmePath.set("$projectDir/README.md")
    heading.set("### Dependency Diagram")
    theme.set(Theme.NEUTRAL)
}

Configuration

To configure the Gradle Module Dependency Graph Plugin, you can set the following options:

• readmePath: The path of the file where the dependency graph will be appended.
• theme: The mermaid theme to be used for styling the graph. Default is NEUTRAL.
• heading: The heading where the dependency graph will be appended.

Usage

To generate the Mermaid dependency graph for your project, run the following command:

./gradlew createModuleGraph

Example Diagram

You can expect the plugin to generate this kind of diagram after running the plugin:

%%{
  init: {
    'theme': 'neutral'
  }
}%%

graph LR
  subgraph app
    main
    playground
  end
  subgraph core
    common
    design-system
    footballdata
    reddit
  end
  subgraph features
    match-day
    match-thread
  end
  main --> match-thread
  main --> match-day
  main --> footballdata
  main --> reddit
  main --> design-system
  main --> common
  playground --> match-thread
  playground --> match-day
  playground --> footballdata
  playground --> reddit
  playground --> design-system
  playground --> common
  footballdata --> common
  reddit --> common
  match-day --> common
  match-day --> footballdata
  match-day --> design-system
  match-day --> reddit
  match-thread --> common
  match-thread --> footballdata
  match-thread --> design-system
  match-thread --> reddit

Contributing 🤝

Feel free to open an issue or submit a pull request for any bugs/improvements.

License 📄

This template is licensed under the MIT License – see the License file for details.

GitHub

View Github