faster-geohash 0.1.0

A fast geohashing library

faster-geohash

A fast geohash library for python implemented using the rust geohash crate.

This library supports python 3.9-3.14 and has experimental support for the 'free-threaded' mode in python 3.14.

Usage

import faster_geohash

faster_geohash.encode((37.8324, 112.5584), precision=9)  # 'ww8p1r4t8'

faster_geohash.decode('ww8p1r4t8')  # ('37.8324', '112.5584')

Building

This library uses maturin to compile the rust code into a python extension module. An existing rust toolchain does not have to be installed because maturin will bootstrap a rust toolchain in an isolated environment as necessary. Use any standard build frontend, e.g. using uv:

# Build from source checkout
uv build --wheel .

# Build directly from sdist
uv build --wheel path/to/faster_geohash-0.0.1.tar.gz

ABI3 Support

This library supports building against the python 'limited' API/ABI3. By default it will not do so, but the option can be enabled by passing the config flag to maturin. E.g. using uv:

uv build --config-setting maturin.build-args=--features=abi3 --wheel <source_dir or sdist>