Skip to main content

Commandline interface for using docker reproducibly

Project description

dockre
======

.. image:: http://hera.physchem.kth.se:9090/api/badges/bjodah/dockre/status.svg
:target: http://hera.physchem.kth.se:9090/bjodah/dockre
:alt: Build status
.. image:: https://img.shields.io/pypi/v/dockre.svg
:target: https://pypi.python.org/pypi/dockre
:alt: PyPI version
.. image:: https://img.shields.io/pypi/l/dockre.svg
:target: https://github.com/bjodah/dockre/blob/master/LICENSE
:alt: License


`dockre <https://github.com/bjodah/dockre>`_ provides a
command line interface (through a `Python <http://www.python.org>`_ packge) for using **dock**er **re**producibly to build
e.g. documents, binaries or host services. The default docker image used is the authors
personal one for work related tasks but it is changeable by specifying ``--image``.


Documentation
-------------
Autogenerated API documentation is found `here <http://hera.physchem.kth.se/~dockre/branches/master/html>`_.

Installation
------------
Simplest way to install ``dockre`` is to use ``pip``:

::

$ pip install --user dockre


Examples
--------
Here is a simple example:

.. code:: bash

$ mkdir input
$ echo -e "report.txt:\n\techo 'silly example'>\$@" > input/Makefile
$ mkdir output
$ dockre build
$ cat output/report.txt
silly example


License
-------
The source code is Open Source and is released under the simplified 2-clause BSD license. See `LICENSE <LICENSE>`_ for further details.

Contributors are welcome to suggest improvements at https://github.com/bjodah/dockre

Author
------
Björn I. Dahlgren, contact:

- gmail address: bjodah
- kth.se address: bda

Project details


Supported by

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