launchd_tools 0.5.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7a74ee78c83f4de133e4d2ae13f21ead304210ef
+  data.tar.gz: ca34827f49bf559be77e8c250471cfa7aa6c2eca
+SHA512:
+  metadata.gz: 03f429b7f92e27e6aa3db2ab370ae418d1a1d0a8d53f18edbb15d926e42b2e4e36a4f2088c919b8733e86eb89abd8808c089b6bc80b034a532000bbc6398edea
+  data.tar.gz: 65c19da4950484a251c349c244e57cad2b76f115e5650f65eb747de9441c6bcf5545c14645cdbf29001f477c0b93ef9feb907fa86aab2f86f3e6d7ea3c770630

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in launchd_tools.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Kyle Crawford
+
+MIT License
+
+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,108 @@
+# Launchd Tools
+
+Convert from command to launchd plist or from launchd plist to command
+
+## Installation
+
+    $ gem install launchd_tools
+
+## Command Usage
+
+Output the command and arguments from a launchd plist:
+
+    $ launchd2cmd /path/to/launchd.plist [another/launchd.plist]
+
+Create a launchd plist from a command and arguments:
+
+    $ cmd2launchd /path/to/daemon [arg] [-option]
+
+## Examples
+
+####launchd2cmd with multiple directories:
+
+    $ launchd2cmd /System/Library/LaunchAgents /System/Library/LaunchDaemons
+    ...
+    # /System/Library/LaunchDaemons/tftp.plist
+    /usr/libexec/tftpd -i /private/tftpboot
+
+####launchd2cmd wildcards/globbing:
+
+    $ launchd2cmd /Library/Launch*/com.googlecode.munki.*
+    ...
+    # /Library/LaunchDaemons/com.googlecode.munki.managedsoftwareupdate-manualcheck.plist
+    /usr/local/munki/supervisor --timeout 43200 -- /usr/local/munki/managedsoftwareupdate --manualcheck
+
+####cmd2launchd creating a launchd plist skeleton:
+
+    $ cmd2launchd /usr/local/bin/daemond -d --mode foreground
+    <?xml version='1.0' encoding='UTF-8'?>
+    <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+    <plist version='1.0'>
+      <dict>
+        <key>ProgramArguments</key>
+        <array>
+          <string>/usr/local/bin/daemond</string>
+          <string>-d</string>
+          <string>--mode</string>
+          <string>foreground</string>
+        </array>
+      </dict>
+    </plist>
+
+## Usage from Ruby
+
+### Parsing a launchd plist
+
+```ruby
+>> require 'launchd_tools/path'
+=> false
+>> sshd_plist_path =
+LaunchdTools::Path.new("/System/Library/LaunchDaemons/ssh.plist")
+=> #<LaunchdTools::Path:0x007f9a7b1a5f50
+@path="/System/Library/LaunchDaemons/ssh.plist">
+>> sshd_job = sshd_plist_path.parse
+=> #<LaunchdTools::LaunchdJob:0x007f9a7aa6cc70
+@attributes={"EnvironmentVariables"=>[],
+"ProgramArguments"=>["/usr/sbin/sshd", "-i"]}>
+>> sshd_job.program_arguments
+=> ["/usr/sbin/sshd", "-i"]
+```
+
+### Creating a launchd plist
+
+```ruby
+>> require 'launchd_tools/launchd_plist'
+=> true
+>> plist = LaunchdTools::LaunchdPlist.new
+=> #<LaunchdTools::LaunchdPlist:0x007fde1c434c78 @doc=<UNDEFINED> ...
+</>, @program_args_array_element=<array/>>
+>> plist.add_program_args(["/usr/local/bin/daemon", "-f", "-o",
+"/var/log/daemon.log"])
+=> ["/usr/local/bin/daemon", "-f", "-o", "/var/log/daemon.log"]
+>> puts plist.to_s
+<?xml version='1.0' encoding='UTF-8'?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
+"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version='1.0'>
+  <dict>
+    <key>ProgramArguments</key>
+    <array>
+      <string>/usr/local/bin/daemon</string>
+      <string>-f</string>
+      <string>-o</string>
+      <string>/var/log/daemon.log</string>
+    </array>
+  </dict>
+</plist>
+```
+
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/TODO

