Skip to content

Commit e85af68

Browse files
authored
docs: recommend install with virtualenv (#768)
1 parent f0b025b commit e85af68

File tree

1 file changed

+20
-6
lines changed

1 file changed

+20
-6
lines changed

README.md

Lines changed: 20 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -16,16 +16,30 @@ For Google Cloud Platform APIs such as Datastore, Cloud Storage or Pub/Sub, we r
1616

1717
## Installation
1818

19-
To install, simply use `pip` or `easy_install`:
19+
Install this library in a [virtualenv](https://virtualenv.pypa.io/en/latest/) using pip. virtualenv is a tool to
20+
create isolated Python environments. The basic problem it addresses is one of
21+
dependencies and versions, and indirectly permissions.
22+
23+
With virtualenv, it's possible to install this library without needing system
24+
install permissions, and without clashing with the installed system
25+
dependencies.
26+
27+
### Mac/Linux
2028

21-
```bash
22-
pip install --upgrade google-api-python-client
29+
```
30+
pip install virtualenv
31+
virtualenv <your-env>
32+
source <your-env>/bin/activate
33+
<your-env>/bin/pip install google-api-python-client
2334
```
2435

25-
or
36+
### Windows
2637

27-
```bash
28-
easy_install --upgrade google-api-python-client
38+
```
39+
pip install virtualenv
40+
virtualenv <your-env>
41+
<your-env>\Scripts\activate
42+
<your-env>\Scripts\pip.exe install google-api-python-client
2943
```
3044

3145
## Supported Python Versions

0 commit comments

Comments
 (0)