easybind 0.2.0__tar.gz → 0.2.3__tar.gz

{easybind-0.2.0 → easybind-0.2.3}/CMakeLists.txt

@@ -3,7 +3,6 @@ cmake_minimum_required(VERSION 3.25)
 project(easybind LANGUAGES CXX)
 
 include(GNUInstallDirs)
-include(FetchContent)
 
 set(CMAKE_CXX_STANDARD 20)
 set(CMAKE_CXX_STANDARD_REQUIRED ON)
@@ -26,27 +25,9 @@ else()
     message(FATAL_ERROR "Python imported target not found (expected Python::Module or Python::Python)")
 endif()
 
-# Nanobind - fetch so builds don't depend on a preinstalled CMake package.
-FetchContent_Declare(
-    nanobind
-    GIT_REPOSITORY https://github.com/wjakob/nanobind.git
-    GIT_TAG v2.12.0
-)
-FetchContent_MakeAvailable(nanobind)
-
-FetchContent_Declare(
-    magic_enum
-    GIT_REPOSITORY https://github.com/Neargye/magic_enum.git
-    GIT_TAG v0.9.7
-)
-FetchContent_MakeAvailable(magic_enum)
-
-FetchContent_Declare(
-    reflect_cpp
-    GIT_REPOSITORY https://github.com/getml/reflect-cpp.git
-    GIT_TAG v0.24.0
-)
-FetchContent_MakeAvailable(reflect_cpp)
+# Third-party sources: pins live in cmake/easybind_dependencies.cmake (also installed for consumers).
+include("${CMAKE_CURRENT_SOURCE_DIR}/cmake/easybind_dependencies.cmake")
+easybind_fetch_third_party_deps()
 
 # Some nanobind configurations don't automatically attach Python include dirs.
 foreach(_nb_tgt IN ITEMS nanobind nanobind_shared nanobind-static)
@@ -328,4 +309,9 @@ if(NOT EASYBIND_SKIP_INSTALL)
     install(FILES "${CMAKE_CURRENT_SOURCE_DIR}/NOTICE"
         DESTINATION easybind
     )
+    install(FILES
+        "${CMAKE_CURRENT_SOURCE_DIR}/cmake/easybind_dependencies.cmake"
+        "${CMAKE_CURRENT_SOURCE_DIR}/cmake/easybind_pip.cmake"
+        DESTINATION easybind/cmake
+    )
 endif()

