hplgit / doconce

Lightweight markup language - document once, include anywhere
http://hplgit.github.io/doconce/doc/web/index.html
Other
309 stars 60 forks source link

Using sudo pip install is regarded as bad practice and fails on Python virtual environments #192

Closed aless80 closed 3 years ago

aless80 commented 4 years ago

DocOnce encourages using sudo pip install. Although sudo pip install is still used in many guides, it is regarded as bad practice due to security risks and possible issues for your system (see e.g. What are the risks of running 'sudo pip'? ). he most recommended installation methods for Python packages is using virtual environments. Using pip install <package> of pip install <package> --user is also recommended (see Installing Python Modules).

Notice that sudo pip install fails on Python virtual environments. An example is in the doc/src/manual/install_doconce.sh file, which was throwing an error on my virtual environment.

All files using sudo pip install can easily found by using this regular expression on the DocOnce installation directory: grep -r 'sudo pip install' .

aless80 commented 3 years ago

I addressed this problem in the doconce/doconce repository, in particular in this commit