#!/usr/bin/env pytest
# -*- coding: utf-8 -*-
###############################################################################
#
# Project:  GDAL/OGR Test Suite
# Purpose:  gdal_rasterize testing
# Author:   Even Rouault <even dot rouault at spatialys dot com>
#
###############################################################################
# Copyright (c) 2015, Even Rouault <even dot rouault at spatialys dot com>
# Copyright (c) 2008, Frank Warmerdam <warmerdam@pobox.com>
#
# SPDX-License-Identifier: MIT
###############################################################################

import collections
import struct

import gdaltest
import pytest

from osgeo import gdal, ogr, osr

###############################################################################
# Simple polygon rasterization (adapted from alg/rasterize.py).


def test_gdal_rasterize_lib_1():

    # Setup working spatial reference
    # sr_wkt = 'LOCAL_CS["arbitrary"]'
    # sr = osr.SpatialReference( sr_wkt )
    sr = osr.SpatialReference()
    sr.ImportFromEPSG(32631)
    sr_wkt = sr.ExportToWkt()

    # Create a raster to rasterize into.

    target_ds = gdal.GetDriverByName("MEM").Create("", 100, 100, 3, gdal.GDT_Byte)
    target_ds.SetGeoTransform((1000, 1, 0, 1100, 0, -1))
    target_ds.SetProjection(sr_wkt)

    # Create a layer to rasterize from.

    vector_ds = gdal.GetDriverByName("MEM").Create("", 0, 0, 0)
    rast_lyr = vector_ds.CreateLayer("rast1", srs=sr)

    rast_lyr.GetLayerDefn()
    field_defn = ogr.FieldDefn("foo")
    rast_lyr.CreateField(field_defn)

    # Add a polygon.

    wkt_geom = "POLYGON((1020 1030,1020 1045,1050 1045,1050 1030,1020 1030))"

    feat = ogr.Feature(rast_lyr.GetLayerDefn())
    feat.SetGeometryDirectly(ogr.Geometry(wkt=wkt_geom))

    rast_lyr.CreateFeature(feat)

    # Add feature without geometry to test fix for #3310
    feat = ogr.Feature(rast_lyr.GetLayerDefn())
    rast_lyr.CreateFeature(feat)

    # Add a linestring.

    wkt_geom = "LINESTRING(1000 1000, 1100 1050)"

    feat = ogr.Feature(rast_lyr.GetLayerDefn())
    feat.SetGeometryDirectly(ogr.Geometry(wkt=wkt_geom))

    rast_lyr.CreateFeature(feat)

    ret = gdal.Rasterize(
        target_ds,
        vector_ds,
        bands=[3, 2, 1],
        burnValues=[200, 220, 240],
        layers="rast1",
    )
    assert ret == 1

    # Check results.
    expected = 6452
    checksum = target_ds.GetRasterBand(2).Checksum()
    assert checksum == expected, "Did not get expected image checksum"

    target_ds = None


###############################################################################
# Test creating an output file


def test_gdal_rasterize_lib_3(tmp_path, tmp_vsimem):

    import test_cli_utilities

    if test_cli_utilities.get_gdal_contour_path() is None:
        pytest.skip()

    dst_shp = tmp_path / "n43dt0.shp"

    gdaltest.runexternal(
        test_cli_utilities.get_gdal_contour_path()
        + f" ../gdrivers/data/n43.tif {dst_shp} -i 10 -3d"
    )

    with pytest.raises(Exception):
        gdal.Rasterize(tmp_vsimem / "bogus.tif", dst_shp)

    ds = gdal.Rasterize(
        "",
        dst_shp,
        format="MEM",
        outputType=gdal.GDT_Byte,
        useZ=True,
        layers=["n43dt0"],
        width=121,
        height=121,
        noData=0,
    )

    ds_ref = gdal.Open("../gdrivers/data/n43.tif")

    assert (
        ds.GetRasterBand(1).GetNoDataValue() == 0.0
    ), "did not get expected nodata value"

    assert (
        ds.RasterXSize == 121 and ds.RasterYSize == 121
    ), "did not get expected dimensions"

    gt_ref = ds_ref.GetGeoTransform()
    gt = ds.GetGeoTransform()
    for i in range(6):
        assert gt[i] == pytest.approx(
            gt_ref[i], abs=1e-6
        ), "did not get expected geotransform"

    wkt = ds.GetProjectionRef()
    assert wkt.find("WGS_1984") != -1, "did not get expected SRS"


