This package has been deprecated

Author message:

Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.

danger-plugin-typescript-graph
TypeScript icon, indicating that this package has built-in type declarations

1.18.0 • Public • Published

danger-plugin-typescript-graph

日本語 (Japanese)

npm version semantic-release

This plugin is a Danger plugin designed to automatically run the CLI tool typescript-graph, which visualizes the dependencies between files in a TypeScript codebase, in a CI environment. Understanding dependencies is crucial for maintaining code integrity. By using this plugin, you can easily check dependencies before creating or merging a pull request.

Usage

Preparing to Run DangerJS on CI Environment

Before installing this library, make sure you have DangerJS set up to run on your CI environment. The setup involves the following 5 steps:

  1. Include the Danger module.
  2. Create a Dangerfile and add some basic rules.
  3. Create an account for Danger to use.
  4. Set up an access token for that account.
  5. Configure your CI environment to run Danger.

For more details, please refer to the DangerJS Official Getting Started Guide.

Install

yarn add danger-plugin-typescript-graph --dev

At a glance

// dangerfile.js
import typescriptGraph from 'danger-plugin-typescript-graph';

typescriptGraph();

Sample Usage

Basic File Modifications

In this example, we show the dependency graph when you've modified outputGraph.ts and its related test files. The modified files are highlighted in yellow, and the files they depend on are also explicitly displayed on the graph.

flowchart
    classDef modified fill:yellow,stroke:#999,color:black
    subgraph src["src"]
        src/utils["/utils"]:::dir
        src/index.ts["index.ts"]
        subgraph src/outputGraph["/outputGraph"]
            src/outputGraph/outputGraph.ts["outputGraph.ts"]:::modified
            src/outputGraph/output2Graphs.test.ts["output2Graphs.test.ts"]:::modified
            src/outputGraph/mergeGraphsWithDifferences.ts["mergeGraphsWithDifferences.ts"]
            src/outputGraph/applyMutualDifferences.ts["applyMutualDifferences.ts"]
        end
    end
    src/outputGraph/outputGraph.ts-->src/utils
    src/outputGraph/outputGraph.ts-->src/outputGraph/mergeGraphsWithDifferences.ts
    src/outputGraph/outputGraph.ts-->src/outputGraph/applyMutualDifferences.ts
    src/index.ts-->src/outputGraph/outputGraph.ts
    src/outputGraph/output2Graphs.test.ts-->src/outputGraph/outputGraph.ts
    src/outputGraph/mergeGraphsWithDifferences.ts-->src/utils
    src/outputGraph/applyMutualDifferences.ts-->src/utils
    src/index.ts-->src/utils

Changes Involving File Deletion or Movement

This case demonstrates the impact when a file is deleted or moved. Dependency graphs are generated for both the base branch and the head branch. Deleted files are displayed in a grayed-out manner.

Base Branch
flowchart
    classDef modified fill:yellow,stroke:#999,color:black
    classDef deleted fill:dimgray,stroke:#999,color:black,stroke-dasharray: 4 4,stroke-width:2px;
    subgraph src["src"]
        src/index.ts["index.ts"]:::modified
        src/index.test.ts["index.test.ts"]
        src/getRenameFiles.ts["getRenameFiles.ts"]
        src/getFullGraph.ts["getFullGraph.ts"]
        subgraph src/graph_["/graph"]
            src/_graph__/index.ts["index.ts"]:::deleted
            src/_graph__/outputGraph.ts["outputGraph.ts"]
            src/_graph__/output2Graphs.ts["output2Graphs.ts"]
        end
    end
    src/_graph__/index.ts-->src/_graph__/outputGraph.ts
    src/_graph__/index.ts-->src/_graph__/output2Graphs.ts
    src/index.ts-->src/getRenameFiles.ts
    src/index.ts-->src/getFullGraph.ts
    src/index.ts-->src/_graph__/index.ts
    src/index.test.ts-->src/index.ts
Head Branch
flowchart
    classDef modified fill:yellow,stroke:#999,color:black
    subgraph src["src"]
        src/index.ts["index.ts"]:::modified
        src/index.test.ts["index.test.ts"]
        src/getRenameFiles.ts["getRenameFiles.ts"]
        src/getFullGraph.ts["getFullGraph.ts"]
        subgraph src/graph_["/graph"]
            src/_graph__/output2Graphs.ts["output2Graphs.ts"]
            src/_graph__/outputGraph.ts["outputGraph.ts"]
        end
    end
    src/index.ts-->src/getRenameFiles.ts
    src/index.ts-->src/getFullGraph.ts
    src/index.ts-->src/_graph__/output2Graphs.ts
    src/index.ts-->src/_graph__/outputGraph.ts
    src/index.test.ts-->src/index.ts

Configuration

The .danger-tsgrc.json is a configuration file that stores settings in JSON format. If the relevant configuration file does not exist, or if it is in an invalid format, the default settings will be applied. Each configuration item has a corresponding environment variable, which takes precedence over the settings in the configuration file.

Configuration Item Details Type Default Value Description
Root directory for tsconfig Env: TSG_TSCONFIG_ROOT
Key: tsconfigRoot
string "./" Specifies the directory where tsconfig will be searched.
Maximum Node Count Env: TSG_MAX_SIZE
Key: maxSize
number 30 Specifies the value to limit graph display when the number of changed files is large.
Graph Orientation Env: TSG_ORIENTATION
Key: orientation
TB or LR Not specified Specifies the orientation (TB or LR) of the graph. However, Mermaid may produce graphs in the opposite direction.
Debug Mode Env: TSG_DEBUG
Key: debug
boolean false Specifies whether to enable debug mode. Logs will be output in debug mode.
Enclose in <details> tag Env: TSG_IN_DETAILS
Key: inDetails
boolean true Specifies whether to enclose Mermaid in a <details> tag and collapse it.
Exclude Files Env: None
Key: exclude
string[] [] Specifies the files to be excluded from the graph.
Display index.ts Dependency Files Env: TSG_INCLUDE_INDEX_FILE_DEPENDENCIES
Key: includeIndexFileDependencies
boolean false Specifies whether to display dependency files when the changed file is referenced from an index.ts in the same directory.

Changelog

See the GitHub release history.

Contributing

See CONTRIBUTING.md.

Package Sidebar

Install

npm i danger-plugin-typescript-graph

Weekly Downloads

7

Version

1.18.0

License

MIT

Unpacked Size

113 kB

Total Files

76

Last publish

Collaborators

  • ysk8hori