Module: Mongrel::Command::Base
- Defined in:
- lib/mongrel/command.rb
Overview
A Command pattern implementation used to create the set of command available to the user from Mongrel. The script uses objects which implement this interface to do the user’s bidding.
Instance Attribute Summary collapse
-
#done_validating ⇒ Object
readonly
Returns the value of attribute done_validating.
-
#original_args ⇒ Object
readonly
Returns the value of attribute original_args.
-
#valid ⇒ Object
readonly
Returns the value of attribute valid.
Instance Method Summary collapse
- #configure ⇒ Object
-
#failure(message) ⇒ Object
Just a simple method to display failure until something better is developed.
-
#help ⇒ Object
Returns a help message.
-
#initialize(options = {}) ⇒ Object
Called by the subclass to setup the command and parse the argv arguments.
-
#options(opts) ⇒ Object
Called by the implemented command to set the options for that command.
-
#run ⇒ Object
Runs the command doing it’s job.
-
#valid?(exp, message) ⇒ Boolean
Validates the given expression is true and prints the message if not, exiting.
-
#valid_dir?(file, message) ⇒ Boolean
Validates that the given directory exists.
-
#valid_exists?(file, message) ⇒ Boolean
Validates that a file exists and if not displays the message.
-
#valid_file?(file, message) ⇒ Boolean
Validates that the file is a file and not a directory or something else.
- #valid_group?(group) ⇒ Boolean
- #valid_user?(user) ⇒ Boolean
-
#validate ⇒ Object
Returns true/false depending on whether the command is configured properly.
Instance Attribute Details
#done_validating ⇒ Object (readonly)
Returns the value of attribute done_validating.
38 39 40 |
# File 'lib/mongrel/command.rb', line 38 def done_validating @done_validating end |
#original_args ⇒ Object (readonly)
Returns the value of attribute original_args.
38 39 40 |
# File 'lib/mongrel/command.rb', line 38 def original_args @original_args end |
#valid ⇒ Object (readonly)
Returns the value of attribute valid.
38 39 40 |
# File 'lib/mongrel/command.rb', line 38 def valid @valid end |
Instance Method Details
#configure ⇒ Object
83 84 85 |
# File 'lib/mongrel/command.rb', line 83 def configure [] end |
#failure(message) ⇒ Object
Just a simple method to display failure until something better is developed.
150 151 152 |
# File 'lib/mongrel/command.rb', line 150 def failure() STDERR.puts "!!! #{}" end |
#help ⇒ Object
Returns a help message. Defaults to OptionParser#help which should be good.
93 94 95 |
# File 'lib/mongrel/command.rb', line 93 def help @opt.help end |
#initialize(options = {}) ⇒ Object
Called by the subclass to setup the command and parse the argv arguments. The call is destructive on argv since it uses the OptionParser#parse! function.
55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 |
# File 'lib/mongrel/command.rb', line 55 def initialize(={}) argv = [:argv] || [] @opt = OptionParser.new @opt. = Mongrel::Command::BANNER @valid = true # this is retarded, but it has to be done this way because -h and -v exit @done_validating = false @original_args = argv.dup configure # I need to add my own -h definition to prevent the -h by default from exiting. @opt.on_tail("-h", "--help", "Show this message") do @done_validating = true puts @opt end # I need to add my own -v definition to prevent the -v from exiting by default as well. @opt.on_tail("--version", "Show version") do @done_validating = true if VERSION puts "Version #{Mongrel::Const::MONGREL_VERSION}" end end @opt.parse! argv end |
#options(opts) ⇒ Object
Called by the implemented command to set the options for that command. Every option has a short and long version, a description, a variable to set, and a default value. No exceptions.
43 44 45 46 47 48 49 50 51 |
# File 'lib/mongrel/command.rb', line 43 def (opts) # process the given options array opts.each do |short, long, help, variable, default| self.instance_variable_set(variable, default) @opt.on(short, long, help) do |arg| self.instance_variable_set(variable, arg) end end end |
#run ⇒ Object
Runs the command doing it’s job. You should implement this otherwise it will throw a NotImplementedError as a reminder.
99 100 101 |
# File 'lib/mongrel/command.rb', line 99 def run raise NotImplementedError end |
#valid?(exp, message) ⇒ Boolean
Validates the given expression is true and prints the message if not, exiting.
105 106 107 108 109 110 111 |
# File 'lib/mongrel/command.rb', line 105 def valid?(exp, ) if not @done_validating and (not exp) failure @valid = false @done_validating = true end end |
#valid_dir?(file, message) ⇒ Boolean
Validates that the given directory exists
125 126 127 |
# File 'lib/mongrel/command.rb', line 125 def valid_dir?(file, ) valid?(file != nil && File.directory?(file), ) end |
#valid_exists?(file, message) ⇒ Boolean
Validates that a file exists and if not displays the message
114 115 116 |
# File 'lib/mongrel/command.rb', line 114 def valid_exists?(file, ) valid?(file != nil && File.exist?(file), ) end |
#valid_file?(file, message) ⇒ Boolean
Validates that the file is a file and not a directory or something else.
120 121 122 |
# File 'lib/mongrel/command.rb', line 120 def valid_file?(file, ) valid?(file != nil && File.file?(file), ) end |
#valid_group?(group) ⇒ Boolean
139 140 141 142 143 144 145 146 147 |
# File 'lib/mongrel/command.rb', line 139 def valid_group?(group) valid?(@user, "You must also specify a user.") begin Etc.getgrnam(group) rescue failure "Group does not exist: #{group}" @valid = false end end |
#valid_user?(user) ⇒ Boolean
129 130 131 132 133 134 135 136 137 |
# File 'lib/mongrel/command.rb', line 129 def valid_user?(user) valid?(@group, "You must also specify a group.") begin Etc.getpwnam(user) rescue failure "User does not exist: #{user}" @valid = false end end |
#validate ⇒ Object
Returns true/false depending on whether the command is configured properly.
88 89 90 |
# File 'lib/mongrel/command.rb', line 88 def validate return @valid end |