package-versioner 0.6.4 → 0.7.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/README.md +13 -6
- package/dist/index.cjs +1061 -169
- package/dist/index.js +1052 -160
- package/docs/changelogs.md +65 -0
- package/docs/{VERSIONING_STRATEGIES.md → versioning.md} +1 -1
- package/package-versioner.schema.json +31 -0
- package/package.json +11 -7
package/README.md
CHANGED
|
@@ -18,6 +18,8 @@ A lightweight yet powerful CLI tool for automated semantic versioning based on G
|
|
|
18
18
|
- Customizable through a `version.config.json` file or CLI options
|
|
19
19
|
- Automatically updates `package.json` or `Cargo.toml` version
|
|
20
20
|
- Creates appropriate Git tags for releases
|
|
21
|
+
- Automatically generates and maintains changelogs in Keep a Changelog or Angular format
|
|
22
|
+
- Integrates commit messages, breaking changes, and issue references into well-structured changelogs
|
|
21
23
|
- CI/CD friendly with JSON output support
|
|
22
24
|
|
|
23
25
|
## Supporting JavaScript and Rust Projects
|
|
@@ -98,7 +100,9 @@ Customize behavior by creating a `version.config.json` file in your project root
|
|
|
98
100
|
"versionPrefix": "v",
|
|
99
101
|
"tagTemplate": "${prefix}${version}",
|
|
100
102
|
"packageTagTemplate": "${packageName}@${prefix}${version}",
|
|
101
|
-
"commitMessage": "chore
|
|
103
|
+
"commitMessage": "chore: release ${packageName}@${version} [skip ci]",
|
|
104
|
+
"updateChangelog": true,
|
|
105
|
+
"changelogFormat": "keep-a-changelog",
|
|
102
106
|
"monorepo": {
|
|
103
107
|
"synced": true,
|
|
104
108
|
"skip": [
|
|
@@ -117,7 +121,9 @@ Customize behavior by creating a `version.config.json` file in your project root
|
|
|
117
121
|
**Notes:**
|
|
118
122
|
- Options like `synced`, `packages`, and `updateInternalDependencies` enable monorepo-specific behaviours.
|
|
119
123
|
- The `tagTemplate` and `packageTagTemplate` allow you to customize how Git tags are formatted for releases.
|
|
120
|
-
- The `commitMessage` template can include CI skip tokens like `[skip ci]` if you want to prevent CI runs after version commits (e.g., `"commitMessage": "chore
|
|
124
|
+
- The `commitMessage` template can include CI skip tokens like `[skip ci]` if you want to prevent CI runs after version commits (e.g., `"commitMessage": "chore: release ${packageName}@${version} [skip ci]"`). See [CI/CD Integration](./docs/CI_CD_INTEGRATION.md) for more details.
|
|
125
|
+
- The `updateChangelog` option controls whether to automatically generate and update changelogs for each package (default: true).
|
|
126
|
+
- The `changelogFormat` option sets the changelog style to either "keep-a-changelog" (default) or "angular".
|
|
121
127
|
- The `cargo` options can help when working with Rust projects:
|
|
122
128
|
- `enabled` (default: `true`): Set to `false` to disable Cargo.toml version handling
|
|
123
129
|
- `paths` (optional): Specify directories to search for Cargo.toml files
|
|
@@ -129,12 +135,13 @@ Customize behavior by creating a `version.config.json` file in your project root
|
|
|
129
135
|
1. **Conventional Commits:** Analyzes commit messages (like `feat:`, `fix:`, `BREAKING CHANGE:`) since the last tag.
|
|
130
136
|
2. **Branch Pattern:** Determines the bump based on the current or recently merged branch name matching predefined patterns.
|
|
131
137
|
|
|
132
|
-
For a detailed explanation of these concepts and monorepo modes (Synced vs. Async), see [Versioning Strategies and Concepts](./docs/
|
|
138
|
+
For a detailed explanation of these concepts and monorepo modes (Synced vs. Async), see [Versioning Strategies and Concepts](./docs/versioning.md).
|
|
133
139
|
|
|
134
140
|
## Documentation
|
|
135
141
|
|
|
136
|
-
- [Versioning Strategies and Concepts](./docs/
|
|
137
|
-
- [CI/CD Integration](./docs/
|
|
142
|
+
- [Versioning Strategies and Concepts](./docs/versioning.md) - Detailed explanation of versioning approaches
|
|
143
|
+
- [CI/CD Integration](./docs/ci_cd_integration.md) - Guide for integrating with CI/CD pipelines
|
|
144
|
+
- [Changelog Generation](./docs/changelogs.md) - How changelogs are automatically generated and maintained
|
|
138
145
|
|
|
139
146
|
For more details on available CLI options, run:
|
|
140
147
|
|
|
@@ -148,4 +155,4 @@ This project was originally forked from and inspired by [`jucian0/turbo-version`
|
|
|
148
155
|
|
|
149
156
|
## License
|
|
150
157
|
|
|
151
|
-
MIT
|
|
158
|
+
MIT
|