package/package.json000644 000767 000024 0000003415 13131624676013033 0ustar00000000 000000 { "name": "is-absolute", "description": "Returns true if a file path is absolute. Does not rely on the path module and can be used as a polyfill for node.js native `path.isAbolute`.", "version": "1.0.0", "homepage": "https://github.com/jonschlinkert/is-absolute", "author": "Jon Schlinkert (https://github.com/jonschlinkert)", "contributors": [ "Elan Shanker (https://github.com/es128)", "Jon Schlinkert (http://twitter.com/jonschlinkert)", "Shinnosuke Watanabe (https://shinnn.github.io)", "(http://sobak.pl)" ], "repository": "jonschlinkert/is-absolute", "bugs": { "url": "https://github.com/jonschlinkert/is-absolute/issues" }, "license": "MIT", "files": [ "index.js" ], "main": "index.js", "engines": { "node": ">=0.10.0" }, "scripts": { "test": "mocha" }, "dependencies": { "is-relative": "^1.0.0", "is-windows": "^1.0.1" }, "devDependencies": { "gulp-format-md": "^1.0.0", "mocha": "^3.4.2" }, "keywords": [ "absolute", "built", "built-in", "check", "core", "detect", "dir", "file", "filepath", "is", "is-absolute", "isabsolute", "normalize", "path", "path-absolute", "path-is-absolute", "paths", "polyfill", "relative", "resolve", "shim", "slash", "slashes", "uri", "url", "util", "utils" ], "verb": { "run": true, "toc": false, "layout": "default", "tasks": [ "readme" ], "plugins": [ "gulp-format-md" ], "related": { "list": [ "is-dotfile", "is-glob", "is-relative", "is-unc-path", "is-valid-glob" ] }, "reflinks": [ "verb" ], "lint": { "reflinks": true } } } package/README.md000644 000767 000024 0000011221 12676414405012016 0ustar00000000 000000 # is-absolute [![NPM version](https://img.shields.io/npm/v/is-absolute.svg?style=flat)](https://www.npmjs.com/package/is-absolute) [![NPM monthly downloads](https://img.shields.io/npm/dm/is-absolute.svg?style=flat)](https://npmjs.org/package/is-absolute) [![NPM total downloads](https://img.shields.io/npm/dt/is-absolute.svg?style=flat)](https://npmjs.org/package/is-absolute) [![Linux Build Status](https://img.shields.io/travis/jonschlinkert/is-absolute.svg?style=flat&label=Travis)](https://travis-ci.org/jonschlinkert/is-absolute) > Returns true if a file path is absolute. Does not rely on the path module and can be used as a polyfill for node.js native `path.isAbolute`. ## Install Install with [npm](https://www.npmjs.com/): ```sh $ npm install --save is-absolute ``` Originally based on the `isAbsolute` utility method in [express](https://github.com/visionmedia/express). ## Usage ```js var isAbsolute = require('is-absolute'); isAbsolute('a/b/c.js'); //=> 'false' isAbsolute('/a/b/c.js'); //=> 'true' ``` **Explicitly test windows paths** ```js isAbsolute.posix('/foo/bar'); isAbsolute.posix('/user/docs/Letter.txt'); //=> true isAbsolute.posix('foo/bar'); //=> false ``` **Explicitly test windows paths** ```js var isAbsolute = require('is-absolute'); isAbsolute.win32('c:\\'); isAbsolute.win32('//C://user\\docs\\Letter.txt'); isAbsolute.win32('\\\\unc\\share'); isAbsolute.win32('\\\\unc\\share\\foo'); isAbsolute.win32('\\\\unc\\share\\foo\\'); isAbsolute.win32('\\\\unc\\share\\foo\\bar'); isAbsolute.win32('\\\\unc\\share\\foo\\bar\\'); isAbsolute.win32('\\\\unc\\share\\foo\\bar\\baz'); //=> true isAbsolute.win32('a:foo/a/b/c/d'); isAbsolute.win32(':\\'); isAbsolute.win32('foo\\bar\\baz'); isAbsolute.win32('foo\\bar\\baz\\'); //=> false ``` ## About ### Related projects * [is-dotfile](https://www.npmjs.com/package/is-dotfile): Return true if a file path is (or has) a dotfile. Returns false if the… [more](https://github.com/jonschlinkert/is-dotfile) | [homepage](https://github.com/jonschlinkert/is-dotfile "Return true if a file path is (or has) a dotfile. Returns false if the path is a dot directory.") * [is-glob](https://www.npmjs.com/package/is-glob): Returns `true` if the given string looks like a glob pattern or an extglob pattern… [more](https://github.com/jonschlinkert/is-glob) | [homepage](https://github.com/jonschlinkert/is-glob "Returns `true` if the given string looks like a glob pattern or an extglob pattern. This makes it easy to create code that only uses external modules like node-glob when necessary, resulting in much faster code execution and initialization time, and a bet") * [is-relative](https://www.npmjs.com/package/is-relative): Returns `true` if the path appears to be relative. | [homepage](https://github.com/jonschlinkert/is-relative "Returns `true` if the path appears to be relative.") * [is-unc-path](https://www.npmjs.com/package/is-unc-path): Returns true if a filepath is a windows UNC file path. | [homepage](https://github.com/jonschlinkert/is-unc-path "Returns true if a filepath is a windows UNC file path.") * [is-valid-glob](https://www.npmjs.com/package/is-valid-glob): Return true if a value is a valid glob pattern or patterns. | [homepage](https://github.com/jonschlinkert/is-valid-glob "Return true if a value is a valid glob pattern or patterns.") ### Contributing Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](../../issues/new). ### Contributors | **Commits** | **Contributor** | | --- | --- | | 35 | [jonschlinkert](https://github.com/jonschlinkert) | | 1 | [es128](https://github.com/es128) | | 1 | [shinnn](https://github.com/shinnn) | | 1 | [Sobak](https://github.com/Sobak) | ### Building docs _(This project's readme.md is generated by [verb](https://github.com/verbose/verb-generate-readme), please don't edit the readme directly. Any changes to the readme must be made in the [.verb.md](.verb.md) readme template.)_ To generate the readme, run the following command: ```sh $ npm install -g verbose/verb#dev verb-generate-readme && verb ``` ### Running tests Running and reviewing unit tests is a great way to get familiarized with a library and its API. You can install dependencies and run tests with the following command: ```sh $ npm install && npm test ``` ### Author **Jon Schlinkert** * [github/jonschlinkert](https://github.com/jonschlinkert) * [twitter/jonschlinkert](https://twitter.com/jonschlinkert) ### License Copyright © 2017, [Jon Schlinkert](https://github.com/jonschlinkert). Released under the [MIT License](LICENSE). *** _This file was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme), v0.6.0, on July 13, 2017._package/LICENSE000644 000767 000024 0000002150 13131624454011537 0ustar00000000 000000 The MIT License (MIT) Copyright (c) 2014-2017, Jon Schlinkert. Copyright (c) 2009-2014, TJ Holowaychuk Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. package/index.js000644 000767 000024 0000001536 13131624534012205 0ustar00000000 000000 'use strict'; var isRelative = require('is-relative'); var isWindows = require('is-windows'); /** * Expose `isAbsolute` */ module.exports = isAbsolute; /** * Returns true if a file path is absolute. * * @param {String} `fp` * @return {Boolean} */ function isAbsolute(fp) { if (typeof fp !== 'string') { throw new TypeError('isAbsolute expects a string.'); } return isWindows() ? isAbsolute.win32(fp) : isAbsolute.posix(fp); } /** * Test posix paths. */ isAbsolute.posix = function posixPath(fp) { return fp.charAt(0) === '/'; }; /** * Test windows paths. */ isAbsolute.win32 = function win32(fp) { if (/[a-z]/i.test(fp.charAt(0)) && fp.charAt(1) === ':' && fp.charAt(2) === '\\') { return true; } // Microsoft Azure absolute filepath if (fp.slice(0, 2) === '\\\\') { return true; } return !isRelative(fp); };