@fredlackey/devutils 0.0.18 → 0.1.0

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 (447) hide show
  1. package/README.md +214 -141
  2. package/package.json +8 -83
  3. package/src/api/loader.js +229 -0
  4. package/src/api/registry.json +62 -0
  5. package/src/cli.js +293 -60
  6. package/src/commands/ai/index.js +16 -0
  7. package/src/commands/ai/launch.js +112 -0
  8. package/src/commands/ai/list.js +54 -0
  9. package/src/commands/ai/resume.js +70 -0
  10. package/src/commands/ai/sessions.js +121 -0
  11. package/src/commands/ai/set.js +131 -0
  12. package/src/commands/ai/show.js +74 -0
  13. package/src/commands/ai/tools.js +46 -0
  14. package/src/commands/alias/add.js +93 -0
  15. package/src/commands/alias/helpers.js +107 -0
  16. package/src/commands/alias/index.js +14 -0
  17. package/src/commands/alias/list.js +55 -0
  18. package/src/commands/alias/remove.js +62 -0
  19. package/src/commands/alias/sync.js +109 -0
  20. package/src/commands/api/disable.js +73 -0
  21. package/src/commands/api/enable.js +148 -0
  22. package/src/commands/api/index.js +15 -0
  23. package/src/commands/api/list.js +66 -0
  24. package/src/commands/api/update.js +87 -0
  25. package/src/commands/auth/index.js +15 -0
  26. package/src/commands/auth/list.js +49 -0
  27. package/src/commands/auth/login.js +384 -0
  28. package/src/commands/auth/logout.js +111 -0
  29. package/src/commands/auth/refresh.js +184 -0
  30. package/src/commands/auth/services.js +169 -0
  31. package/src/commands/auth/status.js +104 -0
  32. package/src/commands/config/export.js +224 -0
  33. package/src/commands/config/get.js +52 -0
  34. package/src/commands/config/import.js +308 -0
  35. package/src/commands/config/index.js +17 -0
  36. package/src/commands/config/init.js +143 -0
  37. package/src/commands/config/reset.js +57 -0
  38. package/src/commands/config/set.js +93 -0
  39. package/src/commands/config/show.js +35 -0
  40. package/src/commands/help.js +338 -0
  41. package/src/commands/identity/add.js +133 -0
  42. package/src/commands/identity/index.js +17 -0
  43. package/src/commands/identity/link.js +76 -0
  44. package/src/commands/identity/list.js +48 -0
  45. package/src/commands/identity/remove.js +72 -0
  46. package/src/commands/identity/show.js +65 -0
  47. package/src/commands/identity/sync.js +172 -0
  48. package/src/commands/identity/unlink.js +57 -0
  49. package/src/commands/ignore/add.js +165 -0
  50. package/src/commands/ignore/index.js +14 -0
  51. package/src/commands/ignore/list.js +89 -0
  52. package/src/commands/ignore/markers.js +43 -0
  53. package/src/commands/ignore/remove.js +164 -0
  54. package/src/commands/ignore/show.js +169 -0
  55. package/src/commands/machine/detect.js +122 -0
  56. package/src/commands/machine/index.js +14 -0
  57. package/src/commands/machine/list.js +74 -0
  58. package/src/commands/machine/set.js +106 -0
  59. package/src/commands/machine/show.js +35 -0
  60. package/src/commands/schema.js +152 -0
  61. package/src/commands/search/collections.js +134 -0
  62. package/src/commands/search/get.js +71 -0
  63. package/src/commands/search/index-cmd.js +54 -0
  64. package/src/commands/search/index.js +21 -0
  65. package/src/commands/search/keyword.js +60 -0
  66. package/src/commands/search/qmd.js +70 -0
  67. package/src/commands/search/query.js +64 -0
  68. package/src/commands/search/semantic.js +62 -0
  69. package/src/commands/search/status.js +46 -0
  70. package/src/commands/status.js +224 -171
  71. package/src/commands/tools/check.js +79 -0
  72. package/src/commands/tools/index.js +14 -0
  73. package/src/commands/tools/install.js +110 -0
  74. package/src/commands/tools/list.js +91 -0
  75. package/src/commands/tools/search.js +60 -0
  76. package/src/commands/update.js +83 -112
  77. package/src/commands/util/add.js +151 -0
  78. package/src/commands/util/index.js +15 -0
  79. package/src/commands/util/list.js +97 -0
  80. package/src/commands/util/remove.js +76 -0
  81. package/src/commands/util/run.js +79 -0
  82. package/src/commands/util/show.js +67 -0
  83. package/src/commands/version.js +21 -88
  84. package/src/installers/_template.js +104 -0
  85. package/src/installers/git.js +150 -0
  86. package/src/installers/homebrew.js +190 -0
  87. package/src/installers/node.js +223 -0
  88. package/src/installers/registry.json +29 -0
  89. package/src/lib/config.js +125 -0
  90. package/src/lib/detect.js +74 -0
  91. package/src/lib/errors.js +114 -0
  92. package/src/lib/github.js +315 -0
  93. package/src/lib/installer.js +225 -0
  94. package/src/lib/output.js +239 -0
  95. package/src/lib/platform.js +112 -0
  96. package/src/lib/platforms/amazon-linux.js +41 -0
  97. package/src/lib/platforms/gitbash.js +46 -0
  98. package/src/lib/platforms/macos.js +45 -0
  99. package/src/lib/platforms/raspbian.js +41 -0
  100. package/src/lib/platforms/ubuntu.js +39 -0
  101. package/src/lib/platforms/windows.js +45 -0
  102. package/src/lib/prompt.js +161 -0
  103. package/src/lib/schema.js +211 -0
  104. package/src/lib/shell.js +75 -0
  105. package/src/patterns/gitignore/claude-code.txt +25 -0
  106. package/src/patterns/gitignore/docker.txt +15 -0
  107. package/src/patterns/gitignore/go.txt +24 -0
  108. package/src/patterns/gitignore/java.txt +38 -0
  109. package/src/patterns/gitignore/jetbrains.txt +26 -0
  110. package/src/patterns/gitignore/linux.txt +18 -0
  111. package/src/patterns/gitignore/macos.txt +27 -0
  112. package/src/patterns/gitignore/node.txt +51 -0
  113. package/src/patterns/gitignore/python.txt +55 -0
  114. package/src/patterns/gitignore/rust.txt +14 -0
  115. package/src/patterns/gitignore/terraform.txt +30 -0
  116. package/src/patterns/gitignore/vscode.txt +15 -0
  117. package/src/patterns/gitignore/windows.txt +25 -0
  118. package/src/utils/clone/index.js +165 -0
  119. package/src/utils/git-push/index.js +230 -0
  120. package/src/utils/git-status/index.js +116 -0
  121. package/src/utils/git-status/unix.sh +75 -0
  122. package/src/utils/registry.json +41 -0
  123. package/bin/dev.js +0 -16
  124. package/files/README.md +0 -0
  125. package/files/claude/.claude/commands/setup-context.md +0 -3
  126. package/files/monorepos/_archive/README.md +0 -36
  127. package/files/monorepos/_legacy/README.md +0 -36
  128. package/files/monorepos/ai-docs/README.md +0 -33
  129. package/files/monorepos/apps/README.md +0 -24
  130. package/files/monorepos/docs/README.md +0 -40
  131. package/files/monorepos/packages/README.md +0 -25
  132. package/files/monorepos/research/README.md +0 -29
  133. package/files/monorepos/scripts/README.md +0 -24
  134. package/src/commands/README.md +0 -41
  135. package/src/commands/configure.js +0 -199
  136. package/src/commands/identity.js +0 -1630
  137. package/src/commands/ignore.js +0 -247
  138. package/src/commands/install.js +0 -526
  139. package/src/commands/setup.js +0 -246
  140. package/src/completion.js +0 -284
  141. package/src/constants.js +0 -45
  142. package/src/ignore/claude-code.txt +0 -10
  143. package/src/ignore/docker.txt +0 -18
  144. package/src/ignore/linux.txt +0 -23
  145. package/src/ignore/macos.txt +0 -36
  146. package/src/ignore/node.txt +0 -55
  147. package/src/ignore/terraform.txt +0 -37
  148. package/src/ignore/vscode.txt +0 -18
  149. package/src/ignore/windows.txt +0 -35
  150. package/src/index.js +0 -0
  151. package/src/installs/README.md +0 -399
  152. package/src/installs/adobe-creative-cloud.js +0 -546
  153. package/src/installs/adobe-creative-cloud.md +0 -605
  154. package/src/installs/appcleaner.js +0 -321
  155. package/src/installs/appcleaner.md +0 -699
  156. package/src/installs/apt-transport-https.js +0 -390
  157. package/src/installs/apt-transport-https.md +0 -678
  158. package/src/installs/atomicparsley.js +0 -642
  159. package/src/installs/atomicparsley.md +0 -795
  160. package/src/installs/aws-cli.js +0 -797
  161. package/src/installs/aws-cli.md +0 -727
  162. package/src/installs/balena-etcher.js +0 -710
  163. package/src/installs/balena-etcher.md +0 -761
  164. package/src/installs/bambu-studio.js +0 -1143
  165. package/src/installs/bambu-studio.md +0 -780
  166. package/src/installs/bash-completion.js +0 -575
  167. package/src/installs/bash-completion.md +0 -833
  168. package/src/installs/bash.js +0 -417
  169. package/src/installs/bash.md +0 -993
  170. package/src/installs/beyond-compare.js +0 -603
  171. package/src/installs/beyond-compare.md +0 -813
  172. package/src/installs/brave-browser.js +0 -968
  173. package/src/installs/brave-browser.md +0 -650
  174. package/src/installs/build-essential.js +0 -529
  175. package/src/installs/build-essential.md +0 -977
  176. package/src/installs/ca-certificates.js +0 -618
  177. package/src/installs/ca-certificates.md +0 -937
  178. package/src/installs/caffeine.js +0 -508
  179. package/src/installs/caffeine.md +0 -839
  180. package/src/installs/camtasia.js +0 -596
  181. package/src/installs/camtasia.md +0 -762
  182. package/src/installs/chatgpt.js +0 -476
  183. package/src/installs/chatgpt.md +0 -814
  184. package/src/installs/chocolatey.js +0 -456
  185. package/src/installs/chocolatey.md +0 -661
  186. package/src/installs/chrome-canary.js +0 -419
  187. package/src/installs/chrome-canary.md +0 -641
  188. package/src/installs/chromium.js +0 -667
  189. package/src/installs/chromium.md +0 -838
  190. package/src/installs/claude-code.js +0 -576
  191. package/src/installs/claude-code.md +0 -1173
  192. package/src/installs/cloudflare-warp.js +0 -900
  193. package/src/installs/cloudflare-warp.md +0 -1047
  194. package/src/installs/comet-browser.js +0 -588
  195. package/src/installs/comet-browser.md +0 -731
  196. package/src/installs/curl.js +0 -379
  197. package/src/installs/curl.md +0 -714
  198. package/src/installs/cursor.js +0 -579
  199. package/src/installs/cursor.md +0 -970
  200. package/src/installs/dbeaver.js +0 -924
  201. package/src/installs/dbeaver.md +0 -939
  202. package/src/installs/dbschema.js +0 -692
  203. package/src/installs/dbschema.md +0 -925
  204. package/src/installs/dependencies.md +0 -453
  205. package/src/installs/development-tools.js +0 -600
  206. package/src/installs/development-tools.md +0 -977
  207. package/src/installs/docker.js +0 -1029
  208. package/src/installs/docker.md +0 -1109
  209. package/src/installs/drawio.js +0 -1019
  210. package/src/installs/drawio.md +0 -795
  211. package/src/installs/elmedia-player.js +0 -347
  212. package/src/installs/elmedia-player.md +0 -556
  213. package/src/installs/ffmpeg.js +0 -889
  214. package/src/installs/ffmpeg.md +0 -852
  215. package/src/installs/file.js +0 -464
  216. package/src/installs/file.md +0 -987
  217. package/src/installs/gemini-cli.js +0 -811
  218. package/src/installs/gemini-cli.md +0 -1153
  219. package/src/installs/git.js +0 -400
  220. package/src/installs/git.md +0 -907
  221. package/src/installs/gitego.js +0 -949
  222. package/src/installs/gitego.md +0 -1172
  223. package/src/installs/go.js +0 -931
  224. package/src/installs/go.md +0 -958
  225. package/src/installs/google-antigravity.js +0 -913
  226. package/src/installs/google-antigravity.md +0 -1075
  227. package/src/installs/google-chrome.js +0 -833
  228. package/src/installs/google-chrome.md +0 -862
  229. package/src/installs/gpg.js +0 -480
  230. package/src/installs/gpg.md +0 -1056
  231. package/src/installs/homebrew.js +0 -1028
  232. package/src/installs/homebrew.md +0 -988
  233. package/src/installs/imageoptim.js +0 -968
  234. package/src/installs/imageoptim.md +0 -1119
  235. package/src/installs/installers.json +0 -4032
  236. package/src/installs/installers.json.tmp +0 -3953
  237. package/src/installs/jq.js +0 -400
  238. package/src/installs/jq.md +0 -809
  239. package/src/installs/keyboard-maestro.js +0 -719
  240. package/src/installs/keyboard-maestro.md +0 -825
  241. package/src/installs/kiro.js +0 -864
  242. package/src/installs/kiro.md +0 -1015
  243. package/src/installs/latex.js +0 -789
  244. package/src/installs/latex.md +0 -1095
  245. package/src/installs/lftp.js +0 -356
  246. package/src/installs/lftp.md +0 -907
  247. package/src/installs/lsb-release.js +0 -346
  248. package/src/installs/lsb-release.md +0 -814
  249. package/src/installs/messenger.js +0 -847
  250. package/src/installs/messenger.md +0 -900
  251. package/src/installs/microsoft-office.js +0 -568
  252. package/src/installs/microsoft-office.md +0 -760
  253. package/src/installs/microsoft-teams.js +0 -801
  254. package/src/installs/microsoft-teams.md +0 -886
  255. package/src/installs/moom.js +0 -326
  256. package/src/installs/moom.md +0 -570
  257. package/src/installs/node.js +0 -904
  258. package/src/installs/node.md +0 -1153
  259. package/src/installs/nordpass.js +0 -716
  260. package/src/installs/nordpass.md +0 -921
  261. package/src/installs/nordvpn.js +0 -892
  262. package/src/installs/nordvpn.md +0 -1052
  263. package/src/installs/nvm.js +0 -995
  264. package/src/installs/nvm.md +0 -1057
  265. package/src/installs/ohmyzsh.js +0 -529
  266. package/src/installs/ohmyzsh.md +0 -1094
  267. package/src/installs/openssh.js +0 -804
  268. package/src/installs/openssh.md +0 -1056
  269. package/src/installs/pandoc.js +0 -662
  270. package/src/installs/pandoc.md +0 -1036
  271. package/src/installs/parallels-desktop.js +0 -431
  272. package/src/installs/parallels-desktop.md +0 -446
  273. package/src/installs/pinentry.js +0 -510
  274. package/src/installs/pinentry.md +0 -1142
  275. package/src/installs/pngyu.js +0 -869
  276. package/src/installs/pngyu.md +0 -896
  277. package/src/installs/postman.js +0 -799
  278. package/src/installs/postman.md +0 -940
  279. package/src/installs/procps.js +0 -425
  280. package/src/installs/procps.md +0 -851
  281. package/src/installs/safari-tech-preview.js +0 -374
  282. package/src/installs/safari-tech-preview.md +0 -533
  283. package/src/installs/sfnt2woff.js +0 -658
  284. package/src/installs/sfnt2woff.md +0 -795
  285. package/src/installs/shellcheck.js +0 -481
  286. package/src/installs/shellcheck.md +0 -1005
  287. package/src/installs/slack.js +0 -741
  288. package/src/installs/slack.md +0 -865
  289. package/src/installs/snagit.js +0 -585
  290. package/src/installs/snagit.md +0 -844
  291. package/src/installs/software-properties-common.js +0 -372
  292. package/src/installs/software-properties-common.md +0 -805
  293. package/src/installs/spotify.js +0 -877
  294. package/src/installs/spotify.md +0 -901
  295. package/src/installs/studio-3t.js +0 -823
  296. package/src/installs/studio-3t.md +0 -918
  297. package/src/installs/sublime-text.js +0 -804
  298. package/src/installs/sublime-text.md +0 -914
  299. package/src/installs/superwhisper.js +0 -706
  300. package/src/installs/superwhisper.md +0 -630
  301. package/src/installs/tailscale.js +0 -745
  302. package/src/installs/tailscale.md +0 -1100
  303. package/src/installs/tar.js +0 -389
  304. package/src/installs/tar.md +0 -946
  305. package/src/installs/termius.js +0 -798
  306. package/src/installs/termius.md +0 -844
  307. package/src/installs/terraform.js +0 -779
  308. package/src/installs/terraform.md +0 -899
  309. package/src/installs/tfenv.js +0 -778
  310. package/src/installs/tfenv.md +0 -1091
  311. package/src/installs/tidal.js +0 -771
  312. package/src/installs/tidal.md +0 -864
  313. package/src/installs/tmux.js +0 -346
  314. package/src/installs/tmux.md +0 -1030
  315. package/src/installs/tree.js +0 -411
  316. package/src/installs/tree.md +0 -833
  317. package/src/installs/unzip.js +0 -460
  318. package/src/installs/unzip.md +0 -879
  319. package/src/installs/vim.js +0 -421
  320. package/src/installs/vim.md +0 -1040
  321. package/src/installs/vlc.js +0 -821
  322. package/src/installs/vlc.md +0 -927
  323. package/src/installs/vscode.js +0 -843
  324. package/src/installs/vscode.md +0 -1002
  325. package/src/installs/wget.js +0 -420
  326. package/src/installs/wget.md +0 -791
  327. package/src/installs/whatsapp.js +0 -729
  328. package/src/installs/whatsapp.md +0 -854
  329. package/src/installs/winpty.js +0 -352
  330. package/src/installs/winpty.md +0 -620
  331. package/src/installs/woff2.js +0 -553
  332. package/src/installs/woff2.md +0 -977
  333. package/src/installs/wsl.js +0 -572
  334. package/src/installs/wsl.md +0 -699
  335. package/src/installs/xcode-clt.js +0 -520
  336. package/src/installs/xcode-clt.md +0 -351
  337. package/src/installs/xcode.js +0 -560
  338. package/src/installs/xcode.md +0 -573
  339. package/src/installs/yarn.js +0 -824
  340. package/src/installs/yarn.md +0 -1074
  341. package/src/installs/yq.js +0 -654
  342. package/src/installs/yq.md +0 -944
  343. package/src/installs/yt-dlp.js +0 -701
  344. package/src/installs/yt-dlp.md +0 -946
  345. package/src/installs/yum-utils.js +0 -297
  346. package/src/installs/yum-utils.md +0 -648
  347. package/src/installs/zoom.js +0 -759
  348. package/src/installs/zoom.md +0 -884
  349. package/src/installs/zsh.js +0 -455
  350. package/src/installs/zsh.md +0 -1008
  351. package/src/scripts/README.md +0 -617
  352. package/src/scripts/STATUS.md +0 -208
  353. package/src/scripts/afk.js +0 -411
  354. package/src/scripts/backup-all.js +0 -746
  355. package/src/scripts/backup-source.js +0 -727
  356. package/src/scripts/brewd.js +0 -389
  357. package/src/scripts/brewi.js +0 -520
  358. package/src/scripts/brewr.js +0 -527
  359. package/src/scripts/brews.js +0 -477
  360. package/src/scripts/brewu.js +0 -504
  361. package/src/scripts/c.js +0 -201
  362. package/src/scripts/ccurl.js +0 -341
  363. package/src/scripts/certbot-crontab-init.js +0 -504
  364. package/src/scripts/certbot-init.js +0 -657
  365. package/src/scripts/ch.js +0 -355
  366. package/src/scripts/claude-danger.js +0 -268
  367. package/src/scripts/clean-dev.js +0 -435
  368. package/src/scripts/clear-dns-cache.js +0 -541
  369. package/src/scripts/clone.js +0 -435
  370. package/src/scripts/code-all.js +0 -437
  371. package/src/scripts/count-files.js +0 -211
  372. package/src/scripts/count-folders.js +0 -211
  373. package/src/scripts/count.js +0 -264
  374. package/src/scripts/d.js +0 -219
  375. package/src/scripts/datauri.js +0 -389
  376. package/src/scripts/delete-files.js +0 -380
  377. package/src/scripts/docker-clean.js +0 -426
  378. package/src/scripts/dp.js +0 -442
  379. package/src/scripts/e.js +0 -390
  380. package/src/scripts/empty-trash.js +0 -513
  381. package/src/scripts/evm.js +0 -444
  382. package/src/scripts/fetch-github-repos.js +0 -456
  383. package/src/scripts/get-channel.js +0 -345
  384. package/src/scripts/get-course.js +0 -399
  385. package/src/scripts/get-dependencies.js +0 -306
  386. package/src/scripts/get-folder.js +0 -799
  387. package/src/scripts/get-tunes.js +0 -426
  388. package/src/scripts/get-video.js +0 -367
  389. package/src/scripts/git-backup.js +0 -577
  390. package/src/scripts/git-clone.js +0 -493
  391. package/src/scripts/git-pup.js +0 -319
  392. package/src/scripts/git-push.js +0 -396
  393. package/src/scripts/h.js +0 -622
  394. package/src/scripts/hide-desktop-icons.js +0 -499
  395. package/src/scripts/hide-hidden-files.js +0 -538
  396. package/src/scripts/install-dependencies-from.js +0 -456
  397. package/src/scripts/ips.js +0 -663
  398. package/src/scripts/iso.js +0 -370
  399. package/src/scripts/killni.js +0 -577
  400. package/src/scripts/ll.js +0 -467
  401. package/src/scripts/local-ip.js +0 -325
  402. package/src/scripts/m.js +0 -524
  403. package/src/scripts/map.js +0 -309
  404. package/src/scripts/mkd.js +0 -351
  405. package/src/scripts/ncu-update-all.js +0 -457
  406. package/src/scripts/nginx-init.js +0 -718
  407. package/src/scripts/npmi.js +0 -382
  408. package/src/scripts/o.js +0 -511
  409. package/src/scripts/org-by-date.js +0 -338
  410. package/src/scripts/p.js +0 -224
  411. package/src/scripts/packages.js +0 -330
  412. package/src/scripts/path.js +0 -225
  413. package/src/scripts/ports.js +0 -597
  414. package/src/scripts/q.js +0 -305
  415. package/src/scripts/refresh-files.js +0 -394
  416. package/src/scripts/remove-smaller-files.js +0 -516
  417. package/src/scripts/rename-files-with-date.js +0 -533
  418. package/src/scripts/resize-image.js +0 -539
  419. package/src/scripts/rm-safe.js +0 -669
  420. package/src/scripts/s.js +0 -540
  421. package/src/scripts/set-git-public.js +0 -365
  422. package/src/scripts/show-desktop-icons.js +0 -475
  423. package/src/scripts/show-hidden-files.js +0 -472
  424. package/src/scripts/tpa.js +0 -280
  425. package/src/scripts/tpo.js +0 -280
  426. package/src/scripts/u.js +0 -505
  427. package/src/scripts/vpush.js +0 -437
  428. package/src/scripts/y.js +0 -283
  429. package/src/utils/README.md +0 -95
  430. package/src/utils/common/apps.js +0 -143
  431. package/src/utils/common/display.js +0 -157
  432. package/src/utils/common/network.js +0 -185
  433. package/src/utils/common/os.js +0 -294
  434. package/src/utils/common/package-manager.js +0 -301
  435. package/src/utils/common/privileges.js +0 -138
  436. package/src/utils/common/shell.js +0 -261
  437. package/src/utils/macos/apps.js +0 -228
  438. package/src/utils/macos/brew.js +0 -315
  439. package/src/utils/ubuntu/apt.js +0 -307
  440. package/src/utils/ubuntu/desktop.js +0 -292
  441. package/src/utils/ubuntu/snap.js +0 -344
  442. package/src/utils/ubuntu/systemd.js +0 -286
  443. package/src/utils/windows/choco.js +0 -465
  444. package/src/utils/windows/env.js +0 -246
  445. package/src/utils/windows/registry.js +0 -269
  446. package/src/utils/windows/shell.js +0 -240
  447. package/src/utils/windows/winget.js +0 -489
