Raketary

Gem Version

Source Code Changelog License

CLI app for commonly-used Rake tasks.

Includes:

Demo of Raketary on the command line

Contents

Installing

Pick your poison...

With the RubyGems CLI package manager:

$ gem install raketary

Manually:

$ git clone 'https://github.com/esotericpig/raketary.git'
$ cd raketary
$ bundle install
$ bundle exec rake install:local

Using

$ raketary
Usage: raketary [options] [command] [options]...

Commands:
    bump                             Bump your project's version
    ghp_sync                         Sync YARDoc to GitHub Pages repo
    github_pkg                       Publish your project's gem(s) to GitHub Packages
    irb                              Open an irb session loaded with your library
    nokogiri                         Install Nokogiri libs
    run                              Run your project's main file: raketary run -- --version

Options:
    -h, --help                       show this help
    -v, --version                    show the version of raketary

Bump

$ raketary bump
...
[bump] Options:
    -n, --dry-run                    do a dry run (do NOT write to files)
    -s, --strict                     enforce semantic versioning (i.e., \d+\.\d+\.\d+.*)

    -v, --ver [STR]                  show/set the version (e.g.: '1.2.3-alpha.4+beta.5') (default: show)
    -m, --major [INT,STR]            bump/set the major number (e.g.: +2, 4) (default: +1)
    -i, --minor [INT,STR]            bump/set the minor number (e.g.: +2, 4) (default: +1)
    -p, --patch [INT,STR]            bump/set the patch number (e.g.: +2, 4) (default: +1)
    -r, --pre [STR]                  set/erase the pre-release extension (e.g.: 'alpha.4') (default: erase)
    -b, --build [STR]                set/erase the the build metadata (e.g.: 'beta.5') (default: erase)
    -u, --bundle                     bump the Gemfile.lock version

    -h, --help                       show this help
    -x, --example                    show some examples

$ raketary bump -x
raketary bump -v  # Show the current version
raketary bump -n  # Do a dry run for any task (will NOT write to files)

raketary bump -v '1.2.3-alpha.4-beta.5'  # Set the version manually
raketary bump -m 1 -i 2 -p 3             # Set the version numbers
raketary bump -r 'alpha.4' -b 'beta.5'   # Set the version extensions
raketary bump -m -i -p                   # Bump the version numbers by 1
raketary bump -m +2 -i +3 -p +4          # Bump the version numbers by X

raketary bump -m            # Bump the major number by 1
raketary bump -m 1          # Set the major number to 1
raketary bump -m +2         # Bump the major number by 2
raketary bump -i            # Bump the minor number by 1
raketary bump -i 2          # Set the minor number to 2
raketary bump -i +3         # Bump the minor number by 3
raketary bump -p            # Bump the patch number by 1
raketary bump -p 3          # Set the patch number to 3
raketary bump -p +4         # Bump the patch number by 4
raketary bump -r            # Erase the pre-release extension
raketary bump -r 'alpha.4'  # Set the pre-release extension
raketary bump -b            # Erase the build metadata
raketary bump -b 'beta.5'   # Set the build metadata
raketary bump -u            # Bump the Gemfile.lock version

GitHub Pkg

$ raketary github_pkg -h
...
[github_pkg] Options:
    -u, --user [STR]                 set the GitHub username
    -h, --help                       show this help

GitHub Pages Sync

$ raketary ghp_sync -h
...
[ghp_sync] Options:
    -g, --ghp-dir STR                the destination (GitHub Pages) directory to sync "doc/" to

    -d, --deploy                     actually deploy (don't just do a dry-run)
    -s, --sync-args STR              additional args to pass to the sync command

    -h, --help                       show this help

Hacking

$ git clone 'https://github.com/esotericpig/raketary.git'
$ cd raketary
$ bundle install
$ bundle exec rake -T

License

GNU LGPL v3+

Raketary (https://github.com/esotericpig/raketary)
Copyright (c) 2019-2021 Jonathan Bradley Whited

Raketary is free software: you can redistribute it and/or modify
it under the terms of the GNU Lesser General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

Raketary is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License
along with Raketary. If not, see https://www.gnu.org/licenses/.