1
0
Fork 0
mirror of https://github.com/actions/setup-python.git synced 2024-11-26 02:11:27 +00:00
setup-python/node_modules/realpath-native/README.md

61 lines
1.3 KiB
Markdown
Raw Normal View History

2019-06-27 01:12:00 +00:00
# realpath-native
> Use the system's native `realpath`
[![NPM Version][npm-image]][npm-url]
[![Linux & Mac Build Status][travis-image]][travis-url]
[![Greenkeeper Dependency Status][greenkeeper-image]][greenkeeper-url]
Node 9.3 added `fs.realpath(Sync).native`. On older Nodes you have to use
`process.binding` to access the same function. This module does that check for
you.
The advantage of the native `realpath` over `fs.realpath` is that the native one
better supports paths on Windows.
On node 4 the function uses the old `fs.realpath` function.
## Install
Install the module with `npm`:
```sh
$ npm install realpath-native
```
## Usage
```js
const realpath = require('realpath-native');
realpath('some-path'); // returns a promise
realpath.sync('some-path');
```
## API
### realpath(path)
Returns a promise for the resolved path of the input.
#### path
Type: `string`
### realpath.sync(path)
Returns the resolved path of the input synchronously.
#### path
Type: `string`
[npm-url]: https://npmjs.org/package/realpath-native
[npm-image]: https://img.shields.io/npm/v/realpath-native.svg
[travis-url]: https://travis-ci.org/SimenB/realpath-native
[travis-image]: https://img.shields.io/travis/SimenB/realpath-native/master.svg
[greenkeeper-url]: https://greenkeeper.io/
[greenkeeper-image]: https://badges.greenkeeper.io/SimenB/realpath-native.svg