time-to-botec/squiggle/node_modules/@stdlib/regexp/extname-posix/lib/regexp.js

108 lines
2.3 KiB
JavaScript
Raw Normal View History

/**
* @license Apache-2.0
*
* Copyright (c) 2018 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';
// MODULES //
var reExtnamePosix = require( './main.js' );
// MAIN //
/**
* Captures a POSIX filename extension. Modified from Node.js [source][1].
*
* Regular expression: `/^(?:\/?|)(?:[\s\S]*?)(?:(?:\.{1,2}|[^\/]+?|)(\.[^.\/]*|))(?:[\/]*)$/`
*
* - `\^`
* - match any string which begins with
*
* - `(?:)`
* - capture but do not remember (root)
*
* - `\/?`
* - match a `/` literal zero or one time
*
* - `|)`
* - OR capture nothing
*
* - `(?:)`
* - capture but do not remember (directory)
*
* - `[\s\S]`
* - any space or non-space character
*
* - `*?`
* - zero or more times, but non-greedily (shortest possible match)
*
* - `(?:)`
* - capture but do not remember (basename)
*
* - `\.{1,2}`
* - match a `.` literal one or two times
*
* - `|`
* - OR
*
* - `[^\/]+?`
* - match anything which is not a `/` literal one or more times, but do so non-greedily
*
* - `|)`
* - OR capture nothing
*
* - `()`
* - capture
*
* - `\.`
* - match a `.` literal
*
* - `[^.\/]`
* - match anything which is not a `.` or `/` literal
*
* - `*`
* - zero or more times
*
* - `|)`
* - OR capture nothing
*
* - `(?:)`
* - capture but do not remember (trailing slash)
*
* - `[\/]`
* - match a `/` literal
*
* - `*`
* - zero or more times
*
* - `$`
* - end of string
*
* [1]: https://github.com/nodejs/node/blob/1a3b295d0f46b2189bd853800b1e63ab4d106b66/lib/path.js#L406
*
* @constant
* @type {RegExp}
* @default /^(?:\/?|)(?:[\s\S]*?)(?:(?:\.{1,2}|[^\/]+?|)(\.[^.\/]*|))(?:[\/]*)$/
*/
var RE_EXTNAME_POSIX = reExtnamePosix();
// EXPORTS //
module.exports = RE_EXTNAME_POSIX;