datajoint / datajoint-docs-original

https://docs.datajoint.org
Other
2 stars 13 forks source link

Using 'sudo pip' as suggested in the tutorial is a bad practice #217

Open guzman-raphael opened 5 years ago

guzman-raphael commented 5 years ago

Reposting on behalf of @aless80

Please consider to review your recommendation in the tutorial (and maybe in your docs) about the following point:

pip3 install datajoint ... Depending on how your Python environment is configured, you may have to prefix sudo to the above command. tutorial

Using 'sudo pip' is generally frowned upon as it can seriously mess up python. The best option is using a virtual environment, followed by pip --user. On the internet you can find some debate on the 'sudo pip' practice, but it is certainly not the best practice.

I actually tried pip3 datajoint --user. Datajoint did not work, as some dependency (the enum function) was not working. In contrast, datajoint was working after installing it in a virtual environment.

Also suggest users to use to install dependencies with pip install -r requirements. Consider to add matplotlib to requirements.txt, which is needed by e.g. ERD.draw()