@fredlackey/devutils 0.0.17 → 0.0.19

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 (331) hide show
  1. package/README.md +32 -150
  2. package/package.json +5 -82
  3. package/bin/dev.js +0 -16
  4. package/files/README.md +0 -0
  5. package/files/claude/.claude/commands/setup-context.md +0 -3
  6. package/files/monorepos/_archive/README.md +0 -36
  7. package/files/monorepos/_legacy/README.md +0 -36
  8. package/files/monorepos/ai-docs/README.md +0 -33
  9. package/files/monorepos/apps/README.md +0 -24
  10. package/files/monorepos/docs/README.md +0 -40
  11. package/files/monorepos/packages/README.md +0 -25
  12. package/files/monorepos/research/README.md +0 -29
  13. package/files/monorepos/scripts/README.md +0 -24
  14. package/src/cli.js +0 -72
  15. package/src/commands/README.md +0 -41
  16. package/src/commands/configure.js +0 -199
  17. package/src/commands/identity.js +0 -1630
  18. package/src/commands/ignore.js +0 -247
  19. package/src/commands/install.js +0 -526
  20. package/src/commands/setup.js +0 -246
  21. package/src/commands/status.js +0 -223
  22. package/src/commands/update.js +0 -142
  23. package/src/commands/version.js +0 -100
  24. package/src/completion.js +0 -284
  25. package/src/constants.js +0 -45
  26. package/src/ignore/claude-code.txt +0 -10
  27. package/src/ignore/docker.txt +0 -18
  28. package/src/ignore/linux.txt +0 -23
  29. package/src/ignore/macos.txt +0 -36
  30. package/src/ignore/node.txt +0 -55
  31. package/src/ignore/terraform.txt +0 -37
  32. package/src/ignore/vscode.txt +0 -18
  33. package/src/ignore/windows.txt +0 -35
  34. package/src/index.js +0 -0
  35. package/src/installs/README.md +0 -399
  36. package/src/installs/adobe-creative-cloud.js +0 -546
  37. package/src/installs/adobe-creative-cloud.md +0 -605
  38. package/src/installs/appcleaner.js +0 -321
  39. package/src/installs/appcleaner.md +0 -699
  40. package/src/installs/apt-transport-https.js +0 -390
  41. package/src/installs/apt-transport-https.md +0 -678
  42. package/src/installs/atomicparsley.js +0 -642
  43. package/src/installs/atomicparsley.md +0 -795
  44. package/src/installs/aws-cli.js +0 -797
  45. package/src/installs/aws-cli.md +0 -727
  46. package/src/installs/balena-etcher.js +0 -710
  47. package/src/installs/balena-etcher.md +0 -761
  48. package/src/installs/bambu-studio.js +0 -1143
  49. package/src/installs/bambu-studio.md +0 -780
  50. package/src/installs/bash-completion.js +0 -575
  51. package/src/installs/bash-completion.md +0 -833
  52. package/src/installs/bash.js +0 -417
  53. package/src/installs/bash.md +0 -993
  54. package/src/installs/beyond-compare.js +0 -603
  55. package/src/installs/beyond-compare.md +0 -813
  56. package/src/installs/brave-browser.js +0 -968
  57. package/src/installs/brave-browser.md +0 -650
  58. package/src/installs/build-essential.js +0 -529
  59. package/src/installs/build-essential.md +0 -977
  60. package/src/installs/ca-certificates.js +0 -618
  61. package/src/installs/ca-certificates.md +0 -937
  62. package/src/installs/caffeine.js +0 -508
  63. package/src/installs/caffeine.md +0 -839
  64. package/src/installs/camtasia.js +0 -596
  65. package/src/installs/camtasia.md +0 -762
  66. package/src/installs/chatgpt.js +0 -476
  67. package/src/installs/chatgpt.md +0 -814
  68. package/src/installs/chocolatey.js +0 -456
  69. package/src/installs/chocolatey.md +0 -661
  70. package/src/installs/chrome-canary.js +0 -419
  71. package/src/installs/chrome-canary.md +0 -641
  72. package/src/installs/chromium.js +0 -667
  73. package/src/installs/chromium.md +0 -838
  74. package/src/installs/claude-code.js +0 -576
  75. package/src/installs/claude-code.md +0 -1173
  76. package/src/installs/cloudflare-warp.js +0 -900
  77. package/src/installs/cloudflare-warp.md +0 -1047
  78. package/src/installs/comet-browser.js +0 -588
  79. package/src/installs/comet-browser.md +0 -731
  80. package/src/installs/curl.js +0 -379
  81. package/src/installs/curl.md +0 -714
  82. package/src/installs/cursor.js +0 -579
  83. package/src/installs/cursor.md +0 -970
  84. package/src/installs/dbeaver.js +0 -924
  85. package/src/installs/dbeaver.md +0 -939
  86. package/src/installs/dbschema.js +0 -692
  87. package/src/installs/dbschema.md +0 -925
  88. package/src/installs/dependencies.md +0 -453
  89. package/src/installs/development-tools.js +0 -600
  90. package/src/installs/development-tools.md +0 -977
  91. package/src/installs/docker.js +0 -1029
  92. package/src/installs/docker.md +0 -1109
  93. package/src/installs/drawio.js +0 -1019
  94. package/src/installs/drawio.md +0 -795
  95. package/src/installs/elmedia-player.js +0 -347
  96. package/src/installs/elmedia-player.md +0 -556
  97. package/src/installs/ffmpeg.js +0 -889
  98. package/src/installs/ffmpeg.md +0 -852
  99. package/src/installs/file.js +0 -464
  100. package/src/installs/file.md +0 -987
  101. package/src/installs/gemini-cli.js +0 -811
  102. package/src/installs/gemini-cli.md +0 -1153
  103. package/src/installs/git.js +0 -400
  104. package/src/installs/git.md +0 -907
  105. package/src/installs/gitego.js +0 -949
  106. package/src/installs/gitego.md +0 -1172
  107. package/src/installs/go.js +0 -931
  108. package/src/installs/go.md +0 -958
  109. package/src/installs/google-antigravity.js +0 -913
  110. package/src/installs/google-antigravity.md +0 -1075
  111. package/src/installs/google-chrome.js +0 -833
  112. package/src/installs/google-chrome.md +0 -862
  113. package/src/installs/gpg.js +0 -480
  114. package/src/installs/gpg.md +0 -1056
  115. package/src/installs/homebrew.js +0 -1033
  116. package/src/installs/homebrew.md +0 -988
  117. package/src/installs/imageoptim.js +0 -968
  118. package/src/installs/imageoptim.md +0 -1119
  119. package/src/installs/installers.json +0 -4032
  120. package/src/installs/installers.json.tmp +0 -3953
  121. package/src/installs/jq.js +0 -400
  122. package/src/installs/jq.md +0 -809
  123. package/src/installs/keyboard-maestro.js +0 -719
  124. package/src/installs/keyboard-maestro.md +0 -825
  125. package/src/installs/kiro.js +0 -864
  126. package/src/installs/kiro.md +0 -1015
  127. package/src/installs/latex.js +0 -789
  128. package/src/installs/latex.md +0 -1095
  129. package/src/installs/lftp.js +0 -356
  130. package/src/installs/lftp.md +0 -907
  131. package/src/installs/lsb-release.js +0 -346
  132. package/src/installs/lsb-release.md +0 -814
  133. package/src/installs/messenger.js +0 -847
  134. package/src/installs/messenger.md +0 -900
  135. package/src/installs/microsoft-office.js +0 -568
  136. package/src/installs/microsoft-office.md +0 -760
  137. package/src/installs/microsoft-teams.js +0 -801
  138. package/src/installs/microsoft-teams.md +0 -886
  139. package/src/installs/moom.js +0 -326
  140. package/src/installs/moom.md +0 -570
  141. package/src/installs/node.js +0 -904
  142. package/src/installs/node.md +0 -1153
  143. package/src/installs/nordpass.js +0 -716
  144. package/src/installs/nordpass.md +0 -921
  145. package/src/installs/nordvpn.js +0 -892
  146. package/src/installs/nordvpn.md +0 -1052
  147. package/src/installs/nvm.js +0 -995
  148. package/src/installs/nvm.md +0 -1057
  149. package/src/installs/ohmyzsh.js +0 -529
  150. package/src/installs/ohmyzsh.md +0 -1094
  151. package/src/installs/openssh.js +0 -804
  152. package/src/installs/openssh.md +0 -1056
  153. package/src/installs/pandoc.js +0 -662
  154. package/src/installs/pandoc.md +0 -1036
  155. package/src/installs/parallels-desktop.js +0 -431
  156. package/src/installs/parallels-desktop.md +0 -446
  157. package/src/installs/pinentry.js +0 -510
  158. package/src/installs/pinentry.md +0 -1142
  159. package/src/installs/pngyu.js +0 -869
  160. package/src/installs/pngyu.md +0 -896
  161. package/src/installs/postman.js +0 -799
  162. package/src/installs/postman.md +0 -940
  163. package/src/installs/procps.js +0 -425
  164. package/src/installs/procps.md +0 -851
  165. package/src/installs/safari-tech-preview.js +0 -374
  166. package/src/installs/safari-tech-preview.md +0 -533
  167. package/src/installs/sfnt2woff.js +0 -658
  168. package/src/installs/sfnt2woff.md +0 -795
  169. package/src/installs/shellcheck.js +0 -481
  170. package/src/installs/shellcheck.md +0 -1005
  171. package/src/installs/slack.js +0 -741
  172. package/src/installs/slack.md +0 -865
  173. package/src/installs/snagit.js +0 -585
  174. package/src/installs/snagit.md +0 -844
  175. package/src/installs/software-properties-common.js +0 -372
  176. package/src/installs/software-properties-common.md +0 -805
  177. package/src/installs/spotify.js +0 -877
  178. package/src/installs/spotify.md +0 -901
  179. package/src/installs/studio-3t.js +0 -823
  180. package/src/installs/studio-3t.md +0 -918
  181. package/src/installs/sublime-text.js +0 -804
  182. package/src/installs/sublime-text.md +0 -914
  183. package/src/installs/superwhisper.js +0 -706
  184. package/src/installs/superwhisper.md +0 -630
  185. package/src/installs/tailscale.js +0 -745
  186. package/src/installs/tailscale.md +0 -1100
  187. package/src/installs/tar.js +0 -389
  188. package/src/installs/tar.md +0 -946
  189. package/src/installs/termius.js +0 -798
  190. package/src/installs/termius.md +0 -844
  191. package/src/installs/terraform.js +0 -779
  192. package/src/installs/terraform.md +0 -899
  193. package/src/installs/tfenv.js +0 -778
  194. package/src/installs/tfenv.md +0 -1091
  195. package/src/installs/tidal.js +0 -771
  196. package/src/installs/tidal.md +0 -864
  197. package/src/installs/tmux.js +0 -346
  198. package/src/installs/tmux.md +0 -1030
  199. package/src/installs/tree.js +0 -411
  200. package/src/installs/tree.md +0 -833
  201. package/src/installs/unzip.js +0 -460
  202. package/src/installs/unzip.md +0 -879
  203. package/src/installs/vim.js +0 -421
  204. package/src/installs/vim.md +0 -1040
  205. package/src/installs/vlc.js +0 -821
  206. package/src/installs/vlc.md +0 -927
  207. package/src/installs/vscode.js +0 -843
  208. package/src/installs/vscode.md +0 -1002
  209. package/src/installs/wget.js +0 -420
  210. package/src/installs/wget.md +0 -791
  211. package/src/installs/whatsapp.js +0 -729
  212. package/src/installs/whatsapp.md +0 -854
  213. package/src/installs/winpty.js +0 -352
  214. package/src/installs/winpty.md +0 -620
  215. package/src/installs/woff2.js +0 -553
  216. package/src/installs/woff2.md +0 -977
  217. package/src/installs/wsl.js +0 -572
  218. package/src/installs/wsl.md +0 -699
  219. package/src/installs/xcode-clt.js +0 -520
  220. package/src/installs/xcode-clt.md +0 -351
  221. package/src/installs/xcode.js +0 -560
  222. package/src/installs/xcode.md +0 -573
  223. package/src/installs/yarn.js +0 -824
  224. package/src/installs/yarn.md +0 -1074
  225. package/src/installs/yq.js +0 -654
  226. package/src/installs/yq.md +0 -944
  227. package/src/installs/yt-dlp.js +0 -701
  228. package/src/installs/yt-dlp.md +0 -946
  229. package/src/installs/yum-utils.js +0 -297
  230. package/src/installs/yum-utils.md +0 -648
  231. package/src/installs/zoom.js +0 -759
  232. package/src/installs/zoom.md +0 -884
  233. package/src/installs/zsh.js +0 -455
  234. package/src/installs/zsh.md +0 -1008
  235. package/src/scripts/README.md +0 -617
  236. package/src/scripts/STATUS.md +0 -208
  237. package/src/scripts/afk.js +0 -411
  238. package/src/scripts/backup-all.js +0 -746
  239. package/src/scripts/backup-source.js +0 -727
  240. package/src/scripts/brewd.js +0 -389
  241. package/src/scripts/brewi.js +0 -520
  242. package/src/scripts/brewr.js +0 -527
  243. package/src/scripts/brews.js +0 -477
  244. package/src/scripts/brewu.js +0 -504
  245. package/src/scripts/c.js +0 -201
  246. package/src/scripts/ccurl.js +0 -341
  247. package/src/scripts/certbot-crontab-init.js +0 -504
  248. package/src/scripts/certbot-init.js +0 -657
  249. package/src/scripts/ch.js +0 -355
  250. package/src/scripts/claude-danger.js +0 -268
  251. package/src/scripts/clean-dev.js +0 -435
  252. package/src/scripts/clear-dns-cache.js +0 -541
  253. package/src/scripts/clone.js +0 -435
  254. package/src/scripts/code-all.js +0 -437
  255. package/src/scripts/count-files.js +0 -211
  256. package/src/scripts/count-folders.js +0 -211
  257. package/src/scripts/count.js +0 -264
  258. package/src/scripts/d.js +0 -219
  259. package/src/scripts/datauri.js +0 -389
  260. package/src/scripts/delete-files.js +0 -380
  261. package/src/scripts/docker-clean.js +0 -426
  262. package/src/scripts/dp.js +0 -442
  263. package/src/scripts/e.js +0 -390
  264. package/src/scripts/empty-trash.js +0 -513
  265. package/src/scripts/evm.js +0 -444
  266. package/src/scripts/fetch-github-repos.js +0 -456
  267. package/src/scripts/get-channel.js +0 -345
  268. package/src/scripts/get-course.js +0 -399
  269. package/src/scripts/get-dependencies.js +0 -306
  270. package/src/scripts/get-folder.js +0 -799
  271. package/src/scripts/get-tunes.js +0 -426
  272. package/src/scripts/get-video.js +0 -367
  273. package/src/scripts/git-backup.js +0 -577
  274. package/src/scripts/git-clone.js +0 -493
  275. package/src/scripts/git-pup.js +0 -319
  276. package/src/scripts/git-push.js +0 -396
  277. package/src/scripts/h.js +0 -622
  278. package/src/scripts/hide-desktop-icons.js +0 -499
  279. package/src/scripts/hide-hidden-files.js +0 -538
  280. package/src/scripts/install-dependencies-from.js +0 -456
  281. package/src/scripts/ips.js +0 -663
  282. package/src/scripts/iso.js +0 -370
  283. package/src/scripts/killni.js +0 -577
  284. package/src/scripts/ll.js +0 -467
  285. package/src/scripts/local-ip.js +0 -325
  286. package/src/scripts/m.js +0 -524
  287. package/src/scripts/map.js +0 -309
  288. package/src/scripts/mkd.js +0 -351
  289. package/src/scripts/ncu-update-all.js +0 -457
  290. package/src/scripts/nginx-init.js +0 -718
  291. package/src/scripts/npmi.js +0 -382
  292. package/src/scripts/o.js +0 -511
  293. package/src/scripts/org-by-date.js +0 -338
  294. package/src/scripts/p.js +0 -224
  295. package/src/scripts/packages.js +0 -330
  296. package/src/scripts/path.js +0 -225
  297. package/src/scripts/ports.js +0 -597
  298. package/src/scripts/q.js +0 -305
  299. package/src/scripts/refresh-files.js +0 -394
  300. package/src/scripts/remove-smaller-files.js +0 -516
  301. package/src/scripts/rename-files-with-date.js +0 -533
  302. package/src/scripts/resize-image.js +0 -539
  303. package/src/scripts/rm-safe.js +0 -669
  304. package/src/scripts/s.js +0 -540
  305. package/src/scripts/set-git-public.js +0 -365
  306. package/src/scripts/show-desktop-icons.js +0 -475
  307. package/src/scripts/show-hidden-files.js +0 -472
  308. package/src/scripts/tpa.js +0 -280
  309. package/src/scripts/tpo.js +0 -280
  310. package/src/scripts/u.js +0 -505
  311. package/src/scripts/vpush.js +0 -437
  312. package/src/scripts/y.js +0 -283
  313. package/src/utils/README.md +0 -95
  314. package/src/utils/common/apps.js +0 -143
  315. package/src/utils/common/display.js +0 -157
  316. package/src/utils/common/network.js +0 -185
  317. package/src/utils/common/os.js +0 -294
  318. package/src/utils/common/package-manager.js +0 -301
  319. package/src/utils/common/privileges.js +0 -138
  320. package/src/utils/common/shell.js +0 -216
  321. package/src/utils/macos/apps.js +0 -228
  322. package/src/utils/macos/brew.js +0 -315
  323. package/src/utils/ubuntu/apt.js +0 -307
  324. package/src/utils/ubuntu/desktop.js +0 -292
  325. package/src/utils/ubuntu/snap.js +0 -344
  326. package/src/utils/ubuntu/systemd.js +0 -286
  327. package/src/utils/windows/choco.js +0 -465
  328. package/src/utils/windows/env.js +0 -246
  329. package/src/utils/windows/registry.js +0 -269
  330. package/src/utils/windows/shell.js +0 -240
  331. 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
- }