{
    "info": {
        "author": "Blake Rohde",
        "author_email": "blake@blakerohde.com",
        "bugtrack_url": null,
        "classifiers": [],
        "description": "Sidewalk: Simple Activity Aggregator\n====================================\n\nSidewalk allows you to easily trigger the execution of sets of Python methods from the command-line.\n\nSimply register your activity processors (i.e. functions/methods) with key associations and execute them by key or group using the included command-line utility ``sidewalk``.\n\nThis comes in handy when you want to setup cron jobs to execute Python code. You can easily create multiple cron job entries that run at various times and call different sets of activity processors.\n\n\nDocumentation and Getting Started\n---------------------------------\n\nFormal documentation is available on `Read the Docs <http://sidewalk.readthedocs.org/en/latest/>`_ and is also located in the ``docs/`` directory of the source code.\n\nHere is a quick run-down for how to get started:\n\n**Step 0) Create an activity processor.**\n\n- This can be any function defined in any module.\n- It is common to create an ``activitiy_processors/`` directory in your project's main directory to hold all of the activity processors specific to that project. This directory is also typically used to the project's Sidewalk configuration file (see Step 1 below).\n- Note Sidewalk comes with an example activitiy processor ``hello`` in the module ``sidewalk.test.example``.\n\n**Step 1) Create a configuration file:**\n\nBefore we can register our activity processors, we need to create and initialize a configurationfile. This file will contain a list of registered activity processors. It is up to you where to put the configuration file. You can create a single configuration file for an entire system, or create one for each of your projects. For right now, lets just create one in the current working directory:\n\n::\n\n        $ sidewalk ./sidewalk.conf init\n\n**Step 2) Register your activity processor:**\n\n::\n\n\t$ sidewalk ./sidewalk.conf add example.hello sidewalk.test.example.hello\n\n- The ``sidewalk`` command-line utility is your way to easily add, list/view, and remove activity processors.\n- Note that when adding your activity processors, you are creating a key association to the activity processor. Also note the syntax: ``example.hello``, in this case, ``example`` is the group and ``hello`` is the name. Groups are useful for executing multiple activity processors in one go. See step 3 below for more information.\n\n**Step 3) Execute your activity processor:**\n\n::\n\n\t$ sidewalk ./sidewalk.conf pave example.hello\n\n- Here we are executing our activity processor ``example.hello``.\n- You can select activity processors by group, e.g.: ``$ sidewalk ./sidewalk.conf pave example.``.\n- You can execute any number of activity processors in one call, e.g.: ``$ sidewalk ./sidewalk.conf pave example.`` to execute all activity processors of group ``example`` or ``$ sidewalk ./sidewalk.conf pave \nexample.hello second_group.`` to execute ``example.hello`` and all activity processors of group ``second_group``.\n\n\nInstallation\n------------\n\nInstall Sidewalk via `pip <http://pypi.python.org/pypi/pip/>`_:\n\n::\n\n\t$ pip install sidewalk\n\nIf needed, other methods of installing Sidewalk are noted in the `documentation <http://readthedocs.org/projects/sidewalk/>`_.\n\n\nLinks\n-----\n\n- `Sidewalk on PyPI <http://pypi.python.org/pypi/sidewalk>`_\n- `Sidewalk on GitHub <https://github.com/blakerohde/sidewalk>`_\n- `Issue Tracker <https://github.com/blakerohde/sidewalk/issues>`_\n\nAuthors\n-------\n\n`Blake Rohde <http://www.blakerohde.com/>`_\n\n\nHistory\n-------\n\n0.3.0 (2013-01-19)\n++++++++++++++++++\n\n- New and improved command-line interface. Legacy CLI is not supported. Sorry. See the documentation or execute ``sidewalk --help`` for more information. The CLI should not change in the future. \n- Greatly improved error handling and logging; added ``traceback`` output for unhandled exceptions, i.e. exceptions caused by activity processors or bad refences to activity processors.\n- Moved locations of ``bin/`` and the core libs into ``sidewalk/bin`` and ``sidewalk/core``, respectively.\n- Updated documentation and README.\n\n0.2.0 (2012-06-30)\n++++++++++++++++++\n\n- New Makefile for easier development testing\n- Sidewalk is production-ready; bumped version to 0.2.0\n- Documentation is now available under ``docs/``\n- Specifying a 'custom' settings file is now required; see the documentation for more information on this\n\n0.1.1 (2012-03-08)\n++++++++++++++++++\n\n- Moved log functions into new module ``sidewalk.loggers``\n- Added exception for when custom settings file's don't have the required section(s)\n- ``sidewalk-conf.py --list`` now returns a sorted list\n\n0.1.0 (2012-03-08)\n++++++++++++++++++\n\n- Updated README to better represent what it is that Sidewalk actually does\n- Added basic log functions and made error messages prettier\n- Created ``sidewalk.exceptions`` module and associated exceptions\n- Unhandled exceptions thrown by rogue activity processors are now caught\n- ``sidewalk-conf.py`` no longer rewrites configuration file if only ``--list`` is requested\n- Can now specify filename in ``sidewalk-conf.py`` and ``sidewalk-pave.py`` to use custom Sidewalk settings file/location\n\n0.0.1 (2012-03-04)\n++++++++++++++++++\n\n- Initial release\n- Wanted initial commit message to read \"Pikachu I commit you!\" but I flubbed it up and put \"Pikachu I choose you!\" Oh well.",
        "description_content_type": null,
        "docs_url": null,
        "download_url": "https://github.com/blakerohde/sidewalk/tarball/master",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "http://www.blakerohde.com/projects/sidewalk",
        "keywords": null,
        "license": "Copyright (c) 2013 Blake Rohde.\n\nPermission to use, copy, modify, and/or distribute this software for any\npurpose with or without fee is hereby granted, provided that the above\ncopyright notice and this permission notice appear in all copies.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\" AND THE AUTHOR DISCLAIMS ALL WARRANTIES\nWITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF\nMERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR\nANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES\nWHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN\nACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF\nOR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.",
        "maintainer": null,
        "maintainer_email": null,
        "name": "sidewalk",
        "package_url": "https://pypi.org/project/sidewalk/",
        "platform": "UNKNOWN",
        "project_url": "https://pypi.org/project/sidewalk/",
        "project_urls": {
            "Download": "https://github.com/blakerohde/sidewalk/tarball/master",
            "Homepage": "http://www.blakerohde.com/projects/sidewalk"
        },
        "release_url": "https://pypi.org/project/sidewalk/0.3.0/",
        "requires_dist": null,
        "requires_python": null,
        "summary": "The Simple Activity Aggregator.",
        "version": "0.3.0"
    },
    "last_serial": 799522,
    "releases": {
        "0.0.1": [],
        "0.1.0": [],
        "0.1.1": [],
        "0.2.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "be7b8f66cdc45fd7709349018970fc62",
                    "sha256": "663a4d67350756c72188011c5045a8a7b244d182f0fa327288610a7e13f66125"
                },
                "downloads": -1,
                "filename": "sidewalk-0.2.0.tar.gz",
                "has_sig": false,
                "md5_digest": "be7b8f66cdc45fd7709349018970fc62",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 6740,
                "upload_time": "2012-07-01T10:49:42",
                "url": "https://files.pythonhosted.org/packages/aa/11/749b672af9cb3be074b2e932d682eb117e38d1d8d5275ec2ca275b5eb1a3/sidewalk-0.2.0.tar.gz"
            }
        ],
        "0.3.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "d0da4e9e693cacd3e3fdb3ee97c19d7b",
                    "sha256": "ecc400037b15fcb9759f887ed241473e2c3c8fe3711b4e7cb62caa0ac63182f1"
                },
                "downloads": -1,
                "filename": "sidewalk-0.3.0.tar.gz",
                "has_sig": false,
                "md5_digest": "d0da4e9e693cacd3e3fdb3ee97c19d7b",
                "packagetype": "sdist",
                "python_version": "source",
                "requires_python": null,
                "size": 10450,
                "upload_time": "2013-01-20T04:12:20",
                "url": "https://files.pythonhosted.org/packages/ff/8a/c3d259400bb876b1789759fd72a21fa060ab66a702da42a9558101a1f3ae/sidewalk-0.3.0.tar.gz"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "d0da4e9e693cacd3e3fdb3ee97c19d7b",
                "sha256": "ecc400037b15fcb9759f887ed241473e2c3c8fe3711b4e7cb62caa0ac63182f1"
            },
            "downloads": -1,
            "filename": "sidewalk-0.3.0.tar.gz",
            "has_sig": false,
            "md5_digest": "d0da4e9e693cacd3e3fdb3ee97c19d7b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 10450,
            "upload_time": "2013-01-20T04:12:20",
            "url": "https://files.pythonhosted.org/packages/ff/8a/c3d259400bb876b1789759fd72a21fa060ab66a702da42a9558101a1f3ae/sidewalk-0.3.0.tar.gz"
        }
    ]
}