Welcome to mr.bobby’s documentation!

Original Authors:  Tom Lazar <tom@tomster.org>, Domen Kožar <domen@dev.si> Orginal ource code:  github.com project Original Bug tracker:  github.com issues

After fork

Author:Cyprien Le Pannérer <cyplp@free.fr>, Jean-Philippe Camguilhem <jp.camguilhem@gmail.com> Source code:github.com project Bug tracker:github.com issues License:BSD Generated:February 05, 2014 Version:0.1.dev0

mr.bobby is as a fork of the excellent mr.bob from Tom Lazar and Domen Kožar

Why a fork?

..todo explain why here

Features

• asks questions which need to be answered to render structure
• questions can be grouped by using a namespace
• renders templates from a folder, Python egg, or zip file
• supports Python 2.6 - 3.3, pypy
• 100% test coverage
• uses Jinja2 as the default rendering engine (can be replaced)
• multiple ways to specify variables to render templates
• preserves permissions when rendering templates
• provides hooks before/after asking a question
• provides hooks before/after rendering structure
• can remember given answers for rendered structure

Flow of mr.bobby

Introduction

mr.bobby is a tool that takes a directory skeleton, copies over its directory structure to a target folder and can use the Jinja2 (or some other) templating engine to dynamically generate the files. Additionally, it can ask you questions needed to render the structure, or provide a config file to answer them.

mr.bobby is meant to deprecate previous tools such as paster (PasteScript) and templer.

• User guide
  • Installation
  • Usage
  • Sample template to try out
  • Listing all questions needed to have corresponding variable for a template
  • Remember answers to a config file
  • Using non-interactive mode
  • Configuration
    • Specifying answers
    • Specifying defaults
    • Remote configuration
    • Configuration inheritance
    • Nesting variables into namespaces called groups
    • mr.bobby section reference
  • Collection of community managed templates
  • Collection of community plugins
• Writing your own template
  • Starting
  • How it works
  • Writing Questions
    • questions section reference
  • Common needs for templating
    • Default value of the question is dynamic
    • Conditionally render a file
    • Based on the answer of the question do something
    • Ask a question based on answer of previous question
  • Hooks
    • Post render hook
    • Pre render hook
    • Pre question hook
    • Post question hook
    • Hooks shipped with mr.bobby
  • template section reference
• Writing your own plugin
  • render_filename plugin
    • structure
    • Register your plugin(s)
• Design goals
• Why another tool
• Developer guide
  • Setup developer environment
  • Running tests
  • Making a Release
• Source documentation
  • mrbobby – Main package
    • mrbobby.configurator – Machinery to figure out configuration
    • mrbobby.cli – Command line interface
    • mrbobby.bobbyexceptions – Exceptions
    • mrbobby.parsing – Parsing .ini files
    • mrbobby.rendering – Everything related to rendering templates and directory structure
    • mrbobby.hooks – Included hooks
    • mrbobby.plugins – Included plugins
• Changelog
• Before forka mr.bob
  • 0.1a10 (unreleased)
  • 0.1a9 (2013-04-26)
  • 0.1a8 (2013-03-11)
  • 0.1a7 (2013-01-23)
  • 0.1a6 (2013-01-02)
  • 0.1a5 (2012-12-12)
  • 0.1a4 (2012-12-11)
  • 0.1a3 (2012-11-30)
  • 0.1a2 (2012-11-29)
  • 0.1a1 (2012-10-19)

Glossary

dotted notation

Importable Python function specified with dots as importing a module separated with a column to denote a function. For example mrbobby.rendering:render_structure

mr.bobby

This section configures how mrbobby behaves

variables

This section answers to the questions that will be passed to templates for rendering

Indices and tables

• Index
• Module Index
• Search Page