skip to navigation
skip to content


Module for easy python modules creation

Latest Version:

Picnic is a simple template engine for writing python modules. You open a console and in any folder you type ModuleName

and it will produce the following folder, with (almost ?) all the files you need. All there is left to do is write the actual code :

        / # A file for the actual code
    / # for Setuptools

The created package is configured to work with Setuptools because Setuptools rocks.


Two useful options are -git and -dev (the order doesn’t matter): ModuleName -git -dev

The -git option will initialize a git repository with the newly created module (requires git installed):

# it will run these lines in the ModuleName folder
git init
git add .
git commit -m "Initial commit"
# it will also create a python-specific .gitignore file

The -dev option will run the following command at the end to install the newly created module in develop mode (i.e. you can do your changes on the module without needing to reinstall the module each time to test it)

sudo python develop

Installation and customization

From the source

Get a zip of the code, for instance on Github . Unzip the code in some folder. You can check the models of the files README.rst, etc in subfolder picnic/files and change them as you like. Then use the following command in the folder where the is

sudo python install

Or even better, use this command instead, it will enable you to change the models of the files even after the installation:

sudo python develop

With pip (not recommanded)

Type this in a terminal

sudo pip install picnic

The problem with this installation is that you cannot customize the templates.


To test if it works go to any folder and type TestModule


Picnic is an open source software originally written by Zulko and released under the MIT licence. Please help make picnic better, for instance by expanding the capabilities, providing advice for sounder standards if you are an experienced module-maker, reporting bugs, etc. We love forks and pull resquests ! Picnic is being developped on Github, that’s where you should go for troubleshooting and bug reports.

File Type Py Version Uploaded on Size
picnic- (md5) Source 2014-01-11 6KB
  • Author: Zulko 2013
  • Keywords: python module template engine setuptools
  • License: LICENSE.txt
  • Package Index Owner: Zulko
  • DOAP record: picnic-