From 247a422a64378c968f0972b1797b919ae03296bb Mon Sep 17 00:00:00 2001 From: Tom Christie Date: Mon, 3 Sep 2012 12:41:52 +0100 Subject: [PATCH] Add virtualenv to start of tutorial --- docs/tutorial/1-serialization.md | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/docs/tutorial/1-serialization.md b/docs/tutorial/1-serialization.md index 55a9f679f..6a97f779e 100644 --- a/docs/tutorial/1-serialization.md +++ b/docs/tutorial/1-serialization.md @@ -6,6 +6,18 @@ This tutorial will walk you through the building blocks that make up REST framew ## Getting started +Before we do anything else we'll create a new virtual environment, using [virtualenv]. This will make sure our package configuration is keep nicely isolated from any other projects we're working on. + + mkdir -p ~/.env + virtualenv --no-site-packages ~/.env/djangorestframework + source ~/.env/djangorestframework/env/bin/activate + +Now that we're inside a virtualenv environment, we can install our packages requirements. + + pip install django + pip install djangorestframework + +Now we're ready to get coding. To get started, let's create a new project to work with. django-admin.py startproject tutorial @@ -231,6 +243,7 @@ We're doing okay so far, we've got a serialization API that feels pretty similar Our API views don't do anything particularly special at the moment, beyond serve `json` responses, and there's some error handling edge cases we'd still like to clean up, but it's a functioning Web API. -We'll see how we can start to improve things in [part 2 of the tutorial][1]. +We'll see how we can start to improve things in [part 2 of the tutorial][tut-2]. -[1]: 2-requests-and-responses.md \ No newline at end of file +[virtualenv]: http://www.virtualenv.org/en/latest/index.html +[tut-2]: 2-requests-and-responses.md \ No newline at end of file