time-to-botec/squiggle/node_modules/@stdlib/utils/convert-path/lib/convert_path.js

124 lines
3.8 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 isString = require( '@stdlib/assert/is-string' ).isPrimitive;
var reExtendedLengthPath = require( '@stdlib/regexp/extended-length-path' );
var lowercase = require( '@stdlib/string/lowercase' );
var replace = require( '@stdlib/string/replace' );
// VARIABLES //
var RE_WIN_DEVICE_ROOT = /^([A-Za-z]):[\\\/]+/; // eslint-disable-line no-useless-escape
var RE_POSIX_DEVICE_ROOT =/^\/([A-Za-z])\//;
// MAIN //
/**
* Converts between POSIX and Windows paths.
*
* @param {string} from - path to convert
* @param {string} to - output path convention
* @throws {TypeError} first argument must be a string
* @throws {TypeError} second argument must be a string
* @throws {RangeError} second argument must be a recognized output path convention
* @throws {Error} cannot convert a Windows extended-length path to a non-Windows path convention
* @returns {string} converted path
*
* @example
* var p = convertPath( '/c/foo/bar/beep.c', 'win32' );
* // returns 'c:\foo\bar\beep.c'
*
* @example
* var p = convertPath( '/c/foo/bar/beep.c', 'mixed' );
* // returns 'c:/foo/bar/beep.c'
*
* @example
* var p = convertPath( 'C:\\foo\\bar\\beep.c', 'posix' );
* // returns '/c/foo/bar/beep.c'
*
* @example
* var p = convertPath( 'C:\\foo\\bar\\beep.c', 'mixed' );
* // returns 'C:/foo/bar/beep.c'
*/
function convertPath( from, to ) {
var device;
var parts;
var out;
if ( !isString( from ) ) {
throw new TypeError( 'invalid argument. First argument must be a string primitive. Value: `'+from+'`.' );
}
if ( !isString( to ) ) {
throw new TypeError( 'invalid argument. Second argument must be a string primitive. Value: `'+to+'`.' );
}
if (
to !== 'win32' &&
to !== 'mixed' &&
to !== 'posix'
) {
throw new Error( 'invalid argument. Second argument must be a recognized output path convention. Value: `'+to+'`.' );
}
out = from;
// Convert to a Windows path convention by transforming a POSIX device root (if present) and using a Windows path separator...
if ( to === 'win32' ) {
parts = RE_POSIX_DEVICE_ROOT.exec( out );
if ( parts ) {
device = parts[ 1 ]+':\\';
out = replace( out, RE_POSIX_DEVICE_ROOT, device );
}
return replace( out, '/', '\\' );
}
// Check for Windows extended-length paths...
if ( reExtendedLengthPath.REGEXP.test( from ) ) {
throw new Error( 'invalid argument. Cannot convert Windows extended-length paths to POSIX paths. Value: `'+from+'`.' );
}
// Convert to a mixed path convention by combining a Windows drive letter convention with a POSIX path separator...
if ( to === 'mixed' ) {
parts = RE_POSIX_DEVICE_ROOT.exec( out );
if ( parts ) {
device = parts[ 1 ]+':/';
out = replace( out, RE_POSIX_DEVICE_ROOT, device );
} else {
parts = RE_WIN_DEVICE_ROOT.exec( out );
if ( parts ) {
device = parts[ 1 ]+':/';
out = replace( out, RE_WIN_DEVICE_ROOT, device );
}
}
return replace( out, '\\', '/' );
}
// Convert to a POSIX path convention by transforming a Windows device root (if present) and using a POSIX path separator...
parts = RE_WIN_DEVICE_ROOT.exec( out );
if ( parts ) {
device = '/'+lowercase( parts[ 1 ] )+'/';
out = replace( out, RE_WIN_DEVICE_ROOT, device );
}
return replace( out, '\\', '/' );
}
// EXPORTS //
module.exports = convertPath;