我在remotion源代码中发现了一个名为“degit”的文件。
remotion 可帮助您以编程方式制作视频。
在本文中,我们将了解以下概念:
我记得在开源的自述文件中看到过“degit”,但我不记得它是哪个存储库,所以我在谷歌上搜索了 degit 的含义并找到了这个 degit npm 包。
简单来说,您可以使用 degit 只需下载最新的提交即可快速复制 github 存储库
而不是整个 git 历史记录。
访问 degit 官方 npm 包以了解有关此包的更多信息。
您也可以使用此 degit 包从 gitlab 或 bitbucket 下载存储库,因此它不仅限于 github 存储库。
# download from gitlab degit gitlab:user/repo # download from bitbucket degit bitbucket:user/repo degit user/repo # these commands are equivalent degit github:user/repo
这是 javascript 中的示例用法:
const degit = require('degit'); const emitter = degit('user/repo', { cache: true, force: true, verbose: true, }); emitter.on('info', info => { console.log(info.message); }); emitter.clone('path/to/dest').then(() => { console.log('done'); });
要了解如何构建简单的 degit 函数,让我们分解 remotion 的 degit.ts 文件中的代码。该文件实现了 degit npm 包的基本版本:获取 github 存储库的最新状态,而不下载完整的历史记录。
import https from 'https'; import fs from 'node:fs'; import {tmpdir} from 'node:os'; import path from 'node:path'; import tar from 'tar'; import {mkdirp} from './mkdirp';
export function fetch(url: string, dest: string) { return new promise<void>((resolve, reject) => { https.get(url, (response) => { const code = response.statuscode as number; if (code >= 400) { reject( new error( `network request to ${url} failed with code ${code} (${response.statusmessage})`, ), ); } else if (code >= 300) { fetch(response.headers.location as string, dest) .then(resolve) .catch(reject); } else { response .pipe(fs.createwritestream(dest)) .on('finish', () => resolve()) .on('error', reject); } }).on('error', reject); }); } </void>
下载存储库后,需要提取tarball的内容:
function untar(file: string, dest: string) { return tar.extract( { file, strip: 1, c: dest, }, [], ); }
主要 degit 函数将所有内容联系在一起,处理目录创建、获取和提取存储库:
export const degit = async ({ repoorg, reponame, dest, }: { repoorg: string; reponame: string; dest: string; }) => { const base = path.join(tmpdir(), '.degit'); const dir = path.join(base, repoorg, reponame); const file = `${dir}/head.tar.gz`; const url = `https://github.com/${repoorg}/${reponame}/archive/head.tar.gz`; mkdirp(path.dirname(file)); await fetch(url, file); mkdirp(dest); await untar(file, dest); fs.unlinksync(file); };
mkdirp 用于创建
递归地目录。
我发现remotion在你运行安装命令时使用degit来下载模板:
npx create-video@latest
这个命令要求你选择一个模板,这就是degit开始下载的地方
所选模板的最新提交
您可以从create-video包中查看此代码作为证明。
获得受开源最佳实践启发的免费课程。
网站:https://ramunarasinga.com/
linkedin:https://www.linkedin.com/in/ramu-narasinga-189361128/
github:https://github.com/ramu-narasinga
邮箱:ramu.narasinga@gmail.com
学习开源中使用的最佳实践。