@@ -0,0 +1,3 @@
+Release package made with fpm
+Output errors to stderr
+Test for exit statuses

data/bin/cmd2launchd

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'launchd_tools/cmd2launchd_cli'
+
+LaunchdTools::Cmd2LaunchdCli.new(ARGV).run

data/bin/launchd2cmd

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+require 'launchd_tools/launchd2cmd_cli'
+
+LaunchdTools::Launchd2CmdCli.new(ARGV).run

data/launchd_tools.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'launchd_tools/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "launchd_tools"
+  spec.version       = LaunchdTools::VERSION
+  spec.authors       = ["Kyle Crawford"]
+  spec.email         = ["kcrwfrd@gmail.com"]
+  spec.description   = %q{Provides tools for converting from command line arguments to a formatted launchd plist and vice versa}
+  spec.summary       = %q{launchd tools convert from command to launchd and launchd to command}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "rake"
+end

data/lib/launchd_tools/cmd2launchd_cli.rb

@@ -0,0 +1,38 @@
+require 'launchd_tools/launchd_plist'
+
+module LaunchdTools
+  class Cmd2LaunchdCli
+
+    attr_reader :args
+    def initialize(args)
+      if args.empty?
+        show_usage
+        exit 0
+      elsif args.length == 1
+        case args.first
+        when "--help"
+          show_usage
+          exit 0
+        when "-h"
+          show_usage
+          exit 0
+        when "--version"
+          puts LaunchdTools::VERSION
+          exit 0
+        end
+      end
+      @args = args
+    end
+
+    def show_usage
+      puts "Usage: #{$0} command [arg1] [arg2]"
+    end
+
+    def run
+      plist = LaunchdPlist.new
+      plist.add_program_args(args)
+      puts plist.to_s
+    end
+  end
+end
+

data/lib/launchd_tools/environment_parser.rb

@@ -0,0 +1,31 @@
+require 'rexml/document'
+include REXML
+module LaunchdTools
+  class EnvironmentParser
+    attr_reader :xml_doc, :element
+    def initialize(xml_doc)
+      @xml_doc = xml_doc
+    end
+
+    def element
+      @element ||= REXML::XPath.first(xml_doc, "plist/dict/key[text()='EnvironmentVariables']/following-sibling::dict")
+    end
+
+    def extract_env
+      env = {}
+      REXML::XPath.match(element, 'key').each do |environment_key|
+        env[environment_key.text] = environment_key.next_sibling.next_sibling.text
+      end
+      env
+    end
+
+    def parse
+      if element
+        extract_env
+      else
+        {}
+      end
+    end
+
+  end
+end

data/lib/launchd_tools/environment_variables.rb

@@ -0,0 +1,17 @@
+module LaunchdTools
+  class EnvironmentVariables
+    attr_reader :variables
+    def initialize(variables = {})
+      @variables = variables
+    end
+
+    def to_a
+      env_items = []
+      variables.each do |key,value|
+        env_items << "#{key}=#{value}"
+      end
+      env_items
+    end
+  end
+end
+

data/lib/launchd_tools/launchd2cmd_cli.rb

