angular-slickgrid 4.1.4 → 4.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (187) hide show
  1. package/README.md +182 -180
  2. package/app/modules/angular-slickgrid/components/angular-slickgrid.component.d.ts +2 -2
  3. package/app/modules/angular-slickgrid/extensions/slickRowDetailView.d.ts +0 -2
  4. package/esm2020/app/modules/angular-slickgrid/components/angular-slickgrid.component.mjs +15 -12
  5. package/esm2020/app/modules/angular-slickgrid/extensions/slickRowDetailView.mjs +1 -3
  6. package/esm2020/app/modules/angular-slickgrid/modules/angular-slickgrid.module.mjs +7 -10
  7. package/esm2020/app/modules/angular-slickgrid/services/angularUtil.service.mjs +3 -3
  8. package/esm2020/app/modules/angular-slickgrid/services/bsDropdown.service.mjs +3 -3
  9. package/esm2020/app/modules/angular-slickgrid/services/container.service.mjs +3 -3
  10. package/esm2020/app/modules/angular-slickgrid/services/translater.service.mjs +3 -3
  11. package/fesm2015/angular-slickgrid.mjs +32 -34
  12. package/fesm2015/angular-slickgrid.mjs.map +1 -1
  13. package/fesm2020/angular-slickgrid.mjs +32 -34
  14. package/fesm2020/angular-slickgrid.mjs.map +1 -1
  15. package/{angular-slickgrid.d.ts → index.d.ts} +0 -0
  16. package/package.json +14 -15
  17. package/test/cypress/node_modules/@cypress/request/README.md +1038 -0
  18. package/test/cypress/node_modules/@cypress/xvfb/README.md +48 -0
  19. package/test/cypress/node_modules/@cypress/xvfb/node_modules/debug/README.md +437 -0
  20. package/test/cypress/node_modules/@types/node/README.md +16 -0
  21. package/test/cypress/node_modules/@types/sinonjs__fake-timers/README.md +16 -0
  22. package/test/cypress/node_modules/@types/sizzle/README.md +16 -0
  23. package/test/cypress/node_modules/@types/yauzl/README.md +16 -0
  24. package/test/cypress/node_modules/@types/yauzl/node_modules/@types/node/README.md +16 -0
  25. package/test/cypress/node_modules/aggregate-error/README.md +61 -0
  26. package/test/cypress/node_modules/ansi-colors/README.md +315 -0
  27. package/test/cypress/node_modules/ansi-escapes/README.md +245 -0
  28. package/test/cypress/node_modules/ansi-regex/README.md +78 -0
  29. package/test/cypress/node_modules/ansi-styles/README.md +152 -0
  30. package/test/cypress/node_modules/arch/README.md +71 -0
  31. package/test/cypress/node_modules/asn1/README.md +50 -0
  32. package/test/cypress/node_modules/assert-plus/README.md +162 -0
  33. package/test/cypress/node_modules/astral-regex/README.md +46 -0
  34. package/test/cypress/node_modules/async/README.md +60 -0
  35. package/test/cypress/node_modules/asynckit/README.md +233 -0
  36. package/test/cypress/node_modules/at-least-node/README.md +25 -0
  37. package/test/cypress/node_modules/aws-sign2/README.md +4 -0
  38. package/test/cypress/node_modules/aws4/README.md +183 -0
  39. package/test/cypress/node_modules/balanced-match/README.md +91 -0
  40. package/test/cypress/node_modules/base64-js/README.md +34 -0
  41. package/test/cypress/node_modules/bcrypt-pbkdf/README.md +45 -0
  42. package/test/cypress/node_modules/blob-util/README.md +623 -0
  43. package/test/cypress/node_modules/bluebird/README.md +57 -0
  44. package/test/cypress/node_modules/brace-expansion/README.md +129 -0
  45. package/test/cypress/node_modules/buffer/README.md +410 -0
  46. package/test/cypress/node_modules/buffer-crc32/README.md +47 -0
  47. package/test/cypress/node_modules/cachedir/README.md +27 -0
  48. package/test/cypress/node_modules/caseless/README.md +45 -0
  49. package/test/cypress/node_modules/chalk/README.md +293 -0
  50. package/test/cypress/node_modules/chalk/node_modules/supports-color/README.md +76 -0
  51. package/test/cypress/node_modules/check-more-types/README.md +952 -0
  52. package/test/cypress/node_modules/ci-info/README.md +114 -0
  53. package/test/cypress/node_modules/clean-stack/README.md +76 -0
  54. package/test/cypress/node_modules/cli-cursor/README.md +55 -0
  55. package/test/cypress/node_modules/cli-table3/README.md +218 -0
  56. package/test/cypress/node_modules/cli-truncate/README.md +139 -0
  57. package/test/cypress/node_modules/color-convert/README.md +68 -0
  58. package/test/cypress/node_modules/color-name/README.md +11 -0
  59. package/test/cypress/node_modules/colorette/README.md +102 -0
  60. package/test/cypress/node_modules/colors/README.md +221 -0
  61. package/test/cypress/node_modules/combined-stream/README.md +138 -0
  62. package/test/cypress/node_modules/commander/README.md +737 -0
  63. package/test/cypress/node_modules/common-tags/README.md +687 -0
  64. package/test/cypress/node_modules/core-util-is/README.md +3 -0
  65. package/test/cypress/node_modules/cross-spawn/README.md +96 -0
  66. package/test/cypress/node_modules/cypress/README.md +25 -0
  67. package/test/cypress/node_modules/cypress/mount-utils/README.md +14 -0
  68. package/test/cypress/node_modules/cypress/react/README.md +414 -0
  69. package/test/cypress/node_modules/cypress/vue/README.md +678 -0
  70. package/test/cypress/node_modules/cypress/vue2/README.md +693 -0
  71. package/test/cypress/node_modules/dashdash/README.md +574 -0
  72. package/test/cypress/node_modules/dayjs/README.md +128 -0
  73. package/test/cypress/node_modules/debug/README.md +455 -0
  74. package/test/cypress/node_modules/delayed-stream/README.md +141 -0
  75. package/test/cypress/node_modules/ecc-jsbn/README.md +8 -0
  76. package/test/cypress/node_modules/emoji-regex/README.md +73 -0
  77. package/test/cypress/node_modules/end-of-stream/README.md +54 -0
  78. package/test/cypress/node_modules/enquirer/README.md +1752 -0
  79. package/test/cypress/node_modules/escape-string-regexp/README.md +27 -0
  80. package/test/cypress/node_modules/eventemitter2/README.md +809 -0
  81. package/test/cypress/node_modules/execa/README.md +656 -0
  82. package/test/cypress/node_modules/executable/README.md +64 -0
  83. package/test/cypress/node_modules/extend/README.md +81 -0
  84. package/test/cypress/node_modules/extract-zip/README.md +57 -0
  85. package/test/cypress/node_modules/extract-zip/node_modules/debug/README.md +455 -0
  86. package/test/cypress/node_modules/extsprintf/README.md +46 -0
  87. package/test/cypress/node_modules/fd-slicer/README.md +199 -0
  88. package/test/cypress/node_modules/figures/README.md +139 -0
  89. package/test/cypress/node_modules/forever-agent/README.md +4 -0
  90. package/test/cypress/node_modules/form-data/README.md +234 -0
  91. package/test/cypress/node_modules/fs-extra/README.md +264 -0
  92. package/test/cypress/node_modules/fs.realpath/README.md +33 -0
  93. package/test/cypress/node_modules/get-stream/README.md +124 -0
  94. package/test/cypress/node_modules/getos/README.md +79 -0
  95. package/test/cypress/node_modules/getpass/README.md +32 -0
  96. package/test/cypress/node_modules/glob/README.md +375 -0
  97. package/test/cypress/node_modules/global-dirs/README.md +72 -0
  98. package/test/cypress/node_modules/graceful-fs/README.md +133 -0
  99. package/test/cypress/node_modules/has-flag/README.md +89 -0
  100. package/test/cypress/node_modules/http-signature/README.md +80 -0
  101. package/test/cypress/node_modules/human-signals/README.md +155 -0
  102. package/test/cypress/node_modules/ieee754/README.md +51 -0
  103. package/test/cypress/node_modules/indent-string/README.md +70 -0
  104. package/test/cypress/node_modules/inflight/README.md +37 -0
  105. package/test/cypress/node_modules/inherits/README.md +42 -0
  106. package/test/cypress/node_modules/ini/README.md +102 -0
  107. package/test/cypress/node_modules/is-ci/README.md +50 -0
  108. package/test/cypress/node_modules/is-fullwidth-code-point/README.md +39 -0
  109. package/test/cypress/node_modules/is-installed-globally/README.md +31 -0
  110. package/test/cypress/node_modules/is-path-inside/README.md +63 -0
  111. package/test/cypress/node_modules/is-stream/README.md +57 -0
  112. package/test/cypress/node_modules/is-typedarray/README.md +16 -0
  113. package/test/cypress/node_modules/isexe/README.md +51 -0
  114. package/test/cypress/node_modules/isstream/README.md +66 -0
  115. package/test/cypress/node_modules/jsbn/README.md +175 -0
  116. package/test/cypress/node_modules/json-schema/README.md +3 -0
  117. package/test/cypress/node_modules/json-stringify-safe/README.md +52 -0
  118. package/test/cypress/node_modules/jsonfile/README.md +205 -0
  119. package/test/cypress/node_modules/jsonfile/node_modules/universalify/README.md +76 -0
  120. package/test/cypress/node_modules/jsprim/README.md +287 -0
  121. package/test/cypress/node_modules/lazy-ass/README.md +269 -0
  122. package/test/cypress/node_modules/listr2/README.md +17 -0
  123. package/test/cypress/node_modules/lodash/README.md +39 -0
  124. package/test/cypress/node_modules/lodash.once/README.md +18 -0
  125. package/test/cypress/node_modules/log-symbols/README.md +51 -0
  126. package/test/cypress/node_modules/log-update/README.md +97 -0
  127. package/test/cypress/node_modules/log-update/node_modules/slice-ansi/README.md +66 -0
  128. package/test/cypress/node_modules/log-update/node_modules/wrap-ansi/README.md +97 -0
  129. package/test/cypress/node_modules/lru-cache/README.md +166 -0
  130. package/test/cypress/node_modules/merge-stream/README.md +78 -0
  131. package/test/cypress/node_modules/mime-db/README.md +102 -0
  132. package/test/cypress/node_modules/mime-types/README.md +123 -0
  133. package/test/cypress/node_modules/mimic-fn/README.md +69 -0
  134. package/test/cypress/node_modules/minimatch/README.md +209 -0
  135. package/test/cypress/node_modules/ms/README.md +60 -0
  136. package/test/cypress/node_modules/npm-run-path/README.md +115 -0
  137. package/test/cypress/node_modules/once/README.md +79 -0
  138. package/test/cypress/node_modules/onetime/README.md +94 -0
  139. package/test/cypress/node_modules/ospath/README.md +53 -0
  140. package/test/cypress/node_modules/p-map/README.md +89 -0
  141. package/test/cypress/node_modules/path-is-absolute/README.md +59 -0
  142. package/test/cypress/node_modules/path-key/README.md +61 -0
  143. package/test/cypress/node_modules/pend/README.md +41 -0
  144. package/test/cypress/node_modules/performance-now/README.md +30 -0
  145. package/test/cypress/node_modules/pify/README.md +119 -0
  146. package/test/cypress/node_modules/pretty-bytes/README.md +131 -0
  147. package/test/cypress/node_modules/proxy-from-env/README.md +131 -0
  148. package/test/cypress/node_modules/psl/README.md +215 -0
  149. package/test/cypress/node_modules/pump/README.md +65 -0
  150. package/test/cypress/node_modules/punycode/README.md +122 -0
  151. package/test/cypress/node_modules/qs/README.md +475 -0
  152. package/test/cypress/node_modules/request-progress/README.md +78 -0
  153. package/test/cypress/node_modules/restore-cursor/README.md +26 -0
  154. package/test/cypress/node_modules/rimraf/README.md +101 -0
  155. package/test/cypress/node_modules/rxjs/README.md +147 -0
  156. package/test/cypress/node_modules/rxjs/_esm2015/README.md +147 -0
  157. package/test/cypress/node_modules/rxjs/_esm5/README.md +147 -0
  158. package/test/cypress/node_modules/rxjs/src/README.md +147 -0
  159. package/test/cypress/node_modules/safe-buffer/README.md +584 -0
  160. package/test/cypress/node_modules/safer-buffer/README.md +156 -0
  161. package/test/cypress/node_modules/semver/README.md +566 -0
  162. package/test/cypress/node_modules/shebang-command/README.md +34 -0
  163. package/test/cypress/node_modules/shebang-regex/README.md +33 -0
  164. package/test/cypress/node_modules/signal-exit/README.md +39 -0
  165. package/test/cypress/node_modules/slice-ansi/README.md +72 -0
  166. package/test/cypress/node_modules/sshpk/README.md +804 -0
  167. package/test/cypress/node_modules/string-width/README.md +50 -0
  168. package/test/cypress/node_modules/strip-ansi/README.md +46 -0
  169. package/test/cypress/node_modules/strip-final-newline/README.md +30 -0
  170. package/test/cypress/node_modules/supports-color/README.md +77 -0
  171. package/test/cypress/node_modules/throttleit/README.md +32 -0
  172. package/test/cypress/node_modules/tmp/README.md +365 -0
  173. package/test/cypress/node_modules/tough-cookie/README.md +527 -0
  174. package/test/cypress/node_modules/tslib/README.md +142 -0
  175. package/test/cypress/node_modules/tunnel-agent/README.md +4 -0
  176. package/test/cypress/node_modules/tweetnacl/README.md +459 -0
  177. package/test/cypress/node_modules/type-fest/README.md +760 -0
  178. package/test/cypress/node_modules/universalify/README.md +76 -0
  179. package/test/cypress/node_modules/untildify/README.md +30 -0
  180. package/test/cypress/node_modules/uuid/README.md +505 -0
  181. package/test/cypress/node_modules/verror/README.md +528 -0
  182. package/test/cypress/node_modules/verror/node_modules/extsprintf/README.md +46 -0
  183. package/test/cypress/node_modules/which/README.md +54 -0
  184. package/test/cypress/node_modules/wrap-ansi/README.md +91 -0
  185. package/test/cypress/node_modules/wrappy/README.md +36 -0
  186. package/test/cypress/node_modules/yallist/README.md +204 -0
  187. package/test/cypress/node_modules/yauzl/README.md +658 -0
