# file-paths-win32

> Find paths of file(s) matching file name(s) on Windows

Latest version **1.0.0** (published 2016-10-22) · MIT license · 0 weekly downloads

## Install

```sh
npm install file-paths-win32
pnpm add file-paths-win32
yarn add file-paths-win32
bun add file-paths-win32
```

## 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.0 |
| Published | 2016-10-22 |
| First published | 2016-10-22 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 1 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Andrew Carpenter |
| Maintainers | musocrat |
| Keywords | find, file, path, by, name, windows |

## Links

- npm: https://www.npmjs.com/package/file-paths-win32
- Repository: https://github.com/doesdev/file-paths-win32
- Homepage: https://github.com/doesdev/file-paths-win32#readme
- Issues: https://github.com/doesdev/file-paths-win32/issues
- npm.io page: https://npm.io/package/file-paths-win32

## Dependencies (1)

- [execa](https://npm.io/package/execa.md) ^0.5.0

## Alternatives

- [base64url](https://npm.io/package/base64url.md) — 6.1M weekly downloads
- [get-installed-path](https://npm.io/package/get-installed-path.md) — 502.9K weekly downloads
- [@uppy/url](https://npm.io/package/@uppy/url.md) — 185.8K weekly downloads
- [@d3fc/d3fc-shape](https://npm.io/package/@d3fc/d3fc-shape.md) — 16.2K weekly downloads
- [localizer](https://npm.io/package/localizer.md) — 226 weekly downloads

## Recent versions

- 1.0.0 (latest) — 2016-10-22

## README

# file-paths-win32 [![NPM version](https://badge.fury.io/js/file-path-win32.svg)](https://npmjs.org/package/file-paths-win32)   [![js-standard-style](https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat)](https://github.com/feross/standard)

> Find paths of files matching file name on Windows

## install

```sh
$ npm install --save file-paths-win32
```

## api

### returns
Promise is returned with
- **resolve** *(array) [Array of file paths, empty if not found]*
- **reject** *(error)*

### arguments
- **filename(s)** *(string || array)*
- **opts** *(object) optional*
  - **hints** *(array - %HOMEPATH% unless file is EXE) [paths to search]*
  - **full** *(boolean - false) [search all drives recursively]*

## usage

```js
const filePaths = require('file-paths-win32')
let fpOpts

// search for single file in default paths
filePaths('someFile.txt').then(console.log).catch(console.error)

// search for single EXE in default executable paths
filePaths('someApp.exe').then(console.log).catch(console.error)

// search for array of files in default paths
filePaths(['someFile.txt', 'someApp.exe']).then(console.log).catch(console.error)

// search for single file in specific paths
fpOpts = {hints: ['C:\\some\\path', 'C:\\some\\other\\path\\']}
filePaths('someFile', fpOpts).then(console.log).catch(console.error)

// search for single file in all drives recursively
fpOpts = {full: true}
filePaths('someFile', fpOpts).then(console.log).catch(console.error)
```

## License

MIT © [Andrew Carpenter](https://github.com/doesdev)

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