Socket
Socket
Sign inDemoInstall

aliasify-patch

Package Overview
Dependencies
Maintainers
1
Versions
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

aliasify-patch

Rewrite require calls in browserify modules.


Version published
Weekly downloads
1
decreased by-50%
Maintainers
1
Weekly downloads
 
Created
Source

Aliasify is a transform for browserify which lets you rewrite calls to require.

Installation

Install with npm install --save-dev aliasify.

Usage

To use, add a section to your package.json:

{
    "aliasify": {
        aliases: {
            "d3": "./shims/d3.js"
            "underscore": "lodash"
        }
    }
}

Now if you have a file in src/browserify/index.js which looks like:

d3 = require('d3')
_ = require('underscore')
...

This will automatically be transformed to:

d3 = require('../../shims/d3.js')
_ = require('lodash')
...

Any replacement that starts with a "." will be resolved as a relative path (as "d3" above.) Replacements that start with any other character will be replaced verbatim (as with "underscore" above.)

Configuration

Configuration can be loaded in multiple ways; You can put your configuration directly in package.json, as in the example above, or you can use an external json or js file. In your package.json:

{
    "aliasify": "./aliasifyConfig.js"
}

Then in aliasifyConfig.js:

module.exports = {
    aliases: {
        "d3": "./shims/d3.js"
    },
    verbose: false
};

Note that using a js file means you can change your configuration based on environment variables.

Alternatively, if you're using the Browserify API, you can configure your aliasify programatically:

aliasify = require('aliasify').configure({
    aliases: {
        "d3": "./shims/d3.js"
    },
    configDir: __dirname,
    verbose: false
});

var b = browserify();
b.transform(aliasify);

note that configure() returns a new aliasify instance.

Configuration options:

  • aliases - An object mapping aliases to their replacements.
  • verbose - If true, then aliasify will print modificiations it is making to stdout.
  • configDir - An absolute path to resolve relative paths against. If you're using package.json, this will automatically be filled in for you with the directory containing package.json. If you're using a .js file for configuration, set this to __dirname.
  • appliesTo - Controls which files will be transformed. By default, only JS type files will be transformed ('.js', '.coffee', etc...). See browserify-trasnform-tools documentation for details.

Relative Requires

When you specify:

aliases: {
    "d3": "./shims/d3.js"
}

The "./" means this will be resolved relative to the configuration file which contains the line. Sometimes it is desirable to literally replace an alias; to resolve the alias relative to the file which is doing the require call. In this case you can do:

aliases: {
    "d3": {"relative": "./shims/d3.js"}
}

This will cause all occurences of require("d3") to be replaced with require("./shims/d3.js"), regardless of where those files are in the directory tree.

Alternatives

aliasify is essentially a fancy version of the browser field from package.json, which is interpreted by browserify.

Using the browser field is probably going to be faster, as it doesn't involve running a transform on each of your files. On the other hand, aliasify gives you a finer degree of control and can be run before other transforms (for example, you can run aliasify before debowerify, which will let you replace certain components that debowerify would otherwise replace.)

Keywords

FAQs

Package last updated on 15 Nov 2014

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc