Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
One stop shop for launchd property list creation. The doctor is *in*!
Ruby
branch: master

Version bump to 3.

Encompasses:
* Replacing old requirements
* Fixing bugs with key coercion
latest commit dce16e313a
@ELLIOTTCABLE authored

README.markdown

LaunchDoctor

I've got a PhD in launchd, and I'm not afraid to use it!

Usage

LaunchDoctor is really simple. It is essentially an easy interface to launchd's property list files.

There are three ways to use LaunchDoctor - the simplest being directly creating property lists and treating them as hashes:

require 'launchdr'
plist = LaunchDr::Launchd.new "name.elliottcable.launchdr.test"
plist[:program_arguments] = ['/Applications/Calculator.app/Contents/MacOS/Calculator']
plist.dump LaunchDr::Launchd::Paths[:user_agent]

The second is to use the common block idiom, provided by the LaunchDr() method:

require 'launchdr'
LaunchDr "name.elliottcable.launchdr.test" do |plist|
  plist[:program_arguments] = ['/Applications/Calculator.app/Contents/MacOS/Calculator']
end

LaunchDoctor will automatically add the property list to launchctl, and then start it running. Once you run the above snippet, the target will immediately be launched for the first time.

LaunchDoctor can write (dump) the property lists to any place on your disk, but the idiom method assumes you're going to want to use one of the directories that launchd checks for property lists. These are stored in the Launchd::Paths array. The default is to place it in the user-owned agents directory at ~/Library/LaunchAgents.

LaunchDoctor also preforms some 'prettification' on the keys provided by launchd's property list structure. All of the keys on the launchd.plist manpage are available, but they can also be used as true 'Ruby-ish' symbol keys. All of the following are legal:

plist["UserName"] = "elliottcable"
plist[:UserName] = "elliottcable"
plist[:user_name] = "elliottcable"

Finally, you can use the Rake task interface to the last method. It simply wraps the last method inside a rake task. This method is really great if you want to provide a way to let users make your gem's binary run all the time:

require 'launchdr/task'
LaunchDr::Task.new :launchd, :bin => 'jello', :arguments => ['-D', 'shortener', 'grabup']

This isn't very flexible, but it's not very complicated either. If you need more control over the plist, just use the second method inside a task block. This method defaults to making your gem's binary run_at_load and be keep_alive as well, so it won't die.

Requirements

  • Plist - gem install plist
  • Ruby Facets - gem install facets
Something went wrong with that request. Please try again.