Brunobkr/llama.cpp_AlgMor24_github

1# tiny-invariant 🔬💥2 3[![Build Status](https://travis-ci.org/alexreardon/tiny-invariant.svg?branch=master)](https://travis-ci.org/alexreardon/tiny-invariant)4[![npm](https://img.shields.io/npm/v/tiny-invariant.svg)](https://www.npmjs.com/package/tiny-invariant) [![dependencies](https://david-dm.org/alexreardon/tiny-invariant.svg)](https://david-dm.org/alexreardon/tiny-invariant)5![types](https://img.shields.io/badge/types-typescript%20%7C%20flow-blueviolet)6[![minzip](https://img.shields.io/bundlephobia/minzip/tiny-invariant.svg)](https://www.npmjs.com/package/tiny-invariant)7[![Downloads per month](https://img.shields.io/npm/dm/tiny-invariant.svg)](https://www.npmjs.com/package/tiny-invariant)8 9A tiny [`invariant`](https://www.npmjs.com/package/invariant) alternative.10 11## What is `invariant`?12 13An `invariant` function takes a value, and if the value is [falsy](https://github.com/getify/You-Dont-Know-JS/blob/bdbe570600d4e1107d0b131787903ca1c9ec8140/up%20%26%20going/ch2.md#truthy--falsy) then the `invariant` function will throw. If the value is [truthy](https://github.com/getify/You-Dont-Know-JS/blob/bdbe570600d4e1107d0b131787903ca1c9ec8140/up%20%26%20going/ch2.md#truthy--falsy), then the function will not throw.14 15```js16import invariant from 'tiny-invariant';17 18invariant(truthyValue, 'This should not throw!');19 20invariant(falsyValue, 'This will throw!');21// Error('Invariant violation: This will throw!');22```23 24You can also provide a function to generate your message, for when your message is expensive to create25 26```js27import invariant from 'tiny-invariant';28 29invariant(value, () => getExpensiveMessage());30```31 32## Why `tiny-invariant`?33 34The [`library: invariant`](https://www.npmjs.com/package/invariant) supports passing in arguments to the `invariant` function in a sprintf style `(condition, format, a, b, c, d, e, f)`. It has internal logic to execute the sprintf substitutions. The sprintf logic is not removed in production builds. `tiny-invariant` has dropped all of the sprintf logic. `tiny-invariant` allows you to pass a single string message. With [template literals](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Template_literals) there is really no need for a custom message formatter to be built into the library. If you need a multi part message you can just do this:35 36```js37invariant(condition, `Hello, ${name} - how are you today?`);38```39 40## Type narrowing41 42`tiny-invariant` is useful for correctly narrowing types for `flow` and `typescript`43 44```ts45const value: Person | null = { name: 'Alex' }; // type of value == 'Person | null'46invariant(value, 'Expected value to be a person');47// type of value has been narrowed to 'Person'48```49 50## API: `(condition: any, message?: string | (() => string)) => void`51 52- `condition` is required and can be anything53- `message` optional `string` or a function that returns a `string` (`() => string`)54 55## Installation56 57```bash58# yarn59yarn add tiny-invariant60 61# npm62npm install tiny-invariant --save63```64 65## Dropping your `message` for kb savings!66 67Big idea: you will want your compiler to convert this code:68 69```js70invariant(condition, 'My cool message that takes up a lot of kbs');71```72 73Into this:74 75```js76if (!condition) {77  if ('production' !== process.env.NODE_ENV) {78    invariant(false, 'My cool message that takes up a lot of kbs');79  } else {80    invariant(false);81  }82}83```84 85- **Babel**: recommend [`babel-plugin-dev-expression`](https://www.npmjs.com/package/babel-plugin-dev-expression)86- **TypeScript**: recommend [`tsdx`](https://github.com/jaredpalmer/tsdx#invariant) (or you can run `babel-plugin-dev-expression` after TypeScript compiling)87 88Your bundler can then drop the code in the `"production" !== process.env.NODE_ENV` block for your production builds to end up with this:89 90```js91if (!condition) {92  invariant(false);93}94```95 96- rollup: use [rollup-plugin-replace](https://github.com/rollup/rollup-plugin-replace) and set `NODE_ENV` to `production` and then `rollup` will treeshake out the unused code97- Webpack: [instructions](https://webpack.js.org/guides/production/#specify-the-mode)98 99## Builds100 101- We have a `es` (EcmaScript module) build102- We have a `cjs` (CommonJS) build103- We have a `umd` (Universal module definition) build in case you needed it104 105We expect `process.env.NODE_ENV` to be available at module compilation. We cache this value106 107## That's it!108 109🤘110