// Copyright 2018-2022 the Deno authors. All rights reserved. MIT license. /** * Tar test * * **test summary** * - create a tar archive in memory containing output.txt and dir/tar.ts. * - read and deflate a tar archive containing output.txt * * **to run this test** * deno run --allow-read archive/tar_test.ts */ import { assert, assertEquals, assertExists } from "../testing/asserts.ts"; import { dirname, fromFileUrl, resolve } from "../path/mod.ts"; import { Tar, TarEntry, Untar } from "./tar.ts"; import type { TarEntry as TarEntryType, TarHeader, TarMeta } from "./tar.ts"; import { Buffer } from "../io/buffer.ts"; import { copy, readAll } from "../streams/conversion.ts"; const moduleDir = dirname(fromFileUrl(import.meta.url)); const testdataDir = resolve(moduleDir, "testdata"); const filePath = resolve(testdataDir, "example.txt"); interface TestEntry { name: string; content?: Uint8Array; filePath?: string; } async function createTar(entries: TestEntry[]): Promise { const tar = new Tar(); // put data on memory for (const file of entries) { let options; if (file.content) { options = { reader: new Buffer(file.content), contentSize: file.content.byteLength, }; } else { options = { filePath: file.filePath }; } await tar.append(file.name, options); } return tar; } Deno.test("createTarArchive", async function () { // initialize const tar = new Tar(); // put data on memory const content = new TextEncoder().encode("hello tar world!"); await tar.append("output.txt", { reader: new Buffer(content), contentSize: content.byteLength, }); // put a file await tar.append("dir/tar.ts", { filePath }); // write tar data to a buffer const writer = new Buffer(); const wrote = await copy(tar.getReader(), writer); /** * 3072 = 512 (header) + 512 (content) + 512 (header) + 512 (content) * + 1024 (footer) */ assertEquals(wrote, 3072); }); Deno.test("deflateTarArchive", async function () { const fileName = "output.txt"; const text = "hello tar world!"; // create a tar archive const tar = new Tar(); const content = new TextEncoder().encode(text); await tar.append(fileName, { reader: new Buffer(content), contentSize: content.byteLength, }); // read data from a tar archive const untar = new Untar(tar.getReader()); const result = await untar.extract(); assert(result !== null); const untarText = new TextDecoder("utf-8").decode(await readAll(result)); assertEquals(await untar.extract(), null); // EOF // tests assertEquals(result.fileName, fileName); assertEquals(untarText, text); }); Deno.test("appendFileWithLongNameToTarArchive", async function (): Promise< void > { // 9 * 15 + 13 = 148 bytes const fileName = "long-file-name/".repeat(10) + "file-name.txt"; const text = "hello tar world!"; // create a tar archive const tar = new Tar(); const content = new TextEncoder().encode(text); await tar.append(fileName, { reader: new Buffer(content), contentSize: content.byteLength, }); // read data from a tar archive const untar = new Untar(tar.getReader()); const result = await untar.extract(); assert(result !== null); assert(!result.consumed); const untarText = new TextDecoder("utf-8").decode(await readAll(result)); assert(result.consumed); // tests assertEquals(result.fileName, fileName); assertEquals(untarText, text); }); Deno.test("untarAsyncIterator", async function () { const entries: TestEntry[] = [ { name: "output.txt", content: new TextEncoder().encode("hello tar world!"), }, { name: "dir/tar.ts", filePath, }, ]; const tar = await createTar(entries); // read data from a tar archive const untar = new Untar(tar.getReader()); let lastEntry; for await (const entry of untar) { const expected = entries.shift(); assert(expected); let content = expected.content; if (expected.filePath) { content = await Deno.readFile(expected.filePath); } assertEquals(content, await readAll(entry)); assertEquals(expected.name, entry.fileName); if (lastEntry) assert(lastEntry.consumed); lastEntry = entry; } assert(lastEntry); assert(lastEntry.consumed); assertEquals(entries.length, 0); }); Deno.test("untarAsyncIteratorWithoutReadingBody", async function (): Promise< void > { const entries: TestEntry[] = [ { name: "output.txt", content: new TextEncoder().encode("hello tar world!"), }, { name: "dir/tar.ts", filePath, }, ]; const tar = await createTar(entries); // read data from a tar archive const untar = new Untar(tar.getReader()); for await (const entry of untar) { const expected = entries.shift(); assert(expected); assertEquals(expected.name, entry.fileName); } assertEquals(entries.length, 0); }); Deno.test( "untarAsyncIteratorWithoutReadingBodyFromFileReader", async function () { const entries: TestEntry[] = [ { name: "output.txt", content: new TextEncoder().encode("hello tar world!"), }, { name: "dir/tar.ts", filePath, }, ]; const outputFile = resolve(testdataDir, "test.tar"); const tar = await createTar(entries); const file = await Deno.open(outputFile, { create: true, write: true }); await copy(tar.getReader(), file); file.close(); const reader = await Deno.open(outputFile, { read: true }); // read data from a tar archive const untar = new Untar(reader); for await (const entry of untar) { const expected = entries.shift(); assert(expected); assertEquals(expected.name, entry.fileName); } reader.close(); await Deno.remove(outputFile); assertEquals(entries.length, 0); }, ); Deno.test("untarAsyncIteratorFromFileReader", async function () { const entries: TestEntry[] = [ { name: "output.txt", content: new TextEncoder().encode("hello tar world!"), }, { name: "dir/tar.ts", filePath, }, ]; const outputFile = resolve(testdataDir, "test.tar"); const tar = await createTar(entries); const file = await Deno.open(outputFile, { create: true, write: true }); await copy(tar.getReader(), file); file.close(); const reader = await Deno.open(outputFile, { read: true }); // read data from a tar archive const untar = new Untar(reader); for await (const entry of untar) { const expected = entries.shift(); assert(expected); let content = expected.content; if (expected.filePath) { content = await Deno.readFile(expected.filePath); } assertEquals(content, await readAll(entry)); assertEquals(expected.name, entry.fileName); } reader.close(); await Deno.remove(outputFile); assertEquals(entries.length, 0); }); Deno.test( "untarAsyncIteratorReadingLessThanRecordSize", async function () { // record size is 512 const bufSizes = [1, 53, 256, 511]; for (const bufSize of bufSizes) { const entries: TestEntry[] = [ { name: "output.txt", content: new TextEncoder().encode("hello tar world!".repeat(100)), }, // Need to test at least two files, to make sure the first entry doesn't over-read // Causing the next to fail with: checksum error { name: "deni.txt", content: new TextEncoder().encode("deno!".repeat(250)), }, ]; const tar = await createTar(entries); // read data from a tar archive const untar = new Untar(tar.getReader()); for await (const entry of untar) { const expected = entries.shift(); assert(expected); assertEquals(expected.name, entry.fileName); const writer = new Buffer(); while (true) { const buf = new Uint8Array(bufSize); const n = await entry.read(buf); if (n === null) break; await writer.write(buf.subarray(0, n)); } assertEquals(writer.bytes(), expected!.content); } assertEquals(entries.length, 0); } }, ); Deno.test("untarLinuxGeneratedTar", async function () { const filePath = resolve(testdataDir, "deno.tar"); const file = await Deno.open(filePath, { read: true }); type ExpectedEntry = TarMeta & { content?: Uint8Array }; const expectedEntries: ExpectedEntry[] = [ { fileName: "archive/", fileSize: 0, fileMode: 509, mtime: 1591800767, uid: 1001, gid: 1001, owner: "deno", group: "deno", type: "directory", }, { fileName: "archive/deno/", fileSize: 0, fileMode: 509, mtime: 1591799635, uid: 1001, gid: 1001, owner: "deno", group: "deno", type: "directory", }, { fileName: "archive/deno/land/", fileSize: 0, fileMode: 509, mtime: 1591799660, uid: 1001, gid: 1001, owner: "deno", group: "deno", type: "directory", }, { fileName: "archive/deno/land/land.txt", fileMode: 436, fileSize: 5, mtime: 1591799660, uid: 1001, gid: 1001, owner: "deno", group: "deno", type: "file", content: new TextEncoder().encode("land\n"), }, { fileName: "archive/file.txt", fileMode: 436, fileSize: 5, mtime: 1591799626, uid: 1001, gid: 1001, owner: "deno", group: "deno", type: "file", content: new TextEncoder().encode("file\n"), }, { fileName: "archive/deno.txt", fileMode: 436, fileSize: 5, mtime: 1591799642, uid: 1001, gid: 1001, owner: "deno", group: "deno", type: "file", content: new TextEncoder().encode("deno\n"), }, ]; const untar = new Untar(file); for await (const entry of untar) { const expected = expectedEntries.shift(); assert(expected); const content = expected.content; delete expected.content; assertEquals({ ...entry }, expected); if (content) { assertEquals(content, await readAll(entry)); } } file.close(); }); Deno.test("directoryEntryType", async function () { const tar = new Tar(); tar.append("directory/", { reader: new Buffer(), contentSize: 0, type: "directory", }); const filePath = resolve(testdataDir); tar.append("archive/testdata/", { filePath, }); const outputFile = resolve(testdataDir, "directory_type_test.tar"); const file = await Deno.open(outputFile, { create: true, write: true }); await copy(tar.getReader(), file); file.close(); const reader = await Deno.open(outputFile, { read: true }); const untar = new Untar(reader); for await (const entry of untar) { assertEquals(entry.type, "directory"); } reader.close(); await Deno.remove(outputFile); }); Deno.test({ name: "test TarEntry", // only: true, fn() { // test TarEntry class assertExists(TarEntry); // Test TarEntry type const bufSizes = [1, 53, 256, 511]; const header: TarHeader = { test: new Uint8Array(bufSizes), }; const content = new TextEncoder().encode("hello tar world!"); const reader = new Buffer(content); const tarMeta = { fileName: "archive/", fileSize: 0, fileMode: 509, mtime: 1591800767, uid: 1001, gid: 1001, owner: "deno", group: "deno", type: "directory", }; const tarEntry: TarEntryType = new TarEntry(tarMeta, header, reader); assertExists(tarEntry); }, });