-
-
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.
BREAKING CHANGE: First release
- Loading branch information
tunnckoCore
committed
Mar 12, 2017
1 parent
c431ef9
commit acac1a2
Showing
13 changed files
with
3,884 additions
and
0 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,12 @@ | ||
root = true | ||
|
||
[*] | ||
indent_style = space | ||
indent_size = 2 | ||
charset = utf-8 | ||
trim_trailing_whitespace = true | ||
insert_final_newline = true | ||
|
||
[*.md] | ||
trim_trailing_whitespace = false | ||
insert_final_newline = false |
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,70 @@ | ||
# Always-ignore dirs # | ||
# #################### | ||
_gh_pages | ||
node_modules | ||
jspm_packages | ||
bower_components | ||
components | ||
vendor | ||
build | ||
dest | ||
lib-cov | ||
coverage | ||
nbproject | ||
cache | ||
temp | ||
tmp | ||
clean-stacktrace-metadata | ||
|
||
# Packages # | ||
# ########## | ||
*.7z | ||
*.dmg | ||
*.iso | ||
*.jar | ||
*.rar | ||
*.tar | ||
*.zip | ||
|
||
# OS, Logs and databases # | ||
# ######################### | ||
logs | ||
*.pid | ||
*.dat | ||
*.log | ||
*.sql | ||
*.sqlite | ||
*~ | ||
~* | ||
|
||
# Another files # | ||
# ############### | ||
Icon? | ||
.DS_Store* | ||
Thumbs.db | ||
ehthumbs.db | ||
Desktop.ini | ||
npm-debug.log | ||
.directory | ||
._* | ||
lcov.info | ||
|
||
# Runtime data | ||
pids | ||
*.pid | ||
*.seed | ||
*.pid.lock | ||
|
||
|
||
# nyc test coverage | ||
.nyc_output | ||
|
||
# Grunt intermediate storage | ||
# see here: http://gruntjs.com/creating-plugins#storing-task-files | ||
.grunt | ||
|
||
# Optional npm cache directory | ||
.npm | ||
|
||
# Optional REPL history | ||
.node_repl_history |
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,14 @@ | ||
sudo: false | ||
language: node_js | ||
|
||
node_js: | ||
- "node" | ||
- "6" | ||
- "4" | ||
- "0.12" | ||
- "0.10" | ||
|
||
notifications: | ||
email: false | ||
|
||
after_success: bash <(curl -s https://codecov.io/bash) |
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,115 @@ | ||
# {%= name %} {%= badge('npm') %} [![mit license][license-img]][license-url] {%= badge('downloads') %} [![npm total downloads][downloads-img]][downloads-url] | ||
|
||
> {%= description %} | ||
[![code climate][codeclimate-img]][codeclimate-url] | ||
[![code style][standard-img]][standard-url] | ||
[![linux build][travis-img]][travis-url] | ||
[![windows build][appveyor-img]][appveyor-url] | ||
[![code coverage][coverage-img]][coverage-url] | ||
[![dependency status][david-img]][david-url] | ||
[![paypal donate][paypalme-img]][paypalme-url] | ||
|
||
{%= include('highlight') %} | ||
|
||
## Table of Contents | ||
<!-- toc --> | ||
|
||
## Install | ||
Install with [npm](https://www.npmjs.com/) | ||
|
||
``` | ||
$ npm install {%= name %} --save | ||
``` | ||
|
||
or install using [yarn](https://yarnpkg.com) | ||
|
||
``` | ||
$ yarn add {%= name %} | ||
``` | ||
|
||
## Usage | ||
> For more use-cases see the [tests](test.js) | ||
```js | ||
const {%= varname %} = require('{%= name %}') | ||
``` | ||
|
||
## API | ||
{%= apidocs('index.js') %} | ||
|
||
{% if (verb.related && verb.related.list && verb.related.list.length) { %} | ||
## Related | ||
{%= related(verb.related.list, {words: 20}) %} | ||
{% } %} | ||
|
||
## Contributing | ||
Pull requests and stars are always welcome. For bugs and feature requests, [please create an issue](https://github.com/{%= repository %}/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 | ||
{%= includeEither('authors', 'author') %} | ||
+ [codementor/tunnckoCore](https://codementor.io/tunnckoCore) | ||
|
||
## License | ||
{%= copyright({ start: 2017, linkify: true, prefix: 'Copyright', symbol: '©' }) %} {%= licenseStatement %} | ||
|
||
*** | ||
|
||
{%= include('footer') %} | ||
_Project scaffolded using [charlike][] cli._ | ||
|
||
{%= reflinks(verb.reflinks) %} | ||
|
||
[license-url]: https://www.npmjs.com/package/{%= name %} | ||
[license-img]: https://img.shields.io/npm/l/{%= name %}.svg | ||
|
||
[downloads-url]: https://www.npmjs.com/package/{%= name %} | ||
[downloads-img]: https://img.shields.io/npm/dt/{%= name %}.svg | ||
|
||
[codeclimate-url]: https://codeclimate.com/github/{%= repository %} | ||
[codeclimate-img]: https://img.shields.io/codeclimate/github/{%= repository %}.svg | ||
|
||
[travis-url]: https://travis-ci.org/{%= repository %} | ||
[travis-img]: https://img.shields.io/travis/{%= repository %}/master.svg?label=linux | ||
|
||
[appveyor-url]: https://ci.appveyor.com/project/tunnckoCore/{%= name %} | ||
[appveyor-img]: https://img.shields.io/appveyor/ci/tunnckoCore/{%= name %}/master.svg?label=windows | ||
|
||
[coverage-url]: https://codecov.io/gh/{%= repository %} | ||
[coverage-img]: https://img.shields.io/codecov/c/github/{%= repository %}/master.svg | ||
|
||
[david-url]: https://david-dm.org/{%= repository %} | ||
[david-img]: https://img.shields.io/david/{%= repository %}.svg | ||
|
||
[standard-url]: https://github.com/feross/standard | ||
[standard-img]: https://img.shields.io/badge/code%20style-standard-brightgreen.svg | ||
|
||
[paypalme-url]: https://www.paypal.me/tunnckoCore | ||
[paypalme-img]: https://img.shields.io/badge/paypal-donate-brightgreen.svg |
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,4 @@ | ||
|
||
|
||
## 0.0.0 - 2017-03-13 | ||
- Initial commit |
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,154 @@ | ||
# Contributing to clean-stacktrace-metadata | ||
|
||
:sparkles: Thanks for your contribution in advance! :tada: | ||
|
||
First and foremost, thank you! We appreciate that you want to contribute to `clean-stacktrace-metadata`, your time is valuable, and your contributions mean a lot to us. | ||
|
||
## What does "contributing" mean? | ||
|
||
There are many ways to contribute to an open source project, including: | ||
|
||
- Updating or correcting documentation | ||
- Feature requests | ||
- Submitting bug reports | ||
|
||
But you aren't limited to these things. Use your imagination. If you like a project, and you see something that can or should be improved, then you have an opportunity (but not an obligation) to contribute. | ||
|
||
### Improve documentation | ||
|
||
As a user of `clean-stacktrace-metadata` you're the perfect candidate to help us improve our documentation. Typo corrections, error fixes, better explanations, more examples, etc. Open issues for things that could be improved. Anything. Even improvements to this document. | ||
|
||
Use the [`docs` label](https://github.com/tunnckoCore/clean-stacktrace-metadata/labels/docs) to find suggestions for what we'd love to see more documentation on. | ||
|
||
### Improve issues | ||
|
||
Some issues are created with missing information, not reproducible, or plain invalid. Help make them easier to resolve. Handling issues takes a lot of time that we could rather spend on fixing bugs and adding features. | ||
|
||
### Give feedback on issues | ||
|
||
We're always looking for more opinions on discussions in the issue tracker. It's a good opportunity to influence the future direction of `clean-stacktrace-metadata`. | ||
|
||
The [`question` label](https://github.com/tunnckoCore/clean-stacktrace-metadata/labels/question%20%2F%20discussion) is a good place to find ongoing discussions. | ||
|
||
|
||
## Why should I contribute? | ||
|
||
Regardless of the details, being an effective contributor means that you're adding _adding value_ to a project. | ||
|
||
Here are just a few of the advantages of adding value to a project: | ||
|
||
- you gain the appreciation and respect of the project's maintainers and community | ||
- you gain valuable experience | ||
- you get noticed by job recruiters | ||
- you become more attrative to potential employers. | ||
|
||
## Getting familiarized with a project | ||
|
||
Before you attempt to contribute to a project, take a moment to get familiarized with it. In most cases you can learn all you need to know within a couple of minutes. | ||
|
||
### Required | ||
|
||
The following items are a pre-requisite for contributing to any project. Avoid creating issues or doing pull requests until you've done all of these things: | ||
|
||
- **Review the readme**: Oftentimes a project readme has links to documentation, advice on creating issues or bug reports, and so on. | ||
- **Read contributing guidelines**: look for a `CONTRIBUTING.md` file and, if one exists, read it in its entirety before creating issues or doing a pull request. Typically this is in the root of the project, but it might be in `.github/CONTRIBUTING.md`. | ||
- **Search issues**: Before creating bug reports, feature requests, or submitting issues of any kind, you should always search for existing issues (closed or open) that address the same thing. | ||
|
||
### Recommended | ||
|
||
- **Review unit tests** - one of the best ways to get familiarized with a project is through its unit tests. Of course, this depends on the type of project, complexity, test coverage, and so on. But when applicable, test are often a good source of insight. | ||
- **Get familiarized with the code** - If the codebase is small, and you're familiar with the language, take a moment to review the code to see if you find anything that can be improved. If the codebase is large, you might be able to provide domain expertise or fixes for specific areas. | ||
- **Ask questions** - Depending the project type and size, it might be good to start by searching google to find anwers to your questions. Then, check to see if the project uses [gitter](https://gitter.im) or has a [slack](https://slack.com) channel, or something similar. Also visit [stackoverflow](https://stackoverflow.com) and do a search to see if others have already asked the same question. As a last resort, create an issue on the project's GitHub repository. | ||
|
||
|
||
## Details of Highly Effective Bug Reports | ||
|
||
### Rationale | ||
|
||
The easier you make it for a maintainter or members of the community to react, the more likely it is for them to react quickly. | ||
|
||
Like you, maintainers have to make decisions about where to spend their time. Not only within a given project, but oftentimes across multiple projects. If you're experiencing a bug and you want to make a report, bug reports that are clearly described and organized are much more likely to get addressed by the maintainers or member of the community. | ||
|
||
Providing these details up front will make everyone happy. If you don't provide these details, maintainers will have to ask you for them, which can be annoying for experienced maintainers who have had to ask for these crucial details many times. | ||
|
||
### The details | ||
|
||
Always include the following essential details in every bug report: | ||
|
||
1. **version**: what version of `clean-stacktrace-metadata` were you using when you experienced the bug? | ||
2. **description**: clear description of the bug, and minimum steps to reproduce it. | ||
3. **error messages**: paste any error messages into the issue or a [github gist](https://gist.github.com/), use [gfm code blocks][gfm]. | ||
4. **code**: paste any code necessary for reproducing the bug and use [gfm code blocks][gfm] to wrap the code. | ||
5. **title**: use a clear and descriptive title. | ||
|
||
See GitHub's guide to [Creating and highlighting code blocks][gfm] for more details. | ||
|
||
## Submitting a pull requests | ||
|
||
**Working on your first Pull Request?** | ||
|
||
You can learn how from this *free* video series ["How to Contribute to an Open Source Project on GitHub"][howto-oss-github] | ||
|
||
**Details** | ||
|
||
- Non-trivial changes are often best discussed in an issue first, to prevent you from doing unnecessary work. | ||
- For ambitious tasks, you should try to get your work in front of the community for feedback as soon as possible. Open a pull request as soon as you have done the minimum needed to demonstrate your idea. At this early stage, don't worry about making things perfect, or 100% complete. Add a [WIP] prefix to the title, and describe what you still need to do. This lets reviewers know not to nit-pick small details or point out improvements you already know you need to make. | ||
- New features should be accompanied with tests and documentation. | ||
- Don't include unrelated changes. | ||
- Lint and test immediately after you fork by running `$ npm test`. | ||
- Lint and test before submitting the pull request by running `$ npm test`. | ||
- Make the pull request from a [topic branch](https://github.com/dchelimsky/rspec/wiki/Topic-Branches), not master. | ||
- Use a clear and descriptive title for the pull request and commits. | ||
- Write a convincing description of why we should land your pull request. It's your job to convince us. Answer "why" it's needed and provide use-cases. | ||
- You might be asked to do changes to your pull request. There's never a need to open another pull request. [Just update the existing one.][amending] | ||
|
||
## Other ways to contribute | ||
|
||
### Show your support | ||
|
||
Sometimes we find a project we like but just don't have time to contribute. That's okay, there are other ways to show support: | ||
|
||
- Star the project | ||
- Tweet about it | ||
- Tell your friends | ||
|
||
### Show your appreciation | ||
|
||
Maintainers are people too. You can make someone's day by letting them know you appreciate their work. If you use a library in one of your own projects, let the author know you care: | ||
|
||
- Add a link to the project on your project's readme | ||
- Say "thanks" on twitter | ||
|
||
## Attribution | ||
|
||
This document is adapted from a few Contributing Guides. It is more general and can apply in most cases. Everyone is free to re-use it or re-adapt it. | ||
|
||
### Good to read | ||
|
||
- [Awesome Contributing][awesomelist] | ||
- [Idiomatic Contributing][idiomatic] | ||
- [AVA's Contributing Guide][avajs] | ||
- [Amending a commit Guide][amending] | ||
- [Creating and highlighting code blocks][gfm] | ||
- [Contributing to Open Source (GitHub)][os-on-github] | ||
- [How to contribute to Open Source Project (Egghead.io videos)][howto-oss-github] | ||
|
||
### Authors | ||
|
||
**Charlike Mike Reagent** | ||
|
||
* [github/tunnckoCore](https://github.com/tunnckoCore) | ||
* [twitter/tunnckoCore](http://twitter.com/tunnckoCore) | ||
|
||
## License | ||
|
||
Released under [Creative Commons](https://creativecommons.org/licenses/by/3.0/). | ||
Copyright © 2016, [Charlike Mike Reagent](http://www.tunnckocore.tk). | ||
|
||
[gfm]: https://help.github.com/articles/creating-and-highlighting-code-blocks/ | ||
[avajs]: https://github.com/avajs/ava/blob/master/contributing.md | ||
[idiomatic]: https://github.com/jonschlinkert/idiomatic-contributing | ||
[awesomelist]: https://github.com/jonschlinkert/awesome-contributing | ||
[amending]: https://github.com/RichardLitt/docs/blob/master/amending-a-commit-guide.md | ||
[os-on-github]: https://guides.github.com/activities/contributing-to-open-source/ | ||
[howto-oss-github]: http://j.mp/how-to-contrib-on-github |
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,21 @@ | ||
The MIT License (MIT) | ||
|
||
Copyright (c) Charlike Mike Reagent <@tunnckoCore> (https://i.am.charlike.online) | ||
|
||
Permission is hereby granted, free of charge, to any person obtaining a copy | ||
of this software and associated documentation files (the "Software"), to deal | ||
in the Software without restriction, including without limitation the rights | ||
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | ||
copies of the Software, and to permit persons to whom the Software is | ||
furnished to do so, subject to the following conditions: | ||
|
||
The above copyright notice and this permission notice shall be included in all | ||
copies or substantial portions of the Software. | ||
|
||
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | ||
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | ||
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE | ||
SOFTWARE. |
Oops, something went wrong.