.. _integration:

================================================================================
Continuous Integration
================================================================================

PDAL :ref:`regression tests <pdal_test>` are run on a per-commit basis by at
least two continuous integration platforms.


Status
--------------------------------------------------------------------------------

|travisstatus|
|appveyorstatus|

.. |travisstatus| image:: https://travis-ci.org/PDAL/PDAL.png?branch=master
   :target: https://travis-ci.org/PDAL/PDAL

.. |appveyorstatus| image:: https://ci.appveyor.com/api/projects/status/6dehrm0v22cw58d3/branch/master?svg=true
   :target: https://ci.appveyor.com/project/hobu/pdal

.. _travis:

Travis
--------------------------------------------------------------------------------

The Travis continuous integration platform runs the PDAL test suite on Linux.
The build status and other supporting information can be found at
https://travis-ci.org/PDAL/PDAL Its configuration can be found at
https://github.com/PDAL/PDAL/blob/master/.travis.yml All administrators of the
GitHub `PDAL` group have rights to modify the Travis configuration.

It uses the ``pdal/dependencies`` :ref:`docker` image found at
https://hub.docker.com/r/pdal/dependencies as a base platform for providing
prerequisite software and running the test suite. If you want to add new test
functionality based on a dependency, you will need to update that Docker image
to do so. See :ref:`development_docker` for more detail on how PDAL builds
and uses Docker containers for testing.


.. _appveyor:

AppVeyor
--------------------------------------------------------------------------------

PDAL uses the AppVeyor continuous integration platform to run the PDAL
compilation and test suite on Windows. The build status and other supporting
information can be found at https://ci.appveyor.com/project/hobu/pdal
Its configuration can be found at https://github.com/PDAL/PDAL/blob/master/appveyor.yml
All administrators of the GitHub `PDAL` group have rights to modify the AppVeyor
configuration.

`Howard Butler`_ currently pays the bill to run in the AppVeyor upper
performance processing tier. The AppVeyor configuration depends on `OSGeo4W64`_
for dependencies. If you want to add new test functionality based on a
dependency, you will need to update OSGeo4W64 with a new package to do so.

.. _`OSGeo4W64`: http://trac.osgeo.org/osgeo4w/


.. _`Howard Butler`: http://github.com/hobu