@@ -0,0 +1,264 @@
1
+ Node.js: fs-extra
2
+ =================
3
+
4
+ `fs-extra` adds file system methods that aren't included in the native `fs` module and adds promise support to the `fs` methods. It also uses [`graceful-fs`](https://github.com/isaacs/node-graceful-fs) to prevent `EMFILE` errors. It should be a drop in replacement for `fs`.
5
+
6
+ [![npm Package](https://img.shields.io/npm/v/fs-extra.svg)](https://www.npmjs.org/package/fs-extra)
7
+ [![License](https://img.shields.io/npm/l/express.svg)](https://github.com/jprichardson/node-fs-extra/blob/master/LICENSE)
8
+ [![build status](https://img.shields.io/travis/jprichardson/node-fs-extra/master.svg)](http://travis-ci.org/jprichardson/node-fs-extra)
9
+ [![windows Build status](https://img.shields.io/appveyor/ci/jprichardson/node-fs-extra/master.svg?label=windows%20build)](https://ci.appveyor.com/project/jprichardson/node-fs-extra/branch/master)
10
+ [![downloads per month](http://img.shields.io/npm/dm/fs-extra.svg)](https://www.npmjs.org/package/fs-extra)
11
+ [![Coverage Status](https://img.shields.io/coveralls/github/jprichardson/node-fs-extra/master.svg)](https://coveralls.io/github/jprichardson/node-fs-extra)
12
+ [![JavaScript Style Guide](https://img.shields.io/badge/code_style-standard-brightgreen.svg)](https://standardjs.com)
13
+
14
+ Why?
15
+ ----
16
+
17
+ I got tired of including `mkdirp`, `rimraf`, and `ncp` in most of my projects.
18
+
19
+
20
+
21
+
22
+ Installation
23
+ ------------
24
+
25
+ npm install fs-extra
26
+
27
+
28
+
29
+ Usage
30
+ -----
31
+
32
+ `fs-extra` is a drop in replacement for native `fs`. All methods in `fs` are attached to `fs-extra`. All `fs` methods return promises if the callback isn't passed.
33
+
34
+ You don't ever need to include the original `fs` module again:
35
+
36
+ ```js
37
+ const fs = require('fs') // this is no longer necessary
38
+ ```
39
+
40
+ you can now do this:
41
+
42
+ ```js
43
+ const fs = require('fs-extra')
44
+ ```
45
+
46
+ or if you prefer to make it clear that you're using `fs-extra` and not `fs`, you may want
47
+ to name your `fs` variable `fse` like so:
48
+
49
+ ```js
50
+ const fse = require('fs-extra')
51
+ ```
52
+
53
+ you can also keep both, but it's redundant:
54
+
55
+ ```js
56
+ const fs = require('fs')
57
+ const fse = require('fs-extra')
58
+ ```
59
+
60
+ Sync vs Async vs Async/Await
61
+ -------------
62
+ Most methods are async by default. All async methods will return a promise if the callback isn't passed.
63
+
64
+ Sync methods on the other hand will throw if an error occurs.
65
+
66
+ Also Async/Await will throw an error if one occurs.
67
+
68
+ Example:
69
+
70
+ ```js
71
+ const fs = require('fs-extra')
72
+
73
+ // Async with promises:
74
+ fs.copy('/tmp/myfile', '/tmp/mynewfile')
75
+ .then(() => console.log('success!'))
76
+ .catch(err => console.error(err))
77
+
78
+ // Async with callbacks:
79
+ fs.copy('/tmp/myfile', '/tmp/mynewfile', err => {
80
+ if (err) return console.error(err)
81
+ console.log('success!')
82
+ })
83
+
84
+ // Sync:
85
+ try {
86
+ fs.copySync('/tmp/myfile', '/tmp/mynewfile')
87
+ console.log('success!')
88
+ } catch (err) {
89
+ console.error(err)
90
+ }
91
+
92
+ // Async/Await:
93
+ async function copyFiles () {
94
+ try {
95
+ await fs.copy('/tmp/myfile', '/tmp/mynewfile')
96
+ console.log('success!')
97
+ } catch (err) {
98
+ console.error(err)
99
+ }
100
+ }
101
+
102
+ copyFiles()
103
+ ```
104
+
105
+
106
+ Methods
107
+ -------
108
+
109
+ ### Async
110
+
111
+ - [copy](docs/copy.md)
112
+ - [emptyDir](docs/emptyDir.md)
113
+ - [ensureFile](docs/ensureFile.md)
114
+ - [ensureDir](docs/ensureDir.md)
115
+ - [ensureLink](docs/ensureLink.md)
116
+ - [ensureSymlink](docs/ensureSymlink.md)
117
+ - [mkdirp](docs/ensureDir.md)
118
+ - [mkdirs](docs/ensureDir.md)
119
+ - [move](docs/move.md)
120
+ - [outputFile](docs/outputFile.md)
121
+ - [outputJson](docs/outputJson.md)
122
+ - [pathExists](docs/pathExists.md)
123
+ - [readJson](docs/readJson.md)
124
+ - [remove](docs/remove.md)
125
+ - [writeJson](docs/writeJson.md)
126
+
127
+ ### Sync
128
+
129
+ - [copySync](docs/copy-sync.md)
130
+ - [emptyDirSync](docs/emptyDir-sync.md)
131
+ - [ensureFileSync](docs/ensureFile-sync.md)
132
+ - [ensureDirSync](docs/ensureDir-sync.md)
133
+ - [ensureLinkSync](docs/ensureLink-sync.md)
134
+ - [ensureSymlinkSync](docs/ensureSymlink-sync.md)
135
+ - [mkdirpSync](docs/ensureDir-sync.md)
136
+ - [mkdirsSync](docs/ensureDir-sync.md)
137
+ - [moveSync](docs/move-sync.md)
138
+ - [outputFileSync](docs/outputFile-sync.md)
139
+ - [outputJsonSync](docs/outputJson-sync.md)
140
+ - [pathExistsSync](docs/pathExists-sync.md)
141
+ - [readJsonSync](docs/readJson-sync.md)
142
+ - [removeSync](docs/remove-sync.md)
143
+ - [writeJsonSync](docs/writeJson-sync.md)
144
+
145
+
146
+ **NOTE:** You can still use the native Node.js methods. They are promisified and copied over to `fs-extra`. See [notes on `fs.read()`, `fs.write()`, & `fs.writev()`](docs/fs-read-write-writev.md)
147
+
148
+ ### What happened to `walk()` and `walkSync()`?
149
+
150
+ They were removed from `fs-extra` in v2.0.0. If you need the functionality, `walk` and `walkSync` are available as separate packages, [`klaw`](https://github.com/jprichardson/node-klaw) and [`klaw-sync`](https://github.com/manidlou/node-klaw-sync).
151
+
152
+
153
+ Third Party
154
+ -----------
155
+
156
+ ### CLI
157
+
158
+ [fse-cli](https://www.npmjs.com/package/@atao60/fse-cli) allows you to run `fs-extra` from a console or from [npm](https://www.npmjs.com) scripts.
159
+
160
+ ### TypeScript
161
+
162
+ If you like TypeScript, you can use `fs-extra` with it: https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/fs-extra
163
+
164
+
165
+ ### File / Directory Watching
166
+
167
+ If you want to watch for changes to files or directories, then you should use [chokidar](https://github.com/paulmillr/chokidar).
168
+
169
+ ### Obtain Filesystem (Devices, Partitions) Information
170
+
171
+ [fs-filesystem](https://github.com/arthurintelligence/node-fs-filesystem) allows you to read the state of the filesystem of the host on which it is run. It returns information about both the devices and the partitions (volumes) of the system.
172
+
173
+ ### Misc.
174
+
175
+ - [fs-extra-debug](https://github.com/jdxcode/fs-extra-debug) - Send your fs-extra calls to [debug](https://npmjs.org/package/debug).
176
+ - [mfs](https://github.com/cadorn/mfs) - Monitor your fs-extra calls.
177
+
178
+
179
+
180
+ Hacking on fs-extra
181
+ -------------------
182
+
183
+ Wanna hack on `fs-extra`? Great! Your help is needed! [fs-extra is one of the most depended upon Node.js packages](http://nodei.co/npm/fs-extra.png?downloads=true&downloadRank=true&stars=true). This project
184
+ uses [JavaScript Standard Style](https://github.com/feross/standard) - if the name or style choices bother you,
185
+ you're gonna have to get over it :) If `standard` is good enough for `npm`, it's good enough for `fs-extra`.
186
+
187
+ [![js-standard-style](https://cdn.rawgit.com/feross/standard/master/badge.svg)](https://github.com/feross/standard)
188
+
189
+ What's needed?
190
+ - First, take a look at existing issues. Those are probably going to be where the priority lies.
191
+ - More tests for edge cases. Specifically on different platforms. There can never be enough tests.
192
+ - Improve test coverage. See coveralls output for more info.
193
+
194
+ Note: If you make any big changes, **you should definitely file an issue for discussion first.**
195
+
196
+ ### Running the Test Suite
197
+
198
+ fs-extra contains hundreds of tests.
199
+
200
+ - `npm run lint`: runs the linter ([standard](http://standardjs.com/))
201
+ - `npm run unit`: runs the unit tests
202
+ - `npm test`: runs both the linter and the tests
203
+
204
+
205
+ ### Windows
206
+
207
+ If you run the tests on the Windows and receive a lot of symbolic link `EPERM` permission errors, it's
208
+ because on Windows you need elevated privilege to create symbolic links. You can add this to your Windows's
209
+ account by following the instructions here: http://superuser.com/questions/104845/permission-to-make-symbolic-links-in-windows-7
210
+ However, I didn't have much luck doing this.
211
+
212
+ Since I develop on Mac OS X, I use VMWare Fusion for Windows testing. I create a shared folder that I map to a drive on Windows.
213
+ I open the `Node.js command prompt` and run as `Administrator`. I then map the network drive running the following command:
214
+
215
+ net use z: "\\vmware-host\Shared Folders"
216
+
217
+ I can then navigate to my `fs-extra` directory and run the tests.
218
+
219
+
220
+ Naming
221
+ ------
222
+
223
+ I put a lot of thought into the naming of these functions. Inspired by @coolaj86's request. So he deserves much of the credit for raising the issue. See discussion(s) here:
224
+
225
+ * https://github.com/jprichardson/node-fs-extra/issues/2
226
+ * https://github.com/flatiron/utile/issues/11
227
+ * https://github.com/ryanmcgrath/wrench-js/issues/29
228
+ * https://github.com/substack/node-mkdirp/issues/17
229
+
230
+ First, I believe that in as many cases as possible, the [Node.js naming schemes](http://nodejs.org/api/fs.html) should be chosen. However, there are problems with the Node.js own naming schemes.
231
+
232
+ For example, `fs.readFile()` and `fs.readdir()`: the **F** is capitalized in *File* and the **d** is not capitalized in *dir*. Perhaps a bit pedantic, but they should still be consistent. Also, Node.js has chosen a lot of POSIX naming schemes, which I believe is great. See: `fs.mkdir()`, `fs.rmdir()`, `fs.chown()`, etc.
233
+
234
+ We have a dilemma though. How do you consistently name methods that perform the following POSIX commands: `cp`, `cp -r`, `mkdir -p`, and `rm -rf`?
235
+
236
+ My perspective: when in doubt, err on the side of simplicity. A directory is just a hierarchical grouping of directories and files. Consider that for a moment. So when you want to copy it or remove it, in most cases you'll want to copy or remove all of its contents. When you want to create a directory, if the directory that it's suppose to be contained in does not exist, then in most cases you'll want to create that too.
237
+
238
+ So, if you want to remove a file or a directory regardless of whether it has contents, just call `fs.remove(path)`. If you want to copy a file or a directory whether it has contents, just call `fs.copy(source, destination)`. If you want to create a directory regardless of whether its parent directories exist, just call `fs.mkdirs(path)` or `fs.mkdirp(path)`.
239
+
240
+
241
+ Credit
242
+ ------
243
+
244
+ `fs-extra` wouldn't be possible without using the modules from the following authors:
245
+
246
+ - [Isaac Shlueter](https://github.com/isaacs)
247
+ - [Charlie McConnel](https://github.com/avianflu)
248
+ - [James Halliday](https://github.com/substack)
249
+ - [Andrew Kelley](https://github.com/andrewrk)
250
+
251
+
252
+
253
+
254
+ License
255
+ -------
256
+
257
+ Licensed under MIT
258
+
259
+ Copyright (c) 2011-2017 [JP Richardson](https://github.com/jprichardson)
260
+
261
+ [1]: http://nodejs.org/docs/latest/api/fs.html
262
+
263
+
264
+ [jsonfile]: https://github.com/jprichardson/node-jsonfile
@@ -0,0 +1,33 @@
1
+ # fs.realpath
2
+
3
+ A backwards-compatible fs.realpath for Node v6 and above
4
+
5
+ In Node v6, the JavaScript implementation of fs.realpath was replaced
6
+ with a faster (but less resilient) native implementation. That raises
7
+ new and platform-specific errors and cannot handle long or excessively
8
+ symlink-looping paths.
9
+
10
+ This module handles those cases by detecting the new errors and
11
+ falling back to the JavaScript implementation. On versions of Node
12
+ prior to v6, it has no effect.
13
+
14
+ ## USAGE
15
+
16
+ ```js
17
+ var rp = require('fs.realpath')
18
+
19
+ // async version
20
+ rp.realpath(someLongAndLoopingPath, function (er, real) {
21
+ // the ELOOP was handled, but it was a bit slower
22
+ })
23
+
24
+ // sync version
25
+ var real = rp.realpathSync(someLongAndLoopingPath)
26
+
27
+ // monkeypatch at your own risk!
28
+ // This replaces the fs.realpath/fs.realpathSync builtins
29
+ rp.monkeypatch()
30
+
31
+ // un-do the monkeypatching
32
+ rp.unmonkeypatch()
33
+ ```
@@ -0,0 +1,124 @@
1
+ # get-stream [![Build Status](https://travis-ci.com/sindresorhus/get-stream.svg?branch=master)](https://travis-ci.com/github/sindresorhus/get-stream)
2
+
3
+ > Get a stream as a string, buffer, or array
4
+
5
+ ## Install
6
+
7
+ ```
8
+ $ npm install get-stream
9
+ ```
10
+
11
+ ## Usage
12
+
13
+ ```js
14
+ const fs = require('fs');
15
+ const getStream = require('get-stream');
16
+
17
+ (async () => {
18
+ const stream = fs.createReadStream('unicorn.txt');
19
+
20
+ console.log(await getStream(stream));
21
+ /*
22
+ ,,))))))));,
23
+ __)))))))))))))),
24
+ \|/ -\(((((''''((((((((.
25
+ -*-==//////(('' . `)))))),
26
+ /|\ ))| o ;-. '((((( ,(,
27
+ ( `| / ) ;))))' ,_))^;(~
28
+ | | | ,))((((_ _____------~~~-. %,;(;(>';'~
29
+ o_); ; )))(((` ~---~ `:: \ %%~~)(v;(`('~
30
+ ; ''''```` `: `:::|\,__,%% );`'; ~
31
+ | _ ) / `:|`----' `-'
32
+ ______/\/~ | / /
33
+ /~;;.____/;;' / ___--,-( `;;;/
34
+ / // _;______;'------~~~~~ /;;/\ /
35
+ // | | / ; \;;,\
36
+ (<_ | ; /',/-----' _>
37
+ \_| ||_ //~;~~~~~~~~~
38
+ `\_| (,~~
39
+ \~\
40
+ ~~
41
+ */
42
+ })();
43
+ ```
44
+
45
+ ## API
46
+
47
+ The methods returns a promise that resolves when the `end` event fires on the stream, indicating that there is no more data to be read. The stream is switched to flowing mode.
48
+
49
+ ### getStream(stream, options?)
50
+
51
+ Get the `stream` as a string.
52
+
53
+ #### options
54
+
55
+ Type: `object`
56
+
57
+ ##### encoding
58
+
59
+ Type: `string`\
60
+ Default: `'utf8'`
61
+
62
+ [Encoding](https://nodejs.org/api/buffer.html#buffer_buffer) of the incoming stream.
63
+
64
+ ##### maxBuffer
65
+
66
+ Type: `number`\
67
+ Default: `Infinity`
68
+
69
+ Maximum length of the returned string. If it exceeds this value before the stream ends, the promise will be rejected with a `getStream.MaxBufferError` error.
70
+
71
+ ### getStream.buffer(stream, options?)
72
+
73
+ Get the `stream` as a buffer.
74
+
75
+ It honors the `maxBuffer` option as above, but it refers to byte length rather than string length.
76
+
77
+ ### getStream.array(stream, options?)
78
+
79
+ Get the `stream` as an array of values.
80
+
81
+ It honors both the `maxBuffer` and `encoding` options. The behavior changes slightly based on the encoding chosen:
82
+
83
+ - When `encoding` is unset, it assumes an [object mode stream](https://nodesource.com/blog/understanding-object-streams/) and collects values emitted from `stream` unmodified. In this case `maxBuffer` refers to the number of items in the array (not the sum of their sizes).
84
+
85
+ - When `encoding` is set to `buffer`, it collects an array of buffers. `maxBuffer` refers to the summed byte lengths of every buffer in the array.
86
+
87
+ - When `encoding` is set to anything else, it collects an array of strings. `maxBuffer` refers to the summed character lengths of every string in the array.
88
+
89
+ ## Errors
90
+
91
+ If the input stream emits an `error` event, the promise will be rejected with the error. The buffered data will be attached to the `bufferedData` property of the error.
92
+
93
+ ```js
94
+ (async () => {
95
+ try {
96
+ await getStream(streamThatErrorsAtTheEnd('unicorn'));
97
+ } catch (error) {
98
+ console.log(error.bufferedData);
99
+ //=> 'unicorn'
100
+ }
101
+ })()
102
+ ```
103
+
104
+ ## FAQ
105
+
106
+ ### How is this different from [`concat-stream`](https://github.com/maxogden/concat-stream)?
107
+
108
+ This module accepts a stream instead of being one and returns a promise instead of using a callback. The API is simpler and it only supports returning a string, buffer, or array. It doesn't have a fragile type inference. You explicitly choose what you want. And it doesn't depend on the huge `readable-stream` package.
109
+
110
+ ## Related
111
+
112
+ - [get-stdin](https://github.com/sindresorhus/get-stdin) - Get stdin as a string or buffer
113
+
114
+ ---
115
+
116
+ <div align="center">
117
+ <b>
118
+ <a href="https://tidelift.com/subscription/pkg/npm-get-stream?utm_source=npm-get-stream&utm_medium=referral&utm_campaign=readme">Get professional support for this package with a Tidelift subscription</a>
119
+ </b>
120
+ <br>
121
+ <sub>
122
+ Tidelift helps make open source sustainable for maintainers while giving companies<br>assurances about security, maintenance, and licensing for their dependencies.
123
+ </sub>
124
+ </div>
@@ -0,0 +1,79 @@
1
+ # getos
2
+
3
+ [![Greenkeeper badge](https://badges.greenkeeper.io/retrohacker/getos.svg)](https://greenkeeper.io/)
4
+
5
+ ![getos](./imgs/logo.png)
6
+
7
+ [![Build Status](https://travis-ci.org/retrohacker/getos.png?branch=master)](https://travis-ci.org/retrohacker/getos) ![](https://img.shields.io/github/issues/retrohacker/getos.svg) ![](https://img.shields.io/npm/dm/getos.svg) ![](https://img.shields.io/npm/v/getos.svg) ![](https://img.shields.io/npm/l/getos.svg) ![](https://img.shields.io/twitter/url/https/github.com/retrohacker/getos.svg?style=social)
8
+
9
+ [![NPM](https://nodei.co/npm/getos.png?downloads=true&downloadRank=true&stars=true)](https://nodei.co/npm/getos/)[![NPM](https://nodei.co/npm-dl/getos.png?months=9&height=3)](https://nodei.co/npm/getos/)
10
+
11
+ [![JavaScript Style Guide](https://cdn.rawgit.com/feross/standard/master/badge.svg)](https://github.com/feross/standard)
12
+
13
+
14
+ Get the OS/Distribution name of the environment you are working on
15
+
16
+ ## Problem
17
+
18
+ `os.platform()` returns `linux`. If you want the distrubtion name, you're out of luck.
19
+
20
+ ## Solution
21
+
22
+ This. Simply call:
23
+
24
+ ```js
25
+ var getos = require('getos')
26
+
27
+ getos(function(e,os) {
28
+ if(e) return console.log(e)
29
+ console.log("Your OS is:" +JSON.stringify(os))
30
+ })
31
+ ```
32
+
33
+ The `os` object conforms to:
34
+
35
+ ```js
36
+ {
37
+ os: [OS NAME],
38
+ dist:[DIST NAME],
39
+ codename:[CODENAME],
40
+ release:[VERSION]
41
+ }
42
+ ```
43
+
44
+ For example:
45
+
46
+ ```js
47
+ {
48
+ os: "linux",
49
+ dist: "Ubuntu",
50
+ codename: "precise",
51
+ release: "12.04"
52
+ }
53
+ ```
54
+
55
+ ## Disclaimer
56
+ Check `os.json` in this repo. Any distribution that *shares* a common resource file with another distrubtion is currently untested. These are the arrays of distrubitons with more than 1 member. If you are using one of these distrubtions, please submit an issue letting me know if it works. If it fails, please post the content of the file.
57
+
58
+ If you have a distrubtion *not* in `os.json`, please identify your resource file and submit it's name and content along with your distrbution/version in an issue.
59
+
60
+ Thanks for helping make this tool great.
61
+
62
+ ## Unit Tests
63
+
64
+ Unit tests stub out the behaviour of the OS files and libraries we depend on to ensure the behaviour of the application is sound. You can run these simply by running `npm test`
65
+
66
+ ## Authors and Contributors
67
+
68
+ getos has been made possible by these fantastic contributors:
69
+
70
+ <table><tbody>
71
+ <tr><th align="left">Benjamin E. Coe</th><td><a href="https://github.com/bcoe">GitHub/bcoe</a></td><td><a href="http://twitter.com/benjamincoe">Twitter/@benjamincoe</a></td></tr>
72
+ <tr><th align="left">Eugene Sharygin</th><td><a href="https://github.com/eush77">GitHub/eush77</a></td><td><a href="http://twitter.com/eush77">Twitter/@eush77</a></td></tr>
73
+ <tr><th align="left">David Routhieau</th><td><a href="https://github.com/root-io">GitHub/root-io</a></td><td>unknown</td></tr>
74
+ <tr><th align="left">Lawrence</th><td><a href="https://github.com/mindmelting">GitHub/mindmelting</a></td><td><a href="http://twitter.com/mindmelting">Twitter/@mindmelting</a></td></tr>
75
+ <tr><th align="left">Roman Jurkov</th><td><a href="https://github.com/winfinit">GitHub/winfinit</a></td><td><a href="http://twitter.com/winfinit">Twitter/@winfinit</a></td></tr>
76
+ <tr><th align="left">Rod Vagg</th><td><a href="https://github.com/rvagg">GitHub/rvagg</a></td><td><a href="http://twitter.com/rvagg">Twitter/@rvagg</a></td></tr>
77
+ <tr><th align="left">Zeke Sikelianos</th><td><a href="https://github.com/zeke">GitHub/zeke</a></td><td><a href="http://twitter.com/zeke">Twitter/@zeke</a></td></tr>
78
+ <tr><th align="left">Alexander</th><td><a href="https://github.com/alex4Zero">GitHub/alex4Zero</a></td><td><a href="http://twitter.com/alex4Zero">Twitter/@alex4Zero</a></td></tr>
79
+ </tbody></table>
@@ -0,0 +1,32 @@
1
+ ## getpass
2
+
3
+ Get a password from the terminal. Sounds simple? Sounds like the `readline`
4
+ module should be able to do it? NOPE.
5
+
6
+ ## Install and use it
7
+
8
+ ```bash
9
+ npm install --save getpass
10
+ ```
11
+
12
+ ```javascript
13
+ const mod_getpass = require('getpass');
14
+ ```
15
+
16
+ ## API
17
+
18
+ ### `mod_getpass.getPass([options, ]callback)`
19
+
20
+ Gets a password from the terminal. If available, this uses `/dev/tty` to avoid
21
+ interfering with any data being piped in or out of stdio.
22
+
23
+ This function prints a prompt (by default `Password:`) and then accepts input
24
+ without echoing.
25
+
26
+ Parameters:
27
+
28
+ * `options`, an Object, with properties:
29
+ * `prompt`, an optional String
30
+ * `callback`, a `Func(error, password)`, with arguments:
31
+ * `error`, either `null` (no error) or an `Error` instance
32
+ * `password`, a String