uppityrobot 0.2.0

data/lib/uppityrobot/cli/commands/monitors/list.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module UppityRobot
+  module CLI
+    module Commands
+      module Monitors
+        # UppityRobot::CLI::Commands::Monitors::List lists monitors
+        class List < Dry::CLI::Command
+          desc "List Monitors"
+
+          option :csv, type: :string, desc: "Path to additionally save results as csv"
+          option :filter, type: :string, default: "{}", desc: "Filter string for monitors"
+          option :search, type: :string, desc: "keyword within url or friendly_name"
+
+          example [
+            "--search aspace",
+            '--filter \'{"friendly_name": "^aspace-"}\'',
+            '--search aspace --filter \'{"status": 0}\''
+          ]
+
+          def call(csv: nil, filter: "{}", search: nil, **)
+            filter   = JSON.parse(filter)
+            filtered = { stat: "ok", total: 0, monitors: [] }
+            params   = search ? { search: search } : {}
+            total    = 0
+
+            UppityRobot::Client.new(:getMonitors, params).filter(filter).each do |m|
+              filtered[:monitors] << m
+              total += 1
+            end
+
+            filtered[:total] = total
+            write_csv(csv, filtered[:monitors])
+            puts filtered.to_json
+          rescue JSON::ParserError => e
+            puts JSON.generate({ stat: "fail", error: "JSON parser #{e.message}" })
+          end
+
+          def write_csv(file, data)
+            return unless file
+
+            CSV.open(File.expand_path(file), "wb", encoding: "UTF-8") do |csv|
+              csv << data.first.keys
+              data.each { |hash| csv << hash.values }
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/uppityrobot/cli/commands/monitors/update.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module UppityRobot
+  module CLI
+    module Commands
+      module Monitors
+        # UppityRobot::CLI::Commands::Monitors::Update update monitors
+        class Update < Dry::CLI::Command
+          desc "Update monitors"
+
+          argument :format, required: true, values: %w[csv json], desc: "The format to use for updates"
+          argument :data, required: true, desc: "The data file or (json) string for updates"
+
+          example [
+            "csv monitors.csv",
+            "json monitors.json",
+            'json \'[{"id": 1, "friendly_name": "newName"}]\''
+          ]
+
+          # rubocop:disable Metrics/AbcSize
+          def call(format:, data:, **)
+            check_format(format)
+            data = parse_data(format, data)
+            unless data.is_a? Array
+              abort(
+                { stat: "fail", error: "Data must be an array: #{data.inspect}" }.to_json
+              )
+            end
+
+            updated = { stat: "ok", total: 0, updated: 0, monitors: [], errors: [] }
+            data.each do |d|
+              original = d.dup # UptimeRobot::Client modifies `d`, avoid this for errors
+              updated[:total] += 1
+              updated[:monitors] << UppityRobot::Client.new(:editMonitor, d).execute
+              updated[:updated] += 1
+            rescue UptimeRobot::Error => e
+              updated[:errors] << "#{e.message} for: #{original.inspect}"
+            end
+
+            puts updated.to_json
+          rescue CSV::MalformedCSVError, JSON::ParserError => e
+            puts JSON.generate({ stat: "fail", error: "Invalid input: #{e.message}" })
+          end
+          # rubocop:enable Metrics/AbcSize
+
+          def check_format(format)
+            return if %w[csv json].include? format
+
+            abort({ stat: "fail",
+                    error: "Format not recognized, must be one of: [csv, json]" }.to_json)
+          end
+
+          def parse_data(format, data)
+            if format == "json" && File.file?(data)
+              JSON.parse(File.read(data))
+            elsif format == "json"
+              JSON.parse(data)
+            elsif format == "csv" && File.file?(data)
+              rows = []
+              CSV.foreach(data, headers: true, header_converters: :symbol) do |row|
+                rows << row.to_hash
+              end
+              rows
+            else
+              abort({ stat: "fail", error: "Error parsing data: #{format}, #{data.inspect}" }.to_json)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/uppityrobot/cli/commands/registry.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module UppityRobot
+  module CLI
+    # UppityRobot::CLI::Commands Registry
+    module Commands
+      extend Dry::CLI::Registry
+
+      register "exec", Exec, aliases: ["e"]
+      register "version", Version, aliases: ["v", "-v", "--version"]
+
+      register "monitors", aliases: ["m"] do |prefix|
+        prefix.register "create", Monitors::Create
+        prefix.register "delete", Monitors::Delete
+        prefix.register "exec",   Monitors::Exec
+        prefix.register "list",   Monitors::List
+        prefix.register "update", Monitors::Update
+      end
+    end
+  end
+end

