@cloudant/couchbackup 2.9.10-SNAPSHOT.113 → 2.9.11-SNAPSHOT.115

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 (433) hide show
  1. package/.scannerwork/report-task.txt +2 -2
  2. package/.scannerwork/scanner-report/analysis-warnings.pb +2 -2
  3. package/.scannerwork/scanner-report/analysis.log +1 -1
  4. package/.scannerwork/scanner-report/changesets-12.pb +1 -0
  5. package/.scannerwork/scanner-report/changesets-13.pb +1 -0
  6. package/.scannerwork/scanner-report/changesets-2.pb +1 -0
  7. package/.scannerwork/scanner-report/changesets-28.pb +1 -0
  8. package/.scannerwork/scanner-report/changesets-29.pb +1 -0
  9. package/.scannerwork/scanner-report/changesets-3.pb +1 -0
  10. package/.scannerwork/scanner-report/changesets-31.pb +1 -0
  11. package/.scannerwork/scanner-report/changesets-34.pb +1 -0
  12. package/.scannerwork/scanner-report/changesets-35.pb +1 -0
  13. package/.scannerwork/scanner-report/changesets-36.pb +1 -0
  14. package/.scannerwork/scanner-report/changesets-39.pb +1 -0
  15. package/.scannerwork/scanner-report/changesets-4.pb +1 -0
  16. package/.scannerwork/scanner-report/changesets-42.pb +1 -0
  17. package/.scannerwork/scanner-report/changesets-65.pb +1 -0
  18. package/.scannerwork/scanner-report/changesets-7.pb +1 -0
  19. package/.scannerwork/scanner-report/changesets-8.pb +1 -0
  20. package/.scannerwork/scanner-report/component-1.pb +2 -2
  21. package/.scannerwork/scanner-report/component-10.pb +1 -1
  22. package/.scannerwork/scanner-report/component-11.pb +1 -1
  23. package/.scannerwork/scanner-report/component-12.pb +1 -0
  24. package/.scannerwork/scanner-report/component-13.pb +1 -1
  25. package/.scannerwork/scanner-report/component-14.pb +1 -1
  26. package/.scannerwork/scanner-report/component-2.pb +1 -0
  27. package/.scannerwork/scanner-report/component-26.pb +1 -1
  28. package/.scannerwork/scanner-report/component-27.pb +1 -1
  29. package/.scannerwork/scanner-report/component-28.pb +1 -0
  30. package/.scannerwork/scanner-report/component-29.pb +1 -0
  31. package/.scannerwork/scanner-report/component-3.pb +1 -0
  32. package/.scannerwork/scanner-report/component-30.pb +1 -1
  33. package/.scannerwork/scanner-report/component-31.pb +1 -0
  34. package/.scannerwork/scanner-report/component-32.pb +1 -1
  35. package/.scannerwork/scanner-report/component-33.pb +1 -1
  36. package/.scannerwork/scanner-report/component-34.pb +1 -0
  37. package/.scannerwork/scanner-report/component-35.pb +1 -0
  38. package/.scannerwork/scanner-report/component-36.pb +1 -0
  39. package/.scannerwork/scanner-report/component-37.pb +1 -0
  40. package/.scannerwork/scanner-report/component-38.pb +1 -0
  41. package/.scannerwork/scanner-report/component-39.pb +1 -0
  42. package/.scannerwork/scanner-report/component-4.pb +1 -0
  43. package/.scannerwork/scanner-report/component-42.pb +1 -0
  44. package/.scannerwork/scanner-report/component-45.pb +1 -1
  45. package/.scannerwork/scanner-report/component-49.pb +1 -1
  46. package/.scannerwork/scanner-report/component-5.pb +1 -1
  47. package/.scannerwork/scanner-report/component-52.pb +1 -1
  48. package/.scannerwork/scanner-report/component-53.pb +1 -1
  49. package/.scannerwork/scanner-report/component-54.pb +1 -1
  50. package/.scannerwork/scanner-report/component-55.pb +1 -1
  51. package/.scannerwork/scanner-report/component-56.pb +1 -1
  52. package/.scannerwork/scanner-report/component-57.pb +1 -1
  53. package/.scannerwork/scanner-report/component-58.pb +1 -1
  54. package/.scannerwork/scanner-report/component-59.pb +1 -1
  55. package/.scannerwork/scanner-report/component-6.pb +1 -1
  56. package/.scannerwork/scanner-report/component-60.pb +1 -1
  57. package/.scannerwork/scanner-report/component-61.pb +1 -1
  58. package/.scannerwork/scanner-report/component-62.pb +1 -1
  59. package/.scannerwork/scanner-report/component-63.pb +1 -1
  60. package/.scannerwork/scanner-report/component-64.pb +1 -1
  61. package/.scannerwork/scanner-report/component-65.pb +1 -0
  62. package/.scannerwork/scanner-report/component-67.pb +1 -1
  63. package/.scannerwork/scanner-report/component-7.pb +1 -0
  64. package/.scannerwork/scanner-report/component-8.pb +1 -0
  65. package/.scannerwork/scanner-report/component-9.pb +1 -1
  66. package/.scannerwork/scanner-report/coverages-10.pb +0 -0
  67. package/.scannerwork/scanner-report/coverages-11.pb +0 -0
  68. package/.scannerwork/scanner-report/coverages-12.pb +0 -0
  69. package/.scannerwork/scanner-report/coverages-13.pb +0 -0
  70. package/.scannerwork/scanner-report/coverages-14.pb +0 -0
  71. package/.scannerwork/scanner-report/coverages-2.pb +0 -0
  72. package/.scannerwork/scanner-report/coverages-26.pb +0 -0
  73. package/.scannerwork/scanner-report/coverages-27.pb +0 -0
  74. package/.scannerwork/scanner-report/coverages-28.pb +0 -0
  75. package/.scannerwork/scanner-report/coverages-3.pb +0 -0
  76. package/.scannerwork/scanner-report/coverages-30.pb +0 -0
  77. package/.scannerwork/scanner-report/coverages-31.pb +0 -0
  78. package/.scannerwork/scanner-report/coverages-32.pb +0 -0
  79. package/.scannerwork/scanner-report/coverages-33.pb +0 -0
  80. package/.scannerwork/scanner-report/coverages-34.pb +0 -0
  81. package/.scannerwork/scanner-report/coverages-35.pb +0 -0
  82. package/.scannerwork/scanner-report/coverages-36.pb +0 -0
  83. package/.scannerwork/scanner-report/coverages-39.pb +0 -0
  84. package/.scannerwork/scanner-report/coverages-4.pb +0 -0
  85. package/.scannerwork/scanner-report/coverages-42.pb +0 -0
  86. package/.scannerwork/scanner-report/coverages-45.pb +0 -0
  87. package/.scannerwork/scanner-report/coverages-49.pb +0 -0
  88. package/.scannerwork/scanner-report/coverages-5.pb +0 -0
  89. package/.scannerwork/scanner-report/coverages-52.pb +0 -0
  90. package/.scannerwork/scanner-report/coverages-53.pb +0 -0
  91. package/.scannerwork/scanner-report/coverages-54.pb +0 -0
  92. package/.scannerwork/scanner-report/coverages-55.pb +0 -0
  93. package/.scannerwork/scanner-report/coverages-56.pb +0 -0
  94. package/.scannerwork/scanner-report/coverages-57.pb +0 -0
  95. package/.scannerwork/scanner-report/coverages-58.pb +0 -0
  96. package/.scannerwork/scanner-report/coverages-59.pb +0 -0
  97. package/.scannerwork/scanner-report/coverages-6.pb +0 -0
  98. package/.scannerwork/scanner-report/coverages-60.pb +0 -0
  99. package/.scannerwork/scanner-report/coverages-61.pb +0 -0
  100. package/.scannerwork/scanner-report/coverages-62.pb +0 -0
  101. package/.scannerwork/scanner-report/coverages-63.pb +0 -0
  102. package/.scannerwork/scanner-report/coverages-64.pb +0 -0
  103. package/.scannerwork/scanner-report/coverages-7.pb +0 -0
  104. package/.scannerwork/scanner-report/coverages-8.pb +0 -0
  105. package/.scannerwork/scanner-report/coverages-9.pb +0 -0
  106. package/.scannerwork/scanner-report/duplications-14.pb +3 -0
  107. package/.scannerwork/scanner-report/duplications-26.pb +2 -1
  108. package/.scannerwork/scanner-report/duplications-27.pb +2 -0
  109. package/.scannerwork/scanner-report/duplications-28.pb +2 -0
  110. package/.scannerwork/scanner-report/duplications-32.pb +0 -2
  111. package/.scannerwork/scanner-report/duplications-33.pb +0 -2
  112. package/.scannerwork/scanner-report/duplications-4.pb +3 -0
  113. package/.scannerwork/scanner-report/duplications-42.pb +2 -0
  114. package/.scannerwork/scanner-report/duplications-45.pb +2 -0
  115. package/.scannerwork/scanner-report/duplications-49.pb +0 -3
  116. package/.scannerwork/scanner-report/duplications-5.pb +0 -2
  117. package/.scannerwork/scanner-report/duplications-55.pb +2 -0
  118. package/.scannerwork/scanner-report/duplications-56.pb +0 -3
  119. package/.scannerwork/scanner-report/duplications-59.pb +0 -2
  120. package/.scannerwork/scanner-report/duplications-6.pb +0 -2
  121. package/.scannerwork/scanner-report/duplications-60.pb +2 -0
  122. package/.scannerwork/scanner-report/duplications-61.pb +0 -3
  123. package/.scannerwork/scanner-report/duplications-9.pb +2 -0
  124. package/.scannerwork/scanner-report/measures-10.pb +0 -0
  125. package/.scannerwork/scanner-report/measures-11.pb +0 -0
  126. package/.scannerwork/scanner-report/measures-12.pb +0 -0
  127. package/.scannerwork/scanner-report/measures-13.pb +0 -0
  128. package/.scannerwork/scanner-report/measures-14.pb +0 -0
  129. package/.scannerwork/scanner-report/measures-2.pb +0 -0
  130. package/.scannerwork/scanner-report/measures-26.pb +0 -0
  131. package/.scannerwork/scanner-report/measures-27.pb +0 -0
  132. package/.scannerwork/scanner-report/measures-28.pb +15 -0
  133. package/.scannerwork/scanner-report/measures-3.pb +0 -0
  134. package/.scannerwork/scanner-report/measures-30.pb +0 -0
  135. package/.scannerwork/scanner-report/measures-31.pb +0 -0
  136. package/.scannerwork/scanner-report/measures-32.pb +0 -0
  137. package/.scannerwork/scanner-report/measures-33.pb +0 -0
  138. package/.scannerwork/scanner-report/measures-34.pb +0 -0
  139. package/.scannerwork/scanner-report/measures-35.pb +0 -0
  140. package/.scannerwork/scanner-report/measures-36.pb +0 -0
  141. package/.scannerwork/scanner-report/measures-37.pb +0 -0
  142. package/.scannerwork/scanner-report/measures-38.pb +0 -0
  143. package/.scannerwork/scanner-report/measures-39.pb +0 -0
  144. package/.scannerwork/scanner-report/measures-4.pb +0 -0
  145. package/.scannerwork/scanner-report/measures-42.pb +0 -0
  146. package/.scannerwork/scanner-report/measures-45.pb +0 -0
  147. package/.scannerwork/scanner-report/measures-49.pb +0 -0
  148. package/.scannerwork/scanner-report/measures-5.pb +0 -0
  149. package/.scannerwork/scanner-report/measures-52.pb +0 -0
  150. package/.scannerwork/scanner-report/measures-53.pb +0 -0
  151. package/.scannerwork/scanner-report/measures-54.pb +0 -0
  152. package/.scannerwork/scanner-report/measures-55.pb +0 -0
  153. package/.scannerwork/scanner-report/measures-56.pb +0 -0
  154. package/.scannerwork/scanner-report/measures-57.pb +0 -0
  155. package/.scannerwork/scanner-report/measures-58.pb +0 -0
  156. package/.scannerwork/scanner-report/measures-59.pb +0 -0
  157. package/.scannerwork/scanner-report/measures-6.pb +0 -0
  158. package/.scannerwork/scanner-report/measures-60.pb +0 -0
  159. package/.scannerwork/scanner-report/measures-61.pb +0 -0
  160. package/.scannerwork/scanner-report/measures-62.pb +0 -0
  161. package/.scannerwork/scanner-report/measures-63.pb +0 -0
  162. package/.scannerwork/scanner-report/measures-64.pb +0 -0
  163. package/.scannerwork/scanner-report/measures-67.pb +0 -0
  164. package/.scannerwork/scanner-report/measures-7.pb +0 -0
  165. package/.scannerwork/scanner-report/measures-8.pb +0 -0
  166. package/.scannerwork/scanner-report/measures-9.pb +0 -0
  167. package/.scannerwork/scanner-report/metadata.pb +0 -0
  168. package/.scannerwork/scanner-report/source-10.txt +21 -62
  169. package/.scannerwork/scanner-report/source-11.txt +121 -93
  170. package/.scannerwork/scanner-report/source-12.txt +92 -0
  171. package/.scannerwork/scanner-report/source-13.txt +63 -509
  172. package/.scannerwork/scanner-report/source-14.txt +228 -64
  173. package/.scannerwork/scanner-report/source-2.txt +68 -0
  174. package/.scannerwork/scanner-report/source-26.txt +110 -71
  175. package/.scannerwork/scanner-report/source-27.txt +199 -78
  176. package/.scannerwork/scanner-report/source-28.txt +293 -0
  177. package/.scannerwork/scanner-report/source-3.txt +47 -0
  178. package/.scannerwork/scanner-report/source-30.txt +557 -350
  179. package/.scannerwork/scanner-report/source-31.txt +35 -0
  180. package/.scannerwork/scanner-report/source-32.txt +11 -268
  181. package/.scannerwork/scanner-report/source-33.txt +47 -124
  182. package/.scannerwork/scanner-report/source-34.txt +147 -0
  183. package/.scannerwork/scanner-report/source-35.txt +77 -0
  184. package/.scannerwork/scanner-report/source-36.txt +56 -0
  185. package/.scannerwork/scanner-report/source-37.txt +509 -0
  186. package/.scannerwork/scanner-report/source-38.txt +509 -0
  187. package/.scannerwork/scanner-report/source-39.txt +418 -0
  188. package/.scannerwork/scanner-report/source-4.txt +119 -0
  189. package/.scannerwork/scanner-report/source-42.txt +175 -0
  190. package/.scannerwork/scanner-report/source-45.txt +144 -579
  191. package/.scannerwork/scanner-report/source-49.txt +89 -219
  192. package/.scannerwork/scanner-report/source-5.txt +80 -170
  193. package/.scannerwork/scanner-report/source-52.txt +14 -51
  194. package/.scannerwork/scanner-report/source-53.txt +88 -69
  195. package/.scannerwork/scanner-report/source-54.txt +31 -32
  196. package/.scannerwork/scanner-report/source-55.txt +77 -132
  197. package/.scannerwork/scanner-report/source-56.txt +57 -96
  198. package/.scannerwork/scanner-report/source-57.txt +100 -50
  199. package/.scannerwork/scanner-report/source-58.txt +160 -45
  200. package/.scannerwork/scanner-report/source-59.txt +106 -202
  201. package/.scannerwork/scanner-report/source-6.txt +130 -149
  202. package/.scannerwork/scanner-report/source-60.txt +59 -19
  203. package/.scannerwork/scanner-report/source-61.txt +257 -107
  204. package/.scannerwork/scanner-report/source-62.txt +25 -13
  205. package/.scannerwork/scanner-report/source-63.txt +149 -19
  206. package/.scannerwork/scanner-report/source-64.txt +82 -78
  207. package/.scannerwork/scanner-report/source-67.txt +51 -393
  208. package/.scannerwork/scanner-report/source-7.txt +34 -0
  209. package/.scannerwork/scanner-report/{source-47.txt → source-8.txt} +7 -14
  210. package/.scannerwork/scanner-report/source-9.txt +130 -41
  211. package/.scannerwork/scanner-report/symbols-10.pb +11 -30
  212. package/.scannerwork/scanner-report/symbols-11.pb +116 -28
  213. package/.scannerwork/scanner-report/symbols-12.pb +60 -0
  214. package/.scannerwork/scanner-report/symbols-13.pb +43 -0
  215. package/.scannerwork/scanner-report/symbols-14.pb +393 -45
  216. package/.scannerwork/scanner-report/symbols-2.pb +36 -0
  217. package/.scannerwork/scanner-report/symbols-26.pb +97 -44
  218. package/.scannerwork/scanner-report/symbols-27.pb +417 -41
  219. package/.scannerwork/scanner-report/symbols-28.pb +486 -0
  220. package/.scannerwork/scanner-report/symbols-3.pb +27 -0
  221. package/.scannerwork/scanner-report/symbols-30.pb +1181 -537
  222. package/.scannerwork/scanner-report/symbols-31.pb +17 -0
  223. package/.scannerwork/scanner-report/symbols-32.pb +14 -486
  224. package/.scannerwork/scanner-report/symbols-33.pb +44 -101
  225. package/.scannerwork/scanner-report/symbols-34.pb +85 -0
  226. package/.scannerwork/scanner-report/symbols-35.pb +30 -0
  227. package/.scannerwork/scanner-report/symbols-36.pb +19 -0
  228. package/.scannerwork/scanner-report/symbols-39.pb +610 -0
  229. package/.scannerwork/scanner-report/symbols-4.pb +77 -0
  230. package/.scannerwork/scanner-report/symbols-42.pb +153 -0
  231. package/.scannerwork/scanner-report/symbols-45.pb +179 -1253
  232. package/.scannerwork/scanner-report/symbols-49.pb +27 -393
  233. package/.scannerwork/scanner-report/symbols-5.pb +69 -180
  234. package/.scannerwork/scanner-report/symbols-52.pb +13 -35
  235. package/.scannerwork/scanner-report/symbols-53.pb +59 -60
  236. package/.scannerwork/scanner-report/symbols-54.pb +19 -26
  237. package/.scannerwork/scanner-report/symbols-55.pb +43 -84
  238. package/.scannerwork/scanner-report/symbols-56.pb +41 -72
  239. package/.scannerwork/scanner-report/symbols-57.pb +30 -45
  240. package/.scannerwork/scanner-report/symbols-58.pb +143 -42
  241. package/.scannerwork/scanner-report/symbols-59.pb +32 -417
  242. package/.scannerwork/scanner-report/symbols-6.pb +107 -148
  243. package/.scannerwork/scanner-report/symbols-60.pb +41 -16
  244. package/.scannerwork/scanner-report/symbols-61.pb +353 -96
  245. package/.scannerwork/scanner-report/symbols-62.pb +18 -9
  246. package/.scannerwork/scanner-report/symbols-63.pb +126 -10
  247. package/.scannerwork/scanner-report/symbols-64.pb +41 -68
  248. package/.scannerwork/scanner-report/symbols-7.pb +10 -0
  249. package/.scannerwork/scanner-report/symbols-8.pb +9 -0
  250. package/.scannerwork/scanner-report/symbols-9.pb +102 -19
  251. package/.scannerwork/scanner-report/syntax-highlightings-10.pb +39 -83
  252. package/.scannerwork/scanner-report/syntax-highlightings-11.pb +99 -103
  253. package/.scannerwork/scanner-report/syntax-highlightings-12.pb +110 -0
  254. package/.scannerwork/scanner-report/syntax-highlightings-13.pb +71 -3736
  255. package/.scannerwork/scanner-report/syntax-highlightings-14.pb +296 -62
  256. package/.scannerwork/scanner-report/syntax-highlightings-2.pb +95 -0
  257. package/.scannerwork/scanner-report/syntax-highlightings-26.pb +149 -57
  258. package/.scannerwork/scanner-report/syntax-highlightings-27.pb +299 -84
  259. package/.scannerwork/scanner-report/syntax-highlightings-28.pb +659 -0
  260. package/.scannerwork/scanner-report/syntax-highlightings-3.pb +68 -0
  261. package/.scannerwork/scanner-report/syntax-highlightings-30.pb +637 -398
  262. package/.scannerwork/scanner-report/syntax-highlightings-31.pb +63 -0
  263. package/.scannerwork/scanner-report/syntax-highlightings-32.pb +21 -626
  264. package/.scannerwork/scanner-report/syntax-highlightings-33.pb +70 -187
  265. package/.scannerwork/scanner-report/syntax-highlightings-34.pb +191 -0
  266. package/.scannerwork/scanner-report/syntax-highlightings-35.pb +103 -0
  267. package/.scannerwork/scanner-report/syntax-highlightings-36.pb +82 -0
  268. package/.scannerwork/scanner-report/syntax-highlightings-37.pb +3748 -0
  269. package/.scannerwork/scanner-report/syntax-highlightings-38.pb +3746 -0
  270. package/.scannerwork/scanner-report/syntax-highlightings-39.pb +648 -0
  271. package/.scannerwork/scanner-report/syntax-highlightings-4.pb +158 -0
  272. package/.scannerwork/scanner-report/syntax-highlightings-42.pb +214 -0
  273. package/.scannerwork/scanner-report/syntax-highlightings-45.pb +152 -814
  274. package/.scannerwork/scanner-report/syntax-highlightings-49.pb +101 -292
  275. package/.scannerwork/scanner-report/syntax-highlightings-5.pb +67 -187
  276. package/.scannerwork/scanner-report/syntax-highlightings-52.pb +15 -65
  277. package/.scannerwork/scanner-report/syntax-highlightings-53.pb +92 -69
  278. package/.scannerwork/scanner-report/syntax-highlightings-54.pb +32 -36
  279. package/.scannerwork/scanner-report/syntax-highlightings-55.pb +56 -157
  280. package/.scannerwork/scanner-report/syntax-highlightings-56.pb +58 -121
  281. package/.scannerwork/scanner-report/syntax-highlightings-57.pb +83 -80
  282. package/.scannerwork/scanner-report/syntax-highlightings-58.pb +207 -46
  283. package/.scannerwork/scanner-report/syntax-highlightings-59.pb +92 -294
  284. package/.scannerwork/scanner-report/syntax-highlightings-6.pb +175 -166
  285. package/.scannerwork/scanner-report/syntax-highlightings-60.pb +45 -30
  286. package/.scannerwork/scanner-report/syntax-highlightings-61.pb +250 -147
  287. package/.scannerwork/scanner-report/syntax-highlightings-62.pb +20 -18
  288. package/.scannerwork/scanner-report/syntax-highlightings-63.pb +179 -16
  289. package/.scannerwork/scanner-report/syntax-highlightings-64.pb +84 -73
  290. package/.scannerwork/scanner-report/syntax-highlightings-67.pb +728 -3527
  291. package/.scannerwork/scanner-report/syntax-highlightings-7.pb +50 -0
  292. package/.scannerwork/scanner-report/syntax-highlightings-8.pb +48 -0
  293. package/.scannerwork/scanner-report/syntax-highlightings-9.pb +200 -55
  294. package/CHANGES.md +6 -2
  295. package/package.json +1 -1
  296. package/test-16-results.xml +146 -146
  297. package/test-18-results.xml +149 -149
  298. package/test-iam-18-results.xml +50 -50
  299. package/.scannerwork/scanner-report/changesets-15.pb +0 -1
  300. package/.scannerwork/scanner-report/changesets-16.pb +0 -1
  301. package/.scannerwork/scanner-report/changesets-17.pb +0 -1
  302. package/.scannerwork/scanner-report/changesets-18.pb +0 -1
  303. package/.scannerwork/scanner-report/changesets-19.pb +0 -1
  304. package/.scannerwork/scanner-report/changesets-20.pb +0 -1
  305. package/.scannerwork/scanner-report/changesets-21.pb +0 -1
  306. package/.scannerwork/scanner-report/changesets-22.pb +0 -1
  307. package/.scannerwork/scanner-report/changesets-23.pb +0 -1
  308. package/.scannerwork/scanner-report/changesets-24.pb +0 -1
  309. package/.scannerwork/scanner-report/changesets-25.pb +0 -1
  310. package/.scannerwork/scanner-report/changesets-46.pb +0 -1
  311. package/.scannerwork/scanner-report/changesets-47.pb +0 -1
  312. package/.scannerwork/scanner-report/changesets-48.pb +0 -1
  313. package/.scannerwork/scanner-report/changesets-50.pb +0 -1
  314. package/.scannerwork/scanner-report/changesets-51.pb +0 -1
  315. package/.scannerwork/scanner-report/component-15.pb +0 -1
  316. package/.scannerwork/scanner-report/component-16.pb +0 -1
  317. package/.scannerwork/scanner-report/component-17.pb +0 -1
  318. package/.scannerwork/scanner-report/component-18.pb +0 -1
  319. package/.scannerwork/scanner-report/component-19.pb +0 -1
  320. package/.scannerwork/scanner-report/component-20.pb +0 -1
  321. package/.scannerwork/scanner-report/component-21.pb +0 -1
  322. package/.scannerwork/scanner-report/component-22.pb +0 -1
  323. package/.scannerwork/scanner-report/component-23.pb +0 -1
  324. package/.scannerwork/scanner-report/component-24.pb +0 -1
  325. package/.scannerwork/scanner-report/component-25.pb +0 -1
  326. package/.scannerwork/scanner-report/component-46.pb +0 -1
  327. package/.scannerwork/scanner-report/component-47.pb +0 -1
  328. package/.scannerwork/scanner-report/component-48.pb +0 -1
  329. package/.scannerwork/scanner-report/component-50.pb +0 -1
  330. package/.scannerwork/scanner-report/component-51.pb +0 -1
  331. package/.scannerwork/scanner-report/component-68.pb +0 -1
  332. package/.scannerwork/scanner-report/coverages-15.pb +0 -0
  333. package/.scannerwork/scanner-report/coverages-16.pb +0 -0
  334. package/.scannerwork/scanner-report/coverages-17.pb +0 -0
  335. package/.scannerwork/scanner-report/coverages-18.pb +0 -0
  336. package/.scannerwork/scanner-report/coverages-19.pb +0 -0
  337. package/.scannerwork/scanner-report/coverages-20.pb +0 -0
  338. package/.scannerwork/scanner-report/coverages-21.pb +0 -0
  339. package/.scannerwork/scanner-report/coverages-22.pb +0 -0
  340. package/.scannerwork/scanner-report/coverages-23.pb +0 -0
  341. package/.scannerwork/scanner-report/coverages-24.pb +0 -0
  342. package/.scannerwork/scanner-report/coverages-46.pb +0 -0
  343. package/.scannerwork/scanner-report/coverages-47.pb +0 -0
  344. package/.scannerwork/scanner-report/coverages-48.pb +0 -0
  345. package/.scannerwork/scanner-report/coverages-51.pb +0 -0
  346. package/.scannerwork/scanner-report/duplications-24.pb +0 -2
  347. package/.scannerwork/scanner-report/duplications-50.pb +0 -0
  348. package/.scannerwork/scanner-report/duplications-51.pb +0 -0
  349. package/.scannerwork/scanner-report/measures-15.pb +0 -0
  350. package/.scannerwork/scanner-report/measures-16.pb +0 -0
  351. package/.scannerwork/scanner-report/measures-17.pb +0 -0
  352. package/.scannerwork/scanner-report/measures-18.pb +0 -0
  353. package/.scannerwork/scanner-report/measures-19.pb +0 -0
  354. package/.scannerwork/scanner-report/measures-20.pb +0 -0
  355. package/.scannerwork/scanner-report/measures-21.pb +0 -16
  356. package/.scannerwork/scanner-report/measures-22.pb +0 -0
  357. package/.scannerwork/scanner-report/measures-23.pb +0 -0
  358. package/.scannerwork/scanner-report/measures-24.pb +0 -0
  359. package/.scannerwork/scanner-report/measures-46.pb +0 -0
  360. package/.scannerwork/scanner-report/measures-47.pb +0 -0
  361. package/.scannerwork/scanner-report/measures-48.pb +0 -0
  362. package/.scannerwork/scanner-report/measures-51.pb +0 -0
  363. package/.scannerwork/scanner-report/measures-68.pb +0 -0
  364. package/.scannerwork/scanner-report/source-15.txt +0 -41
  365. package/.scannerwork/scanner-report/source-16.txt +0 -118
  366. package/.scannerwork/scanner-report/source-17.txt +0 -46
  367. package/.scannerwork/scanner-report/source-18.txt +0 -31
  368. package/.scannerwork/scanner-report/source-19.txt +0 -281
  369. package/.scannerwork/scanner-report/source-20.txt +0 -111
  370. package/.scannerwork/scanner-report/source-21.txt +0 -178
  371. package/.scannerwork/scanner-report/source-22.txt +0 -129
  372. package/.scannerwork/scanner-report/source-23.txt +0 -164
  373. package/.scannerwork/scanner-report/source-24.txt +0 -75
  374. package/.scannerwork/scanner-report/source-46.txt +0 -142
  375. package/.scannerwork/scanner-report/source-48.txt +0 -156
  376. package/.scannerwork/scanner-report/source-51.txt +0 -36
  377. package/.scannerwork/scanner-report/source-68.txt +0 -167
  378. package/.scannerwork/scanner-report/symbols-15.pb +0 -18
  379. package/.scannerwork/scanner-report/symbols-16.pb +0 -30
  380. package/.scannerwork/scanner-report/symbols-17.pb +0 -20
  381. package/.scannerwork/scanner-report/symbols-18.pb +0 -14
  382. package/.scannerwork/scanner-report/symbols-19.pb +0 -354
  383. package/.scannerwork/scanner-report/symbols-20.pb +0 -59
  384. package/.scannerwork/scanner-report/symbols-21.pb +0 -144
  385. package/.scannerwork/scanner-report/symbols-22.pb +0 -33
  386. package/.scannerwork/scanner-report/symbols-23.pb +0 -126
  387. package/.scannerwork/scanner-report/symbols-24.pb +0 -42
  388. package/.scannerwork/scanner-report/symbols-46.pb +0 -116
  389. package/.scannerwork/scanner-report/symbols-47.pb +0 -14
  390. package/.scannerwork/scanner-report/symbols-48.pb +0 -112
  391. package/.scannerwork/scanner-report/symbols-51.pb +0 -11
  392. package/.scannerwork/scanner-report/syntax-highlightings-15.pb +0 -50
  393. package/.scannerwork/scanner-report/syntax-highlightings-16.pb +0 -113
  394. package/.scannerwork/scanner-report/syntax-highlightings-17.pb +0 -64
  395. package/.scannerwork/scanner-report/syntax-highlightings-18.pb +0 -45
  396. package/.scannerwork/scanner-report/syntax-highlightings-19.pb +0 -285
  397. package/.scannerwork/scanner-report/syntax-highlightings-20.pb +0 -133
  398. package/.scannerwork/scanner-report/syntax-highlightings-21.pb +0 -243
  399. package/.scannerwork/scanner-report/syntax-highlightings-22.pb +0 -129
  400. package/.scannerwork/scanner-report/syntax-highlightings-23.pb +0 -213
  401. package/.scannerwork/scanner-report/syntax-highlightings-24.pb +0 -78
  402. package/.scannerwork/scanner-report/syntax-highlightings-46.pb +0 -134
  403. package/.scannerwork/scanner-report/syntax-highlightings-47.pb +0 -54
  404. package/.scannerwork/scanner-report/syntax-highlightings-48.pb +0 -223
  405. package/.scannerwork/scanner-report/syntax-highlightings-51.pb +0 -59
  406. package/.scannerwork/scanner-report/syntax-highlightings-68.pb +0 -949
  407. /package/.scannerwork/scanner-report/{coverages-50.pb → coverages-29.pb} +0 -0
  408. /package/.scannerwork/scanner-report/{coverages-25.pb → coverages-65.pb} +0 -0
  409. /package/.scannerwork/scanner-report/{duplications-15.pb → duplications-12.pb} +0 -0
  410. /package/.scannerwork/scanner-report/{duplications-16.pb → duplications-13.pb} +0 -0
  411. /package/.scannerwork/scanner-report/{duplications-17.pb → duplications-2.pb} +0 -0
  412. /package/.scannerwork/scanner-report/{duplications-18.pb → duplications-29.pb} +0 -0
  413. /package/.scannerwork/scanner-report/{duplications-19.pb → duplications-3.pb} +0 -0
  414. /package/.scannerwork/scanner-report/{duplications-20.pb → duplications-31.pb} +0 -0
  415. /package/.scannerwork/scanner-report/{duplications-21.pb → duplications-34.pb} +0 -0
  416. /package/.scannerwork/scanner-report/{duplications-22.pb → duplications-35.pb} +0 -0
  417. /package/.scannerwork/scanner-report/{duplications-23.pb → duplications-36.pb} +0 -0
  418. /package/.scannerwork/scanner-report/{duplications-25.pb → duplications-39.pb} +0 -0
  419. /package/.scannerwork/scanner-report/{duplications-46.pb → duplications-62.pb} +0 -0
  420. /package/.scannerwork/scanner-report/{duplications-47.pb → duplications-65.pb} +0 -0
  421. /package/.scannerwork/scanner-report/{duplications-48.pb → duplications-7.pb} +0 -0
  422. /package/.scannerwork/scanner-report/{issues-46.pb → issues-11.pb} +0 -0
  423. /package/.scannerwork/scanner-report/{issues-49.pb → issues-14.pb} +0 -0
  424. /package/.scannerwork/scanner-report/{issues-50.pb → issues-29.pb} +0 -0
  425. /package/.scannerwork/scanner-report/{issues-54.pb → issues-3.pb} +0 -0
  426. /package/.scannerwork/scanner-report/{measures-50.pb → measures-29.pb} +0 -0
  427. /package/.scannerwork/scanner-report/{measures-25.pb → measures-65.pb} +0 -0
  428. /package/.scannerwork/scanner-report/{source-50.txt → source-29.txt} +0 -0
  429. /package/.scannerwork/scanner-report/{source-25.txt → source-65.txt} +0 -0
  430. /package/.scannerwork/scanner-report/{symbols-50.pb → symbols-29.pb} +0 -0
  431. /package/.scannerwork/scanner-report/{symbols-25.pb → symbols-65.pb} +0 -0
  432. /package/.scannerwork/scanner-report/{syntax-highlightings-50.pb → syntax-highlightings-29.pb} +0 -0
  433. /package/.scannerwork/scanner-report/{syntax-highlightings-25.pb → syntax-highlightings-65.pb} +0 -0
