{ "info": { "author": "Anas El Husseini", "author_email": "linux.anas@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Environment :: Console", "Intended Audience :: End Users/Desktop", "Intended Audience :: System Administrators", "License :: OSI Approved :: BSD License", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Topic :: System :: Systems Administration", "Topic :: Utilities" ], "description": "SuperCron\n=========\n\nInstallation\n------------\n\nRun ``pip install supercron``.\n\nSuperCron vs classical crontab\n------------------------------\n\nSuperCron is based on crontab, while providing the following additional\nadvantages: \n\n- it can run interactively or non-interactively. \n\n- it allows controlling several jobs simultaneously if they were assigned the same job name. \n\n- it provides more options to handle jobs: adding, removing, searching, enabling, disabling, etc. \n\n- it allows a vast and flexible amount of repetition sentences.\n\n- it allows trigger-induced jobs based on the states of other jobs.\n\n- it is more friendly especially to new sysadmins.\n\nUsage\n-----\n\nSuperCron can run either in interactive mode or non-interactive mode.\n\nInteractive mode:\n~~~~~~~~~~~~~~~~~\n\nRun ``supercron`` without any arguments to start interactive mode. You\nwill prompted to choose an action, and then to enter action parameters\n(like ``name``, ``command`` and ``repetition``) if any.\n\nNon-interactive mode:\n~~~~~~~~~~~~~~~~~~~~~\n\nIn non-interactive mode, one of the following options can be used after the command name ``supercron``.\n\n- option ``-h`` or ``--help``: shows the help message, with some usage examples\n\n- option ``-V`` or ``--version``: displays the version number\n\nAdditionally, one of the following subcommands can be used: add, delete,\nenable, disable, search, clear, trigger.\n\n**Subcommand add**\n\n- option ``-h`` or ``--help``: shows the help message of the subcommand \n\n- option ``-q`` or ``--quiet``: optional; suppresses all output and error messages \n\n- option ``-c`` or ``--command``: required; here goes the command to be executed \n\n- option ``-r`` or ``--repetition``: required; the repetition sentence (see examples below) \n\n- argument ``name``: required; represents the job name which will be added (several jobs can share the same name)\n\n**Subcommand rename**\n\n- option `-h` or `--help`: shows the help message of the subcommand\n\n- option `-q` or `--quiet`: optional; suppresses all output and error messages\n\n- argument `old_name`: required; old name of the job(s) (several jobs can share the same name)\n\n- argument `new_name`: required; new name of the job(s) (several jobs can share the same name)\n\n**Subcommands delete, enable and disable**\n\n- option ``-h`` or ``--help``: shows the help message of the subcommand \n\n- option ``-q`` or ``--quiet``: optional; suppresses all output and error messages \n\n- argument ``name``: required; represents the job name on which the action will occur (several jobs can share the same name)\n\n**Subcommand search**\n\n- option ``-h`` or ``--help``: shows the help message of the subcommand \n\n- 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\n\n**Subcommand clear**\n\n- option ``-h`` or ``--help``: shows the help message of the subcommand\n\n- option `-q` or `--quiet`: optional; suppresses all output and error messages\n\n- option ``-f`` or ``--force``: skips asking for confirmation before clearing all jobs\n\nNote: this subcommand will only clear SuperCron jobs from user's crontab.\n\n**Subcommand trigger**\n\n- option ``-h`` or ``--help``: shows the help message of the subcommand\n\n- option ``-q`` or ``--quiet``: optional; suppresses all output and error messages\n\n- option ``-t`` or ``--trigger``: trigger in the form of \"none\" or \"*ACTION* if *NAME* is *STATE*\". See **Triggers** section below.\n\n- argument ``name``: required; represents the triggered job name on which *ACTION* will occur (several jobs can share the same name)\n\nTriggers\n--------\n\nTriggers can take one of 2 forms:\n\n- \"none\" for removing the previous trigger\n\n- \"*ACTION* if *NAME* is *STATE*\" for adding a new trigger or replacing an old one\n\n*ACTION* is the action applied on the enabled state of the triggered job and it can be ``on``, ``off`` or ``toggle``.\n\n*NAME* is the name of the triggering job.\n\n*STATE* is the triggering state of the triggering job, and it can be ``enabled``, ``disabled``, ``toggled``, ``added`` or ``deleted``.\n\nUsing action ``toggle`` means to enable the triggered job if it was disabled, and to disable it if it was enabled.\n\nState ``toggled`` activates the trigger when the triggering job is enabled or disabled.\n\nNote that when a job is renamed from *name1* to *name2*, it means activating triggers that end with ``if name1 is deleted`` and triggers that end with ``if name2 is added``, since a rename is considered a deletion of the old job name and an addition of the new job name.\n\nExamples\n--------\n\n- Add a job:\n\n ::\n\n supercron add -c \"date +%j >> log_file\" -r \"every 2 days\" log_dates\n supercron add -c \"scp -r /path1 user@server:/path2\" -r \"at 11:50 pm on mondays\" backup_server\n\n- Rename a job:\n\n ::\n\n supercron rename log_dates log_all_dates\n\n- Delete a job:\n\n ::\n\n supercron delete log_dates\n\n- Enable a job:\n\n ::\n\n supercron enable log_dates\n\n- Disable a job:\n\n ::\n\n supercron disable log_dates\n\n- Search jobs:\n\n ::\n\n supercron search log_dates\n supercron search @supercron\n supercron search @all\n\n- Clear all SuperCron jobs:\n\n ::\n\n supercron clear\n\n- Add trigger to a job:\n\n ::\n\n supercron trigger -t \"on if log_months is off\" log_days\n\n- Remove trigger from a job:\n\n ::\n\n supercron trigger -t none log_days\n\nRepetition sentences\n--------------------\n\nRepetition sentences are provided in a ``supercron add`` command\ndirectly after the ``-r`` or ``--repetition`` option.\n\nExamples of accepted repetition sentences (case insensitive): \n\n- everyday\n\n- at midnight \n\n- every 5 minutes \n\n- once every 2 hours \n\n- every 10 days \n\n- every 4 months \n\n- on mondays \n\n- on monday, wednesday and friday \n\n- from saturday to tuesday \n\n- on fri \n\n- on mon, wed and fri \n\n- from mon to thu \n\n- at 11:50 \n\n- at 23:50 \n\n- at 10:10 am \n\n- at 10:10 pm \n\n- on 19/5\n\n- on 14 May\n\n- in september\n\n- in sep \n\n- from may to august \n\n- from dec to feb \n\n- in january and april \n\n- in jan, aug, oct\n\nRepetition sentences can also be any (unsorted) logical mix of the\nabove. For example: \n\n- at 09:00 every 3 days \n\n- from june to november every 2 hours \n\n- every 30 minutes on fri and sat \n\n- midnight from monday to friday in october and december\n\nHomepage and Repository\n-----------------------\n\nHomepage: ``__\n\nRepository: ``__\n\nLicense and Authors\n-------------------\n\nThis software is licensed under the revised BSD license.\n\nAuthors:\n\n- Anas El Husseini (linux.anas [at] gmail [dot] com)", "description_content_type": null, "docs_url": null, "download_url": "https://github.com/linostar/SuperCron/tarball/0.3.2", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "https://linostar.github.io/SuperCron", "keywords": "cron,crontab,scheduling", "license": "BSD", "maintainer": null, "maintainer_email": null, "name": "supercron", "package_url": "https://pypi.org/project/supercron/", "platform": "UNKNOWN", "project_url": "https://pypi.org/project/supercron/", "project_urls": { "Download": "https://github.com/linostar/SuperCron/tarball/0.3.2", "Homepage": "https://linostar.github.io/SuperCron" }, "release_url": "https://pypi.org/project/supercron/0.3.2/", "requires_dist": null, "requires_python": null, "summary": "Intelligent interface to cron in UNIX systems", "version": "0.3.2" }, "last_serial": 1749046, "releases": { "0.1.2": [ { "comment_text": "", "digests": { "md5": "7c612e2bd2999b1677eac658527535c2", "sha256": "25c4a757cbb1eaf627c150f2c56aa5687cb057d5ca74823c3dd10365e37a364e" }, "downloads": -1, "filename": "supercron-0.1.2.tar.gz", "has_sig": false, "md5_digest": "7c612e2bd2999b1677eac658527535c2", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 5394, "upload_time": "2015-09-24T12:53:09", "url": "https://files.pythonhosted.org/packages/91/36/e10a8e90c3da114add42c11f62f5302b4eb141328e6b390733e7eed91465/supercron-0.1.2.tar.gz" } ], "0.2.0": [ { "comment_text": "", "digests": { "md5": "547e1390faaa899b9c6b134b8be55748", "sha256": "9bb34a157b4a0ebab0582b40ea1df26a215f706202b5961952bfb6252ec9c4e6" }, "downloads": -1, "filename": "supercron-0.2.0.tar.gz", "has_sig": false, "md5_digest": "547e1390faaa899b9c6b134b8be55748", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7873, "upload_time": "2015-09-27T05:47:24", "url": "https://files.pythonhosted.org/packages/ad/3d/c537e7bf7ae2474b0e0802f00bcf47c61b7291cdcf5ec635c6fe0cf19560/supercron-0.2.0.tar.gz" } ], "0.2.1": [ { "comment_text": "", "digests": { "md5": "0027cbbe6f66ef8bf898837b5551c76b", "sha256": "c50b8cc68fedd6fcbf2116171c22a79b63447327511f2f344220e4a482291e2a" }, "downloads": -1, "filename": "supercron-0.2.1.tar.gz", "has_sig": false, "md5_digest": "0027cbbe6f66ef8bf898837b5551c76b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10952, "upload_time": "2015-09-27T06:33:17", "url": "https://files.pythonhosted.org/packages/2b/93/9aa019d294962b169ca250c06f83cf5d5fb0e295de43cbdc94f7f7da066e/supercron-0.2.1.tar.gz" } ], "0.2.2": [ { "comment_text": "", "digests": { "md5": "2c6d785129d1c6a8b321654582df246b", "sha256": "ff6663cfc57cad5557d67e33acffd1e1ecff113b0bf4c1074dfcad04e915ba28" }, "downloads": -1, "filename": "supercron-0.2.2.tar.gz", "has_sig": false, "md5_digest": "2c6d785129d1c6a8b321654582df246b", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 10957, "upload_time": "2015-09-27T06:42:42", "url": "https://files.pythonhosted.org/packages/53/9b/2b9f8359690d38a625d8549489a2e56725717e8413b113ab9f562bd35907/supercron-0.2.2.tar.gz" } ], "0.3.0": [ { "comment_text": "", "digests": { "md5": "c5501c9bfe8f80782a0589a6f0abd3b1", "sha256": "646f5cf85f0304496c64278fb365956cfd48b84df89974836cad948f7c551b70" }, "downloads": -1, "filename": "supercron-0.3.0.tar.gz", "has_sig": false, "md5_digest": "c5501c9bfe8f80782a0589a6f0abd3b1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 14953, "upload_time": "2015-09-29T08:18:17", "url": "https://files.pythonhosted.org/packages/1c/e7/7189bba2cc3af17fc6b531cb2b196af4829bf6f7976bdf95d1cc17e2be4d/supercron-0.3.0.tar.gz" } ], "0.3.1": [ { "comment_text": "", "digests": { "md5": "f50798eb4a32fb883bc158e658dd2b58", "sha256": "fac6200c62b28178d77122d7d929a546ed4b9d6b8ac8a1827972383eabb9bb45" }, "downloads": -1, "filename": "supercron-0.3.1.tar.gz", "has_sig": false, "md5_digest": "f50798eb4a32fb883bc158e658dd2b58", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 15107, "upload_time": "2015-10-02T13:05:23", "url": "https://files.pythonhosted.org/packages/ab/64/2ff1d60970c087c3812aa00cef087c762a1da26d3ee83c4bb7dce26fc891/supercron-0.3.1.tar.gz" } ], "0.3.2": [ { "comment_text": "", "digests": { "md5": "3188e22c42b4d5205553c96713091c20", "sha256": "d492eb1c7cb4c6698a020ac11a4e83fe8d2626fa5541f457929cb57f9d938a90" }, "downloads": -1, "filename": "supercron-0.3.2.tar.gz", "has_sig": false, "md5_digest": "3188e22c42b4d5205553c96713091c20", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16607, "upload_time": "2015-10-02T14:01:42", "url": "https://files.pythonhosted.org/packages/d8/d1/5102d3e60b812249dec7496929732999ca5703b0e2271f4761408f8eb391/supercron-0.3.2.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "3188e22c42b4d5205553c96713091c20", "sha256": "d492eb1c7cb4c6698a020ac11a4e83fe8d2626fa5541f457929cb57f9d938a90" }, "downloads": -1, "filename": "supercron-0.3.2.tar.gz", "has_sig": false, "md5_digest": "3188e22c42b4d5205553c96713091c20", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 16607, "upload_time": "2015-10-02T14:01:42", "url": "https://files.pythonhosted.org/packages/d8/d1/5102d3e60b812249dec7496929732999ca5703b0e2271f4761408f8eb391/supercron-0.3.2.tar.gz" } ] }