@@ -0,0 +1,82 @@
+require 'launchd_tools/path'
+require 'optparse'
+module LaunchdTools
+  class Launchd2CmdCli
+    attr_reader :paths, :args
+    def initialize(args)
+      showing_help = false
+      opt_parser = OptionParser.new do |opt|
+        opt.banner = "Usage: #{$0} path/to/launchd.plist"
+        opt.separator ""
+        opt.separator "Options"
+        opt.on("--help", "-h", "Displays this help message") do
+          showing_help = true
+        end
+        opt.on("--version", "outputs version information for this tool") do 
+          puts LaunchdTools::VERSION
+        end
+        opt.separator ""
+      end
+
+      opt_parser.parse!(args)
+
+      if args.empty? || showing_help
+        puts opt_parser
+      else
+        @args = args
+        @paths = extract_paths(args)
+      end
+    end
+
+    def extract_paths(path_args)
+      path_args = path_args.map do |path_arg|
+        if File.directory?(path_arg)
+          path_arg += "/" if path_arg[-1] != "/"
+          path_arg += "*"
+        end
+        path_arg
+      end
+      Dir.glob(path_args)
+    end
+
+    def run
+      errors = 0
+      if paths
+        if paths.length > 0
+          errors = process_each_path
+        else
+          args.each {|arg| puts "No launchd job found at '#{arg}'" }
+          exit 1
+        end
+      end
+      exit 2 if errors > 0
+    end
+
+    def process_path(path_string)
+      error_count = 0
+      begin
+        path = Path.new(path_string).validate
+        puts "# #{path.expanded}"
+        puts path.parse.to_s
+      rescue LaunchdTools::Path::UnparsablePlist
+        puts "Error: unable to parse launchd job\n"
+        error_count = 1
+      rescue LaunchdTools::Path::PermissionsError
+        require 'etc'
+        username = Etc.getpwuid(Process.euid).name
+        puts "Error: user #{username} does not have access to read launchd job\n"
+        error_count = 1
+      end
+      return error_count
+    end
+
+    def process_each_path
+      error_count = 0
+      puts
+      paths.each do |path_string|
+        error_count += process_path(path_string)
+      end
+      return error_count
+    end
+  end
+end

data/lib/launchd_tools/launchd_job.rb

@@ -0,0 +1,45 @@
+module LaunchdTools
+  class LaunchdJob
+    attr_reader :attributes
+    def initialize(attributes = {})
+      @attributes = attributes
+    end
+
+    def environment_variables
+      attributes.fetch('EnvironmentVariables', {})
+    end
+
+    def program_arguments
+      attributes.fetch('ProgramArguments', [])
+    end
+
+    def to_s
+      escaped_args = program_arguments.map {|arg| shellescape(arg) }
+      puts (environment_variables + escaped_args).join(" ")
+    end
+
+    # from ruby's shellescape
+    # included here for ruby 1.8 compatibility
+    def shellescape(str)
+      str = str.to_s
+
+      # An empty argument will be skipped, so return empty quotes.
+      return "''" if str.empty?
+
+      str = str.dup
+
+      # Treat multibyte characters as is.  It is caller's responsibility
+      # to encode the string in the right encoding for the shell
+      # environment.
+      str.gsub!(/([^A-Za-z0-9_\-.,:\/@\n])/, "\\\\\\1")
+
+      # A LF cannot be escaped with a backslash because a backslash + LF
+      # combo is regarded as line continuation and simply ignored.
+      str.gsub!(/\n/, "'\n'")
+
+      return str
+    end
+
+  end
+end
+

data/lib/launchd_tools/launchd_plist.rb

