1 | 'use strict'
|
---|
2 |
|
---|
3 | const fs = require('graceful-fs')
|
---|
4 | const path = require('path')
|
---|
5 | const mkdirs = require('../mkdirs').mkdirs
|
---|
6 | const pathExists = require('../path-exists').pathExists
|
---|
7 | const utimesMillis = require('../util/utimes').utimesMillis
|
---|
8 | const stat = require('../util/stat')
|
---|
9 |
|
---|
10 | function copy (src, dest, opts, cb) {
|
---|
11 | if (typeof opts === 'function' && !cb) {
|
---|
12 | cb = opts
|
---|
13 | opts = {}
|
---|
14 | } else if (typeof opts === 'function') {
|
---|
15 | opts = { filter: opts }
|
---|
16 | }
|
---|
17 |
|
---|
18 | cb = cb || function () {}
|
---|
19 | opts = opts || {}
|
---|
20 |
|
---|
21 | opts.clobber = 'clobber' in opts ? !!opts.clobber : true // default to true for now
|
---|
22 | opts.overwrite = 'overwrite' in opts ? !!opts.overwrite : opts.clobber // overwrite falls back to clobber
|
---|
23 |
|
---|
24 | // Warn about using preserveTimestamps on 32-bit node
|
---|
25 | if (opts.preserveTimestamps && process.arch === 'ia32') {
|
---|
26 | console.warn(`fs-extra: Using the preserveTimestamps option in 32-bit node is not recommended;\n
|
---|
27 | see https://github.com/jprichardson/node-fs-extra/issues/269`)
|
---|
28 | }
|
---|
29 |
|
---|
30 | stat.checkPaths(src, dest, 'copy', (err, stats) => {
|
---|
31 | if (err) return cb(err)
|
---|
32 | const { srcStat, destStat } = stats
|
---|
33 | stat.checkParentPaths(src, srcStat, dest, 'copy', err => {
|
---|
34 | if (err) return cb(err)
|
---|
35 | if (opts.filter) return handleFilter(checkParentDir, destStat, src, dest, opts, cb)
|
---|
36 | return checkParentDir(destStat, src, dest, opts, cb)
|
---|
37 | })
|
---|
38 | })
|
---|
39 | }
|
---|
40 |
|
---|
41 | function checkParentDir (destStat, src, dest, opts, cb) {
|
---|
42 | const destParent = path.dirname(dest)
|
---|
43 | pathExists(destParent, (err, dirExists) => {
|
---|
44 | if (err) return cb(err)
|
---|
45 | if (dirExists) return startCopy(destStat, src, dest, opts, cb)
|
---|
46 | mkdirs(destParent, err => {
|
---|
47 | if (err) return cb(err)
|
---|
48 | return startCopy(destStat, src, dest, opts, cb)
|
---|
49 | })
|
---|
50 | })
|
---|
51 | }
|
---|
52 |
|
---|
53 | function handleFilter (onInclude, destStat, src, dest, opts, cb) {
|
---|
54 | Promise.resolve(opts.filter(src, dest)).then(include => {
|
---|
55 | if (include) return onInclude(destStat, src, dest, opts, cb)
|
---|
56 | return cb()
|
---|
57 | }, error => cb(error))
|
---|
58 | }
|
---|
59 |
|
---|
60 | function startCopy (destStat, src, dest, opts, cb) {
|
---|
61 | if (opts.filter) return handleFilter(getStats, destStat, src, dest, opts, cb)
|
---|
62 | return getStats(destStat, src, dest, opts, cb)
|
---|
63 | }
|
---|
64 |
|
---|
65 | function getStats (destStat, src, dest, opts, cb) {
|
---|
66 | const stat = opts.dereference ? fs.stat : fs.lstat
|
---|
67 | stat(src, (err, srcStat) => {
|
---|
68 | if (err) return cb(err)
|
---|
69 |
|
---|
70 | if (srcStat.isDirectory()) return onDir(srcStat, destStat, src, dest, opts, cb)
|
---|
71 | else if (srcStat.isFile() ||
|
---|
72 | srcStat.isCharacterDevice() ||
|
---|
73 | srcStat.isBlockDevice()) return onFile(srcStat, destStat, src, dest, opts, cb)
|
---|
74 | else if (srcStat.isSymbolicLink()) return onLink(destStat, src, dest, opts, cb)
|
---|
75 | })
|
---|
76 | }
|
---|
77 |
|
---|
78 | function onFile (srcStat, destStat, src, dest, opts, cb) {
|
---|
79 | if (!destStat) return copyFile(srcStat, src, dest, opts, cb)
|
---|
80 | return mayCopyFile(srcStat, src, dest, opts, cb)
|
---|
81 | }
|
---|
82 |
|
---|
83 | function mayCopyFile (srcStat, src, dest, opts, cb) {
|
---|
84 | if (opts.overwrite) {
|
---|
85 | fs.unlink(dest, err => {
|
---|
86 | if (err) return cb(err)
|
---|
87 | return copyFile(srcStat, src, dest, opts, cb)
|
---|
88 | })
|
---|
89 | } else if (opts.errorOnExist) {
|
---|
90 | return cb(new Error(`'${dest}' already exists`))
|
---|
91 | } else return cb()
|
---|
92 | }
|
---|
93 |
|
---|
94 | function copyFile (srcStat, src, dest, opts, cb) {
|
---|
95 | fs.copyFile(src, dest, err => {
|
---|
96 | if (err) return cb(err)
|
---|
97 | if (opts.preserveTimestamps) return handleTimestampsAndMode(srcStat.mode, src, dest, cb)
|
---|
98 | return setDestMode(dest, srcStat.mode, cb)
|
---|
99 | })
|
---|
100 | }
|
---|
101 |
|
---|
102 | function handleTimestampsAndMode (srcMode, src, dest, cb) {
|
---|
103 | // Make sure the file is writable before setting the timestamp
|
---|
104 | // otherwise open fails with EPERM when invoked with 'r+'
|
---|
105 | // (through utimes call)
|
---|
106 | if (fileIsNotWritable(srcMode)) {
|
---|
107 | return makeFileWritable(dest, srcMode, err => {
|
---|
108 | if (err) return cb(err)
|
---|
109 | return setDestTimestampsAndMode(srcMode, src, dest, cb)
|
---|
110 | })
|
---|
111 | }
|
---|
112 | return setDestTimestampsAndMode(srcMode, src, dest, cb)
|
---|
113 | }
|
---|
114 |
|
---|
115 | function fileIsNotWritable (srcMode) {
|
---|
116 | return (srcMode & 0o200) === 0
|
---|
117 | }
|
---|
118 |
|
---|
119 | function makeFileWritable (dest, srcMode, cb) {
|
---|
120 | return setDestMode(dest, srcMode | 0o200, cb)
|
---|
121 | }
|
---|
122 |
|
---|
123 | function setDestTimestampsAndMode (srcMode, src, dest, cb) {
|
---|
124 | setDestTimestamps(src, dest, err => {
|
---|
125 | if (err) return cb(err)
|
---|
126 | return setDestMode(dest, srcMode, cb)
|
---|
127 | })
|
---|
128 | }
|
---|
129 |
|
---|
130 | function setDestMode (dest, srcMode, cb) {
|
---|
131 | return fs.chmod(dest, srcMode, cb)
|
---|
132 | }
|
---|
133 |
|
---|
134 | function setDestTimestamps (src, dest, cb) {
|
---|
135 | // The initial srcStat.atime cannot be trusted
|
---|
136 | // because it is modified by the read(2) system call
|
---|
137 | // (See https://nodejs.org/api/fs.html#fs_stat_time_values)
|
---|
138 | fs.stat(src, (err, updatedSrcStat) => {
|
---|
139 | if (err) return cb(err)
|
---|
140 | return utimesMillis(dest, updatedSrcStat.atime, updatedSrcStat.mtime, cb)
|
---|
141 | })
|
---|
142 | }
|
---|
143 |
|
---|
144 | function onDir (srcStat, destStat, src, dest, opts, cb) {
|
---|
145 | if (!destStat) return mkDirAndCopy(srcStat.mode, src, dest, opts, cb)
|
---|
146 | if (destStat && !destStat.isDirectory()) {
|
---|
147 | return cb(new Error(`Cannot overwrite non-directory '${dest}' with directory '${src}'.`))
|
---|
148 | }
|
---|
149 | return copyDir(src, dest, opts, cb)
|
---|
150 | }
|
---|
151 |
|
---|
152 | function mkDirAndCopy (srcMode, src, dest, opts, cb) {
|
---|
153 | fs.mkdir(dest, err => {
|
---|
154 | if (err) return cb(err)
|
---|
155 | copyDir(src, dest, opts, err => {
|
---|
156 | if (err) return cb(err)
|
---|
157 | return setDestMode(dest, srcMode, cb)
|
---|
158 | })
|
---|
159 | })
|
---|
160 | }
|
---|
161 |
|
---|
162 | function copyDir (src, dest, opts, cb) {
|
---|
163 | fs.readdir(src, (err, items) => {
|
---|
164 | if (err) return cb(err)
|
---|
165 | return copyDirItems(items, src, dest, opts, cb)
|
---|
166 | })
|
---|
167 | }
|
---|
168 |
|
---|
169 | function copyDirItems (items, src, dest, opts, cb) {
|
---|
170 | const item = items.pop()
|
---|
171 | if (!item) return cb()
|
---|
172 | return copyDirItem(items, item, src, dest, opts, cb)
|
---|
173 | }
|
---|
174 |
|
---|
175 | function copyDirItem (items, item, src, dest, opts, cb) {
|
---|
176 | const srcItem = path.join(src, item)
|
---|
177 | const destItem = path.join(dest, item)
|
---|
178 | stat.checkPaths(srcItem, destItem, 'copy', (err, stats) => {
|
---|
179 | if (err) return cb(err)
|
---|
180 | const { destStat } = stats
|
---|
181 | startCopy(destStat, srcItem, destItem, opts, err => {
|
---|
182 | if (err) return cb(err)
|
---|
183 | return copyDirItems(items, src, dest, opts, cb)
|
---|
184 | })
|
---|
185 | })
|
---|
186 | }
|
---|
187 |
|
---|
188 | function onLink (destStat, src, dest, opts, cb) {
|
---|
189 | fs.readlink(src, (err, resolvedSrc) => {
|
---|
190 | if (err) return cb(err)
|
---|
191 | if (opts.dereference) {
|
---|
192 | resolvedSrc = path.resolve(process.cwd(), resolvedSrc)
|
---|
193 | }
|
---|
194 |
|
---|
195 | if (!destStat) {
|
---|
196 | return fs.symlink(resolvedSrc, dest, cb)
|
---|
197 | } else {
|
---|
198 | fs.readlink(dest, (err, resolvedDest) => {
|
---|
199 | if (err) {
|
---|
200 | // dest exists and is a regular file or directory,
|
---|
201 | // Windows may throw UNKNOWN error. If dest already exists,
|
---|
202 | // fs throws error anyway, so no need to guard against it here.
|
---|
203 | if (err.code === 'EINVAL' || err.code === 'UNKNOWN') return fs.symlink(resolvedSrc, dest, cb)
|
---|
204 | return cb(err)
|
---|
205 | }
|
---|
206 | if (opts.dereference) {
|
---|
207 | resolvedDest = path.resolve(process.cwd(), resolvedDest)
|
---|
208 | }
|
---|
209 | if (stat.isSrcSubdir(resolvedSrc, resolvedDest)) {
|
---|
210 | return cb(new Error(`Cannot copy '${resolvedSrc}' to a subdirectory of itself, '${resolvedDest}'.`))
|
---|
211 | }
|
---|
212 |
|
---|
213 | // do not copy if src is a subdir of dest since unlinking
|
---|
214 | // dest in this case would result in removing src contents
|
---|
215 | // and therefore a broken symlink would be created.
|
---|
216 | if (destStat.isDirectory() && stat.isSrcSubdir(resolvedDest, resolvedSrc)) {
|
---|
217 | return cb(new Error(`Cannot overwrite '${resolvedDest}' with '${resolvedSrc}'.`))
|
---|
218 | }
|
---|
219 | return copyLink(resolvedSrc, dest, cb)
|
---|
220 | })
|
---|
221 | }
|
---|
222 | })
|
---|
223 | }
|
---|
224 |
|
---|
225 | function copyLink (resolvedSrc, dest, cb) {
|
---|
226 | fs.unlink(dest, err => {
|
---|
227 | if (err) return cb(err)
|
---|
228 | return fs.symlink(resolvedSrc, dest, cb)
|
---|
229 | })
|
---|
230 | }
|
---|
231 |
|
---|
232 | module.exports = copy
|
---|