* Add `Loader` and map loading functions

* Update examples, doc & tests

* Add tileset loading functions

* Fix unrelated broken intradoc link

* Fix intradoc link

* Fix more docs

* Update changelog and readme

* Fix warnings

* Change version, remove dead code

* Update version to 0.10.0, add include table

* Address PR comments

* Change crates.io version

Also use the TileId alias in a few more places.

* Warn on missing docs

* Add some documentation and fix examples

* More documentation

* More docs

* More docs

* Fix object colour docs

* Finish documenting

* Misc changes

* Address PR comment

* Partial commit

* Partial commit

* Partial commit

* Some suggested changes and fixed tests (except infinite)

* Replaced `tile` member in `LayerTileRef` with a function to get an
  `Option<&Tile>`.

* Replaced `Map::get_tile_by_gid` with `Map::get_tileset_for_gid`, which
  just returns the `Option<&Tileset>`. It also does a reverse search,
  which fixes the lookup in case an external tileset has grown since the
  map was last saved.

* Replaced `Tileset::get_tile_by_gid` with `Tileset::get_tile`, since
  subtracting of the `first_gid` already happens when creating the
  `LayerTileRef`. Also, we eventually should remove `first_gid` from
  `Tileset`, since it should be possible to share a single tileset
  instance betweeen several maps.

* Pre-allocate the tiles hash map for the expected number of tiles and
  use `or_default` instead of `or_insert_with(Default::default)`.

* [nonbuilding] Move ownership of tilesets
- Moves the ownership of tilesets from Map to an object implementing `TilesetCache`

* Clean up

* More cleanup

* Organize layers into modules

* Further modularization

* Add layer wrappers

* Implement `Clone + PartialEq + Debug` for wrappers

* Fix example

* Fix all tests except for test_infinite_tileset

* Move layer utils to its own module

* Better `Map::layers` documentation

* `TilesetCache` -> `cache::ResourceCache`

* Add `ResourcePath`, rename and add errors

* Interface changes
- Move embedded tilesets from cache to map
- Store `Option<LayerTileData>` instead of `LayerTileData`

* parser ->`&mut impl Iterator<Item=XmlEventResult>`

* Document that tilesets are ordered by first GID

* Fix the layer tiles using GIDs issue

* Run `cargo fix`

* Fix `test_infinite_tileset` tests

* Implement a way to access object tile data

* Rename `TiledWrapper` to `MapWrapper`

* More efficient `get_or_try_insert_tileset_with`

* Add `ResourcePathBuf`, use `Rc<Tileset>` in `Map`

* Remove `MapTileset::first_gid`

* Run `cargo fix`

* Remove unrelated `Tileset` changes

* Requested changes

* Avoid reference counting when accessing tiles

* Store tile data instead of (u32, u32)` in objects

* Remove unneeded functions from `ResourceCache`

* Address PR comments

* Misc improvements in `layers::tile`

* Improve example

* Convert `LayerTile` properties to fields

Co-authored-by: Thorbjørn Lindeijer <bjorn@lindeijer.nl>

* Expose types at the top level

While the modules are great for organizing the code internally, it is more
convenient for users of the create when the types are available at the top
level. This avoids the verbosity like "map::Map".

* Changelog updated

Removed the lines stating where which class has been moved, since all these
classes are not available at the top level again.

Also removed some things which I didn't think we actually noteworthy for people
reading up on what had changed.

* Restored some changelog items

Removal of these items unrelated to how the data types are exposed.

Update CI link
Remove things from "Things missing" that were added
Update example to use `parse_file`

If I don't forget to publish the changes then I forget to update the README. *sigh*

 * change readme build button back since this will be a pull request

Before this commit parse took an EventReader. Change so that it takes a
Buffer