Skip to content

Commit 2c64cec

Browse files
authored
📝 feat: update readme and license (#2)
1 parent 1b13c68 commit 2c64cec

File tree

4 files changed

+109
-1
lines changed

4 files changed

+109
-1
lines changed

.npmignore

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,7 @@
11
/node_modules
22
/src
3+
/assets
4+
.github/
5+
coverage/
36

47
tsconfig.json

LICENSE

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
MIT License
2+
3+
Copyright (c) Meta Platforms, Inc. and affiliates.
4+
Copyright Contributors to the RunScript project.
5+
6+
Permission is hereby granted, free of charge, to any person obtaining a copy
7+
of this software and associated documentation files (the "Software"), to deal
8+
in the Software without restriction, including without limitation the rights
9+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
10+
copies of the Software, and to permit persons to whom the Software is
11+
furnished to do so, subject to the following conditions:
12+
13+
The above copyright notice and this permission notice shall be included in all
14+
copies or substantial portions of the Software.
15+
16+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
17+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
19+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
20+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
21+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
22+
SOFTWARE.

README.md

Lines changed: 84 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,86 @@
1-
# RunScript
1+
<p align="center">
2+
<a href="https://www.npmjs.com/package/@gabsf-dev/run-script"><img src="https://img.shields.io/npm/v/%40gabsf-dev%2Frun-script
3+
" alt="npm version"></a>
4+
<a href="https://github.com/gabsf-dev/run-script/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="RunScript is released under the MIT license."></a>
5+
</p>
6+
<p align="center">
7+
<a href="https://github.com/gabsf-dev/run-script/blob/main/.github/workflows/publish.yml"><img alt="GitHub CI Status" src="https://img.shields.io/github/actions/workflow/status/gabsf-dev/run-script/publish.yml?branch=main&logo=github&label=CI
8+
"></a>
9+
</p>
10+
11+
<!-- A spacer -->
12+
<p>&nbsp;</p>
13+
14+
<h1 align="center">RunScript</h1>
215

316
The effortlessly way to run your package.json scripts
17+
18+
## Getting Started
19+
20+
To use `run-script` it's simple as to run:
21+
22+
```bash
23+
npx @gabsf-dev/run-script
24+
```
25+
26+
Or to install globally:
27+
28+
```bash
29+
npm i -g @gabsf-dev/run-script
30+
```
31+
32+
and run it using:
33+
34+
```bash
35+
run-script
36+
```
37+
38+
After that, just choose the script that you want to run, and RunScript make the rest, since choosing `npm` or `yarn` to run your script based on the lock file present in the folder, to logging all of the script execution for you.
39+
40+
## Flags
41+
42+
RunScript provides the following flags:
43+
44+
- _-V, --version_
45+
46+
Logs the RunScript current version.
47+
48+
```bash
49+
npx @gabsf-dev/run-script -V
50+
```
51+
52+
- _-h, --help_
53+
54+
Logs the RunScript help.
55+
56+
```bash
57+
npx @gabsf-dev/run-script -h
58+
```
59+
60+
- _-v, --view_
61+
62+
Only show the scripts listed in your `package.json` in a table format.
63+
64+
```bash
65+
npx @gabsf-dev/run-script --view
66+
```
67+
68+
<p align="center">
69+
<img src="./assets/run-script-view.png" alt="RunScript view example">
70+
</p>
71+
72+
- _--ai_
73+
74+
With the `--ai` flag, you can receive ai thoughts about the scripts presents in the `package.json`. It's a coming soon feature, so stay tuned for the future updates.
75+
76+
```bash
77+
npx @gabsf-dev/run-script --ai
78+
```
79+
80+
## License
81+
82+
RunScript is [MIT licensed](./LICENSE).
83+
84+
## Copyright
85+
86+
Copyright Contributors to the RunScript project.

assets/run-script-view.png

64.4 KB
Loading

0 commit comments

Comments
 (0)