###############################################################################
# Rasterization without georeferencing


def test_gdal_rasterize_lib_100():

    target_ds = gdal.GetDriverByName("MEM").Create("", 100, 100)

    # Create a layer to rasterize from.

    vector_ds = gdal.GetDriverByName("MEM").Create("", 0, 0, 0)
    rast_lyr = vector_ds.CreateLayer("rast1")

    wkt_geom = "POLYGON((20 20,20 80,80 80,80 20,20 20))"

    feat = ogr.Feature(rast_lyr.GetLayerDefn())
    feat.SetGeometryDirectly(ogr.Geometry(wkt=wkt_geom))

    rast_lyr.CreateFeature(feat)

    ret = gdal.Rasterize(target_ds, vector_ds, burnValues=[255])
    assert ret == 1

    # Check results.
    expected = 44190
    checksum = target_ds.GetRasterBand(1).Checksum()
    assert checksum == expected, "Did not get expected image checksum"

    target_ds = None


###############################################################################
# Rasterization on empty geometry


def test_gdal_rasterize_lib_101():

    target_ds = gdal.GetDriverByName("MEM").Create("", 100, 100)

    # Create a layer to rasterize from.

    vector_ds = gdal.GetDriverByName("MEM").Create("", 0, 0, 0)
    rast_lyr = vector_ds.CreateLayer("rast1")

    # polygon with empty exterior ring
    geom = ogr.CreateGeometryFromJson('{ "type": "Polygon", "coordinates": [ [ ] ] }')

    feat = ogr.Feature(rast_lyr.GetLayerDefn())
    feat.SetGeometryDirectly(geom)

    rast_lyr.CreateFeature(feat)

    ret = gdal.Rasterize(target_ds, vector_ds, burnValues=[255])
    assert ret == 1

    # Check results.
    checksum = target_ds.GetRasterBand(1).Checksum()
    assert checksum == 0, "Did not get expected image checksum"

    target_ds = None


###############################################################################
# Rasterization on raster with RPC


