You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@beam.apache.org by "yoshiki obata (Jira)" <ji...@apache.org> on 2019/09/25 15:59:00 UTC
[jira] [Commented] (BEAM-7847) Generate Python SDK docs using
Python 3
[ https://issues.apache.org/jira/browse/BEAM-7847?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16937870#comment-16937870 ]
yoshiki obata commented on BEAM-7847:
-------------------------------------
[~tvalentyn]
I'll work on this if no one has already started.
> Generate Python SDK docs using Python 3
> ----------------------------------------
>
> Key: BEAM-7847
> URL: https://issues.apache.org/jira/browse/BEAM-7847
> Project: Beam
> Issue Type: Sub-task
> Components: sdk-py-core
> Reporter: Valentyn Tymofieiev
> Priority: Major
>
> Currently scripts/generate_pydoc.sh script fails on Python 3 with "RuntimeError: empty_like method already has a docstring" errors:
> {noformat}
> pip install -e .[gcp,test]
> pip install Sphinx==1.6.5
> pip install sphinx_rtd_theme==0.2.4
> ./scripts/generate_pydoc.sh
> /home/valentyn/projects/beam/beam/beam/sdks/python/target/docs/source/apache_beam.testing.benchmarks.nexmark.queries.query0.rst:4: WARNING: autodoc: failed to import module 'apache_beam.testing.benchmarks.nexmark.queries.query0'; the following exception was raised:
> Traceback (most recent call last):
> File "/home/valentyn/tmp/venv/py3/lib/python3.6/site-packages/sphinx/ext/autodoc.py", line 658, in import_object
> __import__(self.modname)
> File "/home/valentyn/projects/beam/beam/beam/sdks/python/apache_beam/__init__.py", line 98, in <module>
> from apache_beam import io
> File "/home/valentyn/projects/beam/beam/beam/sdks/python/apache_beam/io/__init__.py", line 22, in <module>
> from apache_beam.io.avroio import *
> File "/home/valentyn/projects/beam/beam/beam/sdks/python/apache_beam/io/avroio.py", line 61, in <module>
> from apache_beam.io import filebasedsink
> File "/home/valentyn/projects/beam/beam/beam/sdks/python/apache_beam/io/filebasedsink.py", line 34, in <module>
> from apache_beam.io import iobase
> File "/home/valentyn/projects/beam/beam/beam/sdks/python/apache_beam/io/iobase.py", line 50, in <module>
> from apache_beam.transforms import core
> File "/home/valentyn/projects/beam/beam/beam/sdks/python/apache_beam/transforms/__init__.py", line 29, in <module>
> from apache_beam.transforms.util import *
> File "/home/valentyn/projects/beam/beam/beam/sdks/python/apache_beam/transforms/util.py", line 228, in <module>
> class _BatchSizeEstimator(object):
> File "/home/valentyn/projects/beam/beam/beam/sdks/python/apache_beam/transforms/util.py", line 359, in _BatchSizeEstimator
> import numpy as np
> File "/home/valentyn/tmp/venv/py3/lib/python3.6/site-packages/numpy/__init__.py", line 142, in <module>
> from . import core
> File "/home/valentyn/tmp/venv/py3/lib/python3.6/site-packages/numpy/core/__init__.py", line 17, in <module>
> from . import multiarray
> File "/home/valentyn/tmp/venv/py3/lib/python3.6/site-packages/numpy/core/multiarray.py", line 78, in <module>
> def empty_like(prototype, dtype=None, order=None, subok=None, shape=None):
> File "/home/valentyn/tmp/venv/py3/lib/python3.6/site-packages/numpy/core/overrides.py", line 203, in decorator
> docs_from_dispatcher=docs_from_dispatcher)(implementation)
> File "/home/valentyn/tmp/venv/py3/lib/python3.6/site-packages/numpy/core/overrides.py", line 159, in decorator
> add_docstring(implementation, dispatcher.__doc__)
> RuntimeError: empty_like method already has a docstring
> {noformat}
--
This message was sent by Atlassian Jira
(v8.3.4#803005)