ouroboros-group/mybulma/node_modules/true-case-path
2023-07-30 18:21:54 -06:00
..
.vscode 20230730 2023-07-30 18:21:54 -06:00
test 20230730 2023-07-30 18:21:54 -06:00
.prettierrc 20230730 2023-07-30 18:21:54 -06:00
.travis.yml 20230730 2023-07-30 18:21:54 -06:00
CHANGELOG.md 20230730 2023-07-30 18:21:54 -06:00
index.d.ts 20230730 2023-07-30 18:21:54 -06:00
index.js 20230730 2023-07-30 18:21:54 -06:00
LICENSE 20230730 2023-07-30 18:21:54 -06:00
package.json 20230730 2023-07-30 18:21:54 -06:00
README.md 20230730 2023-07-30 18:21:54 -06:00

true-case-path

TravisCI Build Status

Given a possibly case-variant version of an existing filesystem path, returns the absolute, case-exact, normalized version as stored in the filesystem.

Usage

const { trueCasePath, trueCasePathSync } = require('true-case-path')

trueCasePath(<fileSystemPath>)
    .then((caseCorrectPath) => {
        // ...
    })

const caseCorrectPath = trueCasePathSync(<fileSystemPath>)

NOTE: If no matching path exists, an error with be thrown.


Optionally takes a second argument to use as the base path to begin case-correction from. This can be particularly useful within shared hosting environments since true-case-path relies on the ability to list a directory's contents in order to check the case and attempting to list the contents of / or /home will generally result in a permissions error.

const { trueCasePath } = require('true-case-path')

trueCasePath('code/my-app/sOmE-FiLe', '/home/casey')

NOTE: When specifying a basePath, the first argument is expected to be the file path relative to that basePath. If the first argument is absolute, every path segment will be checked. basePath defaults to process.cwd() if not specified and the first argument is relative.

Platforms

Windows, OSX, and Linux

Examples

const { trueCasePathSync } = require('true-case-path')

trueCasePathSync('/users/guest') // OSX: -> '/Users/Guest'

trueCasePathSync('c:\\users\\all users') // Windows: -> 'c:\Users\All Users'