ops_team 1.0.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e74fe375694383d5cf99385e04c314e804a2ab1aae6b03558b811e78874c65e
-  data.tar.gz: 4c9f31d818c8bc456c4c9c37d40d42491dde28ef6e038eee77ff0e7c42e7a6da
+  metadata.gz: 284cb7b523fa92a233a477d63adf73ca4257a460968fa135e722af70d7782e33
+  data.tar.gz: e9ec66dfe05a1411b5a3180cbffe5545ec23dfc193d06150c80a2cb96147bcd9
 SHA512:
-  metadata.gz: 87320ca1362f2691ad4808bca8b7733b2d1be4bc70b4ca06b650267bf5c50c7d69e64a554fc91d246c821e17454794ae0aadb9cca27ea747f7092f5f636a6492
-  data.tar.gz: 6b6bee1687f1858a1097931e336ddcf28fe4f50a9b8802cded747a034f4fefddbcab0fd4331bd961a269811384eb574bfca4e4cc69c5cca576a709bcb2cb59e0
+  metadata.gz: 4f399f48ff25956007f5ee9f7ff043b01c06639d1c58ba6d2dbffbaac5705b33b6c0d94a8a323279b7781aa8a199b8076c3f98e645b9e1a27c1e418cffd4c876
+  data.tar.gz: 0abe327dc2b32a4a82124a1de5f83e71f2d2674b2d3d102cd96db47a4dbed316d094d9041c9f2a2d729176c0cd2cc4ee1c393726f659d4a8d1460e2a1ac03ec6

data/Gemfile

@@ -6,6 +6,7 @@ git_source(:github) { |repo_name| "https://github.com/#{repo_name}" }
 
 gem "bcrypt_pbkdf"
 gem "colorize"
+gem 'concurrent-ruby', require: 'concurrent'
 gem "e2mmap"
 gem "ed25519"
 gem "ejson"

data/bin/ops

@@ -1,8 +1,31 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require_relative "../loader"
+require 'optparse'
+
+
+def usage
+	puts "Usage: ops [-f|--file <ops_yml>] action [<action args>"
+	puts "  ops_yml:      the config file to load instead of './ops.yml'"
+	puts "  action_args:  arguments to the action loaded from the config file; depends on the action"
+
+	exit(1)
+end
 
+options = {}
+while ARGV[0]&.match(/^-/)
+	opt = ARGV.shift
+	case opt
+	when '-f', '--file'
+		usage unless ARGV.length >= 1
+
+		options[:file] = ARGV.shift
+	else
+		usage
+	end
+end
+
+require_relative "../loader"
 require 'ops'
 
-Ops.new(ARGV).run
+Ops.new(ARGV, config_file: options[:file]).run

data/lib/action.rb

@@ -17,7 +17,11 @@ class Action
 			raise NotAllowedInEnvError, "Action not allowed in #{Environment.environment} environment."
 		end
 
-		Kernel.exec(to_s)
+		if perform_shell_expansion?
+			Kernel.exec(to_s)
+		else
+			Kernel.exec(*to_a)
+		end
 	end
 
 	def to_s
@@ -60,6 +64,10 @@ class Action
 
 	private
 
+	def to_a
+		command.split(" ").reject(&:nil?) | @args
+	end
+
 	def not_in_envs
 		@config["not_in_envs"] || []
 	end
@@ -75,4 +83,8 @@ class Action
 
 		true
 	end
+
+	def perform_shell_expansion?
+		@config["shell_expansion"].nil? ? true : @config["shell_expansion"]
+	end
 end

data/lib/builtins/countdown.rb

