@@ -12,7 +12,7 @@ A QGIS plugin to open **MapLibre Tile (MLT)** files, powered by the Rust
1212└────────┬────────────┘
1313 │ import
1414┌────────▼────────────┐
15- │ mlt_pyo3 │ Rust → Python bridge (PyO3 + maturin)
15+ │ mlt │ Rust → Python bridge (PyO3 + maturin)
1616│ (rust/mlt-pyo3) │
1717└────────┬────────────┘
1818 │ depends on
@@ -33,7 +33,7 @@ A QGIS plugin to open **MapLibre Tile (MLT)** files, powered by the Rust
3333
3434### Step 1: Find QGIS's Python interpreter
3535
36- The ` mlt_pyo3 ` native module must be built for the same Python that QGIS uses.
36+ The ` mlt ` native module must be built for the same Python that QGIS uses.
3737
3838``` bash
3939# Linux (system Python, usually the same one QGIS links to)
@@ -56,7 +56,7 @@ maturin build --release --interpreter /usr/bin/python3
5656
5757# Install into user site-packages (visible to QGIS)
5858/usr/bin/python3 -m pip install --user --break-system-packages \
59- ../../rust/target/wheels/mlt_pyo3 -* .whl
59+ ../../rust/target/wheels/mlt -* .whl
6060
6161# Option B: if QGIS uses a virtualenv / conda, activate it first
6262# conda activate qgis-env # or: source /path/to/venv/bin/activate
@@ -66,7 +66,7 @@ maturin build --release --interpreter /usr/bin/python3
6666Verify:
6767
6868``` bash
69- /usr/bin/python3 -c " import mlt_pyo3 ; print(mlt_pyo3 .list_layers(open('../../test/synthetic/0x01/polygon.mlt','rb').read()))"
69+ /usr/bin/python3 -c " import mlt ; print(mlt .list_layers(open('../../test/synthetic/0x01/polygon.mlt','rb').read()))"
7070# Expected: ['layer1']
7171```
7272
@@ -133,31 +133,31 @@ geo-referencing (useful for inspecting raw tile data).
133133## Python API (standalone, without QGIS)
134134
135135``` python
136- import mlt_pyo3
136+ import mlt
137137
138138data = open (" tile.mlt" , " rb" ).read()
139139
140140# Structured decode with geo-referencing
141- layers = mlt_pyo3 .decode_mlt(data, z = 14 , x = 8297 , y = 10749 , tms = True )
141+ layers = mlt .decode_mlt(data, z = 14 , x = 8297 , y = 10749 , tms = True )
142142for layer in layers:
143143 print (f " Layer: { layer.name} , extent: { layer.extent} " )
144144 for feat in layer.features[:3 ]:
145145 print (f " id= { feat.id} , type= { feat.geometry_type} " )
146146 print (f " wkb= { len (feat.wkb)} bytes, props= { dict (feat.properties)} " )
147147
148148# Raw tile-local coordinates (no z/x/y needed)
149- layers = mlt_pyo3 .decode_mlt(data)
149+ layers = mlt .decode_mlt(data)
150150
151151# GeoJSON string output (tile-local coords)
152- geojson_str = mlt_pyo3 .decode_mlt_to_geojson(data)
152+ geojson_str = mlt .decode_mlt_to_geojson(data)
153153
154154# Fast layer listing (no full decode)
155- names = mlt_pyo3 .list_layers(data)
155+ names = mlt .list_layers(data)
156156```
157157
158158## Troubleshooting
159159
160- ** "mlt_pyo3 module not found"** — the native module isn't installed for QGIS's
160+ ** "mlt module not found"** — the native module isn't installed for QGIS's
161161Python. Re-run Step 2 using the correct interpreter.
162162
163163** Features appear in the ocean** — toggle the TMS checkbox, or verify z/x/y
0 commit comments