-
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
tunnckoCore
committed
Jan 2, 2017
1 parent
8c95714
commit a339d90
Showing
2 changed files
with
145 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,130 @@ | ||
# tmp-filepath [![NPM version](https://img.shields.io/npm/v/tmp-filepath.svg?style=flat)](https://www.npmjs.com/package/tmp-filepath) [![NPM monthly downloads](https://img.shields.io/npm/dm/tmp-filepath.svg?style=flat)](https://npmjs.org/package/tmp-filepath) [![npm total downloads][downloads-img]][downloads-url] | ||
|
||
> Generate temporary filepath string (without writing to disk). Using scaleable, secure and fast cross-platform [cuid][] package | ||
[![code climate][codeclimate-img]][codeclimate-url] | ||
[![standard code style][standard-img]][standard-url] | ||
[![linux build status][travis-img]][travis-url] | ||
[![windows build status][appveyor-img]][appveyor-url] | ||
[![coverage status][coveralls-img]][coveralls-url] | ||
[![dependency status][david-img]][david-url] | ||
|
||
You might also be interested in [always-done](https://github.com/hybridables/always-done#readme). | ||
|
||
## Table of Contents | ||
- [Install](#install) | ||
- [Usage](#usage) | ||
- [API](#api) | ||
- [Related](#related) | ||
- [Contributing](#contributing) | ||
- [Building docs](#building-docs) | ||
- [Running tests](#running-tests) | ||
- [Author](#author) | ||
- [License](#license) | ||
|
||
_(TOC generated by [verb](https://github.com/verbose/verb) using [markdown-toc](https://github.com/jonschlinkert/markdown-toc))_ | ||
|
||
## Install | ||
Install with [npm](https://www.npmjs.com/) | ||
|
||
``` | ||
$ npm install tmp-filepath --save | ||
``` | ||
|
||
or install using [yarn](https://yarnpkg.com) | ||
|
||
``` | ||
$ yarn add tmp-filepath | ||
``` | ||
|
||
## Usage | ||
> For more use-cases see the [tests](test.js) | ||
```js | ||
const tmpFilepath = require('tmp-filepath') | ||
``` | ||
|
||
## API | ||
|
||
## Related | ||
- [always-done](https://www.npmjs.com/package/always-done): Handle completion and errors with elegance! Support for streams, callbacks, promises, child processes, async/await and sync functions. A drop-in replacement… [more](https://github.com/hybridables/always-done#readme) | [homepage](https://github.com/hybridables/always-done#readme "Handle completion and errors with elegance! Support for streams, callbacks, promises, child processes, async/await and sync functions. A drop-in replacement for [async-done][] - pass 100% of its tests plus more") | ||
- [minibase](https://www.npmjs.com/package/minibase): Minimalist alternative for Base. Build complex APIs with small units called plugins. Works well with most of the already existing… [more](https://github.com/node-minibase/minibase#readme) | [homepage](https://github.com/node-minibase/minibase#readme "Minimalist alternative for Base. Build complex APIs with small units called plugins. Works well with most of the already existing [base][] plugins.") | ||
- [try-catch-core](https://www.npmjs.com/package/try-catch-core): Low-level package to handle completion and errors of sync or asynchronous functions, using [once][] and [dezalgo][] libs. Useful for and… [more](https://github.com/hybridables/try-catch-core#readme) | [homepage](https://github.com/hybridables/try-catch-core#readme "Low-level package to handle completion and errors of sync or asynchronous functions, using [once][] and [dezalgo][] libs. Useful for and used in higher-level libs such as [always-done][] to handle completion of anything.") | ||
|
||
## Contributing | ||
Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](https://github.com/tunnckoCore/tmp-filepath/issues/new). | ||
Please read the [contributing guidelines](CONTRIBUTING.md) for advice on opening issues, pull requests, and coding standards. | ||
If you need some help and can spent some cash, feel free to [contact me at CodeMentor.io](https://www.codementor.io/tunnckocore?utm_source=github&utm_medium=button&utm_term=tunnckocore&utm_campaign=github) too. | ||
|
||
**In short:** If you want to contribute to that project, please follow these things | ||
|
||
1. Please DO NOT edit [README.md](README.md), [CHANGELOG.md](CHANGELOG.md) and [.verb.md](.verb.md) files. See ["Building docs"](#building-docs) section. | ||
2. Ensure anything is okey by installing the dependencies and run the tests. See ["Running tests"](#running-tests) section. | ||
3. Always use `npm run commit` to commit changes instead of `git commit`, because it is interactive and user-friendly. It uses [commitizen][] behind the scenes, which follows Conventional Changelog idealogy. | ||
4. Do NOT bump the version in package.json. For that we use `npm run release`, which is [standard-version][] and follows Conventional Changelog idealogy. | ||
|
||
Thanks a lot! :) | ||
|
||
## Building docs | ||
Documentation and that readme is generated using [verb-generate-readme][], which is a [verb][] generator, so you need to install both of them and then run `verb` command like that | ||
|
||
``` | ||
$ npm install verbose/verb#dev verb-generate-readme --global && verb | ||
``` | ||
|
||
_Please don't edit the README directly. Any changes to the readme must be made in [.verb.md](.verb.md)._ | ||
|
||
## Running tests | ||
Clone repository and run the following in that cloned directory | ||
|
||
``` | ||
$ npm install && npm test | ||
``` | ||
|
||
## Author | ||
**Charlike Mike Reagent** | ||
|
||
+ [github/tunnckoCore](https://github.com/tunnckoCore) | ||
+ [twitter/tunnckoCore](http://twitter.com/tunnckoCore) | ||
+ [codementor/tunnckoCore](https://codementor.io/tunnckoCore) | ||
|
||
## License | ||
Copyright © 2016-2017, [Charlike Mike Reagent](http://i.am.charlike.online). Released under the [MIT license](LICENSE). | ||
|
||
*** | ||
|
||
_This file was generated by [verb-generate-readme](https://github.com/verbose/verb-generate-readme), v0.2.3, on January 03, 2017._ | ||
_Project scaffolded using [charlike][] cli._ | ||
|
||
[downloads-url]: https://www.npmjs.com/package/tmp-filepath | ||
[downloads-img]: https://img.shields.io/npm/dt/tmp-filepath.svg | ||
|
||
[codeclimate-url]: https://codeclimate.com/github/tunnckoCore/tmp-filepath | ||
[codeclimate-img]: https://img.shields.io/codeclimate/github/tunnckoCore/tmp-filepath.svg | ||
|
||
[travis-url]: https://travis-ci.org/tunnckoCore/tmp-filepath | ||
[travis-img]: https://img.shields.io/travis/tunnckoCore/tmp-filepath/master.svg?label=linux | ||
|
||
[appveyor-url]: https://ci.appveyor.com/project/tunnckoCore/tmp-filepath | ||
[appveyor-img]: https://img.shields.io/appveyor/ci/tunnckoCore/tmp-filepath/master.svg?label=windows | ||
|
||
[coveralls-url]: https://coveralls.io/r/tunnckoCore/tmp-filepath | ||
[coveralls-img]: https://img.shields.io/coveralls/tunnckoCore/tmp-filepath.svg | ||
|
||
[david-url]: https://david-dm.org/tunnckoCore/tmp-filepath | ||
[david-img]: https://img.shields.io/david/tunnckoCore/tmp-filepath.svg | ||
|
||
[standard-url]: https://github.com/feross/standard | ||
[standard-img]: https://img.shields.io/badge/code%20style-standard-brightgreen.svg | ||
|
||
[always-done]: https://github.com/hybridables/always-done | ||
[async-done]: https://github.com/gulpjs/async-done | ||
[base]: https://github.com/node-base/base | ||
[charlike]: https://github.com/tunnckocore/charlike | ||
[commitizen]: https://github.com/commitizen/cz-cli | ||
[cuid]: https://github.com/ericelliott/cuid | ||
[dezalgo]: https://github.com/npm/dezalgo | ||
[once]: https://github.com/isaacs/once | ||
[standard-version]: https://github.com/conventional-changelog/standard-version | ||
[verb-generate-readme]: https://github.com/verbose/verb-generate-readme | ||
[verb]: https://github.com/verbose/verb |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters