rbcli 0.1.10 → 0.2.0

data/docs-src/docs/tutorial/40-options_parameters_and_arguments.md

@@ -0,0 +1,251 @@
+# Options, Paramters, and Arguments
+
+If you're already an experienced coder, you can jump to the last section of this document, the [Simplified Reference (TLDR)](#simplified-reference-tldr)
+
+## Command Line Structure
+
+In the previous section, you saw two parts of the RBCli command line structure - the executable followed by the command. However, RBCli is capable of more complex interaction. The structure is as follows:
+
+```
+toolname [options] command [parameters] argument1 argument2...
+```
+
+* __Options__ are command line parameters such as `-f`, or `--force`. These are available globally to every command. You can create your own, though several are already built-in and reserved for RBCli:
+	* `--config-file=<filename>` allows specifying a config file location manually.
+	* `--generate-config` generates a config file for the user by writing out the defaults to a YAML file. This option will only appear if a config file has been set. The location is configurable, with more on that in the documentation on [User Config Files][user_config_documentation]).
+	* `-v / --version` shows the version.
+	* `-h / --help` shows the help.
+* __Command__ represents the subcommands that you will create, such as `list`, `test`, or `apply`.
+* __Parameters__ are the same as options, but only apply to the specific subcommand being executed. In this case only the `-h / --help` parameter is provided automatically.
+* __Arguments__ are strings that don't begin with a '-', and are passed to the command's code as an array. These can be used as subcommands or additional parameters for your command. 
+
+So a valid command could look something like these:
+
+```shell
+mytool -n load --filename=foo.txt
+mytool parse foo.txt
+mytool show -l
+```
+
+Note that all options and parameters will have both a short and long version of the parameter available for use.
+
+So let's take a look at how we define them.
+
+
+## Options
+
+You can find the options declarations under `application/options.rb`.  You'll see the example in the code:
+
+```ruby
+option :name, 'Give me your name', short: 'n', type: :string, default: 'Jack', required: false, permitted: ['Jack', 'Jill']
+```
+
+This won't do for our tool, so let's change it. Remember that these options will be applicable to all of our commands, so lets make it something appropriate:
+
+```ruby
+option :color, 'Enable color output', short: 'c', type: :boolean, default: false
+```
+
+So now, let's take advantage of this flag in our `list` command. Let's change our block to:
+
+```ruby
+	action do |params, args, global_opts, config|
+		Dir.glob "./*" do |filename|
+			outname = filename.split('/')[1]
+			outname += '/' if File.directory? filename
+
+			# We change the color based on the kind of file shown
+			if global_opts[:color]
+				if File.directory? filename
+					outname = outname.light_blue
+				elsif File.executable? filename
+					outname = outname.light_green
+				end
+			end
+			
+			puts outname
+		end
+	end
+```
+
+Notice how we referenced the value by using `global_opts[:color]`. It's that simple. To see it in action, run:
+
+```bash
+mytool -c list
+```
+
+## Parameters
+
+Parameters work the same way as options, but they are localized to only the selected command. They are declared - as you probably guessed by now - in the command's class. So let's add the following lines to our list command within the class declaration:
+
+```ruby
+parameter :sort, 'Sort output alphabetically', type: :boolean, default: false
+parameter :all, 'Show hidden files', type: :boolean, default: false
+parameter :directoriesfirst, 'Show directories on top', type: :boolean, default: false
+```
+
+And let's modify our action block to utilize them:
+
+```ruby
+	action do |params, args, global_opts, config|
+		filelist = []
+
+		# We include dotfiles if specified
+		include_dotfiles = (params[:all]) ? File::FNM_DOTMATCH : 0
+		
+		# We store a list of the files in an array, including dotfiles if specified
+		Dir.glob "./*", include_dotfiles do |filename|
+			outname = filename.split('/')[1]
+			outname += '/' if File.directory? filename
+			filelist.append outname
+		end
+
+		# Sort alphabetically if specified
+		filelist.sort! if params[:sort]
+
+		# Put directories first if specified
+		if params[:directoriesfirst]
+			files = []; dirs = []
+			filelist.each do |filename|
+				if File.directory? filename
+					dirs.append(filename)
+				else
+					files.append(filename)
+				end
+			end
+			filelist = dirs + files
+		end
+		
+		# Apply color. We do this at the end now because color codes can alter the sorting.
+		filelist.map! do |filename|
+			if File.directory? filename
+				filename.light_blue
+			elsif File.executable? filename
+				filename.light_green
+			else
+				filename
+			end
+		end if global_opts[:color]
+
+		puts filelist
+	end
+```
+
+You should be able to run it now:
+
+```bash
+mytool -c list -asd
+```
+
+Note how the parameters come after the `list` command in the syntax above. As you create more commands, each will have its own unique set of parameters, while the options remain _before_ the command and are available to all of them.
+
+## Arguments
+
+Lastly on the command line, there are arguments. Arguments are simply strings without the `-` character in front, and automatically get passed into an array in your applicaiton. Let's take a look at how we can use them.
+
+Unlike options and parameters, arguments require no setup. So let's assume that we want any arguments passed to the `list` command to be filenames that you want to display, and that you can pass multiple ones. Since arguments aren't listed automatically by the help function, this is a good example of what to put in your usage text. Let's take a look at what our class looks like now:
+
+```ruby
+class List < Rbcli::Command
+	description %q{List files in current directory}
+	usage <<-EOF
+To list only specific files, you can enter filenames as arguments
+
+	mytool list filename1 filename2...
+EOF
+	parameter :sort, 'Sort output alphabetically', type: :boolean, default: false
+	parameter :all, 'Show hidden files', type: :boolean, default: false
+	parameter :directoriesfirst, 'Show directories on top', type: :boolean, default: false
+
+	action do |params, args, global_opts, config|
+		filelist = []
+
+		# We include dotfiles if specified
+		include_dotfiles = (params[:all]) ? File::FNM_DOTMATCH : 0
+		
+		# We store a list of the files in an array, including dotfiles if specified
+		Dir.glob "./*", include_dotfiles do |filename|
+			outname = filename.split('/')[1]
+			next unless args.include? outname if args.length > 0
+			outname += '/' if File.directory? filename
+			filelist.append outname
+		end
+
+		# Sort alphabetically if specified
+		filelist.sort! if params[:sort]
+
+		# Put directories first if specified
+		if params[:directoriesfirst]
+			files = []; dirs = []
+			filelist.each do |filename|
+				if File.directory? filename
+					dirs.append(filename)
+				else
+					files.append(filename)
+				end
+			end
+			filelist = dirs + files
+		end
+		
+		# Apply color. We do this at the end because color codes can alter the sorting
+		filelist.map! do |filename|
+			if File.directory? filename
+				filename.light_blue
+			elsif File.executable? filename
+				filename.light_green
+			else
+				filename
+			end
+		end if global_opts[:color]
+
+		puts filelist
+	end
+end
+```
+
+
+
+## Simplified Reference (TLDR)
+
+RBCli enforces a CLI structure of:
+
+```
+toolname [options] command [parameters] argument1 argument2...
+```
+
+__Options__ are declared in `application/options.rb` file.
+
+__Parameters__ are declared in the respective command's class declaration.
+
+__Arguments__ don't need to be declared, and are passed in as an array to your commands. It is helpful to describe the argument purpose in the `usage` text declaration so that the user can see what to do in the help.
+
+__Options__ and __parameters__ both use the same format:
+
+```ruby
+option    :<name>, "<description_string>", short: '<character>', type: <variable_type>, default: <default_value>, permitted: [<array_of_permitted_values]
+
+parameter :<name>, "<description_string>", short: '<character>', type: <variable_type>, default: <default_value>, permitted: [<array_of_permitted_values]
+```
+
+* `name`
+	* (Required) The long name of the option, as a symbol. This will be represented as `--name` on the command line
+* `description_string`
+	* (Required) A short description of the command that will appear in the help text for the user
+* `type`
+	* (Required) The following types are supported: `:string`, `:boolean` or `:flag`, `:integer`, and `:float`
+* `default`
+	* (Optional) A default value for the option if one isn't entered (default: nil)
+* `short`
+	* (Optional) A letter that acts as a shortcut for the option. This will allow users to apply the command as `-n`
+	* To not have a short value, set this to :none (default: the first letter of the long name)
+* `required`
+	* (Optional) Specify whether the option is required from the user (default: false)
+* `permitted`
+	* (Optional) An array of whitelisted values for the option (default: nil)
+
+## Next Steps
+
+Next, we're going to take a quick look at how to publish and distribute your application, both publicly and within your organization.
+
+[user_config_documentation]: ../advanced/user_config_files.md
+[regex_explanation]: https://medium.com/factory-mind/regex-tutorial-a-simple-cheatsheet-by-examples-649dc1c3f285

