1.18.2 • Published 8 years ago

on3 v1.18.2

Weekly downloads
3
License
ISC
Repository
github
Last release
8 years ago

on3 simplifies common workflows for managing a Node module under Git version control. Increment your Node module's version, commit, push to GitHub, and publish to npm in one command.

npm install -g on3

Submit your pull requests and feedback to GitHub.

API

publish
on3.publish(args: {}, callback: fn)

branch {str} The branch to push. This is set to "master" by default.
gittag {str} By default, this is a "v" followed by the package version in package.json, e.g. "v1.0.0-0".
gitmsg {str} Sets the Git commit message.
npmtag {str} The tag to apply when executing npm publish. This is set to "next" by default so publishing to the "latest" tag is a conscious decision. This should mitigate the risk of accidentally releasing breaking changes.
version {str} Any value valid to npm version. This is set to "prepatch" by default.
dryrun Report the would-be changes without executing them.

increment
on3.increment(args: {}, callback: fn)

message {str} Sets the Git commit message.
flag {str} Sets the flags to pass to npm version.
only {bool} If true, increments the version without committing the changes.
version {str} Any value valid to npm version. This is set to "prepatch" by default.
--dryrun Report the would-be changes without executing them.

CLI

# Example
on3 # alias: on
publish -v patch -n latest

publish alias: p Increments the package's version, commits as instructed, then pushes and publishes the package.

publish -b master -v prepatch -g v1.0.1 -n next -m "Increments from v1.0.1-0 to v1.0.1-1."

-b, --branch [branch] Sets which branch to push to GitHub. Defaults to master.
-g, --gittag [tag] Tags the Git commit. The new version number is used by default.
-m, --gitmsg ["message"] Sets the Git commit message. Wrapping your comment in double quotes is recommended.
-n, --npmtag [tag] Tags the node module. This is set as "next" by default so releasing as "latest" is a conscious choice.
-v, --version [version] Increments the package to the given version. Uses "prepatch" by default.
--dryrun Report the would-be changes without executing them.

increment Increments the package version, commits the changes, and tags the commit with the new version number. See -o to avoid the latter two steps.

increment -m "Your Git commit message here."
increment -f "--no-git-tag-version -f"

-f, --flags Sets the flags on the npm version command.
-m, --message Sets the git commit message.
-o, --only Ignore your repo's status, and do not commit. Only update the version in package.json.
--dryrun Report the would-be changes without executing them.

Contributing

Submit your pull requests and feedback to GitHub.

Engineering Tasks (@todo)

  • Improve the user experience with better, colored feedback
  • Improve test coverage
  • Consider other pains in managing a Node module

Development Guidelines

eslint

npm run lint

Testing

npm run build && node build/test.js

Dependencies

Developers contributing to this project require the tools that support it:

1.18.2

8 years ago

1.18.1

8 years ago

1.18.0

8 years ago

1.17.0

8 years ago

1.16.0

8 years ago

1.14.0

8 years ago

1.12.0

8 years ago

1.11.0

8 years ago

1.10.0

8 years ago

1.9.0

8 years ago

1.8.0

8 years ago

1.7.0

8 years ago

1.6.1

8 years ago

1.6.0

8 years ago

1.4.1

8 years ago

1.4.0

8 years ago

1.1.9-0

8 years ago

1.1.9

9 years ago

1.1.8

9 years ago

1.1.7

9 years ago

1.1.7-0

10 years ago

1.1.6

10 years ago

1.1.5

10 years ago

1.1.4

10 years ago

1.1.3

10 years ago

1.1.2

10 years ago

1.1.1

10 years ago

1.1.0

10 years ago

1.0.6-0

10 years ago

1.0.4-0

10 years ago

1.0.3-0

10 years ago

1.0.2

10 years ago

1.0.2-0

10 years ago

1.0.1-0

10 years ago