@11ty/recursive-copy

临时叉子 timkendrick/recursive-copy 满足 https://github.com/11ty/eleventy/issues/3299 互联网档案馆的存檔,存档日期2013-12-02 慢慢的十一点 移动以使用节点本地 API fs.cp。 。 。 .

• v5.x 需要节点 20+
• v4.x 需要节点 18+
• v3.x需要节点0.10+
• v2.x需要节点0.10+

简单而灵活的文件副本工具

特征

• 连续复制整个目录等级
• 通过传递过滤函数、正则表达式或 glob 选择哪些文件被复制
• 动态重命名文件,包括更改输出路径
• 使用流转换文件内容
• 选择是否覆盖已存在文件
• 选择是否复制系统文件
• 过滤出 垃圾 默认文件
• 为处理的每个文件发送开始、完成和出错事件
• 基于承诺的可选界面

实例

节点风格的回调接口

var copy = require('@11ty/recursive-copy');

copy('src', 'dest', function(error, results) {
    if (error) {
        console.error('Copy failed: ' + error);
    } else {
        console.info('Copied ' + results.length + ' files');
    }
});

承诺接口

var copy = require('@11ty/recursive-copy');

copy('src', 'dest')
    .then(function(results) {
        console.info('Copied ' + results.length + ' files');
    })
    .catch(function(error) {
        console.error('Copy failed: ' + error);
    });

ES2015+ 使用量

import copy from '@11ty/recursive-copy';

try {
    const results = await copy('src', 'dest');
    console.info('Copied ' + results.length + ' files');
} catch (error) {
    console.error('Copy failed: ' + error);
}

高级选项

var copy = require('@11ty/recursive-copy');

var path = require('path');
var through = require('through2');

var options = {
    overwrite: true,
    expand: true,
    dot: true,
    junk: true,
    filter: [
        '**/*',
        '!.htpasswd'
    ],
    rename: function(filePath) {
        return filePath + '.orig';
    },
    transform: function(src, dest, stats) {
        if (path.extname(src) !== '.txt') { return null; }
        return through(function(chunk, enc, done)  {
            var output = chunk.toString().toUpperCase();
            done(null, output);
        });
    }
};

copy('src', 'dest', options)
    .on(copy.events.COPY_FILE_START, function(copyOperation) {
        console.info('Copying file ' + copyOperation.src + '...');
    })
    .on(copy.events.COPY_FILE_COMPLETE, function(copyOperation) {
        console.info('Copied to ' + copyOperation.dest);
    })
    .on(copy.events.ERROR, function(error, copyOperation) {
        console.error('Unable to copy ' + copyOperation.dest);
    })
    .then(function(results) {
        console.info(results.length + ' file(s) copied');
    })
    .catch(function(error) {
        return console.error('Copy failed: ' + error);
    });

使用量

copy(src, dest, [options], [callback])

递归复制文件和文件夹 src 改为 dest

参数 :

回返情况:

Promise<Array> 承诺, 以一系列复制结果实现 :

[
    {
        "src": "/path/to/src",
        "dest": "/path/to/dest",
        "stats": <Stats>
    },
    {
        "src": "/path/to/src/file.txt",
        "dest": "/path/to/dest/file.txt",
        "stats": <Stats>
    },
    {
        "src": "/path/to/src/subfolder",
        "dest": "/path/to/dest/subfolder",
        "stats": <Stats>
    },
    {
        "src": "/path/to/src/subfolder/nested.txt",
        "dest": "/path/to/dest/subfolder/nested.txt",
        "stats": <Stats>
    }
]

copy.shouldCopy(filePath, [options])

返回是否为 dot 财务报告和审定财务报表 junk 选项保存一个文件,对照其基准名检查(filter (不应用).

copy.shouldCopy('src/.DS_Store', { dot: true }); // false
copy.shouldCopy('src/.htaccess', { dot: true }); // true

活动

返回的值 copy 函数执行 EventEmitter 界面,并释放以下事件:

...如果处理器签名中提到的类型如下:

ErrorInfo

CopyOperation