[Pkg-javascript-commits] [node-parse-filepath] 01/05: Import Upstream version 1.0.1
Paolo Greppi
paolog-guest at moszumanska.debian.org
Mon Dec 12 12:23:17 UTC 2016
This is an automated email from the git hooks/post-receive script.
paolog-guest pushed a commit to branch master
in repository node-parse-filepath.
commit 35bb0fef580c04f08b85292ebacdb63b04ec33cb
Author: Paolo Greppi <paolo.greppi at libpf.com>
Date: Mon Dec 12 11:48:12 2016 +0000
Import Upstream version 1.0.1
---
LICENSE | 21 +++++++++++
README.md | 111 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
index.js | 90 ++++++++++++++++++++++++++++++++++++++++++++++++
package.json | 79 ++++++++++++++++++++++++++++++++++++++++++
4 files changed, 301 insertions(+)
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..39245ac
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014-2016, Jon Schlinkert.
+
+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.
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3eb7ce5
--- /dev/null
+++ b/README.md
@@ -0,0 +1,111 @@
+# parse-filepath [![NPM version](https://img.shields.io/npm/v/parse-filepath.svg?style=flat)](https://www.npmjs.com/package/parse-filepath) [![NPM downloads](https://img.shields.io/npm/dm/parse-filepath.svg?style=flat)](https://npmjs.org/package/parse-filepath) [![Build Status](https://img.shields.io/travis/jonschlinkert/parse-filepath.svg?style=flat)](https://travis-ci.org/jonschlinkert/parse-filepath)
+
+> Pollyfill for node.js `path.parse`, parses a filepath into an object.
+
+You might also be interested in [global-prefix](https://github.com/jonschlinkert/global-prefix).
+
+## Install
+
+Install with [npm](https://www.npmjs.com/):
+
+```sh
+$ npm install parse-filepath --save
+```
+
+## Usage
+
+```js
+var parsePath = require('parse-filepath');
+parsePath(filepath);
+```
+
+This can be used as a polyfill for the native node.js `path.parse()` method, and it also adds a few properties:
+
+* `path`: the original filepath
+* `isAbsolute`: (getter) true if the given path is absolute
+* `absolute`: (getter) fully resolved, absolute filepath
+* `dirname`: alias for `dir`
+* `basename`: alias for `base`
+* `extname`: alias for `ext`
+* `stem`: alias for `name`
+
+**Example**
+
+```js
+var parsePath = require('parse-filepath');
+console.log(parsePath('foo/bar/baz/index.js'));
+```
+
+Returns:
+
+```js
+{ root: '',
+ dir: 'foo/bar/baz',
+ base: 'index.js',
+ ext: '.js',
+ name: 'index',
+
+ // aliases
+ extname: '.js',
+ basename: 'index.js',
+ dirname: 'foo/bar/baz',
+ stem: 'index',
+
+ // original path
+ path: 'foo/bar/baz/index.js',
+
+ // getters
+ absolute: [Getter/Setter],
+ isAbsolute: [Getter/Setter] }
+```
+
+## Related projects
+
+You might also be interested in these projects:
+
+* [global-prefix](https://www.npmjs.com/package/global-prefix): Get the npm global path prefix. | [homepage](https://github.com/jonschlinkert/global-prefix)
+* [is-absolute](https://www.npmjs.com/package/is-absolute): Polyfill for node.js `path.isAbolute`. Returns true if a file path is absolute. | [homepage](https://github.com/jonschlinkert/is-absolute)
+* [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)
+* [relative](https://www.npmjs.com/package/relative): Get the relative filepath from path A to path B. Calculates from file-to-directory, file-to-file, directory-to-file,… [more](https://www.npmjs.com/package/relative) | [homepage](https://github.com/jonschlinkert/relative)
+
+## Contributing
+
+Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](https://github.com/jonschlinkert/parse-filepath/issues/new).
+
+## Building docs
+
+Generate readme and API documentation with [verb](https://github.com/verbose/verb):
+
+```sh
+$ npm install verb && npm run docs
+```
+
+Or, if [verb](https://github.com/verbose/verb) is installed globally:
+
+```sh
+$ verb
+```
+
+## Running tests
+
+Install dev dependencies:
+
+```sh
+$ npm install -d && npm test
+```
+
+## Author
+
+**Jon Schlinkert**
+
+* [github/jonschlinkert](https://github.com/jonschlinkert)
+* [twitter/jonschlinkert](http://twitter.com/jonschlinkert)
+
+## License
+
+Copyright © 2016, [Jon Schlinkert](https://github.com/jonschlinkert).
+Released under the [MIT license](https://github.com/jonschlinkert/parse-filepath/blob/master/LICENSE).
+
+***
+
+_This file was generated by [verb](https://github.com/verbose/verb), v, on March 29, 2016._
\ No newline at end of file
diff --git a/index.js b/index.js
new file mode 100644
index 0000000..fce6f2c
--- /dev/null
+++ b/index.js
@@ -0,0 +1,90 @@
+'use strict';
+
+var path = require('path');
+var isAbsolute = require('is-absolute');
+var pathRoot = require('path-root');
+var MapCache = require('map-cache');
+var cache = new MapCache();
+
+module.exports = function(filepath) {
+ if (typeof filepath !== 'string') {
+ throw new TypeError('parse-filepath expects a string');
+ }
+
+ if (cache.has(filepath)) {
+ return cache.get(filepath);
+ }
+
+ var obj = {};
+ if (typeof path.parse === 'function') {
+ obj = path.parse(filepath);
+ obj.extname = obj.ext;
+ obj.basename = obj.base;
+ obj.dirname = obj.dir;
+ obj.stem = obj.name;
+
+ } else {
+ define(obj, 'root', function() {
+ return pathRoot(this.path);
+ });
+
+ define(obj, 'extname', function() {
+ return path.extname(filepath);
+ });
+
+ define(obj, 'ext', function() {
+ return this.extname;
+ });
+
+ define(obj, 'name', function() {
+ return path.basename(filepath, this.ext);
+ });
+
+ define(obj, 'stem', function() {
+ return this.name;
+ });
+
+ define(obj, 'base', function() {
+ return this.name + this.ext;
+ });
+
+ define(obj, 'basename', function() {
+ return this.base;
+ });
+
+ define(obj, 'dir', function() {
+ return path.dirname(filepath);
+ });
+
+ define(obj, 'dirname', function() {
+ return this.dir;
+ });
+ }
+
+ obj.path = filepath;
+
+ define(obj, 'absolute', function() {
+ return path.resolve(this.path);
+ });
+
+ define(obj, 'isAbsolute', function() {
+ return isAbsolute(this.path);
+ });
+
+ cache.set(filepath, obj);
+ return obj;
+};
+
+function define(obj, prop, fn) {
+ var cached;
+ Object.defineProperty(obj, prop, {
+ configurable: true,
+ enumerable: true,
+ set: function(val) {
+ cached = val;
+ },
+ get: function() {
+ return cached || (cached = fn.call(obj));
+ }
+ });
+}
diff --git a/package.json b/package.json
new file mode 100644
index 0000000..5f5acc5
--- /dev/null
+++ b/package.json
@@ -0,0 +1,79 @@
+{
+ "name": "parse-filepath",
+ "description": "Pollyfill for node.js `path.parse`, parses a filepath into an object.",
+ "version": "1.0.1",
+ "homepage": "https://github.com/jonschlinkert/parse-filepath",
+ "author": "Jon Schlinkert (https://github.com/jonschlinkert)",
+ "repository": "jonschlinkert/parse-filepath",
+ "bugs": {
+ "url": "https://github.com/jonschlinkert/parse-filepath/issues"
+ },
+ "license": "MIT",
+ "files": [
+ "index.js"
+ ],
+ "main": "index.js",
+ "engines": {
+ "node": ">=0.8"
+ },
+ "scripts": {
+ "test": "mocha"
+ },
+ "dependencies": {
+ "is-absolute": "^0.2.3",
+ "map-cache": "^0.2.0",
+ "path-root": "^0.1.1"
+ },
+ "devDependencies": {
+ "gulp-format-md": "^0.1.7",
+ "mocha": "^2.2.5",
+ "should": "^7.0.2"
+ },
+ "keywords": [
+ "absolute",
+ "basename",
+ "dir",
+ "directory",
+ "dirname",
+ "ext",
+ "extension",
+ "extname",
+ "file",
+ "filename",
+ "filepath",
+ "is-absolute",
+ "name",
+ "object",
+ "parse",
+ "parser",
+ "parts",
+ "path",
+ "segment"
+ ],
+ "verb": {
+ "run": true,
+ "toc": false,
+ "layout": "default",
+ "tasks": [
+ "readme"
+ ],
+ "plugins": [
+ "gulp-format-md"
+ ],
+ "related": {
+ "highlight": "global-prefix",
+ "list": [
+ "global-prefix",
+ "is-absolute",
+ "is-relative",
+ "relative"
+ ]
+ },
+ "reflinks": [
+ "verb"
+ ],
+ "lint": {
+ "reflinks": true
+ }
+ }
+}
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-javascript/node-parse-filepath.git
More information about the Pkg-javascript-commits
mailing list