{"name":"tar","description":"tar for node","dist-tags":{"latest":"6.2.1"},"versions":{"6.2.1":{"name":"tar","version":"6.2.1","author":{"name":"GitHub Inc."},"license":"ISC","_id":"tar@6.2.1","bugs":{"url":"https://github.com/isaacs/node-tar/issues"},"tap":{"nyc-arg":["--exclude","tap-snapshots/**"],"timeout":0,"coverage-map":"map.js"},"dist":{"shasum":"717549c541bc3c2af15751bea94b1dd068d4b03a","tarball":"http://localhost:4260/tar/tar-6.2.1.tgz","fileCount":29,"integrity":"sha512-DZ4yORTwrbTj/7MZYq2w+/ZFdI6OZ/f9SFHR+71gIVUZhOQPHzVCLpvRnPgyaMpfWxxk/4ONva3GQSyNIKRv6A==","signatures":[{"sig":"MEQCICiN57b6g7ZWCQN3sRJ+KpQedOYvNEmp0rJiwyGiT6ilAiA92/r4ohXAxTc9ATTxiPbhsnqxFx5d2WFp4qzPVMI+cA==","keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA"}],"unpackedSize":166613},"engines":{"node":">=10"},"gitHead":"c65f76d89a69a4c0d2a1e3ab97c289ce965f6476","scripts":{"snap":"tap","test":"tap","genparse":"node scripts/generate-parse-fixtures.js"},"repository":{"url":"git+https://github.com/isaacs/node-tar.git","type":"git"},"_npmVersion":"10.5.0","description":"tar for node","directories":{},"templateOSS":{"content":"scripts/template-oss","engines":">=10","version":"4.11.0","distPaths":["index.js"],"allowPaths":["/index.js"],"ciVersions":["10.x","12.x","14.x","16.x","18.x"],"//@npmcli/template-oss":"This file is partially managed by @npmcli/template-oss. Edits may be overwritten."},"_nodeVersion":"20.11.0","dependencies":{"chownr":"^2.0.0","mkdirp":"^1.0.3","yallist":"^4.0.0","minipass":"^5.0.0","minizlib":"^2.1.1","fs-minipass":"^2.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tap":"^16.0.1","nock":"^13.2.9","chmodr":"^1.2.0","rimraf":"^3.0.2","mutate-fs":"^2.1.1","end-of-stream":"^1.4.3","events-to-array":"^2.0.3","@npmcli/template-oss":"4.11.0","@npmcli/eslint-config":"^4.0.0"}}},"author":{"name":"GitHub Inc."},"repository":{"type":"git","url":"git+https://github.com/isaacs/node-tar.git"},"license":"ISC","homepage":"https://github.com/isaacs/node-tar#readme","bugs":{"url":"https://github.com/isaacs/node-tar/issues"},"readme":"# node-tar\n\nFast and full-featured Tar for Node.js\n\nThe API is designed to mimic the behavior of `tar(1)` on unix systems.\nIf you are familiar with how tar works, most of this will hopefully be\nstraightforward for you. If not, then hopefully this module can teach\nyou useful unix skills that may come in handy someday :)\n\n## Background\n\nA \"tar file\" or \"tarball\" is an archive of file system entries\n(directories, files, links, etc.) The name comes from \"tape archive\".\nIfyourun`mantar`onalmostanyUnixcommandline,you'lllearn\nquiteabitaboutwhatitcando,anditshistory.\n\nTarhas5maintop-levelcommands:\n\n-`c`Createanarchive\n-`r`Replaceentrieswithinanarchive\n-`u`Updateentrieswithinanarchive(ie,replaceifthey'renewer)\n-`t`Listoutthecontentsofanarchive\n-`x`Extractanarchivetodisk\n\nTheotherflagsandoptionsmodifyhowthistoplevelfunctionworks.\n\n##High-LevelAPI\n\nThese5functionsarethehigh-levelAPI.Allofthemhavea\nsingle-charactername(forunixnerdsfamiliarwith`tar(1)`)aswell\nasalongname(foreveryoneelse).\n\nAllthehigh-levelfunctionstakethefollowingarguments,allthree\nofwhichareoptionalandmaybeomitted.\n\n1.`options`-Anoptionalobjectspecifyingvariousoptions\n2.`paths`-Anarrayofpathstoaddorextract\n3.`callback`-Calledwhenthecommandiscompleted,ifasync.(If\nsyncornofilespecified,providingacallbackthrowsa\n`TypeError`.)\n\nIfthecommandissync(ie,if`options.sync=true`),thenthe\ncallbackisnotallowed,sincetheactionwillbecompletedimmediately.\n\nIfa`file`argumentisspecified,andthecommandisasync,thena\n`Promise`isreturned.Inthiscase,ifasync,acallbackmaybe\nprovidedwhichiscalledwhenthecommandiscompleted.\n\nIfa`file`optionisnotspecified,thenastreamisreturned.For\n`create`,thisisareadablestreamofthegeneratedarchive.For\n`list`and`extract`thisisawritablestreamthatanarchi