Package Exports
- pathmodify
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (pathmodify) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
This is a browserify plugin that's meant to do the same kind of thing as aliasify and remapify, but in a more elegant, powerful way. This hasn't been tested extensively yet, so consider it experimental. But some of the other alternatives already in common use don't really even work, so....
Installation & Quick Summary
npm install pathmodify
var pathmodify = require('pathmodify');
browserify()
.plugin(pathmodify(), {mods: [
// Make code like `require('app/something')` act like
// `require('/somedir/src/something')`
pathmodify.mod.dir('app', '/somedir/src')
]})
Purpose
Avoid having to use cumbersome relative paths (../../../../../../..
) in your browserified application, and still be able to apply transforms programatically: browserify().transform(something)
.
This plugin allows you to rewrite (AKA alias, map) require()
IDs / paths to different values. For example, rewrite require('app/model/something')
to a relative path like ./model/something
. This can be used to alias entire directories or any specific modules / ID string passed to require()
, and the rewriting can be dependent on the path of the requiring file as well.
Say you have a directory structure like...
somedir/
+-- src/
+-- entry.js
+-- model/
¦ +-- whatever.js
+-- subdir/
+-- subsubdir/
+-- something.js
...and entry.js
is the entry point to a dependency graph with a bunch of files not pictured. And say you don't want to store the application files you're going to browserify in node_modules
or symlink them there because it will break programmatic application of transforms (browserify().transform(whatever)
). (But, see below -- you can combine this tool with symlinking to get the best of both worlds.)
pathmodify allows you to require()
files like somedir/src/model/whatever.js
from anywhere in the dependency graph without using ./
or ../
relative paths, enabing a something.js
like this for example:
require('app/model/whatever');
Example usage
var
path = require('path'),
pathmodify = require('pathmodify');
var opts = {
// Feel free to think of `mods` as referring to either modifications or
// module IDs that are being altered. It is an array of possible
// modifications to apply to the values passed to `require()` calls in the
// browserified code. `mods` will be iterated until an entry is
// encountered that alters the `id` of the `require()` call being
// processed.
mods: [
// `id` type (exact match)
pathmodify.mod.id('jquery', '/somedir/jquery.js'),
// `dir` type (directory prefix)
pathmodify.mod.dir('app', '/somedir/src'),
// `re` type (regular expression)
pathmodify.mod.re(/(.*\.)abc$/, '$1.xyz'),
// Function
function (rec) {
var alias = {};
var prefix = 'app' + path.sep;
if (rec.id.indexOf(prefix) === 0) {
alias.id = path.join(
__dirname, 'src', rec.id.substr(prefix.length)
);
}
return alias;
}
]
};
browserify('./src/entry')
.plugin(pathmodify(), opts)
When the mod is a function it will receive an object like this:
{
// The string passed to `require()`
id: '...',
opts: {
// Absolute path of the parent file (the one that called require())
filename: '...'
}
}
It should leave the passed object alone and return an object like this if the id
should be aliased to something else:
{
// The path / id that should be resolved (as if the `require()` call
// contained this value).
id: '...',
// Optional name to expose the module as (like
// b.require('x', {expose: 'whatever'}))
expose: '...'
}
If you don't want to alias the id
to something else, don't return anything.
node_modules
As alluded to earlier, ordinarily you could store or symlink your application as something like node_modules/app
and require its files from node like require('app/something/whatever')
. But if you do that in browserify you lose the ability to apply transforms programatically, like:
browserify('./entry')
.transform(some_transform)
With this plugin you can get the best of both worlds by symlinking your application under node_modules
and get the normal resolution behavior in node, and use the same paths in browserify by rewriting them to absolute paths (outside of node_modules
) or paths relative to the requiring file. So if you have say /somedir/src
synlinked as node_modules/app
, you can use pathmodify like this:
// Point browserify to `./src/...`, not `app/...`
browserify('./src/entry')
.plugin(pathmodify(), {mods: [
pathmodify.mod.dir('app', path.join(__dirname, 'src'))
]})