Skip to main content

The Simple Activity Aggregator.

Project description

Sidewalk allows you to run your Python code from the command-line.

This comes in handy when you want to setup cron jobs to execute Python code.

Simply register your activity processor (any defined method in any module) and you can execute it using the included command-line utilities: ‘’ and ‘’, respectively.

Documentation and Demos

Formal documentation coming soon. Sorry about that. But don’t leave now! Here is a quick run-down of 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) Register your activity processor:

$ --add 'example.hello sidewalk_activity_processors.example.hello'
  • The 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 2 below for more information.

Step 2) Execute your activity processor:

$ --activity-processor 'example.hello'
  • Here we are executing our activity processor ‘example.hello’.

  • You can execute any number of activity processors in one call.

  • You can also select activity processors by group.


To install sidewalk, download the source by clicking the ‘Downloads’ link above, and running the following in the un-zipped/un-tarred directory:

$ python install


Blake Rohde

Project details

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page