add typing stubs

.github/workflows/pip.yml

@@ -12,8 +12,8 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        platform: [ubuntu-20.04, windows-2019, macos-11]
-        python-version: ["3.8", "3.9", "3.10"]
+        platform: [ubuntu-20.04, windows-2019, macos-13]
+        python-version: ["3.9"]
 
     runs-on: ${{ matrix.platform }}
 

.github/workflows/wheels.yml

@@ -49,7 +49,7 @@ jobs:
       with:
         platforms: all
 
-    - uses: pypa/cibuildwheel@v2.12.0
+    - uses: pypa/cibuildwheel@v2.21.1
       env:
         # CIBW_ARCHS: auto64
         CIBW_ARCHS_LINUX: x86_64 aarch64
@@ -79,7 +79,7 @@ jobs:
     steps:
     - uses: actions/setup-python@v4
       with:
-        python-version: "3.x"
+        python-version: "3.9"
 
     - uses: actions/download-artifact@v3
       with:

.gitignore

@@ -9,3 +9,4 @@ _generate/
 wheelhouse
 !test.py
 site
+stubs

CMakeLists.txt

@@ -38,7 +38,7 @@ endif()
 # https://scikit-build-core.readthedocs.io/en/latest/getting_started.html
 find_package(Python REQUIRED COMPONENTS Interpreter Development.Module)
 find_package(pybind11 CONFIG REQUIRED)
-include_directories(BEFORE ${PROJECT_SOURCE_DIR}/headers/include)
+include_directories(SYSTEM ${PROJECT_SOURCE_DIR}/headers/include)
 
 python_add_library(_core MODULE src/main.cpp WITH_SOABI)
 target_link_libraries(_core PRIVATE pybind11::headers)

Makefile

@@ -59,6 +59,10 @@ pytest:
 	pytest tests/test_basic.py
 .PHONY: build
 
+restub:
+	pybind11-stubgen concave_hull._core -o stubs
+	cp stubs/concave_hull/_core.pyi src/concave_hull
+
 # conda create -y -n py36 python=3.6
 # conda create -y -n py37 python=3.7
 # conda create -y -n py38 python=3.8

docs/about/release-notes.md

@@ -10,6 +10,10 @@ To upgrade `concave_hull` to the latest version, use pip:
 pip install -U concave_hull
 ```
 
+## Version 0.0.8 (2024-10-03)
+
+*   Add typing stubs
+
 ## Version 0.0.7 (2024-01-06)
 
 *   Strip useless code

pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "scikit_build_core.build"
 
 [project]
 name = "concave_hull"
-version = "0.0.7"
+version = "0.0.8"
 url = "https://concave-hull.readthedocs.io"
 description="A very fast 2D concave hull algorithm"
 readme = "README.md"

src/concave_hull/_core.pyi

@@ -0,0 +1,66 @@
+"""
+
+        A very fast 2D concave hull algorithm
+        -------------------------------------
+
+        credits:
+            -   https://github.com/mapbox/concaveman
+            -   https://github.com/sadaszewski/concaveman-cpp
+            -   https://cp-algorithms.com/geometry/convex-hull.html#implementation
+
+"""
+from __future__ import annotations
+
+import numpy
+
+__all__ = [
+    "clockwise",
+    "colinear",
+    "concave_hull_indexes",
+    "convex_hull_indexes",
+    "orientation",
+    "wgs84_to_east_north",
+]
+
+def clockwise(
+    prev: numpy.ndarray[numpy.float64[2, 1]],
+    curr: numpy.ndarray[numpy.float64[2, 1]],
+    next: numpy.ndarray[numpy.float64[2, 1]],
+    *,
+    include_colinear: bool = False,
+) -> bool: ...
+def colinear(
+    prev: numpy.ndarray[numpy.float64[2, 1]],
+    curr: numpy.ndarray[numpy.float64[2, 1]],
+    next: numpy.ndarray[numpy.float64[2, 1]],
+) -> bool: ...
+def concave_hull_indexes(
+    points: numpy.ndarray[numpy.float64[m, 2]],
+    *,
+    convex_hull_indexes: numpy.ndarray[numpy.int32[m, 1]],
+    concavity: float = 2.0,
+    length_threshold: float = 0.0,
+) -> numpy.ndarray[numpy.int32[m, 1]]:
+    """
+    documents here: https://github.com/mapbox/concaveman
+    """
+
+def convex_hull_indexes(
+    points: numpy.ndarray[numpy.float64[m, 2], numpy.ndarray.flags.c_contiguous],
+    *,
+    include_colinear: bool = False,
+    order_only: bool = False,
+) -> numpy.ndarray[numpy.int32[m, 1]]: ...
+def orientation(
+    prev: numpy.ndarray[numpy.float64[2, 1]],
+    curr: numpy.ndarray[numpy.float64[2, 1]],
+    next: numpy.ndarray[numpy.float64[2, 1]],
+) -> int: ...
+def wgs84_to_east_north(
+    wgs84: numpy.ndarray[numpy.float64[m, 2], numpy.ndarray.flags.c_contiguous]
+) -> numpy.ndarray[numpy.float64[m, 2]]:
+    """
+    documents here: https://github.com/mapbox/cheap-ruler
+    """
+
+__version__: str = "0.0.8"