# in-folder

> Temporarily change directories to run a callback

Latest version **1.0.3** (published 2017-03-12) · MIT license · 0 weekly downloads

## Install

```sh
npm install in-folder
pnpm add in-folder
yarn add in-folder
bun add in-folder
```

## 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.3 |
| Published | 2017-03-12 |
| First published | 2017-03-12 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >= 7.7.2 |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | David MacDonald |
| Maintainers | mindlapse |
| Keywords | cwd, folder, process, micropackage, change, directory, dir |

## Links

- npm: https://www.npmjs.com/package/in-folder
- Repository: https://github.com/mindlapse/in-folder
- Homepage: https://github.com/mindlapse/in-folder#readme
- Issues: https://github.com/mindlapse/in-folder/issues
- npm.io page: https://npm.io/package/in-folder

## Alternatives

- [@mce/gif](https://npm.io/package/@mce/gif.md) — 2.6K weekly downloads
- [cleanse](https://npm.io/package/cleanse.md) — 173 weekly downloads
- [str](https://npm.io/package/str.md) — 127 weekly downloads
- [naming](https://npm.io/package/naming.md) — 95 weekly downloads
- [tap-telco-api](https://npm.io/package/tap-telco-api.md) — 19 weekly downloads

## Recent versions

- 1.0.3 (latest) — 2017-03-12
- 1.0.2 — 2017-03-12
- 1.0.1 — 2017-03-12
- 1.0.0 — 2017-03-12

## README

# in-folder (a micropackage)
Temporarily change directories to run a callback

  [![NPM Version][npm-image]][npm-url]
  [![Linux Build][travis-image]][travis-url]
  [![Windows Build][appveyor-image]][appveyor-url]
  [![Test Coverage][coveralls-image]][coveralls-url]
  

### Installation
```
npm install in-folder
```

### Usage

```javascript
let inside = require('in-folder')

let showFolder = () => console.log("Folder: " + process.pwd())

showFolder()
inside("lib", showFolder)
showFolder()

```

If the current working directory was '/var', and '/var/lib' existed, then the output would be:
```
Folder: /var
Folder: /var/lib
Folder: /var
```

### Notes
* Promises, if returned within the callback, will be resolved and returned by in-folder.
* Supports relative and absolute paths
* Uses [process.chdir](https://nodejs.org/api/process.html#process_process_chdir_directory) to change folders

### License

[MIT](LICENSE)

[npm-image]: https://img.shields.io/npm/v/in-folder.svg?label=stable
[npm-url]: https://npmjs.org/package/in-folder
[downloads-image]: https://img.shields.io/npm/dm/in-folder.svg
[downloads-url]: https://npmjs.org/package/in-folder
[travis-image]: https://img.shields.io/travis/mindlapse/in-folder/master.svg?label=linux
[travis-url]: https://travis-ci.org/mindlapse/in-folder
[appveyor-image]: https://img.shields.io/appveyor/ci/mindlapse/in-folder/master.svg?label=windows
[appveyor-url]: https://ci.appveyor.com/project/mindlapse/in-folder
[coveralls-image]: https://img.shields.io/coveralls/mindlapse/in-folder/master.svg
[coveralls-url]: https://coveralls.io/r/mindlapse/in-folder?branch=master

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