This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Lightweight Python Build Tool.

Project Description

Calum J. Eadie (www.calumjeadie.com)

Features

  • Really quick to learn.
  • Manages dependancies between tasks.
  • Automatically generates a command line interface.

Installation

You can install microbuild from the Python Package Index (PyPI) or from source.

Using pip:

$ pip install microbuild

Using easy_install:

$ easy_install microbuild

Example

The build script is written in pure Python and microbuild takes care of managing any dependancies between tasks and generating a command line interface.

Tasks are just regular Python functions marked with the @task() decorator. Dependancies are specified with @task() too. Tasks can be ignored with the @ignore decorator.

After defining all tasks build(sys.modules[__name__],sys.argv[1:]) is called to run the build.

# example.py
import sys
from microbuild.microbuild import task,ignore,build

@task()
def clean():
    """Clean build directory."""
    print "Cleaning build directory..."

@task(clean)
def html():
    """Generate HTML."""
    print "Generating HTML..."

@ignore
@task(clean)
def images():
    """Prepare images."""
    print "Preparing images..."

@task(html,images)
def android():
    """Package Android app."""
    print "Packaging android app..."

if __name__ == "__main__":
    build(sys.modules[__name__],sys.argv[1:])

The command line interface and help is automatically generated. Task descriptions are extracted from function docstrings.

$ ./example.py -h
usage: example.py [-h] task

positional arguments:
  task        perform specified task and all it's dependancies

optional arguments:
  -h, --help  show this help message and exit

tasks:
  android     Package Android app.
  clean       Clean build directory.
  html        Generate HTML.
  images      Prepare images.

Dependancies between tasks are taken care of too.

$ ./example.py android
[ example.py - Starting task "clean" ]
Cleaning build directory...
[ example.py - Completed task "clean" ]
[ example.py - Starting task "html" ]
Generating HTML...
[ example.py - Completed task "html" ]
[ example.py - Ignoring task "images" ]
[ example.py - Starting task "android" ]
Packaging android app...
[ example.py - Completed task "android" ]

Contributing

microbuild is hosted at https://github.com/CalumJEadie/microbuild and contributions are very welcome.

epydoc is used for documentation generation and unittest for tests.

Run build.py apidoc to generate documentation and build.py test to run all unit tests.

License

microbuild is licensed under a MIT license. See LICENSE.txt.

Changes

0.3.3 - 26/03/2013

  • Improved README documentation.

0.3.1,0.3.2 - 15/12/2012

  • Improved README documentation.

0.3.0 - 18/09/2012

  • Fixed bug in logging. No longer modifies root logger.
  • Added ignore functionality.
  • Extended API documentation.

0.2.0 - 29/08/2012

  • Added progress tracking output.
  • Added handling of exceptions within tasks.

0.1.0 - 28/08/2012

  • Initial release.
  • Added management of dependancies between tasks.
  • Added automatic generation of command line interface.
Release History

Release History

This version
History Node

0.3.3

History Node

0.3.2

History Node

0.3.1

History Node

0.3.0

History Node

0.2.0

History Node

0.1.0

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
microbuild-0.3.3.tar.gz (5.6 kB) Copy SHA256 Checksum SHA256 Source Mar 26, 2013

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