Skip to main content

The Simple Activity Aggregator.

Project description

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:

$ sidewalk-conf.py ./sidewalk.conf --init

Step 2) Register your activity processor:

$ sidewalk-conf.py ./sidewalk.conf --add 'example.hello sidewalk_activity_processors.example.hello'
  • 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.

Step 3) Execute your activity processor:

$ sidewalk-pave.py ./sidewalk.conf --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.

Installation

Install Sidewalk via pip:

$ pip install sidewalk

If needed, other methods of installing Sidewalk are noted in the documentation.

Authors

Blake Rohde

History

0.2.0 (2012-06-30)

  • New Makefile for easier development testing
  • Sidewalk is production-ready; bumped version to 0.2.0
  • Documentation is now available under docs/
  • Specifying a ‘custom’ settings file is now required; see the documentation for more information on this

0.1.1 (2012-03-08)

  • Moved log functions into new module sidewalk.loggers
  • Added exception for when custom settings file’s don’t have the required section(s)
  • sidewalk-conf.py --list now returns a sorted list

0.1.0 (2012-03-08)

  • Updated README to better represent what it is that Sidewalk actually does
  • Added basic log functions and made error messages prettier
  • Created sidewalk.exceptions module and associated exceptions
  • Unhandled exceptions thrown by rogue activity processors are now caught
  • sidewalk-conf.py no longer rewrites configuration file if only --list is requested
  • Can now specify filename in sidewalk-conf.py and sidewalk-pave.py to use custom Sidewalk settings file/location

0.0.1 (2012-03-04)

  • Initial release
  • Wanted initial commit message to read “Pikachu I commit you!” but I flubbed it up and put “Pikachu I choose you!” Oh well.

Project details


Release history Release notifications

History Node

0.3.0

This version
History Node

0.2.0

History Node

0.1.1

History Node

0.1.0

History Node

0.0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
sidewalk-0.2.0.tar.gz (6.7 kB) Copy SHA256 hash SHA256 Source None Jul 1, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page