Nuptial Predicament Mediation

    szip
    TypeScript icon, indicating that this package has built-in type declarations

    1.0.3 • Public • Published

    Szip

    An event based 7zip wrapper for nodejs.

    Installation

    npm i szip
    

    Events

    Most of the functions in this package are event based. Here are some events which you have to use to get the data while in operation.

    EVENT.PROGRESS

    This event receives how much operation has been done in %.

    const { SevenZip, EVENT } =  require("szip");
    
    // Instance created
    const szip = new SevenZip();
    
    szip.on(EVENT.PROGRESS, (data) => {
    	console.log(`Done :: ${data}%`);
    });
    

    EVENT.FINISH

    This event receives when operation finished.

    const { SevenZip, EVENT } =  require("szip");
    
    // Instance created
    const szip = new SevenZip();
    
    szip.on(EVENT.FINISH, (data) => {
    	// 	data.err {string | number} contains error message
    	// 	data.buffer {string} containes stdout buffer of the operation
    	// 	data.payload {object} contains any information about result.
    });
    

    Basic Execution function

    By using this function you can execute any 7zip cli commands.

    • run()
    • run_async()

    Example run()

    const { SevenZip, EVENT } = require("szip");
    
    const szip = new SevenZip();
    
    szip.on(EVENT.PROGRESS, (data) => {
        console.log(`Done :: ${data}%`);
    });
    
    szip.on(EVENT.FINISH, (data) => {
        if (data.err) {
            console.log(data.err);
        } else {
            console.log(data.payload);
            console.log(`Successfull Operation. Exit Code :: ${data.err}`);
        }
    });
    
    szip.run(`t "index.zip"`);
    

    Example run_async()

    const { SevenZip, EVENT } = require("szip");
    
    const szip = new SevenZip();
    
    szip.run_async(`t "./index.zip"`).then((data) => {
        console.log(data);
    }).catch((err) => {
        console.log(err);
    });
    

    Note: You don't have to put binary name into args parameter.

    High Level functions

    These functions are created for easier implementation of 7zip. Currently package have these operations in this category,

    • Extract
    • Add Archive
    • Genarate Hash
    • Test Integrity of Archive

    Extract File

    To extract a file you have use extract function from sevenzip class. Here is an example below,

    const { SevenZip, EVENT } =  require("szip");
    
    const szip = new SevenZip();
    
    szip.on(EVENT.PROGRESS, (data) => {
    	console.log(`Done :: ${data}%`);
    });
    
    szip.on(EVENT.FINISH, (data) => {
    	if (data.err) {
    		console.log(data.err);
    	} else {
    		console.log(`Successfull Operation. Exit Code :: ${data.err}`);
    	}
    });
    
    // For normal archives
    szip.extract("h.7z", "./extract/*");
    
    // Use option for encrypted archives
    szip.extract("h.7z", "./extract/*", {password:  "123@password"});
    

    Create Archive

    To create an archive you have to use create.{archivesType}() List of supported archive

    • 7z - create.sevenz() or create.sevenz_async()
    • zip - create.zip() or create.zip_async()
    • gz - create.gzip() or create.gzip_async()
    • bzip2 - create.bzip2() or create.bzip2_async()
    • tar - create.tar() or create.tar_async()
    • wim - create.wim() or create.wim_async()
    • xz - create.xz() or create.xz_async()

    Note: Each function have different option parameters because each archive types doesn't support every features like pasword, encrpyted file name or maybe compression method etc.

    Example of creating an archive using password + encrypted filenames

    const { SevenZip, EVENT } =  require("szip");
    
    const szip = new SevenZip();
    
    szip.on(EVENT.PROGRESS, (data) => {
    	console.log(`Done :: ${data}%`);
    });
    
    szip.on(EVENT.FINISH, (data) => {
    	if (data.err) {
    		console.log(data.err);
    	} else {
    		console.log(`Successfull Operation. Exit Code :: ${data.err}`);
    	}
    });
    
    szip.create.sevenz("h.7z", "./*", {
    	compression_method: SevenZ_Method.LZMA2,
    	compression_level: SevenZ_Level.MAXIMUM,
    	encrypt: true,
    	encrypt_name: true,
    	password: "hello",
    });
    

    Generate Hash of File

    To genarate hash of file, you have to use hash() or hash_async()

    Example hash()

    const { SevenZip, EVENT, Hasher } =  require("szip");
    
    const szip = new SevenZip();
    
    szip.on(EVENT.PROGRESS, (data) => {
    	console.log(`Done :: ${data}%`);
    });
    
    szip.on(EVENT.FINISH, (data) => {
    	if (data.err) {
    		console.log(data.err);
    	} else {
    		console.log(data.payload.hash);
    		console.log(`Successfull Operation. Exit Code :: ${data.err}`);
    	}
    });
    
    szip.hash("index.js", Hasher.SHA1);
    

    Output

    Done :: 100%
    { value: '38EF913D283D71177BFCC43828314208A8DB2B66' }
    Successfull Operation. Exit Code :: 0
    

    Example hash_async()

    const { SevenZip, Hasher } =  require("szip");
    
    const szip = new SevenZip();
    
    szip.hash_async("index.js", Hasher.SHA1).then((data) => {
    	console.log(data);
    }).catch((err) => {
    	console.log(err);
    });
    

    Output

    { value: '38EF913D283D71177BFCC43828314208A8DB2B66' }
    

    Note: You can use different hashing alorithms too. Avaliable hashing algorithms are down below.

    • CRC32
    • CRC64
    • SHA1
    • SHA256
    • ALL

    Choose any one option from above into the parameter. Hasher.{HashingAlogrithm} By default function will use SHA1 as hashing algorithm if you dont pass hash parameter.

    Test integrity of a file

    To test integrity of a file, you have to use test() or test_async()

    Example of test()

    const { SevenZip, EVENT } =  require("szip");
    
    const szip = new SevenZip();
    
    szip.on(EVENT.PROGRESS, (data) => {
    	console.log(`Done :: ${data}%`);
    });
    
    szip.on(EVENT.FINISH, (data) => {
    	if (data.err) {
    		console.log(data.err);
    	} else {
    		console.log(data.payload);
    		console.log(`Successfull Operation. Exit Code :: ${data.err}`);
    	}
    });
    
    szip.test("index.js");
    

    Example of test_async()

    const { SevenZip } =  require("szip");
    
    const szip = new SevenZip();
    
    szip.test_async("index.js").then((data) => {
    	console.log(data);
    }).catch((err) => {
    	console.log(err);
    });
    

    Very Important Note

    Do not run more than one event based function within same instance at the same time, because all the event based function emits into same event into same instance. But you can run multiple non event based functions (like async ones) within same instance at the same time.

    To avoid this problem create different instance and then call function from separate instances.

    At last

    If you like this wrapper package please give this repo a star :)

    Credits, 7zip 7zip-bin (npm package)

    Install

    npm i szip

    DownloadsWeekly Downloads

    1

    Version

    1.0.3

    License

    MIT

    Unpacked Size

    143 kB

    Total Files

    8

    Last publish

    Collaborators

    • epicx