2015-09-20 15:42:50 +00:00
# beautylog
2016-05-03 21:09:57 +00:00
beautiful logging, TypeScript ready
2015-09-27 15:16:43 +00:00
2016-09-02 10:50:07 +00:00
## Availabililty
[![npm ](https://push.rocks/assets/repo-button-npm.svg )](https://www.npmjs.com/package/beautylog)
[![git ](https://push.rocks/assets/repo-button-git.svg )](https://gitlab.com/pushrocks/beautylog)
[![git ](https://push.rocks/assets/repo-button-mirror.svg )](https://github.com/pushrocks/beautylog)
[![docs ](https://push.rocks/assets/repo-button-docs.svg )](https://pushrocks.gitlab.io/beautylog/docs)
## Status for master
2016-05-30 04:40:03 +00:00
[![build status ](https://gitlab.com/pushrocks/beautylog/badges/master/build.svg )](https://gitlab.com/pushrocks/beautylog/commits/master)
2016-09-02 10:50:07 +00:00
[![coverage report ](https://gitlab.com/pushrocks/beautylog/badges/master/coverage.svg )](https://gitlab.com/pushrocks/beautylog/commits/master)
2015-09-27 15:16:43 +00:00
[![Dependency Status ](https://david-dm.org/pushrocks/beautylog.svg )](https://david-dm.org/pushrocks/beautylog)
2015-11-23 22:54:14 +00:00
[![bitHound Dependencies ](https://www.bithound.io/github/pushrocks/beautylog/badges/dependencies.svg )](https://www.bithound.io/github/pushrocks/beautylog/master/dependencies/npm)
2016-09-02 10:50:07 +00:00
[![bitHound Code ](https://www.bithound.io/github/pushrocks/beautylog/badges/code.svg )](https://www.bithound.io/github/pushrocks/beautylog)
[![TypeScript ](https://img.shields.io/badge/TypeScript-2.x-blue.svg )](https://nodejs.org/dist/latest-v6.x/docs/api/)
[![node ](https://img.shields.io/badge/node->=%206.x.x-blue.svg )](https://nodejs.org/dist/latest-v6.x/docs/api/)
2015-09-27 15:23:32 +00:00
## Usage
2015-11-16 22:32:40 +00:00
2016-05-19 04:53:51 +00:00
```typescript
2016-07-23 23:17:38 +00:00
var beautylog = require("beautylog");
2016-05-03 21:09:57 +00:00
beautylog.log("some log message"); // normal console log message
beautylog.info("some log message") // info console log message
beautylog.ok("some log message"); // ok console log message
beautylog.warn("some log message"); // warn console log message
beautylog.success("some success message"); // success console log message
beautylog.error("some error message"); // error console log message
2015-09-27 15:23:32 +00:00
```
2015-11-16 22:32:40 +00:00
The plugin produces beautiful output like this:
2015-09-30 15:27:01 +00:00
![console.png ](https://mediaserve.lossless.digital/github.com/pushrocks/beautylog/console.png )
2015-11-16 22:32:40 +00:00
2016-05-19 04:53:51 +00:00
### Ora Integration
beautylog wraps the excellent ora module from npm to better work with beautylog. In general that means that you can log persistent messages WHILE you are actually having an active Ora object. beautylog handles all the fuss for you.
2016-01-30 05:19:44 +00:00
2016-05-19 04:53:51 +00:00
```typescript
var myOra = new beautylog.Ora("my awesome text", "blue");
myOra.start();
beautylog.info("some persistent text") //does not disturb myOra
2016-05-23 08:21:10 +00:00
console.log("something") // even this works because console.log is monkeypatched by beautylog
2016-05-19 04:53:51 +00:00
myOra.text("some updated text");
myOra.stop();
```
2016-01-30 05:19:44 +00:00
2015-11-16 22:32:40 +00:00
### Console Tables
beautylog allows displaying data in nice tables for better overview.
2016-05-03 21:09:57 +00:00
> **Note:** This only works only in nodejs for now.
2015-12-20 22:14:22 +00:00
There are different types of tables.
#### Custom
```javascript
2016-05-03 21:09:57 +00:00
var beautylog = require("beautylog");
var myTable = beautylog.table.new("custom",["Heading1".blue,"Heading2".blue,"Heading3".blue]); // type "custom"
2015-12-20 22:14:22 +00:00
myTable.push(["check 1","success"]); // adds a row the myTable
myTable.push(["check 2","error"]); // adds a row the myTable
myTable.push(["check 3","error"]); // adds a row the myTable
myTable.print(); //prints myTable to the console
```
#### Checks
2015-11-16 22:32:40 +00:00
```javascript
2016-05-03 21:09:57 +00:00
var beautylog = require("beautylog");
var myTable = beautylog.table.new("checks"); // type checks
2016-07-14 21:01:08 +00:00
myTable.push(["check 1","success"]); // adds a row to myTable
myTable.push(["check 2","error"]); // adds a row to myTable
myTable.push(["check 3","error"]); // adds a row to myTable
myTable.print(); //prints myTable to console
2015-11-16 22:32:40 +00:00
```
2015-11-16 22:41:50 +00:00
2015-12-20 22:14:22 +00:00
The table from the code with type "checks" above looks like this:
2016-01-30 05:19:44 +00:00
![table.png ](https://mediaserve.lossless.digital/github.com/pushrocks/beautylog/table.png )
2016-07-23 17:47:23 +00:00
## Centralized remote logging
2016-07-23 18:01:30 +00:00
Beautylog makes it easy to have all your node applications log to a remote location.
2016-07-23 17:47:23 +00:00
Currently supported remote providers:
* loggly.com
```typescript
2016-07-23 23:30:30 +00:00
beautylog.remote.loggly({
2016-07-23 23:47:35 +00:00
token: "loggly-token",
subdomain: "loggly-subdomain",
2016-07-23 23:30:30 +00:00
appName: "some App Name",
serverName: "some Server Name"
});
2016-07-23 17:47:23 +00:00
```
> Note: since beautylog monkeypatches all console log methods.
There is no need to change anything in your code.
Everything that is getting logged to your console by node will get logged to loggly as well.
2016-09-02 10:50:07 +00:00
For more information read the docs!
2016-05-19 04:53:51 +00:00
2016-09-02 10:50:07 +00:00
[![npm ](https://push.rocks/assets/repo-header.svg )](https://push.rocks)