Skip to main content
Help us improve Python packaging – donate today!

Craft - Like Makefile, but in Python.

Project Description

Craft is like Makefile, except everything is in native Python.


pip install craft

Craft works on Python 2.7+ and Python 3.2+.

Crafty files

Craft will read attempt to read in the current directory or the environment variable $CRAFTFILE.

An example

from craft import task, depends

@depends('bar', 'foo')
def cake():
  Prints cake, and depends on foo & bar
  to run first
  print('Time for cake')

def bar():
  """ Prints bar """

def foo():
  print("Hi,I'm foo")

def auto():
  I will run when you supply no arguments to "craft".
  print("Auto - Doing my own thing. Which is 'foo' today.")

def setup():
  I will run once on any call to "craft"
  print("Hello good sir, I'm the setup routine.")


Running craft -h in the directory containing will show the list of available tasks. Example:

usage: craft [-h] [task [task ...]]

positional arguments:

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

Available tasks:

- cake: Prints cake, and depends on foo & bar to run first
- auto: I will run when you supply no arguments to "craft".
- setup: I will run once on any call to "craft"
- foo:
- bar: Prints bar

As you can see, the docstring for each @task function will then be represented in the help output, and docstrings can be omitted.

You can call individual tasks like:

craft foo

and run multiple tasks with one call like:

craft foo bar


v0.2.6 - 10 Nov 2012

  • Fix an issue with linking to the README

v0.2.3 - 14 Oct 2012

  • Fix error catching isolation from craft and the actual task

v0.2.0 - 27 Aug 2012

  • Added setup() and auto() tasks
  • Added support for task dependencies via @depends

v0.1.0 - 26 Aug 2012

Source is available at:

Release history Release notifications

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
craft-0.2.6.tar.gz (3.0 kB) Copy SHA256 hash SHA256 Source None Nov 11, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page