def copy(src, dst, **kw):
"""Copy a source raster to a new destination with driver specific
creation options.
Parameters
----------
src: string
an existing raster file
dst: string
valid path to output file.
Returns
-------
None
Raises
------
ValueError:
If source path is not a valid Dataset
Notes
-----
A ``driver`` keyword argument with value like 'GTiff' or 'JPEG' is
used to control the output format.
This is the one way to create write-once files like JPEGs.
"""
from rasterio._copy import RasterCopier
return RasterCopier()(src, dst, **kw)
def copy(src, dst, **kw):
"""Copy a source dataset to a new destination with driver specific
creation options.
``src`` must be an existing file and ``dst`` a valid output file.
A ``driver`` keyword argument with value like 'GTiff' or 'JPEG' is
used to control the output format.
This is the one way to create write-once files like JPEGs.
"""
with drivers():
return RasterCopier()(src, dst, **kw)
