dpdm

A dependencies analysis instrument and framework.

Install

npm i -g dpdm

# use api
npm i dpdm

Example

If you have a project will follow directory structure:

.
├── node_modules
│   └── ...
├── package.json
├── src
│   ├── components
│   │   ├── Dialog.less
│   │   ├── Dialog.tsx
│   │   └── Provider.tsx
│   ├── index.ts
│   └── widgets
│       └── alert.ts
├── tsconfig.json
└── typings.json

5 directories, 8 files

And with the follow contents:

/* -------- ./package.json -------- */
{
}

/* -------- ./src/components/Dialog.less -------- */
.dialog {
  position: fixed;
}

/* -------- ./src/components/Dialog.tsx -------- */
import * as React from 'react'
import './Dialog.less'

export class Dialog extends React.Component<void, void> {
  render() {
    return <div>{this.props.children}</div>
  }
}

/* -------- ./src/components/Provider.tsx -------- */
import * as React from 'react'

export class Provider extends React.Component<void, void> {
  render() {
    return <div>Hello Provider</div>
  }
}

export function mount<T>(Component: typeof React.Component, props:T, children:React.ReactNode) {
  // pass
}


/* -------- ./src/index.ts -------- */
export * from './widgets/alert'
export * from './components/Dialog'
export * from './components/Provider'

/* -------- ./src/widgets/alert.ts -------- */
import { Dialog } from 'components/Dialog'
import { mount } from 'components/Provider'

export function alert(msg) {
  mount(Dialog, void 0, msg)
}

/* -------- ./tsconfig.json -------- */
{
}

/* -------- ./typings.json -------- */
{
  "name": "example",
  "dependencies": {}
}

Then run

dpdm -r classic -d ./src src/index.ts

will print this:

{
  "entries": {
    "index.ts": {
      "files": [
        "widgets/alert.ts",
        "components/Dialog.tsx",
        "components/Dialog.less",
        "components/Provider.tsx"
      ],
      "modules": [],
      "unknown": [
        "react"
      ]
    }
  },
  "files": {
    "index.ts": {
      "files": [
        "widgets/alert.ts",
        "components/Dialog.tsx",
        "components/Provider.tsx"
      ],
      "modules": [],
      "unknown": [],
      "uid": 1
    },
    "widgets/alert.ts": {
      "files": [
        "components/Dialog.tsx",
        "components/Provider.tsx"
      ],
      "modules": [],
      "unknown": [],
      "uid": 1
    },
    "components/Dialog.tsx": {
      "files": [
        "components/Dialog.less"
      ],
      "modules": [],
      "unknown": [
        "react"
      ],
      "uid": 1
    },
    "components/Provider.tsx": {
      "files": [],
      "modules": [],
      "unknown": [
        "react"
      ],
      "uid": 1
    }
  },
  "parents": {
    "widgets/alert.ts": [
      "index.ts"
    ],
    "components/Dialog.tsx": [
      "index.ts",
      "widgets/alert.ts"
    ],
    "components/Provider.tsx": [
      "index.ts",
      "widgets/alert.ts"
    ],
    "components/Dialog.less": [
      "components/Dialog.tsx"
    ]
  },
  "modules": {}
}

The result includes four map:

• entries: the entry files specified by command line,
• files: the all files are dependent on the entries and entries self,
• parents: the files dependent,
• modules: the modules dependent,

The entries and files include the file's dependencies, seperated by modules, files and unknown. entries resolved all dependencies recursively, files just resolved shallowly.

For typescript, if a import or export has a moduleSpecifier, will think as a dependency, if is relative or absolute path, or the moduleResolution is classic and could be resolve, will be treated as file dependency, else if be resolved by node_modules, will treated as module dependency, else is unknown dependency

Usage

// TODO

Command Line

$ dpdm --help
dpdm
Version: 1.0.0
A module and internal file dependencies analyzer

Usage: dpdm [options] <...entries>

Options:
        -v,--version: optional
                output version of the command
        -h,--help: optional
                output help information
        -c,--cwd    cwd: optional
                The work context directory to resolve files, default 
                is ${CWD}
        -r,--root    root: optional
                The root directory to limit files dependencies, if 
                resolved path is output the dir, will be treated as 
                unknown dependencies, default is argv.cwd
        -b,--basedir    basedir: optional
                The prefix to remove for all resolved files, add / is 
                better, default is argv.root
        -p,--parsers    parser:config,...: optional
                The extra parsers for add on, the TypescriptParser is 
                mounted default
        -r,--resolution    classic|node: optional
                The module resolution mode, default is node
        -o,--output    dist: optional
                The dist file to write parse result, if not specified, 
                will print to process.stdout
        -d,--diff    path: optional
                get the diff to specified file, for example, -d 
                ./package.json#dependencies,devDependencies;./typings.json#globalDependencies

API

// TODO, maybe you can use type definition to realize

npm i -S dpdm

import {Analyzer} from 'dpdm/lib'

Plugins

// TODO, maybe you can use type definition to realize

npm i -S dpdm

import {IParser} from 'dpdm/lib'

License

MIT