data/lib/uppityrobot/cli/commands/version.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module UppityRobot
+  module CLI
+    module Commands
+      # UppityRobot::CLI::Commands::Version prints version
+      class Version < Dry::CLI::Command
+        desc "Print UppityRobot CLI tool version"
+
+        def call(*)
+          puts UppityRobot::VERSION
+        end
+      end
+    end
+  end
+end

data/lib/uppityrobot/client.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+module UppityRobot
+  # UppityRobot::Client is a CLI focused wrapper for the UptimeRobot::Client
+  class Client
+    attr_reader :response
+
+    RECORD_TYPES = {
+      getAlertContacts: "alert_contacts",
+      getMonitors: "monitors"
+    }.freeze
+
+    def initialize(task, params)
+      @client   = client
+      @task     = verify_task(task)
+      @params   = params
+      @response = nil
+    end
+
+    def execute
+      @response = client.send(@task, @params)
+    end
+
+    def filter(filter = {})
+      type = RECORD_TYPES[@task]
+      Enumerator.new do |yielder|
+        paginate.each do |response, _offset, _total|
+          response[type].find_all do |record|
+            satisfies_conditions = true
+            filter.each do |key, regex|
+              satisfies_conditions = false unless record.key?(key) && record[key].to_s =~ /#{regex}/
+            end
+            yielder << record if satisfies_conditions
+          end
+        end
+      end.lazy
+    end
+
+    def paginate
+      Enumerator.new do |yielder|
+        @params.delete :offset # we want to start from the beginning
+        response = execute # initial connection
+        offset   = 0
+        limit    = response["pagination"]["limit"]
+        total    = response["pagination"]["total"]
+
+        loop do
+          raise StopIteration if offset >= total
+
+          @params  = @params.merge({ offset: offset })
+          response = execute
+          yielder << [response, offset, total]
+          offset += limit
+        end
+      end.lazy
+    end
+
+    # use when a single record result is expected & required
+    def fetch
+      verify_fetch_params
+      # TODO: support alert_contacts search (requires filter)
+      response = execute
+      verify_fetch_total response
+      response[RECORD_TYPES[@task]].first
+    end
+
+    private
+
+    def client
+      options = { api_key: ENV.fetch("UPTIMEROBOT_API_KEY") }
+      options[:url] = ENV["UPTIMEROBOT_ENDPOINT"] if ENV["UPTIMEROBOT_ENDPOINT"]
+      UptimeRobot::Client.new(options)
+    rescue KeyError => e
+      abort({ stat: "fail", error: "Error, #{e.message}" }.to_json)
+    end
+
+    def parse_total(response)
+      response.key?("total") ? response["total"] : response["pagination"]["total"]
+    end
+
+    def verify_fetch_params
+      return if @params.key?(:search) || @params.key?(RECORD_TYPES[@task].to_sym)
+
+      abort(
+        { stat: "fail", error: "Attempted fetch without required params" }.to_json
+      )
+    end
+
+    def verify_fetch_total(response)
+      total = parse_total response
+      return if total == 1
+
+      abort(
+        {
+          stat: "fail",
+          error: "Unique record lookup failed: #{response.inspect}"
+        }.to_json
+      )
+    end
+
+    def verify_task(task)
+      unless UptimeRobot::Client::METHODS.include? task
+        error = {
+          stat: "fail",
+          error: "Task not recognized [#{task}], must be: #{UptimeRobot::Client::METHODS.join(", ")}"
+        }.to_json
+        abort(error)
+      end
+      task
+    end
+  end
+end

