text: #!/usr/bin/env python
  # -*- coding: utf-8 -*-
  ###############################################################################
  # $Id$
  #
  # Project:  GDAL/OGR Test Suite
  # Purpose:  test librarified gdalbuildvrt
  # Author:   Even Rouault <even dot rouault @ spatialys dot com>
  #
  ###############################################################################
  # Copyright (c) 2016, Even Rouault <even dot rouault @ spatialys dot com>
  #
  # Permission is hereby granted, free of charge, to any person obtaining a
  # copy of this software and associated documentation files (the "Software"),
  # to deal in the Software without restriction, including without limitation
  # the rights to use, copy, modify, merge, publish, distribute, sublicense,
  # and/or sell copies of the Software, and to permit persons to whom the
  # Software is furnished to do so, subject to the following conditions:
  #
  # The above copyright notice and this permission notice shall be included
  # in all copies or substantial portions of the Software.
  #
  # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  # OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
  # THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  # FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  # DEALINGS IN THE SOFTWARE.
  ###############################################################################
  
  import sys
  
  sys.path.append('../pymod')
  
  from osgeo import gdal
  import gdaltest
  
  ###############################################################################
  # Simple test
  
  
  def test_gdalbuildvrt_lib_1():
  
      # Source = String
      ds = gdal.BuildVRT('', '../gcore/data/byte.tif')
      if ds is None:
          gdaltest.post_reason('got error/warning')
          return 'fail'
  
      if ds.GetRasterBand(1).Checksum() != 4672:
          gdaltest.post_reason('Bad checksum')
          return 'fail'
  
      # Source = Array of string
      ds = gdal.BuildVRT('', ['../gcore/data/byte.tif'])
      if ds is None:
          gdaltest.post_reason('got error/warning')
          return 'fail'
  
      if ds.GetRasterBand(1).Checksum() != 4672:
          gdaltest.post_reason('Bad checksum')
          return 'fail'
  
      # Source = Dataset
      ds = gdal.BuildVRT('', gdal.Open('../gcore/data/byte.tif'))
      if ds is None:
          gdaltest.post_reason('got error/warning')
          return 'fail'
  
      if ds.GetRasterBand(1).Checksum() != 4672:
          gdaltest.post_reason('Bad checksum')
          return 'fail'
  
      # Source = Array of dataset
      ds = gdal.BuildVRT('', [gdal.Open('../gcore/data/byte.tif')])
      if ds is None:
          gdaltest.post_reason('got error/warning')
          return 'fail'
  
      if ds.GetRasterBand(1).Checksum() != 4672:
          gdaltest.post_reason('Bad checksum')
          return 'fail'
  
      return 'success'
  
  ###############################################################################
  # Test callback
  
  
  def mycallback(pct, msg, user_data):
      # pylint: disable=unused-argument
      user_data[0] = pct
      return 1
  
  
  def test_gdalbuildvrt_lib_2():
  
      tab = [0]
      ds = gdal.BuildVRT('', '../gcore/data/byte.tif', callback=mycallback, callback_data=tab)
      if ds is None:
          return 'fail'
  
      if ds.GetRasterBand(1).Checksum() != 4672:
          gdaltest.post_reason('Bad checksum')
          return 'fail'
  
      if tab[0] != 1.0:
          gdaltest.post_reason('Bad percentage')
          return 'fail'
  
      ds = None
  
      return 'success'
  
  
  gdaltest_list = [
      test_gdalbuildvrt_lib_1,
      test_gdalbuildvrt_lib_2,
  ]
  
  
  if __name__ == '__main__':
  
      gdaltest.setup_run('test_gdalbuildvrt_lib')
  
      gdaltest.run_tests(gdaltest_list)
  
      gdaltest.summarize()
  