Merge pull request #4 from nika-begiashvili/single-file-extract

Single file extract

README.md

@@ -63,12 +63,12 @@ To get file listing without actually decompressing archive, use one of these met
     await archive.getFilesObject();
     // outputs
     {
-        ".gitignore": null,
+        ".gitignore": {CompressedFile},
         "addon": {
-            "addon.py": null,
-            "addon.xml": null
+            "addon.py": {CompressedFile},
+            "addon.xml": {CompressedFile}
         },
-        "README.md": null
+        "README.md": {CompressedFile}
     }
 
     await archive.getFilesArray();
@@ -89,6 +89,15 @@ decompression might take long for bigger files, to track each file as it gets ex
     });
 ```
 
+### Extract single file form archive
+
+To extract single file from archive you can use `extract()` method on returned `CompressedFile`
+
+```js
+    const filesObj = await archive.getFilesObject();
+    const file = await filesObj['.gitignore'].extract();
+```
+
 ## How it works
 
 Libarchivejs is port of popular [libarchive](https://github.com/libarchive/libarchive) C library to WASM. since WASM runs in current thread library uses WebWorkers for heavy lifting, ES Module (Archive class) is just a client for WebWorker, it's tiny and doesn't take up much space.