data/lib/uppityrobot/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module UppityRobot
+  VERSION = "0.2.0"
+end

data/lib/uppityrobot.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "csv"
+require "dry/cli"
+require "json"
+require "uptimerobot"
+
+require_relative "uppityrobot/client"
+require_relative "uppityrobot/version"
+require_relative "uppityrobot/cli/commands/exec"
+require_relative "uppityrobot/cli/commands/monitors/create"
+require_relative "uppityrobot/cli/commands/monitors/delete"
+require_relative "uppityrobot/cli/commands/monitors/exec"
+require_relative "uppityrobot/cli/commands/monitors/list"
+require_relative "uppityrobot/cli/commands/monitors/update"
+require_relative "uppityrobot/cli/commands/version"
+
+# load the registry last
+require_relative "uppityrobot/cli/commands/registry"
+
+module UppityRobot
+  class Error < StandardError; end
+
+  ROOT = Gem::Specification.find_by_name("uppityrobot").gem_dir
+end

data/uppityrobot.gemspec

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative "lib/uppityrobot/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "uppityrobot"
+  spec.version       = UppityRobot::VERSION
+  spec.authors       = ["Mark Cooper"]
+  spec.email         = ["mark.c.cooper@outlook.com"]
+
+  spec.summary       = "Command line wrapper for the UptimeRobot API (wrapper)."
+  spec.description   = "Command line wrapper for the UptimeRobot API (wrapper)."
+  spec.homepage      = "https://github.com/lyrasis/uppityrobot.git"
+  spec.license       = "MIT"
+  spec.required_ruby_version = ">= 2.7.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{\A(?:test|spec|features)/}) }
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "dry-cli", "~> 0.7"
+  spec.add_dependency "json", "~> 2.5"
+  spec.add_dependency "uptimerobot", "~> 0.2"
+
+  spec.add_development_dependency "aruba"
+  spec.add_development_dependency "capybara_discoball"
+  spec.add_development_dependency "cucumber"
+  spec.add_development_dependency "json_spec"
+  spec.add_development_dependency "pry"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "rspec", "~> 3.2"
+  spec.add_development_dependency "rubocop", "~> 1.7"
+  spec.add_development_dependency "sinatra"
+  spec.add_development_dependency "webmock"
+end

metadata

@@ -0,0 +1,261 @@
+--- !ruby/object:Gem::Specification
+name: uppityrobot
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- Mark Cooper
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2021-09-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: dry-cli
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.7'
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: uptimerobot
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+- !ruby/object:Gem::Dependency
+  name: aruba
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: capybara_discoball
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: json_spec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Command line wrapper for the UptimeRobot API (wrapper).
+email:
+- mark.c.cooper@outlook.com
+executables:
+- uppityrobot
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/main.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".vscode/settings.json"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- exe/uppityrobot
+- fixtures/deleteMonitor.json
+- fixtures/editMonitor.json
+- fixtures/getAlertContacts.json
+- fixtures/getMonitor.unknown.json
+- fixtures/getMonitors.google.json
+- fixtures/getMonitors.json
+- fixtures/getMonitors.mywebpage.json
+- fixtures/newMonitor.json
+- lib/uppityrobot.rb
+- lib/uppityrobot/cli/commands/exec.rb
+- lib/uppityrobot/cli/commands/monitors/create.rb
+- lib/uppityrobot/cli/commands/monitors/delete.rb
+- lib/uppityrobot/cli/commands/monitors/exec.rb
+- lib/uppityrobot/cli/commands/monitors/list.rb
+- lib/uppityrobot/cli/commands/monitors/update.rb
+- lib/uppityrobot/cli/commands/registry.rb
+- lib/uppityrobot/cli/commands/version.rb
+- lib/uppityrobot/client.rb
+- lib/uppityrobot/version.rb
+- uppityrobot.gemspec
+homepage: https://github.com/lyrasis/uppityrobot.git
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/lyrasis/uppityrobot.git
+  source_code_uri: https://github.com/lyrasis/uppityrobot.git
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.6
+signing_key: 
+specification_version: 4
+summary: Command line wrapper for the UptimeRobot API (wrapper).
+test_files: []