Brunobkr/llama.cpp_AlgMor24_github

1# totalist [![build status](https://badgen.now.sh/github/status/lukeed/totalist)](https://github.com/lukeed/totalist/actions) [![codecov](https://badgen.now.sh/codecov/c/github/lukeed/totalist)](https://codecov.io/gh/lukeed/totalist)2 3> A tiny (195B to 224B) utility to recursively list all (total) files in a directory4 5Traverse a directory recursively, running a function for **every file** found.6 7With this module, you easily apply custom logic to decide which file(s) to process without worrying about accidentally accessing a directory or making repeat `fs.Stats` requests.8 9## Install10 11```12$ npm install --save totalist13```14 15 16## Modes17 18There are two "versions" of `totalist` available:19 20#### "async"21> **Node.js:** >= 8.x<br>22> **Size (gzip):** 220 bytes<br>23> **Availability:** [CommonJS](https://unpkg.com/totalist/dist/index.js), [ES Module](https://unpkg.com/totalist/dist/index.mjs)24 25This is the primary/default mode. It makes use of `async`/`await` and [`util.promisify`](https://nodejs.org/api/util.html#util_util_promisify_original).26 27#### "sync"28> **Node.js:** >= 6.x<br>29> **Size (gzip):** 195 bytes<br>30> **Availability:** [CommonJS](https://unpkg.com/totalist/sync/index.js), [ES Module](https://unpkg.com/totalist/sync/index.mjs)31 32This is the opt-in mode, ideal for scenarios where `async` usage cannot be supported.33 34 35## Usage36 37***Selecting a Mode***38 39```js40// import via npm module41import { totalist } from 'totalist';42import { totalist } from 'totalist/sync';43```44 45***Example Usage***46 47```js48import { totalist } from 'totalist/sync';49 50const styles = new Set();51const scripts = new Set();52 53totalist('src', (name, abs, stats) => {54  if (/\.js$/.test(name)) {55    scripts.add(abs);56    if (stats.size >= 100e3) {57      console.warn(`[WARN] "${name}" might cause performance issues (${stats.size})`);58    }59  } else if (/\.css$/.test(name)) {60    styles.add(abs);61  }62});63 64console.log([...scripts]);65//=> [..., '/Users/lukeed/.../src/path/to/example.css', ...]66```67 68 69## API70 71### totalist(dir, callback)72Returns: `void`73 74> **Important:** The "async" usage must be `await`ed or included within a Promise chain.75 76#### dir77Type: `string`<br>78Required: `true`79 80The directory to traverse.81 82This may be a relative _or_ an absolute path.83 84> **Note**: Node.js will assume a relative path is meant to be resolved from the current location (`process.cwd()`).85 86#### callback87Type: `Function`<br>88Required: `true`89 90The callback function to run for _every_ file.91 92The function receives three parameters:93 94##### relPath95Type: `String`<br>96The path _relative to_ the initial `dir` value you provided.97 98##### absPath99Type: `String`<br>100The absolute path of the file.101 102##### stats103Type: `fs.Stats`<br>104The [`fs.Stats`](https://nodejs.org/api/fs.html#fs_class_fs_stats) object for the file.105 106 107## License108 109MIT © [Luke Edwards](https://lukeed.com)110