autorel 0.0.30 → 0.0.32

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.
Files changed (2) hide show
  1. package/README.md +28 -7
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -20,26 +20,27 @@ Autorel automatically does the following, if appropriate:
20
20
  - Runs any arbitrary command or bash script after the release is complete
21
21
 
22
22
  **✅ Conventional Commit and SemVer Compliant**
23
- -`autorel` is 100% compliant with Conventional Commits and SemVer out of the box, including "!" for breaking changes
23
+ - 100% compliant with Conventional Commits and SemVer out of the box, including "!" for breaking changes
24
24
 
25
25
  **😃 Simple & Easy to Use**
26
26
  - No confusing configuration files or complex setup
27
27
  - Works with any CI/CD system, including GitHub Actions
28
28
  - Built-in TypeScript and bash script support
29
29
 
30
- **💪 Flexible & Powerful**
31
- - Use via `npx`, or import as a library
32
- - If using CLI, supports both `yaml` configuration and arguments
33
- - Highly customizable without being overly complex
30
+ **🚀 Fast & Lightweight**
31
+ - Minimal dependencies and fast execution
32
+ - Less broken builds and more time to focus on your code!
34
33
 
35
34
  # Table of Contents
36
35
 
37
36
  - [Example Usage (CLI)](#example-usage-cli)
38
37
  - [Example Usage (Library)](#example-usage-library)
39
38
  - [Usage with GitHub Actions](#usage-with-github-actions)
39
+ - [Example Commit Messages](#example-commit-messages)
40
40
  - [Configuration](#configuration)
41
41
  - [Sample YAML Configuration](#sample-yaml-configuration)
42
42
  - [Types](#types)
43
+ - [Debug Mode](#debug-mode)
43
44
  - [Support, Feedback, and Contributions](#support-feedback-and-contributions)
44
45
 
45
46
  # Example Usage (CLI)
@@ -55,7 +56,7 @@ This will:
55
56
  3. Publish the release to NPM
56
57
  4. Run the command `echo "Next version is ${NEXT_VERSION}"`
57
58
 
58
- You can also install `autorel` globally and run it that way:
59
+ You can also install `autorel` globally and run it directly:
59
60
 
60
61
  ```bash
61
62
  npm i -g autorel
@@ -125,11 +126,21 @@ jobs:
125
126
  run: npx autorel --publish
126
127
  ```
127
128
 
129
+ # Example Commit Messages
130
+
131
+ Here are some examples of commit messages and the resulting version bump (default configuration):
132
+
133
+ - `fix: fix a bug` -> `0.0.1`
134
+ - `feat: add new feature` -> `0.1.0`
135
+ - `feat!: add breaking change` -> `1.0.0`
136
+
137
+ You can find more examples in the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) documentation.
138
+
128
139
  # Configuration
129
140
 
130
141
  When run in CLI mode, `autorel` can be configured via CLI arguments or a `yaml` file. CLI arguments take precedence over the `yaml` file.
131
142
 
132
- When used as a library, you can pass the configuration directly to the `autorel` function. [See below](#types) for the types of configuration options.
143
+ When used as a library, you can pass the configuration directly to the `autorel` function.
133
144
 
134
145
  All arguments are optional, but setting `branches` is recommended.
135
146
 
@@ -259,6 +270,16 @@ run: echo 'Hello, World!'
259
270
 
260
271
  You can find the types defined at [src/index.ts](src/index.ts).
261
272
 
273
+ # Debug Mode
274
+
275
+ To enable debug mode, set `AUTOREL_DEBUG=1`:
276
+
277
+ ```bash
278
+ AUTOREL_DEBUG=1 npx autorel
279
+ ```
280
+
281
+ This will output configuration and other debug information.
282
+
262
283
  # Support, Feedback, and Contributions
263
284
 
264
285
  - Star this repo if you like it!
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "autorel",
3
- "version": "0.0.30",
3
+ "version": "0.0.32",
4
4
  "description": "Automate semantic releases based on conventional commits. Similar to semantic-release but much simpler.",
5
5
  "license": "MIT",
6
6
  "author": "Marc H. Weiner <mhweiner234@gmail.com> (https://mhweiner.com)",