Rasterio

-------------------

- CRS based EPSG codes can now report that code using a new `to_epsg()` method
(1288).
- A regression in rasterio.warp.reproject has been reported (1395), confirmed,
and fixed.

-------------------

Deprecation:

- The rasterio.vfs module has been removed.
- Reading array data or masks from datasets opened in "w" mode is prohibited.
- Property set_* methods of datasets have been removed. The appropriate
properties should be used instead. For example, ``dataset.crs = "EPSG:4326"``
instead of ``dataset.set_crs("EPSG:4326")``.
- Rasterio ignores creation options saved in the metadata of datasets
by Rasterio versions < 1.0b1.

-------------------

Bug fixes:

- Internal Env() in `rasterio.open` has been replaced with an environment
ensuring decorator (1009). The same decorator ensures that credentials are
obtained when functions from `rasterio.shutils` are called.
- Input file arguments for all CLI commands are now parsed and validated in
a uniform manner (999).
- Local loggers have all been changed to `getLogger(__name__)` in rasterio.rio
module (1328).

------------------

Bug fixes:

- We now raise an exception when WarpedVRT is asked to add an alpha band and
one already exists for the VRT.

------------------

Bug fixes:

- The warp memory limit configuration available in gdalwarp has been added
to `reproject()` and `WarpedVRT`.
- Avoid boundless reads when sampling pixels outside a dataset's extent
(1249).
- The logic behind rio-warp's --target-aligned-pixels has been factored into
a new `aligned_target()` function in the warp module to help resolve
853.
- A regression in the VSI path of some zip:// URLs has been fixed (1377).
- Transform, coordinate reference system, and ground control points are
properly set when opening a dataset in w+ mode (1359.

------------------

Breaking changes:

- `boundless=True` reads from warped VRTs are disallowed. Instead, VRTs should
be constructed so that only data bounded by their extents is read. In
exchange, boundless reads for non-VRT datasets are faster and more robust.

Upcoming deprecations:

- Comparison of CRS objects to str or dict is deprecated.

New features:

- Added `out`, `out_shape`, `window`, `resampling` keyword parameters to
the `dataset_mask` method (1298).
- CRS.from_string can now take WKT strings as input.

Bug fixes:

- Tests have been added to confirm that reading from a WarpedVRT will use the
source dataset's masks and overviews.
- Expectations of warp tests that use resampling algorithms other than nearest
neighbor have been corrected.
- WarpedVRT.crs now returns a CRS, not a str.
- A Windows-crashing bug in the _warp module has been fixed (1356).