def test_gdal_rasterize_lib_102():

    target_ds = gdal.GetDriverByName("MEM").Create("", 353, 226)
    target_ds.GetRasterBand(1).Fill(255)
    md = {
        "HEIGHT_OFF": "430",
        "HEIGHT_SCALE": "501",
        "LAT_OFF": "-0.0734",
        "LAT_SCALE": "0.2883",
        "LINE_DEN_COEFF": "1 0.0002790015 0.001434672 1.481312e-07 5.866139e-06 1.878347e-07 -7.1677e-08 -1.099383e-05 1.968371e-06 -5.50509e-06 0 -1.227539e-08 0 0 2.40682e-07 -1.144941e-08 0 -1.884406e-08 0 0",
        "LINE_NUM_COEFF": "0.002744972 -0.382552 -1.279674 -0.0001147828 0.001140472 1.262068e-07 -1.69402e-07 -0.005830625 -0.001964747 0 -2.006924e-07 3.066144e-07 3.005069e-06 2.103552e-06 -1.981401e-06 -1.636042e-06 7.045145e-06 -5.699422e-08 1.169591e-07 0",
        "LINE_OFF": "112.98500331785",
        "LINE_SCALE": "113.01499668215",
        "LONG_OFF": "-4.498",
        "LONG_SCALE": "0.5511",
        "SAMP_DEN_COEFF": "1 0.001297913 0.0005878427 -0.0004554233 -7.353773e-05 7.928584e-06 -1.826261e-06 9.516839e-05 5.332457e-07 -4.236274e-05 -1.89316e-08 -1.520878e-06 -8.941367e-07 -7.770314e-07 1.413225e-06 9.681702e-08 -4.724849e-08 -2.244317e-07 1.0665e-08 4.212225e-08",
        "SAMP_NUM_COEFF": "0.01819195 1.091934 -0.1976373 0.003166136 0.002648549 0.0003527143 -6.27017e-05 -0.01889831 -0.0005888535 1.729232e-07 3.037208e-06 0.000174218 -3.129558e-05 -4.602708e-05 2.724941e-05 -9.314161e-07 8.328574e-06 -1.240182e-05 -4.652876e-07 -1.322223e-07",
        "SAMP_OFF": "176.619681301916",
        "SAMP_SCALE": "177.068486184099",
    }
    target_ds.SetMetadata(md, "RPC")

    vector_ds = gdal.GetDriverByName("MEM").Create("", 0, 0, 0)
    sr = osr.SpatialReference()
    sr.ImportFromEPSG(4326)
    rast_lyr = vector_ds.CreateLayer("", srs=sr)

    # polygon with empty exterior ring
    geom = ogr.CreateGeometryFromWkt(
        """POLYGON ((-3.967081661665 0.0003251483162,-4.976841813513 0.0003251483162,-4.904140485134 0.2151010973779,-4.904124933286 0.2151433982916,-4.904107210626 0.2151848366149,-4.904087364764 0.2152253010321,-4.904065449011 0.2152646828438,-4.904041522241 0.2153028762585,-4.904015648726 0.2153397786774,-4.903987897971 0.2153752909697,-4.903958344523 0.2154093177387,-4.903927067771 0.2154417675784,-4.903894151734 0.2154725533188,-4.903859684834 0.2155015922603,-4.90382375966 0.2155288063955,-4.903786472717 0.2155541226193,-4.903747924169 0.2155774729247,-4.90370821757 0.2155987945858,-4.903667459582 0.2156180303263,-4.903625759694 0.2156351284732,-4.903583229924 0.2156500430959,-4.90353998452 0.2156627341291,-4.903496139651 0.2156731674811,-4.9034518131 0.2156813151247,-4.903407123938 0.2156871551729,-4.903362192216 0.2156906719376,-4.903317138633 0.2156918559717,-4.903272084216 0.2156907040946,-4.903227149995 0.2156872194006,-4.903182456677 0.2156814112505,-3.945022212098 0.0658193544758,-3.94497805444 0.0658112751384,-3.944934372574 0.0658009277184,-3.944891282916 0.0657883397923,-3.944848900303 0.0657735449078,-3.944807337687 0.0657565824944,-3.944766705836 0.0657374977579,-3.944727113036 0.0657163415606,-3.944688664805 0.0656931702851,-3.94465146361 0.0656680456844,-3.944615608594 0.0656410347174,-3.944581195314 0.0656122093701,-3.944548315483 0.065581646464,-3.944517056729 0.0655494274513,-3.944487502358 0.065515638198,-3.944459731134 0.0654803687547,-3.944433817071 0.0654437131168,-3.944409829229 0.0654057689742,-3.94438783154 0.0653666374506,-3.944367882627 0.0653264228341,-3.944350035657 0.0652852322995,-3.944334338192 0.0652431756223,-3.944320832068 0.0652003648864,-3.944309553279 0.0651569141855,-3.944300531884 0.0651129393185,-3.944293791926 0.0650685574815,-3.944289351367 0.0650238869551,-3.944287222041 0.0649790467894,-3.944287409623 0.0649341564864,-3.944289913614 0.0648893356818,-3.94429472734 0.0648447038262,-3.944301837972 0.0648003798665,-3.94431122656 0.064756481929,-3.944322868082 0.0647131270048,-3.944336731513 0.0646704306378,-3.967081661665 0.0003251483162))"""
    )

    feat = ogr.Feature(rast_lyr.GetLayerDefn())
    feat.SetGeometryDirectly(geom)

    rast_lyr.CreateFeature(feat)

    ret = gdal.Rasterize(target_ds, vector_ds, burnValues=[0])
    assert ret == 1

    # Check results.
    checksum = target_ds.GetRasterBand(1).Checksum()
    assert checksum == 1604, "Did not get expected image checksum"

    # Re-try with transformer options
    target_ds.GetRasterBand(1).Fill(255)
    ret = gdal.Rasterize(
        target_ds, vector_ds, burnValues=[0], transformerOptions=["RPC_HEIGHT=1000"]
    )
    assert ret == 1

    # Check results.
    checksum = target_ds.GetRasterBand(1).Checksum()
    assert checksum == 2003, "Did not get expected image checksum"
    target_ds = None


