Hi Paul, I'll try to get to it after work, but having a 2 year old makes that a bit difficult. :) I do have some suggestions to pass on:
1. The docs should *definitely* mention that if you see /usr/local/anything in the error messages, you're not using the virtual environment correctly.
2. In the docs, if you look at the section "Ubuntu 12.04 or above" you can see exactly why I was confused.
Inside a virtual env, you can install Scrapy with pip
after that:
I think for the bare bones beginner, like me, it would be better to say something like:
1. First install virtual env.
$ pip3 install virtualenv (maybe make a note of pip vs pip3 for newbies?)
2. Now create a project directory.
$ mkdir quoteProject
3. Within that project directory, create your virtual environment. It doesn't matter what you call the virtual environment. Maybe make note of the -p switch for virtualenv to distinguish between python2 and python3? And use a crazy name to demonstrate you can name the environment anything you want.
$ cd quoteProject
$ virtualenv -p /usr/bin/python3.4 myVE
4. Source the virtual environment. You'll know you did it correctly if your prompt looks like "blah". And install scrapy.
$ source myVE/bin/activate
(myVE) $ pip3 install scrapy
[ lots of stuff ]
3. Honestly, I didn't need much to understand how to use virtual environments. The most helpful site I encountered was this:
https://realpython.com/blog/python/python-virtual-environments-a-primer/It's very short. Scrapy docs did a good job explaining why a virtual environment is needed, so the only thing *I* needed were these two short sections on that site:
Using virtual environments
How does a virtual environment work?
And that's it. The other sections I read, and maybe they'll be useful in the future, but for the purposes of getting me up and running with scrapy, I just needed those two sections. I think half a page in the scrapy docs should do it (maybe what I wrote above would be all that's needed for Linux users).
Oh, dear. I told myself I wouldn't do this on company time. OK, well, it's done. If you think this will be useful, I'll try to contribute it. How do I do that?