Metadata-Version: 2.0
Name: django-runcommands
Version: 0.1
Summary: runcommands: execute system commands from views
Home-page: https://github.com/magopian/django-runcommands
Author: Mathieu Agopian
Author-email: mathieu.agopian@gmail.com
License: BSD Licence
Keywords: s,y,s,t,e,m, ,c,o,m,m,a,n,d,s
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3

###################
django-runcommands
###################

.. image:: https://secure.travis-ci.org/magopian/django-runcommands.png?branch=master
   :alt: Build Status
   :target: https://travis-ci.org/magopian/django-runcommands

runcommands: execute system commands from urls.

* Authors: Mathieu Agopian and `contributors
  <https://github.com/magopian/django-runcommands/contributors>`_
* Licence: BSD
* Compatibility: Django 1.4+, python2.7 and python3.3
* Project URL: https://github.com/magopian/django-runcommands
* Documentation: http://django-runcommands.rtfd.org/


Quickstart
==========

Install the application:

.. code-block:: sh

    pip install django-runcommands

And then add an entry for the runcommand's view in your URLCONF, for each
command you wish to make accessible:

.. code-block:: python

    # urls.py
    from runcommands.views import RunCommandView


    urlpatterns = patterns(
        '',
        url(r'^hello-world/$',
            RunCommandView.as_view(command='echo Hello World')),
    )

Your command output is now available at the url ``/hello-world/``.


Hacking
=======

Setup your environment:

::

    git clone https://github.com/magopian/django-runcommands.git
    cd django-runcommands

Hack and run the tests using `Tox <https://pypi.python.org/pypi/tox>`_ to test
on all the supported python and Django versions:

::

    make test


Changelog
=========

0.1 (2013-06-18)
----------------

  - first version