data/docs-src/docs/tutorial/50-publishing.md

@@ -0,0 +1,47 @@
+# Publishing Your Application
+
+RBCli creates projects designed to be easily distributed via either source control or as a gem. We'll go over both methods.
+
+## Common Tasks
+
+Regardless of where you are publishing, certain tasks need to be accomplished. Namely, preparing the gemspec and the README.
+
+In both files the items that need changing are pretty obvious -- you'll need to fill out your name, email, etc, and replace the placeholder text in the README with something useful to your users.
+
+Then, for every release, you'll need to update the version number in `config/version.rb`. This number is automatically used by the `gemspec` when versioning the gem in the system, and by RBCli when displaying help to the user and checking for automatic updates if you enable that feature (see [Automatic Updates][automatic_update_documentation] for more information).
+
+## Source Control Distribution
+
+With Source Control distribution your users will be cloning the source code directly from your repository, and building and installing the gem locally. Thankfully, the process is pretty simple:
+
+```bash
+git clone <your_repo_here>
+gem build mytool.gemspec
+gem install mytool-*.gem
+```
+
+Note that he README's placeholder text has these commands already listed for your users, which you can leave as instructions.
+
+When using this method, we highly recommend using a git flow where you only merge to master when you are ready to release, this way your users don't inadvertently download a buggy commit.
+
+## Rubygems.org Distribution
+
+If you're distributing as a gem via Rubygems.org, you'll need to follow a specific release process.
+
+1. Update the version number in `config/version.rb`
+2. Commit the change locally
+3. Run `bundle exec rake release`
+
+This will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Recommended Platforms
+
+As far as RBCli is concerned, all Git hosts and gem platforms work equally well, and as long as the code reaches your users in one piece it's all the same. That said, if you'd like to take advantage of automatic update notifications for your users, please see the documentation for [Automatic Updates][automatic_update_documentation] for a list of supported platforms for that feature. 
+
+## Next Steps
+
+Congratulations! You've completed the tutorial on RBCli and should be able to make all sorts of CLI applications and tools with what you learned. That said, there are still many features in RBCli that we didn't explore, which you can find in the __Advanced__ section of this site. If you aren't sure where to start, we recommend looking at [User Config Files][user_config_files_documentation] and going from there.
+
+
+[automatic_update_documentation]: ../advanced/automatic_updates.md
+[user_config_files_documentation]: ../advanced/user_config_files.md

