fsevents 1.2.4 → 1.2.6

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.

Potentially problematic release.


This version of fsevents might be problematic. Click here for more details.

Files changed (550) hide show
  1. package/.travis.yml +1 -1
  2. package/fsevents.cc +6 -15
  3. package/package.json +2 -2
  4. package/src/async.cc +2 -2
  5. package/src/thread.cc +5 -6
  6. package/build/.target.mk +0 -55
  7. package/build/Makefile +0 -352
  8. package/build/Release/.deps/Release/.node.d +0 -1
  9. package/build/Release/.deps/Release/fse.node.d +0 -1
  10. package/build/Release/.deps/Release/obj.target/action_after_build.stamp.d +0 -1
  11. package/build/Release/.deps/Release/obj.target/fse/fsevents.o.d +0 -67
  12. package/build/Release/.deps/Users/eshanker/Code/fsevents/lib/binding/Release/node-v64-darwin-x64/fse.node.d +0 -1
  13. package/build/Release/.node +0 -0
  14. package/build/Release/fse.node +0 -0
  15. package/build/Release/obj.target/action_after_build.stamp +0 -0
  16. package/build/Release/obj.target/fse/fsevents.o +0 -0
  17. package/build/action_after_build.target.mk +0 -32
  18. package/build/binding.Makefile +0 -6
  19. package/build/fse.target.mk +0 -184
  20. package/build/gyp-mac-tool +0 -611
  21. package/lib/binding/Release/node-v11-darwin-x64/fse.node +0 -0
  22. package/lib/binding/Release/node-v46-darwin-x64/fse.node +0 -0
  23. package/lib/binding/Release/node-v47-darwin-x64/fse.node +0 -0
  24. package/lib/binding/Release/node-v48-darwin-x64/fse.node +0 -0
  25. package/lib/binding/Release/node-v57-darwin-x64/fse.node +0 -0
  26. package/lib/binding/Release/node-v64-darwin-x64/fse.node +0 -0
  27. package/node_modules/abbrev/LICENSE +0 -46
  28. package/node_modules/abbrev/README.md +0 -23
  29. package/node_modules/abbrev/abbrev.js +0 -61
  30. package/node_modules/abbrev/package.json +0 -60
  31. package/node_modules/ansi-regex/index.js +0 -4
  32. package/node_modules/ansi-regex/license +0 -21
  33. package/node_modules/ansi-regex/package.json +0 -111
  34. package/node_modules/ansi-regex/readme.md +0 -39
  35. package/node_modules/aproba/LICENSE +0 -14
  36. package/node_modules/aproba/README.md +0 -94
  37. package/node_modules/aproba/index.js +0 -105
  38. package/node_modules/aproba/package.json +0 -65
  39. package/node_modules/are-we-there-yet/CHANGES.md +0 -31
  40. package/node_modules/are-we-there-yet/CHANGES.md~ +0 -27
  41. package/node_modules/are-we-there-yet/LICENSE +0 -5
  42. package/node_modules/are-we-there-yet/README.md +0 -195
  43. package/node_modules/are-we-there-yet/index.js +0 -4
  44. package/node_modules/are-we-there-yet/package.json +0 -66
  45. package/node_modules/are-we-there-yet/tracker-base.js +0 -11
  46. package/node_modules/are-we-there-yet/tracker-group.js +0 -107
  47. package/node_modules/are-we-there-yet/tracker-stream.js +0 -35
  48. package/node_modules/are-we-there-yet/tracker.js +0 -30
  49. package/node_modules/balanced-match/.npmignore +0 -5
  50. package/node_modules/balanced-match/LICENSE.md +0 -21
  51. package/node_modules/balanced-match/README.md +0 -91
  52. package/node_modules/balanced-match/index.js +0 -59
  53. package/node_modules/balanced-match/package.json +0 -80
  54. package/node_modules/brace-expansion/LICENSE +0 -21
  55. package/node_modules/brace-expansion/README.md +0 -129
  56. package/node_modules/brace-expansion/index.js +0 -201
  57. package/node_modules/brace-expansion/package.json +0 -78
  58. package/node_modules/chownr/LICENSE +0 -15
  59. package/node_modules/chownr/README.md +0 -3
  60. package/node_modules/chownr/chownr.js +0 -52
  61. package/node_modules/chownr/package.json +0 -59
  62. package/node_modules/code-point-at/index.js +0 -32
  63. package/node_modules/code-point-at/license +0 -21
  64. package/node_modules/code-point-at/package.json +0 -73
  65. package/node_modules/code-point-at/readme.md +0 -32
  66. package/node_modules/concat-map/.travis.yml +0 -4
  67. package/node_modules/concat-map/LICENSE +0 -18
  68. package/node_modules/concat-map/README.markdown +0 -62
  69. package/node_modules/concat-map/example/map.js +0 -6
  70. package/node_modules/concat-map/index.js +0 -13
  71. package/node_modules/concat-map/package.json +0 -91
  72. package/node_modules/concat-map/test/map.js +0 -39
  73. package/node_modules/console-control-strings/LICENSE +0 -13
  74. package/node_modules/console-control-strings/README.md +0 -145
  75. package/node_modules/console-control-strings/README.md~ +0 -140
  76. package/node_modules/console-control-strings/index.js +0 -125
  77. package/node_modules/console-control-strings/package.json +0 -64
  78. package/node_modules/core-util-is/LICENSE +0 -19
  79. package/node_modules/core-util-is/README.md +0 -3
  80. package/node_modules/core-util-is/float.patch +0 -604
  81. package/node_modules/core-util-is/lib/util.js +0 -107
  82. package/node_modules/core-util-is/package.json +0 -65
  83. package/node_modules/core-util-is/test.js +0 -68
  84. package/node_modules/debug/.coveralls.yml +0 -1
  85. package/node_modules/debug/.eslintrc +0 -11
  86. package/node_modules/debug/.npmignore +0 -9
  87. package/node_modules/debug/.travis.yml +0 -14
  88. package/node_modules/debug/CHANGELOG.md +0 -362
  89. package/node_modules/debug/LICENSE +0 -19
  90. package/node_modules/debug/Makefile +0 -50
  91. package/node_modules/debug/README.md +0 -312
  92. package/node_modules/debug/component.json +0 -19
  93. package/node_modules/debug/karma.conf.js +0 -70
  94. package/node_modules/debug/node.js +0 -1
  95. package/node_modules/debug/package.json +0 -91
  96. package/node_modules/debug/src/browser.js +0 -185
  97. package/node_modules/debug/src/debug.js +0 -202
  98. package/node_modules/debug/src/index.js +0 -10
  99. package/node_modules/debug/src/inspector-log.js +0 -15
  100. package/node_modules/debug/src/node.js +0 -248
  101. package/node_modules/deep-extend/CHANGELOG.md +0 -38
  102. package/node_modules/deep-extend/LICENSE +0 -20
  103. package/node_modules/deep-extend/README.md +0 -93
  104. package/node_modules/deep-extend/index.js +0 -1
  105. package/node_modules/deep-extend/lib/deep-extend.js +0 -150
  106. package/node_modules/deep-extend/package.json +0 -93
  107. package/node_modules/delegates/.npmignore +0 -1
  108. package/node_modules/delegates/History.md +0 -22
  109. package/node_modules/delegates/License +0 -20
  110. package/node_modules/delegates/Makefile +0 -8
  111. package/node_modules/delegates/Readme.md +0 -94
  112. package/node_modules/delegates/index.js +0 -121
  113. package/node_modules/delegates/package.json +0 -51
  114. package/node_modules/delegates/test/index.js +0 -94
  115. package/node_modules/detect-libc/.npmignore +0 -7
  116. package/node_modules/detect-libc/LICENSE +0 -201
  117. package/node_modules/detect-libc/README.md +0 -78
  118. package/node_modules/detect-libc/bin/detect-libc.js +0 -18
  119. package/node_modules/detect-libc/lib/detect-libc.js +0 -92
  120. package/node_modules/detect-libc/package.json +0 -73
  121. package/node_modules/fs-minipass/LICENSE +0 -15
  122. package/node_modules/fs-minipass/README.md +0 -70
  123. package/node_modules/fs-minipass/index.js +0 -386
  124. package/node_modules/fs-minipass/package.json +0 -65
  125. package/node_modules/fs.realpath/LICENSE +0 -43
  126. package/node_modules/fs.realpath/README.md +0 -33
  127. package/node_modules/fs.realpath/index.js +0 -66
  128. package/node_modules/fs.realpath/old.js +0 -303
  129. package/node_modules/fs.realpath/package.json +0 -62
  130. package/node_modules/gauge/CHANGELOG.md +0 -160
  131. package/node_modules/gauge/LICENSE +0 -13
  132. package/node_modules/gauge/README.md +0 -399
  133. package/node_modules/gauge/base-theme.js +0 -14
  134. package/node_modules/gauge/error.js +0 -24
  135. package/node_modules/gauge/has-color.js +0 -12
  136. package/node_modules/gauge/index.js +0 -233
  137. package/node_modules/gauge/package.json +0 -94
  138. package/node_modules/gauge/plumbing.js +0 -48
  139. package/node_modules/gauge/process.js +0 -3
  140. package/node_modules/gauge/progress-bar.js +0 -35
  141. package/node_modules/gauge/render-template.js +0 -181
  142. package/node_modules/gauge/set-immediate.js +0 -7
  143. package/node_modules/gauge/set-interval.js +0 -3
  144. package/node_modules/gauge/spin.js +0 -5
  145. package/node_modules/gauge/template-item.js +0 -73
  146. package/node_modules/gauge/theme-set.js +0 -115
  147. package/node_modules/gauge/themes.js +0 -54
  148. package/node_modules/gauge/wide-truncate.js +0 -25
  149. package/node_modules/glob/LICENSE +0 -15
  150. package/node_modules/glob/README.md +0 -368
  151. package/node_modules/glob/changelog.md +0 -67
  152. package/node_modules/glob/common.js +0 -240
  153. package/node_modules/glob/glob.js +0 -790
  154. package/node_modules/glob/package.json +0 -79
  155. package/node_modules/glob/sync.js +0 -486
  156. package/node_modules/has-unicode/LICENSE +0 -14
  157. package/node_modules/has-unicode/README.md +0 -43
  158. package/node_modules/has-unicode/index.js +0 -16
  159. package/node_modules/has-unicode/package.json +0 -61
  160. package/node_modules/iconv-lite/.travis.yml +0 -23
  161. package/node_modules/iconv-lite/Changelog.md +0 -146
  162. package/node_modules/iconv-lite/LICENSE +0 -21
  163. package/node_modules/iconv-lite/README.md +0 -156
  164. package/node_modules/iconv-lite/encodings/dbcs-codec.js +0 -555
  165. package/node_modules/iconv-lite/encodings/dbcs-data.js +0 -176
  166. package/node_modules/iconv-lite/encodings/index.js +0 -22
  167. package/node_modules/iconv-lite/encodings/internal.js +0 -188
  168. package/node_modules/iconv-lite/encodings/sbcs-codec.js +0 -72
  169. package/node_modules/iconv-lite/encodings/sbcs-data-generated.js +0 -451
  170. package/node_modules/iconv-lite/encodings/sbcs-data.js +0 -169
  171. package/node_modules/iconv-lite/encodings/tables/big5-added.json +0 -122
  172. package/node_modules/iconv-lite/encodings/tables/cp936.json +0 -264
  173. package/node_modules/iconv-lite/encodings/tables/cp949.json +0 -273
  174. package/node_modules/iconv-lite/encodings/tables/cp950.json +0 -177
  175. package/node_modules/iconv-lite/encodings/tables/eucjp.json +0 -182
  176. package/node_modules/iconv-lite/encodings/tables/gb18030-ranges.json +0 -1
  177. package/node_modules/iconv-lite/encodings/tables/gbk-added.json +0 -55
  178. package/node_modules/iconv-lite/encodings/tables/shiftjis.json +0 -125
  179. package/node_modules/iconv-lite/encodings/utf16.js +0 -177
  180. package/node_modules/iconv-lite/encodings/utf7.js +0 -290
  181. package/node_modules/iconv-lite/lib/bom-handling.js +0 -52
  182. package/node_modules/iconv-lite/lib/extend-node.js +0 -217
  183. package/node_modules/iconv-lite/lib/index.d.ts +0 -24
  184. package/node_modules/iconv-lite/lib/index.js +0 -153
  185. package/node_modules/iconv-lite/lib/streams.js +0 -121
  186. package/node_modules/iconv-lite/package.json +0 -79
  187. package/node_modules/ignore-walk/LICENSE +0 -15
  188. package/node_modules/ignore-walk/README.md +0 -60
  189. package/node_modules/ignore-walk/index.js +0 -265
  190. package/node_modules/ignore-walk/package.json +0 -74
  191. package/node_modules/inflight/LICENSE +0 -15
  192. package/node_modules/inflight/README.md +0 -37
  193. package/node_modules/inflight/inflight.js +0 -54
  194. package/node_modules/inflight/package.json +0 -61
  195. package/node_modules/inherits/LICENSE +0 -16
  196. package/node_modules/inherits/README.md +0 -42
  197. package/node_modules/inherits/inherits.js +0 -7
  198. package/node_modules/inherits/inherits_browser.js +0 -23
  199. package/node_modules/inherits/package.json +0 -67
  200. package/node_modules/ini/LICENSE +0 -15
  201. package/node_modules/ini/README.md +0 -102
  202. package/node_modules/ini/ini.js +0 -194
  203. package/node_modules/ini/package.json +0 -66
  204. package/node_modules/is-fullwidth-code-point/index.js +0 -46
  205. package/node_modules/is-fullwidth-code-point/license +0 -21
  206. package/node_modules/is-fullwidth-code-point/package.json +0 -80
  207. package/node_modules/is-fullwidth-code-point/readme.md +0 -39
  208. package/node_modules/isarray/.npmignore +0 -1
  209. package/node_modules/isarray/.travis.yml +0 -4
  210. package/node_modules/isarray/Makefile +0 -6
  211. package/node_modules/isarray/README.md +0 -60
  212. package/node_modules/isarray/component.json +0 -19
  213. package/node_modules/isarray/index.js +0 -5
  214. package/node_modules/isarray/package.json +0 -76
  215. package/node_modules/isarray/test.js +0 -20
  216. package/node_modules/minimatch/LICENSE +0 -15
  217. package/node_modules/minimatch/README.md +0 -209
  218. package/node_modules/minimatch/minimatch.js +0 -923
  219. package/node_modules/minimatch/package.json +0 -67
  220. package/node_modules/minimist/.travis.yml +0 -4
  221. package/node_modules/minimist/LICENSE +0 -18
  222. package/node_modules/minimist/example/parse.js +0 -2
  223. package/node_modules/minimist/index.js +0 -187
  224. package/node_modules/minimist/package.json +0 -74
  225. package/node_modules/minimist/readme.markdown +0 -73
  226. package/node_modules/minimist/test/dash.js +0 -24
  227. package/node_modules/minimist/test/default_bool.js +0 -20
  228. package/node_modules/minimist/test/dotted.js +0 -16
  229. package/node_modules/minimist/test/long.js +0 -31
  230. package/node_modules/minimist/test/parse.js +0 -318
  231. package/node_modules/minimist/test/parse_modified.js +0 -9
  232. package/node_modules/minimist/test/short.js +0 -67
  233. package/node_modules/minimist/test/whitespace.js +0 -8
  234. package/node_modules/minipass/README.md +0 -46
  235. package/node_modules/minipass/index.js +0 -304
  236. package/node_modules/minipass/package.json +0 -72
  237. package/node_modules/minizlib/LICENSE +0 -26
  238. package/node_modules/minizlib/README.md +0 -44
  239. package/node_modules/minizlib/constants.js +0 -46
  240. package/node_modules/minizlib/index.js +0 -364
  241. package/node_modules/minizlib/package.json +0 -74
  242. package/node_modules/mkdirp/.travis.yml +0 -8
  243. package/node_modules/mkdirp/LICENSE +0 -21
  244. package/node_modules/mkdirp/bin/cmd.js +0 -33
  245. package/node_modules/mkdirp/bin/usage.txt +0 -12
  246. package/node_modules/mkdirp/examples/pow.js +0 -6
  247. package/node_modules/mkdirp/index.js +0 -98
  248. package/node_modules/mkdirp/package.json +0 -67
  249. package/node_modules/mkdirp/readme.markdown +0 -100
  250. package/node_modules/mkdirp/test/chmod.js +0 -41
  251. package/node_modules/mkdirp/test/clobber.js +0 -38
  252. package/node_modules/mkdirp/test/mkdirp.js +0 -28
  253. package/node_modules/mkdirp/test/opts_fs.js +0 -29
  254. package/node_modules/mkdirp/test/opts_fs_sync.js +0 -27
  255. package/node_modules/mkdirp/test/perm.js +0 -32
  256. package/node_modules/mkdirp/test/perm_sync.js +0 -36
  257. package/node_modules/mkdirp/test/race.js +0 -37
  258. package/node_modules/mkdirp/test/rel.js +0 -32
  259. package/node_modules/mkdirp/test/return.js +0 -25
  260. package/node_modules/mkdirp/test/return_sync.js +0 -24
  261. package/node_modules/mkdirp/test/root.js +0 -19
  262. package/node_modules/mkdirp/test/sync.js +0 -32
  263. package/node_modules/mkdirp/test/umask.js +0 -28
  264. package/node_modules/mkdirp/test/umask_sync.js +0 -32
  265. package/node_modules/ms/index.js +0 -152
  266. package/node_modules/ms/license.md +0 -21
  267. package/node_modules/ms/package.json +0 -72
  268. package/node_modules/ms/readme.md +0 -51
  269. package/node_modules/needle/README.md +0 -593
  270. package/node_modules/needle/bin/needle +0 -40
  271. package/node_modules/needle/examples/deflated-stream.js +0 -22
  272. package/node_modules/needle/examples/digest-auth.js +0 -16
  273. package/node_modules/needle/examples/download-to-file.js +0 -18
  274. package/node_modules/needle/examples/multipart-stream.js +0 -25
  275. package/node_modules/needle/examples/parsed-stream.js +0 -23
  276. package/node_modules/needle/examples/parsed-stream2.js +0 -21
  277. package/node_modules/needle/examples/stream-events.js +0 -23
  278. package/node_modules/needle/examples/stream-to-file.js +0 -14
  279. package/node_modules/needle/examples/upload-image.js +0 -51
  280. package/node_modules/needle/lib/auth.js +0 -110
  281. package/node_modules/needle/lib/cookies.js +0 -77
  282. package/node_modules/needle/lib/decoder.js +0 -53
  283. package/node_modules/needle/lib/multipart.js +0 -98
  284. package/node_modules/needle/lib/needle.js +0 -783
  285. package/node_modules/needle/lib/parsers.js +0 -120
  286. package/node_modules/needle/lib/querystring.js +0 -49
  287. package/node_modules/needle/license.txt +0 -19
  288. package/node_modules/needle/package.json +0 -105
  289. package/node_modules/needle/test/basic_auth_spec.js +0 -196
  290. package/node_modules/needle/test/compression_spec.js +0 -94
  291. package/node_modules/needle/test/cookies_spec.js +0 -305
  292. package/node_modules/needle/test/decoder_spec.js +0 -86
  293. package/node_modules/needle/test/errors_spec.js +0 -286
  294. package/node_modules/needle/test/headers_spec.js +0 -198
  295. package/node_modules/needle/test/helpers.js +0 -72
  296. package/node_modules/needle/test/long_string_spec.js +0 -34
  297. package/node_modules/needle/test/output_spec.js +0 -254
  298. package/node_modules/needle/test/parsing_spec.js +0 -494
  299. package/node_modules/needle/test/post_data_spec.js +0 -1021
  300. package/node_modules/needle/test/proxy_spec.js +0 -202
  301. package/node_modules/needle/test/querystring_spec.js +0 -128
  302. package/node_modules/needle/test/redirect_spec.js +0 -392
  303. package/node_modules/needle/test/redirect_with_timeout.js +0 -45
  304. package/node_modules/needle/test/request_stream_spec.js +0 -202
  305. package/node_modules/needle/test/response_stream_spec.js +0 -139
  306. package/node_modules/needle/test/socket_pool_spec.js +0 -66
  307. package/node_modules/needle/test/url_spec.js +0 -147
  308. package/node_modules/needle/test/utils/formidable.js +0 -17
  309. package/node_modules/needle/test/utils/proxy.js +0 -62
  310. package/node_modules/needle/test/utils/test.js +0 -104
  311. package/node_modules/node-pre-gyp/CHANGELOG.md +0 -409
  312. package/node_modules/node-pre-gyp/LICENSE +0 -27
  313. package/node_modules/node-pre-gyp/README.md +0 -661
  314. package/node_modules/node-pre-gyp/appveyor.yml +0 -32
  315. package/node_modules/node-pre-gyp/bin/node-pre-gyp +0 -134
  316. package/node_modules/node-pre-gyp/bin/node-pre-gyp.cmd +0 -2
  317. package/node_modules/node-pre-gyp/contributing.md +0 -10
  318. package/node_modules/node-pre-gyp/lib/build.js +0 -51
  319. package/node_modules/node-pre-gyp/lib/clean.js +0 -32
  320. package/node_modules/node-pre-gyp/lib/configure.js +0 -52
  321. package/node_modules/node-pre-gyp/lib/info.js +0 -40
  322. package/node_modules/node-pre-gyp/lib/install.js +0 -221
  323. package/node_modules/node-pre-gyp/lib/node-pre-gyp.js +0 -203
  324. package/node_modules/node-pre-gyp/lib/package.js +0 -56
  325. package/node_modules/node-pre-gyp/lib/pre-binding.js +0 -30
  326. package/node_modules/node-pre-gyp/lib/publish.js +0 -79
  327. package/node_modules/node-pre-gyp/lib/rebuild.js +0 -21
  328. package/node_modules/node-pre-gyp/lib/reinstall.js +0 -20
  329. package/node_modules/node-pre-gyp/lib/reveal.js +0 -33
  330. package/node_modules/node-pre-gyp/lib/testbinary.js +0 -81
  331. package/node_modules/node-pre-gyp/lib/testpackage.js +0 -55
  332. package/node_modules/node-pre-gyp/lib/unpublish.js +0 -43
  333. package/node_modules/node-pre-gyp/lib/util/abi_crosswalk.json +0 -1734
  334. package/node_modules/node-pre-gyp/lib/util/compile.js +0 -87
  335. package/node_modules/node-pre-gyp/lib/util/handle_gyp_opts.js +0 -100
  336. package/node_modules/node-pre-gyp/lib/util/napi.js +0 -156
  337. package/node_modules/node-pre-gyp/lib/util/nw-pre-gyp/index.html +0 -26
  338. package/node_modules/node-pre-gyp/lib/util/nw-pre-gyp/package.json +0 -9
  339. package/node_modules/node-pre-gyp/lib/util/s3_setup.js +0 -27
  340. package/node_modules/node-pre-gyp/lib/util/versioning.js +0 -330
  341. package/node_modules/node-pre-gyp/package.json +0 -87
  342. package/node_modules/nopt/.npmignore +0 -1
  343. package/node_modules/nopt/.travis.yml +0 -8
  344. package/node_modules/nopt/CHANGELOG.md +0 -58
  345. package/node_modules/nopt/LICENSE +0 -15
  346. package/node_modules/nopt/README.md +0 -213
  347. package/node_modules/nopt/bin/nopt.js +0 -54
  348. package/node_modules/nopt/examples/my-program.js +0 -30
  349. package/node_modules/nopt/lib/nopt.js +0 -436
  350. package/node_modules/nopt/package.json +0 -61
  351. package/node_modules/nopt/test/basic.js +0 -303
  352. package/node_modules/npm-bundled/README.md +0 -46
  353. package/node_modules/npm-bundled/index.js +0 -227
  354. package/node_modules/npm-bundled/package.json +0 -63
  355. package/node_modules/npm-packlist/LICENSE +0 -15
  356. package/node_modules/npm-packlist/README.md +0 -68
  357. package/node_modules/npm-packlist/index.js +0 -220
  358. package/node_modules/npm-packlist/package.json +0 -69
  359. package/node_modules/npmlog/CHANGELOG.md +0 -49
  360. package/node_modules/npmlog/LICENSE +0 -15
  361. package/node_modules/npmlog/README.md +0 -216
  362. package/node_modules/npmlog/log.js +0 -309
  363. package/node_modules/npmlog/package.json +0 -64
  364. package/node_modules/number-is-nan/index.js +0 -4
  365. package/node_modules/number-is-nan/license +0 -21
  366. package/node_modules/number-is-nan/package.json +0 -70
  367. package/node_modules/number-is-nan/readme.md +0 -28
  368. package/node_modules/object-assign/index.js +0 -90
  369. package/node_modules/object-assign/license +0 -21
  370. package/node_modules/object-assign/package.json +0 -77
  371. package/node_modules/object-assign/readme.md +0 -61
  372. package/node_modules/once/LICENSE +0 -15
  373. package/node_modules/once/README.md +0 -79
  374. package/node_modules/once/once.js +0 -42
  375. package/node_modules/once/package.json +0 -70
  376. package/node_modules/os-homedir/index.js +0 -24
  377. package/node_modules/os-homedir/license +0 -21
  378. package/node_modules/os-homedir/package.json +0 -76
  379. package/node_modules/os-homedir/readme.md +0 -31
  380. package/node_modules/os-tmpdir/index.js +0 -25
  381. package/node_modules/os-tmpdir/license +0 -21
  382. package/node_modules/os-tmpdir/package.json +0 -76
  383. package/node_modules/os-tmpdir/readme.md +0 -32
  384. package/node_modules/osenv/LICENSE +0 -15
  385. package/node_modules/osenv/README.md +0 -63
  386. package/node_modules/osenv/osenv.js +0 -72
  387. package/node_modules/osenv/package.json +0 -76
  388. package/node_modules/path-is-absolute/index.js +0 -20
  389. package/node_modules/path-is-absolute/license +0 -21
  390. package/node_modules/path-is-absolute/package.json +0 -78
  391. package/node_modules/path-is-absolute/readme.md +0 -59
  392. package/node_modules/process-nextick-args/index.js +0 -44
  393. package/node_modules/process-nextick-args/license.md +0 -19
  394. package/node_modules/process-nextick-args/package.json +0 -53
  395. package/node_modules/process-nextick-args/readme.md +0 -18
  396. package/node_modules/rc/LICENSE.APACHE2 +0 -15
  397. package/node_modules/rc/LICENSE.BSD +0 -26
  398. package/node_modules/rc/LICENSE.MIT +0 -24
  399. package/node_modules/rc/README.md +0 -227
  400. package/node_modules/rc/browser.js +0 -7
  401. package/node_modules/rc/cli.js +0 -4
  402. package/node_modules/rc/index.js +0 -53
  403. package/node_modules/rc/lib/utils.js +0 -104
  404. package/node_modules/rc/node_modules/minimist/.travis.yml +0 -8
  405. package/node_modules/rc/node_modules/minimist/LICENSE +0 -18
  406. package/node_modules/rc/node_modules/minimist/example/parse.js +0 -2
  407. package/node_modules/rc/node_modules/minimist/index.js +0 -236
  408. package/node_modules/rc/node_modules/minimist/package.json +0 -76
  409. package/node_modules/rc/node_modules/minimist/readme.markdown +0 -91
  410. package/node_modules/rc/node_modules/minimist/test/all_bool.js +0 -32
  411. package/node_modules/rc/node_modules/minimist/test/bool.js +0 -166
  412. package/node_modules/rc/node_modules/minimist/test/dash.js +0 -31
  413. package/node_modules/rc/node_modules/minimist/test/default_bool.js +0 -35
  414. package/node_modules/rc/node_modules/minimist/test/dotted.js +0 -22
  415. package/node_modules/rc/node_modules/minimist/test/kv_short.js +0 -16
  416. package/node_modules/rc/node_modules/minimist/test/long.js +0 -31
  417. package/node_modules/rc/node_modules/minimist/test/num.js +0 -36
  418. package/node_modules/rc/node_modules/minimist/test/parse.js +0 -197
  419. package/node_modules/rc/node_modules/minimist/test/parse_modified.js +0 -9
  420. package/node_modules/rc/node_modules/minimist/test/short.js +0 -67
  421. package/node_modules/rc/node_modules/minimist/test/stop_early.js +0 -15
  422. package/node_modules/rc/node_modules/minimist/test/unknown.js +0 -102
  423. package/node_modules/rc/node_modules/minimist/test/whitespace.js +0 -8
  424. package/node_modules/rc/package.json +0 -66
  425. package/node_modules/rc/test/ini.js +0 -16
  426. package/node_modules/rc/test/nested-env-vars.js +0 -50
  427. package/node_modules/rc/test/test.js +0 -59
  428. package/node_modules/readable-stream/.travis.yml +0 -55
  429. package/node_modules/readable-stream/CONTRIBUTING.md +0 -38
  430. package/node_modules/readable-stream/GOVERNANCE.md +0 -136
  431. package/node_modules/readable-stream/LICENSE +0 -47
  432. package/node_modules/readable-stream/README.md +0 -58
  433. package/node_modules/readable-stream/doc/wg-meetings/2015-01-30.md +0 -60
  434. package/node_modules/readable-stream/duplex-browser.js +0 -1
  435. package/node_modules/readable-stream/duplex.js +0 -1
  436. package/node_modules/readable-stream/lib/_stream_duplex.js +0 -131
  437. package/node_modules/readable-stream/lib/_stream_passthrough.js +0 -47
  438. package/node_modules/readable-stream/lib/_stream_readable.js +0 -1019
  439. package/node_modules/readable-stream/lib/_stream_transform.js +0 -214
  440. package/node_modules/readable-stream/lib/_stream_writable.js +0 -687
  441. package/node_modules/readable-stream/lib/internal/streams/BufferList.js +0 -79
  442. package/node_modules/readable-stream/lib/internal/streams/destroy.js +0 -74
  443. package/node_modules/readable-stream/lib/internal/streams/stream-browser.js +0 -1
  444. package/node_modules/readable-stream/lib/internal/streams/stream.js +0 -1
  445. package/node_modules/readable-stream/package.json +0 -84
  446. package/node_modules/readable-stream/passthrough.js +0 -1
  447. package/node_modules/readable-stream/readable-browser.js +0 -7
  448. package/node_modules/readable-stream/readable.js +0 -19
  449. package/node_modules/readable-stream/transform.js +0 -1
  450. package/node_modules/readable-stream/writable-browser.js +0 -1
  451. package/node_modules/readable-stream/writable.js +0 -8
  452. package/node_modules/rimraf/LICENSE +0 -15
  453. package/node_modules/rimraf/README.md +0 -101
  454. package/node_modules/rimraf/bin.js +0 -50
  455. package/node_modules/rimraf/package.json +0 -67
  456. package/node_modules/rimraf/rimraf.js +0 -364
  457. package/node_modules/safe-buffer/.travis.yml +0 -7
  458. package/node_modules/safe-buffer/LICENSE +0 -21
  459. package/node_modules/safe-buffer/README.md +0 -584
  460. package/node_modules/safe-buffer/index.js +0 -62
  461. package/node_modules/safe-buffer/package.json +0 -68
  462. package/node_modules/safe-buffer/test.js +0 -101
  463. package/node_modules/safer-buffer/LICENSE +0 -21
  464. package/node_modules/safer-buffer/Porting-Buffer.md +0 -268
  465. package/node_modules/safer-buffer/Readme.md +0 -156
  466. package/node_modules/safer-buffer/dangerous.js +0 -58
  467. package/node_modules/safer-buffer/package.json +0 -63
  468. package/node_modules/safer-buffer/safer.js +0 -77
  469. package/node_modules/safer-buffer/tests.js +0 -406
  470. package/node_modules/sax/LICENSE +0 -41
  471. package/node_modules/sax/README.md +0 -225
  472. package/node_modules/sax/lib/sax.js +0 -1565
  473. package/node_modules/sax/package.json +0 -64
  474. package/node_modules/semver/LICENSE +0 -15
  475. package/node_modules/semver/README.md +0 -388
  476. package/node_modules/semver/bin/semver +0 -143
  477. package/node_modules/semver/package.json +0 -57
  478. package/node_modules/semver/range.bnf +0 -16
  479. package/node_modules/semver/semver.js +0 -1324
  480. package/node_modules/set-blocking/CHANGELOG.md +0 -26
  481. package/node_modules/set-blocking/LICENSE.txt +0 -14
  482. package/node_modules/set-blocking/README.md +0 -31
  483. package/node_modules/set-blocking/index.js +0 -7
  484. package/node_modules/set-blocking/package.json +0 -73
  485. package/node_modules/signal-exit/CHANGELOG.md +0 -27
  486. package/node_modules/signal-exit/LICENSE.txt +0 -16
  487. package/node_modules/signal-exit/README.md +0 -40
  488. package/node_modules/signal-exit/index.js +0 -157
  489. package/node_modules/signal-exit/package.json +0 -69
  490. package/node_modules/signal-exit/signals.js +0 -53
  491. package/node_modules/string-width/index.js +0 -37
  492. package/node_modules/string-width/license +0 -21
  493. package/node_modules/string-width/package.json +0 -92
  494. package/node_modules/string-width/readme.md +0 -42
  495. package/node_modules/string_decoder/.travis.yml +0 -50
  496. package/node_modules/string_decoder/LICENSE +0 -48
  497. package/node_modules/string_decoder/README.md +0 -47
  498. package/node_modules/string_decoder/lib/string_decoder.js +0 -296
  499. package/node_modules/string_decoder/package.json +0 -62
  500. package/node_modules/strip-ansi/index.js +0 -6
  501. package/node_modules/strip-ansi/license +0 -21
  502. package/node_modules/strip-ansi/package.json +0 -105
  503. package/node_modules/strip-ansi/readme.md +0 -33
  504. package/node_modules/strip-json-comments/index.js +0 -70
  505. package/node_modules/strip-json-comments/license +0 -21
  506. package/node_modules/strip-json-comments/package.json +0 -77
  507. package/node_modules/strip-json-comments/readme.md +0 -64
  508. package/node_modules/tar/LICENSE +0 -15
  509. package/node_modules/tar/README.md +0 -949
  510. package/node_modules/tar/index.js +0 -18
  511. package/node_modules/tar/lib/buffer.js +0 -11
  512. package/node_modules/tar/lib/create.js +0 -105
  513. package/node_modules/tar/lib/extract.js +0 -112
  514. package/node_modules/tar/lib/header.js +0 -273
  515. package/node_modules/tar/lib/high-level-opt.js +0 -29
  516. package/node_modules/tar/lib/large-numbers.js +0 -92
  517. package/node_modules/tar/lib/list.js +0 -130
  518. package/node_modules/tar/lib/mkdir.js +0 -206
  519. package/node_modules/tar/lib/pack.js +0 -403
  520. package/node_modules/tar/lib/parse.js +0 -422
  521. package/node_modules/tar/lib/pax.js +0 -146
  522. package/node_modules/tar/lib/read-entry.js +0 -94
  523. package/node_modules/tar/lib/replace.js +0 -220
  524. package/node_modules/tar/lib/types.js +0 -44
  525. package/node_modules/tar/lib/unpack.js +0 -560
  526. package/node_modules/tar/lib/update.js +0 -36
  527. package/node_modules/tar/lib/warn-mixin.js +0 -14
  528. package/node_modules/tar/lib/winchars.js +0 -23
  529. package/node_modules/tar/lib/write-entry.js +0 -403
  530. package/node_modules/tar/package.json +0 -81
  531. package/node_modules/util-deprecate/History.md +0 -16
  532. package/node_modules/util-deprecate/LICENSE +0 -24
  533. package/node_modules/util-deprecate/README.md +0 -53
  534. package/node_modules/util-deprecate/browser.js +0 -67
  535. package/node_modules/util-deprecate/node.js +0 -6
  536. package/node_modules/util-deprecate/package.json +0 -59
  537. package/node_modules/wide-align/LICENSE +0 -14
  538. package/node_modules/wide-align/README.md +0 -47
  539. package/node_modules/wide-align/align.js +0 -65
  540. package/node_modules/wide-align/package.json +0 -69
  541. package/node_modules/wrappy/LICENSE +0 -15
  542. package/node_modules/wrappy/README.md +0 -36
  543. package/node_modules/wrappy/package.json +0 -62
  544. package/node_modules/wrappy/wrappy.js +0 -33
  545. package/node_modules/yallist/LICENSE +0 -15
  546. package/node_modules/yallist/README.md +0 -204
  547. package/node_modules/yallist/iterator.js +0 -8
  548. package/node_modules/yallist/package.json +0 -66
  549. package/node_modules/yallist/yallist.js +0 -376
  550. package/src/locking.cc +0 -27
