bumpp 8.0.0 → 8.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE CHANGED
@@ -1,6 +1,7 @@
1
1
  The MIT License (MIT)
2
2
 
3
3
  Copyright (c) 2015 James Messinger
4
+ Copyright (c) 2022 Anthony Fu
4
5
 
5
6
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
7
  of this software and associated documentation files (the "Software"), to deal
package/README.md CHANGED
@@ -13,272 +13,3 @@ Forked from [`version-bump-prompt`](https://github.com/JS-DevTools/version-bump-
13
13
  - Confirmation before bumping.
14
14
  - Enable `--commit` `--tag` `--push` by default. (opt-out by `--no-push`, etc.)
15
15
  - Conventional Commits by default.
16
-
17
- <details>
18
- <summary>Original README</summary>
19
-
20
- # Version Bump Prompt
21
-
22
- [![Cross-Platform Compatibility](https://jstools.dev/img/badges/os-badges.svg)](https://github.com/JS-DevTools/version-bump-prompt/actions)
23
- [![Build Status](https://github.com/JS-DevTools/version-bump-prompt/workflows/CI-CD/badge.svg)](https://github.com/JS-DevTools/version-bump-prompt/actions)
24
-
25
- [![Coverage Status](https://coveralls.io/repos/github/JS-DevTools/version-bump-prompt/badge.svg?branch=master)](https://coveralls.io/github/JS-DevTools/version-bump-prompt)
26
- [![Dependencies](https://david-dm.org/JS-DevTools/version-bump-prompt.svg)](https://david-dm.org/JS-DevTools/version-bump-prompt)
27
-
28
- [![npm](https://img.shields.io/npm/v/@jsdevtools/version-bump-prompt.svg)](https://www.npmjs.com/package/@jsdevtools/version-bump-prompt)
29
- [![License](https://img.shields.io/npm/l/@jsdevtools/version-bump-prompt.svg)](LICENSE)
30
- [![Buy us a tree](https://img.shields.io/badge/Treeware-%F0%9F%8C%B3-lightgreen)](https://plant.treeware.earth/JS-DevTools/version-bump-prompt)
31
-
32
- ### Automate your release process with a single command that can:
33
-
34
- - Prompt for the type of version bump
35
-
36
- - Bump the version number **any** file, including:
37
- - `package.json`
38
- - `package-lock.json`
39
- - config files
40
- - source code files
41
- - ReadMe files
42
- - license files
43
-
44
- - Run your `preversion`, `version`, and `postversion` scripts
45
-
46
- - Commit changes to git
47
-
48
- - Tag the commit with the version number
49
-
50
- - Push the commit to remote
51
-
52
-
53
-
54
- Installation
55
- --------------------------
56
- You can install `version-bump-prompt` via [npm](https://docs.npmjs.com/about-npm/).
57
-
58
- ```bash
59
- npm install -g @jsdevtools/version-bump-prompt
60
- ```
61
-
62
-
63
-
64
- Usage
65
- --------------------------
66
-
67
- ```
68
- bump [release] [options] [files...]
69
-
70
- Automatically (or with prompts) bump your version number, commit changes, tag, and push to Git
71
-
72
- release:
73
- The release version or type. Can be one of the following:
74
- - A semver version number (ex: 1.23.456)
75
- - prompt: Prompt for the version number (this is the default)
76
- - major: Increase major version
77
- - minor: Increase minor version
78
- - patch: Increase patch version
79
- - premajor: Increase major version, pre-release
80
- - preminor: Increase preminor version, pre-release
81
- - prepatch: Increase prepatch version, pre-release
82
- - prerelease: Increase prerelease version
83
-
84
- options:
85
- --preid <name> The identifier for prerelease versions.
86
- Defaults to "beta".
87
-
88
- -c, --commit [message] Commit changed files to Git.
89
- Defaults to "release vX.X.X".
90
-
91
- -t, --tag [tag] Tag the commit in Git.
92
- The Default tag is "vX.X.X"
93
-
94
- -p, --push Push the Git commit.
95
-
96
- -a, --all Commit/tag/push ALL pending files,
97
- not just the ones that were bumped.
98
- (same as "git commit -a")
99
-
100
- --no-verify Bypass Git commit hooks
101
- (same as "git commit --no-verify")
102
-
103
- -v, --version Show the version number
104
-
105
- -q, --quiet Suppress unnecessary output
106
-
107
- -h, --help Show usage information
108
-
109
- --ignore-scripts Bypass version scripts
110
-
111
- files...
112
- One or more files and/or globs to bump (ex: README.md *.txt docs/**/*).
113
- Defaults to package.json and package-lock.json.
114
- ```
115
-
116
-
117
-
118
- Examples
119
- --------------------------
120
-
121
- ### Default Behavior (no arguments)
122
-
123
- ```
124
- bump
125
- ```
126
-
127
- When run without any arguments, the `bump` command will do the following:
128
-
129
- - Prompt the user to select the bump type (major, minor, prerelease, etc.)
130
- - Update the version number in `package.json` and `package-lock.json`
131
- - Run any [npm version scripts](https://docs.npmjs.com/cli/version.html) (`preversion`, `version`, or `postversion`)
132
- - It will **NOT** commit, tag, or push to git.
133
-
134
-
135
- ### Bump Without Prompting
136
- You can specify an explicit version number:
137
-
138
- ```
139
- bump 1.23.456
140
- bump 1.23.456-beta.1
141
- ```
142
-
143
- Or you can specify a release type:
144
-
145
- ```
146
- bump major
147
- bump patch
148
- bump prerelease
149
- ```
150
-
151
- For pre-releases, the default identifier is "beta". You can change it using the `--preid` argument:
152
-
153
- ```
154
- bump premajor --preid alpha
155
- ```
156
-
157
- All of the above commands do the following:
158
-
159
- - Update the version number in `package.json` and `package-lock.json`
160
- - Run any [npm version scripts](https://docs.npmjs.com/cli/version.html) (`preversion`, `version`, or `postversion`)
161
- - It will **NOT** commit, tag, or push to git.
162
-
163
-
164
-
165
- ### Git Commit
166
- You can use the `--commit` argument by itself to prompt the user for the version number. If you don't specify a commit message, then it defaults to "**release vX.X.X**". If you _do_ specify a commit message, then the version number will be appended to it. Or you can insert `%s` placeholders in the message, and they'll be replaced with the version number instead.
167
-
168
- ```
169
- bump --commit
170
- bump --commit "This is release v"
171
- bump --commit "The v%s release"
172
- ```
173
-
174
- You can also specify a release type instead of prompting the user:
175
-
176
- ```
177
- bump major --commit
178
- bump minor --commit "This is release v"
179
- bump patch --commit "The v%s release"
180
- ```
181
-
182
- The above commands do the following:
183
-
184
- - Update the version number in `package.json` and `package-lock.json`
185
- - Run any [npm version scripts](https://docs.npmjs.com/cli/version.html) (`preversion`, `version`, or `postversion`)
186
- - Commit the `package.json` and `package-lock.json` files to git
187
- - The commit will **NOT** be tagged
188
- - The commit will **NOT** be pushed to the remote
189
-
190
-
191
- ### Git Tag
192
- The `--commit` argument does not tag the commit by default. You can use the `--tag` argument to do that. You can optionally specify a tag name, which can contain `%s` placeholders, just like the commit message.
193
-
194
- You don't need to specify the `--commit` argument, since it's implied by `--tag`. Unless you want to customize the commit message.
195
-
196
- ```
197
- bump --tag
198
- bump major --tag "v%s tag"
199
- bump patch --commit "release v" --tag "v"
200
- ```
201
-
202
- The above commands do the following:
203
-
204
- - Update the version number in `package.json` and `package-lock.json`
205
- - Run any [npm version scripts](https://docs.npmjs.com/cli/version.html) (`preversion`, `version`, or `postversion`)
206
- - Commit the `package.json` and `package-lock.json` files to git
207
- - Tag the commit
208
- - The commit will **NOT** be pushed to the remote
209
-
210
-
211
- ### Git Push
212
- The `--push` argument pushes the git commit and tags.
213
-
214
- ```
215
- bump --commit --push
216
- bump major --tag --push
217
- bump patch --tag "v%s tag" --push
218
- bump prerelease --commit "release v" --tag "v" --push
219
- ```
220
-
221
-
222
- ### Specifying Files to Update
223
- All of the `bump` commands shown above operate on the `package.json` and `package-lock.json` files by default. You can specify a custom list of files and/or [glob patterns](https://www.npmjs.com/package/glob#glob-primer) to update instead.
224
-
225
- > **Note:** If you specify your own file list, then the `package.json` and `package-lock.json` files will **not** be updated by default. You need to explicitly include them in your file list if you want them updated.
226
-
227
- ```
228
- bump README.md
229
- bump package.json package-lock.json README.md
230
- bump *.json *.md
231
- ```
232
-
233
-
234
-
235
- Version Scripts
236
- --------------------------
237
- `version-bump-prompt` will execute your `preversion`, `version`, and `postversion` scripts, just like [the `npm version` command](https://docs.npmjs.com/cli/version) does. If your `package.json` file contains any or all of these scripts, then they will be executed in the following order:
238
-
239
- - The `preversion` script runs before the version is updated (and before the version prompt is shown)
240
- - The `version` script runs after the version is updated, but _before_ `git commit` and `git tag`
241
- - The `postversion` script runs after `git commit` and `git tag`, but _before_ `git push`
242
-
243
-
244
-
245
- Contributing
246
- --------------------------
247
- Contributions, enhancements, and bug-fixes are welcome! [Open an issue](https://github.com/JS-DevTools/version-bump-prompt/issues) on GitHub and [submit a pull request](https://github.com/JS-DevTools/version-bump-prompt/pulls).
248
-
249
- #### Building
250
- To build the project locally on your computer:
251
-
252
- 1. __Clone this repo__<br>
253
- `git clone https://github.com/JS-DevTools/version-bump-prompt.git`
254
-
255
- 2. __Install dependencies__<br>
256
- `npm install`
257
-
258
- 3. __Build the code__<br>
259
- `npm run build`
260
-
261
- 4. __Run the tests__<br>
262
- `npm test`
263
-
264
-
265
-
266
- License
267
- --------------------------
268
- Version Bump Prompt is 100% free and open-source, under the [MIT license](LICENSE). Use it however you want.
269
-
270
- This package is [Treeware](http://treeware.earth). If you use it in production, then we ask that you [**buy the world a tree**](https://plant.treeware.earth/JS-DevTools/version-bump-prompt) to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.
271
-
272
-
273
-
274
- Big Thanks To
275
- --------------------------
276
- Thanks to these awesome companies for their support of Open Source developers ❤
277
-
278
- [![GitHub](https://jstools.dev/img/badges/github.svg)](https://github.com/open-source)
279
- [![NPM](https://jstools.dev/img/badges/npm.svg)](https://www.npmjs.com/)
280
- [![Coveralls](https://jstools.dev/img/badges/coveralls.svg)](https://coveralls.io)
281
- [![Travis CI](https://jstools.dev/img/badges/travis-ci.svg)](https://travis-ci.com)
282
- [![SauceLabs](https://jstools.dev/img/badges/sauce-labs.svg)](https://saucelabs.com)
283
-
284
- </details>