data/docs-src/docs/whoami.md

@@ -0,0 +1,28 @@
+# My Letter To You
+
+My Fellow Coder,
+
+I'm glad to see you are interested in RBCli. I'd like to introduce myself. My name is Andrew, and I've been a technologist since 1992 when my father bought our first family computer -- a 486DX2 which ran at 66Mhz (33Mhz if you turned off the 'turbo' button) and came with MS DOS 5.0, [QBasic](https://en.wikipedia.org/wiki/QBasic), and a game already coded in it called [Nibbles](https://classicreload.com/qbasic-nibbles.html) (if you care to see the code, die 5 times and don't play again). I didn't like that the game forced my name to be "Sammy", and thought, "hey, if I can see the code, can't I change it?". So I did what any annoyed child would do and learned to code so I could do just that. I'd tell you what I changed it to, but I was so proud of myself for this simple feat that I changed it every 30 seconds and couldn't settle on just one name. Then I performed my first ever hack, and figured out how to go through walls without dying. All of a sudden the world seemed limitless.
+
+I was only a child at the time, but on that day I learned that every "rule" in computing was an artifical construct and could be changed to suit your needs. Thus began my career in tech and my obsession to change the world with it. This is why RBCli was born.
+
+RBCli started as a collection of code that I would copy-paste between projects, until one day when I wondered if I could just find a framework that suited me. I couldn't - in case you hadn't guessed - so I decided to build my own and give it to the world. I would not have accomplished even half of what I have without the open source community, and this is to be the first of hopefully many contributions back.
+
+The features in RBCli have been chosen from over 25 years of experience writing applications, building features that 3rd parties left out, managing large scale infrastructure, designing embedded systems, integrating enterprise systems, automating CI/CD, scripting my own computers, and so much more. I hope that you can find as much use out of it as I have.
+
+If you'd like to get in touch with me at any time, feel free to email me at [andrew@blacknex.us](mailto:andrew@blacknex.us).
+
+All the best,
+
+Andrew
+
+
+P.S.: If you really liked RBCli and want to support it, any amount you can help out with goes a long way.
+
+<form action="https://www.paypal.com/cgi-bin/webscr" method="post" target="_top">
+<input type="hidden" name="cmd" value="_s-xclick">
+<input type="hidden" name="encrypted" value="-----BEGIN PKCS7-----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-----END PKCS7-----
+">
+<input type="image" src="https://www.paypalobjects.com/en_US/i/btn/btn_donate_LG.gif" border="0" name="submit" alt="PayPal - The safer, easier way to pay online!">
+<img alt="" border="0" src="https://www.paypalobjects.com/en_US/i/scr/pixel.gif" width="1" height="1">
+</form>