{easybind-0.2.0 → easybind-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: easybind
-Version: 0.2.0
+Version: 0.2.3
 Summary: Self-registering nanobind helpers (import as easybind)
 Keywords: easybind,nanobind,bindings,pymergetic
 Author-Email: PymergeticOS Maintainers <raudzus@pymergetic.com>
@@ -64,18 +64,25 @@ The Python package is implemented as native extensions. It exposes:
 - `easybind.sample` (demo bindings)
 
 ## Build-time SDK
-`easybind` provides CMake helpers for hybrid extensions:
+Installed wheels ship CMake helpers under **`easybind/cmake/`**:
 
-- `easybind::build_interface` (INTERFACE): baseline C++20 + PIC + shared include paths
-- `easybind_add_extension(target ...)`: wraps `nanobind_add_module(... NB_SHARED ...)`
+- **`easybind_pip.cmake`** — `easybind_pip_setup()` finds Python, **`nanobind`** (pip), **`libeasybind`**, and include roots for `#include <easybind/...>`, then pulls in **`easybind_dependencies.cmake`**. Helpers: `easybind_pip_link_magic_enum(target)`, `easybind_pip_set_rpath_next_to_easybind(target easybind_pkg_dir)`.
+- **`easybind_dependencies.cmake`** — pins **nanobind**, **magic_enum**, **reflect-cpp** (same tags as this repo). Use **`easybind_fetch_third_party_deps()`** to pull all three, or **`easybind_fetch_nanobind()`** / **`easybind_fetch_magic_enum()`** / **`easybind_fetch_reflect_cpp()`** when you only need a subset (e.g. pip already provides nanobind, so call only **`easybind_fetch_magic_enum()`**).
+
+Typical consumer bootstrap:
 
-Example:
 ```cmake
-find_package(easybind CONFIG REQUIRED)
-easybind_add_extension(my_module src_bind/my_pkg/__cpp__/module.cpp)
-target_link_libraries(my_module PRIVATE easybind::easybind)
+find_package(Python REQUIRED COMPONENTS Interpreter Development.Module)
+execute_process(COMMAND "${Python_EXECUTABLE}" -c
+  "import pathlib, easybind; print(pathlib.Path(easybind.__file__).resolve().parent / 'cmake' / 'easybind_pip.cmake')"
+  OUTPUT_VARIABLE _eb_pip OUTPUT_STRIP_TRAILING_WHITESPACE COMMAND_ERROR_IS_FATAL ANY)
+include("${_eb_pip}")
+easybind_pip_setup()
+easybind_fetch_magic_enum()   # if you include easybind headers that need magic_enum
 ```
 
+When developing **inside** this repository, `easybind_add_extension(...)` is defined in the top-level `CMakeLists.txt` (not shipped in the wheel).
+
 ## Core idea
 - Each namespace/module defines a `ModuleNode` and a bind callback.
 - The module entry point calls `apply_init` to run the callback and recurse.

{easybind-0.2.0 → easybind-0.2.3}/README.md

@@ -35,18 +35,25 @@ The Python package is implemented as native extensions. It exposes:
 - `easybind.sample` (demo bindings)
 
 ## Build-time SDK
-`easybind` provides CMake helpers for hybrid extensions:
+Installed wheels ship CMake helpers under **`easybind/cmake/`**:
 
-- `easybind::build_interface` (INTERFACE): baseline C++20 + PIC + shared include paths
-- `easybind_add_extension(target ...)`: wraps `nanobind_add_module(... NB_SHARED ...)`
+- **`easybind_pip.cmake`** — `easybind_pip_setup()` finds Python, **`nanobind`** (pip), **`libeasybind`**, and include roots for `#include <easybind/...>`, then pulls in **`easybind_dependencies.cmake`**. Helpers: `easybind_pip_link_magic_enum(target)`, `easybind_pip_set_rpath_next_to_easybind(target easybind_pkg_dir)`.
+- **`easybind_dependencies.cmake`** — pins **nanobind**, **magic_enum**, **reflect-cpp** (same tags as this repo). Use **`easybind_fetch_third_party_deps()`** to pull all three, or **`easybind_fetch_nanobind()`** / **`easybind_fetch_magic_enum()`** / **`easybind_fetch_reflect_cpp()`** when you only need a subset (e.g. pip already provides nanobind, so call only **`easybind_fetch_magic_enum()`**).
+
+Typical consumer bootstrap:
 
-Example:
 ```cmake
-find_package(easybind CONFIG REQUIRED)
-easybind_add_extension(my_module src_bind/my_pkg/__cpp__/module.cpp)
-target_link_libraries(my_module PRIVATE easybind::easybind)
+find_package(Python REQUIRED COMPONENTS Interpreter Development.Module)
+execute_process(COMMAND "${Python_EXECUTABLE}" -c
+  "import pathlib, easybind; print(pathlib.Path(easybind.__file__).resolve().parent / 'cmake' / 'easybind_pip.cmake')"
+  OUTPUT_VARIABLE _eb_pip OUTPUT_STRIP_TRAILING_WHITESPACE COMMAND_ERROR_IS_FATAL ANY)
+include("${_eb_pip}")
+easybind_pip_setup()
+easybind_fetch_magic_enum()   # if you include easybind headers that need magic_enum
 ```
 
+When developing **inside** this repository, `easybind_add_extension(...)` is defined in the top-level `CMakeLists.txt` (not shipped in the wheel).
+
 ## Core idea
 - Each namespace/module defines a `ModuleNode` and a bind callback.
 - The module entry point calls `apply_init` to run the callback and recurse.

{easybind-0.2.0 → easybind-0.2.3}/RELEASING.md

@@ -37,3 +37,7 @@ Locally, a plain `python -m build` on Linux may still emit a bare `linux_x86_64`
 ## Submodule / monorepo note
 
 If this repo is a **git submodule** inside another project, **tags for versioning must exist on this repository’s own remote**, not only on the parent repo. Tag and release from the `easybind` repo (or push tags there after merging).
+
+## Downstream: cppdantic
+
+The **cppdantic** demo package depends on **easybind** with a compatible-release pin (`easybind~=A.B.C` in its `pyproject.toml`). **Release easybind to PyPI first**, then bump those pins in the cppdantic repo to the new **`A.B.C`** before tagging cppdantic. See **cppdantic**’s **`RELEASING.md`** for the full order.

easybind-0.2.3/cmake/easybind_dependencies.cmake

@@ -0,0 +1,56 @@
+# Single source of truth for FetchContent pins used by easybind and downstream CMake projects.
+# Include from the installed package: include("${EASYBIND_PKG_DIR}/cmake/easybind_dependencies.cmake")
+
+include_guard(GLOBAL)
+
+include(FetchContent)
+
+set(EASYBIND_NANOBIND_GIT_TAG "v2.12.0"
+    CACHE STRING "nanobind Git tag (align with easybind’s nanobind / PyPI pin)")
+set(EASYBIND_MAGIC_ENUM_GIT_TAG "v0.9.7" CACHE STRING "magic_enum Git tag")
+set(EASYBIND_REFLECT_CPP_GIT_TAG "v0.24.0" CACHE STRING "reflect-cpp Git tag")
+
+function(easybind_fetch_nanobind)
+  FetchContent_GetProperties(nanobind)
+  if(nanobind_POPULATED)
+    return()
+  endif()
+  FetchContent_Declare(
+    nanobind
+    GIT_REPOSITORY https://github.com/wjakob/nanobind.git
+    GIT_TAG "${EASYBIND_NANOBIND_GIT_TAG}"
+  )
+  FetchContent_MakeAvailable(nanobind)
+endfunction()
+
+function(easybind_fetch_magic_enum)
+  FetchContent_GetProperties(magic_enum)
+  if(magic_enum_POPULATED)
+    return()
+  endif()
+  FetchContent_Declare(
+    magic_enum
+    GIT_REPOSITORY https://github.com/Neargye/magic_enum.git
+    GIT_TAG "${EASYBIND_MAGIC_ENUM_GIT_TAG}"
+  )
+  FetchContent_MakeAvailable(magic_enum)
+endfunction()
+
+function(easybind_fetch_reflect_cpp)
+  FetchContent_GetProperties(reflect_cpp)
+  if(reflect_cpp_POPULATED)
+    return()
+  endif()
+  FetchContent_Declare(
+    reflect_cpp
+    GIT_REPOSITORY https://github.com/getml/reflect-cpp.git
+    GIT_TAG "${EASYBIND_REFLECT_CPP_GIT_TAG}"
+  )
+  FetchContent_MakeAvailable(reflect_cpp)
+endfunction()
+
+function(easybind_fetch_third_party_deps)
+  easybind_fetch_nanobind()
+  easybind_fetch_magic_enum()
+  easybind_fetch_reflect_cpp()
+endfunction()

easybind-0.2.3/cmake/easybind_pip.cmake

@@ -0,0 +1,79 @@
+# Helpers for CMake projects that depend on the pip-installed easybind package.
+# Bootstrap (once per project):
+#   find_package(Python REQUIRED COMPONENTS Interpreter Development.Module)
+#   execute_process(COMMAND "${Python_EXECUTABLE}" -c
+#     "import pathlib, easybind; print(pathlib.Path(easybind.__file__).resolve().parent / 'cmake' / 'easybind_pip.cmake')"
+#     OUTPUT_VARIABLE _eb_pip OUTPUT_STRIP_TRAILING_WHITESPACE COMMAND_ERROR_IS_FATAL ANY)
+#   include("${_eb_pip}")
+#   easybind_pip_setup()
+
+# Must run before include_guard: guard skips the whole file on re-include, and this must be this file’s directory.
+get_filename_component(_EASYBIND_PIP_CMAKE_DIR "${CMAKE_CURRENT_LIST_FILE}" DIRECTORY)
+include_guard(GLOBAL)
+
+function(easybind_pip_setup)
+  if(NOT Python_FOUND)
+    find_package(Python REQUIRED COMPONENTS Interpreter Development.Module)
+  endif()
+
+  execute_process(
+    COMMAND "${Python_EXECUTABLE}" -m nanobind --cmake_dir
+    OUTPUT_STRIP_TRAILING_WHITESPACE
+    OUTPUT_VARIABLE nanobind_ROOT
+    COMMAND_ERROR_IS_FATAL ANY
+  )
+  find_package(nanobind CONFIG REQUIRED)
+
+  # This file lives in …/site-packages/easybind/cmake/
+  get_filename_component(EASYBIND_PKG_DIR "${_EASYBIND_PIP_CMAKE_DIR}/.." ABSOLUTE)
+  get_filename_component(EASYBIND_INCLUDE_ROOT "${EASYBIND_PKG_DIR}/.." ABSOLUTE)
+
+  # Prefer explicit path — find_library can fail with NO_DEFAULT_PATH on some setups.
+  if(APPLE)
+    set(_eb_core "${EASYBIND_PKG_DIR}/libeasybind.dylib")
+  elseif(UNIX)
+    set(_eb_core "${EASYBIND_PKG_DIR}/libeasybind.so")
+  else()
+    find_library(
+      _eb_core
+      NAMES easybind
+      PATHS "${EASYBIND_PKG_DIR}"
+      NO_DEFAULT_PATH
+      REQUIRED
+    )
+  endif()
+  if(NOT EXISTS "${_eb_core}")
+    message(FATAL_ERROR "easybind core library not found at ${_eb_core} (EASYBIND_PKG_DIR=${EASYBIND_PKG_DIR})")
+  endif()
+  set(EASYBIND_CORE_LIB "${_eb_core}")
+
+  include("${_EASYBIND_PIP_CMAKE_DIR}/easybind_dependencies.cmake")
+
+  set(EASYBIND_PKG_DIR "${EASYBIND_PKG_DIR}" PARENT_SCOPE)
+  set(EASYBIND_INCLUDE_ROOT "${EASYBIND_INCLUDE_ROOT}" PARENT_SCOPE)
+  set(EASYBIND_CORE_LIB "${EASYBIND_CORE_LIB}" PARENT_SCOPE)
+endfunction()
+
+function(easybind_pip_link_magic_enum target)
+  if(TARGET magic_enum::magic_enum)
+    target_link_libraries(${target} PRIVATE magic_enum::magic_enum)
+  else()
+    target_include_directories(${target} PRIVATE "${magic_enum_SOURCE_DIR}/include")
+  endif()
+endfunction()
+
+# RPATH so the extension finds libeasybind (and siblings) next to the pip easybind package.
+# Pass the same EASYBIND_PKG_DIR you got from easybind_pip_setup().
+function(easybind_pip_set_rpath_next_to_easybind target easybind_pkg_dir)
+  if(APPLE)
+    set(_install "@loader_path/../easybind")
+    set(_build "@loader_path;@loader_path/../easybind")
+  else()
+    set(_install "$ORIGIN/../easybind")
+    set(_build "$ORIGIN;${easybind_pkg_dir}")
+  endif()
+  set_target_properties(${target} PROPERTIES
+    INSTALL_RPATH "${_install}"
+    BUILD_RPATH "${_build}"
+  )
+endfunction()

easybind-0.2.0/cmake/easybindConfig.cmake.in

@@ -1,57 +0,0 @@
-@PACKAGE_INIT@
-
-include(CMakeFindDependencyMacro)
-
-find_dependency(Python COMPONENTS Interpreter Development.Module)
-
-set(EASYBIND_PYTHON_TARGET "")
-if(TARGET Python::Module)
-  set(EASYBIND_PYTHON_TARGET Python::Module)
-elseif(TARGET Python::Python)
-  set(EASYBIND_PYTHON_TARGET Python::Python)
-else()
-  message(FATAL_ERROR "Python imported target not found (expected Python::Module or Python::Python)")
-endif()
-
-find_dependency(nanobind CONFIG QUIET)
-if(NOT nanobind_FOUND)
-  include(FetchContent)
-  FetchContent_Declare(
-    nanobind
-    GIT_REPOSITORY https://github.com/wjakob/nanobind.git
-    GIT_TAG v2.9.2
-  )
-  FetchContent_MakeAvailable(nanobind)
-endif()
-
-find_path(EASYBIND_BOOST_INCLUDE_DIR boost/asio.hpp)
-if(NOT EASYBIND_BOOST_INCLUDE_DIR)
-  include(FetchContent)
-  set(_easybind_boost_ver "1.85.0")
-  string(REPLACE "." "_" _easybind_boost_ver_us "${_easybind_boost_ver}")
-  set(_easybind_boost_url "https://archives.boost.io/release/${_easybind_boost_ver}/source/boost_${_easybind_boost_ver_us}.tar.gz")
-  FetchContent_Declare(easybind_boost URL ${_easybind_boost_url})
-  FetchContent_MakeAvailable(easybind_boost)
-  set(EASYBIND_BOOST_INCLUDE_DIR "${easybind_boost_SOURCE_DIR}")
-endif()
-
-include("${CMAKE_CURRENT_LIST_DIR}/easybindTargets.cmake")
-
-function(easybind_add_extension target_name)
-    nanobind_add_module(${target_name} NB_SHARED ${ARGN})
-    target_link_libraries(${target_name} PRIVATE easybind::build_interface)
-    target_link_libraries(${target_name} PRIVATE ${EASYBIND_PYTHON_TARGET})
-    target_include_directories(${target_name} PRIVATE ${EASYBIND_BOOST_INCLUDE_DIR})
-    target_compile_definitions(${target_name} PRIVATE BOOST_ERROR_CODE_HEADER_ONLY=1 BOOST_SYSTEM_NO_DEPRECATED=1)
-    if(APPLE)
-        set_target_properties(${target_name} PROPERTIES
-            BUILD_RPATH "@loader_path"
-            INSTALL_RPATH "@loader_path"
-        )
-    else()
-        set_target_properties(${target_name} PROPERTIES
-            BUILD_RPATH "$ORIGIN"
-            INSTALL_RPATH "$ORIGIN"
-        )
-    endif()
-endfunction()