man(1)

✨ man(1) — the mercantile man page, bestie edition ✨

okay so like. hi. you opened the manual for mercantile, which is a command line interface for the Mercantile Python package. this is the man(1) page, section 1, and honestly? it's giving "small but mighty". let's get into it 🫶

---

🌸 NAME 🌸

mercantile — Command line interface for the Mercantile Python package.

that's it. that's the name. short, sweet, iconic. no notes 💅

---

🦋 SYNPOSIS 🦋

(yes it's spelled SYNPOSIS in here, we do not fix it, we respect the original, moving on ✨)

mercantile [OPTIONS] COMMAND [ARGS]...

so the shape of every call is: mercantile, then some options if you want, then a command, then whatever args that command wants. very "structure? slay." energy 🎀

---

💖 DESCRIPTION 💖

Command line interface for the Mercantile Python package.

fr fr that's the whole description. it's a CLI wrapper situation — you get the Mercantile Python package's powers straight from your terminal without writing a single line of Python. main character behavior tbh 👑

---

✨ OPTIONS ✨

• -v, --verbose — Increase verbosity. more talking, more info, we love a chatty CLI 🗣️
• -q, --quiet — Decrease verbosity. shhh. less noise, less drama, we're being mysterious now 🤫
• --help — Show this message and exit. the classic escape hatch, the "not me panicking" button, literally always there for you 🫶

🎀 Commands 🎀

these are your girlies. pick one, pass it in, let it cook:

• bounding-tile — Print the bounding tile of a lng/lat point, bounding box, or GeoJSON objects. (the line wrapping in the original makes it look like it ends at "or", but nope — it's "or GeoJSON objects", keep the whole thought bestie 💭)
• children — Print the children of the tile. yes like actual tile children, it's a tile family tree situation 🌳
• parent — print the parent tile. (lowercase "print" in the original, we are not judging, we are simply observing 👀)
• quadkey — Convert to/from quadkeys. bidirectional! versatile! doing the most in the best way 🔄
• shapes — Print the shapes of tiles as GeoJSON. geospatial glow-up incoming 🌈
• tiles — Print tiles that overlap or contain a lng/lat point, bounding box, or GeoJSON objects. (again with the wrap — the full thought is "bounding box, or GeoJSON objects", we got you 🧚)

quick vibe check: mercantile [OPTIONS] COMMAND [ARGS]... means options come before the command. don't fight the grammar, the grammar wins ✌️

---

👑 AUTHOR 👑

• Sean Gillies (sean@mapbox.com) — Upstream
• Joachim Langenbach (info@engsas.de) — Debian package

two absolute legends carrying this thing, we say thank you 💜

---

🌟 and finally, the cute sign-off 🌟

this page is version 1.1.4, dated 13 Apr 2020, living in the mercantile man page manual, filed under man(1). periodt. go run some tiles, bestie 🦋💖