Commit Graph

12 Commits

Author SHA1 Message Date
Ben Ramsey c005f69d6e chore: update package files 2021-08-06 14:05:57 -05:00
Ben Ramsey 39c610ea31 Clean up project documentation and repo metadata 2019-11-30 11:07:39 -08:00
Ben Ramsey 6b5ba08f03 Add CodeTriage statement 2019-11-30 09:10:09 -08:00
Ben Ramsey 446df35e87 Move util/ to tools/
GitHub ignores the contents of the tools/ directory for the purpose of
repo language statistics.
2017-03-26 16:03:42 -05:00
Ben Ramsey cc7bcfa142 Removed reference to Gitter chat
[ci skip]
2017-03-26 15:19:26 -05:00
Ben Ramsey 9e1b234324 Add Composer scripts as shortcuts to tests and doc generation 2017-03-18 10:38:08 -05:00
Ben Ramsey ec9774cc0f Updated CONTRIBUTING to include "tests" when running phpcs 2016-04-23 19:30:18 -05:00
Ben Ramsey 89b9a33431 Rename conduct file, according to Contributor Covenant recommendations 2016-03-17 11:14:50 -05:00
Ben Ramsey 6d712900f4 Modify Travis CI builds to run tests on multiple CPU architectures
The ramsey/uuid library has requirements to run on 32-bit and 64-bit
systems, as well as little-endian and big-endian systems. Travis CI only
provides hardware for testing 64-bit, little-endian CPU architectures,
but they recently announced support for Docker[^1].

After some research, I found it is possible to use [QEMU][] with
[chroot][] jails on Travis CI to emulate other CPU architectures and run
tests through these chroot jails[^2]. Unfortunately, it takes an awful
long time to set up a chroot jail, build PHP within it, and run the
tests. It wasn't reasonable to expect to do this on every single push to
the ramsey/uuid repository. This is where Docker comes in.

I was able to create chroot jails for each architecture and version of
PHP combination I need to test and then turn these into Docker images,
which Travis is able to download and run fairly quickly. The instances
on which Travis CI is running their Docker services do not currently
support phpenv or php-build, so I needed to masquerade as a Python
project and specify all PHP versions and CPU architectures in
environment variables in my `.travis.yml` configuration. I run
`composer install` and report to Coveralls outside of the Docker images,
but all tests are run within the Docker images.

The Docker image I created for PHP 7.0.0RC4 on MIPS architecture
produces segfaults when attempting to build PHP with Phar. PHP builds
okay without Phar, but then it produces segfaults when running any PHP
script on the image, so I'm leaving out 7.0.0RC4 on MIPS for now.

The Docker images for use with ramsey/uuid tests are available here:
<https://hub.docker.com/r/benramsey/ramsey-uuid/>.

[^1]: "Using Docker on Travis
CI," <http://blog.travis-ci.com/2015-08-19-using-docker-on-travis-ci/>
[^2]: "Running Travis CI tests on ARM architecture,"
<https://www.tomaz.me/2013/12/02/running-travis-ci-tests-on-arm.html>

[qemu]: http://wiki.qemu.org/Main_Page
[chroot]: https://en.wikipedia.org/wiki/Chroot
2015-10-07 22:59:11 -05:00
Ben Ramsey a0217723d5 Use --verbose when running tests to show skipped/incomplete tests 2015-10-03 11:01:12 -05:00
Ben Ramsey f48f26e3e1 Add project code of conduct and update README
[ci skip]
2015-09-29 09:38:31 -05:00
Ben Ramsey 72930cd283 Adding contributing guide 2015-06-16 12:04:06 -05:00