gapic-generator-python icon indicating copy to clipboard operation
gapic-generator-python copied to clipboard

Sphinx Warning when generating client for Service Control API

Open parthea opened this issue 4 years ago • 0 comments

After generating the python client for Service Control API, I received the following Sphinx warning

"sphinx.errors.SphinxWarning: /usr/local/google/home/partheniou/git/python-service-control/google/cloud/servicecontrol_v1/types/distribution.py:docstring of google.cloud.servicecontrol_v1.types.distribution.Distribution:8:Block quote ends without a blank line; unexpected unindent.

Warning, treated as error:
/usr/local/google/home/partheniou/git/python-service-control/google/cloud/servicecontrol_v1/types/distribution.py:docstring of google.cloud.servicecontrol_v1.types.distribution.Distribution:8:Block quote ends without a blank line; unexpected unindent.

I had to apply this workaround in order to change the doc string from

      - the sum-squared-deviation of the samples, used to compute
    variance   - a histogram of the values of the sample points

to

      - the sum-squared-deviation of the samples, used to compute
        variance
      - a histogram of the values of the sample points

parthea avatar Apr 05 '21 17:04 parthea