@@ -0,0 +1,74 @@
+# frozen_string_literal: true
+
+require 'concurrent'
+
+require 'builtin'
+require 'output'
+
+module Builtins
+	class Countdown < Builtin
+		USAGE_STRING = "Usage: ops countdown <seconds>"
+
+		class << self
+			def description
+				"Like `sleep`, but displays time remaining in terminal."
+			end
+		end
+
+		def run
+			check_args
+
+			timer_task.execute
+
+			while timer_task.running?
+				sleep(1)
+				timer_task.shutdown if task_complete?
+			end
+			Output.out("\rCountdown complete after #{sleep_seconds}s.")
+		end
+
+		private
+
+		def check_args
+			check_arg_count
+			check_arg_is_positive_int
+		end
+
+		def check_arg_count
+			raise Builtin::ArgumentError, USAGE_STRING unless args.length == 1
+		end
+
+		def check_arg_is_positive_int
+			raise Builtin::ArgumentError, USAGE_STRING unless sleep_seconds.positive?
+		# raised when the arg is not an int
+		rescue ::ArgumentError
+			raise Builtin::ArgumentError, USAGE_STRING
+		end
+
+		def timer_task
+			@timer_task ||= Concurrent::TimerTask.new(run_now: true, execution_interval: 1) do
+				Output.print("\r#{seconds_left}")
+			end
+		end
+
+		def sleep_seconds
+			Integer(args.first)
+		end
+
+		def task_start_time
+			@task_start_time ||= Time.now
+		end
+
+		def task_end_time
+			@task_end_time ||= task_start_time + sleep_seconds
+		end
+
+		def task_complete?
+			Time.now > task_end_time
+		end
+
+		def seconds_left
+			Integer(task_end_time - Time.now + 1)
+		end
+	end
+end

data/lib/dependencies/cask.rb

@@ -5,11 +5,11 @@ require 'dependencies/brew'
 module Dependencies
 	class Cask < Brew
 		def met?
-			execute("brew cask list #{name}")
+			execute("brew list --cask #{name}")
 		end
 
 		def meet
-			execute("brew cask install #{name}")
+			execute("brew install --cask #{name}")
 		end
 	end
 end

data/lib/environment.rb

@@ -13,8 +13,9 @@ class Environment
 		end
 	end
 
-	def initialize(env_hash)
+	def initialize(env_hash, config_path)
 		@env_hash = env_hash
+		@config_path = config_path
 	end
 
 	def set_variables
@@ -26,7 +27,7 @@ class Environment
 	private
 
 	def set_ops_variables
-		ENV["OPS_YML_DIR"] = Dir.pwd
+		ENV["OPS_YML_DIR"] = File.dirname(@config_path)
 		ENV["OPS_VERSION"] = Version.version.to_s
 		ENV["OPS_SECRETS_FILE"] = Secrets.config_path_for(Environment.environment)
 		ENV["OPS_CONFIG_FILE"] = AppConfig.config_path_for(Environment.environment)

data/lib/ops.rb

@@ -5,25 +5,15 @@ require 'yaml'
 require 'require_all'
 require "rubygems"
 
-require 'hook_handler'
-require 'action'
 require 'output'
 require 'options'
-require 'environment'
 require 'version'
-require 'action_list'
-require 'action_suggester'
-require 'forwards'
+require 'runner'
 
 require_rel "builtins"
 
 # executes commands based on local `ops.yml`
 class Ops
-	class UnknownActionError < StandardError; end
-	class ActionConfigError < StandardError; end
-
-	CONFIG_FILE = "ops.yml"
-
 	INVALID_SYNTAX_EXIT_CODE = 64
 	UNKNOWN_ACTION_EXIT_CODE = 65
 	ERROR_LOADING_APP_CONFIG_EXIT_CODE = 66
@@ -40,50 +30,55 @@ class Ops
 		end
 	end
 
-	def initialize(argv)
+	def initialize(argv, config_file: nil)
 		@action_name = argv[0]
 		@args = argv[1..-1]
+		@config_file = config_file || "ops.yml"
 
 		Options.set(config["options"] || {})
 	end
 
+	# rubocop:disable Metrics/MethodLength
+	# better to have all the rescues in one place
 	def run
 		# "return" is here to allow specs to stub "exit" without executing everything after it
 		return exit(INVALID_SYNTAX_EXIT_CODE) unless syntax_valid?
 		return exit(MIN_VERSION_NOT_MET_EXIT_CODE) unless min_version_met?
 
-		run_action
-	rescue UnknownActionError => e
+		runner.run
+	rescue Runner::UnknownActionError => e
 		Output.error(e.to_s)
 		Output.out(RECOMMEND_HELP_TEXT) unless print_did_you_mean
 		exit(UNKNOWN_ACTION_EXIT_CODE)
-	rescue ActionConfigError => e
+	rescue Runner::ActionConfigError => e
 		Output.error("Error(s) running action '#{@action_name}': #{e}")
 		exit(ACTION_CONFIG_ERROR_EXIT_CODE)
+	rescue Builtin::ArgumentError => e
+		Output.error("Error running builtin '#{@action_name}': #{e}")
+		exit(BUILTIN_SYNTAX_ERROR_EXIT_CODE)
+	rescue AppConfig::ParsingError => e
+		Output.error("Error parsing app config: #{e}")
+		exit(ERROR_LOADING_APP_CONFIG_EXIT_CODE)
+	rescue Action::NotAllowedInEnvError => e
+		Output.error("Error running action #{@action_name}: #{e}")
+		exit(ACTION_NOT_ALLOWED_IN_ENV_EXIT_CODE)
 	end
