Unable to build local version of docs about conda-docs

[asmeurer]

Well, that's what happens when you try to write Python 2/3 compatible code without actually testing it in Python 2. Apparently rb'' is not valid Python 2 syntax. I have also fixed the README.

Note that there was another issue with my help2man package which I have only been able to fix for OS X (I will fix it for Linux next week when I get access to my work computer again).

[gvwilson]

Build still fails on my machine:

~/p/conda-docs/docs: make html
python scrape_help.py
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
Traceback (most recent call last):
  File "scrape_help.py", line 173, in <module>
    sys.exit(main())
  File "scrape_help.py", line 165, in main
    list(executor.map(gen_command, commands))
  File "/Users/gwilson/anaconda/lib/python2.7/site-packages/concurrent/futures/_base.py", line 580, in map
    yield future.result()
  File "/Users/gwilson/anaconda/lib/python2.7/site-packages/concurrent/futures/_base.py", line 407, in result
    return self.__get_result()
  File "/Users/gwilson/anaconda/lib/python2.7/site-packages/concurrent/futures/_base.py", line 359, in __get_result
    reraise(self._exception, self._traceback)
  File "/Users/gwilson/anaconda/lib/python2.7/site-packages/concurrent/futures/_compat.py", line 107, in reraise
    exec('raise exc_type, exc_value, traceback', {}, locals_)
  File "/Users/gwilson/anaconda/lib/python2.7/site-packages/concurrent/futures/thread.py", line 61, in run
    result = self.fn(*self.args, **self.kwargs)
  File "scrape_help.py", line 160, in gen_command
    generate_man(command)
  File "scrape_help.py", line 108, in generate_man
    'conda %s' % command,
  File "/Users/gwilson/anaconda/lib/python2.7/subprocess.py", line 566, in check_output
    process = Popen(stdout=PIPE, *popenargs, **kwargs)
  File "/Users/gwilson/anaconda/lib/python2.7/subprocess.py", line 710, in __init__
    errread, errwrite)
  File "/Users/gwilson/anaconda/lib/python2.7/subprocess.py", line 1327, in _execute_child
    raise child_exception
OSError: [Errno 2] No such file or directory
make: *** [command-html] Error 1

[asmeurer]

Not sure where the conda 3.7.1 comes from. Maybe I left in a print statement (or did you?). You need to conda update help2man in your environment.

[gvwilson]

~/p/conda-docs/docs: conda list help2man
# packages in environment at /Users/gwilson/anaconda:
#
help2man                  1.46.4               pl5.18.2_1

~/p/conda-docs/docs: conda update help2man
Fetching package metadata: ..
Error: No packages found in current osx-64 channels matching: help2man

Thanks
Greg

[asmeurer]

Sorry conda update -c asmeurer help2man.

[gvwilson]

~/p/conda-docs/docs: conda update -c asmeurer help2man
Fetching package metadata: ...
Solving package specifications: .
Package plan for installation in environment /Users/gwilson/anaconda:

The following packages will be downloaded:

     package                    |            build
     ---------------------------|-----------------
     help2man-1.46.4            |       pl5.18.2_2          16 KB

The following packages will be UPDATED:

     help2man: 1.46.4-pl5.18.2_1 --> 1.46.4-pl5.18.2_2

Proceed ([y]/n)? y

