@fredlackey/devutils 0.0.18 → 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 -1028
  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 -261
  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,799 +0,0 @@
1
- #!/usr/bin/env node
2
-
3
- /**
4
- * get-folder - Copy files from source to target directory with size comparison.
5
- *
6
- * Migrated from legacy dotfiles alias.
7
- * Original:
8
- * get-folder() {
9
- * source="${1%/}/"
10
- * target="${2%/}/"
11
- * if command -v rsync &> /dev/null; then
12
- * for file in "$source"*; do
13
- * filename=$(basename "$file")
14
- * if [ -f "$target$filename" ]; then
15
- * source_size=$(stat -c %s "$file")
16
- * target_size=$(stat -c %s "$target$filename")
17
- * if [ "$source_size" -eq "$target_size" ]; then
18
- * echo "Skipping $filename as it already exists and has the same size."
19
- * else
20
- * rsync -avP "$file" "$target"
21
- * fi
22
- * else
23
- * rsync -avP "$file" "$target"
24
- * fi
25
- * done
26
- * elif command -v robocopy &> /dev/null; then
27
- * robocopy "$source" "$target" /E /Z /W:1 /R:3
28
- * else
29
- * echo "Error: Neither rsync nor robocopy command found."
30
- * return 1
31
- * fi
32
- * }
33
- *
34
- * @module scripts/get-folder
35
- */
36
-
37
- const fs = require('fs');
38
- const path = require('path');
39
- const os = require('../utils/common/os');
40
- const shell = require('../utils/common/shell');
41
-
42
- /**
43
- * Normalizes a directory path by ensuring it ends with a path separator.
44
- * This is important because rsync treats paths differently based on trailing slashes.
45
- *
46
- * @param {string} dirPath - The directory path to normalize
47
- * @returns {string} The path with a trailing separator
48
- */
49
- function ensureTrailingSlash(dirPath) {
50
- const separator = path.sep;
51
- const normalizedPath = dirPath.replace(/[\/\\]+$/, ''); // Remove existing trailing slashes
52
- return normalizedPath + separator;
53
- }
54
-
55
- /**
56
- * Validates that a directory path exists and is actually a directory.
57
- *
58
- * @param {string} dirPath - The path to validate
59
- * @returns {{ valid: boolean, error: string|null }} Validation result
60
- */
61
- function validateDirectory(dirPath) {
62
- try {
63
- const stats = fs.statSync(dirPath);
64
- if (!stats.isDirectory()) {
65
- return { valid: false, error: `Path exists but is not a directory: ${dirPath}` };
66
- }
67
- return { valid: true, error: null };
68
- } catch (err) {
69
- if (err.code === 'ENOENT') {
70
- return { valid: false, error: `Directory does not exist: ${dirPath}` };
71
- }
72
- return { valid: false, error: `Cannot access directory: ${dirPath} (${err.message})` };
73
- }
74
- }
75
-
76
- /**
77
- * Gets the size of a file in bytes.
78
- *
79
- * @param {string} filePath - The path to the file
80
- * @returns {number|null} The file size in bytes, or null if file doesn't exist
81
- */
82
- function getFileSize(filePath) {
83
- try {
84
- const stats = fs.statSync(filePath);
85
- return stats.size;
86
- } catch {
87
- return null;
88
- }
89
- }
90
-
91
- /**
92
- * Lists all files (not directories) in a directory.
93
- * Returns only top-level files, not recursive.
94
- *
95
- * @param {string} dirPath - The directory to list
96
- * @returns {string[]} Array of filenames (not full paths)
97
- */
98
- function listFiles(dirPath) {
99
- try {
100
- const entries = fs.readdirSync(dirPath, { withFileTypes: true });
101
- return entries
102
- .filter(entry => entry.isFile())
103
- .map(entry => entry.name);
104
- } catch (err) {
105
- console.error(`Error reading directory: ${err.message}`);
106
- return [];
107
- }
108
- }
109
-
110
- /**
111
- * Checks if rsync is available on the system.
112
- *
113
- * @returns {boolean} True if rsync command is available
114
- */
115
- function isRsyncAvailable() {
116
- return shell.commandExists('rsync');
117
- }
118
-
119
- /**
120
- * Checks if robocopy is available on the system.
121
- *
122
- * @returns {boolean} True if robocopy command is available
123
- */
124
- function isRobocopyAvailable() {
125
- return shell.commandExists('robocopy');
126
- }
127
-
128
- /**
129
- * Displays usage information and examples.
130
- */
131
- function showUsage() {
132
- console.error('Usage: get-folder <source-folder> <target-folder>');
133
- console.error('');
134
- console.error('Copies files from source to target directory, skipping files that');
135
- console.error('already exist in the target with the same size.');
136
- console.error('');
137
- console.error('Examples:');
138
- console.error(' get-folder /path/to/source/ /path/to/target/');
139
- console.error(' get-folder ~/Downloads/photos/ ~/Pictures/');
140
- }
141
-
142
- /**
143
- * Node.js implementation note:
144
- *
145
- * This script intentionally uses rsync (macOS/Linux) or robocopy (Windows)
146
- * instead of a pure Node.js implementation because:
147
- *
148
- * 1. rsync is battle-tested for decades with excellent file copying
149
- * 2. rsync handles edge cases (permissions, timestamps, partial transfers)
150
- * 3. rsync has progress reporting with -P (--progress --partial)
151
- * 4. robocopy is the Windows equivalent with similar reliability
152
- *
153
- * A pure Node.js implementation could be written using fs.copyFile() and
154
- * fs.stat(), but it would lack the robustness and progress reporting of
155
- * these dedicated tools.
156
- *
157
- * @param {string[]} args - Command line arguments (unused - this is a note)
158
- * @returns {Promise<void>}
159
- */
160
- async function do_get_folder_nodejs(args) {
161
- // This function documents why we don't use pure Node.js for this task.
162
- // The platform-specific functions use rsync or robocopy because those tools
163
- // are superior for file copying with size comparison.
164
- throw new Error(
165
- 'do_get_folder_nodejs should not be called directly. ' +
166
- 'This script requires platform-specific tools (rsync or robocopy).'
167
- );
168
- }
169
-
170
- /**
171
- * Copies files from source to target on macOS using rsync.
172
- *
173
- * Iterates through each file in the source directory and:
174
- * - Skips files that exist in target with the same size
175
- * - Copies files using rsync with progress output for new/changed files
176
- *
177
- * @param {string[]} args - Command line arguments
178
- * @param {string} args[0] - Source folder path (required)
179
- * @param {string} args[1] - Target folder path (required)
180
- * @returns {Promise<void>}
181
- */
182
- async function do_get_folder_macos(args) {
183
- // Validate arguments
184
- if (!args || args.length < 2) {
185
- console.error('Error: Both source and target folders are required.');
186
- console.error('');
187
- showUsage();
188
- process.exit(1);
189
- }
190
-
191
- const sourcePath = ensureTrailingSlash(args[0]);
192
- const targetPath = ensureTrailingSlash(args[1]);
193
-
194
- // Validate source directory exists
195
- const sourceValidation = validateDirectory(sourcePath.slice(0, -1)); // Remove trailing slash for validation
196
- if (!sourceValidation.valid) {
197
- console.error(`Error: ${sourceValidation.error}`);
198
- process.exit(1);
199
- }
200
-
201
- // Validate target directory exists
202
- const targetValidation = validateDirectory(targetPath.slice(0, -1));
203
- if (!targetValidation.valid) {
204
- console.error(`Error: ${targetValidation.error}`);
205
- process.exit(1);
206
- }
207
-
208
- // Check if rsync is available
209
- if (!isRsyncAvailable()) {
210
- console.error('Error: rsync is required but not installed.');
211
- console.error('Install it with: brew install rsync');
212
- process.exit(1);
213
- }
214
-
215
- console.log(`Source: ${sourcePath}`);
216
- console.log(`Target: ${targetPath}`);
217
- console.log('');
218
-
219
- // Get list of files in source directory
220
- const files = listFiles(sourcePath.slice(0, -1));
221
-
222
- if (files.length === 0) {
223
- console.log('No files found in source directory.');
224
- return;
225
- }
226
-
227
- let copiedCount = 0;
228
- let skippedCount = 0;
229
-
230
- // Process each file
231
- for (const filename of files) {
232
- const sourceFile = path.join(sourcePath, filename);
233
- const targetFile = path.join(targetPath, filename);
234
-
235
- // Check if target file exists
236
- const targetSize = getFileSize(targetFile);
237
-
238
- if (targetSize !== null) {
239
- // Target file exists - compare sizes
240
- const sourceSize = getFileSize(sourceFile);
241
-
242
- if (sourceSize === targetSize) {
243
- console.log(`Skipping ${filename} as it already exists and has the same size.`);
244
- skippedCount++;
245
- continue;
246
- }
247
- }
248
-
249
- // Copy file using rsync with progress
250
- console.log(`Copying ${filename}...`);
251
- const result = await shell.spawnAsync('rsync', [
252
- '-avP',
253
- sourceFile,
254
- targetPath
255
- ], {
256
- onStdout: (data) => process.stdout.write(data),
257
- onStderr: (data) => process.stderr.write(data)
258
- });
259
-
260
- if (result.code !== 0) {
261
- console.error(`Warning: Failed to copy ${filename}`);
262
- } else {
263
- copiedCount++;
264
- }
265
- }
266
-
267
- console.log('');
268
- console.log(`Done. Copied: ${copiedCount}, Skipped: ${skippedCount}`);
269
- }
270
-
271
- /**
272
- * Copies files from source to target on Ubuntu using rsync.
273
- *
274
- * Iterates through each file in the source directory and:
275
- * - Skips files that exist in target with the same size
276
- * - Copies files using rsync with progress output for new/changed files
277
- *
278
- * @param {string[]} args - Command line arguments
279
- * @param {string} args[0] - Source folder path (required)
280
- * @param {string} args[1] - Target folder path (required)
281
- * @returns {Promise<void>}
282
- */
283
- async function do_get_folder_ubuntu(args) {
284
- // Validate arguments
285
- if (!args || args.length < 2) {
286
- console.error('Error: Both source and target folders are required.');
287
- console.error('');
288
- showUsage();
289
- process.exit(1);
290
- }
291
-
292
- const sourcePath = ensureTrailingSlash(args[0]);
293
- const targetPath = ensureTrailingSlash(args[1]);
294
-
295
- // Validate source directory exists
296
- const sourceValidation = validateDirectory(sourcePath.slice(0, -1));
297
- if (!sourceValidation.valid) {
298
- console.error(`Error: ${sourceValidation.error}`);
299
- process.exit(1);
300
- }
301
-
302
- // Validate target directory exists
303
- const targetValidation = validateDirectory(targetPath.slice(0, -1));
304
- if (!targetValidation.valid) {
305
- console.error(`Error: ${targetValidation.error}`);
306
- process.exit(1);
307
- }
308
-
309
- // Check if rsync is available
310
- if (!isRsyncAvailable()) {
311
- console.error('Error: rsync is required but not installed.');
312
- console.error('Install it with: sudo apt-get install rsync');
313
- process.exit(1);
314
- }
315
-
316
- console.log(`Source: ${sourcePath}`);
317
- console.log(`Target: ${targetPath}`);
318
- console.log('');
319
-
320
- // Get list of files in source directory
321
- const files = listFiles(sourcePath.slice(0, -1));
322
-
323
- if (files.length === 0) {
324
- console.log('No files found in source directory.');
325
- return;
326
- }
327
-
328
- let copiedCount = 0;
329
- let skippedCount = 0;
330
-
331
- // Process each file
332
- for (const filename of files) {
333
- const sourceFile = path.join(sourcePath, filename);
334
- const targetFile = path.join(targetPath, filename);
335
-
336
- // Check if target file exists
337
- const targetSize = getFileSize(targetFile);
338
-
339
- if (targetSize !== null) {
340
- // Target file exists - compare sizes
341
- const sourceSize = getFileSize(sourceFile);
342
-
343
- if (sourceSize === targetSize) {
344
- console.log(`Skipping ${filename} as it already exists and has the same size.`);
345
- skippedCount++;
346
- continue;
347
- }
348
- }
349
-
350
- // Copy file using rsync with progress
351
- console.log(`Copying ${filename}...`);
352
- const result = await shell.spawnAsync('rsync', [
353
- '-avP',
354
- sourceFile,
355
- targetPath
356
- ], {
357
- onStdout: (data) => process.stdout.write(data),
358
- onStderr: (data) => process.stderr.write(data)
359
- });
360
-
361
- if (result.code !== 0) {
362
- console.error(`Warning: Failed to copy ${filename}`);
363
- } else {
364
- copiedCount++;
365
- }
366
- }
367
-
368
- console.log('');
369
- console.log(`Done. Copied: ${copiedCount}, Skipped: ${skippedCount}`);
370
- }
371
-
372
- /**
373
- * Copies files from source to target on Raspberry Pi OS using rsync.
374
- *
375
- * Uses the same rsync approach as Ubuntu since Raspberry Pi OS is Debian-based.
376
- *
377
- * @param {string[]} args - Command line arguments
378
- * @param {string} args[0] - Source folder path (required)
379
- * @param {string} args[1] - Target folder path (required)
380
- * @returns {Promise<void>}
381
- */
382
- async function do_get_folder_raspbian(args) {
383
- // Raspbian uses the same rsync approach as Ubuntu
384
- return do_get_folder_ubuntu(args);
385
- }
386
-
387
- /**
388
- * Copies files from source to target on Amazon Linux using rsync.
389
- *
390
- * Uses rsync for reliable file copying with size comparison.
391
- *
392
- * @param {string[]} args - Command line arguments
393
- * @param {string} args[0] - Source folder path (required)
394
- * @param {string} args[1] - Target folder path (required)
395
- * @returns {Promise<void>}
396
- */
397
- async function do_get_folder_amazon_linux(args) {
398
- // Validate arguments
399
- if (!args || args.length < 2) {
400
- console.error('Error: Both source and target folders are required.');
401
- console.error('');
402
- showUsage();
403
- process.exit(1);
404
- }
405
-
406
- const sourcePath = ensureTrailingSlash(args[0]);
407
- const targetPath = ensureTrailingSlash(args[1]);
408
-
409
- // Validate source directory exists
410
- const sourceValidation = validateDirectory(sourcePath.slice(0, -1));
411
- if (!sourceValidation.valid) {
412
- console.error(`Error: ${sourceValidation.error}`);
413
- process.exit(1);
414
- }
415
-
416
- // Validate target directory exists
417
- const targetValidation = validateDirectory(targetPath.slice(0, -1));
418
- if (!targetValidation.valid) {
419
- console.error(`Error: ${targetValidation.error}`);
420
- process.exit(1);
421
- }
422
-
423
- // Check if rsync is available
424
- if (!isRsyncAvailable()) {
425
- console.error('Error: rsync is required but not installed.');
426
- console.error('Install it with: sudo dnf install rsync (or: sudo yum install rsync)');
427
- process.exit(1);
428
- }
429
-
430
- console.log(`Source: ${sourcePath}`);
431
- console.log(`Target: ${targetPath}`);
432
- console.log('');
433
-
434
- // Get list of files in source directory
435
- const files = listFiles(sourcePath.slice(0, -1));
436
-
437
- if (files.length === 0) {
438
- console.log('No files found in source directory.');
439
- return;
440
- }
441
-
442
- let copiedCount = 0;
443
- let skippedCount = 0;
444
-
445
- // Process each file
446
- for (const filename of files) {
447
- const sourceFile = path.join(sourcePath, filename);
448
- const targetFile = path.join(targetPath, filename);
449
-
450
- // Check if target file exists
451
- const targetSize = getFileSize(targetFile);
452
-
453
- if (targetSize !== null) {
454
- // Target file exists - compare sizes
455
- const sourceSize = getFileSize(sourceFile);
456
-
457
- if (sourceSize === targetSize) {
458
- console.log(`Skipping ${filename} as it already exists and has the same size.`);
459
- skippedCount++;
460
- continue;
461
- }
462
- }
463
-
464
- // Copy file using rsync with progress
465
- console.log(`Copying ${filename}...`);
466
- const result = await shell.spawnAsync('rsync', [
467
- '-avP',
468
- sourceFile,
469
- targetPath
470
- ], {
471
- onStdout: (data) => process.stdout.write(data),
472
- onStderr: (data) => process.stderr.write(data)
473
- });
474
-
475
- if (result.code !== 0) {
476
- console.error(`Warning: Failed to copy ${filename}`);
477
- } else {
478
- copiedCount++;
479
- }
480
- }
481
-
482
- console.log('');
483
- console.log(`Done. Copied: ${copiedCount}, Skipped: ${skippedCount}`);
484
- }
485
-
486
- /**
487
- * Copies files from source to target on Windows Command Prompt using robocopy.
488
- *
489
- * Uses robocopy which is built into Windows. Robocopy has built-in logic to
490
- * skip files that haven't changed, similar to rsync.
491
- *
492
- * @param {string[]} args - Command line arguments
493
- * @param {string} args[0] - Source folder path (required)
494
- * @param {string} args[1] - Target folder path (required)
495
- * @returns {Promise<void>}
496
- */
497
- async function do_get_folder_cmd(args) {
498
- // Validate arguments
499
- if (!args || args.length < 2) {
500
- console.error('Error: Both source and target folders are required.');
501
- console.error('');
502
- console.error('Usage: get-folder <source-folder> <target-folder>');
503
- console.error('');
504
- console.error('Examples:');
505
- console.error(' get-folder C:\\source\\ D:\\target\\');
506
- console.error(' get-folder %USERPROFILE%\\Downloads\\ D:\\Backup\\');
507
- process.exit(1);
508
- }
509
-
510
- // Normalize paths - remove trailing slashes and convert to Windows format
511
- const sourcePath = args[0].replace(/[\/\\]+$/, '');
512
- const targetPath = args[1].replace(/[\/\\]+$/, '');
513
-
514
- // Validate source directory exists
515
- const sourceValidation = validateDirectory(sourcePath);
516
- if (!sourceValidation.valid) {
517
- console.error(`Error: ${sourceValidation.error}`);
518
- process.exit(1);
519
- }
520
-
521
- // Validate target directory exists
522
- const targetValidation = validateDirectory(targetPath);
523
- if (!targetValidation.valid) {
524
- console.error(`Error: ${targetValidation.error}`);
525
- process.exit(1);
526
- }
527
-
528
- console.log(`Source: ${sourcePath}`);
529
- console.log(`Target: ${targetPath}`);
530
- console.log('');
531
-
532
- // Use robocopy with options to skip unchanged files
533
- // /E = copy subdirectories including empty ones
534
- // /Z = copy files in restartable mode (useful for large files/network)
535
- // /W:1 = wait 1 second between retries
536
- // /R:3 = retry 3 times on failed copies
537
- // /XO = exclude older files (skips if target is same or newer)
538
- // /XX = exclude extra files (don't delete files that don't exist in source)
539
- const result = await shell.spawnAsync('robocopy', [
540
- sourcePath,
541
- targetPath,
542
- '/E',
543
- '/Z',
544
- '/W:1',
545
- '/R:3',
546
- '/XO'
547
- ], {
548
- onStdout: (data) => process.stdout.write(data),
549
- onStderr: (data) => process.stderr.write(data)
550
- });
551
-
552
- // robocopy exit codes: 0-7 are success (0=no files copied, 1=files copied, etc.)
553
- // Exit code 8+ indicates errors
554
- if (result.code >= 8) {
555
- console.error('');
556
- console.error('Error: Copy failed.');
557
- process.exit(1);
558
- }
559
-
560
- console.log('');
561
- console.log('Done.');
562
- }
563
-
564
- /**
565
- * Copies files from source to target on Windows PowerShell using robocopy.
566
- *
567
- * Uses the same robocopy approach as Windows CMD.
568
- *
569
- * @param {string[]} args - Command line arguments
570
- * @param {string} args[0] - Source folder path (required)
571
- * @param {string} args[1] - Target folder path (required)
572
- * @returns {Promise<void>}
573
- */
574
- async function do_get_folder_powershell(args) {
575
- // PowerShell uses the same robocopy approach as CMD
576
- return do_get_folder_cmd(args);
577
- }
578
-
579
- /**
580
- * Copies files from source to target in Git Bash using rsync or robocopy.
581
- *
582
- * Git Bash runs on Windows but can use rsync if it's installed via MSYS2.
583
- * Falls back to robocopy via PowerShell if rsync is not available.
584
- *
585
- * @param {string[]} args - Command line arguments
586
- * @param {string} args[0] - Source folder path (required)
587
- * @param {string} args[1] - Target folder path (required)
588
- * @returns {Promise<void>}
589
- */
590
- async function do_get_folder_gitbash(args) {
591
- // Validate arguments
592
- if (!args || args.length < 2) {
593
- console.error('Error: Both source and target folders are required.');
594
- console.error('');
595
- showUsage();
596
- process.exit(1);
597
- }
598
-
599
- // Check if rsync is available in Git Bash
600
- if (isRsyncAvailable()) {
601
- const sourcePath = ensureTrailingSlash(args[0]);
602
- const targetPath = ensureTrailingSlash(args[1]);
603
-
604
- // Validate source directory exists
605
- const sourceValidation = validateDirectory(sourcePath.slice(0, -1));
606
- if (!sourceValidation.valid) {
607
- console.error(`Error: ${sourceValidation.error}`);
608
- process.exit(1);
609
- }
610
-
611
- // Validate target directory exists
612
- const targetValidation = validateDirectory(targetPath.slice(0, -1));
613
- if (!targetValidation.valid) {
614
- console.error(`Error: ${targetValidation.error}`);
615
- process.exit(1);
616
- }
617
-
618
- console.log(`Source: ${sourcePath}`);
619
- console.log(`Target: ${targetPath}`);
620
- console.log('');
621
-
622
- // Get list of files in source directory
623
- const files = listFiles(sourcePath.slice(0, -1));
624
-
625
- if (files.length === 0) {
626
- console.log('No files found in source directory.');
627
- return;
628
- }
629
-
630
- let copiedCount = 0;
631
- let skippedCount = 0;
632
-
633
- // Process each file
634
- for (const filename of files) {
635
- const sourceFile = path.join(sourcePath, filename);
636
- const targetFile = path.join(targetPath, filename);
637
-
638
- // Check if target file exists
639
- const targetSize = getFileSize(targetFile);
640
-
641
- if (targetSize !== null) {
642
- // Target file exists - compare sizes
643
- const sourceSize = getFileSize(sourceFile);
644
-
645
- if (sourceSize === targetSize) {
646
- console.log(`Skipping ${filename} as it already exists and has the same size.`);
647
- skippedCount++;
648
- continue;
649
- }
650
- }
651
-
652
- // Copy file using rsync with progress
653
- console.log(`Copying ${filename}...`);
654
- const result = await shell.spawnAsync('rsync', [
655
- '-avP',
656
- sourceFile,
657
- targetPath
658
- ], {
659
- onStdout: (data) => process.stdout.write(data),
660
- onStderr: (data) => process.stderr.write(data)
661
- });
662
-
663
- if (result.code !== 0) {
664
- console.error(`Warning: Failed to copy ${filename}`);
665
- } else {
666
- copiedCount++;
667
- }
668
- }
669
-
670
- console.log('');
671
- console.log(`Done. Copied: ${copiedCount}, Skipped: ${skippedCount}`);
672
- } else if (isRobocopyAvailable()) {
673
- // Fall back to robocopy
674
- console.log('rsync not found, using robocopy...');
675
- console.log('');
676
-
677
- // Convert Git Bash paths to Windows paths for robocopy
678
- let sourcePath = args[0].replace(/[\/\\]+$/, '');
679
- let targetPath = args[1].replace(/[\/\\]+$/, '');
680
-
681
- // Convert /c/Users/... to C:\Users\... for robocopy
682
- if (sourcePath.match(/^\/[a-zA-Z]\//)) {
683
- sourcePath = sourcePath.replace(/^\/([a-zA-Z])\//, '$1:\\').replace(/\//g, '\\');
684
- }
685
- if (targetPath.match(/^\/[a-zA-Z]\//)) {
686
- targetPath = targetPath.replace(/^\/([a-zA-Z])\//, '$1:\\').replace(/\//g, '\\');
687
- }
688
-
689
- // Validate directories
690
- const sourceValidation = validateDirectory(sourcePath);
691
- if (!sourceValidation.valid) {
692
- console.error(`Error: ${sourceValidation.error}`);
693
- process.exit(1);
694
- }
695
-
696
- const targetValidation = validateDirectory(targetPath);
697
- if (!targetValidation.valid) {
698
- console.error(`Error: ${targetValidation.error}`);
699
- process.exit(1);
700
- }
701
-
702
- console.log(`Source: ${sourcePath}`);
703
- console.log(`Target: ${targetPath}`);
704
- console.log('');
705
-
706
- // Use robocopy
707
- const result = await shell.spawnAsync('robocopy', [
708
- sourcePath,
709
- targetPath,
710
- '/E',
711
- '/Z',
712
- '/W:1',
713
- '/R:3',
714
- '/XO'
715
- ], {
716
- onStdout: (data) => process.stdout.write(data),
717
- onStderr: (data) => process.stderr.write(data)
718
- });
719
-
720
- if (result.code >= 8) {
721
- console.error('');
722
- console.error('Error: Copy failed.');
723
- process.exit(1);
724
- }
725
-
726
- console.log('');
727
- console.log('Done.');
728
- } else {
729
- console.error('Error: Neither rsync nor robocopy command found.');
730
- console.error('');
731
- console.error('To use rsync in Git Bash, install it via MSYS2 packages.');
732
- console.error('Alternatively, robocopy should be available on Windows systems.');
733
- process.exit(1);
734
- }
735
- }
736
-
737
- /**
738
- * Main entry point - detects environment and executes appropriate implementation.
739
- *
740
- * Copies files from a source directory to a target directory, skipping files
741
- * that already exist in the target with the same size. Uses rsync on Unix-like
742
- * systems (macOS, Linux) and robocopy on Windows.
743
- *
744
- * This is useful for:
745
- * - Syncing folders without copying unchanged files
746
- * - Incremental backups where only changed files need to be copied
747
- * - Copying large folders where some files already exist at the destination
748
- *
749
- * @param {string[]} args - Command line arguments
750
- * @param {string} args[0] - Source folder path (required)
751
- * @param {string} args[1] - Target folder path (required)
752
- * @returns {Promise<void>}
753
- */
754
- async function do_get_folder(args) {
755
- const platform = os.detect();
756
-
757
- const handlers = {
758
- 'macos': do_get_folder_macos,
759
- 'ubuntu': do_get_folder_ubuntu,
760
- 'debian': do_get_folder_ubuntu,
761
- 'raspbian': do_get_folder_raspbian,
762
- 'amazon_linux': do_get_folder_amazon_linux,
763
- 'rhel': do_get_folder_amazon_linux,
764
- 'fedora': do_get_folder_amazon_linux,
765
- 'cmd': do_get_folder_cmd,
766
- 'windows': do_get_folder_cmd,
767
- 'powershell': do_get_folder_powershell,
768
- 'gitbash': do_get_folder_gitbash,
769
- 'wsl': do_get_folder_ubuntu
770
- };
771
-
772
- const handler = handlers[platform.type];
773
- if (!handler) {
774
- console.error(`Platform '${platform.type}' is not supported for this command.`);
775
- console.error('');
776
- console.error('Supported platforms: macOS, Ubuntu, Debian, Raspberry Pi OS,');
777
- console.error('Amazon Linux, RHEL, Fedora, Windows, Git Bash, WSL');
778
- process.exit(1);
779
- }
780
-
781
- await handler(args);
782
- }
783
-
784
- module.exports = {
785
- main: do_get_folder,
786
- do_get_folder,
787
- do_get_folder_nodejs,
788
- do_get_folder_macos,
789
- do_get_folder_ubuntu,
790
- do_get_folder_raspbian,
791
- do_get_folder_amazon_linux,
792
- do_get_folder_cmd,
793
- do_get_folder_powershell,
794
- do_get_folder_gitbash
795
- };
796
-
797
- if (require.main === module) {
798
- do_get_folder(process.argv.slice(2));
799
- }