index geobuf (#26)

* add geobuf plus

* not ready

* it should work

* export

* good

* not ready

* export geobuf plus

* export geobuf + index

* good

* not ready

* not ready

* add header

* not ready

* not ready

* notready

* invalid tag exception?

* not ready

* not ready

* not ready

* not good

* good

* this is better

* extract geometry/properties

* not ready

* good

* not ready

* good

* rename

* fix

* update

* good

* good

* not ready

* fix

* fix lint

* supports int/string get/set

* add test

* fix for windows

---------

Co-authored-by: TANG ZHIXIONG <zhixiong.tang@momenta.ai>

Author: district10

.gitignore

@@ -9,3 +9,4 @@ benchmarks/*.pbf*
 # https://github.com/cubao/nano-fmm/blob/master/data/Makefile
 data/suzhoubeizhan.json
 tests/*.json
+data/suzhoubeizhan.idx

docs/about/release-notes.md

@@ -10,6 +10,10 @@ To upgrade `pybind11-geobuf` to the latest version, use pip:
 pip install -U pybind11-geobuf
 ```
 
+## Version 0.1.9 (2023-11-15)
+
+*   Indexing geobuf (like flatgeobuf, but more general), making it random accessible
+
 ## Version 0.1.8 (2023-11-11)
 
 *   Fix readthedocs

headers

@@ -4,7 +4,7 @@
 from loguru import logger
 
 from pybind11_geobuf import rapidjson  # noqa
-from pybind11_geobuf import Decoder, Encoder  # noqa
+from pybind11_geobuf import Decoder, Encoder, GeobufIndex  # noqa
 from pybind11_geobuf import is_subset_of as is_subset_of_impl  # noqa
 from pybind11_geobuf import normalize_json as normalize_json_impl  # noqa
 from pybind11_geobuf import pbf_decode as pbf_decode_impl  # noqa
@@ -210,13 +210,22 @@ def is_subset_of(path1: str, path2: str):
     assert is_subset_of_impl(path1, path2)
 
 
+def index_geobuf(input_geobuf_path: str, output_index_path: str):
+    os.makedirs(
+        os.path.dirname(os.path.abspath(output_index_path)),
+        exist_ok=True,
+    )
+    return GeobufIndex.indexing(input_geobuf_path, output_index_path)
+
+
 if __name__ == "__main__":
     import fire
 
     fire.core.Display = lambda lines, out: print(*lines, file=out)
     fire.Fire(
         {
             "geobuf2json": geobuf2json,
+            "index_geobuf": index_geobuf,
             "is_subset_of": is_subset_of,
             "json2geobuf": json2geobuf,
             "normalize_geobuf": normalize_geobuf,

pybind11_geobuf/__main__.py

@@ -127,7 +127,7 @@ def build_extension(self, ext):
 # logic and declaration, and simpler if you include description/version in a file.
 setup(
     name="pybind11_geobuf",
-    version="0.1.8",
+    version="0.1.9",
     author="tzx",
     author_email="dvorak4tzx@gmail.com",
     url="https://geobuf-cpp.readthedocs.io",