+	# rubocop:enable Metrics/MethodLength
 
 	private
 
 	def syntax_valid?
-		if @action_name.nil?
-			Output.error("Usage: ops <action>")
-			Output.out(RECOMMEND_HELP_TEXT)
-			false
-		else
-			true
-		end
+		return true unless @action_name.nil?
+
+		Output.error("Usage: ops <action>")
+		Output.out(RECOMMEND_HELP_TEXT)
+		false
 	end
 
 	def print_did_you_mean
-		suggestions = did_you_mean.check(@action_name)
+		Output.out("Did you mean '#{runner.suggestions.join(", ")}'?") if runner.suggestions.any?
 
-		Output.out("Did you mean '#{suggestions.join(", ")}'?") if suggestions.any?
-
-		suggestions.any?
-	end
-
-	def did_you_mean
-		ActionSuggester.new(action_list.names + action_list.aliases + builtin_names)
+		runner.suggestions.any?
 	end
 
 	def min_version_met?
@@ -101,96 +96,34 @@ class Ops
 		config["min_version"]
 	end
 
-	def run_action
-		return forward.run if forward
-
-		do_before_all
-
-		return builtin.run if builtin
-
-		raise UnknownActionError, "Unknown action: #{@action_name}" unless action
-		raise ActionConfigError, action.config_errors.join("; ") unless action.config_valid?
-
-		do_before_action
-		Output.notice("Running '#{action}' from #{CONFIG_FILE} in environment '#{ENV['environment']}'...")
-		action.run
-	rescue Builtin::ArgumentError => e
-		Output.error("Error running builtin '#{@action_name}': #{e}")
-		exit(BUILTIN_SYNTAX_ERROR_EXIT_CODE)
-	rescue AppConfig::ParsingError => e
-		Output.error("Error parsing app config: #{e}")
-		exit(ERROR_LOADING_APP_CONFIG_EXIT_CODE)
-	rescue Action::NotAllowedInEnvError => e
-		Output.error("Error running action #{@action_name}: #{e}")
-		exit(ACTION_NOT_ALLOWED_IN_ENV_EXIT_CODE)
-	end
-
-	def do_before_all
-		AppConfig.load
-		Secrets.load if action && action.load_secrets?
-		environment.set_variables
-	end
-
-	def do_before_action
-		return if ENV["OPS_RUNNING"] || action.skip_hooks?("before")
-
-		# this prevents before hooks from running in ops executed by ops
-		ENV["OPS_RUNNING"] = "1"
-		hook_handler.do_hooks("before")
-	end
-
-	def hook_handler
-		@hook_handler ||= HookHandler.new(config)
-	end
-
-	def builtin
-		@builtin ||= Builtin.class_for(name: @action_name).new(@args, config)
-	rescue NameError
-		# this means there isn't a builtin with that name in that module
-		nil
-	end
-
-	def builtin_names
-		Builtins.constants.select { |c| Builtins.const_get(c).is_a? Class }.map(&:downcase)
-	end
-
-	def forward
-		@forward ||= Forwards.new(@config, @args).get(@action_name)
-	end
-
-	def action
-		return action_list.get(@action_name) if action_list.get(@action_name)
-		return action_list.get_by_alias(@action_name) if action_list.get_by_alias(@action_name)
-	end
-
-	def action_list
-		@action_list ||= begin
-			Output.warn("'ops.yml' has no 'actions' defined.") if config.any? && config["actions"].nil?
-
-			ActionList.new(config["actions"], @args)
-		end
+	def runner
+		@runner ||= Runner.new(@action_name, @args, config, config_file_absolute_path)
 	end
 
 	def config
 		@config ||= begin
-			if File.exist?(CONFIG_FILE)
-				YAML.load_file(CONFIG_FILE)
+			if config_file_exists?
+				parsed_config_contents
 			else
-				Output.warn("File '#{CONFIG_FILE}' does not exist.") unless @action_name == "init"
+				Output.warn("File '#{@config_file}' does not exist.") unless @action_name == "init"
 				{}
 			end
-		rescue StandardError => e
-			Output.warn("Error parsing '#{CONFIG_FILE}': #{e}")
-			{}
 		end
 	end
 
