Skip to main content

Python project bootstraps for mr.bob: usual Python distro, buildout, and mr.bob template

Project description

Python package templates for mr.bob. Please read carefully mr.bob user documentation before using this package.

Installation

easy_install bobtemplates.gillux

About the templates

bobtempaltes.gillux offers the following templates :

buildout

A simple minimal zc.buildout based project bootstrap

mybobtemplate

Make your own bobtemplate.yourname bootstrap in a some seconds (or more).

nspackage

A regular Python package bootstrap with or without namespace, any level with lots of goodies.

buildout

Usage:

mrbob [options] bobtemplates.gillux:buildout

This provides a minimal zc.buildout based project, with a bootstrap.py file and a buildout.cfg file. Takes care of differences between versions 1.x and 2.x of zc.buildout.

mybobtemplate

Usage:

mrbob [options] bobtemplates.gillux:mybobtemplate

Make your own bobtemplate.yourname package in a few minutes (or more). Means that you can have the skeleton of a package like bobtemplates.gillux in some seconds.

You just need to add the content of your template as described in the mr.bob user documentation

nspackage

Usage:

mrbob [options] bobtemplates.gillux:nspackage

A regular Python package bootstrap with following features:

  • Any namespaces level you want, even none at all. This is detected with the name you provide in the wizard.

  • Code targeted to Python 2.4 to 2.7 and 3.x

Two optional features:

  • Tests with nose and coverage. Run them with nosetests. Tune your options in generated setup.cfg.

  • A Sphinx documentation skeleton. Build the HTML doc with python setup.py build_sphinx. The doctest files may optionally be automatically included in the doc.

Package files outline (may change depending on options:

src/<your>/<package>/  # Your package source skeleton
docs/                  # Sphinx source tree skeleton
tests/                 # Test module skeleton with nose goodies
setup.py               # Usual setup script
setup.cfg
README.rst
MANIFEST.in

Then grep - and optionally fix - the FIXME: that occur in the resulting files tree for optional stuffs I couldn’t fix easily with the regular mr.bob features.

Read the generated README.rst in your newly created package for more information about what you got.

TODO

  • Provide a six support option

  • Tests inside the source tree (in src/<your>/<package>/tests) OR in the package root. Sometimes we prefer to ship source distros with the tests, and sometimes (i.e big amount of test data) we prefer to keep a source dist small.

Changes log

1.1.0

  • nspackage: Distro name and package (Python) name can be distinct. [glenfant]

  • nspackage: Use of nosetests + coverage is optional [glenfant]

  • nspackage: Sphinx doc skeleton is optional [glenfant]

1.0.0

  • Added the “mybobtemplate” template for new bobtemplates.xxx packages skeletons. [glenfant]

  • Added .xxignore files for git, bazaar and mercurial to the “buildout” template. [glenfant]

  • setuptools/distribute don’t let us distribute empty directories. So we need to put a marker file in some directories then remove them. [glenfant]

1.0.0b1

  • Python 3 support (alpha). Please feeback [glenfant]

  • Added the “buildout” template, a minimal zc.buildout project bootstrap [glenfant]

  • Added .xxignore files for git, bazaar and mercurial [glenfant]

  • Gone through the weirdness of include_package_data, package_data and MANIFEST.in This setuptools / distribute feature really sucks [glenfant]

1.0.0a2

1.0.0a1

  • First public version [glenfant]

Project details


Download files

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

Source Distribution

bobtemplates.gillux-1.1.0.tar.gz (20.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page