Brunobkr/llama.cpp_AlgMor24_github

1# obug2 3[![npm version][npm-version-src]][npm-version-href]4[![npm downloads][npm-downloads-src]][npm-downloads-href]5[![JSR][jsr-badge-src]][jsr-badge-href]6[![Unit Test][unit-test-src]][unit-test-href]7 8A lightweight JavaScript debugging utility, forked from [debug](https://www.npmjs.com/package/debug), featuring TypeScript and ESM support.9 10> [!NOTE]11> obug v1 retains most of the compatibility with [debug](https://github.com/debug-js/debug), but drops support for older browsers and Node.js, making it a drop-in replacement.12>13> obug v2 refactors some API imports and usage for better support of ESM and TypeScript, easier customization, and an even smaller package size.14 15## Key Differences from `debug`16 17- ✨ Minimal footprint18  - 7.7 kB package size19  - 1.4 KB minified + gzipped for browsers20- 📦 Zero dependencies21- 📝 Full TypeScript support22- 🚀 Native ESM compatibility23- 🌐 Optimized for modern runtimes24  - ES2015+ browsers25  - Modern Node.js versions26- 🎨 Customizable formatting27 28## Installation29 30```bash31npm install obug32```33 34## Usage35 36```ts37import { createDebug, disable, enable, enabled, namespaces } from 'obug'38 39// Get the currently enabled namespaces40console.log(namespaces())41 42const debug = createDebug('my-namespace', {43  // All options are optional44 45  useColors: true, // false, true, undefined for auto-detect46  color: 2, // custom color47  // custom formatArgs48  formatArgs(args) {},49  formatters: {},50  // Node.js only51  inspectOpts: {},52 53  // custom log54  log: console.log,55})56 57debug('This is a debug message')58console.log(59  debug.namespace, // 'my-namespace'60  debug.enabled, // Check if enabled61  debug.useColors, // true62  debug.color, // 263  debug.formatArgs, // custom formatArgs64  debug.formatters, // {}65  debug.inspectOpts, // {}66  debug.log, // implemented log function67)68 69// Create a sub-namespace, and it will inherit options from the parent debugger70const sub = debug.extend('sub-namespace')71sub('This is a sub-namespace debug message')72console.log(sub.namespace) // 'my-namespace:sub-namespace'73```74 75## How to use76 77### Enabling debug output78 79obug picks up enabled namespaces from the `DEBUG` environment variable in Node.js, or from `localStorage.debug` in browsers.80 81In Node.js:82 83```bash84DEBUG=app:* node app.js85```86 87On Windows (CMD):88 89```cmd90set DEBUG=app:* & node app.js91```92 93On Windows (PowerShell):94 95```powershell96$env:DEBUG='app:*'; node app.js97```98 99In the browser, set the value in DevTools and refresh the page:100 101```js102localStorage.debug = 'app:*'103```104 105### Wildcards and exclusion106 107The `*` character is a wildcard. Suppose your library has debuggers named `connect:bodyParser`, `connect:compress`, and `connect:session` — instead of listing each one, use `DEBUG=connect:*`. Use `DEBUG=*` to enable everything.108 109Exclude namespaces by prefixing them with `-`:110 111```bash112DEBUG=*,-connect:* node app.js113```114 115### Namespace conventions116 117If you're using obug in a library, prefix your namespaces with the library name and use `:` to separate features (e.g. `connect:bodyParser`). This lets users opt into the parts they care about without guessing names.118 119### Extending a namespace120 121Use `.extend()` to create a sub-namespace that inherits options from its parent:122 123```ts124const log = createDebug('auth')125const logSign = log.extend('sign') // 'auth:sign'126const logLogin = log.extend('login') // 'auth:login'127 128log('hello') // auth hello129logSign('hello') // auth:sign hello130logLogin('hello') // auth:login hello131```132 133### Formatters134 135obug uses [printf-style](https://wikipedia.org/wiki/Printf_format_string) formatting. Built-in formatters:136 137| Formatter | Representation                                     |138| --------- | -------------------------------------------------- |139| `%O`      | Pretty-print an Object on multiple lines.          |140| `%o`      | Pretty-print an Object all on a single line.       |141| `%%`      | Single percent sign. Does not consume an argument. |142 143Other format specifiers supported by Node's `util.format` (`%s`, `%d`, `%j`, …) and the browser console pass through to the underlying logger.144 145#### Custom formatters146 147Register custom formatters via the `formatters` option. For example, to render a `Buffer` as hex with `%h`:148 149```ts150const debug = createDebug('foo', {151  formatters: {152    h: (v) => v.toString('hex'),153  },154})155 156debug('this is hex: %h', Buffer.from('hello world'))157//   foo this is hex: 68656c6c6f20776f726c64 +0ms158```159 160### Dynamic enable / disable161 162You can toggle namespaces at runtime:163 164```ts165import { disable, enable, enabled, namespaces } from 'obug'166 167enable('app:*')168console.log(enabled('app:server')) // true169 170const previous = disable()171console.log(enabled('app:server')) // false172 173// Restore later174enable(previous)175```176 177`namespaces()` returns the string of currently enabled namespaces. Note that calling `enable()` overrides the value initially read from `DEBUG`.178 179### Checking whether a debugger is enabled180 181Guard expensive work behind the `enabled` property:182 183```ts184const debug = createDebug('http')185 186if (debug.enabled) {187  // expensive computation only when enabled188}189```190 191You can also force the state by assigning to `debug.enabled` directly.192 193### Custom output194 195By default, obug writes to `stderr` in Node.js and to the console in browsers. Override the `log` option to redirect output per-namespace:196 197```ts198const log = createDebug('app:log', {199  log: console.log,200})201 202const error = createDebug('app:error') // still goes to stderr203```204 205### Environment variables (Node.js)206 207| Name                | Purpose                                         |208| ------------------- | ----------------------------------------------- |209| `DEBUG`             | Enables/disables specific debugging namespaces. |210| `DEBUG_HIDE_DATE`   | Hide date from debug output (non-TTY).          |211| `DEBUG_COLORS`      | Whether to use colors in the debug output.      |212| `DEBUG_DEPTH`       | Object inspection depth.                        |213| `DEBUG_SHOW_HIDDEN` | Shows hidden properties on inspected objects.   |214 215Variables prefixed with `DEBUG_` are converted to camelCase keys on the options object passed to Node's [`util.inspect()`](https://nodejs.org/api/util.html#util_util_inspect_object_options) for the `%o` / `%O` formatters.216 217## Original Authors218 219As obug is a fork of debug with significant modifications, we would like to acknowledge the original authors:220 221- TJ Holowaychuk222- Nathan Rajlich223- Andrew Rhyne224- Josh Junon225 226## Sponsors227 228<p align="center">229  <a href="https://cdn.jsdelivr.net/gh/sxzz/sponsors/sponsors.svg">230    <img src='https://cdn.jsdelivr.net/gh/sxzz/sponsors/sponsors.svg'/>231  </a>232</p>233 234## License235 236[MIT](./LICENSE) License © 2025-PRESENT [Kevin Deng](https://github.com/sxzz)237 238[The MIT License](./LICENSE) Copyright (c) 2014-2017 TJ Holowaychuk &lt;tj@vision-media.ca&gt;239 240[The MIT License](./LICENSE) Copyright (c) 2018-2021 Josh Junon241 242<!-- Badges -->243 244[npm-version-src]: https://img.shields.io/npm/v/obug.svg245[npm-version-href]: https://npmjs.com/package/obug246[npm-downloads-src]: https://img.shields.io/npm/dm/obug247[npm-downloads-href]: https://www.npmcharts.com/compare/obug?interval=30248[unit-test-src]: https://github.com/sxzz/obug/actions/workflows/unit-test.yml/badge.svg249[unit-test-href]: https://github.com/sxzz/obug/actions/workflows/unit-test.yml250[jsr-badge-src]: https://jsr.io/badges/@sxzz/obug251[jsr-badge-href]: https://jsr.io/@sxzz/obug252