-	def env_vars
-		config.dig("options", "environment") || {}
+	def parsed_config_contents
+		YAML.load_file(@config_file)
+	rescue StandardError => e
+		Output.warn("Error parsing '#{@config_file}': #{e}")
+		{}
+	end
+
+	def config_file_exists?
+		File.exist?(@config_file)
 	end
 
-	def environment
-		@environment ||= Environment.new(env_vars)
+	def config_file_absolute_path
+		File.expand_path(@config_file)
 	end
 end
 

data/lib/runner.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+require 'hook_handler'
+require 'action'
+require 'action_list'
+require 'action_suggester'
+require 'forwards'
+require 'environment'
+
+class Runner
+	class UnknownActionError < StandardError; end
+	class ActionConfigError < StandardError; end
+
+	def initialize(action_name, args, config, config_path)
+		@action_name = action_name
+		@args = args
+		@config = config
+		@config_path = config_path
+	end
+
+	def run
+		return forward.run if forward
+
+		do_before_all
+
+		return builtin.run if builtin
+
+		raise UnknownActionError, "Unknown action: #{@action_name}" unless action
+		raise ActionConfigError, action.config_errors.join("; ") unless action.config_valid?
+
+		do_before_action
+		Output.notice("Running '#{action}' in environment '#{ENV['environment']}'...")
+		action.run
+	end
+
+	def suggestions
+		@suggestions ||= ActionSuggester.new(action_list.names + action_list.aliases + builtin_names).check(@action_name)
+	end
+
+	private
+
+	def do_before_all
+		AppConfig.load
+		Secrets.load if action&.load_secrets?
+		environment.set_variables
+	end
+
+	def do_before_action
+		return if ENV["OPS_RUNNING"] || action.skip_hooks?("before")
+
+		# this prevents before hooks from running in ops executed by ops
+		ENV["OPS_RUNNING"] = "1"
+		hook_handler.do_hooks("before")
+	end
+
+	def hook_handler
+		@hook_handler ||= HookHandler.new(@config)
+	end
+
+	def builtin
+		@builtin ||= Builtin.class_for(name: @action_name).new(@args, @config)
+	rescue NameError
+		# this means there isn't a builtin with that name in that module
+		nil
+	end
+
+	def builtin_names
+		Builtins.constants.select { |c| Builtins.const_get(c).is_a? Class }.map(&:downcase)
+	end
+
+	def forward
+		@forward ||= Forwards.new(@config, @args).get(@action_name)
+	end
+
+	def action
+		return action_list.get(@action_name) if action_list.get(@action_name)
+		return action_list.get_by_alias(@action_name) if action_list.get_by_alias(@action_name)
+	end
+
+	def action_list
+		@action_list ||= begin
+			Output.warn("'ops.yml' has no 'actions' defined.") if @config.any? && @config["actions"].nil?
+
+			ActionList.new(@config["actions"], @args)
+		end
+	end
+
+	def env_vars
+		@config.dig("options", "environment") || {}
+	end
+
+	def environment
+		@environment ||= Environment.new(env_vars, @config_path)
+	end
+end

data/ops_team.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
 	s.name = 'ops_team'
-	s.version = '1.0.0'
+	s.version = '1.3.0'
 	s.authors = [
 		'nickthecook@gmail.com'
 	]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ops_team
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.3.0
 platform: ruby
 authors:
 - nickthecook@gmail.com
@@ -94,22 +94,22 @@ dependencies:
   name: net-ssh
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 6.1.0
     - - "~>"
       - !ruby/object:Gem::Version
         version: '6.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 6.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 6.1.0
     - - "~>"
       - !ruby/object:Gem::Version
         version: '6.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 6.1.0
 - !ruby/object:Gem::Dependency
   name: require_all
   requirement: !ruby/object:Gem::Requirement
@@ -152,6 +152,7 @@ files:
 - lib/builtin.rb
 - lib/builtins/background.rb
 - lib/builtins/background_log.rb
+- lib/builtins/countdown.rb
 - lib/builtins/down.rb
 - lib/builtins/env.rb
 - lib/builtins/envdiff.rb
@@ -181,6 +182,7 @@ files:
 - lib/ops.rb
 - lib/options.rb
 - lib/output.rb
+- lib/runner.rb
 - lib/secrets.rb
 - lib/version.rb
 - loader.rb
@@ -204,7 +206,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.2
 signing_key:
 specification_version: 4
 summary: ops_team handles basic operations tasks for your project, driven by YAML