@@ -1,593 +0,0 @@
1
- Needle
2
- ======
3
-
4
- [![NPM](https://nodei.co/npm/needle.png)](https://nodei.co/npm/needle/)
5
-
6
- The leanest and most handsome HTTP client in the Nodelands.
7
-
8
- ```js
9
- var needle = require('needle');
10
-
11
- needle.get('http://www.google.com', function(error, response) {
12
- if (!error && response.statusCode == 200)
13
- console.log(response.body);
14
- });
15
- ```
16
-
17
- Callbacks not floating your boat? Needle got your back.
18
-
19
- ``` js
20
- var data = {
21
- file: '/home/johnlennon/walrus.png',
22
- content_type: 'image/png'
23
- };
24
-
25
- // the callback is optional, and needle returns a `readableStream` object
26
- // that triggers a 'done' event when the request/response process is complete.
27
- needle
28
- .post('https://my.server.com/foo', data, { multipart: true })
29
- .on('readable', function() { /* eat your chunks */ })
30
- .on('done', function(err, resp) {
31
- console.log('Ready-o!');
32
- })
33
- ```
34
-
35
- From version 2.0.x up, Promises are also supported. Just call `needle()` directly and you'll get a native Promise object.
36
-
37
- ```js
38
- needle('put', 'https://hacking.the.gibson/login', { password: 'god' })
39
- .then(function(response) {
40
- return doSomethingWith(response)
41
- })
42
- .catch(function(err) {
43
- console.log('Call the locksmith!')
44
- })
45
- ```
46
-
47
- With only two real dependencies, Needle supports:
48
-
49
- - HTTP/HTTPS requests, with the usual verbs you would expect
50
- - All of Node's native TLS options, such as 'rejectUnauthorized' (see below)
51
- - Basic & Digest authentication with auto-detection
52
- - Multipart form-data (e.g. file uploads)
53
- - HTTP Proxy forwarding, optionally with authentication
54
- - Streaming gzip or deflate decompression
55
- - Automatic XML & JSON parsing
56
- - 301/302/303 redirect following, with fine-grained tuning, and
57
- - Streaming non-UTF-8 charset decoding, via `iconv-lite`
58
-
59
- And yes, Mr. Wayne, it does come in black.
60
-
61
- This makes Needle an ideal alternative for performing quick HTTP requests in Node, either for API interaction, downloading or uploading streams of data, and so on. If you need OAuth, AWS support or anything fancier, you should check out mikeal's request module.
62
-
63
- Install
64
- -------
65
-
66
- ```
67
- $ npm install needle
68
- ```
69
-
70
- Usage
71
- -----
72
-
73
- ```js
74
- // using promises
75
- needle('get', 'https://server.com/posts/12')
76
- .then(function(resp) {
77
- // ...
78
- })
79
- .catch(function(err) {
80
- // ...
81
- })
82
- });
83
-
84
- // with callback
85
- needle.get('ifconfig.me/all.json', function(error, response, body) {
86
- if (error) throw error;
87
-
88
- // body is an alias for `response.body`,
89
- // that in this case holds a JSON-decoded object.
90
- console.log(body.ip_addr);
91
- });
92
-
93
- // no callback, using streams
94
- var out = fs.createWriteStream('logo.png');
95
- needle.get('https://google.com/images/logo.png').pipe(out).on('finish', function() {
96
- console.log('Pipe finished!');
97
- });
98
- ```
99
-
100
- As you can see, you can use Needle with Promises or without them. When using Promises or when a callback is passed, the response's body will be buffered and written to `response.body`, and the callback will be fired when all of the data has been collected and processed (e.g. decompressed, decoded and/or parsed).
101
-
102
- When no callback is passed, however, the buffering logic will be skipped but the response stream will still go through Needle's processing pipeline, so you get all the benefits of post-processing while keeping the streamishness we all love from Node.
103
-
104
- Response pipeline
105
- -----------------
106
-
107
- Depending on the response's Content-Type, Needle will either attempt to parse JSON or XML streams, or, if a text response was received, will ensure that the final encoding you get is UTF-8.
108
-
109
- You can also request a gzip/deflated response, which, if sent by the server, will be processed before parsing or decoding is performed.
110
-
111
- ```js
112
- needle.get('http://stackoverflow.com/feeds', { compressed: true }, function(err, resp) {
113
- console.log(resp.body); // this little guy won't be a Gzipped binary blob
114
- // but a nice object containing all the latest entries
115
- });
116
- ```
117
-
118
- Or in anti-callback mode, using a few other options:
119
-
120
- ```js
121
- var options = {
122
- compressed : true, // sets 'Accept-Encoding' to 'gzip,deflate'
123
- follow_max : 5, // follow up to five redirects
124
- rejectUnauthorized : true // verify SSL certificate
125
- }
126
-
127
- var stream = needle.get('https://backend.server.com/everything.html', options);
128
-
129
- // read the chunks from the 'readable' event, so the stream gets consumed.
130
- stream.on('readable', function() {
131
- while (data = this.read()) {
132
- console.log(data.toString());
133
- }
134
- })
135
-
136
- stream.on('done', function(err) {
137
- // if our request had an error, our 'done' event will tell us.
138
- if (!err) console.log('Great success!');
139
- })
140
- ```
141
-
142
- API
143
- ---
144
-
145
- ### needle(method, url[, data][, options][, callback]) `(> 2.0.x)`
146
-
147
- Calling `needle()` directly returns a Promise. Besides `method` and `url`, all parameters are optional, although when sending a `post`, `put` or `patch` request you will get an error if `data` is not present.
148
-
149
- ```js
150
- needle('get', 'http://some.url.com')
151
- .then(function(resp) { console.log(resp.body) })
152
- .catch(function(err) { console.error(err) })
153
- })
154
- ```
155
-
156
- Except from the above, all of Needle's request methods return a Readable stream, and both `options` and `callback` are optional. If passed, the callback will return three arguments: `error`, `response` and `body`, which is basically an alias for `response.body`.
157
-
158
- ### needle.head(url[, options][, callback])
159
-
160
- ```js
161
- needle.head('https://my.backend.server.com', {
162
- open_timeout: 5000 // if we're not able to open a connection in 5 seconds, boom.
163
- }, function(err, resp) {
164
- if (err)
165
- console.log('Shoot! Something is wrong: ' + err.message)
166
- else
167
- console.log('Yup, still alive.')
168
- })
169
- ```
170
-
171
- ### needle.get(url[, options][, callback])
172
-
173
- ```js
174
- needle.get('google.com/search?q=syd+barrett', function(err, resp) {
175
- // if no http:// is found, Needle will automagically prepend it.
176
- });
177
- ```
178
-
179
- ### needle.post(url, data[, options][, callback])
180
-
181
- ```js
182
- var options = {
183
- headers: { 'X-Custom-Header': 'Bumbaway atuna' }
184
- }
185
-
186
- needle.post('https://my.app.com/endpoint', 'foo=bar', options, function(err, resp) {
187
- // you can pass params as a string or as an object.
188
- });
189
- ```
190
-
191
- ### needle.put(url, data[, options][, callback])
192
-
193
- ```js
194
- var nested = {
195
- params: {
196
- are: {
197
- also: 'supported'
198
- }
199
- }
200
- }
201
-
202
- needle.put('https://api.app.com/v2', nested, function(err, resp) {
203
- console.log('Got ' + resp.bytes + ' bytes.') // another nice treat from this handsome fella.
204
- });
205
- ```
206
-
207
- ### needle.patch(url, data[, options][, callback])
208
-
209
- Same behaviour as PUT.
210
-
211
- ### needle.delete(url, data[, options][, callback])
212
-
213
- ```js
214
- var options = {
215
- username: 'fidelio',
216
- password: 'x'
217
- }
218
-
219
- needle.delete('https://api.app.com/messages/123', null, options, function(err, resp) {
220
- // in this case, data may be null, but you need to explicity pass it.
221
- });
222
- ```
223
-
224
- ### needle.request(method, url, data[, options][, callback])
225
-
226
- Generic request. This not only allows for flexibility, but also lets you perform a GET request with data, in which case will be appended to the request as a query string, unless you pass a `json: true` option (read below).
227
-
228
- ```js
229
- var params = {
230
- q : 'a very smart query',
231
- page : 2
232
- }
233
-
234
- needle.request('get', 'forum.com/search', params, function(err, resp) {
235
- if (!err && resp.statusCode == 200)
236
- console.log(resp.body); // here you go, mister.
237
- });
238
- ```
239
-
240
- Now, if you set pass `json: true` among the options, Needle won't set your params as a querystring but instead send a JSON representation of your data through the request's body, as well as set the `Content-Type` and `Accept` headers to `application/json`.
241
-
242
- ```js
243
- needle.request('get', 'forum.com/search', params, { json: true }, function(err, resp) {
244
- if (resp.statusCode == 200) console.log('It worked!');
245
- });
246
- ```
247
-
248
- Events
249
- ------
250
-
251
- The [Readable stream](https://nodejs.org/api/stream.html#stream_class_stream_readable) object returned by the above request methods emits the following events, in addition to the regular ones (e.g. `end`, `close`, `data`, `pipe`, `readable`).
252
-
253
- ### Event: `'response'`
254
-
255
- - `response <http.IncomingMessage>`
256
-
257
- Emitted when the underlying [http.ClientRequest](https://nodejs.org/api/http.html#http_class_http_clientrequest) emits a response event. This is after the connection is established and the header received, but before any of it is processed (e.g. authorization required or redirect to be followed). No data has been consumed at this point.
258
-
259
- ### Event: `'redirect'`
260
-
261
- - `location <String>`
262
-
263
- Indicates that the a redirect is being followed. This means that the response code was a redirect (`301`, `302`, `303`, `307`) and the given [redirect options](#redirect-options) allowed following the URL received in the `Location` header.
264
-
265
- ### Event: `'header'`
266
-
267
- - `statusCode <Integer>`
268
- - `headers <Object>`
269
-
270
- Triggered after the header has been processed, and just before the data is to be consumed. This implies that no redirect was followed and/or authentication header was received. In other words, we got a "valid" response.
271
-
272
- ### Event: `'done'` (previously 'end')
273
-
274
- - `exception <Error>` (optional)
275
-
276
- Emitted when the request/response process has finished, either because all data was consumed or an error ocurred somewhere in between. Unlike a regular stream's `end` event, Needle's `done` will be fired either on success or on failure, which is why the first argument may be an Error object. In other words:
277
-
278
- ```js
279
- var resp = needle.get('something.worthy/of/being/streamed/by/needle');
280
- resp.pipe(someWritableStream);
281
-
282
- resp.on('done', function(err) {
283
- if (err) console.log('An error ocurred: ' + err.message);
284
- else console.log('Great success!');
285
- })
286
- ```
287
-
288
- ### Event: `'err'`
289
-
290
- - `exception <Error>`
291
-
292
- Emitted when an error ocurrs. This should only happen once in the lifecycle of a Needle request.
293
-
294
- ### Event: `'timeout'`
295
-
296
- - `type <String>`
297
-
298
- Emitted when an timeout error occurs. Type can be either 'open', 'response', or 'read'. This will called right before aborting the request, which will also trigger an `err` event, a described above, with an `ECONNRESET` (Socket hang up) exception.
299
-
300
- Request options
301
- ---------------
302
-
303
- For information about options that've changed, there's always [the changelog](https://github.com/tomas/needle/releases).
304
-
305
- - `agent` : Uses an [http.Agent](https://nodejs.org/api/http.html#http_class_http_agent) of your choice, instead of the global, default one. Useful for tweaking the behaviour at the connection level, such as when doing tunneling (see below for an example).
306
- - `json` : When `true`, sets content type to `application/json` and sends request body as JSON string, instead of a query string.
307
- - `open_timeout`: (or `timeout`) Returns error if connection takes longer than X milisecs to establish. Defaults to `10000` (10 secs). `0` means no timeout.
308
- - `response_timeout`: Returns error if no response headers are received in X milisecs, counting from when the connection is opened. Defaults to `0` (no response timeout).
309
- - `read_timeout`: Returns error if data transfer takes longer than X milisecs, once response headers are received. Defaults to `0` (no timeout).
310
- - `follow_max` : (or `follow`) Number of redirects to follow. Defaults to `0`. See below for more redirect options.
311
- - `multipart` : Enables multipart/form-data encoding. Defaults to `false`. Use it when uploading files.
312
- - `proxy` : Forwards request through HTTP(s) proxy. Eg. `proxy: 'http://user:pass@proxy.server.com:3128'`. For more advanced proxying/tunneling use a custom `agent`, as described below.
313
- - `headers` : Object containing custom HTTP headers for request. Overrides defaults described below.
314
- - `auth` : Determines what to do with provided username/password. Options are `auto`, `digest` or `basic` (default). `auto` will detect the type of authentication depending on the response headers.
315
- - `stream_length`: When sending streams, this lets you manually set the Content-Length header --if the stream's bytecount is known beforehand--, preventing ECONNRESET (socket hang up) errors on some servers that misbehave when receiving payloads of unknown size. Set it to `0` and Needle will get and set the stream's length for you, or leave unset for the default behaviour, which is no Content-Length header for stream payloads.
316
-
317
- Response options
318
- ----------------
319
-
320
- - `decode_response` : (or `decode`) Whether to decode the text responses to UTF-8, if Content-Type header shows a different charset. Defaults to `true`.
321
- - `parse_response` : (or `parse`) Whether to parse XML or JSON response bodies automagically. Defaults to `true`. You can also set this to 'xml' or 'json' in which case Needle will *only* parse the response if the content type matches.
322
- - `output` : Dump response output to file. This occurs after parsing and charset decoding is done.
323
- - `parse_cookies` : Whether to parse response’s `Set-Cookie` header. Defaults to `true`. If parsed, response cookies will be available at `resp.cookies`.
324
-
325
- HTTP Header options
326
- -------------------
327
-
328
- These are basically shortcuts to the `headers` option described above.
329
-
330
- - `cookies` : Builds and sets a Cookie header from a `{ key: 'value' }` object.
331
- - `compressed`: If `true`, sets 'Accept-Encoding' header to 'gzip,deflate', and inflates content if zipped. Defaults to `false`.
332
- - `username` : For HTTP basic auth.
333
- - `password` : For HTTP basic auth. Requires username to be passed, but is optional.
334
- - `accept` : Sets 'Accept' HTTP header. Defaults to `*/*`.
335
- - `connection`: Sets 'Connection' HTTP header. Not set by default, unless running Node < 0.11.4 in which case it defaults to `close`. More info about this below.
336
- - `user_agent`: Sets the 'User-Agent' HTTP header. Defaults to `Needle/{version} (Node.js {node_version})`.
337
- - `content_type`: Sets the 'Content-Type' header. Unset by default, unless you're sending data in which case it's set accordingly to whatever is being sent (`application/x-www-form-urlencoded`, `application/json` or `multipart/form-data`). That is, of course, unless the option is passed, either here or through `options.headers`. You're the boss.
338
-
339
- Node.js TLS Options
340
- -------------------
341
-
342
- These options are passed directly to `https.request` if present. Taken from the [original documentation](http://nodejs.org/docs/latest/api/https.html):
343
-
344
- - `pfx` : Certificate, Private key and CA certificates to use for SSL.
345
- - `key` : Private key to use for SSL.
346
- - `passphrase` : A string of passphrase for the private key or pfx.
347
- - `cert` : Public x509 certificate to use.
348
- - `ca` : An authority certificate or array of authority certificates to check the remote host against.
349
- - `ciphers` : A string describing the ciphers to use or exclude.
350
- - `rejectUnauthorized` : If true, the server certificate is verified against the list of supplied CAs. An 'error' event is emitted if verification fails. Verification happens at the connection level, before the HTTP request is sent.
351
- - `secureProtocol` : The SSL method to use, e.g. SSLv3_method to force SSL version 3.
352
-
353
- Redirect options
354
- ----------------
355
-
356
- These options only apply if the `follow_max` (or `follow`) option is higher than 0.
357
-
358
- - `follow_set_cookies` : Sends the cookies received in the `set-cookie` header as part of the following request. `false` by default.
359
- - `follow_set_referer` : Sets the 'Referer' header to the requested URI when following a redirect. `false` by default.
360
- - `follow_keep_method` : If enabled, resends the request using the original verb instead of being rewritten to `get` with no data. `false` by default.
361
- - `follow_if_same_host` : When true, Needle will only follow redirects that point to the same host as the original request. `false` by default.
362
- - `follow_if_same_protocol` : When true, Needle will only follow redirects that point to the same protocol as the original request. `false` by default.
363
-
364
- Overriding Defaults
365
- -------------------
366
-
367
- Yes sir, we have it. Needle includes a `defaults()` method, that lets you override some of the defaults for all future requests. Like this:
368
-
369
- ```js
370
- needle.defaults({
371
- open_timeout: 60000,
372
- user_agent: 'MyApp/1.2.3',
373
- parse_response: false });
374
- ```
375
-
376
- This will override Needle's default user agent and 10-second timeout, and disable response parsing, so you don't need to pass those options in every other request.
377
-
378
- More advanced Proxy support
379
- ---------------------------
380
-
381
- Since you can pass a custom HTTPAgent to Needle you can do all sorts of neat stuff. For example, if you want to use the [`tunnel`](https://github.com/koichik/node-tunnel) module for HTTPS proxying, you can do this:
382
-
383
- ```js
384
- var tunnel = require('tunnel');
385
- var myAgent = tunnel.httpOverHttp({
386
- proxy: { host: 'localhost' }
387
- });
388
-
389
- needle.get('foobar.com', { agent: myAgent });
390
- ```
391
-
392
- Regarding the 'Connection' header
393
- ---------------------------------
394
-
395
- Unless you're running an old version of Node (< 0.11.4), by default Needle won't set the Connection header on requests, yielding Node's default behaviour of keeping the connection alive with the target server. This speeds up inmensely the process of sending several requests to the same host.
396
-
397
- On older versions, however, this has the unwanted behaviour of preventing the runtime from exiting, either because of a bug or 'feature' that was changed on 0.11.4. To overcome this Needle does set the 'Connection' header to 'close' on those versions, however this also means that making new requests to the same host doesn't benefit from Keep-Alive.
398
-
399
- So if you're stuck on 0.10 or even lower and want full speed, you can simply set the Connection header to 'Keep-Alive' by using `{ connection: 'Keep-Alive' }`. Please note, though, that an event loop handler will prevent the runtime from exiting so you'll need to manually call `process.exit()` or the universe will collapse.
400
-
401
- Examples Galore
402
- ---------------
403
-
404
- ### HTTPS GET with Basic Auth
405
-
406
- ```js
407
- needle.get('https://api.server.com', { username: 'you', password: 'secret' },
408
- function(err, resp) {
409
- // used HTTP auth
410
- });
411
- ```
412
-
413
- Or use [RFC-1738](http://tools.ietf.org/html/rfc1738#section-3.1) basic auth URL syntax:
414
-
415
- ```js
416
- needle.get('https://username:password@api.server.com', function(err, resp) {
417
- // used HTTP auth from URL
418
- });
419
- ```
420
-
421
- ### Digest Auth
422
-
423
- ```js
424
- needle.get('other.server.com', { username: 'you', password: 'secret', auth: 'digest' },
425
- function(err, resp, body) {
426
- // needle prepends 'http://' to your URL, if missing
427
- });
428
- ```
429
-
430
- ### Custom Accept header, deflate
431
-
432
- ```js
433
- var options = {
434
- compressed : true,
435
- follow : 10,
436
- accept : 'application/vnd.github.full+json'
437
- }
438
-
439
- needle.get('api.github.com/users/tomas', options, function(err, resp, body) {
440
- // body will contain a JSON.parse(d) object
441
- // if parsing fails, you'll simply get the original body
442
- });
443
- ```
444
-
445
- ### GET XML object
446
-
447
- ```js
448
- needle.get('https://news.ycombinator.com/rss', function(err, resp, body) {
449
- // you'll get a nice object containing the nodes in the RSS
450
- });
451
- ```
452
-
453
- ### GET binary, output to file
454
-
455
- ```js
456
- needle.get('http://upload.server.com/tux.png', { output: '/tmp/tux.png' }, function(err, resp, body) {
457
- // you can dump any response to a file, not only binaries.
458
- });
459
- ```
460
-
461
- ### GET through proxy
462
-
463
- ```js
464
- needle.get('http://search.npmjs.org', { proxy: 'http://localhost:1234' }, function(err, resp, body) {
465
- // request passed through proxy
466
- });
467
- ```
468
-
469
- ### GET a very large document in a stream (from 0.7+)
470
-
471
- ```js
472
- var stream = needle.get('http://www.as35662.net/100.log');
473
-
474
- stream.on('readable', function() {
475
- var chunk;
476
- while (chunk = this.read()) {
477
- console.log('got data: ', chunk);
478
- }
479
- });
480
- ```
481
-
482
- ### GET JSON object in a stream (from 0.7+)
483
-
484
- ```js
485
- var stream = needle.get('http://jsonplaceholder.typicode.com/db', { parse: true });
486
-
487
- stream.on('readable', function() {
488
- var node;
489
-
490
- // our stream will only emit a single JSON root node.
491
- while (node = this.read()) {
492
- console.log('got data: ', node);
493
- }
494
- });
495
- ```
496
-
497
- ### GET JSONStream flexible parser with search query (from 0.7+)
498
-
499
- ```js
500
-
501
- // The 'data' element of this stream will be the string representation
502
- // of the titles of all posts.
503
-
504
- needle.get('http://jsonplaceholder.typicode.com/db', { parse: true })
505
- .pipe(new JSONStream.parse('posts.*.title'));
506
- .on('data', function (obj) {
507
- console.log('got post title: %s', obj);
508
- });
509
- ```
510
-
511
- ### File upload using multipart, passing file path
512
-
513
- ```js
514
- var data = {
515
- foo: 'bar',
516
- image: { file: '/home/tomas/linux.png', content_type: 'image/png' }
517
- }
518
-
519
- needle.post('http://my.other.app.com', data, { multipart: true }, function(err, resp, body) {
520
- // needle will read the file and include it in the form-data as binary
521
- });
522
- ```
523
-
524
- ### Stream upload, PUT or POST
525
-
526
- ``` js
527
- needle.put('https://api.app.com/v2', fs.createReadStream('myfile.txt'), function(err, resp, body) {
528
- // stream content is uploaded verbatim
529
- });
530
- ```
531
-
532
- ### Multipart POST, passing data buffer
533
-
534
- ```js
535
- var buffer = fs.readFileSync('/path/to/package.zip');
536
-
537
- var data = {
538
- zip_file: {
539
- buffer : buffer,
540
- filename : 'mypackage.zip',
541
- content_type : 'application/octet-stream'
542
- }
543
- }
544
-
545
- needle.post('http://somewhere.com/over/the/rainbow', data, { multipart: true }, function(err, resp, body) {
546
- // if you see, when using buffers we need to pass the filename for the multipart body.
547
- // you can also pass a filename when using the file path method, in case you want to override
548
- // the default filename to be received on the other end.
549
- });
550
- ```
551
-
552
- ### Multipart with custom Content-Type
553
-
554
- ```js
555
- var data = {
556
- token: 'verysecret',
557
- payload: {
558
- value: JSON.stringify({ title: 'test', version: 1 }),
559
- content_type: 'application/json'
560
- }
561
- }
562
-
563
- needle.post('http://test.com/', data, { timeout: 5000, multipart: true }, function(err, resp, body) {
564
- // in this case, if the request takes more than 5 seconds
565
- // the callback will return a [Socket closed] error
566
- });
567
- ```
568
-
569
- For even more examples, check out the examples directory in the repo.
570
-
571
- ### Testing
572
-
573
- To run tests, you need to generate a self-signed SSL certificate in the `test` directory. After cloning the repository, run the following commands:
574
-
575
- $ mkdir -p test/keys
576
- $ openssl genrsa -out test/keys/ssl.key 2048
577
- $ openssl req -new -key test/keys/ssl.key -x509 -days 999 -out test/keys/ssl.cert
578
-
579
- Then you should be able to run `npm test` once you have the dependencies in place.
580
-
581
- > Note: Tests currently only work on linux-based environments that have `/proc/self/fd`. They *do not* work on MacOS environments.
582
- > You can use Docker to run tests by creating a container and mounting the needle project directory on `/app`
583
- > `docker create --name Needle -v /app -w /app -v /app/node_modules -i node:argon`
584
-
585
- Credits
586
- -------
587
-
588
- Written by Tomás Pollak, with the help of contributors.
589
-
590
- Copyright
591
- ---------
592
-
593
- (c) Fork Ltd. Licensed under the MIT license.
@@ -1,40 +0,0 @@
1
- #!/usr/bin/env node
2
- var needle = require('./../lib/needle');
3
-
4
- function exit(code, str) {
5
- console.log(str) || process.exit(code);
6
- }
7
-
8
- function usage() {
9
- var out = ['Usage: needle [get|head|post|put|delete] url [query]'];
10
- out.push('Examples: \n needle get google.com\n needle post server.com/api foo=bar');
11
- exit(1, out.join('\n'))
12
- }
13
-
14
- if (process.argv[2] == '-v' || process.argv[2] == '--version')
15
- exit(0, needle.version);
16
- else if (process.argv[2] == null)
17
- usage();
18
-
19
- var method = process.argv[2],
20
- url = process.argv[3],
21
- options = { compressed: true, parse_response: true, follow_max: 5, timeout: 10000 };
22
-
23
- if (!needle[method]) {
24
- url = method;
25
- method = 'get';
26
- }
27
-
28
- var callback = function(err, resp) {
29
- if (err) return exit(1, "Error: " + err.message);
30
-
31
- if (process.argv.indexOf('-i') != -1)
32
- console.log(resp.headers) || console.log('');
33
-
34
- console.log(resp.body.toString());
35
- };
36
-
37
- if (method == 'post' || method == 'put')
38
- needle[method](url, process.argv[4], options, callback);
39
- else
40
- needle[method](url, options, callback);
@@ -1,22 +0,0 @@
1
- var fs = require('fs'),
2
- stream = require('stream'),
3
- needle = require('./../');
4
-
5
- var url = 'http://ibl.gamechaser.net/f/tagqfxtteucbuldhezkz/bt_level1.gz';
6
-
7
- var resp = needle.get(url, { compressed: true, follow_max: 10 });
8
- console.log('Downloading...');
9
-
10
- resp.on('readable', function() {
11
-
12
- while (data = this.read()) {
13
- var lines = data.toString().split('\n');
14
- console.log('Got ' + lines.length + ' items.');
15
- // console.log(lines);
16
- }
17
-
18
- })
19
-
20
- resp.on('done', function(data) {
21
- console.log('Done');
22
- })
@@ -1,16 +0,0 @@
1
- var needle = require('./..');
2
-
3
- var opts = {
4
- username: 'user3',
5
- password: 'user3',
6
- auth: 'digest'
7
- }
8
-
9
- needle.get('http://test.webdav.org/auth-digest/', opts, function(err, resp, body) {
10
- console.log(resp.headers);
11
-
12
- if (resp.statusCode == 401)
13
- console.log('\nIt failed.')
14
- else
15
- console.log('\nIt worked!')
16
- });
@@ -1,18 +0,0 @@
1
- var fs = require('fs'),
2
- needle = require('./..'),
3
- path = require('path');
4
-
5
- var url = process.argv[2] || 'https://upload.wikimedia.org/wikipedia/commons/a/af/Tux.png';
6
- var file = path.basename(url);
7
-
8
- console.log('Downloading ' + file);
9
-
10
- needle.get(url, { output: file, follow: 3 }, function(err, resp, data){
11
- console.log('File saved: ' + process.cwd() + '/' + file);
12
-
13
- var size = fs.statSync(file).size;
14
- if (size == resp.bytes)
15
- console.log(resp.bytes + ' bytes written to file.');
16
- else
17
- throw new Error('File size mismatch: ' + size + ' != ' + resp.bytes);
18
- });