@@ -0,0 +1,44 @@
+require 'rexml/document'
+include REXML
+module LaunchdTools
+  class LaunchdPlist
+    attr_reader :doc, :program_args_array_element
+
+    def initialize
+      base = %q[<?xml version='1.0' encoding='UTF-8'?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">]
+      @doc = Document.new(base)
+      plist_element = Element.new('plist')
+      doc.add_element(plist_element, {"version" => "1.0"})
+      base_dictionary = Element.new('dict')
+      plist_element.add_element(base_dictionary)
+      program_args_key_element = Element.new('key')
+      program_args_key_element.text = 'ProgramArguments'
+      base_dictionary.add_element(program_args_key_element)
+      @program_args_array_element = Element.new "array"
+      base_dictionary.add_element(program_args_array_element)
+    end
+
+
+    def add_program_arg(arg)
+      string_element = Element.new "string"
+      string_element.text = arg
+      program_args_array_element << string_element
+    end
+
+    def add_program_args(args)
+      args.each do |arg|
+        add_program_arg(arg)
+      end
+    end
+
+    def to_s
+      formatter = REXML::Formatters::Pretty.new # (2)
+      formatter.compact = true
+      xml_string = String.new
+      formatter.write(doc, xml_string)
+      xml_string
+    end
+  end
+end
+

data/lib/launchd_tools/path.rb

@@ -0,0 +1,47 @@
+require 'launchd_tools/path_parser'
+require 'launchd_tools/path_content'
+
+module LaunchdTools
+  class Path
+
+    class UnparsablePlist < Exception
+    end
+
+    class PermissionsError < Exception
+    end
+
+    attr_reader :path
+
+    def initialize(path)
+      @path = path
+    end
+
+    def validate
+      raise PathMissingError unless File.exist?(path)
+      self
+    end
+
+    def content
+      PathContent.new(path).to_s
+    end
+
+    def parse
+      begin
+        path_parser.parse
+      rescue Errno::EACCES
+        raise PermissionsError.new
+      rescue
+        raise UnparsablePlist.new
+      end
+    end
+
+    def path_parser
+      PathParser.new(self)
+    end
+
+    def expanded
+      File.expand_path(path)
+    end
+
+  end
+end

data/lib/launchd_tools/path_content.rb

@@ -0,0 +1,24 @@
+module LaunchdTools
+  class PathContent
+    attr_reader :path
+    def initialize(path)
+      @path = path
+    end
+
+    def to_s
+      if binary?
+        `plutil -convert xml1 -o /dev/stdout '#{path}'`
+      else
+        File.read(path)
+      end
+    end
+
+    def binary?
+      f = File.open(path, "r")
+      f.read(6) == "bplist"
+    ensure
+      f.close if f
+    end
+  end
+
+end

data/lib/launchd_tools/path_parser.rb

@@ -0,0 +1,34 @@
+require 'rexml/document'
+require 'launchd_tools/launchd_job'
+require 'launchd_tools/environment_parser'
+require 'launchd_tools/environment_variables'
+require 'launchd_tools/program_args_parser'
+
+include REXML
+module LaunchdTools
+  class PathParser
+    attr_reader :path, :xml_doc
+    def initialize(path)
+      @path = path
+    end
+
+    # returns a parsed launchd job
+    def parse
+      LaunchdJob.new({ 'EnvironmentVariables' => parse_env, 'ProgramArguments' => parse_program_args })
+    end
+
+    def parse_env
+      variables = EnvironmentParser.new(xml_doc).parse
+      EnvironmentVariables.new(variables).to_a
+    end
+
+    def parse_program_args
+      ProgramArgsParser.new(xml_doc).parse
+    end
+
+    def xml_doc
+      @xml_doc ||= Document.new(path.content)
+    end
+
+  end
+end

data/lib/launchd_tools/program_args_parser.rb

@@ -0,0 +1,21 @@
+require 'rexml/document'
+include REXML
+module LaunchdTools
+  class ProgramArgsParser
+    attr_reader :xml_doc, :element
+    def initialize(xml_doc)
+      @xml_doc = xml_doc
+    end
+
+    def parse
+      element = REXML::XPath.first(xml_doc, "plist/dict/key[text()='ProgramArguments']/following-sibling::array")
+      if element
+        args_strings = XPath.match(element, 'string')
+        args_strings.map {|e| e.text }
+      else
+        program_string_element = REXML::XPath.first(xml_doc, "plist/dict/key[text()='Program']/following-sibling::string")
+        [program_string_element.text]
+      end
+    end
+  end
+end

data/lib/launchd_tools/version.rb

@@ -0,0 +1,3 @@
+module LaunchdTools
+  VERSION = "0.5.0"
+end

data/lib/launchd_tools.rb

@@ -0,0 +1,5 @@
+require "launchd_tools/version"
+
+module LaunchdTools
+  # Your code goes here...
+end

data/spec/fixtures/LaunchAgents/com.apple.dt.CommandLineTools.installondemand.plist

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>Label</key>
+	<string>com.apple.dt.CommandLineTools.installondemand</string>
+	<key>MachServices</key>
+	<dict>
+		<key>com.apple.dt.CommandLineTools.installondemand</key>
+		<true/>
+	</dict>
+	<key>OnDemand</key>
+	<true/>
+	<key>EnableTransactions</key>
+	<true/>
+	<key>Program</key>
+	<string>/System/Library/CoreServices/Install Command Line Developer Tools.app/Contents/MacOS/Install Command Line Developer Tools</string>
+	<key>LimitLoadToSessionType</key>
+	<string>Aqua</string>
+</dict>
+</plist>

data/spec/fixtures/LaunchAgents/com.apple.storeagent.plist

@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>Label</key>
+	<string>com.apple.storeagent</string>
+	<key>MachServices</key>
+	<dict>
+		<key>com.apple.storeagent</key>
+		<true/>
+		<key>com.apple.storeagent-xpc</key>
+		<true/>
+		<key>com.apple.storeagent.storekit</key>
+		<string></string>
+	</dict>
+	<key>OnDemand</key>
+	<true/>
+	<key>Program</key>
+	<string>/System/Library/PrivateFrameworks/CommerceKit.framework/Versions/A/Resources/storeagent</string>
+	<key>EnableTransactions</key>
+	<true/>
+	<key>LimitLoadToSessionType</key>
+	<array>
+		<string>LoginWindow</string>
+		<string>Aqua</string>
+	</array>
+	<key>LaunchEvents</key>
+	<dict>
+		<key>com.apple.usernotificationcenter.matching</key>
+		<dict>
+			<key>store</key>
+			<dict>
+				<key>bundleid</key>
+                <string>com.apple.appstore</string>
+				<key>delay registration</key>
+				<true/>
+				<key>events</key>
+                <array>
+					<string>didDismissAlert</string>
+					<string>didActivateNotification</string>
+					<string>didDeliverNotification</string>
+					<string>didSnoozeAlert</string>
+					<string>didRemoveDeliveredNotifications</string>
+					<string>didExpireNotifications</string>
+				</array>
+			</dict>
+		</dict>
+	</dict>
+</dict>
+</plist>

data/spec/fixtures/LaunchDaemons/inaccessible.plist

@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>Disabled</key>
+	<true/>
+	<key>Label</key>
+	<string>com.openssh.sshd</string>
+	<key>Program</key>
+	<string>/usr/libexec/sshd-keygen-wrapper</string>
+	<key>ProgramArguments</key>
+	<array>
+		<string>/usr/sbin/sshd</string>
+		<string>-i</string>
+	</array>
+	<key>Sockets</key>
+	<dict>
+		<key>Listeners</key>
+		<dict>
+			<key>SockServiceName</key>
+			<string>ssh</string>
+			<key>Bonjour</key>
+			<array>
+				<string>ssh</string>
+				<string>sftp-ssh</string>
+			</array>
+		</dict>
+	</dict>
+	<key>inetdCompatibility</key>
+	<dict>
+		<key>Wait</key>
+		<false/>
+	</dict>
+	<key>StandardErrorPath</key>
+	<string>/dev/null</string>
+	<key>SHAuthorizationRight</key>
+	<string>system.preferences</string>
+	<key>POSIXSpawnType</key>
+	<string>Interactive</string>
+</dict>
+</plist>

data/spec/fixtures/LaunchDaemons/org.apache.httpd.plist

@@ -0,0 +1,25 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>Disabled</key>
+	<true/>
+	<key>EnvironmentVariables</key>
+	<dict>
+		<key>XPC_SERVICES_UNAVAILABLE</key>
+		<string>1</string>
+	</dict>
+	<key>Label</key>
+	<string>org.apache.httpd</string>
+	<key>OnDemand</key>
+	<false/>
+	<key>ProgramArguments</key>
+	<array>
+		<string>/usr/sbin/httpd</string>
+		<string>-D</string>
+		<string>FOREGROUND</string>
+	</array>
+	<key>SHAuthorizationRight</key>
+	<string>system.preferences</string>
+</dict>
+</plist>

data/spec/integration/cmd2launchd_spec.rb

@@ -0,0 +1,25 @@
+require 'tempfile'
+describe 'running cmd2launchd' do
+  it "converts right back to original commmand using launchd2cmd" do
+    t = Tempfile.new(File.basename(__FILE__))
+    temp_file_path = t.path
+    t.close
+    output = `bundle exec bin/cmd2launchd ls -la /tmp > #{temp_file_path} && bundle exec bin/launchd2cmd #{temp_file_path}`
+    expect(output.chomp).to include("ls -la /tmp")
+    File.unlink(temp_file_path)
+  end
+
+  context "no arguments" do
+    it "outputs usage info" do
+      output = `bundle exec bin/cmd2launchd`
+      expect(output.chomp).to include("Usage: ")
+    end
+  end
+
+  context "help option" do
+    it "outputs usage info" do
+      output = `bundle exec bin/cmd2launchd -h`
+      expect(output.chomp).to include("Usage: ")
+    end
+  end
+end

data/spec/integration/launchd2cmd_spec.rb

@@ -0,0 +1,82 @@
+describe 'running launchd2cmd' do
+
+  context 'launch agent' do
+    it 'outputs the command' do
+      output = `bundle exec bin/launchd2cmd spec/fixtures/LaunchAgents/com.apple.storeagent.plist`
+      expect(output.chomp).to include("/System/Library/PrivateFrameworks/CommerceKit.framework/Versions/A/Resources/storeagent")
+    end
+    it "outputs a comment line with path to the plist" do
+      output = `bundle exec bin/launchd2cmd spec/fixtures/LaunchAgents/com.apple.storeagent.plist`
+      expect(output.chomp).to include("# #{File.expand_path("spec/fixtures/LaunchAgents/com.apple.storeagent.plist")}")
+    end
+  end
+
+  context "no arguments" do
+    it "outputs usage info" do
+      output = `bundle exec bin/launchd2cmd`
+      expect(output.chomp).to include("Usage: ")
+    end
+  end
+
+  context "help option" do
+    it "outputs usage info" do
+      output = `bundle exec bin/launchd2cmd -h`
+      expect(output.chomp).to include("Usage: ")
+    end
+  end
+
+  context "inaccessible file" do
+    it "outputs relevant error message" do
+      inaccessible_path = 'spec/fixtures/LaunchDaemons/inaccessible.plist'
+      File.chmod(0000, inaccessible_path)
+      output = `bundle exec bin/launchd2cmd #{inaccessible_path}`
+      File.chmod(0644, inaccessible_path)
+      require 'etc'
+      username = Etc.getpwuid(Process.euid).name
+      expect(output).to include("Error: user #{username} does not have access to read launchd job")
+    end
+  end
+
+  context "unparsable file" do
+    it "outputs relevant error message" do
+      output = `bundle exec bin/launchd2cmd #{__FILE__}`
+      expect(output).to include("Error: unable to parse launchd job")
+    end
+  end
+
+  context 'bad file paths' do
+    it "outputs relevant error message" do
+      output = `bundle exec bin/launchd2cmd not/a/real/path and/another/bad/path`
+      expect(output).to include("No launchd job found at 'not/a/real/path'")
+      expect(output).to include("No launchd job found at 'and/another/bad/path'")
+    end
+  end
+  context 'launch daemon' do
+    context 'with environment variables' do
+      it 'includes argument and environment variables in output' do
+        output = `bundle exec bin/launchd2cmd spec/fixtures/LaunchDaemons/org.apache.httpd.plist`
+        expect(output.chomp).to include("XPC_SERVICES_UNAVAILABLE=1 /usr/sbin/httpd -D FOREGROUND")
+      end
+    end
+  end
+  context "binary plist" do
+    it "handles it without error" do
+      output = `bundle exec bin/launchd2cmd spec/fixtures/LaunchDaemons/com.apple.opendirectoryd.plist`
+      expect(output.chomp).to include("__CFPREFERENCES_AVOID_DAEMON=1 __CF_USER_TEXT_ENCODING=0x0:0:0 /usr/libexec/opendirectoryd")
+    end
+  end
+
+  context "args are directories" do
+    it "lists contents of directory" do
+      command = "bundle exec bin/launchd2cmd spec/fixtures/LaunchAgents > /dev/null"
+      expect(system(command)).to be_true
+    end
+  end
+
+  context "program arguments contain spaces" do
+    it "escapes them for use in the shell" do
+      output = `bundle exec bin/launchd2cmd spec/fixtures/LaunchAgents/com.apple.dt.CommandLineTools.installondemand.plist`
+      expect(output.chomp).to include("/System/Library/CoreServices/Install\\ Command\\ Line\\ Developer\\ Tools.app/Contents/MacOS/Install\\ Command\\ Line\\ Developer\\ Tools")
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,17 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+end

metadata

@@ -0,0 +1,127 @@
+--- !ruby/object:Gem::Specification
+name: launchd_tools
+version: !ruby/object:Gem::Version
+  version: 0.5.0
+platform: ruby
+authors:
+- Kyle Crawford
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-02-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  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: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Provides tools for converting from command line arguments to a formatted
+  launchd plist and vice versa
+email:
+- kcrwfrd@gmail.com
+executables:
+- cmd2launchd
+- launchd2cmd
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- TODO
+- bin/cmd2launchd
+- bin/launchd2cmd
+- launchd_tools.gemspec
+- lib/launchd_tools.rb
+- lib/launchd_tools/cmd2launchd_cli.rb
+- lib/launchd_tools/environment_parser.rb
+- lib/launchd_tools/environment_variables.rb
+- lib/launchd_tools/launchd2cmd_cli.rb
+- lib/launchd_tools/launchd_job.rb
+- lib/launchd_tools/launchd_plist.rb
+- lib/launchd_tools/path.rb
+- lib/launchd_tools/path_content.rb
+- lib/launchd_tools/path_parser.rb
+- lib/launchd_tools/program_args_parser.rb
+- lib/launchd_tools/version.rb
+- spec/fixtures/LaunchAgents/com.apple.dt.CommandLineTools.installondemand.plist
+- spec/fixtures/LaunchAgents/com.apple.storeagent.plist
+- spec/fixtures/LaunchDaemons/com.apple.opendirectoryd.plist
+- spec/fixtures/LaunchDaemons/inaccessible.plist
+- spec/fixtures/LaunchDaemons/org.apache.httpd.plist
+- spec/integration/cmd2launchd_spec.rb
+- spec/integration/launchd2cmd_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.1
+signing_key: 
+specification_version: 4
+summary: launchd tools convert from command to launchd and launchd to command
+test_files:
+- spec/fixtures/LaunchAgents/com.apple.dt.CommandLineTools.installondemand.plist
+- spec/fixtures/LaunchAgents/com.apple.storeagent.plist
+- spec/fixtures/LaunchDaemons/com.apple.opendirectoryd.plist
+- spec/fixtures/LaunchDaemons/inaccessible.plist
+- spec/fixtures/LaunchDaemons/org.apache.httpd.plist
+- spec/integration/cmd2launchd_spec.rb
+- spec/integration/launchd2cmd_spec.rb
+- spec/spec_helper.rb