Use easy_install to install Sphinx?

[dideler]

For some reason I was getting the following error on my machine.

sphinx-build -b html -d build/doctrees   source build/html
Traceback (most recent call last):
  File "/usr/local/bin/sphinx-build", line 5, in <module>
    from pkg_resources import load_entry_point
  File "/usr/lib/python2.7/dist-packages/pkg_resources.py", line 2809, in <module>
    parse_requirements(__requires__), Environment()
  File "/usr/lib/python2.7/dist-packages/pkg_resources.py", line 594, in resolve
    raise DistributionNotFound(req)
pkg_resources.DistributionNotFound: Sphinx==1.1.3

Following Sphinx's instructions to install Sphinx using easy_install fixed the problem.

[dideler]

@Freeseer/students can anyone reproduce this? You just need to run the sphinx-build (no arguments necessary). I'm not sure what I did for it to suddenly stop working on my machine.

[bohnje]

Sorry what exactly are you looking to confirm? That sphinx-build doesn't work and then following the easy-install instructions causes it to work after?

[dideler]

@bohnje sorry, should have been more clear.

Go into the docs/ directory then run pip install -Ur requirements.txt (you might have to use sudo if you're not using virtualenv). Then try to run sphinx-build. You can also try running make html from the docs/ directory, since that calls sphinx-build but with arguments.

I'm more curious about why sphinx-build doesn't work and how to avoid the problem than how to fix it. Maybe we should be using easy_install instead of pip to install Sphinx.

[bohnje]

Here is the output I get. It doesn't look like I am getting the error you mentioned above.

Note: I had ran the easy install instructions for installing Sphinx before this but I believe I uninstalled it fully using "pip uninstall sphinx" and then followed your new instructions using the requirements.txt.

Running just "sphinx-build":
http://pastebin.com/WP8SYjMY

Running "make html":
http://pastebin.com/rtjHhgtr

[dideler]

@bohnje thanks.

I'll leave this issue open until the cause is known.

[ulemarakki]

Hello, I had

$ sphinx-build
Traceback (most recent call last):
  File "/usr/local/bin/sphinx-build", line 5, in <module>
    from pkg_resources import load_entry_point
  File "build/bdist.macosx-10.6-intel/egg/pkg_resources.py", line 2797, in <module>

  File "build/bdist.macosx-10.6-intel/egg/pkg_resources.py", line 576, in resolve
    plugin_env, full_env=None, installer=None, fallback=True
pkg_resources.DistributionNotFound: Sphinx==1.1.3

I installed the not founded Sphinx==1.1.3

$ easy_install Sphinx==1.1.3

It solved my problem.
Is it possible that Sphinx==1.1.3 was missed from requirements.txt?

[dideler]

@ulemarakki the requirements file being used allows for any Sphinx version below 2. https://github.com/Freeseer/freeseer/blob/master/docs/requirements.txt

Installing Sphinx via easy_install fixed the problem for me as well. See the issue's description

Following Sphinx's instructions to install Sphinx using easy_install fixed the problem.

But I was interested in what was causing the problem in the first place, since it used to work fine for me until I suddenly got that error one day.

I'm closing this issue for now. If anyone runs into this issue in the future we can reopen.

[dideler]

Ran into this issue again. It seems to be fairly common (also happened here #575 (comment)) so I think we should use easy_install for installing Sphinx, which fixes the problem but does add another setup step.

[Centaur]

Same error here. Installing sphinx by Mac OS X build-in python&pip. And after easy_install Sphinx==1.1.3 the error goes away.