# furi

> File URI manipulation library

Latest version **3.0.0** (published 2024-01-24) · MIT license · 0 weekly downloads

## Install

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

## Health

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

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

Negative: abandoned.

## Facts

| | |
|---|---|
| Version | 3.0.0 |
| Published | 2024-01-24 |
| First published | 2018-10-16 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=14.13.1 |
| Dependencies | 0 |
| Unpacked size | 36.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 3 |
| Author | Charles Samborski <demurgos@demurgos.net> (https://demurgos.net/) |
| Maintainers | demurgos |
| Keywords | file, url |

## Links

- npm: https://www.npmjs.com/package/furi
- Repository: https://github.com/demurgos/furi
- npm.io page: https://npm.io/package/furi

## 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.0.0 (latest) — 2024-01-24
- 2.0.0-build.86 (next) — 2020-01-27
- 2.0.0 — 2020-01-27
- 1.3.0-build.82 — 2019-12-09
- 1.3.0-build.79 — 2019-12-07
- 1.3.0-build.73 — 2019-12-07
- 1.3.0-build.61 — 2019-12-06
- 1.3.0 — 2018-12-04
- 1.2.0 — 2018-12-04
- 1.1.0 — 2018-12-03
- 1.0.0-build.26 — 2018-12-03
- 1.0.0 — 2018-11-21
- 0.2.0 — 2018-11-21
- 0.2.0-build.11 — 2018-11-21
- 0.1.0-build.9 — 2018-10-17
- … 1 more at https://npm.io/package/furi/versions

## README

# furi

[![npm](https://img.shields.io/npm/v/furi.svg?maxAge=2592000)](https://www.npmjs.com/package/furi)
[![GitHub repository](https://img.shields.io/badge/Github-demurgos%2Ffuri-blue.svg)](https://github.com/demurgos/furi)
[![Codecov](https://codecov.io/gh/demurgos/furi/branch/master/graph/badge.svg)](https://codecov.io/gh/demurgos/furi)

File URI manipulation library.

This library is intended as a toolbox to handle `file://` URIs. It currently
focuses on conversion between file URIs and system dependent paths.

The conversion supports Windows UNC paths, Windows long paths, trailing
separators, special characters and non-ASCII characters.

This library has no dependencies and is compatible with browsers.

## Installation

```shell
# Yarn
yarn add furi
# npm
npm install --save furi
```

## API documentation

See [documentation](https://demurgos.github.io/furi/).

## References

- https://tools.ietf.org/html/rfc3986#section-3.3
- https://url.spec.whatwg.org/
- https://github.com/nodejs/node/blob/deaddd212c499c7ff88d20034753b5f3f00d5153/lib/internal/url.js#L1414
- https://github.com/nodejs/node/blob/master/test/parallel/test-url-pathtofileurl.js
- https://docs.microsoft.com/en-us/windows/desktop/FileIO/naming-a-file

## License

[MIT License](./LICENSE.md)

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