Version 3 pre-release / release master ticket

[vincentsarago]

After intensive and precious work from @kylebarron (myself and @geospatial-jeff) we are releasing a new version of cogeo-mosaic today 🎉 .

We refactored a lot of internal functions and methods and introduced new Backend concept, plus the adoption of Pydantic model for mosaicjson definition.

we created a doc to ease the migration: https://github.com/developmentseed/cogeo-mosaic/blob/master/docs/v3_migration.md

thanks a lot to @kylebarron and @geospatial-jeff for their help.

3.0a.1 - 2020/05/01

https://pypi.org/project/cogeo-mosaic/3.0a1/

[vincentsarago]

3.0.a2 -2020/05/05

release changes added in #73

[vincentsarago]

3.0a3 - 2020/05/07

cogeo-mosaic/CHANGES.txt

Lines 1 to 4 in 5c6d683

	3.0a3 (2020-05-01)
	------------------
	- add Upload CLI (#74, author @kylebarron)
	- fix boto3 dynamodb exception (#75)

[vincentsarago]

3.0a4 - 2020/06/25

cogeo-mosaic/CHANGES.txt

Lines 1 to 4 in 21e6cba

	3.0a4 (2020-06-25)
	------------------
	- add STACBackend (#82)
	- fix backends caching and switch to TTL cache (#83)

[vincentsarago]

3.0a5 (2020-06-29)

cogeo-mosaic/CHANGES.txt

Lines 1 to 4 in 9986e4f

	3.0a5 (2020-06-29)
	------------------
	- remove FTP from supported backend (#87, author @geospatial-jeff)
	- add backend CRUD exceptions (#86, author @geospatial-jeff)

Thanks @geospatial-jeff

[vincentsarago]

3.0a6 - 2020/07/31

cogeo-mosaic/CHANGES.txt

Lines 1 to 12 in c989249

	3.0a6 (2020-07-31)
	------------------
	- Use environement variable to set/disable cache (#93, autho @geospatial-jeff)
	- Allow Threads configuration for overview command (author @kylebarron)
	- add --in-memory/--no-in-memory to control temporary files creation for `overview` function.
	- allow pixel_selection method options for `overview` function.
	- update to rio-tiler 2.0b4
	- use new COGReader and STACReader to add .tile and .point methods directly in the backends
	**API breacking changes**
	- backend.tile -> backend.assets_for_tile
	- backend.point -> backend.assets_for_point

[vincentsarago]

3.0a7 - 2020/07/31

cogeo-mosaic/CHANGES.txt

Lines 1 to 6 in 157d319

	3.0a7 (2020-07-31)
	------------------
	- update to rio-tiler 2.0b5
	**API breaking changes**
	- 'value' -> 'values' in MosaicBackend.point output (#98)

[vincentsarago]

3.0a8 - 2020/08/21

cogeo-mosaic/CHANGES.txt

Lines 1 to 7 in e3d82ba

	3.0a8 (2020-08-21)
	------------------
	- BaseBackend is now a subclass of rio-tiler.io.base.BaseReader (add minzoom, maxzoom, bounds properties and info method)
	- use `attr` to define backend classes
	**API breaking changes**
	- `backend_options` is now used to pass options (*kwargs) to the `_read` method

[vincentsarago]

3.0a9 and 3.0a10 - 2020/08/24

cogeo-mosaic/CHANGES.txt

Lines 1 to 7 in d26cde1

	3.0a10 (2020-08-24)
	------------------
	- Allow PointOutsideBounds exception for `point` method (#108)
	3.0a9 (2020-08-24)
	------------------
	- BaseBackend.center returns value from the mosaic definition (#105)

[vincentsarago]

3.0.0a13 (2020-10-13)

• add TMS in BaseBackend to align with rio-tiler BaseBackend.

[vincentsarago]

3.0.0a14 (2020-10-22)

• add logger (cogeo_mosaic.logger.logger)
• Update STACBackend to better handler paggination (ref: fix STAC pagination (E84 api) #125)
• with change from fix STAC pagination (E84 api) #125, stac_next_link_key has be specified if you know the STAC API is using the latest specs:

with MosaicBackend(
    f"stac+{stac_endpoint}",
    query.copy(),
    11,
    14,
    backend_options={
        "accessor": lambda feature: feature["id"],
        "stac_next_link_key": "next",
    }
) as mosaic:

• add to-geojson CLI to create a GeoJSON from a mosaicJSON document (add CLI to create GeoJSON from mosaic #128)
• refactor internal cache (refactor get_assets and cache config. #131)
• add progressbar for iterating over quadkeys when creating a mosaic (author @kylebarron, Add progress bar for iterating over quadkeys #130)

Breaking changes

• refactored DynamoDB backend to store multiple mosaics in one table (Support Multi Mosaic in DynamoDB Table #127)

  • new path schema dynamodb://{REGION}?/{TABLE}:{MOSAIC}

• renamed exception MosaicExists to MosaicExistsError

• renamed option fetch_quadkeys to quadkeys in DynamoDBBackend.info() method

• add quadkeys option in Backends.info() to return (or not) the list of quadkeys (add option to return or not quadkey list #129)

• moves get_assets to the base Backend (refactor get_assets and cache config. #131)

• remove multi_level mosaic support (Remove support for nested mosaics #122)

[vincentsarago]

we just publish the first release candidate 🥳

I think the library is almost ready to go. Next changes will be mostly documentation related

Changes

3.0.0rc1 (2021-02-11)

• add SQLite backend (add SQLite Backend #148)
• fix cached responsed after updating a mosaic (https://github.com/developmentseed/cogeo-mosaic/pull/148/files#r557020660)
• update mosaicJSON.bounds type definition to match rio-tiler BaseReader definition (update mosaicJSON.bounds type to tuple(float, float, float, float) #158)
• add default bounds/minzoom/maxzoom values matching the mosaicjson default in the backends (reorder backend methods and raise error when backend is read-only #162)
• raise an error when trying to pass mosaic_def in read-only backend (reorder backend methods and raise error when backend is read-only #162)
• add MemoryBackend (add InMemoryBackend  #163)

breaking

• Updated the backends .point() methods to return a list in form of [(asset1, values)] (use rio-tiler native function for multiple assets point reading #168)

[vincentsarago]

Alright I lied

I just pushed a rc2 with some breaking changes

## 3.0.0rc2 (2021-02-25))

**breaking**

* `gzip` is now only applied if the path endswith `.gz`
* remove `backend_options` attribute in base backends. This attribute was used to pass optional `gzip` option and/or STAC related options
* STAC backends has additional attributes (`stac_api_options` and `mosaic_options`)