Fixed #31713 -- Added SpatialReference support to GDALRaster.transform().

[rico-ci]

Deprecated integer SRID as function argument in django.contrib.gis.gdal.GDALRaster.transform in favor of directly passing a SpatialReference item to the transform (django.contrib.gis.gdal.SpatialReference).

Providing patch with updated documentation, release notes, and internal deprecation log.

This is my first PR so please point out anything that can be improved!
Very much appreciated.

[claudep]

I would be for keeping support for passing an integer SRID. Or do you have a specific reason to prevent it?

[rico-ci]

My reasoning behind it was that one could pass a SpatialReference object which takes a multitude of inputs anyways. That way the function signature would be clear while keeping a high degree of flexibility. However, there’s even less hassle to keep the int input when thinking of depreciation warnings anyways. So I’m good with either way.

[claudep]

Yes, I'd rather have a similar behavior as:

• GDAL: https://docs.djangoproject.com/en/3.0/ref/contrib/gis/gdal/#django.contrib.gis.gdal.OGRGeometry.transform
• GEOS: https://docs.djangoproject.com/en/3.0/ref/contrib/gis/geos/#django.contrib.gis.geos.GEOSGeometry.transform

[rico-ci]

Have a look now. I skipped to support CoordTransform objects. I am not familiar with the cAPI and don't know how I would need to massage the pointer to obtain the target SRID from the target SpatialReference system.

[claudep]

Already in good shape in my opinion, thanks!

[rico-ci]

Let me know if there's anything else to do here :)

[claudep]

Maybe rebase the patch, then wait for a finer review by one of the Django fellows.

[felixxm]

@rico-ci Thanks for this patch 👍

[felixxm]

@rico-ci Thanks 👍 Welcome aboard ⛵

I used subTest() in tests and removed test related with ticket-31766.

[rico-ci]

Cheers @felixxm! Was a good first one to get started here.