###############################################################################
# Simple rasterization with all values of the optim option


def test_gdal_rasterize_lib_4():

    # Setup working spatial reference
    # sr_wkt = 'LOCAL_CS["arbitrary"]'
    # sr = osr.SpatialReference( sr_wkt )
    sr = osr.SpatialReference()
    sr.ImportFromEPSG(32631)
    sr_wkt = sr.ExportToWkt()

    # Create a raster to rasterize into.
    for optim in ["RASTER", "VECTOR", "AUTO"]:
        target_ds = gdal.GetDriverByName("MEM").Create("", 100, 100, 3, gdal.GDT_Byte)
        target_ds.SetGeoTransform((1000, 1, 0, 1100, 0, -1))
        target_ds.SetProjection(sr_wkt)

        # Create a layer to rasterize from.

        vector_ds = gdal.GetDriverByName("MEM").Create("", 0, 0, 0)
        rast_lyr = vector_ds.CreateLayer("rast1", srs=sr)

        rast_lyr.GetLayerDefn()
        field_defn = ogr.FieldDefn("foo")
        rast_lyr.CreateField(field_defn)

        # Add a polygon.

        wkt_geom = "POLYGON((1020 1030,1020 1045,1050 1045,1050 1030,1020 1030))"

        feat = ogr.Feature(rast_lyr.GetLayerDefn())
        feat.SetGeometryDirectly(ogr.Geometry(wkt=wkt_geom))

        rast_lyr.CreateFeature(feat)

        # Add feature without geometry to test fix for #3310
        feat = ogr.Feature(rast_lyr.GetLayerDefn())
        rast_lyr.CreateFeature(feat)

        # Add a linestring.

        wkt_geom = "LINESTRING(1000 1000, 1100 1050)"

        feat = ogr.Feature(rast_lyr.GetLayerDefn())
        feat.SetGeometryDirectly(ogr.Geometry(wkt=wkt_geom))

        rast_lyr.CreateFeature(feat)

        ret = gdal.Rasterize(
            target_ds,
            vector_ds,
            bands=[3, 2, 1],
            burnValues=[200, 220, 240],
            layers="rast1",
            optim=optim,
        )
        assert ret == 1

        # Check results.
        expected = 6452
        checksum = target_ds.GetRasterBand(2).Checksum()
        if checksum != expected:
            print(checksum, optim)

            pytest.fail("Did not get expected image checksum")

        target_ds = None


