Installation

Requirements

This library requires Python 3.10 or higher. To compile it from source, Cython is required in addition.

Using Pip

$ pip install pyquadkey2

Pip installation is only tested for Linux and Mac, yet. If you encounter problems with the installation on Windows, please report them as a new issue.

From archive

$ wget https://github.com/muety/pyquadkey2/releases/download/0.3.2/pyquadkey2-0.3.2.tar.gz
$ pip install pyquadkey2-0.3.2.tar.gz

From source

Prerequisites (Linux)

• gcc
  • Fedora: dnf install @development-tools
  • Ubuntu / Debian: apt install build-essential
• python3-devel
  • Fedora: dnf install python3-devel
  • Ubuntu / Debian: apt install python3-dev
  • Others: See here

Prerequisites (Windows)

• Visual C++ Build Tools 2015 (with Windows 10 SDK) (see here)

Build

# Check out repo
$ git clone https://github.com/muety/pyquadkey2

# Create and active virtual environment (optional)
$ python -m venv ./venv
$ source venv/bin/activate

# Install dependencies
$ pip install -r requirements.txt

# Compile
$ cd src/pyquadkey2/quadkey/tilesystem && python setup.py build_ext --inplace && cd ../../../..

# Install as module
$ pip install .