Metadata-Version: 1.1
Name: plunchy
Version: 1.0.1
Summary: A simpler interface into OS X's launchctl
Home-page: https://github.com/epochblue/plunchy
Author: Bill Israel
Author-email: bill.israel@gmail.com
License: MIT
Description: plunchy
        =======
        
        .. image:: https://img.shields.io/pypi/v/plunchy.svg
            :target: https://pypi.python.org/pypi/plunchy
        
        ``plunchy`` is a simple interface into OS X's launchctl_. It is based on the idea behind Mike Perham's ``lunchy`` (`link <https://github.com/mperham/lunchy>`_) Ruby script, though there are a few small differences between the two:
        
        1. By default, ``plunchy`` does not install items into the system's ``LaunchAgents`` folders. Unless you jump through hoops, items in those folders are automatically started at system boot, defeating the purpose of managing startup and shutdown for your launch agents.
        2. Also by default, if you do want a file to be installed in a ``LaunchAgents`` folder, ``plunchy`` will symlink the file, rather than copy it. This allows you to automatically receive updates if the launch agent is updated.
        
        
        ``plunchy`` does want to maintain the simplicity of the original, however, so the available commands largely mirror ``lunchy``'s:
        
        * ``ls [pattern]``        List all launch agents, or only ones matching the given pattern.
        * ``list [pattern]``      Alias for ``ls``
        * ``start {pattern}``     Start the launch agent matching the given pattern.
        * ``stop {pattern}``      Stop the launch agent matching the given pattern.
        * ``restart {pattern}``   Restart the launch agent matching the given pattern.
        * ``status {pattern}``    Display the status of all launch agents matching the pattern.
        * ``show {pattern}``      See the launch agent with the specified pattern
        * ``edit {pattern}``      Edit the launch agent with the specified pattern
        
        The main area where ``plunchy`` differs, however, is in the installation of scripts. ``plunchy`` provides the following commands for installing scripts:
        
        * ``add {path}``          Add the agent to ``~/.plunchy`` to be started/stopped manually
        * ``install {path}``      Alias for ``add``
        * ``link {path}``         Install the agent into ``~/Library/LaunchAgents`` via symlink (*)
        * ``copy {path}``         Install the agent into ``~/Library/LaunchAgents`` via file copy (*)
        
        
        (\*) Doing this means the launch agent will be loaded/started when the system boots up.
        
        
        Installation
        ------------
        
        The easiest way to install `plunchy` is via `pip`:
        
        .. code-block:: console
        
            pip install plunchy
        
        License
        -------
        
        ``plunchy`` is MIT licensed. Please see the included ``LICENSE`` file.
        
        Authors
        -------
        
        * Bill Israel - `@epochblue`_ - `http://billisrael.info/`_
        * Marc Abramowitz - `@msabramo`_ - `http://marc-abramowitz.com/`_
        
        .. _launchctl: https://developer.apple.com/library/mac/documentation/Darwin/Reference/ManPages/man1/launchctl.1.html
        .. _@epochblue: https://twitter.com/epochblue
        .. _http://billisrael.info/: http://billisrael.info/
        .. _@msabramo: https://twitter.com/msabramo
        .. _http://marc-abramowitz.com/: http://marc-abramowitz.com/
        
Keywords: os x,launchctl,lunchy
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Environment :: MacOS X
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Utilities
