# metautil

**Repository Path**: mirrors_Semigradsky/metautil

## Basic Information

- **Project Name**: metautil
- **Description**: Metarhia utilities 🧰
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-10-22
- **Last Updated**: 2026-03-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Metarhia utilities

[![ci status](https://github.com/metarhia/metautil/workflows/Testing%20CI/badge.svg)](https://github.com/metarhia/metautil/actions?query=workflow%3A%22Testing+CI%22+branch%3Amaster)
[![snyk](https://snyk.io/test/github/metarhia/metautil/badge.svg)](https://snyk.io/test/github/metarhia/metautil)
[![npm version](https://badge.fury.io/js/metautil.svg)](https://badge.fury.io/js/metautil)
[![npm downloads/month](https://img.shields.io/npm/dm/metautil.svg)](https://www.npmjs.com/package/metautil)
[![npm downloads](https://img.shields.io/npm/dt/metautil.svg)](https://www.npmjs.com/package/metautil)
[![license](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/metarhia/metautil/blob/master/LICENSE)

## Usage

- Install: `npm install metautil`
- Require: `const metautil = require('metautil');`

## Common utilities

- `random(min: number, max?: number): number`
- `sample(arr: Array<any>): any`
- `parseParams(params: string): object`
- `replace(str: string, substr: string, newstr: string): string`
- `split(s: string, separator: string): [string, string]`
- `fileExt(fileName: string): string`
- `parsePath(relPath: string): Array<string>`
- `between(s: string, prefix: string, suffix: string): string`
- `isFirstUpper(s: string): boolean`
- `toLowerCamel(s: string): string`
- `toUpperCamel(s: string): string`
- `isConstant(s: string): boolean`
- `nowDate(date?: Date): string`
- `duration(s: string | number): number`
- `bytesToSize(bytes: number): string`
- `sizeToBytes(size: string): number`
- `namespaceByPath(namespace: object, path: string): object | null`
- `makePrivate(instance: object): object`
- `protect(allowMixins: Array<string>, ...namespaces: Array<object>): void`
- `createAbortController(): AbortController`
- `timeout(msec: number, signal?: EventEmitter): Promise<void>`
- `delay(msec: number, signal?: EventEmitter): Promise<void>`

## Network utilities

- `ipToInt(ip?: string): number`
- `parseHost(host?: string): string`
- `parseCookies(cookie: string): object`
- `fetch(url: string): Promise<string>`
- `jsonParse(buffer: Buffer): object | null`
- `receiveBody(req: IncomingMessage): Promise<Buffer | null>`

## Crypto utilities

- `cryptoRandom(): number`
- `generateKey(length: number, possible: string): string`
- `crcToken(secret: string, key: string): string`
- `generateToken(secret: string, characters: string, length: number): string`
- `validateToken(secret: string, token: string): boolean`
- `hashPassword(password: string): Promise<string>`
- `validatePassword(password: string, serHash: string): Promise<boolean>`
- `md5(fileName: string): Promise<string>`

## Async abstractions

- Semaphore for limit concurrency accessing limited resource
  - `new Semaphore(concurrency: number, size?: number, timeout?: number)`
  - `empty: boolean`
  - `enter(): Promise<void>`
  - `leave(): void`
- Pool with round-robin and exclusive item capture
  - `new Pool()`
  - `size: number`
  - `available: number`
  - `next(): object | null`
  - `add(item: object): void`
  - `capture(): object | null`
  - `release(item: object): void`
  -  `isFree(item: object): boolean`

## License & Contributors

Copyright (c) 2017-2021 [Metarhia contributors](https://github.com/metarhia/metautil/graphs/contributors).
Metautil is [MIT licensed](./LICENSE).\
Metautil is a part of [Metarhia](https://github.com/metarhia) technology stack.