From 805818cf0f4ef0a761f49d5701dbd87b7d61ab59 Mon Sep 17 00:00:00 2001 From: Kenneth Reitz Date: Wed, 17 Jan 2018 08:53:05 -0500 Subject: [PATCH] enhance --- source/getting-started.rst | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/source/getting-started.rst b/source/getting-started.rst index ea5d783..02bc2fd 100644 --- a/source/getting-started.rst +++ b/source/getting-started.rst @@ -46,14 +46,26 @@ Here are some great installation guides for various system types: - `Installing Python 3 Properly on Linux `_ - `Installing Python 3 Properly on Windows `_ +Understanding Dependencies +-------------------------- + +Applications, scripts, and utlities built with Python typicaly have *dependencies* attached to them, which are Python modules they require to run/operate with, that need to be installed before you can use the sotware. + +A package manager, like *pipenv* (which we'll cover shortly), or the lower–level *pip* (in conjunction with *virtalenv* can be used to install and manage these dependencies, which are typically hosted on either on `PyPi (The Python Package Index) `_ or `GitHub `. + +You'll typically see these required packages (and any specific versions) declared in one of the following files: ``Pipfile``, ``requirements.txt``, or ``setup.py``. + Installing Pipenv ----------------- The next step is to install *Pipenv*, our packaging tool of choice. Package mangers allow us to easily manage (resolve, install, uninstall) dependencies and virtual environments for projects. - Python.org has a `great guide `_ available for installing Pipenv that also covers its basic usage. +If you're on a Mac, and have `homebrew `_ installed, the following command will suffice:: + + $ brew install pipenv + Here's a great `blog post `_ covering the basic concepts presented by Pipenv, and why it's an excellent choice for your first project. Using Pipenv