@@ -1,4 +1,4 @@
1
- // Copyright © 2017, 2018 IBM Corp. All rights reserved.
1
+ // Copyright © 2017, 2021 IBM Corp. All rights reserved.
2
2
  //
3
3
  // Licensed under the Apache License, Version 2.0 (the "License");
4
4
  // you may not use this file except in compliance with the License.
@@ -11,215 +11,119 @@
11
11
  // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12
12
  // See the License for the specific language governing permissions and
13
13
  // limitations under the License.
14
-
15
- /* global describe it */
16
14
  'use strict';
17
15
 
18
- const assert = require('assert');
19
- const backup = require('../app.js').backup;
20
- const fs = require('fs');
21
- const nock = require('nock');
22
-
23
- const goodUrl = 'http://localhost:5984/db';
24
- // The real validateArgs function of app.js isn't
25
- // exported - so we call the exported backup method
26
- // instead. We don't get as far as a real backup when
27
- // testing error cases. For success cases we nock the
28
- // goodUrl and
29
- const validateArgs = function(url, opts, callback) {
30
- const nullStream = fs.createWriteStream('/dev/null');
31
- let cb = callback;
32
- if (url === goodUrl) {
33
- // Nock the goodUrl
34
- nock(goodUrl).head('').reply(404, { error: 'not_found', reason: 'missing' });
35
- // replace the callback to handle the nock response
36
- // to avoid attempting a real backup
37
- cb = function(err) {
38
- nullStream.end();
39
- if (err.name === 'DatabaseNotFound') {
40
- // This is what we expect if we reached the backup
41
- // This is success for valid args cases.
42
- err = null;
43
- }
44
- callback(err);
45
- };
16
+ const cliutils = require('./cliutils.js');
17
+ const config = require('./config.js');
18
+ const error = require('./error.js');
19
+ const path = require('path');
20
+ const pkg = require('../package.json');
21
+
22
+ function parseBackupArgs() {
23
+ const program = require('commander');
24
+
25
+ // Option CLI defaults
26
+ const defaults = config.cliDefaults();
27
+
28
+ // Options set by environment variables
29
+ const envVarOptions = {};
30
+ config.applyEnvironmentVariables(envVarOptions);
31
+
32
+ program
33
+ .version(pkg.version)
34
+ .description('Backup a CouchDB/Cloudant database to a backup text file.')
35
+ .usage('[options...]')
36
+ .option('-b, --buffer-size <n>',
37
+ cliutils.getUsage('number of documents fetched at once', defaults.bufferSize),
38
+ Number)
39
+ .option('-d, --db <db>',
40
+ cliutils.getUsage('name of the database to backup', defaults.db))
41
+ .option('-k, --iam-api-key <API key>',
42
+ cliutils.getUsage('IAM API key to access the Cloudant server'))
43
+ .option('-l, --log <file>',
44
+ cliutils.getUsage('file to store logging information during backup; invalid in "shallow" mode', 'a temporary file'),
45
+ path.normalize)
46
+ .option('-m, --mode <mode>',
47
+ cliutils.getUsage('"shallow" if only a superficial backup is done (ignoring conflicts and revision tokens), else "full" for complete backup', defaults.mode),
48
+ (mode) => { return mode.toLowerCase(); })
49
+ .option('-o, --output <file>',
50
+ cliutils.getUsage('file name to store the backup data', 'stdout'),
51
+ path.normalize)
52
+ .option('-p, --parallelism <n>',
53
+ cliutils.getUsage('number of HTTP requests to perform in parallel when performing a backup; ignored in "shallow" mode', defaults.parallelism),
54
+ Number)
55
+ .option('-q, --quiet',
56
+ cliutils.getUsage('suppress batch messages', defaults.quiet))
57
+ .option('-r, --resume',
58
+ cliutils.getUsage('continue a previous backup from its last known position; invalid in "shallow" mode', defaults.resume))
59
+ .option('-t, --request-timeout <n>',
60
+ cliutils.getUsage('milliseconds to wait for a response to a HTTP request before retrying the request', defaults.requestTimeout),
61
+ Number)
62
+ .option('-u, --url <url>',
63
+ cliutils.getUsage('URL of the CouchDB/Cloudant server', defaults.url))
64
+ .parse(process.argv);
65
+
66
+ // Remove defaults that don't apply when using shallow mode
67
+ if (program.opts().mode === 'shallow' || envVarOptions.mode === 'shallow') {
68
+ delete defaults.parallelism;
69
+ delete defaults.log;
70
+ delete defaults.resume;
46
71
  }
47
- backup(url, nullStream, opts, cb);
48
- return true;
49
- };
50
72
 
51
- const stderrWriteFun = process.stderr.write;
52
- let capturedStderr;
73
+ // Apply the options in order so that the CLI overrides env vars and env variables
74
+ // override defaults.
75
+ const opts = Object.assign({}, defaults, envVarOptions, program.opts());
53
76
 
54
- function captureStderr() {
55
- process.stderr.write = function(string, encoding, fd) {
56
- capturedStderr += string;
57
- };
58
- }
77
+ if (opts.resume && (opts.log === defaults.log)) {
78
+ // If resuming and the log file arg is the newly generated tmp name from defaults then we know that --log wasn't specified.
79
+ // We have to do this check here for the CLI case because of the default.
80
+ error.terminationCallback(new error.BackupError('NoLogFileName', 'To resume a backup, a log file must be specified'));
81
+ }
59
82
 
60
- function releaseStderr() {
61
- process.stderr.write = stderrWriteFun;
62
- capturedStderr = null;
83
+ return opts;
63
84
  }
64
85
 
65
- function assertErrorMessage(msg, done) {
66
- return function(err, data) {
67
- try {
68
- assert(err.message, 'There should be an error message');
69
- assert(err.message.indexOf(msg) >= 0);
70
- assert(data === null || data === undefined, 'There should only be an error.');
71
- done();
72
- } catch (e) {
73
- done(e);
74
- }
75
- };
76
- }
86
+ function parseRestoreArgs() {
87
+ const program = require('commander');
88
+
89
+ // Option CLI defaults
90
+ const defaults = config.cliDefaults();
91
+
92
+ // Options set by environment variables
93
+ const envVarOptions = {};
94
+ config.applyEnvironmentVariables(envVarOptions);
77
95
 
78
- function assertNoError(done) {
79
- return function(err, data) {
80
- try {
81
- assert(err === null, 'There should be no error message.');
82
- done();
83
- } catch (e) {
84
- done(e);
85
- }
86
- };
96
+ program
97
+ .version(pkg.version)
98
+ .description('Restore a CouchDB/Cloudant database from a backup text file.')
99
+ .usage('[options...]')
100
+ .option('-b, --buffer-size <n>',
101
+ cliutils.getUsage('number of documents restored at once', defaults.bufferSize),
102
+ Number)
103
+ .option('-d, --db <db>',
104
+ cliutils.getUsage('name of the new, existing database to restore to', defaults.db))
105
+ .option('-k, --iam-api-key <API key>',
106
+ cliutils.getUsage('IAM API key to access the Cloudant server'))
107
+ .option('-p, --parallelism <n>',
108
+ cliutils.getUsage('number of HTTP requests to perform in parallel when restoring a backup', defaults.parallelism),
109
+ Number)
110
+ .option('-q, --quiet',
111
+ cliutils.getUsage('suppress batch messages', defaults.quiet))
112
+ .option('-t, --request-timeout <n>',
113
+ cliutils.getUsage('milliseconds to wait for a response to a HTTP request before retrying the request', defaults.requestTimeout),
114
+ Number)
115
+ .option('-u, --url <url>',
116
+ cliutils.getUsage('URL of the CouchDB/Cloudant server', defaults.url))
117
+ .parse(process.argv);
118
+
119
+ // Apply the options in order so that the CLI overrides env vars and env variables
120
+ // override defaults.
121
+ const opts = Object.assign({}, defaults, envVarOptions, program.opts());
122
+
123
+ return opts;
87
124
  }
88
125
 
89
- describe('#unit Validate arguments', function() {
90
- it('returns error for invalid URL type', function(done) {
91
- validateArgs(true, {}, assertErrorMessage('Invalid URL, must be type string', done));
92
- });
93
- it('returns no error for valid URL type', function(done) {
94
- validateArgs(goodUrl, {}, assertNoError(done));
95
- });
96
- it('returns error for invalid (no host) URL', function(done) {
97
- validateArgs('http://', {}, assertErrorMessage('Invalid URL', done));
98
- });
99
- it('returns error for invalid (no protocol) URL', function(done) {
100
- validateArgs('invalid', {}, assertErrorMessage('Invalid URL', done));
101
- });
102
- it('returns error for invalid (wrong protocol) URL', function(done) {
103
- validateArgs('ftp://invalid.example.com', {}, assertErrorMessage('Invalid URL protocol.', done));
104
- });
105
- it('returns error for invalid (no path) URL', function(done) {
106
- validateArgs('https://invalid.example.com', {}, assertErrorMessage('Invalid URL, missing path element (no database).', done));
107
- });
108
- it('returns error for invalid (no protocol, no host) URL', function(done) {
109
- validateArgs('invalid', {}, assertErrorMessage('Invalid URL', done));
110
- });
111
- it('returns error for invalid buffer size type', function(done) {
112
- validateArgs(goodUrl, { bufferSize: '123' }, assertErrorMessage('Invalid buffer size option, must be a positive integer in the range (0, MAX_SAFE_INTEGER]', done));
113
- });
114
- it('returns error for zero buffer size', function(done) {
115
- validateArgs(goodUrl, { bufferSize: 0 }, assertErrorMessage('Invalid buffer size option, must be a positive integer in the range (0, MAX_SAFE_INTEGER]', done));
116
- });
117
- it('returns error for float buffer size', function(done) {
118
- validateArgs(goodUrl, { bufferSize: 1.23 }, assertErrorMessage('Invalid buffer size option, must be a positive integer in the range (0, MAX_SAFE_INTEGER]', done));
119
- });
120
- it('returns no error for valid buffer size type', function(done) {
121
- validateArgs(goodUrl, { bufferSize: 123 }, assertNoError(done));
122
- });
123
- it('returns error for invalid log type', function(done) {
124
- validateArgs(goodUrl, { log: true }, assertErrorMessage('Invalid log option, must be type string', done));
125
- });
126
- it('returns no error for valid log type', function(done) {
127
- validateArgs(goodUrl, { log: 'log.txt' }, assertNoError(done));
128
- });
129
- it('returns error for invalid mode type', function(done) {
130
- validateArgs(goodUrl, { mode: true }, assertErrorMessage('Invalid mode option, must be either "full" or "shallow"', done));
131
- });
132
- it('returns error for invalid mode string', function(done) {
133
- validateArgs(goodUrl, { mode: 'foobar' }, assertErrorMessage('Invalid mode option, must be either "full" or "shallow"', done));
134
- });
135
- it('returns no error for valid mode type', function(done) {
136
- validateArgs(goodUrl, { mode: 'full' }, assertNoError(done));
137
- });
138
- it('returns error for invalid output type', function(done) {
139
- validateArgs(goodUrl, { output: true }, assertErrorMessage('Invalid output option, must be type string', done));
140
- });
141
- it('returns no error for valid output type', function(done) {
142
- validateArgs(goodUrl, { output: 'output.txt' }, assertNoError(done));
143
- });
144
- it('returns error for invalid parallelism type', function(done) {
145
- validateArgs(goodUrl, { parallelism: '123' }, assertErrorMessage('Invalid parallelism option, must be a positive integer in the range (0, MAX_SAFE_INTEGER]', done));
146
- });
147
- it('returns error for zero parallelism', function(done) {
148
- validateArgs(goodUrl, { parallelism: 0 }, assertErrorMessage('Invalid parallelism option, must be a positive integer in the range (0, MAX_SAFE_INTEGER]', done));
149
- });
150
- it('returns error for float parallelism', function(done) {
151
- validateArgs(goodUrl, { parallelism: 1.23 }, assertErrorMessage('Invalid parallelism option, must be a positive integer in the range (0, MAX_SAFE_INTEGER]', done));
152
- });
153
- it('returns no error for valid parallelism type', function(done) {
154
- validateArgs(goodUrl, { parallelism: 123 }, assertNoError(done));
155
- });
156
- it('returns error for invalid request timeout type', function(done) {
157
- validateArgs(goodUrl, { requestTimeout: '123' }, assertErrorMessage('Invalid request timeout option, must be a positive integer in the range (0, MAX_SAFE_INTEGER]', done));
158
- });
159
- it('returns error for zero request timeout', function(done) {
160
- validateArgs(goodUrl, { requestTimeout: 0 }, assertErrorMessage('Invalid request timeout option, must be a positive integer in the range (0, MAX_SAFE_INTEGER]', done));
161
- });
162
- it('returns error for float request timout', function(done) {
163
- validateArgs(goodUrl, { requestTimeout: 1.23 }, assertErrorMessage('Invalid request timeout option, must be a positive integer in the range (0, MAX_SAFE_INTEGER]', done));
164
- });
165
- it('returns no error for valid request timeout type', function(done) {
166
- validateArgs(goodUrl, { requestTimeout: 123 }, assertNoError(done));
167
- });
168
- it('returns error for invalid resume type', function(done) {
169
- validateArgs(goodUrl, { resume: 'true' }, assertErrorMessage('Invalid resume option, must be type boolean', done));
170
- });
171
- it('returns no error for valid resume type', function(done) {
172
- validateArgs(goodUrl, { resume: false }, assertNoError(done));
173
- });
174
- it('returns error for invalid key type', function(done) {
175
- validateArgs(goodUrl, { iamApiKey: true }, assertErrorMessage('Invalid iamApiKey option, must be type string', done));
176
- });
177
- it('returns error for key and URL credentials supplied', function(done) {
178
- validateArgs('https://a:b@example.com/db', { iamApiKey: 'abc123' }, assertErrorMessage('URL user information must not be supplied when using IAM API key.', done));
179
- });
180
- it('warns for log arg in shallow mode', function(done) {
181
- captureStderr();
182
- try {
183
- validateArgs(goodUrl, { mode: 'shallow', log: 'test' }, function(err, data) {
184
- assert.ok(err);
185
- assert.ok(!data);
186
- assert(capturedStderr.indexOf('The options "log" and "resume" are invalid when using shallow mode.') > -1, 'Log warning message was not present');
187
- });
188
- done();
189
- } catch (e) {
190
- done(e);
191
- } finally {
192
- releaseStderr();
193
- }
194
- });
195
- it('warns for resume arg in shallow mode', function(done) {
196
- captureStderr();
197
- try {
198
- validateArgs(goodUrl, { mode: 'shallow', log: 'test', resume: true }, function(err, data) {
199
- assert.ok(err);
200
- assert.ok(!data);
201
- assert(capturedStderr.indexOf('The options "log" and "resume" are invalid when using shallow mode.') > -1, 'Log warning message was not present');
202
- });
203
- done();
204
- } catch (e) {
205
- done(e);
206
- } finally {
207
- releaseStderr();
208
- }
209
- });
210
- it('warns for parallism arg in shallow mode', function(done) {
211
- captureStderr();
212
- try {
213
- validateArgs(goodUrl, { mode: 'shallow', parallelsim: 10 }, function(err, data) {
214
- assert.ok(err);
215
- assert.ok(!data);
216
- assert(capturedStderr.indexOf('The option "parallelism" has no effect when using shallow mode.') > -1, 'Log warning message was not present');
217
- });
218
- done();
219
- } catch (e) {
220
- done(e);
221
- } finally {
222
- releaseStderr();
223
- }
224
- });
225
- });
126
+ module.exports = {
127
+ parseBackupArgs: parseBackupArgs,
128
+ parseRestoreArgs: parseRestoreArgs
129
+ };
@@ -1,4 +1,4 @@
1
- // Copyright © 2017, 2018 IBM Corp. All rights reserved.
1
+ // Copyright © 2017, 2021 IBM Corp. All rights reserved.
2
2
  //
3
3
  // Licensed under the Apache License, Version 2.0 (the "License");
4
4
  // you may not use this file except in compliance with the License.
@@ -12,164 +12,145 @@
12
12
  // See the License for the specific language governing permissions and
13
13
  // limitations under the License.
14
14
 
15
- // Small script which backs up a Cloudant or CouchDB database to an S3
16
- // bucket via a stream rather than on-disk file.
17
- //
18
- // The script generates the backup object name by combining together the path
19
- // part of the database URL and the current time.
20
-
15
+ /* global describe it */
21
16
  'use strict';
22
17
 
23
- const stream = require('stream');
24
- const url = require('url');
25
-
26
- const AWS = require('aws-sdk');
27
- const couchbackup = require('@cloudant/couchbackup');
28
- const debug = require('debug')('s3-backup');
29
- const VError = require('verror').VError;
30
-
31
- /*
32
- Main function, run from base of file.
33
- */
34
- function main() {
35
- const argv = require('yargs')
36
- .usage('Usage: $0 [options]')
37
- .example('$0 -s https://user:pass@host/db -b <bucket>', 'Backup db to bucket')
38
- .options({
39
- source: { alias: 's', nargs: 1, demandOption: true, describe: 'Source database URL' },
40
- bucket: { alias: 'b', nargs: 1, demandOption: true, describe: 'Destination bucket' },
41
- prefix: { alias: 'p', nargs: 1, describe: 'Prefix for backup object key', default: 'couchbackup' },
42
- s3url: { nargs: 1, describe: 'S3 endpoint URL' },
43
- awsprofile: { nargs: 1, describe: 'The profile section to use in the ~/.aws/credentials file', default: 'default' }
44
- })
45
- .help('h').alias('h', 'help')
46
- .epilog('Copyright (C) IBM 2017')
47
- .argv;
48
-
49
- const sourceUrl = argv.source;
50
- const backupName = new url.URL(sourceUrl).pathname.split('/').filter(function(x) { return x; }).join('-');
51
- const backupBucket = argv.bucket;
52
- const backupKeyPrefix = `${argv.prefix}-${backupName}`;
53
- const shallow = argv.shallow;
54
-
55
- const backupKey = `${backupKeyPrefix}-${new Date().toISOString()}`;
18
+ const assert = require('assert');
19
+ const nock = require('nock');
20
+ const request = require('../includes/request.js');
21
+ const changes = require('../includes/spoolchanges.js');
56
22
 
57
- const s3Endpoint = argv.s3url;
58
- const awsProfile = argv.awsprofile;
23
+ const url = 'http://localhost:7777';
24
+ const dbName = 'fakenockdb';
25
+ const longTestTimeout = 3000;
59
26
 
60
- // Creds are from ~/.aws/credentials, environment etc. (see S3 docs).
61
- const awsOpts = {
62
- signatureVersion: 'v4',
63
- credentials: new AWS.SharedIniFileCredentials({ profile: awsProfile })
64
- };
65
- if (typeof s3Endpoint !== 'undefined') {
66
- awsOpts.endpoint = new AWS.Endpoint(s3Endpoint);
67
- }
68
- const s3 = new AWS.S3(awsOpts);
27
+ const db = request.client(`${url}/${dbName}`, { parallelism: 1 });
69
28
 
70
- debug(`Creating a new backup of ${s(sourceUrl)} at ${backupBucket}/${backupKey}...`);
71
- bucketAccessible(s3, backupBucket)
72
- .then(() => {
73
- return backupToS3(sourceUrl, s3, backupBucket, backupKey, shallow);
74
- })
75
- .then(() => {
76
- debug('done.');
77
- })
78
- .catch((reason) => {
79
- debug(`Error: ${reason}`);
80
- process.exit(1);
29
+ const seqSuffix = Buffer.alloc(124, 'abc123').toString('base64');
30
+ function provideChanges(batchSize, totalChanges, fullResponse = false) {
31
+ let pending = totalChanges;
32
+ const sparseResultsArray = Array(batchSize).fill({
33
+ seq: null,
34
+ id: 'doc',
35
+ changes: [{ rev: '1-abcdef0123456789abcdef0123456789' }]
36
+ });
37
+ nock(url)
38
+ .post(`/${dbName}/_changes`)
39
+ .query(true)
40
+ .times(totalChanges / batchSize + (totalChanges % batchSize > 0 ? 1 : 0))
41
+ .reply(200, (uri, requestBody) => {
42
+ pending -= batchSize;
43
+ const lastSeq = (totalChanges - pending);
44
+ const seq = lastSeq - batchSize;
45
+ return {
46
+ results: fullResponse
47
+ ? Array.from(Array(batchSize), (_, i) => {
48
+ return {
49
+ seq: `${seq + i}-${seqSuffix}`,
50
+ id: `doc${seq + i}`,
51
+ changes: [{ rev: '1-abcdef0123456789abcdef0123456789' }]
52
+ };
53
+ })
54
+ : sparseResultsArray,
55
+ pending: pending,
56
+ last_seq: `${lastSeq}-abc`
57
+ };
81
58
  });
82
59
  }
83
60
 
84
- /**
85
- * Return a promise that resolves if the bucket is available and
86
- * rejects if not.
87
- *
88
- * @param {any} s3 S3 client object
89
- * @param {any} bucketName Bucket name
90
- * @returns Promise
91
- */
92
- function bucketAccessible(s3, bucketName) {
93
- return new Promise(function(resolve, reject) {
94
- const params = {
95
- Bucket: bucketName
96
- };
97
- s3.headBucket(params, function(err, data) {
98
- if (err) {
99
- reject(new VError(err, 'S3 bucket not accessible'));
100
- } else {
101
- resolve();
102
- }
61
+ describe('#unit Check spool changes', function() {
62
+ it('should terminate on request error', function(done) {
63
+ nock(url)
64
+ .post(`/${dbName}/_changes`)
65
+ .query(true)
66
+ .times(3)
67
+ .replyWithError({ code: 'ECONNRESET', message: 'socket hang up' });
68
+
69
+ changes(db, '/dev/null', 500, null, function(err) {
70
+ assert.strictEqual(err.name, 'SpoolChangesError');
71
+ assert.strictEqual(err.message, `Failed changes request - socket hang up: post ${url}/${dbName}/_changes`);
72
+ assert.ok(nock.isDone());
73
+ done();
74
+ });
75
+ }).timeout(longTestTimeout);
76
+
77
+ it('should terminate on bad HTTP status code response', function(done) {
78
+ nock(url)
79
+ .post(`/${dbName}/_changes`)
80
+ .query(true)
81
+ .times(3)
82
+ .reply(500, function(uri, requestBody) {
83
+ this.req.response.statusMessage = 'Internal Server Error';
84
+ return { error: 'foo', reason: 'bar' };
85
+ });
86
+
87
+ changes(db, '/dev/null', 500, null, function(err) {
88
+ assert.strictEqual(err.name, 'HTTPFatalError');
89
+ assert.strictEqual(err.message, `500 Internal Server Error: post ${url}/${dbName}/_changes - Error: foo, Reason: bar`);
90
+ assert.ok(nock.isDone());
91
+ done();
92
+ });
93
+ }).timeout(longTestTimeout);
94
+
95
+ it('should keep collecting changes', function(done) {
96
+ // This test validates that spooling will correctly
97
+ // continue across multiple requests
98
+ // (4 batches of 100000 to be precise).
99
+ // This test might take up to 10 seconds
100
+ this.timeout(10 * 1000);
101
+
102
+ // Use full changes for this test
103
+ provideChanges(100000, 400000, true);
104
+ changes(db, '/dev/null', 500, null, function(err) {
105
+ assert.ok(!err);
106
+ assert.ok(nock.isDone());
107
+ done();
103
108
  });
104
109
  });
105
- }
106
-
107
- /**
108
- * Backup directly from Cloudant to an object store object via a stream.
109
- *
110
- * @param {any} sourceUrl URL of database
111
- * @param {any} s3Client Object store client
112
- * @param {any} s3Bucket Backup destination bucket
113
- * @param {any} s3Key Backup destination key name (shouldn't exist)
114
- * @param {any} shallow Whether to use the couchbackup `shallow` mode
115
- * @returns Promise
116
- */
117
- function backupToS3(sourceUrl, s3Client, s3Bucket, s3Key, shallow) {
118
- return new Promise((resolve, reject) => {
119
- debug(`Setting up S3 upload to ${s3Bucket}/${s3Key}`);
120
110
 
121
- // A pass through stream that has couchbackup's output
122
- // written to it and it then read by the S3 upload client.
123
- // It has a 64MB highwater mark to allow for fairly
124
- // uneven network connectivity.
125
- const streamToUpload = new stream.PassThrough({ highWaterMark: 67108864 });
126
-
127
- // Set up S3 upload.
128
- const params = {
129
- Bucket: s3Bucket,
130
- Key: s3Key,
131
- Body: streamToUpload
132
- };
133
- s3Client.upload(params, function(err, data) {
134
- debug('Object store upload done');
135
- if (err) {
136
- debug(err);
137
- reject(new VError(err, 'Object store upload failed'));
138
- return;
139
- }
140
- debug('Object store upload succeeded');
141
- debug(data);
142
- resolve();
143
- }).httpUploadProgress = (progress) => {
144
- debug(`Object store upload progress: ${progress}`);
145
- };
146
-
147
- debug(`Starting streaming data from ${s(sourceUrl)}`);
148
- couchbackup.backup(
149
- sourceUrl,
150
- streamToUpload,
151
- (err, obj) => {
152
- if (err) {
153
- debug(err);
154
- reject(new VError(err, 'CouchBackup failed with an error'));
155
- return;
156
- }
157
- debug(`Download from ${s(sourceUrl)} complete.`);
158
- streamToUpload.end(); // must call end() to complete upload.
159
- // resolve() is called by the upload
160
- }
161
- );
111
+ it('should keep collecting sparse changes', function(done) {
112
+ // This test checks that making thousands of requests doesn't
113
+ // make anything bad happen.
114
+ // This test might take up to 25 seconds
115
+ this.timeout(25 * 1000);
116
+ // Use sparse changes for this test and a batch size of 1
117
+ provideChanges(1, 2500);
118
+ changes(db, '/dev/null', 500, null, function(err) {
119
+ assert.ok(!err);
120
+ assert.ok(nock.isDone());
121
+ done();
122
+ });
123
+ });
124
+ });
125
+
126
+ describe('Longer spool changes checks', function() {
127
+ it('#slow should keep collecting changes (25M)', function(done) {
128
+ // This test might take up to 5 minutes
129
+ this.timeout(5 * 60 * 1000);
130
+ // Note changes spooling uses a constant batch size, we are setting
131
+ // a test value here and setting the buffer to match
132
+ const batch = 100000;
133
+ // Use sparse changes for this test
134
+ provideChanges(batch, 25000000);
135
+ changes(db, '/dev/null', batch, null, function(err) {
136
+ assert.ok(!err);
137
+ assert.ok(nock.isDone());
138
+ done();
139
+ });
162
140
  });
163
- }
164
-
165
- /**
166
- * Remove creds from a URL, e.g., before logging
167
- *
168
- * @param {string} url URL to safen
169
- */
170
- function s(originalUrl) {
171
- const parts = new url.URL(originalUrl);
172
- return url.format(parts, { auth: false });
173
- }
174
141
 
175
- main();
142
+ it('#slower should keep collecting changes (500M)', function(done) {
143
+ // This test might take up to 90 minutes
144
+ this.timeout(90 * 60 * 1000);
145
+ // Note changes spooling uses a constant batch size, we are setting
146
+ // a test value here and setting the buffer to match
147
+ const batch = 1000000;
148
+ // Use full changes for this test to exercise load
149
+ provideChanges(batch, 500000000, true);
150
+ changes(db, '/dev/null', batch, null, function(err) {
151
+ assert.ok(!err);
152
+ assert.ok(nock.isDone());
153
+ done();
154
+ });
155
+ });
156
+ });