# printaeu

> Alternative to console.log

Latest version **0.1.12** (published 2023-12-31) · MIT license · 0 weekly downloads

## Install

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

## Health

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

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.1.12 |
| Published | 2023-12-31 |
| First published | 2020-10-22 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=12 |
| Dependencies | 0 |
| Unpacked size | 44 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Planet's Lightning Arrester |
| Maintainers | planetslightningarrester |
| Keywords | print, console, time, stamp, inline, colors, timestamp, replace, line |

## Links

- npm: https://www.npmjs.com/package/printaeu
- Repository: https://github.com/planetsLightningArrester/printaeu
- Homepage: hhttps://github.com/planetsLightningArrester/printaeu#readme
- Issues: https://github.com/planetsLightningArrester/printaeu/issues
- npm.io page: https://npm.io/package/printaeu

## Alternatives

- [@js-joda/timezone](https://npm.io/package/@js-joda/timezone.md) — 383.4K weekly downloads
- [chartjs-adapter-moment](https://npm.io/package/chartjs-adapter-moment.md) — 210.8K weekly downloads
- [strftime](https://npm.io/package/strftime.md) — 171.2K weekly downloads
- [vue-flatpickr-component](https://npm.io/package/vue-flatpickr-component.md) — 115.8K weekly downloads
- [timepicker](https://npm.io/package/timepicker.md) — 51.0K weekly downloads

## Recent versions

- 0.1.12 (latest) — 2023-12-31
- 0.1.11 — 2022-12-10
- 0.1.9 — 2022-02-11
- 0.1.8 — 2022-02-11
- 0.1.7 — 2022-02-11
- 0.1.6 — 2022-02-10
- 0.1.5 — 2021-08-11
- 0.1.4 — 2021-08-11
- 0.1.3 — 2021-08-11
- 0.1.2 — 2021-08-11
- 0.1.1 — 2021-05-03
- 0.1.0 — 2021-05-01
- 0.0.9 — 2020-11-28
- 0.0.8 — 2020-11-15
- 0.0.7 — 2020-11-15
- … 6 more at https://npm.io/package/printaeu/versions

## README

# printaeu

Time stamp is a must. **Period.**

### Features
- Time stamp (configurable to even show `ms` and date)
- Can replace previous line content
- Colorful text
- Modifiers (bold, italic, underline)
- Verbosity control
- File output

### Install
`npm i printaeu`

### Usage
It receives the same parameters of `console.log`.

```javascript
const { print } = require('printaeu');

// All of them has time stamp
print.log('Like console.log');  // [08:39] Like console.log
print.inline.log('Replace previous line');  // [08:40] Replace previous line
print.inline.green('Replace previous line + green');    // print.inline has all available colors
print.inline.bright.magenta('Replace previous line + bright + magenta');

// Clear console
print.clear();

// Many colors available
print.red('Red');
print.green('Green');
print.cyan('Cyan');
// ...and more

// Control verbosity
print.high.log(`This shows only if verbosity is set to 'high'`);
print.med.bold.pink(`This shows only if verbosity is set to 'high' or 'medium'`);
print.bold.pink(`This always shows`);
print.setVerbosity('low');
print.high.italic.orange(`This won't show :(`);
print.med.underline.magenta(`Neither this`);
print.underline.magenta(`This will`);

// ...and more!

```

```typescript
// Also works with ES5+
import { print, italic as i} from 'printaeu';

print.green(`You won't ${i.on}believe${i.off} this!`);

```

### Parameters
+ **...args:** Just like console.log().

### Show milliseconds
`print.showMs()` turn it on.
`print.showMs(false)` turn it off.

### Clear
`print.clear()` clear the terminal.
`print.clearLine(lines = 0)` clear some line. No args clears the current line.
`print.goBacknLines(lines)` move the cursor N lines from the current position. Negative goes down.

### Track errors
I don't commit errors, but when you do it's better to know where this come from.

```javascript
const { print } = require('printaeu');

function foo () {
    print.green(thisVarDoesntExist);
}

try {
    foo();
} catch(e) {
    print.red('omg where does this error come from? help me print');
    print.track(e); // Like stack error, but beautier
}
```

### File redirection
Print and logs into a file

```javascript
const { Print, print } = require('printaeu');
print.logToFile("/tmp/app.log");

const error = Print.create();
error.logToFile("/tmp/app.err");

try {
    foo();
} catch(e) {
    print.red('error data will be printed');
    print.logToFile("/tmp/app.log", false); // stop logging
    error.track(e); // Like stack error, but beautier
    print.log('Error printed') // won't be to the log file
}
```

### Not sure?
Copy, paste and run.

```javascript
const { print } = require('printaeu');

const warningSign = '\u{26a0}',
      recycleBin  = '\u{267b}',
      heart       = '\u{2764}';

const hey = 'HEY';
print.log(hey, `${hey}`, 'YOU YOU');
print.cyan("I don't like your girlfriend!");

print.showDate();
print.underline.yellow(warningSign, 'NO WAY NO WAY');
print.showDate(false);

print.showMs();
print.setColorfulTimeStamp(false);

print.bright.green(`${recycleBin} I think you need a new one`);
print.reverse.log('HEY HEY YOU YOU');

print.showMs(false);

setTimeout(() => {print.inline.bright.red('I could be your girlfriend ' + heart + heart + heart)}, 3000);
```

### Socket
`print.socket(socket);` receives a `socket` from Socket.io lib. Then, every `print.log` call will fire `socket.emit('console', [timeStamp] + data)`.

### Whole Lib

```javascript
const { print } = require('printaeu');

// All of them has time stamp
print.log('Like console.log');  // [08:39] Like console.log
print.inline.log('Replace previous line');
print.inline.green('Replace previous line + green');    // print.inline has all available colors
print.inline.bright.magenta('Replace previous line + bright + green');

// Colors available
print.red('Red');
print.green('Green');
print.magenta('Magenta');
print.white('White');
print.black('Black');
print.blue('Blue');
print.cyan('Cyan');
print.yellow('Yellow');
print.gray('Gray');
print.gray('Same as grey');
print.pink('Pink');
print.orange('Orange');

// Bright or Bold colors
print.bright.log('Like console.log but brighter');
print.bold.log('Like console.log but bold');
print.bright.red('Bright Red');     // print.bright has all available colors
print.bold.red('Bold Red');     // print.bright has all available colors

// Italic colors
print.bright.log('Like console.log but *italic*');
print.italic.red('Italic Red');     // print.italic has all available colors

// Underline + colors
print.underline.log('Like console.log but underscored');
print.underline.green('Underline Green');     // print.underline has all available colors

// Reversed background
print.reverse.log('Like console.log but with background reversed');
print.reverse.green('Reverse Green');     // print.reverse has all available colors

// Dim colors
print.dim.log('Like console.log but dim');
print.dim.green('Bright Green');     // print.dim has all colors above

// More
print.showMs(false);    // Switch milliseconds display
print.setBG.cyan('magenta');     // Switch the background color of all cyan prints (pink, orange and gray bg are not available)
print.clearBG.cyan();   // Set the default bg for all cyan prints
try {
    print.socket(socket);   // Every print.log(data) it executes socket.emit('console', [timeStamp] data);
} catch(error) {
    print.track(error);     // Print the error in a more readable way
}
```

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