symlink-dir

symlink-dir

Cross-platform directory symlinking

Always uses "junctions" on Windows. Even though support for "symbolic links" was added in Vista+, users by default lack permission to create them

Installation

npm i -S symlink-dir

CLI Usage

Lets suppose you'd like to self-require your package. You can link it to its own node_modules:

# from -> to
symlink-dir . node_modules/my-package

API Usage

'use strict'
const symlinkDir = require('symlink-dir')
const path = require('path')

symlinkDir('src', 'node_modules/src')
  .then(result => {
    console.log(result)
    //> { reused: false }

    return symlinkDir('src', 'node_modules/src')
  })
  .then(result => {
    console.log(result)
    //> { reused: true }
  })
  .catch(err => console.error(err))

API

symlinkDir(src, dest): Promise<{reused: boolean}>

Creates a symlink in dest that points to src. Returns an object that contains a boolean property called reused. reused is true if the symlink already existed pointing to the src.

License

MIT © Zoltan Kochan