summaryrefslogtreecommitdiff
path: root/desktop/node_modules/galactus/README.md
diff options
context:
space:
mode:
authorRaindropsSys <raindrops@equestria.dev>2023-10-24 17:43:37 +0200
committerRaindropsSys <raindrops@equestria.dev>2023-10-24 17:43:37 +0200
commitae187b6d75c8079da0be1dc288613bad8466fe61 (patch)
tree5ea0d34185a2270f29ffaa65e1f5258028d7d5d0 /desktop/node_modules/galactus/README.md
downloadmist-ae187b6d75c8079da0be1dc288613bad8466fe61.tar.gz
mist-ae187b6d75c8079da0be1dc288613bad8466fe61.tar.bz2
mist-ae187b6d75c8079da0be1dc288613bad8466fe61.zip
Initial commit
Diffstat (limited to 'desktop/node_modules/galactus/README.md')
-rw-r--r--desktop/node_modules/galactus/README.md46
1 files changed, 46 insertions, 0 deletions
diff --git a/desktop/node_modules/galactus/README.md b/desktop/node_modules/galactus/README.md
new file mode 100644
index 0000000..c536e5c
--- /dev/null
+++ b/desktop/node_modules/galactus/README.md
@@ -0,0 +1,46 @@
+Galactus
+-----------
+
+> A JS implementation of `prune --production`
+
+## Installation
+
+```bash
+npm i --save-dev galactus
+```
+
+## API
+
+### Class: `DestroyerOfModules`
+
+```js
+import { DestroyerOfModules } from 'galactus';
+
+// modulePath is the root folder of your module
+const destroyer = new DestroyerOfModules({
+ rootDirectory: __dirname,
+ // Optionally provide your own walker from 'flora-colossus'
+ walker: myWalker,
+ // Optionally provide a method to override the default
+ // keep or destroy test
+ shouldKeepModuleTest: (module, isDepDep) => true,
+});
+```
+
+#### `destroyer.destroy()`
+
+Returns a `Promise` that resolves once the destruction is complete. By default
+it will destroy all dependencies that aren't required for production or
+optional dependencies. You can override this behavior by providing a
+`shouldKeepModuleTest` function in the constructor.
+
+#### `destroyer.collectKeptModules()`
+
+Returns a `Promise` of a `ModuleMap` (a `Map` of paths to `Module`s). The
+`Promise` resolves when the walker finishes walking the module tree. The
+`ModuleMap` only contains the `Module`s that would be kept by a call
+to `destroy()`.
+
+There is one optional keyword argument, `relativePaths`. By default, the paths
+in the `ModuleMap` are absolute. If `relativePaths` is `true`, they are relative
+to the `rootDirectory` specified in the constructor.