Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/skoshx/logpile
🪵 A simple & tiny logging library with supercharged search features
https://github.com/skoshx/logpile
extendable logger logging search simple tiny typescript utility
Last synced: 10 days ago
JSON representation
🪵 A simple & tiny logging library with supercharged search features
- Host: GitHub
- URL: https://github.com/skoshx/logpile
- Owner: skoshx
- License: mit
- Created: 2022-05-14T21:08:00.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2022-05-18T12:12:20.000Z (over 2 years ago)
- Last Synced: 2025-01-29T00:22:45.472Z (14 days ago)
- Topics: extendable, logger, logging, search, simple, tiny, typescript, utility
- Language: TypeScript
- Homepage: https://paka.dev/npm/logpile
- Size: 106 KB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
> 🪵 A simple & tiny logging library with supercharged search features
[](https://github.com/skoshx/logpile/blob/main/LICENSE.md)
[](https://github.com/skoshx/logpile/actions/workflows/ci.yml)
[](https://github.com/prettier/prettier)
[](https://github.com/facebook/jest)
[](https://github.com/skoshx/logpile/blob/main/README.md)
[](https://paka.dev/npm/logpile)
Logs are an integral part of building good software, especially APIs. It's important for logs to be easy to write in code, and easy to connect to some larger entity. This is where `logpile` comes in. This library is perfect for needing a versatile logger that works for anything, and that can flexibly search logs.
A perfect example is an API, where errors are logged with a reference to the users account. You can use `logpile` to search for all the error logs associated with that user, and display them to the API user.
## Install
```bash
$ yarn add logpile
```
or with npm
```bash
$ npm install --save logpile
```
## Features
- Tiny, Simple & Extendable
- Extendable output medium (stdout, file, database or custom)
- Supercharged search features (text, object, fuzzy)
- Hides sensitive values from the logs
- Fully TypeScript
## Usage
```typescript
import { createLogger } from 'logpile';
const logger = createLogger({
persist: [consolePersist({ level: 'error' }), filePersist()],
retrieve: fileRetrieve(),
});
// you can pass anything to the function
logger.warn('hello world', { some: 'object' }, 'another message');
/*=> {
timestamp: "2022-05-13T01:19:18.402Z",
level: "warning",
message: "hello world",
message2: "another message",
some: "object"
}*/
// you can search all logs with useful features
// search logs containing value 'hello world', in the last hour
/**
* You can search all logs with useful features.
* Search logs containing value 'hello world', from the last hour
*/
const logs = logger.searchLogs('hello world', { time: '1h' });
```
## License
`logpile` is released under the [MIT License](https://opensource.org/licenses/MIT).
## TODO
- Improved search functionality
- Search options for time (vercel's `ms` type eg. { time: '1wk' })
- Search where timestamp between 2 values
- Search items can be ranges (eg. { count > 2 && count < 4 })
- Deno release