data/docs-src/makesite.sh

@@ -0,0 +1,14 @@
+#!/usr/bin/env bash
+
+if ! pip list | grep mkdocs &> /dev/null; then
+	echo "Python package mkdocs not found. Installing..."
+	pip install mkdocs mkdocs-material
+fi
+
+DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" >/dev/null && pwd )"
+
+mkdir -p "${DIR}/docs/imported" || true
+cp "${DIR}/../CHANGELOG.md" "${DIR}/docs/imported/changelog.md"
+sed -n '/Quick Reference/,$p' "${DIR}/../README.md" > "${DIR}/docs/imported/quick_reference.md"
+
+mkdocs build --clean

data/docs-src/mkdocs.yml

@@ -0,0 +1,76 @@
+# https://www.mkdocs.org/user-guide/configuration
+
+site_name: RBCli Documentation
+site_description: Description
+site_author: Andrew Khoury
+copyright: Copyright © 2018 Andrew Khoury
+
+pages:
+  - Home: index.md
+  - Quick Reference: imported/quick_reference.md
+  - Tutorial:
+    - Getting Started: tutorial/10-getting_started.md
+    - The Project Layout: tutorial/20-project_layout.md
+    - Your First Command: tutorial/30-your_first_command.md
+    - Options, Parameters, and Arguments: tutorial/40-options_parameters_and_arguments.md
+    - Publishing and Distribution: tutorial/50-publishing.md
+  - Advanced Features:
+    - Command Types: advanced/command_types.md
+    - User Config Files: advanced/user_config_files.md
+    - Hooks: advanced/hooks.md
+    - Automatic Updates: advanced/automatic_updates.md
+    - State Storage: advanced/state_storage.md
+    - Distributed State Locking: advanced/distributed_state_locking.md
+  - Development:
+    - Contribution Guide: development/contributing.md
+    - License Info: development/license.md
+    - Code of Conduct: development/code_of_conduct.md
+    - Changelog: imported/changelog.md
+  - $ whoami: whoami.md
+
+# The repo link on the top-right of the page
+#repo_name: GitHub
+repo_url: https://github.com/akhoury6/rbcli/
+edit_uri: ''
+
+# For use with mkdocs build
+#docs_dir: ./docs-src/docs/
+site_dir: ../docs/
+
+# For use with gh-deploy
+#remote_branch: master
+#remote_name: origin
+
+#theme: windmill
+
+theme:
+  name: material
+  logo:
+     icon: devices    # from https://material.io/tools/icons/?style=baseline
+  feature:
+    tabs: true
+#  logo: 'images/logo.svg'
+#   palette:
+#     primary: 'indigo'
+#     accent: 'indigo'
+#   language: 'en'
+#   direction: 'ltr'
+#   favicon: 'assets/images/favicon.ico'
+
+
+#theme: readthedocs
+#theme:
+#  name: mkdocs
+#  custom_dir: my_theme_customizations/
+#  static_templates:
+#   - sitemap.html
+#  include_sidebar: false
+#extra_css:
+#    - css/extra.css
+#    - css/second_extra.css
+#extra_javascript:
+#extra_templates:
+#extra:
+#  rbcli_version: 0.1.0
+
+# For formatting options see https://www.mkdocs.org/user-guide/configuration/#formatting-options

data/docs-src/runsite.sh

@@ -0,0 +1,3 @@
+#!/usr/bin/env bash
+
+mkdocs serve

data/exe/rbcli

@@ -1,4 +1,23 @@
 #!/usr/bin/env ruby
