skeleton 0.1

mkmodule.py

mkmodule.py is the script that create new module:

#!/usr/bin/env python

from skeleton import Skeleton, Var


class SimpleModule(Skeleton):
    src = 'module-skel'
    vars = [
        Var('ModuleName'),
        Var('Author', default=''),
        Var('AuthorEmail', default=''),
        ]


def main():
    SimpleModule().run()

if __name__ == '__main__':
    main()

The src attribute sets the relative path to the skeleton directory where the script will find the files and directories to create.

The vars attribute list the variables the templates will require. The variables with a default can be left blank by the user.

Skeleton.run() is a convenient method to set an optparser and the logging basic config, and to apply the skeleton:

Usage: mkmodule.py [options] dst_dir

Options:
  -h, --help            show this help message and exit
  --ModuleName=MODULENAME
                        ModuleName
  --Author=AUTHOR       Author
  --AuthorEmail=AUTHOREMAIL
                        AuthorEmail

If you needed to run a Skeleton yourself, you would use the constructor, the update or __setitem__ methods to set the variables (Skeleton is a dict subclass), and the write(dstdir) method to apply the skeleton.

module-skel/README

README a is static file that will simply be copied:

TODO: write the description of this module.

module-skel/setup.py_tmpl

setup.py_tmpl is a template (it ends with the _tmpl suffix) that will be used to create a setup.py file:

#!/usr/bin/env python

from distutils.core import setup


PROJECT = {ModuleName!r}
VERSION = '0.1'
AUTHOR = {Author!r}
AUTHOR_EMAIL = {AuthorEmail!r}
DESC = "A short description..."

setup(
    name=PROJECT,
    version=VERSION,
    description=DESC,
    long_description=open('README.rst').read(),
    author=AUTHOR,
    author_email=AUTHOR_EMAIL,
    py_module={ModuleName!r}
)

By default, Skeleton uses python 2.6+ string formatting.

module-skel/{ModuleName}.py

{ModuleName}.py is the module file for which the name will be set dynamically at run time.