def test_gdal_rasterize_lib_multipolygon():

    sr_wkt = 'LOCAL_CS["arbitrary"]'
    sr = osr.SpatialReference(sr_wkt)

    # Try rasterizing a multipolygon
    vector_ds = gdal.GetDriverByName("MEM").Create("", 0, 0, 0)
    layer = vector_ds.CreateLayer("", sr)
    feature = ogr.Feature(layer.GetLayerDefn())
    feature.SetGeometryDirectly(
        ogr.CreateGeometryFromWkt(
            "MULTIPOLYGON (((0 0,0 1,1 1,0 0)),((1 1,2 1,2 0,1 1)))"
        )
    )
    layer.CreateFeature(feature)

    target_ds = gdal.GetDriverByName("MEM").Create("", 3, 2)
    target_ds.SetGeoTransform((-0.5, 1, 0, 1.5, 0, -1))
    target_ds.SetSpatialRef(sr)
    ret = gdal.Rasterize(target_ds, vector_ds, burnValues=[10])
    assert ret == 1
    cs1 = target_ds.GetRasterBand(1).Checksum()

    # And now each of its parts
    vector_ds = gdal.GetDriverByName("MEM").Create("", 0, 0, 0)
    layer = vector_ds.CreateLayer("", sr)
    feature = ogr.Feature(layer.GetLayerDefn())
    feature.SetGeometryDirectly(
        ogr.CreateGeometryFromWkt("POLYGON ((0 0,0 1,1 1,0 0))")
    )
    layer.CreateFeature(feature)
    feature = ogr.Feature(layer.GetLayerDefn())
    feature.SetGeometryDirectly(
        ogr.CreateGeometryFromWkt("POLYGON ((1 1,2 1,2 0,1 1))")
    )
    layer.CreateFeature(feature)

    target_ds = gdal.GetDriverByName("MEM").Create("", 3, 2)
    target_ds.SetGeoTransform((-0.5, 1, 0, 1.5, 0, -1))
    target_ds.SetSpatialRef(sr)
    ret = gdal.Rasterize(target_ds, vector_ds, burnValues=[10])
    assert ret == 1
    cs2 = target_ds.GetRasterBand(1).Checksum()

    # Check that results are the same
    assert cs1 == cs2


def test_gdal_rasterize_lib_inverse():

    sr_wkt = 'LOCAL_CS["arbitrary"]'
    sr = osr.SpatialReference(sr_wkt)

    # Try rasterizing a multipolygon
    vector_ds = gdal.GetDriverByName("MEM").Create("", 0, 0, 0)
    layer = vector_ds.CreateLayer("", sr)

    feature = ogr.Feature(layer.GetLayerDefn())
    feature.SetGeometryDirectly(
        ogr.CreateGeometryFromWkt(
            "MULTIPOLYGON (((1 1,1 9,4 9,4 1,1 1),(2 2,2 8,3 8,3 2,2 2)))"
        )
    )
    layer.CreateFeature(feature)

    feature = ogr.Feature(layer.GetLayerDefn())
    feature.SetGeometryDirectly(
        ogr.CreateGeometryFromWkt("POLYGON ((5 1,5 9,9 9,9 1,5 1))")
    )
    layer.CreateFeature(feature)

    # Will not be rasterized
    feature = ogr.Feature(layer.GetLayerDefn())
    feature.SetGeometryDirectly(ogr.CreateGeometryFromWkt("POINT (5 5)"))
    layer.CreateFeature(feature)

    target_ds = gdal.GetDriverByName("MEM").Create("", 11, 11)
    target_ds.SetGeoTransform((-0.5, 1, 0, 10.5, 0, -1))
    target_ds.SetSpatialRef(sr)

    with gdal.quiet_errors():
        ret = gdal.Rasterize(target_ds, vector_ds, burnValues=[9], inverse=True)
    assert ret == 1

    expected = (
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        0,
        0,
        0,
        9,
        0,
        0,
        0,
        0,
        9,
        9,
        9,
        0,
        9,
        0,
        9,
        0,
        0,
        0,
        0,
        9,
        9,
        9,
        0,
        9,
        0,
        9,
        0,
        0,
        0,
        0,
        9,
        9,
        9,
        0,
        9,
        0,
        9,
        0,
        0,
        0,
        0,
        9,
        9,
        9,
        0,
        9,
        0,
        9,
        0,
        0,
        0,
        0,
        9,
        9,
        9,
        0,
        9,
        0,
        9,
        0,
        0,
        0,
        0,
        9,
        9,
        9,
        0,
        9,
        0,
        9,
        0,
        0,
        0,
        0,
        9,
        9,
        9,
        0,
        9,
        0,
        9,
        0,
        0,
        0,
        0,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
        9,
    )
    assert struct.unpack("B" * 121, target_ds.ReadRaster()) == expected


###############################################################################


