# linecat

> linecat is a tool trying to simplify android log analytics. It also can be used as a generic tool for line content reducer.

Latest version **1.0.1** (published 2022-05-14) · ISC license · 0 weekly downloads

## Install

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

Provides the command `linecat`.

## Health

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

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.1 |
| Published | 2022-05-14 |
| First published | 2022-05-14 |
| Weekly downloads | 0 |
| License | ISC |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 27.6 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | ruize |
| Maintainers | wyer |

## Links

- npm: https://www.npmjs.com/package/linecat
- Repository: https://github.com/zhangruize/logdog
- Homepage: https://github.com/zhangruize/logdog#readme
- Issues: https://github.com/zhangruize/logdog/issues
- npm.io page: https://npm.io/package/linecat

## Recent versions

- 1.0.1 (latest) — 2022-05-14
- 1.0.0 — 2022-05-14

## README

Parse input lines using custom patterns and output more readable and helpful lines.

## Install

`npm install -g linecat`

## Usage

- `linecat -p=pattern_path`

pattern_path is the custom pattern json file. Example patterns json files are listed in src/example-patterns.

## Pattern json file

| field        | require | note                                                                       |
| ------------ | ------- | -------------------------------------------------------------------------- |
| id           | no      | the id of current pattern, which can be referenced in `outputFormat` field |
| line         | no      | regular expression for whole line content                                  |
| outputFormat | no      | specific output line format. Available env variables are listed below.     |

Many env variables are available in `outputFormat` field:

| Env var name           | note                                                                                            |
| ---------------------- | ----------------------------------------------------------------------------------------------- |
| id                     | current pattern id                                                                              |
| line                   | whole line                                                                                      |
| content                | whole line except other tokens                                                                  |
| level                  | log level if available                                                                          |
| month                  | month of current line if available                                                              |
| day                    | date of current line if available                                                               |
| hours                  | hours of current line if available                                                              |
| minutes                | minute of current line if available                                                             |
| seconds                | seconds of current line if available                                                            |
| ms                     | ms of current line if avaiilable                                                                |
| timediff               | time diff from current line.                                                                    |
| last-\[id\|line]-{...} | last matched line of specific id or any matched line for fields above. eg: `last-line-timediff` |

You can also check example patterns in `src/example-patterns` to know more usage.

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