Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Yet another jinja2 cli command for static text generation

Project Description

moban brings the high performance template engine (JINJA2) for web into static text generation. It is used in pyexcel project to keep documentation consistent across the documentations of individual libraries.


You can install it via pip:

$ pip install moban

or clone it and install it:

$ git clone
$ cd moban
$ python install

Quick start

Here is a simple example:

$ moban -c data.yml -t my.template
$ cat moban.output

Given data.yml as:

hello: world

and my.template as:


moban.output will contain:


the tutorial has more use cases.


usage: moban [-h] [-cd CONFIGURATION_DIR] [-c CONFIGURATION]
[-td [TEMPLATE_DIR [TEMPLATE_DIR …]]] [-t TEMPLATE] [–template_type TEMPLATE_TYPE] [-o OUTPUT] [-f]

Yet another jinja2 cli command for static text generation

optional arguments

  • -h, –help show this help message and exit
  • -cd CONFIGURATION_DIR –configuration_dir CONFIGURATION_DIR the directory for configuration file lookup
  • -c CONFIGURATION, –configuration CONFIGURATION the dictionary file
  • -td [TEMPLATE_DIR [TEMPLATE_DIR …]], –template_dir [TEMPLATE_DIR [TEMPLATE_DIR …]] the directories for template file lookup
  • -t TEMPLATE, –template TEMPLATE the template file
  • –template_type TEMPLATE_TYPE the template type, default is jinja2
  • -o OUTPUT, –output OUTPUT the output file
  • -f force moban to template all files despite of .moban.hashes


0.0.7 - 19-Jul-2017


  1. Bring the visibility of environment variable into jinja2 templating process: issue 7

0.0.6 - 16-Jun-2017


  1. added ‘-f’ flag to force moban to template all files despite of .moban.hashes


  1. moban will not template target file in the situation where the changes occured in target file than in the source: the template file + the data configuration after moban has been applied. This new release will remove the change during mobanization process.

0.0.5 - 17-Mar-2017


  1. Create a default hash store when processing a moban file. It will save unnecessary file write to the disc if the rendered content is not changed.
  2. Added summary reports

0.0.4 - 11-May-2016


  1. Bug fix issue 5, should detect duplicated targets in .moban.yml file.

0.0.3 - 09-May-2016


  1. Bug fix issue 4, keep trailing new lines

0.0.2 - 27-Apr-2016


  1. Bug fix issue 1, failed to save utf-8 characters

0.0.1 - 23-Mar-2016

Initial release

Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
moban-0.0.7-py2.py3-none-any.whl (11.1 kB) Copy SHA256 Checksum SHA256 2.7 Wheel Jul 19, 2017
moban-0.0.7.tar.gz (8.4 kB) Copy SHA256 Checksum SHA256 Source Jul 19, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting