Not Logged In

sidewalk 0.2.0

Sidewalk allows you to trigger the execution of Python methods from the command-line.

Simply register your activity processor (any defined method in any module) and you can execute it using the included command-line utilities sidewalk-conf.py and sidewalk-pave.py, respectively.

This 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 activity processors.

Documentation and Getting Started

Formal documentation is available on Read the Docs and is also located in the docs/ directory of the source code.

Here is a quick run-down for how to get started:

Step 0) Create an activity processor.

This can be any function defined in any module.

It is recommended that you create a local package to keep all of your activity processors in one location.

Sidewalk comes with a package sidewalk_activity_processors for you to use if you would like.

Note that in this sample package, sidewalk_activitiy_processors, there is an activity processor ‘hello’ in the module ‘example’.

Step 1) Create a settings file:

Before we can register our activity processors, we need to create and initialize a settings file. This file will contain a list of registered activity processors. It is up to you where to put the settings file. You can create a single settings 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:

The sidwalk-conf.py command-line utility is your way to easily add, list/view, and remove activity processors.

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.

Copyright (c) 2012 Blake Rohde.
Permission to use, copy, modify, and/or distribute this software for any
purpose with or without fee is hereby granted, provided that the above
copyright notice and this permission notice appear in all copies.
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.