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