@pytest.mark.require_geos
def test_gdal_rasterize_lib_inverse_nested_polygons():

    # Create a memory raster to rasterize into.
    target_ds = gdal.GetDriverByName("MEM").Create("", 10, 10, 1, gdal.GDT_Byte)
    target_ds.SetGeoTransform((0, 1, 0, 10, 0, -1))

    # Create a memory layer to rasterize from.
    vector_ds = gdal.GetDriverByName("MEM").Create("", 0, 0, 0, gdal.GDT_Unknown)
    rast_mem_lyr = vector_ds.CreateLayer("poly")

    # Add a multi polygon with nested polygons
    feat = ogr.Feature(rast_mem_lyr.GetLayerDefn())
    wkt = "MULTIPOLYGON(((0 0,0 10,10 10,10 0,0 0),(2 2,2 8,8 8,8 2,2 2)),((4 4,4 6,6 6,6 4,4 4)))"
    feat.SetGeometryDirectly(ogr.Geometry(wkt=wkt))

    rast_mem_lyr.CreateFeature(feat)

    gdal.Rasterize(target_ds, vector_ds, burnValues=[1], inverse=True)

    expected = (
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,  ################################
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,  ################################
        0,
        0,
        1,
        1,
        1,
        1,
        1,
        1,
        0,
        0,  ################################
        0,
        0,
        1,
        1,
        1,
        1,
        1,
        1,
        0,
        0,  ################################
        0,
        0,
        1,
        1,
        0,
        0,
        1,
        1,
        0,
        0,  ################################
        0,
        0,
        1,
        1,
        0,
        0,
        1,
        1,
        0,
        0,  ################################
        0,
        0,
        1,
        1,
        1,
        1,
        1,
        1,
        0,
        0,  ################################
        0,
        0,
        1,
        1,
        1,
        1,
        1,
        1,
        0,
        0,  ################################
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,  ################################
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
    )

    got = struct.unpack("B" * (10 * 10), target_ds.ReadRaster())
    assert got == expected


###############################################################################
# Test rasterization of a 64 bit integer attribute


def test_gdal_rasterize_lib_int64_attribute():

    # Try rasterizing a multipolygon
    vector_ds = gdal.GetDriverByName("MEM").Create("", 0, 0, 0)
    layer = vector_ds.CreateLayer("")
    layer.CreateField(ogr.FieldDefn("val", ogr.OFTInteger64))

    feature = ogr.Feature(layer.GetLayerDefn())
    feature.SetGeometryDirectly(
        ogr.CreateGeometryFromWkt("POLYGON ((0 0,0 1,1 1,1 0,0 0))")
    )
    val = (1 << 63) - 1  # not exactly representable as a double
    feature["val"] = val
    layer.CreateFeature(feature)

    noData = -(1 << 63)
    target_ds = gdal.Rasterize(
        "", vector_ds, format="MEM", attribute="val", width=2, height=3, noData=noData
    )
    assert target_ds is not None
    assert target_ds.RasterXSize == 2
    assert target_ds.RasterYSize == 3
    assert target_ds.GetRasterBand(1).DataType == gdal.GDT_Int64
    assert target_ds.GetRasterBand(1).GetNoDataValue() == noData
    assert struct.unpack("Q", target_ds.ReadRaster(0, 0, 1, 1))[0] == val


###############################################################################
# Test invalid layer name


def test_gdal_rasterize_lib_invalid_layers():

    vector_ds = gdal.GetDriverByName("MEM").Create("", 0, 0, 0)
    layer = vector_ds.CreateLayer("layer")
    layer.CreateField(ogr.FieldDefn("val", ogr.OFTInteger64))

    with pytest.raises(Exception, match="Unable to find layer"):
        gdal.Rasterize(
            "", vector_ds, format="MEM", layers=["invalid"], width=2, height=2
        )


###############################################################################
# Test rasterizing empty layer


