From 7d1b47e7724e71f500548fce059d104fca7dbd66 Mon Sep 17 00:00:00 2001 From: Kenneth Reitz Date: Thu, 2 Feb 2017 14:20:50 -0500 Subject: [PATCH] deterministic builds --- docs/advanced.rst | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/docs/advanced.rst b/docs/advanced.rst index 726f8cd8..c446c878 100644 --- a/docs/advanced.rst +++ b/docs/advanced.rst @@ -40,7 +40,7 @@ This will install both ``pipenv`` and ``pew`` (one of our dependencies) in an is ------------------------ The two primary commands you'll use in managing your pipenv environment are -``$ pipenv install`` and ``$ pipenv uninstall``. +``$ pipenv install``, ``$ pipenv uninstall``, and ``$ pipenv lock`. .. _pipenv_install @@ -79,6 +79,15 @@ as well as one additonal, ``--all``. - ``--all`` — This parameter will purge all files from the virtual environment, but leave the Pipfile untouched. + +.. _pipenv_lock + +$ pipenv lock +///////////// + +``$ pipenv lock`` is used to create a ``Pipfile.lock``, which declares **all** dependencies (and sub-depdendencies) of your project, their latest available versions, and the current hashes for the downloaded files. This ensures repeatable, and most importantly *deterministic*, builds. + + ☤ Configuration With Environment Variables ------------------------------------------