toshell

Simple text logger for node application.
We create it for fast and beautiful logging.

- Beautiful logging.
- Light weight.
- Log caller file and line number.
- Create custom log type, then you can choose what you want to display at the moment without commenting out the line.
- Global settings also avaliable for your project scope and environment.
- Typescript Support


---

$3

#### v1.3.0
- Add color functionality (light weight)
#### v1.2.0
- Use default varialbe to access global instance
``javascript
var toshell = require('toshell').default;//javascript
`
`typescript
import {default as toshell} from 'toshell';//typescript
`
- Now you can create new instance of toshell for further preference modification without effect default instance via toshellInstance.newInstance()
---

$3

- [ ] parse any object as pretty json format
- [ ] cli command line
- [ ] transfer log to web with interactive interface (json object viewer, filter, search)

---

!Screenshot

---

$3

`javascript
var toshell = require("toshell").default;
toshell.log("Log using log()");
toshell.warn("Log using warn()");
toshell.error("Log using error()");
toshell.systemLog("Log using systemLog()");
toshell.line();//log line
toshell.section("This is Section");

var myFuntion = function () {
toshell.logFunction("Log within closure function using logFunction()");
};
myFuntion();

toshell.setPreference({projectID:"MY_PROJECT"});
toshell.log("Logging after setPreference({projectID}) ");
`
---

$3

Preference can set at any point of the application.

It's will apply to all usage afterwards, by default.

`javascript
var toshell = require("toshell").default;
toshell.setPreference({
projectID : "MY_PROJECT"
});
`
or
`javascript
var toshell = require("toshell").default;
toshell.setPreference({
displaySystemLog : true, //display log that calls via logger.systelLog
displayDate : false, //display date
displayTime : true, //display time
displayFile : true, //display script path for each line
displayProjectID : true, //display project id
displayInfo : true, //display additional information
displayIcon : true, //display icon
fileMaxLength : 30, //set maximum length of file path
verboseLogTypeArray: [], //disable some log type when use logger.logWithType
projectID : "LOG" //project id
});
`

You can create local instance and change logging behavior

`javascript
var toshell = require("toshell").default;//import default instance
var localToShell = toshell.newInstance({projectID:"LOCAL"});
//Or
var localToShell = toshell.newInstance({projectID:"LOCAL"}, true);//Copy configuration from current instance
//use localToShell
localToShell.log('Log something');

`
---

$3

Try it yourself

`javascript
var toshell = require("toshell").default;
toshell.section("Playing with indent");
toshell.log("Line 1");
toshell.logWithTab("Line 2");
toshell.logWithTab("Line 3");

toshell.section("Playing with preference");

//create new instance of toshell
var localToShell = toshell.newInstance({projectID:"LOCAL"});

localToShell.log("Create local instance and set projectID:\"LOCAL\"");

localToShell.setPreference({displayFile:false});
localToShell.warn("displayFile:false");

localToShell.setPreference({displayTime:false});
localToShell.error("displayTime:false");

toshell.log('Log from GLOBAL instance');
localToShell.log('Log from LOCAL instance');

`

$3


Built-in color functionality (light-weight)
`javascript
var toshell = require('toshell').default;//javascript
toshell.log(Log with ${toshell.color('red','happy red')} color);
/*
Here is the list of color you can use
'_reset' |
'txt_bright' |
'txt_dim' |
'txt_underscore' |
'txt_blink' |
'txt_reverse' |
'txt_hidden' |
'black' |
'red' |
'green' |
'yellow' |
'blue' |
'magenta' |
'cyan' |
'white' |
'bg_black' |
'bg_red' |
'bg_green' |
'bg_yellow' |
'bg_blue' |
'bg_magenta' |
'bg_cyan' |
'bg_white'
*/

``