rechoir

What is rechoir?

The rechoir npm package is used to automatically load the appropriate module to handle a given file extension. It allows a project to require files with different extensions and have them preprocessed using the correct handler before being used. This is particularly useful when working with various transpilers or preprocessors in a Node.js environment.

What are rechoir's main functionalities?

Registering preprocessors for file extensions

This feature allows you to register preprocessors for specific file extensions. In the code sample, rechoir is used to prepare handling of '.ts' and '.coffee' files before requiring them.

require('rechoir').prepare({extensions: ['.ts', '.coffee']}, 'path/to/file.ts');

Other packages similar to rechoir

interpret

The 'interpret' package is similar to rechoir in that it maps file extensions to their associated module loaders. However, it does not automatically register these loaders; it simply provides the mapping for other tools to use.

liftoff

Liftoff is a higher-level tool that integrates with 'interpret' to provide a CLI tool that can automatically handle pre-processing files with different extensions. It is more feature-rich than rechoir, offering a more complete solution for bootstrapping applications with custom configurations and build steps.

require-extension-hooks

This package allows you to hook into the require function to add support for additional file types. It is similar to rechoir but provides a more granular control over the require process, allowing developers to define custom behavior when requiring specific file types.

README

rechoir

Require any supported file as a node module.

What is it?

This module can find, require and register any file type the npm ecosystem has a module loader for.

Currently supported extensions:

.co, .coco, .coffee, .iced, .ini, .js, .json, .litcoffee, .ls, .toml, .xml, .yaml, .yml

Note: If you'd like to add a new extension, please make a PR for interpret.

API

registerFor(filepath, requireFrom)

Look for a module loader associated with the provided file and attempt require it. If necessary, run any setup required to inject it into require.extensions. If calling this method is successful (aka: it doesn't throw), you can now require files of the type you requested natively.

filepath A file whose type you'd like to register a module loader for.

requireFrom An optional path to start searching for the module required to load the requested file. Defaults to the directory of filepath.

Note: While rechoir will automatically load and register transpilers like coffee-script, you must provide a local installation. The transpilers are not bundled with this module..

Usage

var rechoir = require('rechoir');
rechoir.registerFor('path/to/file.coffee');
// coffee-script is now loaded and registered with node
require('file.coffee');

load (filepath)

Automatically call requireFor, then require the requested file and return the result.

Usage

var rechoir = require('rechoir');
rechoir.load('file.coffee');