# nebulog

> A enhancement/wrapper around the wonderful Winston logger.

Latest version **0.2.1** (published 2016-02-08) · 0 weekly downloads

## Install

```sh
npm install nebulog
pnpm add nebulog
yarn add nebulog
bun add nebulog
```

## Health

**Score 10/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; low quality score; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.2.1 |
| Published | 2016-02-08 |
| First published | 2011-04-20 |
| Weekly downloads | 0 |
| TypeScript types | none |
| Module format | CommonJS |
| Node | * |
| Dependencies | 1 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 4 |
| Author | Nebu Pookins |
| Maintainers | nebu |

## Links

- npm: https://www.npmjs.com/package/nebulog
- Repository: https://github.com/AntPortal/nebulog
- Issues: https://github.com/AntPortal/nebulog/issues
- npm.io page: https://npm.io/package/nebulog

## Dependencies (1)

- [winston](https://npm.io/package/winston.md) 2.1.1

## Recent versions

- 0.2.1 (latest) — 2016-02-08
- 0.0.0 — 2011-04-20

## README

# nebulog

A enhancement/wrapper around the wonderful Winston logger.

## Installation

### Installing npm (node package manager)
<pre>
  curl http://npmjs.org/install.sh | sh
</pre>

### Installing nebulog
<pre>
  [sudo] npm install nebulog
</pre>

## Motivation

[Winston](https://github.com/indexzero/winston) is a great logger, but there
were a few minor issues about it that I didn't like, or features I wish it had.
The enhancements over a vanilla implementation of Winston are:

* Outputting the filename of the file from which the logging message came from.
* Aligning the logging message by adding padding after the severity level.
* Use a more JSON-like syntax when printing the metadata object.
* Allow arbitrarily many metadata objects to be logged, rather than just one.

## Example usage:

### Basic Usage
<pre>
  var logger = require('nebulog').make({filename: __filename});

  logger.log('info', 'Logger is working');
  logger.info('This also works');
</pre>

### Setting minimum log level

<pre>
  var logger = require('nebulog').make({filename: __filename, level: 'warn'});

  logger.warn('This will be visible.');
  logger.info("But this won't");
</pre>

The log available log levels, from least serious to most serious, are:

['silly', 'verbose', 'info', 'warn', 'debug', 'error'];

### Logger per function

<pre>
  var loggerA = require('nebulog').make({filename: __filename + ':A'});
  var loggerB = require('nebulog').make({filename: __filename + ':B'});

  function A() {
    loggerA.info('This log message will be marked as coming from A');
  }

  function B() {
    loggerB.info('But this log message will be marked as coming from B');
  }
</pre>

---
_Source: https://npm.io/package/nebulog · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._