@@ -1,727 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * backup-source - Backup ~/Source directory using rsync or robocopy.
5
- *
6
- * Migrated from legacy dotfiles alias.
7
- * Original:
8
- * backup-source(){
9
- * backupdir="$*$(date +"%Y%m%d%H%M%S")/"
10
- * backupcmd="rsync -arv --progress --no-links --exclude={.Trash,.android,.atom,...} ~/Source $backupdir"
11
- * mkdir -p "$backupdir"
12
- * eval "$backupcmd"
13
- * cd "$backupdir"
14
- * }
15
- *
16
- * @module scripts/backup-source
17
- */
18
-
19
- const fs = require('fs');
20
- const path = require('path');
21
- const os = require('../utils/common/os');
22
- const shell = require('../utils/common/shell');
23
-
24
- /**
25
- * Directories and files to exclude from backup.
26
- * These are common development artifacts, caches, and system directories
27
- * that should not be backed up.
28
- */
29
- const EXCLUDE_PATTERNS = [
30
- '.Trash',
31
- '.android',
32
- '.atom',
33
- '.bash_sessions',
34
- '.cache',
35
- '.cups',
36
- '.dropbox',
37
- '.git',
38
- '.next',
39
- '.npm',
40
- '.nvm',
41
- '.viminfo',
42
- 'bower_components',
43
- 'node_modules',
44
- '.tmp',
45
- '.idea',
46
- '.DS_Store',
47
- '.terraform'
48
- ];
49
-
50
- /**
51
- * Generates a timestamp string in YYYYMMDDHHmmss format.
52
- * This format is used to create unique backup directory names.
53
- *
54
- * @returns {string} Timestamp in YYYYMMDDHHmmss format (e.g., "20240115143022")
55
- */
56
- function generateTimestamp() {
57
- const now = new Date();
58
- const year = now.getFullYear();
59
- const month = String(now.getMonth() + 1).padStart(2, '0');
60
- const day = String(now.getDate()).padStart(2, '0');
61
- const hours = String(now.getHours()).padStart(2, '0');
62
- const minutes = String(now.getMinutes()).padStart(2, '0');
63
- const seconds = String(now.getSeconds()).padStart(2, '0');
64
- return `${year}${month}${day}${hours}${minutes}${seconds}`;
65
- }
66
-
67
- /**
68
- * Gets the path to the user's Source directory.
69
- * This is typically ~/Source on all platforms.
70
- *
71
- * @returns {string} Absolute path to ~/Source
72
- */
73
- function getSourceDirectory() {
74
- return path.join(os.getHomeDir(), 'Source');
75
- }
76
-
77
- /**
78
- * Validates that the Source directory exists.
79
- *
80
- * @returns {boolean} True if ~/Source exists and is a directory
81
- */
82
- function sourceDirectoryExists() {
83
- const sourcePath = getSourceDirectory();
84
- try {
85
- const stats = fs.statSync(sourcePath);
86
- return stats.isDirectory();
87
- } catch {
88
- return false;
89
- }
90
- }
91
-
92
- /**
93
- * Checks if rsync is available on the system.
94
- *
95
- * @returns {boolean} True if rsync command is available
96
- */
97
- function isRsyncAvailable() {
98
- return shell.commandExists('rsync');
99
- }
100
-
101
- /**
102
- * Node.js implementation note:
103
- *
104
- * This script intentionally uses rsync (macOS/Linux) or robocopy (Windows)
105
- * instead of a pure Node.js implementation because:
106
- *
107
- * 1. rsync is battle-tested for decades with excellent file synchronization
108
- * 2. rsync handles edge cases (symlinks, permissions, sparse files) that
109
- * would be complex to implement correctly in Node.js
110
- * 3. rsync has progress reporting and resumable transfers
111
- * 4. robocopy is the Windows equivalent with similar benefits
112
- *
113
- * A pure Node.js implementation would not be appropriate for this use case.
114
- *
115
- * @param {string[]} args - Command line arguments (unused - this is a note)
116
- * @returns {Promise<void>}
117
- */
118
- async function do_backup_source_nodejs(args) {
119
- // This function documents why we don't use pure Node.js for this task.
120
- // The platform-specific functions use rsync or robocopy because those tools
121
- // are superior for file synchronization compared to implementing the same
122
- // functionality in Node.js.
123
- throw new Error(
124
- 'do_backup_source_nodejs should not be called directly. ' +
125
- 'This script requires platform-specific tools (rsync or robocopy).'
126
- );
127
- }
128
-
129
- /**
130
- * Backs up ~/Source directory on macOS using rsync.
131
- *
132
- * Creates a timestamped backup directory at the specified destination and
133
- * uses rsync to copy all files while excluding common development artifacts.
134
- *
135
- * @param {string[]} args - Command line arguments
136
- * @param {string} args[0] - Destination backup directory path (required)
137
- * @returns {Promise<void>}
138
- */
139
- async function do_backup_source_macos(args) {
140
- // Validate destination argument
141
- if (!args || args.length === 0 || !args[0]) {
142
- console.error('Error: Destination backup directory is required.');
143
- console.error('');
144
- console.error('Usage: backup-source /path/to/backups/');
145
- console.error('');
146
- console.error('Example:');
147
- console.error(' backup-source /Volumes/ExternalDrive/backups/');
148
- console.error(' backup-source ~/Backups/');
149
- process.exit(1);
150
- }
151
-
152
- // Validate Source directory exists
153
- if (!sourceDirectoryExists()) {
154
- console.error('Error: Source directory does not exist.');
155
- console.error(`Expected path: ${getSourceDirectory()}`);
156
- console.error('');
157
- console.error('Create the directory first or check if it exists at a different location.');
158
- process.exit(1);
159
- }
160
-
161
- // Check if rsync is available
162
- if (!isRsyncAvailable()) {
163
- console.error('Error: rsync is required but not installed.');
164
- console.error('Install it with: brew install rsync');
165
- process.exit(1);
166
- }
167
-
168
- // Build the backup directory path with timestamp
169
- const destBase = args.join(' ').replace(/\/+$/, ''); // Remove trailing slashes
170
- const timestamp = generateTimestamp();
171
- const backupDir = `${destBase}${timestamp}/`;
172
-
173
- // Create the backup directory
174
- console.log(`Creating backup directory: ${backupDir}`);
175
- try {
176
- fs.mkdirSync(backupDir, { recursive: true });
177
- } catch (err) {
178
- console.error(`Error: Failed to create backup directory: ${err.message}`);
179
- process.exit(1);
180
- }
181
-
182
- // Build rsync command with exclude patterns
183
- const excludeArgs = EXCLUDE_PATTERNS.map(pattern => `--exclude="${pattern}"`).join(' ');
184
- const sourcePath = getSourceDirectory();
185
- const rsyncCmd = `rsync -arv --progress --no-links ${excludeArgs} "${sourcePath}" "${backupDir}"`;
186
-
187
- console.log('');
188
- console.log('Starting backup of ~/Source...');
189
- console.log(`Source: ${sourcePath}`);
190
- console.log(`Destination: ${backupDir}`);
191
- console.log('');
192
-
193
- // Execute rsync with live output
194
- const result = await shell.spawnAsync('rsync', [
195
- '-arv',
196
- '--progress',
197
- '--no-links',
198
- ...EXCLUDE_PATTERNS.map(p => `--exclude=${p}`),
199
- sourcePath,
200
- backupDir
201
- ], {
202
- onStdout: (data) => process.stdout.write(data),
203
- onStderr: (data) => process.stderr.write(data)
204
- });
205
-
206
- if (result.code !== 0) {
207
- console.error('');
208
- console.error('Error: Backup failed.');
209
- console.error(result.stderr);
210
- process.exit(1);
211
- }
212
-
213
- console.log('');
214
- console.log('Backup completed successfully!');
215
- console.log(`Backup location: ${backupDir}`);
216
- }
217
-
218
- /**
219
- * Backs up ~/Source directory on Ubuntu using rsync.
220
- *
221
- * Creates a timestamped backup directory at the specified destination and
222
- * uses rsync to copy all files while excluding common development artifacts.
223
- *
224
- * @param {string[]} args - Command line arguments
225
- * @param {string} args[0] - Destination backup directory path (required)
226
- * @returns {Promise<void>}
227
- */
228
- async function do_backup_source_ubuntu(args) {
229
- // Validate destination argument
230
- if (!args || args.length === 0 || !args[0]) {
231
- console.error('Error: Destination backup directory is required.');
232
- console.error('');
233
- console.error('Usage: backup-source /path/to/backups/');
234
- console.error('');
235
- console.error('Example:');
236
- console.error(' backup-source /mnt/backup/');
237
- console.error(' backup-source ~/Backups/');
238
- process.exit(1);
239
- }
240
-
241
- // Validate Source directory exists
242
- if (!sourceDirectoryExists()) {
243
- console.error('Error: Source directory does not exist.');
244
- console.error(`Expected path: ${getSourceDirectory()}`);
245
- console.error('');
246
- console.error('Create the directory first or check if it exists at a different location.');
247
- process.exit(1);
248
- }
249
-
250
- // Check if rsync is available
251
- if (!isRsyncAvailable()) {
252
- console.error('Error: rsync is required but not installed.');
253
- console.error('Install it with: sudo apt-get install rsync');
254
- process.exit(1);
255
- }
256
-
257
- // Build the backup directory path with timestamp
258
- const destBase = args.join(' ').replace(/\/+$/, ''); // Remove trailing slashes
259
- const timestamp = generateTimestamp();
260
- const backupDir = `${destBase}${timestamp}/`;
261
-
262
- // Create the backup directory
263
- console.log(`Creating backup directory: ${backupDir}`);
264
- try {
265
- fs.mkdirSync(backupDir, { recursive: true });
266
- } catch (err) {
267
- console.error(`Error: Failed to create backup directory: ${err.message}`);
268
- process.exit(1);
269
- }
270
-
271
- // Get source path
272
- const sourcePath = getSourceDirectory();
273
-
274
- console.log('');
275
- console.log('Starting backup of ~/Source...');
276
- console.log(`Source: ${sourcePath}`);
277
- console.log(`Destination: ${backupDir}`);
278
- console.log('');
279
-
280
- // Execute rsync with live output
281
- const result = await shell.spawnAsync('rsync', [
282
- '-arv',
283
- '--progress',
284
- '--no-links',
285
- ...EXCLUDE_PATTERNS.map(p => `--exclude=${p}`),
286
- sourcePath,
287
- backupDir
288
- ], {
289
- onStdout: (data) => process.stdout.write(data),
290
- onStderr: (data) => process.stderr.write(data)
291
- });
292
-
293
- if (result.code !== 0) {
294
- console.error('');
295
- console.error('Error: Backup failed.');
296
- console.error(result.stderr);
297
- process.exit(1);
298
- }
299
-
300
- console.log('');
301
- console.log('Backup completed successfully!');
302
- console.log(`Backup location: ${backupDir}`);
303
- }
304
-
305
- /**
306
- * Backs up ~/Source directory on Raspberry Pi OS using rsync.
307
- *
308
- * Creates a timestamped backup directory at the specified destination and
309
- * uses rsync to copy all files while excluding common development artifacts.
310
- *
311
- * @param {string[]} args - Command line arguments
312
- * @param {string} args[0] - Destination backup directory path (required)
313
- * @returns {Promise<void>}
314
- */
315
- async function do_backup_source_raspbian(args) {
316
- // Raspbian uses the same rsync approach as Ubuntu
317
- return do_backup_source_ubuntu(args);
318
- }
319
-
320
- /**
321
- * Backs up ~/Source directory on Amazon Linux using rsync.
322
- *
323
- * Creates a timestamped backup directory at the specified destination and
324
- * uses rsync to copy all files while excluding common development artifacts.
325
- *
326
- * @param {string[]} args - Command line arguments
327
- * @param {string} args[0] - Destination backup directory path (required)
328
- * @returns {Promise<void>}
329
- */
330
- async function do_backup_source_amazon_linux(args) {
331
- // Validate destination argument
332
- if (!args || args.length === 0 || !args[0]) {
333
- console.error('Error: Destination backup directory is required.');
334
- console.error('');
335
- console.error('Usage: backup-source /path/to/backups/');
336
- console.error('');
337
- console.error('Example:');
338
- console.error(' backup-source /mnt/efs/backups/');
339
- console.error(' backup-source ~/Backups/');
340
- process.exit(1);
341
- }
342
-
343
- // Validate Source directory exists
344
- if (!sourceDirectoryExists()) {
345
- console.error('Error: Source directory does not exist.');
346
- console.error(`Expected path: ${getSourceDirectory()}`);
347
- console.error('');
348
- console.error('Create the directory first or check if it exists at a different location.');
349
- process.exit(1);
350
- }
351
-
352
- // Check if rsync is available
353
- if (!isRsyncAvailable()) {
354
- console.error('Error: rsync is required but not installed.');
355
- console.error('Install it with: sudo dnf install rsync (or: sudo yum install rsync)');
356
- process.exit(1);
357
- }
358
-
359
- // Build the backup directory path with timestamp
360
- const destBase = args.join(' ').replace(/\/+$/, ''); // Remove trailing slashes
361
- const timestamp = generateTimestamp();
362
- const backupDir = `${destBase}${timestamp}/`;
363
-
364
- // Create the backup directory
365
- console.log(`Creating backup directory: ${backupDir}`);
366
- try {
367
- fs.mkdirSync(backupDir, { recursive: true });
368
- } catch (err) {
369
- console.error(`Error: Failed to create backup directory: ${err.message}`);
370
- process.exit(1);
371
- }
372
-
373
- // Get source path
374
- const sourcePath = getSourceDirectory();
375
-
376
- console.log('');
377
- console.log('Starting backup of ~/Source...');
378
- console.log(`Source: ${sourcePath}`);
379
- console.log(`Destination: ${backupDir}`);
380
- console.log('');
381
-
382
- // Execute rsync with live output
383
- const result = await shell.spawnAsync('rsync', [
384
- '-arv',
385
- '--progress',
386
- '--no-links',
387
- ...EXCLUDE_PATTERNS.map(p => `--exclude=${p}`),
388
- sourcePath,
389
- backupDir
390
- ], {
391
- onStdout: (data) => process.stdout.write(data),
392
- onStderr: (data) => process.stderr.write(data)
393
- });
394
-
395
- if (result.code !== 0) {
396
- console.error('');
397
- console.error('Error: Backup failed.');
398
- console.error(result.stderr);
399
- process.exit(1);
400
- }
401
-
402
- console.log('');
403
- console.log('Backup completed successfully!');
404
- console.log(`Backup location: ${backupDir}`);
405
- }
406
-
407
- /**
408
- * Backs up ~/Source directory on Windows Command Prompt using robocopy.
409
- *
410
- * Creates a timestamped backup directory at the specified destination and
411
- * uses robocopy (built into Windows) to copy all files while excluding
412
- * common development artifacts.
413
- *
414
- * @param {string[]} args - Command line arguments
415
- * @param {string} args[0] - Destination backup directory path (required)
416
- * @returns {Promise<void>}
417
- */
418
- async function do_backup_source_cmd(args) {
419
- // Validate destination argument
420
- if (!args || args.length === 0 || !args[0]) {
421
- console.error('Error: Destination backup directory is required.');
422
- console.error('');
423
- console.error('Usage: backup-source C:\\path\\to\\backups\\');
424
- console.error('');
425
- console.error('Example:');
426
- console.error(' backup-source D:\\Backups\\');
427
- console.error(' backup-source %USERPROFILE%\\Backups\\');
428
- process.exit(1);
429
- }
430
-
431
- // Validate Source directory exists
432
- if (!sourceDirectoryExists()) {
433
- console.error('Error: Source directory does not exist.');
434
- console.error(`Expected path: ${getSourceDirectory()}`);
435
- console.error('');
436
- console.error('Create the directory first or check if it exists at a different location.');
437
- process.exit(1);
438
- }
439
-
440
- // Build the backup directory path with timestamp
441
- const destBase = args.join(' ').replace(/\\+$/, '').replace(/\/+$/, ''); // Remove trailing slashes
442
- const timestamp = generateTimestamp();
443
- const backupDir = path.join(destBase + timestamp);
444
-
445
- // Create the backup directory
446
- console.log(`Creating backup directory: ${backupDir}`);
447
- try {
448
- fs.mkdirSync(backupDir, { recursive: true });
449
- } catch (err) {
450
- console.error(`Error: Failed to create backup directory: ${err.message}`);
451
- process.exit(1);
452
- }
453
-
454
- // Get source path
455
- const sourcePath = getSourceDirectory();
456
- const sourceBasename = path.basename(sourcePath);
457
- const destPath = path.join(backupDir, sourceBasename);
458
-
459
- console.log('');
460
- console.log('Starting backup of ~/Source...');
461
- console.log(`Source: ${sourcePath}`);
462
- console.log(`Destination: ${destPath}`);
463
- console.log('');
464
-
465
- // Build robocopy command with exclude patterns
466
- // robocopy uses /XD for directories and /XF for files
467
- const excludeDirs = EXCLUDE_PATTERNS.filter(p => !p.includes('.')).map(p => `/XD "${p}"`).join(' ');
468
- const excludeFiles = EXCLUDE_PATTERNS.filter(p => p.includes('.')).map(p => `/XF "${p}"`).join(' ');
469
-
470
- // Execute robocopy
471
- // /E = copy subdirectories including empty ones
472
- // /R:3 = retry 3 times on failed copies
473
- // /W:5 = wait 5 seconds between retries
474
- // /NP = no progress (we'll use /V for verbose instead)
475
- // /XJ = exclude junction points (similar to --no-links)
476
- const robocopyArgs = [
477
- sourcePath,
478
- destPath,
479
- '/E',
480
- '/R:3',
481
- '/W:5',
482
- '/XJ',
483
- ...EXCLUDE_PATTERNS.map(p => `/XD ${p}`),
484
- ...EXCLUDE_PATTERNS.map(p => `/XF ${p}`)
485
- ];
486
-
487
- const result = await shell.spawnAsync('robocopy', robocopyArgs, {
488
- onStdout: (data) => process.stdout.write(data),
489
- onStderr: (data) => process.stderr.write(data)
490
- });
491
-
492
- // robocopy exit codes: 0-7 are success (0=no files copied, 1=files copied, etc.)
493
- // Exit code 8+ indicates errors
494
- if (result.code >= 8) {
495
- console.error('');
496
- console.error('Error: Backup failed.');
497
- console.error(result.stderr);
498
- process.exit(1);
499
- }
500
-
501
- console.log('');
502
- console.log('Backup completed successfully!');
503
- console.log(`Backup location: ${backupDir}`);
504
- }
505
-
506
- /**
507
- * Backs up ~/Source directory on Windows PowerShell using robocopy.
508
- *
509
- * Creates a timestamped backup directory at the specified destination and
510
- * uses robocopy (built into Windows) to copy all files while excluding
511
- * common development artifacts.
512
- *
513
- * @param {string[]} args - Command line arguments
514
- * @param {string} args[0] - Destination backup directory path (required)
515
- * @returns {Promise<void>}
516
- */
517
- async function do_backup_source_powershell(args) {
518
- // PowerShell uses the same robocopy approach as CMD
519
- return do_backup_source_cmd(args);
520
- }
521
-
522
- /**
523
- * Backs up ~/Source directory in Git Bash using rsync (if available) or robocopy.
524
- *
525
- * Git Bash runs on Windows but can use rsync if it's installed via MSYS2.
526
- * Falls back to robocopy via PowerShell if rsync is not available.
527
- *
528
- * @param {string[]} args - Command line arguments
529
- * @param {string} args[0] - Destination backup directory path (required)
530
- * @returns {Promise<void>}
531
- */
532
- async function do_backup_source_gitbash(args) {
533
- // Validate destination argument
534
- if (!args || args.length === 0 || !args[0]) {
535
- console.error('Error: Destination backup directory is required.');
536
- console.error('');
537
- console.error('Usage: backup-source /path/to/backups/');
538
- console.error('');
539
- console.error('Example:');
540
- console.error(' backup-source /d/Backups/');
541
- console.error(' backup-source ~/Backups/');
542
- process.exit(1);
543
- }
544
-
545
- // Validate Source directory exists
546
- if (!sourceDirectoryExists()) {
547
- console.error('Error: Source directory does not exist.');
548
- console.error(`Expected path: ${getSourceDirectory()}`);
549
- console.error('');
550
- console.error('Create the directory first or check if it exists at a different location.');
551
- process.exit(1);
552
- }
553
-
554
- // Check if rsync is available in Git Bash
555
- if (isRsyncAvailable()) {
556
- // Build the backup directory path with timestamp
557
- const destBase = args.join(' ').replace(/\/+$/, ''); // Remove trailing slashes
558
- const timestamp = generateTimestamp();
559
- const backupDir = `${destBase}${timestamp}/`;
560
-
561
- // Create the backup directory
562
- console.log(`Creating backup directory: ${backupDir}`);
563
- try {
564
- fs.mkdirSync(backupDir, { recursive: true });
565
- } catch (err) {
566
- console.error(`Error: Failed to create backup directory: ${err.message}`);
567
- process.exit(1);
568
- }
569
-
570
- // Get source path
571
- const sourcePath = getSourceDirectory();
572
-
573
- console.log('');
574
- console.log('Starting backup of ~/Source using rsync...');
575
- console.log(`Source: ${sourcePath}`);
576
- console.log(`Destination: ${backupDir}`);
577
- console.log('');
578
-
579
- // Execute rsync with live output
580
- const result = await shell.spawnAsync('rsync', [
581
- '-arv',
582
- '--progress',
583
- '--no-links',
584
- ...EXCLUDE_PATTERNS.map(p => `--exclude=${p}`),
585
- sourcePath,
586
- backupDir
587
- ], {
588
- onStdout: (data) => process.stdout.write(data),
589
- onStderr: (data) => process.stderr.write(data)
590
- });
591
-
592
- if (result.code !== 0) {
593
- console.error('');
594
- console.error('Error: Backup failed.');
595
- console.error(result.stderr);
596
- process.exit(1);
597
- }
598
-
599
- console.log('');
600
- console.log('Backup completed successfully!');
601
- console.log(`Backup location: ${backupDir}`);
602
- } else {
603
- // Fall back to robocopy via PowerShell
604
- console.log('rsync not found in Git Bash, using robocopy via PowerShell...');
605
- console.log('');
606
-
607
- // Convert Git Bash paths to Windows paths for robocopy
608
- const destBase = args.join(' ').replace(/\/+$/, '');
609
- const timestamp = generateTimestamp();
610
-
611
- // Convert /c/Users/... to C:\Users\... for PowerShell
612
- let windowsDestBase = destBase;
613
- if (destBase.match(/^\/[a-zA-Z]\//)) {
614
- // Git Bash style path like /c/Users/...
615
- windowsDestBase = destBase.replace(/^\/([a-zA-Z])\//, '$1:\\').replace(/\//g, '\\');
616
- }
617
-
618
- const backupDir = windowsDestBase + timestamp;
619
-
620
- // Create the backup directory
621
- console.log(`Creating backup directory: ${backupDir}`);
622
- try {
623
- fs.mkdirSync(backupDir, { recursive: true });
624
- } catch (err) {
625
- console.error(`Error: Failed to create backup directory: ${err.message}`);
626
- process.exit(1);
627
- }
628
-
629
- // Get source path and convert to Windows format
630
- const sourcePath = getSourceDirectory();
631
- let windowsSourcePath = sourcePath;
632
- if (sourcePath.match(/^\/[a-zA-Z]\//)) {
633
- windowsSourcePath = sourcePath.replace(/^\/([a-zA-Z])\//, '$1:\\').replace(/\//g, '\\');
634
- }
635
-
636
- const sourceBasename = path.basename(sourcePath);
637
- const destPath = path.join(backupDir, sourceBasename);
638
-
639
- console.log('');
640
- console.log('Starting backup of ~/Source using robocopy...');
641
- console.log(`Source: ${windowsSourcePath}`);
642
- console.log(`Destination: ${destPath}`);
643
- console.log('');
644
-
645
- // Build robocopy command for PowerShell
646
- const excludeArgs = EXCLUDE_PATTERNS.map(p => `/XD "${p}" /XF "${p}"`).join(' ');
647
- const robocopyCmd = `robocopy "${windowsSourcePath}" "${destPath}" /E /R:3 /W:5 /XJ ${excludeArgs}`;
648
-
649
- const result = await shell.exec(`powershell.exe -NoProfile -Command "${robocopyCmd}"`);
650
-
651
- // robocopy exit codes: 0-7 are success
652
- // Note: shell.exec returns the exit code differently than spawnAsync
653
- // We check stderr for errors since robocopy outputs to stdout
654
- if (result.code >= 8) {
655
- console.error('');
656
- console.error('Error: Backup failed.');
657
- console.error(result.stderr || result.stdout);
658
- process.exit(1);
659
- }
660
-
661
- console.log(result.stdout);
662
- console.log('');
663
- console.log('Backup completed successfully!');
664
- console.log(`Backup location: ${backupDir}`);
665
- }
666
- }
667
-
668
- /**
669
- * Main entry point - detects environment and executes appropriate implementation.
670
- *
671
- * Creates a timestamped backup of the ~/Source directory to the specified
672
- * destination. Uses rsync on macOS/Linux (superior for file synchronization)
673
- * and robocopy on Windows (built-in equivalent).
674
- *
675
- * The backup excludes common development artifacts like node_modules, .git,
676
- * cache directories, and IDE-specific folders to reduce backup size and time.
677
- *
678
- * @param {string[]} args - Command line arguments
679
- * @param {string} args[0] - Destination backup directory path (required)
680
- * @returns {Promise<void>}
681
- */
682
- async function do_backup_source(args) {
683
- const platform = os.detect();
684
-
685
- const handlers = {
686
- 'macos': do_backup_source_macos,
687
- 'ubuntu': do_backup_source_ubuntu,
688
- 'debian': do_backup_source_ubuntu,
689
- 'raspbian': do_backup_source_raspbian,
690
- 'amazon_linux': do_backup_source_amazon_linux,
691
- 'rhel': do_backup_source_amazon_linux,
692
- 'fedora': do_backup_source_amazon_linux,
693
- 'cmd': do_backup_source_cmd,
694
- 'windows': do_backup_source_cmd,
695
- 'powershell': do_backup_source_powershell,
696
- 'gitbash': do_backup_source_gitbash,
697
- 'wsl': do_backup_source_ubuntu
698
- };
699
-
700
- const handler = handlers[platform.type];
701
- if (!handler) {
702
- console.error(`Platform '${platform.type}' is not supported for this command.`);
703
- console.error('');
704
- console.error('Supported platforms: macOS, Ubuntu, Debian, Raspberry Pi OS,');
705
- console.error('Amazon Linux, RHEL, Fedora, Windows, Git Bash, WSL');
706
- process.exit(1);
707
- }
708
-
709
- await handler(args);
710
- }
711
-
712
- module.exports = {
713
- main: do_backup_source,
714
- do_backup_source,
715
- do_backup_source_nodejs,
716
- do_backup_source_macos,
717
- do_backup_source_ubuntu,
718
- do_backup_source_raspbian,
719
- do_backup_source_amazon_linux,
720
- do_backup_source_cmd,
721
- do_backup_source_powershell,
722
- do_backup_source_gitbash
723
- };
724
-
725
- if (require.main === module) {
726
- do_backup_source(process.argv.slice(2));
727
- }