Skip to content
Fetching contributors…
Cannot retrieve contributors at this time
79 lines (56 sloc) 2.88 KB

Bash Delectable Scripting Modules (BDSM) Framework

The BDSM Framework is a... scripting management framework, with modules (go figure)!


The goal is to create a framework for maintaining and sharing server side scripts while exposing them through a consistent command line interface (CLI).


BDSM itself is a scripting framework. Users may write and/or install 'extensions' (think plugins) to the core framework in order to add CLI functionality to BDSM.

Creating Extensions

There are only a few requirements for the 'extensions'. The extension must be a directory. Within this directory are (at least) the subdirectory bin/ with at least one executable file called 'help'. Additionally in the root of the extension directory there must be a text file called VERSION with a version number that follows semantic versioning ( in the format of X.Y.Z where X,Y and Z are positive integers. An extension must also have a README file in which you should explain about the extension.

The contents of the bin directory can be any execuatble file. This means for example that C compiled binaries, Ruby Scripts, python, lua, etc... may all be used according to requrements and/or user preferences. Of course the extensions which I write will likely be in bash ;) Additionally if you write your extensions in bash a nice DSL is automatically loaded for you. Read more about the DSL in the online documentation.


Wayne E. Seguin


In the spirit of free software, everyone is encouraged to help improve this project.

Here are some ways you can contribute:

by using the latest development and release versions by reporting bugs in #beginrescueend on by suggesting new features in #beginrescueend on by writing or editing documentation by translating documentation to a new language by writing extensions by writing code (no patch is too small: fix typos, add comments, clean up inconsistent whitespace) by refactoring code by resolving issues by reviewing patches


All BDSM Core scripts and extensions themselves are are licensed under the Apache License v2.0

Copyright (c) 2009-2011 Wayne E. Seguin

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

bin/bdsm-ll is GNU Parallel and is licensed under the GNU GPL v3 which can be read here:

Something went wrong with that request. Please try again.