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:buster``, ``debian:bookworm`` 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. Pip ``extra``
requirements can be used in this mode.
.. code-block:: console
$ grocker build ./path/to/ipython-7.1.1-py3-none-any.whl[doc] --entrypoint ipython
$ docker run --rm -ti ipython-doc:7.1.1-<grocker-version>
Raw data
{
"_id": null,
"home_page": "http://github.com/polyconseil/grocker",
"name": "grocker",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "docker,build,packaging",
"author": "Polyconseil",
"author_email": "opensource+grocker@polyconseil.fr",
"download_url": "https://files.pythonhosted.org/packages/c1/20/5f1a4fe73ae124b2791fceae3991d6ad6eb669d12a88fbf9cbf65b95dfd7/grocker-8.2.tar.gz",
"platform": null,
"description": "Grocker - a Docker image builder for Python applications\n========================================================\n\n*Grocker* allows you to bundle your Python applications as Docker image\nwhile keeping the image size as minimal as possible.\n\n*Grocker* uses ``debian:buster``, ``debian:bookworm`` or ``alpine:latest`` as its\nbase image.\n\n*Grocker* is hosted on Github at https://github.com/polyconseil/Grocker.\n*Grocker* full documentation is available on https://grocker.readthedocs.io/.\n\nInstallation\n============\n\n1. Install Docker Engine. See `its official documentation <https://docs.docker.com/engine/>`_.\n2. Install Grocker with *pip*: ``pip install grocker``.\n\nBasic usage\n===========\n\n.. code-block:: console\n\n $ grocker build ipython==5.0.0 --entrypoint ipython\n $ docker run --rm -ti ipython:5.0.0-<grocker-version>\n\nDirect wheel path\n=================\n\nA wheel can also be directly passed to grocker to avoid the need to upload an artefact to\nbuild an image.\n\nGrocker will switch to this mode if a ``/`` is present in the argument. Pip ``extra``\nrequirements can be used in this mode.\n\n.. code-block:: console\n\n $ grocker build ./path/to/ipython-7.1.1-py3-none-any.whl[doc] --entrypoint ipython\n $ docker run --rm -ti ipython-doc:7.1.1-<grocker-version>\n",
"bugtrack_url": null,
"license": "BSD 3-Clause License",
"summary": "Docker image builder",
"version": "8.2",
"project_urls": {
"Homepage": "http://github.com/polyconseil/grocker"
},
"split_keywords": [
"docker",
"build",
"packaging"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3bc9daa229a7be9ef7f45505bfbbb89c4621de5fab38d4b15d877641eb715ea0",
"md5": "28df44eaaabff953833e6ed5ddfc6fb8",
"sha256": "e992929131ef604951fd5b343cead62851be7df3ec4e6b2e40ba48bee9f70388"
},
"downloads": -1,
"filename": "grocker-8.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "28df44eaaabff953833e6ed5ddfc6fb8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 23663,
"upload_time": "2024-02-27T14:29:30",
"upload_time_iso_8601": "2024-02-27T14:29:30.507552Z",
"url": "https://files.pythonhosted.org/packages/3b/c9/daa229a7be9ef7f45505bfbbb89c4621de5fab38d4b15d877641eb715ea0/grocker-8.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c1205f1a4fe73ae124b2791fceae3991d6ad6eb669d12a88fbf9cbf65b95dfd7",
"md5": "ac8f24afb41ee0c039002bb74a4ca298",
"sha256": "f5126e423a11dbb2c6796620c3dbae931eab5d48dbac6adf837bc9f037e4eb15"
},
"downloads": -1,
"filename": "grocker-8.2.tar.gz",
"has_sig": false,
"md5_digest": "ac8f24afb41ee0c039002bb74a4ca298",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 17894,
"upload_time": "2024-02-27T14:29:32",
"upload_time_iso_8601": "2024-02-27T14:29:32.507508Z",
"url": "https://files.pythonhosted.org/packages/c1/20/5f1a4fe73ae124b2791fceae3991d6ad6eb669d12a88fbf9cbf65b95dfd7/grocker-8.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-02-27 14:29:32",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "polyconseil",
"github_project": "grocker",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "grocker"
}
JSON
