From 600c22543993d125e0973e7703ff7f4a478b1584 Mon Sep 17 00:00:00 2001
From: Gus Caplan <me@gus.host>
Date: Wed, 14 Mar 2018 18:36:59 -0500
Subject: [PATCH] module: add createRequireFunction method

PR-URL: https://github.com/nodejs/node/pull/19360
Reviewed-By: Anna Henningsen <anna@addaleax.net>
Reviewed-By: Benjamin Gruenbaum <benjamingr@gmail.com>
Reviewed-By: Jan Krems <jan.krems@gmail.com>
Reviewed-By: Bradley Farias <bradley.meck@gmail.com>
Reviewed-By: John-David Dalton <john.david.dalton@gmail.com>
---
 doc/api/modules.md                          | 18 ++++++++++++++++++
 lib/internal/modules/cjs/loader.js          | 10 ++++++++--
 test/parallel/test-module-create-require.js | 12 ++++++++++++
 3 files changed, 38 insertions(+), 2 deletions(-)
 create mode 100644 test/parallel/test-module-create-require.js

diff --git a/doc/api/modules.md b/doc/api/modules.md
index f7934706d6b0de..9919a675169e8b 100644
--- a/doc/api/modules.md
+++ b/doc/api/modules.md
@@ -888,12 +888,30 @@ by the [module wrapper][]. To access it, require the `Module` module:
 const builtin = require('module').builtinModules;
 ```
 
+### module.createRequireFromPath(filename)
+<!-- YAML
+added: REPLACEME
+-->
+
+* `filename` {string} Filename to be used to construct the relative require
+  function.
+* Returns: {[`require`][]} Require function
+
+```js
+const { createRequireFromPath } = require('module');
+const requireUtil = createRequireFromPath('../src/utils');
+
+// require `../src/utils/some-tool`
+requireUtil('./some-tool');
+```
+
 [`__dirname`]: #modules_dirname
 [`__filename`]: #modules_filename
 [`Error`]: errors.html#errors_class_error
 [`module` object]: #modules_the_module_object
 [`path.dirname()`]: path.html#path_path_dirname_path
 [GLOBAL_FOLDERS]: #modules_loading_from_the_global_folders
+[`require`]: #modules_require
 [exports shortcut]: #modules_exports_shortcut
 [module resolution]: #modules_all_together
 [module wrapper]: #modules_the_module_wrapper
diff --git a/lib/internal/modules/cjs/loader.js b/lib/internal/modules/cjs/loader.js
index 1e93791237c92f..3083cdbb8bce3f 100644
--- a/lib/internal/modules/cjs/loader.js
+++ b/lib/internal/modules/cjs/loader.js
@@ -23,6 +23,7 @@
 
 const { NativeModule } = require('internal/bootstrap/loaders');
 const util = require('util');
+const { pathToFileURL } = require('internal/url');
 const vm = require('vm');
 const assert = require('assert').ok;
 const fs = require('fs');
@@ -54,7 +55,6 @@ module.exports = Module;
 let asyncESM;
 let ModuleJob;
 let createDynamicModule;
-let pathToFileURL;
 let decorateErrorStack;
 
 function lazyLoadESM() {
@@ -63,7 +63,6 @@ function lazyLoadESM() {
   createDynamicModule = require(
     'internal/modules/esm/create_dynamic_module');
   decorateErrorStack = require('internal/util').decorateErrorStack;
-  pathToFileURL = require('internal/url').pathToFileURL;
 }
 
 const {
@@ -745,6 +744,13 @@ Module.runMain = function() {
   process._tickCallback();
 };
 
+Module.createRequireFromPath = (filename) => {
+  const m = new Module(filename);
+  m.filename = filename;
+  m.paths = Module._nodeModulePaths(path.dirname(filename));
+  return makeRequireFunction(m);
+};
+
 Module._initPaths = function() {
   const isWindows = process.platform === 'win32';
 
diff --git a/test/parallel/test-module-create-require.js b/test/parallel/test-module-create-require.js
new file mode 100644
index 00000000000000..03ed31939fba67
--- /dev/null
+++ b/test/parallel/test-module-create-require.js
@@ -0,0 +1,12 @@
+'use strict';
+
+require('../common');
+const assert = require('assert');
+const path = require('path');
+
+const { createRequireFromPath } = require('module');
+
+const p = path.resolve(__dirname, '..', 'fixtures', 'fake.js');
+
+const req = createRequireFromPath(p);
+assert.strictEqual(req('./baz'), 'perhaps I work');