8000 Fix and align travis and platform build environments by robfrawley · Pull Request #8030 · symfony/symfony-docs · GitHub
[go: up one dir, main page]

Skip to content

Fix and align travis and platform build environments #8030

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

Conversation

robfrawley
Copy link
Contributor
@robfrawley robfrawley commented Jun 12, 2017

This pull request fixes the platform.sh deploy and aligns the platform.sh and travis-ci.org build to use the same version constraints and environments. Per @xabbuh in #8009 (comment) this PR has been made against the 2.7 branch. Original implementation pulled from #8010 and #8009. Changes include:

  • Update the pip version requirements pulled in by _build/.requirements.txt to latest releases, except for sphinx which must be downgraded to 1.3 until we find a solution for sphinx-php (which there doesn't seem to be much interest in fixing: Fix Platform.sh Build #7402 (comment), Improve the Sphinx build process #7422, Compatibility with Sphinx 1.4 fabpot/sphinx-php#33).

  • Use the same package management and constraint requirements for both platform.sh and travis-ci.org by having both utilize the _build/.requirements.txt file when calling pip.

  • Use the same documentation build command to compile the documentation HTML (make) while still calling sphinx with "strict mode" (or, more accurately, "turn warnings into errors mode") for travis-ci.org.

  • On platform.sh, since the vitrualenv folder is at the documentation root, remove all rst files contained within it (pulled in from the pip packages) via a find command, so as to ensure the build doesn't pull them in (they would never appear in the output as they don't exist in the doctree, but if they contain errors or other inconsistencies, this could cause the build to fail while reading in their sources).

@weaverryan
Copy link
Member

Wow, incredible! It indeed fixes platform.sh! I'm going to merge this now so that other PR's can take advantage of it immediately. Thank you!

@weaverryan
Copy link
Member

Merged!

@weaverryan weaverryan merged commit 764bc37 into symfony:2.7 J 8000 un 13, 2017
weaverryan added a commit that referenced this pull request Jun 13, 2017
…frawley)

This PR was merged into the 2.7 branch.

Discussion
----------

Fix and align travis and platform build environments

This pull request fixes the `platform.sh` deploy and aligns the `platform.sh` and `travis-ci.org` build to use the same version constraints and environments. Per @xabbuh in #8009 (comment) this PR has been made against the `2.7` branch. Original implementation pulled from #8010 and #8009. Changes include:

- Update the `pip` version requirements pulled in by [_build/.requirements.txt](https://github.com/robfrawley/symfony-docs/blob/feature-align-travis-and-platform-build/_build/.requirements.txt) to latest releases, except for `sphinx` which must be downgraded to `1.3` until we find a solution for `sphinx-php` (which there doesn't seem to be much interest in fixing: #7402 (comment), #7422, fabpot/sphinx-php#33).

- Use the same package management and constraint requirements for both `platform.sh` and `travis-ci.org` by having both utilize the `_build/.requirements.txt` file when calling `pip`.

- Use the same documentation build command to compile the documentation HTML (`make`) while still calling `sphinx` with "strict mode" (or, more accurately, "turn warnings into errors mode") for `travis-ci.org`.

- On `platform.sh`, since the `vitrualenv` folder is at the documentation root, remove all `rst` files contained within it (pulled in from the `pip` packages) via a `find` command, so as to ensure the build doesn't pull them in (they would never appear in the output as they don't exist in the doctree, but if they contain errors or other inconsistencies, this could cause the build to fail while reading in their sources).
  - `find .virtualenv -type f -name "*.rst" -delete`

Commits
-------

764bc37 align travis and platform build environments
@robfrawley
Copy link
Contributor Author

Good deal; glad to help! I hate seeing pages of PRs in the "red". :-)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants
0