+##################################################################################
+#     RBCli -- A framework for developing command line applications in Ruby      #
+#     Copyright (C) 2018 Andrew Khoury                                           #
+#                                                                                #
+#     This program is free software: you can redistribute it and/or modify       #
+#     it under the terms of the GNU General Public License as published by       #
+#     the Free Software Foundation, either version 3 of the License, or          #
+#     (at your option) any later version.                                        #
+#                                                                                #
+#     This program 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 General Public License for more details.                               #
+#                                                                                #
+#     You should have received a copy of the GNU General Public License          #
+#     along with this program.  If not, see <https://www.gnu.org/licenses/>.     #
+#                                                                                #
+#     For questions regarding licensing, please contact andrew@blacknex.us        #
+##################################################################################
 
 require "#{File.dirname(__FILE__)}/../lib/rbcli.rb"
 
@@ -6,6 +25,7 @@ Rbcli::Configurate.me do
 	scriptname __FILE__.split('/')[-1]
 	version Rbcli::VERSION
 	description 'RBCli initialization tool'
+	autoupdate gem: 'rbcli', force_update: false, message: "Please run `gem update rbcli` to upgrade to the latest version."
 end
 
 require "#{File.dirname(__FILE__)}/../lib/rbcli-tool.rb"
@@ -23,6 +43,26 @@ class Docs < Rbcli::Command
 	end
 end
 
