Metadata-Version: 1.1
Name: supercron
Version: 0.2.1
Summary: Intelligent interface to cron in UNIX systems
Home-page: https://github.com/linostar/SuperCron
Author: Anas El Husseini
Author-email: linux.anas@gmail.com
License: BSD
Download-URL: https://github.com/linostar/SuperCron/tarball/0.2.0
Description: SuperCron
        =========
        
        Intelligent interface to cron in UNIX systems.
        
        Installation
        ------------
        
        Run ``pip install supercron`` or ``easy_install supercron``.
        
        SuperCron vs classical crontab
        ------------------------------
        
        SuperCron is based on crontab, while providing the following additional
        advantages: 
        
        - it can run interactively or non-interactively. 
        
        - it allows controlling several jobs simultaneously if they were assigned the same job name. 
        
        - it provides more options to handle jobs: adding, removing, searching, enabling, disabling, etc. 
        
        - it allows a vast and flexible amount of repetition sentences. 
        
        - it is more friendly especially to new sysadmins.
        
        Usage
        -----
        
        SuperCron can run either in interactive mode or non-interactive mode.
        
        **Interactive mode:**
        
        Run ``supercron`` without any arguments to start interactive mode. You
        will prompted to choose an action, and then to enter action parameters
        (like ``name``, ``command`` and ``repetition``) if any.
        
        **Non-interactive mode:**
        
        In non-interactive mode, at least one of the following options/arguments
        has to be used after the command name ``supercron``.
        
        -  option ``-h`` or ``--help``: shows the help message, with some usage examples
        
        -  option ``-V`` or ``--version``: displays the version number
        
        Additionally, one of the following subcommands can be used: add, delete,
        enable, disable, search, clear.
        
        ***Subcommand add*** 
        
        - option ``-h`` or ``--help``: shows the help message of the subcommand 
        
        - option ``-q`` or ``--quiet``: optional; suppresses all output and error messages 
        
        - option ``-c`` or ``--command``: required; here goes the command to be executed 
        
        - option ``-r`` or ``--repetition``: required; the repetition sentence (see examples below) 
        
        - argument ``name``: required; represents the job name which will be added (several jobs can share the same name)
        
        ***Subcommands delete, enable and disable*** 
        
        - option ``-h`` or ``--help``: shows the help message of the subcommand 
        
        - option ``-q`` or ``--quiet``: optional; suppresses all output and error messages 
        - argument ``name``: required; represents the job name on which the action will occur (several jobs can share the same name)
        
        ***Subcommand search*** 
        
        - option ``-h`` or ``--help``: shows the help message of the subcommand 
        
        - argument ``name``: required; the exact job name to search for, or ``@supercron`` to list all SuperCron jobs, or ``@all`` to list all user's crontab entries
        
        ***Subcommand clear***
        
        It will only clear SuperCron jobs from user's crontab: 
        
        - option ``-h`` or ``--help``: shows the help message of the subcommand 
        
        - option ``-f`` or ``--force``: skips asking for confirmation before clearing all jobs
        
        Examples
        --------
        
        -  Add a job:
        
           ::
        
               supercron add -c "date +%j >> log_file" -r "every 2 days" log_dates
               supercron add -c "scp -r /path1 user@server:/path2" -r "at 11:50 pm on mondays" backup_server
        
        -  Delete a job:
        
           ::
        
               supercron delete log_dates
        
        -  Enable a job:
        
           ::
        
               supercron enable log_dates
        
        -  Disable a job:
        
           ::
        
               supercron disable log_dates
        
        -  Search jobs:
        
           ::
        
               supercron search log_dates
               supercron search @supercron
               supercron search @all
        
        -  Clear all SuperCron jobs:
        
           ::
        
               supercron clear
        
        Repetition sentences
        --------------------
        
        Repetition sentences are provided in a ``supercron add`` command
        directly after the ``-r`` or ``--repetition`` option.
        
        Examples of accepted repetition sentences (case insensitive): 
        
        - everyday
        
        - at midnight 
        
        - every 5 minutes 
        
        - once every 2 hours 
        
        - every 10 days 
        
        - every 4 months 
        
        - on mondays 
        
        - on monday, wednesday and friday 
        
        - from saturday to tuesday 
        
        - on fri 
        
        - on mon, wed and fri 
        
        - from mon to thu 
        
        - at 11:50 
        
        - at 23:50 
        
        - at 10:10 am 
        
        - at 10:10 pm 
        
        - on 19/5 
        
        - in september
        
        - in sep 
        
        - from may to august 
        
        - from dec to feb 
        
        - in january and april 
        
        - in jan, aug, oct
        
        Repetition sentences can also be any (unsorted) logical mix of the
        above. For example: 
        
        - at 09:00 every 3 days 
        
        - from june to november every 2 hours 
        
        - every 30 minutes on fri and sat 
        
        - midnight from monday to friday in october and december
        
        Homepage and Repository
        -----------------------
        
        Homepage: `<https://linostar.github.io/SuperCron>`__
        
        Repository: `<https://github.com/linostar/SuperCron>`__
        
        License and Authors
        -------------------
        
        This software is licensed under the revised BSD license.
        
        Authors:
        
        - Anas El Husseini (linux.anas [at] gmail [dot] com)
        
Keywords: cron,crontab,scheduling
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: System Administrators
Classifier: Topic :: Utilities
Classifier: Topic :: System :: Systems Administration
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
