Allows build to fail if JSON docs fail to generate.

[daspecster]

@dhermes what do you think of moving the documentation generation to after_success?

Fixes#2121

[dhermes]

If you put it in after_success it won't fail the build if there's a problem

[daspecster]

@dhermes switched them back around. If I understand correctly though, even if the unittests fail, the docs will still get deployed. I don't know if that's the best case.

[dhermes]

I don't know if that's the best case.

It's not. Are you deploying on PRs or just merges?

[dhermes]

You'll have to apply the **kwargs fix from #2071

[daspecster]

Yup, thanks!

[dhermes]

I assume / hope the Yup wasn't for "Are you deploying on PRs or just merges?"

[daspecster]

Apparently it is! I'm fixing that right now.

[dhermes]

Oy

[daspecster]

How does tox -e docs deploy to RTD? Is that just from the READTHEDOCS envar?

Update: nm I see the docs-rtd now.

[dhermes]

It doesn't, https://readthedocs.org/projects/gcloud-python/ looks for commits to master and triggers a build.

The relevant file was scripts/update_docs.sh before you implemented the new docs env

[daspecster]

A while ago, I made a separate script for the JSON docs, update_json_docs.sh. Travis is calling that now instead of tox -e json-docs directly.

[dhermes]

Looking at https://github.com/GoogleCloudPlatform/gcloud-python/commits/master/.travis.yml it looks like tox already does this (#2016)

[daspecster]

I guess I had more coffee in me back then.

[dhermes]

It doesn't look like update_json_docs.sh checks if the docs build during a PR

[daspecster]

That should run it every time, or were there some cases that you didn't want the docs to build? Also, should I have it build the RTD docs with tox -e docs?

I added that line as well.

[dhermes]

tox -e docs has been changed by you (previously) to update_json_docs.sh, which now calls tox -e docs, thus creating an infinite recursion.

tox -e docs-rtd makes sure the docs actually build with Sphinx (which is the concern)

[daspecster]

I didn't change tox -e docs, I added tox -e json-docs.

[testenv:docs]
https://github.com/GoogleCloudPlatform/gcloud-python/blob/master/tox.ini#L67

[testenv:json-docs]
https://github.com/GoogleCloudPlatform/gcloud-python/blob/master/tox.ini#L79

So I think it should be ok?

Except for my refactor now failing.

generate_json_docs.py: error: argument --tag: expected one argument

[daspecster]

@dhermes updated! Looks like it worked.
https://travis-ci.org/GoogleCloudPlatform/gcloud-python/builds/153329212#L687

[dhermes]

@daspecster This LGTM except for the tiny nit about using ${...}. Please squash and rename the PR to actually state what is happening

[dhermes]

You can merge once you've fixed the nit and Travis goes green, no need to check with me