1 |
|
2 |
|
3 |
|
4 | [![idea](http://i.imgur.com/BGMt0Ne.png)](#)
|
5 |
|
6 | # `$ idea`
|
7 |
|
8 | [![Support me on Patreon][badge_patreon]][patreon] [![Buy me a book][badge_amazon]][amazon] [![PayPal][badge_paypal_donate]][paypal-donations] [![Ask me anything](https://img.shields.io/badge/ask%20me-anything-1abc9c.svg)](https://github.com/IonicaBizau/ama) [![Version](https://img.shields.io/npm/v/idea.svg)](https://www.npmjs.com/package/idea) [![Downloads](https://img.shields.io/npm/dt/idea.svg)](https://www.npmjs.com/package/idea) [![Get help on Codementor](https://cdn.codementor.io/badges/get_help_github.svg)](https://www.codementor.io/johnnyb?utm_source=github&utm_medium=button&utm_term=johnnyb&utm_campaign=github)
|
9 |
|
10 | <a href="https://www.buymeacoffee.com/H96WwChMy" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/yellow_img.png" alt="Buy Me A Coffee"></a>
|
11 |
|
12 | > A lightweight CLI tool and module for keeping ideas in a safe place quick and easy.
|
13 |
|
14 | ## :cloud: Installation
|
15 |
|
16 | You can install the package globally and use it as command line tool:
|
17 |
|
18 |
|
19 | ```sh
|
20 | # Using npm
|
21 | npm install --global idea
|
22 |
|
23 | # Using yarn
|
24 | yarn global add idea
|
25 | ```
|
26 |
|
27 |
|
28 | Then, run `idea --help` and see what the CLI tool can do.
|
29 |
|
30 |
|
31 | ```
|
32 | $ idea --help
|
33 | idea help
|
34 | usage: idea [command] <idea|filter|id>
|
35 |
|
36 | A lightweight CLI tool and module for keeping your ideas in a safe place quick and easy.
|
37 |
|
38 | [command]
|
39 | create <idea> Creates and saves a new idea. Example: `idea create "Implement something very cool"`
|
40 | list Lists all ideas. Example: `idea list`
|
41 | filter <filter> Lists filtered ideas. Example: `idea filter '{"state": "SOLVED"}'`
|
42 | solve <id> Solves an idea. Example `idea solve 1`
|
43 | help Prints this help.
|
44 |
|
45 | Documentation can be found at https://github.com/IonicaBizau/idea
|
46 | ```
|
47 |
|
48 | ## :clipboard: Example
|
49 |
|
50 |
|
51 | Here is an example how to use this package as library. To install it locally, as library, you can do that using `npm` (or `yarn`):
|
52 |
|
53 | ```sh
|
54 | # Using npm
|
55 | npm install --save idea
|
56 |
|
57 | # Using yarn
|
58 | yarn add idea
|
59 | ```
|
60 |
|
61 |
|
62 |
|
63 | ```js
|
64 | // Dependencies
|
65 | var Idea = require("idea");
|
66 |
|
67 | // Initialize the idea object
|
68 | var idea = new Idea("./ideas.json", err => {
|
69 | if (err) throw err;
|
70 | idea.create("Implement something cool.", err => {
|
71 | if (err) throw err;
|
72 | });
|
73 | });
|
74 | ```
|
75 |
|
76 |
|
77 |
|
78 | ## :question: Get Help
|
79 |
|
80 | There are few ways to get help:
|
81 |
|
82 | 1. Please [post questions on Stack Overflow](https://stackoverflow.com/questions/ask). You can open issues with questions, as long you add a link to your Stack Overflow question.
|
83 | 2. For bug reports and feature requests, open issues. :bug:
|
84 |
|
85 | 3. For direct and quick help, you can [use Codementor](https://www.codementor.io/johnnyb). :rocket:
|
86 |
|
87 |
|
88 |
|
89 | ## :memo: Documentation
|
90 |
|
91 | For full API reference, see the [DOCUMENTATION.md][docs] file.
|
92 |
|
93 | ## :yum: How to contribute
|
94 | Have an idea? Found a bug? See [how to contribute][contributing].
|
95 |
|
96 |
|
97 | ## :sparkling_heart: Support my projects
|
98 |
|
99 | I open-source almost everything I can, and I try to reply to everyone needing help using these projects. Obviously,
|
100 | this takes time. You can integrate and use these projects in your applications *for free*! You can even change the source code and redistribute (even resell it).
|
101 |
|
102 | However, if you get some profit from this or just want to encourage me to continue creating stuff, there are few ways you can do it:
|
103 |
|
104 |
|
105 | - Starring and sharing the projects you like :rocket:
|
106 | - [![Buy me a book][badge_amazon]][amazon]—I love books! I will remember you after years if you buy me one. :grin: :book:
|
107 | - [![PayPal][badge_paypal]][paypal-donations]—You can make one-time donations via PayPal. I'll probably buy a ~~coffee~~ tea. :tea:
|
108 | - [![Support me on Patreon][badge_patreon]][patreon]—Set up a recurring monthly donation and you will get interesting news about what I'm doing (things that I don't share with everyone).
|
109 | - **Bitcoin**—You can send me bitcoins at this address (or scanning the code below): `1P9BRsmazNQcuyTxEqveUsnf5CERdq35V6`
|
110 |
|
111 | ![](https://i.imgur.com/z6OQI95.png)
|
112 |
|
113 |
|
114 | Thanks! :heart:
|
115 |
|
116 |
|
117 |
|
118 | ## :scroll: License
|
119 |
|
120 | [MIT][license] © [Ionică Bizău][website]
|
121 |
|
122 |
|
123 | [badge_patreon]: https://ionicabizau.github.io/badges/patreon.svg
|
124 | [badge_amazon]: https://ionicabizau.github.io/badges/amazon.svg
|
125 | [badge_paypal]: https://ionicabizau.github.io/badges/paypal.svg
|
126 | [badge_paypal_donate]: https://ionicabizau.github.io/badges/paypal_donate.svg
|
127 |
|
128 | [patreon]: https://www.patreon.com/ionicabizau
|
129 | [amazon]: http://amzn.eu/hRo9sIZ
|
130 | [paypal-donations]: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=RVXDDLKKLQRJW
|
131 |
|
132 | [license]: http://showalicense.com/?fullname=Ionic%C4%83%20Biz%C4%83u%20%3Cbizauionica%40gmail.com%3E%20(https%3A%2F%2Fionicabizau.net)&year=2015#license-mit
|
133 | [website]: https://ionicabizau.net
|
134 | [contributing]: /CONTRIBUTING.md
|
135 | [docs]: /DOCUMENTATION.md
|