[Debian-astro-maintainers] Bug#881163: astroquery: FTBFS with astropy-helpers 2.0.2: The section Examples appears twice in the docstring

[Dmitry Shachnev]

Source: astroquery
Version: 0.3.6+dfsg-2
Severity: serious
Justification: fails to build from source
Tags: fixed-upstream

Dear maintainer,

astroquery currently fails to build with this error:

  Exception occurred:
    File "/usr/lib/python3/dist-packages/astropy_helpers/extern/numpydoc/docscrape.py", line 343, in _parse
      raise ValueError(msg)
  ValueError: The section Examples appears twice in the docstring of None in None.

The error message is quite confusing, but the duplicate section is in the
docstring of SkyViewClass.get_image_list() in astroquery/skyview/core.py,
one Examples section is in the original docstring, another one is added by
the @prepend_docstr_noreturns(get_images.__doc__) decorator.

This was caused by python-astropy-helpers 2.0.2, where some checks were
made stricter.

Full build log is available here:
https://tests.reproducible-builds.org/debian/rbuild/unstable/amd64/astroquery_0.3.6+dfsg-2.rbuild.log

Quick fix for this is applying this commit:
https://github.com/astropy/astroquery/commit/f8380f42698973ec

A more proper, but longer, fix is backporting these changes:
https://github.com/astropy/astroquery/pull/988

--
Dmitry Shachnev
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/debian-astro-maintainers/attachments/20171108/e98a265d/attachment.sig>