Fetching packages ...
help2man-1.46. 100% 
|###############################################################################################| 
Time: 0:00:00   1.60 MB/s
Extracting packages ...
[      COMPLETE      ] 
|#################################################################################################################| 
100%
Unlinking packages ...
[      COMPLETE      ] 
|#################################################################################################################| 
100%
Linking packages ...
[      COMPLETE      ] 
|#################################################################################################################| 
100%
~/p/conda-docs/docs: !make
make html
python scrape_help.py
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
conda 3.7.1
help2man: can't get `--version' info from conda clean
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda info
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda bundle
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda help
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda create
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda run
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda search
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda remove
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda install
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda list
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda init
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda update
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda config
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda package
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda index
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda skeleton
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda build
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda convert
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda develop
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda metapackage
Try `--no-discard-stderr' if option outputs to stderr
help2man: can't get `--version' info from conda pipbuild
Try `--no-discard-stderr' if option outputs to stderr
Traceback (most recent call last):
   File "scrape_help.py", line 173, in <module>
     sys.exit(main())
   File "scrape_help.py", line 165, in main
     list(executor.map(gen_command, commands))
   File 
"/Users/gwilson/anaconda/lib/python2.7/site-packages/concurrent/futures/_base.py", 
line 580, in map
     yield future.result()
   File 
"/Users/gwilson/anaconda/lib/python2.7/site-packages/concurrent/futures/_base.py", 
line 407, in result
     return self.__get_result()
   File 
"/Users/gwilson/anaconda/lib/python2.7/site-packages/concurrent/futures/_base.py", 
line 359, in __get_result
     reraise(self._exception, self._traceback)
   File 
"/Users/gwilson/anaconda/lib/python2.7/site-packages/concurrent/futures/_compat.py", 
line 107, in reraise
     exec('raise exc_type, exc_value, traceback', {}, locals_)
   File 
"/Users/gwilson/anaconda/lib/python2.7/site-packages/concurrent/futures/thread.py", 
line 61, in run
     result = self.fn(*self.args, **self.kwargs)
   File "scrape_help.py", line 160, in gen_command
     generate_man(command)
   File "scrape_help.py", line 108, in generate_man
     'conda %s' % command,
   File "/Users/gwilson/anaconda/lib/python2.7/subprocess.py", line 573, 
in check_output
     raise CalledProcessError(retcode, cmd, output=output)
subprocess.CalledProcessError: Command '['help2man', '--name', u'conda 
info', '--section', '1', '--source', 'Continuum Analytics', 
'--version-string', '', '--no-info', u'conda info']' returned non-zero 
exit status 2
make: *** [command-html] Error 1

[asmeurer]

Ahh, that's where the conda 3.7.1 is coming from. It is printing it to the terminal instead of capturing it with check_output. My only guess as to why this is happening is that it is being printed to stderr. See if the latest version works.

If not, I'll have to take a look tomorrow, because I am going to bed now.

[asmeurer]

The version doesn't even seen to be used anywhere anyway, so I could also probably just stub it out. I was kind of hoping it would be used, though.

[gvwilson]

Nope. Flying today (which is why I wanted a local copy), will check in
again tomorrow.
Sleep well,
Thanks,
Greg

~/p/conda-docs/docs: git pull upstream master
remote: Counting objects: 4, done.
remote: Compressing objects: 100% (4/4), done.
Unpacking objects: 100% (4/4), done.
remote: Total 4 (delta 0), reused 0 (delta 0)
 From github.com:conda/conda-docs
  * branch            master     -> FETCH_HEAD
Updating 8d732c4..d2091a5
Fast-forward
  docs/scrape_help.py | 4 ++--
  1 file changed, 2 insertions(+), 2 deletions(-)
~/p/conda-docs/docs: !make
make html
python scrape_help.py
Traceback (most recent call last):
   File "scrape_help.py", line 173, in <module>
     sys.exit(main())
   File "scrape_help.py", line 165, in main
     list(executor.map(gen_command, commands))
   File 
"/Users/gwilson/anaconda/lib/python2.7/site-packages/concurrent/futures/_base.py", 
line 580, in map
     yield future.result()
   File 
"/Users/gwilson/anaconda/lib/python2.7/site-packages/concurrent/futures/_base.py", 
line 407, in result
     return self.__get_result()
   File 
"/Users/gwilson/anaconda/lib/python2.7/site-packages/concurrent/futures/_base.py", 
line 359, in __get_result
     reraise(self._exception, self._traceback)
   File 
"/Users/gwilson/anaconda/lib/python2.7/site-packages/concurrent/futures/_compat.py", 
line 107, in reraise
     exec('raise exc_type, exc_value, traceback', {}, locals_)
   File 
"/Users/gwilson/anaconda/lib/python2.7/site-packages/concurrent/futures/thread.py", 
line 61, in run
     result = self.fn(*self.args, **self.kwargs)
   File "scrape_help.py", line 160, in gen_command
     generate_man(command)
   File "scrape_help.py", line 111, in generate_man
     replacements = man_replacements()
   File "scrape_help.py", line 89, in man_replacements
     (info['rc_path'].encode('utf-8'), b'\\fI\\,user .condarc path\\/\\fP'),
AttributeError: 'NoneType' object has no attribute 'encode'
make: *** [command-html] Error 1

[asmeurer]

The fix for that is going to end up being in conda. The workaround is touch ~/.condarc.

[asmeurer]

I'm glad you are building these. I did a lot of work in the past couple of weeks in making the building of these docs reproducible so that not just me could do it, and it's good to fix the issues that there apparently are with actually doing that. If you can't figure it out you can always wget --recursive http://conda.pydata.org/docs/.

[asmeurer]

Oh duh, don't use wget. Just git checkout gh-pages. The github pages are built automatically by Travis. But I would like to see if you can eventually build the docs regardless.

[gvwilson]

touch ~/.condarc worked - thanks.

[asmeurer]

The remainder of this is #26 then.

[github-actions]

Hi there, thank you for your contribution!

This issue has been automatically locked because it has not had recent activity after being closed.

Please open a new issue if needed.

Thanks!