# @cloudcmd/formatify

> format directory content

Latest version **3.1.0** (published 2026-03-20) · MIT license · 0 weekly downloads

## Install

```sh
npm install @cloudcmd/formatify
pnpm add @cloudcmd/formatify
yarn add @cloudcmd/formatify
bun add @cloudcmd/formatify
```

## Health

**Score 50/100 (C)** — status: active.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

## Facts

| | |
|---|---|
| Version | 3.1.0 |
| Published | 2026-03-20 |
| First published | 2018-01-31 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Node | >=22 |
| Dependencies | 2 |
| Unpacked size | 7.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 1 |
| Author | coderaiser |
| Maintainers | coderaiser |
| Keywords | format, file, directory, size, name, date |

## Links

- npm: https://www.npmjs.com/package/@cloudcmd/formatify
- Repository: https://github.com/cloudcmd/formatify
- Homepage: http://github.com/cloudcmd/formatify
- Issues: https://github.com/cloudcmd/formatify/issues
- npm.io page: https://npm.io/package/@cloudcmd/formatify

## Dependencies (2)

- [format-io](https://npm.io/package/format-io.md) ^2.0.0
- [shortdate](https://npm.io/package/shortdate.md) ^2.0.0

## Alternatives

- [unionfs](https://npm.io/package/unionfs.md) — 2.2M weekly downloads
- [path-starts-with](https://npm.io/package/path-starts-with.md) — 35.9K weekly downloads
- [redzip](https://npm.io/package/redzip.md) — 1.2K weekly downloads
- [vscode-anymatch](https://npm.io/package/vscode-anymatch.md) — 848 weekly downloads
- [@ledgerhq/coin-filecoin](https://npm.io/package/@ledgerhq/coin-filecoin.md) — 793 weekly downloads

## Recent versions

- 3.1.0 (latest) — 2026-03-20
- 3.0.0 — 2026-03-17
- 2.0.1 — 2024-08-16
- 2.0.0 — 2024-08-16
- 1.0.4 — 2019-10-11
- 1.0.3 — 2019-09-20
- 1.0.2 — 2018-06-12
- 1.0.1 — 2018-02-02
- 1.0.0 — 2018-01-31

## README

# Formatify [![License][LicenseIMGURL]][LicenseURL] [![NPM version][NPMIMGURL]][NPMURL] [![Build Status][BuildStatusIMGURL]][BuildStatusURL] [![Coverage Status][CoverageIMGURL]][CoverageURL]

[NPMIMGURL]: https://img.shields.io/npm/v/@cloudcmd/formatify.svg?style=flat
[BuildStatusIMGURL]: https://github.com/cloudcmd/formatify/actions/workflows/nodejs.yml/badge.svg
[LicenseIMGURL]: https://img.shields.io/badge/license-MIT-317BF9.svg?style=flat
[NPMURL]: https://npmjs.org/package/@cloudcmd/formatify "npm"
[BuildStatusURL]: https://github.com/cloudcmd/formatify/actions/workflows/nodejs.yml
[LicenseURL]: https://tldrlegal.com/license/mit-license "MIT License"

Format directory content received by [readify](https://github.com/coderaiser/readify).

## Install

```
npm i @cloudcmd/formatify --save
```

## API

### formatify(files)

- **files** - `files list`

## Examples

```js
import {formatify} from '@cloudcmd/formatify';

const files = [{
    name: 'sortify.js',
    size: 3538,
    date,
    owner: 0,
    mode: 33_204,
}, {
    name: 'readify.js',
    size: 1629,
    date: '2016-11-21T13:37:55.275Z',
    owner: 0,
    mode: 33_204,
}];

formatify(files);
// returns
[{
    name: 'formatify.js',
    size: '3.46kb',
    date: '12.01.2017',
    owner: 0,
    mode: 'rw- rw- r--',
    time: '10:30:30',
}, {
    name: 'readify.js',
    size: '1.59kb',
    date: '12.01.2017',
    owner: 0,
    mode: 'rw- rw- r--',
    time: '10:30:30',
}];
```

## Related

- [Sortify](https://github.com/cloudcmd/sortify "Sortify") - sort directory content by name, size, date
- [Readify](https://github.com/coderaiser/readify "Readify") - read directory content with file attributes: size, date, owner, mode

## License

MIT

[CoverageURL]: https://coveralls.io/github/cloudcmd/formatify?branch=master
[CoverageIMGURL]: https://coveralls.io/repos/cloudcmd/formatify/badge.svg?branch=master&service=github

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