mirror of
https://github.com/S2-/gitlit
synced 2025-08-03 21:00:04 +02:00
initial commit
This commit is contained in:
3
app/node_modules/klaw/.npmignore
generated
vendored
Normal file
3
app/node_modules/klaw/.npmignore
generated
vendored
Normal file
@@ -0,0 +1,3 @@
|
||||
tests/
|
||||
appveyor.yml
|
||||
.travis.yml
|
||||
42
app/node_modules/klaw/CHANGELOG.md
generated
vendored
Normal file
42
app/node_modules/klaw/CHANGELOG.md
generated
vendored
Normal file
@@ -0,0 +1,42 @@
|
||||
1.3.1 / 2016-10-25
|
||||
------------------
|
||||
### Added
|
||||
- `graceful-fs` added as an `optionalDependencies`. Thanks [ryanzim]!
|
||||
|
||||
1.3.0 / 2016-06-09
|
||||
------------------
|
||||
### Added
|
||||
- `filter` option to pre-filter and not walk directories.
|
||||
|
||||
1.2.0 / 2016-04-16
|
||||
------------------
|
||||
- added support for custom `fs` implementation. Useful for https://github.com/tschaub/mock-fs
|
||||
|
||||
1.1.3 / 2015-12-23
|
||||
------------------
|
||||
- bugfix: if `readdir` error, got hung up. See: https://github.com/jprichardson/node-klaw/issues/1
|
||||
|
||||
1.1.2 / 2015-11-12
|
||||
------------------
|
||||
- assert that param `dir` is a `string`
|
||||
|
||||
1.1.1 / 2015-10-25
|
||||
------------------
|
||||
- bug fix, options not being passed
|
||||
|
||||
1.1.0 / 2015-10-25
|
||||
------------------
|
||||
- added `queueMethod` and `pathSorter` to `options` to affect searching strategy.
|
||||
|
||||
1.0.0 / 2015-10-25
|
||||
------------------
|
||||
- removed unused `filter` param
|
||||
- bugfix: always set `streamOptions` to `objectMode`
|
||||
- simplified, converted from push mode (streams 1) to proper pull mode (streams 3)
|
||||
|
||||
0.1.0 / 2015-10-25
|
||||
------------------
|
||||
- initial release
|
||||
|
||||
<!-- contributors -->
|
||||
[ryanzim]: https://github.com/ryanzim
|
||||
15
app/node_modules/klaw/LICENSE
generated
vendored
Normal file
15
app/node_modules/klaw/LICENSE
generated
vendored
Normal file
@@ -0,0 +1,15 @@
|
||||
(The MIT License)
|
||||
|
||||
Copyright (c) 2015-2016 JP Richardson
|
||||
|
||||
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.
|
||||
270
app/node_modules/klaw/README.md
generated
vendored
Normal file
270
app/node_modules/klaw/README.md
generated
vendored
Normal file
@@ -0,0 +1,270 @@
|
||||
Node.js - klaw
|
||||
==============
|
||||
|
||||
A Node.js file system walker extracted from [fs-extra](https://github.com/jprichardson/node-fs-extra).
|
||||
|
||||
[](https://www.npmjs.org/package/klaw)
|
||||
[](http://travis-ci.org/jprichardson/node-klaw)
|
||||
[](https://ci.appveyor.com/project/jprichardson/node-klaw/branch/master)
|
||||
|
||||
<!-- [](https://github.com/feross/standard) -->
|
||||
<a href="http://standardjs.com"><img src="https://cdn.rawgit.com/feross/standard/master/sticker.svg" alt="Standard" width="100"></a>
|
||||
|
||||
Install
|
||||
-------
|
||||
|
||||
npm i --save klaw
|
||||
|
||||
|
||||
Name
|
||||
----
|
||||
|
||||
`klaw` is `walk` backwards :p
|
||||
|
||||
|
||||
Usage
|
||||
-----
|
||||
|
||||
### klaw(directory, [options])
|
||||
|
||||
Returns a [Readable stream](https://nodejs.org/api/stream.html#stream_class_stream_readable) that iterates
|
||||
through every file and directory starting with `dir` as the root. Every `read()` or `data` event
|
||||
returns an object with two properties: `path` and `stats`. `path` is the full path of the file and
|
||||
`stats` is an instance of [fs.Stats](https://nodejs.org/api/fs.html#fs_class_fs_stats).
|
||||
|
||||
- `directory`: The directory to recursively walk. Type `string`.
|
||||
- `options`: [Readable stream options](https://nodejs.org/api/stream.html#stream_new_stream_readable_options) and
|
||||
the following:
|
||||
- `queueMethod` (`string`, default: `'shift'`): Either `'shift'` or `'pop'`. On `readdir()` array, call either `shift()` or `pop()`.
|
||||
- `pathSorter` (`function`, default: `undefined`): Sorting [function for Arrays](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/sort).
|
||||
- `fs` (`object`, default: `require('fs')`): Use this to hook into the `fs` methods or to use [`mock-fs`](https://github.com/tschaub/mock-fs)
|
||||
- `filter` (`function`, default: `undefined`): Filtering [function for Arrays](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/filter)
|
||||
|
||||
**Streams 1 (push) example:**
|
||||
|
||||
```js
|
||||
var klaw = require('klaw')
|
||||
|
||||
var items = [] // files, directories, symlinks, etc
|
||||
klaw('/some/dir')
|
||||
.on('data', function (item) {
|
||||
items.push(item.path)
|
||||
})
|
||||
.on('end', function () {
|
||||
console.dir(items) // => [ ... array of files]
|
||||
})
|
||||
```
|
||||
|
||||
**Streams 2 & 3 (pull) example:**
|
||||
|
||||
```js
|
||||
var klaw = require('klaw')
|
||||
|
||||
var items = [] // files, directories, symlinks, etc
|
||||
klaw('/some/dir')
|
||||
.on('readable', function () {
|
||||
var item
|
||||
while ((item = this.read())) {
|
||||
items.push(item.path)
|
||||
}
|
||||
})
|
||||
.on('end', function () {
|
||||
console.dir(items) // => [ ... array of files]
|
||||
})
|
||||
```
|
||||
|
||||
If you're not sure of the differences on Node.js streams 1, 2, 3 then I'd
|
||||
recommend this resource as a good starting point: https://strongloop.com/strongblog/whats-new-io-js-beta-streams3/.
|
||||
|
||||
|
||||
### Error Handling
|
||||
|
||||
Listen for the `error` event.
|
||||
|
||||
Example:
|
||||
|
||||
```js
|
||||
var klaw = require('klaw')
|
||||
klaw('/some/dir')
|
||||
.on('readable', function () {
|
||||
var item
|
||||
while ((item = this.read())) {
|
||||
// do something with the file
|
||||
}
|
||||
})
|
||||
.on('error', function (err, item) {
|
||||
console.log(err.message)
|
||||
console.log(item.path) // the file the error occurred on
|
||||
})
|
||||
.on('end', function () {
|
||||
console.dir(items) // => [ ... array of files]
|
||||
})
|
||||
|
||||
```
|
||||
|
||||
|
||||
### Aggregation / Filtering / Executing Actions (Through Streams)
|
||||
|
||||
On many occasions you may want to filter files based upon size, extension, etc.
|
||||
Or you may want to aggregate stats on certain file types. Or maybe you want to
|
||||
perform an action on certain file types.
|
||||
|
||||
You should use the module [`through2`](https://www.npmjs.com/package/through2) to easily
|
||||
accomplish this.
|
||||
|
||||
Install `through2`:
|
||||
|
||||
npm i --save through2
|
||||
|
||||
|
||||
**Example (skipping directories):**
|
||||
|
||||
```js
|
||||
var klaw = require('klaw')
|
||||
var through2 = require('through2')
|
||||
|
||||
var excludeDirFilter = through2.obj(function (item, enc, next) {
|
||||
if (!item.stats.isDirectory()) this.push(item)
|
||||
next()
|
||||
})
|
||||
|
||||
var items = [] // files, directories, symlinks, etc
|
||||
klaw('/some/dir')
|
||||
.pipe(excludeDirFilter)
|
||||
.on('data', function (item) {
|
||||
items.push(item.path)
|
||||
})
|
||||
.on('end', function () {
|
||||
console.dir(items) // => [ ... array of files without directories]
|
||||
})
|
||||
|
||||
```
|
||||
**Example (ignore hidden directories):**
|
||||
```js
|
||||
var klaw = require('klaw')
|
||||
var path = require('path')
|
||||
|
||||
var filterFunc = function(item){
|
||||
var basename = path.basename(item)
|
||||
return basename === '.' || basename[0] !== '.'
|
||||
}
|
||||
|
||||
klaw('/some/dir', { filter : filterFunc })
|
||||
.on('data', function(item){
|
||||
// only items of none hidden folders will reach here
|
||||
})
|
||||
|
||||
```
|
||||
|
||||
**Example (totaling size of PNG files):**
|
||||
|
||||
```js
|
||||
var klaw = require('klaw')
|
||||
var path = require('path')
|
||||
var through2 = require('through2')
|
||||
|
||||
var totalPngsInBytes = 0
|
||||
var aggregatePngSize = through2.obj(function (item, enc, next) {
|
||||
if (path.extname(item.path) === '.png') {
|
||||
totalPngsInBytes += item.stats.size
|
||||
}
|
||||
this.push(item)
|
||||
next()
|
||||
})
|
||||
|
||||
klaw('/some/dir')
|
||||
.pipe(aggregatePngSize)
|
||||
.on('data', function (item) {
|
||||
items.push(item.path)
|
||||
})
|
||||
.on('end', function () {
|
||||
console.dir(totalPngsInBytes) // => total of all pngs (bytes)
|
||||
})
|
||||
```
|
||||
|
||||
|
||||
**Example (deleting all .tmp files):**
|
||||
|
||||
```js
|
||||
var fs = require('fs')
|
||||
var klaw = require('klaw')
|
||||
var through2 = require('through2')
|
||||
|
||||
var deleteAction = through2.obj(function (item, enc, next) {
|
||||
this.push(item)
|
||||
|
||||
if (path.extname(item.path) === '.tmp') {
|
||||
item.deleted = true
|
||||
fs.unklink(item.path, next)
|
||||
} else {
|
||||
item.deleted = false
|
||||
next()
|
||||
}
|
||||
})
|
||||
|
||||
var deletedFiles = []
|
||||
klaw('/some/dir')
|
||||
.pipe(deleteAction)
|
||||
.on('data', function (item) {
|
||||
if (!item.deleted) return
|
||||
deletedFiles.push(item.path)
|
||||
})
|
||||
.on('end', function () {
|
||||
console.dir(deletedFiles) // => all deleted files
|
||||
})
|
||||
```
|
||||
|
||||
You can even chain a bunch of these filters and aggregators together. By using
|
||||
multiple pipes.
|
||||
|
||||
**Example (using multiple filters / aggregators):**
|
||||
|
||||
```js
|
||||
klaw('/some/dir')
|
||||
.pipe(filterCertainFiles)
|
||||
.pipe(deleteSomeOtherFiles)
|
||||
.on('end', function () {
|
||||
console.log('all done!')
|
||||
})
|
||||
```
|
||||
|
||||
**Example passing (piping) through errors:**
|
||||
|
||||
Node.js does not `pipe()` errors. This means that the error on one stream, like
|
||||
`klaw` will not pipe through to the next. If you want to do this, do the following:
|
||||
|
||||
```js
|
||||
var klaw = require('klaw')
|
||||
var through2 = require('through2')
|
||||
|
||||
var excludeDirFilter = through2.obj(function (item, enc, next) {
|
||||
if (!item.stats.isDirectory()) this.push(item)
|
||||
next()
|
||||
})
|
||||
|
||||
var items = [] // files, directories, symlinks, etc
|
||||
klaw('/some/dir')
|
||||
.on('error', function (err) { excludeDirFilter.emit('error', err) }) // forward the error on
|
||||
.pipe(excludeDirFilter)
|
||||
.on('data', function (item) {
|
||||
items.push(item.path)
|
||||
})
|
||||
.on('end', function () {
|
||||
console.dir(items) // => [ ... array of files without directories]
|
||||
})
|
||||
```
|
||||
|
||||
|
||||
### Searching Strategy
|
||||
|
||||
Pass in options for `queueMethod` and `pathSorter` to affect how the file system
|
||||
is recursively iterated. See the code for more details, it's less than 50 lines :)
|
||||
|
||||
|
||||
|
||||
License
|
||||
-------
|
||||
|
||||
MIT
|
||||
|
||||
Copyright (c) 2015 [JP Richardson](https://github.com/jprichardson)
|
||||
70
app/node_modules/klaw/package.json
generated
vendored
Normal file
70
app/node_modules/klaw/package.json
generated
vendored
Normal file
@@ -0,0 +1,70 @@
|
||||
{
|
||||
"_from": "klaw@^1.0.0",
|
||||
"_id": "klaw@1.3.1",
|
||||
"_inBundle": false,
|
||||
"_integrity": "sha1-QIhDO0azsbolnXh4XY6W9zugJDk=",
|
||||
"_location": "/klaw",
|
||||
"_phantomChildren": {},
|
||||
"_requested": {
|
||||
"type": "range",
|
||||
"registry": true,
|
||||
"raw": "klaw@^1.0.0",
|
||||
"name": "klaw",
|
||||
"escapedName": "klaw",
|
||||
"rawSpec": "^1.0.0",
|
||||
"saveSpec": null,
|
||||
"fetchSpec": "^1.0.0"
|
||||
},
|
||||
"_requiredBy": [
|
||||
"/fs-extra"
|
||||
],
|
||||
"_resolved": "https://registry.npmjs.org/klaw/-/klaw-1.3.1.tgz",
|
||||
"_shasum": "4088433b46b3b1ba259d78785d8e96f73ba02439",
|
||||
"_spec": "klaw@^1.0.0",
|
||||
"_where": "E:\\projects\\p\\gitlit\\app\\node_modules\\fs-extra",
|
||||
"author": {
|
||||
"name": "JP Richardson"
|
||||
},
|
||||
"bugs": {
|
||||
"url": "https://github.com/jprichardson/node-klaw/issues"
|
||||
},
|
||||
"bundleDependencies": false,
|
||||
"dependencies": {
|
||||
"graceful-fs": "^4.1.9"
|
||||
},
|
||||
"deprecated": false,
|
||||
"description": "File system walker with Readable stream interface.",
|
||||
"devDependencies": {
|
||||
"mkdirp": "^0.5.1",
|
||||
"mock-fs": "^3.8.0",
|
||||
"rimraf": "^2.4.3",
|
||||
"standard": "^8.4.0",
|
||||
"tap-spec": "^4.1.1",
|
||||
"tape": "^4.2.2"
|
||||
},
|
||||
"homepage": "https://github.com/jprichardson/node-klaw#readme",
|
||||
"keywords": [
|
||||
"walk",
|
||||
"walker",
|
||||
"fs",
|
||||
"fs-extra",
|
||||
"readable",
|
||||
"streams"
|
||||
],
|
||||
"license": "MIT",
|
||||
"main": "./src/index.js",
|
||||
"name": "klaw",
|
||||
"optionalDependencies": {
|
||||
"graceful-fs": "^4.1.9"
|
||||
},
|
||||
"repository": {
|
||||
"type": "git",
|
||||
"url": "git+https://github.com/jprichardson/node-klaw.git"
|
||||
},
|
||||
"scripts": {
|
||||
"lint": "standard",
|
||||
"test": "npm run lint && npm run unit",
|
||||
"unit": "tape tests/**/*.js | tap-spec"
|
||||
},
|
||||
"version": "1.3.1"
|
||||
}
|
||||
16
app/node_modules/klaw/src/assign.js
generated
vendored
Normal file
16
app/node_modules/klaw/src/assign.js
generated
vendored
Normal file
@@ -0,0 +1,16 @@
|
||||
// simple mutable assign (extracted from fs-extra)
|
||||
// I really like object-assign package, but I wanted a lean package with zero deps
|
||||
function _assign () {
|
||||
var args = [].slice.call(arguments).filter(function (i) { return i })
|
||||
var dest = args.shift()
|
||||
args.forEach(function (src) {
|
||||
Object.keys(src).forEach(function (key) {
|
||||
dest[key] = src[key]
|
||||
})
|
||||
})
|
||||
|
||||
return dest
|
||||
}
|
||||
|
||||
// thank you baby Jesus for Node v4 and Object.assign
|
||||
module.exports = Object.assign || _assign
|
||||
57
app/node_modules/klaw/src/index.js
generated
vendored
Normal file
57
app/node_modules/klaw/src/index.js
generated
vendored
Normal file
@@ -0,0 +1,57 @@
|
||||
var assert = require('assert')
|
||||
var fs
|
||||
try {
|
||||
fs = require('graceful-fs')
|
||||
} catch (e) {
|
||||
fs = require('fs')
|
||||
}
|
||||
var path = require('path')
|
||||
var Readable = require('stream').Readable
|
||||
var util = require('util')
|
||||
var assign = require('./assign')
|
||||
|
||||
function Walker (dir, options) {
|
||||
assert.strictEqual(typeof dir, 'string', '`dir` parameter should be of type string. Got type: ' + typeof dir)
|
||||
var defaultStreamOptions = { objectMode: true }
|
||||
var defaultOpts = { queueMethod: 'shift', pathSorter: undefined, filter: undefined }
|
||||
options = assign(defaultOpts, options, defaultStreamOptions)
|
||||
|
||||
Readable.call(this, options)
|
||||
this.root = path.resolve(dir)
|
||||
this.paths = [this.root]
|
||||
this.options = options
|
||||
this.fs = options.fs || fs // mock-fs
|
||||
}
|
||||
util.inherits(Walker, Readable)
|
||||
|
||||
Walker.prototype._read = function () {
|
||||
if (this.paths.length === 0) return this.push(null)
|
||||
var self = this
|
||||
var pathItem = this.paths[this.options.queueMethod]()
|
||||
|
||||
self.fs.lstat(pathItem, function (err, stats) {
|
||||
var item = { path: pathItem, stats: stats }
|
||||
if (err) return self.emit('error', err, item)
|
||||
if (!stats.isDirectory()) return self.push(item)
|
||||
|
||||
self.fs.readdir(pathItem, function (err, pathItems) {
|
||||
if (err) {
|
||||
self.push(item)
|
||||
return self.emit('error', err, item)
|
||||
}
|
||||
|
||||
pathItems = pathItems.map(function (part) { return path.join(pathItem, part) })
|
||||
if (self.options.filter) pathItems = pathItems.filter(self.options.filter)
|
||||
if (self.options.pathSorter) pathItems.sort(self.options.pathSorter)
|
||||
pathItems.forEach(function (pi) { self.paths.push(pi) })
|
||||
|
||||
self.push(item)
|
||||
})
|
||||
})
|
||||
}
|
||||
|
||||
function walk (root, options) {
|
||||
return new Walker(root, options)
|
||||
}
|
||||
|
||||
module.exports = walk
|
||||
Reference in New Issue
Block a user