Metadata-Version: 2.0
Name: grocker
Version: 6.4
Summary: Docker image builder
Home-page: http://github.com/polyconseil/grocker
Author: Polyconseil
Author-email: opensource+grocker@polyconseil.fr
License: BSD 3-Clause License
Description-Content-Type: UNKNOWN
Keywords: docker,build,packaging
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: System :: Software Distribution
Requires-Dist: click
Requires-Dist: docker (>=3.0.0)
Requires-Dist: importlib-resources
Requires-Dist: Jinja2
Requires-Dist: setuptools (>=30.3)
Requires-Dist: pip (>=10)
Requires-Dist: pyyaml (>=3.11)
Requires-Dist: packaging
Requires-Dist: enum34; python_version == "2.7"

Grocker - a Docker image builder for Python applications
========================================================

*Grocker* allows you to bundle your Python applications as Docker image
while keeping the image size as minimal as possible.

*Grocker* uses ``debian:jessie``, ``debian:stretch`` or ``alpine:latest`` as its
base image.

*Grocker* is hosted on Github at https://github.com/polyconseil/Grocker.
*Grocker* full documentation is available on https://grocker.readthedocs.io/.

Installation
============

1. Install Docker Engine. See `its official documentation <https://docs.docker.com/engine/>`_.
2. Install Grocker with *pip*: ``pip install grocker``.

Basic usage
===========

.. code-block:: console

    $ grocker build ipython==5.0.0 --entrypoint ipython
    $ docker run --rm -ti ipython:5.0.0-<grocker-version>

Direct wheel path
=================

A wheel can also be directly passed to grocker to avoid the need to upload an artefact to
build an image.

Grocker will switch to this mode if a ``/`` is present in the argument.

.. code-block:: console

    $ grocker build ./path/to/ipython-7.1.1-py3-none-any.whl --entrypoint ipython
    $ docker run --rm -ti ipython:7.1.1-<grocker-version>


