1 | 'use strict'
|
---|
2 |
|
---|
3 | const fs = require('graceful-fs')
|
---|
4 | const path = require('path')
|
---|
5 | const mkdirsSync = require('../mkdirs').mkdirsSync
|
---|
6 | const utimesMillisSync = require('../util/utimes').utimesMillisSync
|
---|
7 | const stat = require('../util/stat')
|
---|
8 |
|
---|
9 | function copySync (src, dest, opts) {
|
---|
10 | if (typeof opts === 'function') {
|
---|
11 | opts = { filter: opts }
|
---|
12 | }
|
---|
13 |
|
---|
14 | opts = opts || {}
|
---|
15 | opts.clobber = 'clobber' in opts ? !!opts.clobber : true // default to true for now
|
---|
16 | opts.overwrite = 'overwrite' in opts ? !!opts.overwrite : opts.clobber // overwrite falls back to clobber
|
---|
17 |
|
---|
18 | // Warn about using preserveTimestamps on 32-bit node
|
---|
19 | if (opts.preserveTimestamps && process.arch === 'ia32') {
|
---|
20 | console.warn(`fs-extra: Using the preserveTimestamps option in 32-bit node is not recommended;\n
|
---|
21 | see https://github.com/jprichardson/node-fs-extra/issues/269`)
|
---|
22 | }
|
---|
23 |
|
---|
24 | const { srcStat, destStat } = stat.checkPathsSync(src, dest, 'copy')
|
---|
25 | stat.checkParentPathsSync(src, srcStat, dest, 'copy')
|
---|
26 | return handleFilterAndCopy(destStat, src, dest, opts)
|
---|
27 | }
|
---|
28 |
|
---|
29 | function handleFilterAndCopy (destStat, src, dest, opts) {
|
---|
30 | if (opts.filter && !opts.filter(src, dest)) return
|
---|
31 | const destParent = path.dirname(dest)
|
---|
32 | if (!fs.existsSync(destParent)) mkdirsSync(destParent)
|
---|
33 | return startCopy(destStat, src, dest, opts)
|
---|
34 | }
|
---|
35 |
|
---|
36 | function startCopy (destStat, src, dest, opts) {
|
---|
37 | if (opts.filter && !opts.filter(src, dest)) return
|
---|
38 | return getStats(destStat, src, dest, opts)
|
---|
39 | }
|
---|
40 |
|
---|
41 | function getStats (destStat, src, dest, opts) {
|
---|
42 | const statSync = opts.dereference ? fs.statSync : fs.lstatSync
|
---|
43 | const srcStat = statSync(src)
|
---|
44 |
|
---|
45 | if (srcStat.isDirectory()) return onDir(srcStat, destStat, src, dest, opts)
|
---|
46 | else if (srcStat.isFile() ||
|
---|
47 | srcStat.isCharacterDevice() ||
|
---|
48 | srcStat.isBlockDevice()) return onFile(srcStat, destStat, src, dest, opts)
|
---|
49 | else if (srcStat.isSymbolicLink()) return onLink(destStat, src, dest, opts)
|
---|
50 | }
|
---|
51 |
|
---|
52 | function onFile (srcStat, destStat, src, dest, opts) {
|
---|
53 | if (!destStat) return copyFile(srcStat, src, dest, opts)
|
---|
54 | return mayCopyFile(srcStat, src, dest, opts)
|
---|
55 | }
|
---|
56 |
|
---|
57 | function mayCopyFile (srcStat, src, dest, opts) {
|
---|
58 | if (opts.overwrite) {
|
---|
59 | fs.unlinkSync(dest)
|
---|
60 | return copyFile(srcStat, src, dest, opts)
|
---|
61 | } else if (opts.errorOnExist) {
|
---|
62 | throw new Error(`'${dest}' already exists`)
|
---|
63 | }
|
---|
64 | }
|
---|
65 |
|
---|
66 | function copyFile (srcStat, src, dest, opts) {
|
---|
67 | fs.copyFileSync(src, dest)
|
---|
68 | if (opts.preserveTimestamps) handleTimestamps(srcStat.mode, src, dest)
|
---|
69 | return setDestMode(dest, srcStat.mode)
|
---|
70 | }
|
---|
71 |
|
---|
72 | function handleTimestamps (srcMode, src, dest) {
|
---|
73 | // Make sure the file is writable before setting the timestamp
|
---|
74 | // otherwise open fails with EPERM when invoked with 'r+'
|
---|
75 | // (through utimes call)
|
---|
76 | if (fileIsNotWritable(srcMode)) makeFileWritable(dest, srcMode)
|
---|
77 | return setDestTimestamps(src, dest)
|
---|
78 | }
|
---|
79 |
|
---|
80 | function fileIsNotWritable (srcMode) {
|
---|
81 | return (srcMode & 0o200) === 0
|
---|
82 | }
|
---|
83 |
|
---|
84 | function makeFileWritable (dest, srcMode) {
|
---|
85 | return setDestMode(dest, srcMode | 0o200)
|
---|
86 | }
|
---|
87 |
|
---|
88 | function setDestMode (dest, srcMode) {
|
---|
89 | return fs.chmodSync(dest, srcMode)
|
---|
90 | }
|
---|
91 |
|
---|
92 | function setDestTimestamps (src, dest) {
|
---|
93 | // The initial srcStat.atime cannot be trusted
|
---|
94 | // because it is modified by the read(2) system call
|
---|
95 | // (See https://nodejs.org/api/fs.html#fs_stat_time_values)
|
---|
96 | const updatedSrcStat = fs.statSync(src)
|
---|
97 | return utimesMillisSync(dest, updatedSrcStat.atime, updatedSrcStat.mtime)
|
---|
98 | }
|
---|
99 |
|
---|
100 | function onDir (srcStat, destStat, src, dest, opts) {
|
---|
101 | if (!destStat) return mkDirAndCopy(srcStat.mode, src, dest, opts)
|
---|
102 | if (destStat && !destStat.isDirectory()) {
|
---|
103 | throw new Error(`Cannot overwrite non-directory '${dest}' with directory '${src}'.`)
|
---|
104 | }
|
---|
105 | return copyDir(src, dest, opts)
|
---|
106 | }
|
---|
107 |
|
---|
108 | function mkDirAndCopy (srcMode, src, dest, opts) {
|
---|
109 | fs.mkdirSync(dest)
|
---|
110 | copyDir(src, dest, opts)
|
---|
111 | return setDestMode(dest, srcMode)
|
---|
112 | }
|
---|
113 |
|
---|
114 | function copyDir (src, dest, opts) {
|
---|
115 | fs.readdirSync(src).forEach(item => copyDirItem(item, src, dest, opts))
|
---|
116 | }
|
---|
117 |
|
---|
118 | function copyDirItem (item, src, dest, opts) {
|
---|
119 | const srcItem = path.join(src, item)
|
---|
120 | const destItem = path.join(dest, item)
|
---|
121 | const { destStat } = stat.checkPathsSync(srcItem, destItem, 'copy')
|
---|
122 | return startCopy(destStat, srcItem, destItem, opts)
|
---|
123 | }
|
---|
124 |
|
---|
125 | function onLink (destStat, src, dest, opts) {
|
---|
126 | let resolvedSrc = fs.readlinkSync(src)
|
---|
127 | if (opts.dereference) {
|
---|
128 | resolvedSrc = path.resolve(process.cwd(), resolvedSrc)
|
---|
129 | }
|
---|
130 |
|
---|
131 | if (!destStat) {
|
---|
132 | return fs.symlinkSync(resolvedSrc, dest)
|
---|
133 | } else {
|
---|
134 | let resolvedDest
|
---|
135 | try {
|
---|
136 | resolvedDest = fs.readlinkSync(dest)
|
---|
137 | } catch (err) {
|
---|
138 | // dest exists and is a regular file or directory,
|
---|
139 | // Windows may throw UNKNOWN error. If dest already exists,
|
---|
140 | // fs throws error anyway, so no need to guard against it here.
|
---|
141 | if (err.code === 'EINVAL' || err.code === 'UNKNOWN') return fs.symlinkSync(resolvedSrc, dest)
|
---|
142 | throw err
|
---|
143 | }
|
---|
144 | if (opts.dereference) {
|
---|
145 | resolvedDest = path.resolve(process.cwd(), resolvedDest)
|
---|
146 | }
|
---|
147 | if (stat.isSrcSubdir(resolvedSrc, resolvedDest)) {
|
---|
148 | throw new Error(`Cannot copy '${resolvedSrc}' to a subdirectory of itself, '${resolvedDest}'.`)
|
---|
149 | }
|
---|
150 |
|
---|
151 | // prevent copy if src is a subdir of dest since unlinking
|
---|
152 | // dest in this case would result in removing src contents
|
---|
153 | // and therefore a broken symlink would be created.
|
---|
154 | if (fs.statSync(dest).isDirectory() && stat.isSrcSubdir(resolvedDest, resolvedSrc)) {
|
---|
155 | throw new Error(`Cannot overwrite '${resolvedDest}' with '${resolvedSrc}'.`)
|
---|
156 | }
|
---|
157 | return copyLink(resolvedSrc, dest)
|
---|
158 | }
|
---|
159 | }
|
---|
160 |
|
---|
161 | function copyLink (resolvedSrc, dest) {
|
---|
162 | fs.unlinkSync(dest)
|
---|
163 | return fs.symlinkSync(resolvedSrc, dest)
|
---|
164 | }
|
---|
165 |
|
---|
166 | module.exports = copySync
|
---|