Best Practices

Getting started with Belafonte is pretty easy, but as is the case with anything easy, it is also pretty easy to get yourself into a sticky situation. The goal of this document is to provide some guidelines to help you stay out of some of the common pitfalls that you may run across.

Quick Tips

• Arguments are never optional. That is the job of options.
• Whitespace is cheap. For your own sanity, include as much of it as you like.
• Avoid the urge to autoload and (especially) automount apps.

Longer Guides

Since these become pretty big on their own, they're broken up into several pages.

• Do One Thing - Suggestions for keeping apps (and subcommands) simple
• Keep Handle Tiny - Suggestions for specifically keeping your handle method clutter-free
• Thoughtful App Layouts - Suggestions for how you might go about structuring your source tree