Skip to content
Easy semantic versioning of git repositories, along with other rapid app dev tools.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE
README.md
folder-utils.js
get-svn-last-changed-rev-cmd.js
get-svn-rev-cmd.js
git-branchlog-cmd.js
git-log-cmd.js
git-next-build-cmd.js
git-next-major-cmd.js
git-next-minor-cmd.js
git-next-patch-cmd.js
git-noskip-cmd.js
git-skip-cmd.js
git-skiplist-cmd.js
git-sync-cmd.js
git-sync-notag-cmd.js
git-tag-list-cmd.js
git-version-clean-cmd.js
git-version-cmd.js
index.js
make-folder-cmd.js
npm-update-version-cmd.js
package.json
rad-cmd.js
rs-sync-cmd.js
run-utils.js
string-utils.js
version-control.js

README.md

rad-scripts

Easily add semantic versioning to all your git repositories, and integrate the versioning into your apps.

The rad-scripts mantra:

Automatically tag your code with a semantic version every time you push

Rad-scripts facilitates semantic versioning of git repositories. Following semantic versioning guidelines, developers can tag major/minor/patch releases without knowing numeric tag details. Instead, the developer can focus on whether commits since the last tag include breaking changes (major), addition of new functionality (minor), or bugfixes (patch).

To painlessly kick things off, just start using git-sync to push your changes. This automatically applies semantic version tags to your code, starting with v0.0.0. Use --major when pushing breaking changes, and --minor when pushing new features. Other than that, it should all be automatic.

In more complex continuously automated environments, rad-scripts provides a framework for you to stamp the "next version" into your code base right before pushing. Best practice is to create an app-specific "stamp" script for your app, and use it for every commit. Any type of app is supported, through a generic callback; npm module publishing is also supported. See rs-sync-cmd.js for a complete example that is used to publish rad-scripts itself.

git-sync is the primary command. It automates version stamping through a rebased push:

stash, pull --rebase, stash pop, determine "next" version, stamp, commit, tag, push, publish

git-sync will drop you back to the command line on any conflicts. Automating this workflow can save hours.

Common commands:

  • git-sync [--major|--minor|--patch] [msg msg...] > stash, pull, pop, stamp, commit, tag, push

  • git-sync-notag > a git-sync version to commit code without a tag; bad form perhaps, but up to you

  • git-log [--branch|-b name] [count] > an opinionated pretty colored git log, clipped to ~110 chars

  • git-branchlog [--branch|-b name OR -all|-a] [--with-commits|-c] > an opinionated branch summary log

  • git-tag-list > list tags, including one line from the annotaged tag's commit message

  • git-skip [file] > tell git to start ignoring upstream and local changes to the given file

  • git-noskip [file] > tell git to stop ignoring upstream and local changes to the given file

  • git-skiplist > list the files for which git is currently ignoring upstream and local changes

  • npm-update-version [version] > inject the current version into package.json

  • rs-sync [--major|--minor] [msg msg...] > dogfooding 101: use rad-scripts to publish rad-scripts

  • list-commands > lists all available commands

See https://bitpost.com/news for more bloviating. Devs don't need no stinkin ops. Happy automating! :-)

Most recent commits... 1daf185 4 minutes .. Better branchlog param order handling HEAD -> ma.. Michael Behrns-Miller [mbehrnsm-silver] ba05bd9 6 days ago Added ru hostname helper function tag: 4.10.5 Michael Behrns-Miller [mbehrnsm-silver] 0a0b169 6 weeks ago auto-sync tag: 4.10.4 Michael Behrns-Miller [mbehrnsm-silver] 69e29b9 9 weeks ago Added optional non-space separator to ru.combine_params() tag: 4.10.3 Michael Behrns-Miller [viper]

Version 4.10.7

You can’t perform that action at this time.