def test_gdal_rasterize_lib_empty_layer():

    vector_ds = gdal.GetDriverByName("MEM").Create("", 0, 0, 0)
    layer = vector_ds.CreateLayer("layer")
    layer.CreateField(ogr.FieldDefn("val", ogr.OFTInteger64))

    with pytest.raises(Exception, match="Cannot get layer extent"):
        gdal.Rasterize("", vector_ds, format="MEM", width=2, height=2)


###############################################################################
# Test too small target resolution


def test_gdal_rasterize_lib_too_small_resolution():

    vector_ds = gdal.GetDriverByName("MEM").Create("", 0, 0, 0)
    layer = vector_ds.CreateLayer("layer")
    layer.CreateField(ogr.FieldDefn("val", ogr.OFTInteger64))

    feature = ogr.Feature(layer.GetLayerDefn())
    feature.SetGeometryDirectly(
        ogr.CreateGeometryFromWkt("POLYGON ((0 0,0 1,1 1,1 0,0 0))")
    )
    feature["val"] = 0
    layer.CreateFeature(feature)

    with pytest.raises(Exception, match="Invalid computed output raster size"):
        gdal.Rasterize("", vector_ds, format="MEM", xRes=1e-20, yRes=1)

    with pytest.raises(Exception, match="Invalid computed output raster size"):
        gdal.Rasterize("", vector_ds, format="MEM", xRes=1, yRes=1e-20)


###############################################################################
# Test option argument handling


def test_gdal_rasterize_lib_dict_arguments():

    opt = gdal.RasterizeOptions(
        "__RETURN_OPTION_LIST__",
        creationOptions=collections.OrderedDict(
            (("COMPRESS", "DEFLATE"), ("LEVEL", 4))
        ),
    )

    ind = opt.index("-co")

    assert opt[ind : ind + 4] == ["-co", "COMPRESS=DEFLATE", "-co", "LEVEL=4"]


###############################################################################
# Test doesn't crash without options


@pytest.mark.require_driver("GeoJSON")
def test_gdal_rasterize_no_options(tmp_vsimem):
    """Test doesn't crash without options"""

    gdal.FileFromMemBuffer(
        tmp_vsimem / "test.json",
        r"""{
                "type": "FeatureCollection",
                "name": "test",
                "crs": { "type": "name", "properties": { "name": "urn:ogc:def:crs:EPSG::4326" } },
                "features": [
                    { "type": "Feature", "properties": { "id": 1 }, "geometry": { "type": "Polygon", "coordinates": [ [ [ 0, 0 ], [ 0, 1 ], [ 1, 1 ], [ 1, 0 ], [ 0, 0 ] ] ] } }
                ]
            }""",
    )

    # Open the dataset
    ds = gdal.OpenEx(tmp_vsimem / "test.json", gdal.OF_VECTOR)
    assert ds

    # Create a raster to rasterize into.
    target_ds = gdal.GetDriverByName("GTiff").Create(
        tmp_vsimem / "out.tif", 10, 10, 1, gdal.GDT_Byte
    )

    assert target_ds

    # Call rasterize
    ds = gdal.Rasterize(target_ds, ds)


###############################################################################
# Error cases


@gdaltest.enable_exceptions()
def test_gdal_rasterize_bad_output_format(tmp_vsimem):

    if gdal.GetDriverByName("PNG"):
        with pytest.raises(
            RuntimeError, match="does not support direct output file creation"
        ):
            gdal.Rasterize(
                tmp_vsimem / "out.png",
                "../ogr/data/poly.shp",
                width=100,
                height=100,
                format="PNG",
            )

    with pytest.raises(RuntimeError, match="driver .* not recognised"):
        gdal.Rasterize(
            tmp_vsimem / "out.pngg",
            "../ogr/data/poly.shp",
            width=100,
            height=100,
            format="DOES_NOT_EXIST",
        )

    with pytest.raises(RuntimeError, match="not a raster driver"):
        gdal.Rasterize(
            tmp_vsimem / "out.pngg",
            "../ogr/data/poly.shp",
            width=100,
            height=100,
            format="ESRI Shapefile",
        )
