1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
|
/**
* @license Apache-2.0
*
* Copyright (c) 2019 The Stdlib Authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
'use strict';
// MAIN //
/**
* Returns a regular expression for matching an incomplete `require` expression for file path completion.
*
* ## Notes
*
* - The regular expression also includes support for related `require` expressions, such as `rerequire` and `deeprerequire`.
*
* @private
* @returns {RegExp} regular expression
*
* @example
* var RE_REQUIRE = createRegExp();
*
* var bool = RE_REQUIRE.test( 'var foo = require( "foo" );' );
* // returns true
*
* @example
* var RE_REQUIRE = createRegExp();
*
* var bool = RE_REQUIRE.test( 'var foo = require( "./foo.js" );' );
* // returns true
*/
function createRegExp() {
/*
* Regular expression for an incomplete `require` expression.
*
* ## Examples
*
* - `'require( \'./foo'`
* - `'require( \'./foo/bar'`
* - `'require( \'./foo/bar/'`
* - `'require( \'foo'`
* - `'require( \'foo/bar'`
* - `'require( \'foo/bar/'`
* - `'require( \''`
* - `'require( \'.'`
* - `'require( \'./'`
* - `'require( \'..'`
* - `'require( \'../'`
* - `'require( \'./../'`
*
* Regular expression: `/\b(?:re|deepre|)require\s*\(\s*['"]((?:[\w@./-]+\/)?(?:[\w@./-]*))$/`
*
* - `\b`
* - match a word boundary
* - `(?:re|deepre|)`
* - capture, but do not remember, related `require` API prefixes
* - `require`
* - match the word `require` exactly
* - `\s*`
* - zero or more whitespace characters
* - `\(`
* - parenthesis literal
* - `\s*`
* - zero or more whitespace characters
* - `['"]`
* - either a `'` or a `"` mark
* - `(`
* - begin capture (1)
* - `(?:[\w@./-]+\/)`
* - capture, but do not remember, one or more path characters followed by a forward slash (2)
* - `?`
* - match zero or one time
* - `(?:[\w@./-]*)`
* - capture, but do not remember, zero or more path characters (3)
* - `)`
* - end capture (1)
* - `$`
* - match end of input
*/
return /\b(?:re|deepre|)require\s*\(\s*['"]((?:[\w@./-]+\/)?(?:[\w@./-]*))$/;
}
// EXPORTS //
module.exports = createRegExp;
|
