potluck 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 50b13dbd4649490c2673d9dde14aef89251279b2ea39c6cb816d110320078efa
+  data.tar.gz: f380c5e9c07a27b55bfa20a5a4deddbb3e1978ecb9d63db8acc5888e9457f533
+SHA512:
+  metadata.gz: 878a3446024f4ef4ac5464acb7866ed5517d27dd4a113ed2e2f24c119d9a0416bc82eb5cf00462a0dd4e3a602a566bf15a9f1b900c8e28fba5734399ed5a3d48
+  data.tar.gz: 0fe2162e70524a4bd85eba990d32b5d5397c4366bb8532d3f8a11a06824e7bce169f03b4dbe27e04600f0763a62a6f4a596a597f24ce4197a1bdb07e8ee8de07

data/LICENSE

@@ -0,0 +1,16 @@
+Copyright 2021 Nate Pickens
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the Software without restriction, including without
+limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial
+portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT
+LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO
+EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
+AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
+OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,30 @@
+# Potluck
+
+Potluck is an extensible Ruby framework for managing external processes.
+
+## Installation
+
+Add this line to your Gemfile:
+
+```ruby
+gem('potluck')
+```
+
+Or install manually on the command line:
+
+```bash
+gem install potluck
+```
+
+## Usage
+
+[Coming soon.]
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/npickens/potluck.
+
+## License
+
+The gem is available as open source under the terms of the
+[MIT License](https://opensource.org/licenses/MIT).

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/lib/potluck.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative('potluck/dish')
+
+module Potluck
+  DIR = File.expand_path(File.join(ENV['HOME'], '.potluck')).freeze
+  IS_MACOS = !!RUBY_PLATFORM[/darwin/]
+end

data/lib/potluck/dish.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+module Potluck
+  class Dish
+    SERVICE_PREFIX = 'potluck.npickens.'
+
+    PLIST_XML = '<?xml version="1.0" encoding="UTF-8"?>'
+    PLIST_DOCTYPE = '<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/Prope'\
+      'rtyList-1.0.dtd">'
+
+    LAUNCHCTL_ERROR_REGEX = /^-|\t[^0]\t/.freeze
+
+    def initialize(logger: nil, is_local: nil)
+      @logger = logger
+      @is_local = is_local.nil? ? (IS_MACOS && ensure_launchctl! rescue false) : is_local
+    end
+
+    def ensure_launchctl!
+      @@launchctl = `which launchctl` && $? == 0 unless defined?(@@launchctl)
+      @@launchctl || raise("Cannot manage #{self.class.to_s.split('::').last}: launchctl not found")
+    end
+
+    def ensure_plist
+      File.write(self.class.plist_path, self.class.plist)
+    end
+
+    def status
+      return :inactive unless @is_local && ensure_launchctl!
+
+      output = `launchctl list 2>&1 | grep #{SERVICE_PREFIX}#{self.class.service_name}`
+
+      if $? != 0
+        :inactive
+      elsif output[LAUNCHCTL_ERROR_REGEX]
+        :error
+      else
+        :active
+      end
+    end
+
+    def start
+      return unless @is_local && ensure_launchctl!
+
+      ensure_plist
+
+      case status
+      when :error then stop
+      when :active then return
+      end
+
+      run("launchctl bootstrap gui/#{Process.uid} #{self.class.plist_path}")
+      wait { status == :inactive }
+
+      raise("Could not start #{self.class.pretty_name}") if status != :active
+
+      log("#{self.class.pretty_name} started")
+    end
+
+    def stop
+      return unless @is_local && ensure_launchctl! && status != :inactive
+
+      run("launchctl bootout gui/#{Process.uid}/#{self.class.launchctl_name}")
+      wait { status != :inactive }
+
+      raise("Could not stop #{self.class.pretty_name}") if status != :inactive
+
+      log("#{self.class.pretty_name} stopped")
+    end
+
+    def restart
+      return unless @is_local && ensure_launchctl!
+
+      stop
+      start
+    end
+
+    def run(command, redirect_stderr: true)
+      output = `#{command}#{' 2>&1' if redirect_stderr}`
+      status = $?
+
+      if status != 0
+        output.split("\n").each { |line| log(line, :error) }
+        raise("Command exited with status #{status.to_i}: #{command}")
+      else
+        output
+      end
+    end
+
+    def log(message, error = false)
+      if @logger
+        error ? @logger.error(message) : @logger.info(message)
+      else
+        error ? $stderr.puts(message) : $stdout.puts(message)
+      end
+    end
+
+    private
+
+    def wait(timeout = 30, &block)
+      while block.call && timeout > 0
+        reduce = [[(30 - timeout.to_i) / 5.0, 0.1].max, 1].min
+        timeout -= reduce
+
+        sleep(reduce)
+      end
+    end
+
+    def self.pretty_name
+      @pretty_name ||= self.to_s.split('::').last
+    end
+
+    def self.service_name
+      @service_name ||= pretty_name.downcase
+    end
+
+    def self.launchctl_name
+      "#{SERVICE_PREFIX}#{service_name}"
+    end
+
+    def self.plist_path
+      File.join(DIR, "#{launchctl_name}.plist")
+    end
+
+    def self.plist(content)
+      <<~EOS
+        #{PLIST_XML}
+        #{PLIST_DOCTYPE}
+        <plist version="1.0">
+        <dict>
+          <key>Label</key>
+          <string>#{launchctl_name}</string>
+          <key>RunAtLoad</key>
+          <true/>
+          <key>KeepAlive</key>
+          <false/>
+          #{content.gsub(/^/, '  ').strip}
+        </dict>
+        </plist>
+      EOS
+    end
+  end
+end

data/lib/potluck/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Potluck
+  VERSION = '0.0.1'
+end

metadata

@@ -0,0 +1,85 @@
+--- !ruby/object:Gem::Specification
+name: potluck
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Nate Pickens
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2021-03-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.11.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 6.0.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 5.11.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 6.0.0
+description: An extensible Ruby framework for managing external processes.
+email:
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- VERSION
+- lib/potluck.rb
+- lib/potluck/dish.rb
+- lib/potluck/version.rb
+homepage: https://github.com/npickens/potluck
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://github.com/npickens/potluck
+  source_code_uri: https://github.com/npickens/potluck
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.8
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.3
+signing_key:
+specification_version: 4
+summary: An extensible Ruby framework for managing external processes.
+test_files: []