Sean Gillies (Posts about tiles)

Mercantile 1.0.0

Sean Gillies — Fri, 01 Dec 2017 15:51:14 GMT

Mercantile, the module of web mercator XYZ tile utilities that I started at Mapbox, is complete. Version 1.0.0 is on the Python Package Index today and can be obtained using pip: pip install -U mercantile, no --pre option necessary. The latest and greatest documentation is at http://mercantile.readthedocs.io/en/latest/. I expect to be making improvements to the docs over the next few weeks. Please don't be shy about pointing out what the docs lack.

I'm super grateful for the help from Matthew Perry, Patrick M. Young, Amit Kapadia, Damon Burgett, Stefano Costa, Jacob Wasserman, and Brendan Ward. Sam Matthews doesn't appear in the git log, but helped me with the Sphinx layout.

I'm fortunate to be able to work on open source projects at my job and proud of Mapbox's continuing commitment to open source. Virtual confetti is being tossed in Mapbox's main Slack channel this morning and I'm feeling good.

Mercantile 1.0a1

Sean Gillies — Fri, 17 Nov 2017 04:48:42 GMT

801 Main Street, Louisville, Colorado. Photo By Jeffrey Beall (Own work) [CC BY-SA 3.0 (https://creativecommons.org/licenses/by-sa/3.0)], via Wikimedia Commons

The Python module of web mercator tile utilities that I named mercantile seems to be complete and so over the next few weeks I will shepherd a few 1.0 pre-releases and then a final 1.0.0. Any mercantile user who wants to help the cause can do this

pip install -U --pre mercantile

to get the new 1.0a1 release from PyPI and try it in new or existing projects. I was tempted by attrs yesterday, but resisted, and so the 1.0a1 release is just as stable and tested as 0.10 or 0.11, versions that my team uses the hell out of at work.

I've come late to the Read the Docs party, but am pretty much all in now. Continuous documentation (as the RTD team puts it) seems to encourage users of my projects to contribute to documentation more than ever. Mercantile's docs are here: http://mercantile.readthedocs.io/en/latest/. They're rather basic and boring, though there is one ASCII diagram at http://mercantile.readthedocs.io/en/latest/quickstart.html that makes my colleague Damon Burgett happy. Damon is the author of Supermercado, which takes web mercator tile manipulation to the next level, and a ASCII graphics wizard.

The mercantile project is a workhorse, but has also been one where I experimented and learned how to use tox, pytest, and how to publish wheels to PyPI from Travis-CI. It's uncomplicated by C extensions or industry standards and has been pretty fun to work on over the past few years.

Mercantile 0.11.0

Sean Gillies — Wed, 18 Oct 2017 13:32:11 GMT

As I mentioned the other day, my team is in Fort Collins this week for a sprint. Damon Burgett and I were sitting together working yesterday and he says, "I keep looking for the inverse of the xy function in mercantile, but it's never there." It's true, the module is missing a function to convert web mercator x and y to longitude and latitude. He wrote it, and some tests that numbers round trip properly through xy and lnglat, then made a pull request. I merged it, tagged it, pushed to GitHub. A minute later Travis-CI had uploaded mercantile 0.11.0 to the Python package index and we were pulling it back into our sprint work through an updated pip requirements file. I love how frictionless Python development and packaging can be now.

I've got limited time for Rasterio and GDAL issues this week. I can catch up a bit in the evenings, but I must prioritize getting extra rest before Saturday's race. Apologies if I don't respond until Monday.