+class License < Rbcli::Command
+	description 'Shows Copyright and License Info'
+	usage nil
+
+	parameter :full, 'Display Full License Text', default: false
+
+	action do |params|
+		puts File.read("#{File.dirname(__FILE__)}/../LICENSE.txt") if params[:full]
+		puts <<-EOF
+RBCli  Copyright (C) 2018 Andrew Khoury
+This program comes with ABSOLUTELY NO WARRANTY.
+This is free software, and you are welcome to redistribute it
+under certain conditions.
+If you wish to release this library as part of commercial software,
+please contact andrew@blacknex.us.
+Type `rbcli license --full' to show the license text.
+EOF
+	end
+end
+
 class Init < Rbcli::Command
 	description 'Initialize a skeleton RBCli project.'
 	usage <<-EOF
@@ -107,13 +147,12 @@ EOF
 	end
 end
 
-class Extern < Rbcli::Command
+class Script < Rbcli::Command
 	description 'Generate an Rbcli Command with Bash Script under the current project'
 	usage <<-EOF
 This will generate a new command under the current RBCli project, and a skeleton bash script to code it.
 
-Use this option if you prefer to use bash (or another shell) to script your command, or if you need to integrate with
-a third party application.
+Use this option if you prefer to use bash (or another shell) to script your command.
 
 Please run this command from within the project's directory structure.
 EOF
@@ -121,7 +160,6 @@ EOF
 	parameter :name, 'Name of command to generate', type: :string, required: true
 	parameter :description, 'A short description of the command', type: :string, default: 'TODO: Description goes here'
 	parameter :usagetext, 'Usage help text for the command', type: :string, default: 'TODO: Usage text goes here'
-	parameter :skip_script, 'Skip creating a bash script and set executable path manually', type: :boolean, default: false
 
 	action do |params, args, global_opts, config|
 		# First we check that we are working within a project folder
@@ -133,7 +171,40 @@ EOF
 				name: params[:name],
 				description: params[:description],
 				usage_text: params[:usagetext],
-				no_script: params[:skip_script],
+				no_script: false,
+				rbcli_version: Rbcli::VERSION
+		}
+
+		generator = RBCliTool::Generator.new(:extern, project_root, template_vars)
+		generator.run
+	end
+end
+
+class Extern < Rbcli::Command
+	description 'Generate an Rbcli Command that can wrap an external application'
+	usage <<-EOF
+This will generate a new command under the current RBCli project
+
+Use this option if you need to integrate with a third party application.
+
+Please run this command from within the project's directory structure.
+	EOF
+
+	parameter :name, 'Name of command to generate', type: :string, required: true
+	parameter :description, 'A short description of the command', type: :string, default: 'TODO: Description goes here'
+	parameter :usagetext, 'Usage help text for the command', type: :string, default: 'TODO: Usage text goes here'
+
+	action do |params, args, global_opts, config|
+		# First we check that we are working within a project folder
+		project_root = RBCliTool::Project.find_root(Dir.pwd)
+		RBCliTool.exit_with_error("Can't find the project root in the current path. Please `cd` to your project's directory before running this command, and ensure that the `.rbcli` file is present in its root path.") unless project_root
+
+		# Prepare template vars
+		template_vars = {
+				name: params[:name],
+				description: params[:description],
+				usage_text: params[:usagetext],
+				no_script: true,
 				rbcli_version: Rbcli::VERSION
 		}
 

data/lib/rbcli/autoupdate/autoupdate.rb

@@ -1,13 +1,33 @@
+##################################################################################
+#     RBCli -- A framework for developing command line applications in Ruby      #
+#     Copyright (C) 2018 Andrew Khoury                                           #
+#                                                                                #
+#     This program is free software: you can redistribute it and/or modify       #
+#     it under the terms of the GNU General Public License as published by       #
+#     the Free Software Foundation, either version 3 of the License, or          #
+#     (at your option) any later version.                                        #
+#                                                                                #
+#     This program 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 General Public License for more details.                               #
+#                                                                                #
+#     You should have received a copy of the GNU General Public License          #
+#     along with this program.  If not, see <https://www.gnu.org/licenses/>.     #
+#                                                                                #
+#     For questions regarding licensing, please contact andrew@blacknex.us        #
+##################################################################################
+
 module Rbcli::Configurate
-	def self.autoupdate gem: nil, github_repo: nil, access_token: nil, enterprise_hostname: nil, force_update: false
+	def self.autoupdate gem: nil, github_repo: nil, access_token: nil, enterprise_hostname: nil, force_update: false, message: nil
 		raise StandardError.new "Autoupdater can not have both a gem and git target defined. Please pick one." if gem and github_repo
 		raise StandardError.new "Only one autoupdater can be defined." if @data[:autoupdater]
 		if gem
 			#Rbcli::Autoupdate::GemUpdater.save_defaults
-			@data[:autoupdater] = Rbcli::Autoupdate::GemUpdater.new gem, force_update
+			@data[:autoupdater] = Rbcli::Autoupdate::GemUpdater.new gem, force_update, message
 		else
 			Rbcli::Autoupdate::GithubUpdater.save_defaults
-			@data[:autoupdater] = Rbcli::Autoupdate::GithubUpdater.new github_repo, access_token, enterprise_hostname, force_update
+			@data[:autoupdater] = Rbcli::Autoupdate::GithubUpdater.new github_repo, access_token, enterprise_hostname, force_update, message
 		end
 		@data[:autoupdater].show_message if @data[:autoupdater].update_available?
 	end
@@ -32,7 +52,7 @@ module Rbcli::Autoupdate
 
 		def show_message
 			puts "WARNING: An update is available to #{Rbcli::Configurate::configuration[:scriptname]}. You are currently running version #{Rbcli.configuration[:version]}; the latest is #{@latest_version || get_latest_version}."
-			puts update_message
+			puts @message || update_message
 			puts "\n"
 			if @force_update
 				puts "This application requires that you update to the latest version to continue using it. It will now exit."

data/lib/rbcli/autoupdate/gem_updater.rb

@@ -1,3 +1,23 @@
+##################################################################################
+#     RBCli -- A framework for developing command line applications in Ruby      #
+#     Copyright (C) 2018 Andrew Khoury                                           #
+#                                                                                #
+#     This program is free software: you can redistribute it and/or modify       #
+#     it under the terms of the GNU General Public License as published by       #
+#     the Free Software Foundation, either version 3 of the License, or          #
+#     (at your option) any later version.                                        #
+#                                                                                #
+#     This program 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 General Public License for more details.                               #
+#                                                                                #
+#     You should have received a copy of the GNU General Public License          #
+#     along with this program.  If not, see <https://www.gnu.org/licenses/>.     #
+#                                                                                #
+#     For questions regarding licensing, please contact andrew@blacknex.us        #
+##################################################################################
+
 require 'net/http'
 require 'json'
 
@@ -5,10 +25,11 @@ module Rbcli::Autoupdate
 	class GemUpdater
 		include Common
 
-		def initialize gemname, force_update
+		def initialize gemname, force_update, message
 			@gemname = gemname
 			@uri = URI.parse "https://rubygems.org/api/v1/versions/#{gemname}/latest.json"
 			@force_update = force_update
+			@message = message
 		end
 
 		def get_latest_version
@@ -21,7 +42,7 @@ module Rbcli::Autoupdate
 		end
 
 		def update_message
-			"Please check the Ruby gem #{@gemname} for instructions. You can see it at: https://rubygems.org/gems/#{@gemname}/versions/#{@latest_version}"
+			"Please run `gem update #{@gemname}` to upgrade to the latest version. You can see it at: https://rubygems.org/gems/#{@gemname}/versions/#{@latest_version}"
 		end
 
 		# def self.save_defaults