hatch-cpp 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

hatch_cpp/__init__.py

@@ -1 +1,5 @@
-__version__ = "0.1.0"
+__version__ = "0.1.2"
+
+from .hooks import hatch_register_build_hook
+from .plugin import HatchCppBuildHook
+from .structs import *

hatch_cpp/plugin.py

@@ -3,11 +3,11 @@ from __future__ import annotations
 import logging
 import os
 import typing as t
-from dataclasses import fields
 
 from hatchling.builders.hooks.plugin.interface import BuildHookInterface
 
-from .structs import HatchCppBuildConfig, HatchCppBuildPlan, HatchCppLibrary, HatchCppPlatform
+from .structs import HatchCppBuildConfig, HatchCppBuildPlan
+from .utils import import_string
 
 __all__ = ("HatchCppBuildHook",)
 
@@ -20,66 +20,48 @@ class HatchCppBuildHook(BuildHookInterface[HatchCppBuildConfig]):
 
     def initialize(self, version: str, _: dict[str, t.Any]) -> None:
         """Initialize the plugin."""
+        # Log some basic information
+        self._logger.info("Initializing hatch-cpp plugin version %s", version)
         self._logger.info("Running hatch-cpp")
 
+        # Only run if creating wheel
+        # TODO: Add support for specify sdist-plan
         if self.target_name != "wheel":
             self._logger.info("ignoring target name %s", self.target_name)
             return
 
+        # Skip if SKIP_HATCH_CPP is set
+        # TODO: Support CLI once https://github.com/pypa/hatch/pull/1743
         if os.getenv("SKIP_HATCH_CPP"):
             self._logger.info("Skipping the build hook since SKIP_HATCH_CPP was set")
             return
 
-        kwargs = {k.replace("-", "_"): v if not isinstance(v, bool) else str(v) for k, v in self.config.items()}
-        available_fields = [f.name for f in fields(HatchCppBuildConfig)]
-        for key in list(kwargs):
-            if key not in available_fields:
-                del kwargs[key]
-        config = HatchCppBuildConfig(**kwargs)
-
-        library_kwargs = [
-            {k.replace("-", "_"): v if not isinstance(v, bool) else str(v) for k, v in library_kwargs.items()} for library_kwargs in config.libraries
-        ]
-        libraries = [HatchCppLibrary(**library_kwargs) for library_kwargs in library_kwargs]
-        platform = HatchCppPlatform.default()
-        if config.toolchain == "raw":
-            # g++ basic-project/basic.cpp -I. -I/opt/homebrew/opt/python@3.11/Frameworks/Python.framework/Versions/3.11/include/python3.11/  -undefined dynamic_lookup -fPIC -shared -o extension.so
-            build_plan = HatchCppBuildPlan(libraries=libraries, platform=platform)
-            build_plan.generate()
-            build_plan.execute(verbose=config.verbose)
-        # build_kwargs = config.build_kwargs
-        # if version == "editable":
-        #     build_kwargs = config.editable_build_kwargs or build_kwargs
-
-        # should_skip_build = False
-        # if not config.build_function:
-        #     log.warning("No build function found")
-        #     should_skip_build = True
-
-        # elif config.skip_if_exists and version == "standard":
-        #     should_skip_build = should_skip(config.skip_if_exists)
-        #     if should_skip_build:
-        #         log.info("Skip-if-exists file(s) found")
-
-        # # Get build function and call it with normalized parameter names.
-        # if not should_skip_build and config.build_function:
-        #     build_func = get_build_func(config.build_function)
-        #     build_kwargs = normalize_kwargs(build_kwargs)
-        #     log.info("Building with %s", config.build_function)
-        #     log.info("With kwargs: %s", build_kwargs)
-        #     try:
-        #         build_func(self.target_name, version, **build_kwargs)
-        #     except Exception as e:
-        #         if version == "editable" and config.optional_editable_build.lower() == "true":
-        #             warnings.warn(f"Encountered build error:\n{e}", stacklevel=2)
-        #         else:
-        #             raise e
-        # else:
-        #     log.info("Skipping build")
-
-        # # Ensure targets in distributable dists.
-        # if version == "standard":
-        #     ensure_targets(config.ensured_targets)
-
-        self._logger.info("Finished running hatch-cpp")
-        return
+        # Get build config class or use default
+        build_config_class = import_string(self.config["build-config-class"]) if "build-config-class" in self.config else HatchCppBuildConfig
+
+        # Instantiate build config
+        config = build_config_class(**self.config)
+
+        # Grab libraries and platform
+        libraries = config.libraries
+        platform = config.platform
+
+        # Get build plan class or use default
+        build_plan_class = import_string(self.config["build-plan-class"]) if "build-plan-class" in self.config else HatchCppBuildPlan
+
+        # Instantiate builder
+        build_plan = build_plan_class(libraries=libraries, platform=platform)
+
+        # Generate commands
+        build_plan.generate()
+
+        # Log commands if in verbose mode
+        if config.verbose:
+            for command in build_plan.commands:
+                self._logger.warning(command)
+
+        # Execute build plan
+        build_plan.execute()
+
+        # Perform any cleanup actions
+        build_plan.cleanup()

hatch_cpp/structs.py

@@ -1,12 +1,13 @@
 from __future__ import annotations
 
-from dataclasses import dataclass, field
 from os import environ, system
-from sys import platform as sys_platform
+from pathlib import Path
+from shutil import which
+from sys import executable, platform as sys_platform
 from sysconfig import get_path
-from typing import Literal
+from typing import List, Literal, Optional
 
-from hatchling.builders.config import BuilderConfig
+from pydantic import BaseModel, Field
 
 __all__ = (
     "HatchCppBuildConfig",
@@ -15,53 +16,47 @@ __all__ = (
     "HatchCppBuildPlan",
 )
 
-Platform = Literal["linux", "darwin", "win32"]
+BuildType = Literal["debug", "release"]
 CompilerToolchain = Literal["gcc", "clang", "msvc"]
+Language = Literal["c", "c++"]
+Binding = Literal["cpython", "pybind11", "nanobind"]
+Platform = Literal["linux", "darwin", "win32"]
 PlatformDefaults = {
-    "linux": {"CC": "gcc", "CXX": "g++"},
-    "darwin": {"CC": "clang", "CXX": "clang++"},
-    "win32": {"CC": "cl", "CXX": "cl"},
+    "linux": {"CC": "gcc", "CXX": "g++", "LD": "ld"},
+    "darwin": {"CC": "clang", "CXX": "clang++", "LD": "ld"},
+    "win32": {"CC": "cl", "CXX": "cl", "LD": "link"},
 }
 
 
-@dataclass
-class HatchCppBuildConfig(BuilderConfig):
-    """Build config values for Hatch C++ Builder."""
+class HatchCppLibrary(BaseModel):
+    """A C++ library."""
 
-    toolchain: str | None = field(default="raw")
-    libraries: list[dict[str, str]] = field(default_factory=list)
-    verbose: bool | None = field(default=False)
-    # build_function: str | None = None
-    # build_kwargs: t.Mapping[str, str] = field(default_factory=dict)
-    # editable_build_kwargs: t.Mapping[str, str] = field(default_factory=dict)
-    # ensured_targets: list[str] = field(default_factory=list)
-    # skip_if_exists: list[str] = field(default_factory=list)
+    name: str
+    sources: List[str]
+    language: Language = "c++"
 
+    binding: Binding = "cpython"
+    std: Optional[str] = None
 
-@dataclass
-class HatchCppLibrary(object):
-    """A C++ library."""
+    include_dirs: List[str] = Field(default_factory=list, alias="include-dirs")
+    library_dirs: List[str] = Field(default_factory=list, alias="library-dirs")
+    libraries: List[str] = Field(default_factory=list)
 
-    name: str
-    sources: list[str]
+    extra_compile_args: List[str] = Field(default_factory=list, alias="extra-compile-args")
+    extra_link_args: List[str] = Field(default_factory=list, alias="extra-link-args")
+    extra_objects: List[str] = Field(default_factory=list, alias="extra-objects")
 
-    include_dirs: list[str] = field(default_factory=list)
-    library_dirs: list[str] = field(default_factory=list)
-    libraries: list[str] = field(default_factory=list)
-    extra_compile_args: list[str] = field(default_factory=list)
-    extra_link_args: list[str] = field(default_factory=list)
-    extra_objects: list[str] = field(default_factory=list)
-    define_macros: list[str] = field(default_factory=list)
-    undef_macros: list[str] = field(default_factory=list)
+    define_macros: List[str] = Field(default_factory=list, alias="define-macros")
+    undef_macros: List[str] = Field(default_factory=list, alias="undef-macros")
 
-    export_symbols: list[str] = field(default_factory=list)
-    depends: list[str] = field(default_factory=list)
+    export_symbols: List[str] = Field(default_factory=list, alias="export-symbols")
+    depends: List[str] = Field(default_factory=list)
 
 
-@dataclass
-class HatchCppPlatform(object):
+class HatchCppPlatform(BaseModel):
     cc: str
     cxx: str
+    ld: str
     platform: Platform
     toolchain: CompilerToolchain
 
@@ -70,6 +65,7 @@ class HatchCppPlatform(object):
         platform = environ.get("HATCH_CPP_PLATFORM", sys_platform)
         CC = environ.get("CC", PlatformDefaults[platform]["CC"])
         CXX = environ.get("CXX", PlatformDefaults[platform]["CXX"])
+        LD = environ.get("LD", PlatformDefaults[platform]["LD"])
         if "gcc" in CC and "g++" in CXX:
             toolchain = "gcc"
         elif "clang" in CC and "clang++" in CXX:
@@ -78,69 +74,145 @@ class HatchCppPlatform(object):
             toolchain = "msvc"
         else:
             raise Exception(f"Unrecognized toolchain: {CC}, {CXX}")
-        return HatchCppPlatform(cc=CC, cxx=CXX, platform=platform, toolchain=toolchain)
 
-    def get_flags(self, library: HatchCppLibrary) -> str:
+        # Customizations
+        if which("ccache") and not environ.get("HATCH_CPP_DISABLE_CCACHE"):
+            CC = f"ccache {CC}"
+            CXX = f"ccache {CXX}"
+
+        # https://github.com/rui314/mold/issues/647
+        # if which("ld.mold"):
+        #     LD = which("ld.mold")
+        # elif which("ld.lld"):
+        #     LD = which("ld.lld")
+        return HatchCppPlatform(cc=CC, cxx=CXX, ld=LD, platform=platform, toolchain=toolchain)
+
+    def get_compile_flags(self, library: HatchCppLibrary, build_type: BuildType = "release") -> str:
         flags = ""
+
+        # Python.h
+        library.include_dirs.append(get_path("include"))
+
+        if library.binding == "pybind11":
+            import pybind11
+
+            library.include_dirs.append(pybind11.get_include())
+            if not library.std:
+                library.std = "c++11"
+        elif library.binding == "nanobind":
+            import nanobind
+
+            library.include_dirs.append(nanobind.include_dir())
+            if not library.std:
+                library.std = "c++17"
+            library.sources.append(str(Path(nanobind.include_dir()).parent / "src" / "nb_combined.cpp"))
+            library.include_dirs.append(str((Path(nanobind.include_dir()).parent / "ext" / "robin_map" / "include")))
+
         if self.toolchain == "gcc":
-            flags = f"-I{get_path('include')}"
             flags += " " + " ".join(f"-I{d}" for d in library.include_dirs)
-            flags += " -fPIC -shared"
+            flags += " -fPIC"
             flags += " " + " ".join(library.extra_compile_args)
+            flags += " " + " ".join(f"-D{macro}" for macro in library.define_macros)
+            flags += " " + " ".join(f"-U{macro}" for macro in library.undef_macros)
+            if library.std:
+                flags += f" -std={library.std}"
+        elif self.toolchain == "clang":
+            flags += " ".join(f"-I{d}" for d in library.include_dirs)
+            flags += " -fPIC"
+            flags += " " + " ".join(library.extra_compile_args)
+            flags += " " + " ".join(f"-D{macro}" for macro in library.define_macros)
+            flags += " " + " ".join(f"-U{macro}" for macro in library.undef_macros)
+            if library.std:
+                flags += f" -std={library.std}"
+        elif self.toolchain == "msvc":
+            flags += " ".join(f"/I{d}" for d in library.include_dirs)
+            flags += " " + " ".join(library.extra_compile_args)
+            flags += " " + " ".join(library.extra_link_args)
+            flags += " " + " ".join(library.extra_objects)
+            flags += " " + " ".join(f"/D{macro}" for macro in library.define_macros)
+            flags += " " + " ".join(f"/U{macro}" for macro in library.undef_macros)
+            flags += " /EHsc /DWIN32"
+            if library.std:
+                flags += f" /std:{library.std}"
+        # clean
+        while flags.count("  "):
+            flags = flags.replace("  ", " ")
+        return flags
+
+    def get_link_flags(self, library: HatchCppLibrary, build_type: BuildType = "release") -> str:
+        flags = ""
+        if self.toolchain == "gcc":
+            flags += " -shared"
             flags += " " + " ".join(library.extra_link_args)
             flags += " " + " ".join(library.extra_objects)
             flags += " " + " ".join(f"-l{lib}" for lib in library.libraries)
             flags += " " + " ".join(f"-L{lib}" for lib in library.library_dirs)
-            flags += " " + " ".join(f"-D{macro}" for macro in library.define_macros)
-            flags += " " + " ".join(f"-U{macro}" for macro in library.undef_macros)
             flags += f" -o {library.name}.so"
+            if self.platform == "darwin":
+                flags += " -undefined dynamic_lookup"
+            if "mold" in self.ld:
+                flags += f" -fuse-ld={self.ld}"
+            elif "lld" in self.ld:
+                flags += " -fuse-ld=lld"
         elif self.toolchain == "clang":
-            flags = f"-I{get_path('include')} "
-            flags += " ".join(f"-I{d}" for d in library.include_dirs)
-            flags += " -undefined dynamic_lookup -fPIC -shared"
-            flags += " " + " ".join(library.extra_compile_args)
+            flags += " -shared"
             flags += " " + " ".join(library.extra_link_args)
             flags += " " + " ".join(library.extra_objects)
             flags += " " + " ".join(f"-l{lib}" for lib in library.libraries)
             flags += " " + " ".join(f"-L{lib}" for lib in library.library_dirs)
-            flags += " " + " ".join(f"-D{macro}" for macro in library.define_macros)
-            flags += " " + " ".join(f"-U{macro}" for macro in library.undef_macros)
             flags += f" -o {library.name}.so"
+            if self.platform == "darwin":
+                flags += " -undefined dynamic_lookup"
+            if "mold" in self.ld:
+                flags += f" -fuse-ld={self.ld}"
+            elif "lld" in self.ld:
+                flags += " -fuse-ld=lld"
         elif self.toolchain == "msvc":
-            flags = f"/I{get_path('include')} "
-            flags += " ".join(f"/I{d}" for d in library.include_dirs)
-            flags += " /LD"
-            flags += " " + " ".join(library.extra_compile_args)
             flags += " " + " ".join(library.extra_link_args)
             flags += " " + " ".join(library.extra_objects)
+            flags += " /LD"
+            flags += f" /Fe:{library.name}.pyd"
+            flags += " /link /DLL"
+            if (Path(executable).parent / "libs").exists():
+                flags += f" /LIBPATH:{str(Path(executable).parent / 'libs')}"
             flags += " " + " ".join(f"{lib}.lib" for lib in library.libraries)
             flags += " " + " ".join(f"/LIBPATH:{lib}" for lib in library.library_dirs)
-            flags += " " + " ".join(f"/D{macro}" for macro in library.define_macros)
-            flags += " " + " ".join(f"/U{macro}" for macro in library.undef_macros)
-            flags += f" /Fo{library.name}.obj"
-            flags += f" /Fe{library.name}.pyd"
         # clean
         while flags.count("  "):
             flags = flags.replace("  ", " ")
         return flags
 
 
-@dataclass
-class HatchCppBuildPlan(object):
-    libraries: list[HatchCppLibrary] = field(default_factory=list)
-    platform: HatchCppPlatform = field(default_factory=HatchCppPlatform.default)
-    commands: list[str] = field(default_factory=list)
+class HatchCppBuildPlan(BaseModel):
+    build_type: BuildType = "release"
+    libraries: List[HatchCppLibrary] = Field(default_factory=list)
+    platform: HatchCppPlatform = Field(default_factory=HatchCppPlatform.default)
+    commands: List[str] = Field(default_factory=list)
 
     def generate(self):
         self.commands = []
         for library in self.libraries:
-            flags = self.platform.get_flags(library)
-            self.commands.append(f"{self.platform.cc} {' '.join(library.sources)} {flags}")
+            compile_flags = self.platform.get_compile_flags(library, self.build_type)
+            link_flags = self.platform.get_link_flags(library, self.build_type)
+            self.commands.append(
+                f"{self.platform.cc if library.language == 'c' else self.platform.cxx} {' '.join(library.sources)} {compile_flags} {link_flags}"
+            )
         return self.commands
 
-    def execute(self, verbose: bool = True):
+    def execute(self):
         for command in self.commands:
-            if verbose:
-                print(f"Running command: {command}")
             system(command)
         return self.commands
+
+    def cleanup(self):
+        if self.platform.platform == "win32":
+            for temp_obj in Path(".").glob("*.obj"):
+                temp_obj.unlink()
+
+
+class HatchCppBuildConfig(BaseModel):
+    """Build config values for Hatch C++ Builder."""
+
+    verbose: Optional[bool] = Field(default=False)
+    libraries: List[HatchCppLibrary] = Field(default_factory=list)
+    platform: Optional[HatchCppPlatform] = Field(default_factory=HatchCppPlatform.default)

hatch_cpp/tests/test_project_basic/cpp/{basic-project → project}/basic.cpp

@@ -1,4 +1,4 @@
-#include "basic-project/basic.hpp"
+#include "project/basic.hpp"
 
 PyObject* hello(PyObject*, PyObject*) {
     return PyUnicode_FromString("A string");

hatch_cpp/tests/test_project_basic/pyproject.toml

@@ -14,50 +14,22 @@ dependencies = [
 
 [tool.hatch.build]
 artifacts = [
-    "basic_project/*.dll",
-    "basic_project/*.dylib",
-    "basic_project/*.so",
+    "project/*.dll",
+    "project/*.dylib",
+    "project/*.so",
 ]
 
 [tool.hatch.build.sources]
 src = "/"
 
 [tool.hatch.build.targets.sdist]
-packages = ["basic_project"]
+packages = ["project"]
 
 [tool.hatch.build.targets.wheel]
-packages = ["basic_project"]
+packages = ["project"]
 
 [tool.hatch.build.hooks.hatch-cpp]
 verbose = true
 libraries = [
-    {name = "basic_project/extension", sources = ["cpp/basic-project/basic.cpp"], include-dirs = ["cpp"]}
+    {name = "project/extension", sources = ["cpp/project/basic.cpp"], include-dirs = ["cpp"]}
 ]
-
-# build-function = "hatch_cpp.cpp_builder"
-
-# [tool.hatch.build.hooks.defaults]
-# build-type = "release"
-
-# [tool.hatch.build.hooks.env-vars]
-# TODO: these will all be available via
-# CLI after https://github.com/pypa/hatch/pull/1743
-# e.g. --hatch-cpp-build-type=debug
-# build-type = "BUILD_TYPE"
-# ccache = "USE_CCACHE"
-# manylinux = "MANYLINUX"
-# vcpkg = "USE_VCPKG"
-
-# [tool.hatch.build.hooks.cmake]
-
-# [tool.hatch.build.hooks.vcpkg]
-# triplets = {linux="x64-linux", macos="x64-osx", windows="x64-windows-static-md"}
-# clone = true
-# update = true
-
-# [tool.hatch.build.hooks.hatch-cpp.build-kwargs]
-# path = "cpp"
-
-[tool.pytest.ini_options]
-asyncio_mode = "strict"
-testpaths = "basic_project/tests"

hatch_cpp/tests/test_project_nanobind/cpp/project/basic.cpp

@@ -0,0 +1,2 @@
+#include "project/basic.hpp"
+

hatch_cpp/tests/test_project_nanobind/cpp/project/basic.hpp

@@ -0,0 +1,7 @@
+#pragma once
+#include <nanobind/nanobind.h>
+#include <nanobind/stl/string.h>
+
+NB_MODULE(extension, m) {
+    m.def("hello", []() { return "A string"; });
+}

hatch_cpp/tests/test_project_nanobind/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["hatchling>=1.20"]
+build-backend = "hatchling.build"
+
+[project]
+name = "hatch-cpp-test-project-basic"
+description = "Basic test project for hatch-cpp"
+version = "0.1.0"
+requires-python = ">=3.9"
+dependencies = [
+    "hatchling>=1.20",
+    "hatch-cpp",
+]
+
+[tool.hatch.build]
+artifacts = [
+    "project/*.dll",
+    "project/*.dylib",
+    "project/*.so",
+]
+
+[tool.hatch.build.sources]
+src = "/"
+
+[tool.hatch.build.targets.sdist]
+packages = ["project"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["project"]
+
+[tool.hatch.build.hooks.hatch-cpp]
+verbose = true
+libraries = [
+    {name = "project/extension", sources = ["cpp/project/basic.cpp"], include-dirs = ["cpp"], binding = "nanobind"},
+]

hatch_cpp/tests/test_project_override_classes/cpp/project/basic.cpp

@@ -0,0 +1,5 @@
+#include "project/basic.hpp"
+
+PyObject* hello(PyObject*, PyObject*) {
+    return PyUnicode_FromString("A string");
+}

hatch_cpp/tests/test_project_override_classes/cpp/project/basic.hpp

@@ -0,0 +1,17 @@
+#pragma once
+#include "Python.h"
+
+PyObject* hello(PyObject*, PyObject*);
+
+static PyMethodDef extension_methods[] = {
+  {"hello", (PyCFunction)hello, METH_NOARGS},
+  {nullptr, nullptr, 0, nullptr}
+};
+
+static PyModuleDef extension_module = {
+  PyModuleDef_HEAD_INIT, "extension", "extension", -1, extension_methods};
+
+PyMODINIT_FUNC PyInit_extension(void) {
+  Py_Initialize();
+  return PyModule_Create(&extension_module);
+}

hatch_cpp/tests/test_project_override_classes/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["hatchling>=1.20"]
+build-backend = "hatchling.build"
+
+[project]
+name = "hatch-cpp-test-project-basic"
+description = "Basic test project for hatch-cpp"
+version = "0.1.0"
+requires-python = ">=3.9"
+dependencies = [
+    "hatchling>=1.20",
+    "hatch-cpp",
+]
+
+[tool.hatch.build]
+artifacts = [
+    "project/*.dll",
+    "project/*.dylib",
+    "project/*.so",
+]
+
+[tool.hatch.build.sources]
+src = "/"
+
+[tool.hatch.build.targets.sdist]
+packages = ["project"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["project"]
+
+[tool.hatch.build.hooks.hatch-cpp]
+build-config-class = "hatch_cpp.HatchCppBuildConfig"
+build-plan-class = "hatch_cpp.HatchCppBuildPlan"
+verbose = true
+libraries = [
+    {name = "project/extension", sources = ["cpp/project/basic.cpp"], include-dirs = ["cpp"]}
+]

hatch_cpp/tests/test_project_pybind/cpp/project/basic.cpp

@@ -0,0 +1,6 @@
+#include "project/basic.hpp"
+
+std::string hello() {
+    return "A string";
+}
+

hatch_cpp/tests/test_project_pybind/cpp/project/basic.hpp

@@ -0,0 +1,9 @@
+#pragma once
+#include <pybind11/pybind11.h>
+#include <string>
+
+std::string hello();
+
+PYBIND11_MODULE(extension, m) {
+    m.def("hello", &hello);
+}

hatch_cpp/tests/test_project_pybind/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["hatchling>=1.20"]
+build-backend = "hatchling.build"
+
+[project]
+name = "hatch-cpp-test-project-basic"
+description = "Basic test project for hatch-cpp"
+version = "0.1.0"
+requires-python = ">=3.9"
+dependencies = [
+    "hatchling>=1.20",
+    "hatch-cpp",
+]
+
+[tool.hatch.build]
+artifacts = [
+    "project/*.dll",
+    "project/*.dylib",
+    "project/*.so",
+]
+
+[tool.hatch.build.sources]
+src = "/"
+
+[tool.hatch.build.targets.sdist]
+packages = ["project"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["project"]
+
+[tool.hatch.build.hooks.hatch-cpp]
+verbose = true
+libraries = [
+    {name = "project/extension", sources = ["cpp/project/basic.cpp"], include-dirs = ["cpp"], binding="pybind11"},
+]

hatch_cpp/tests/test_projects.py

@@ -0,0 +1,41 @@
+from os import listdir
+from pathlib import Path
+from shutil import rmtree
+from subprocess import check_call
+from sys import modules, path, platform
+
+import pytest
+
+
+class TestProject:
+    @pytest.mark.parametrize("project", ["test_project_basic", "test_project_override_classes", "test_project_pybind", "test_project_nanobind"])
+    def test_basic(self, project):
+        # cleanup
+        rmtree(f"hatch_cpp/tests/{project}/project/extension.so", ignore_errors=True)
+        rmtree(f"hatch_cpp/tests/{project}/project/extension.pyd", ignore_errors=True)
+        modules.pop("project", None)
+        modules.pop("project.extension", None)
+
+        # compile
+        check_call(
+            [
+                "hatchling",
+                "build",
+                "--hooks-only",
+            ],
+            cwd=f"hatch_cpp/tests/{project}",
+        )
+
+        # assert built
+
+        if platform == "win32":
+            assert "extension.pyd" in listdir(f"hatch_cpp/tests/{project}/project")
+        else:
+            assert "extension.so" in listdir(f"hatch_cpp/tests/{project}/project")
+
+        # import
+        here = Path(__file__).parent / project
+        path.insert(0, str(here))
+        import project.extension
+
+        assert project.extension.hello() == "A string"

hatch_cpp/utils.py

@@ -1,5 +1,17 @@
 from __future__ import annotations
 
+from functools import lru_cache
+
+from pydantic import ImportString, TypeAdapter
+
+_import_string_adapter = TypeAdapter(ImportString)
+
+
+@lru_cache(maxsize=None)
+def import_string(input_string: str):
+    return _import_string_adapter.validate_python(input_string)
+
+
 # import multiprocessing
 # import os
 # import os.path

{hatch_cpp-0.1.0.dist-info → hatch_cpp-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hatch-cpp
-Version: 0.1.0
+Version: 0.1.2
 Summary: Hatch plugin for C++ builds
 Project-URL: Repository, https://github.com/python-project-templates/hatch-cpp
 Project-URL: Homepage, https://github.com/python-project-templates/hatch-cpp
@@ -20,10 +20,13 @@ Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Requires-Python: >=3.9
 Requires-Dist: hatchling>=1.20
+Requires-Dist: pydantic
 Provides-Extra: develop
 Requires-Dist: build; extra == 'develop'
 Requires-Dist: bump-my-version; extra == 'develop'
 Requires-Dist: check-manifest; extra == 'develop'
+Requires-Dist: nanobind; extra == 'develop'
+Requires-Dist: pybind11; extra == 'develop'
 Requires-Dist: pytest; extra == 'develop'
 Requires-Dist: pytest-cov; extra == 'develop'
 Requires-Dist: ruff<0.9,>=0.3; extra == 'develop'
@@ -42,5 +45,27 @@ Hatch plugin for C++ builds
 
 ## Overview
 
+A simple, extensible C++ build plugin for [hatch](https://hatch.pypa.io/latest/).
+
+```toml
+[tool.hatch.build.hooks.hatch-cpp]
+libraries = [
+    {name = "project/extension", sources = ["cpp/project/basic.cpp"], include-dirs = ["cpp"]}
+]
+```
+
+For more complete systems, see:
+- [scikit-build-core](https://github.com/scikit-build/scikit-build-core)
+- [setuptools](https://setuptools.pypa.io/en/latest/userguide/ext_modules.html)
+
+## Environment Variables
+| Name | Default | Description |
+|:-----|:--------|:------------|
+|`CC`| | |
+|`CXX`| | |
+|`LD`| | |
+|`HATCH_CPP_PLATFORM`| | |
+|`HATCH_CPP_DISABLE_CCACHE`| | |
+
 > [!NOTE]
 > This library was generated using [copier](https://copier.readthedocs.io/en/stable/) from the [Base Python Project Template repository](https://github.com/python-project-templates/base).

hatch_cpp-0.1.2.dist-info/RECORD

@@ -0,0 +1,30 @@
+hatch_cpp/__init__.py,sha256=TkBacTiDIMCQw8W4szqksyUlwA-f-XuC7FxVqE5SSRQ,129
+hatch_cpp/hooks.py,sha256=SQkF5WJIgzw-8rvlTzuQvBqdP6K3fHgnh6CZOZFag50,203
+hatch_cpp/plugin.py,sha256=ZH-RmbaC9z9GMbOu9qWzWe6ht42noZLqBzj7VT-GGYQ,2240
+hatch_cpp/structs.py,sha256=haFLBwb3T1YOC-ZjsbPB_X2Hv8whp4WMu3MrAIMdLkg,8857
+hatch_cpp/utils.py,sha256=topOiT6biVzisNAEKHvYzU-JdA56B3LA61jbU9fjAEQ,4444
+hatch_cpp/tests/test_all.py,sha256=zxMSmbNDdS_pIhjBR9IQfnJLtehCmbHqJXWC40Y8TXg,28
+hatch_cpp/tests/test_projects.py,sha256=HW-4IExYEAgats0_-RL-HZr3uvJdNVEMJ083wWjFyWg,1275
+hatch_cpp/tests/test_project_basic/pyproject.toml,sha256=eqM1UVpNmJWDfsuO18ZG_VOV9I4tAWgsM5Dhf49X8Nc,694
+hatch_cpp/tests/test_project_basic/cpp/project/basic.cpp,sha256=gQ2nmdLqIdgaqxSKvkN_vbp6Iv_pAoVIHETXPRnALb0,117
+hatch_cpp/tests/test_project_basic/cpp/project/basic.hpp,sha256=SO5GhPj8k3RzWrfH37lFSDc8w1Vf3yqTUhxmr1hnoko,422
+hatch_cpp/tests/test_project_basic/project/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hatch_cpp/tests/test_project_nanobind/pyproject.toml,sha256=PyqfQJomnY0ebavNiDBSlDU6z1f7XHR5_PE7RaxYHhQ,717
+hatch_cpp/tests/test_project_nanobind/cpp/project/basic.cpp,sha256=L4v9AUveWWQX8Z2GMRREsEGLz-A_NCeuX0KiyppDmbc,30
+hatch_cpp/tests/test_project_nanobind/cpp/project/basic.hpp,sha256=AK2FKdlqBwH5jnRUdJXSbWvRr-gSVsUKSG0PiYNsW7A,155
+hatch_cpp/tests/test_project_nanobind/project/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hatch_cpp/tests/test_project_override_classes/pyproject.toml,sha256=cfsaxEltYqcqJo9LKrd8VoTzafjue3cRj38UZsjF5-M,796
+hatch_cpp/tests/test_project_override_classes/cpp/project/basic.cpp,sha256=gQ2nmdLqIdgaqxSKvkN_vbp6Iv_pAoVIHETXPRnALb0,117
+hatch_cpp/tests/test_project_override_classes/cpp/project/basic.hpp,sha256=SO5GhPj8k3RzWrfH37lFSDc8w1Vf3yqTUhxmr1hnoko,422
+hatch_cpp/tests/test_project_override_classes/project/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hatch_cpp/tests/test_project_pybind/pyproject.toml,sha256=buYJAAdAanoOpJTj3JHfzSTgjjPPZ47ribtO07lODHY,715
+hatch_cpp/tests/test_project_pybind/cpp/project/basic.cpp,sha256=MT3eCSQKr4guI3XZHV8kw8PoBGC6LEK8ClxnNMBnvnI,78
+hatch_cpp/tests/test_project_pybind/cpp/project/basic.hpp,sha256=LZSfCfhLY_91MBOxtnvDk7DcceO-9GhCHKpMnAjGe18,146
+hatch_cpp/tests/test_project_pybind/project/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hatch_cpp/toolchains/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hatch_cpp/toolchains/cmake.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+hatch_cpp-0.1.2.dist-info/METADATA,sha256=bLAzn6Fm5bSdr0wQgeQj4akpUViQTRro4FxaGxU-Epo,3003
+hatch_cpp-0.1.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+hatch_cpp-0.1.2.dist-info/entry_points.txt,sha256=RgXfjpD4iwomJQK5n7FnPkXzb5fOnF5v3DI5hbkgVcw,30
+hatch_cpp-0.1.2.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+hatch_cpp-0.1.2.dist-info/RECORD,,

hatch_cpp-0.1.2.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[hatch]
+cpp = hatch_cpp.hooks

hatch_cpp/__main__.py

@@ -1,4 +0,0 @@
-from .cli import main
-
-if __name__ == "__main__":
-    main()

hatch_cpp/tests/test_project_basic.py

@@ -1,22 +0,0 @@
-from os import listdir
-from shutil import rmtree
-from subprocess import check_output
-from sys import platform
-
-
-class TestProject:
-    def test_basic(self):
-        rmtree("hatch_cpp/tests/test_project_basic/basic_project/extension.so", ignore_errors=True)
-        rmtree("hatch_cpp/tests/test_project_basic/basic_project/extension.pyd", ignore_errors=True)
-        check_output(
-            [
-                "hatchling",
-                "build",
-                "--hooks-only",
-            ],
-            cwd="hatch_cpp/tests/test_project_basic",
-        )
-        if platform == "win32":
-            assert "extension.pyd" in listdir("hatch_cpp/tests/test_project_basic/basic_project")
-        else:
-            assert "extension.so" in listdir("hatch_cpp/tests/test_project_basic/basic_project")

hatch_cpp-0.1.0.dist-info/RECORD

@@ -1,19 +0,0 @@
-hatch_cpp/__init__.py,sha256=kUR5RAFc7HCeiqdlX36dZOHkUI5wI6V_43RpEcD8b-0,22
-hatch_cpp/__main__.py,sha256=MSmt_5Xg84uHqzTN38JwgseJK8rsJn_11A8WD99VtEo,61
-hatch_cpp/hooks.py,sha256=SQkF5WJIgzw-8rvlTzuQvBqdP6K3fHgnh6CZOZFag50,203
-hatch_cpp/plugin.py,sha256=2skvxNUCfLVbgKo_DKvTAvpU6Rmolhm5NKSzcVXAPI0,3576
-hatch_cpp/structs.py,sha256=Jk6NBdbsVTwVg78XltfyKJet-hptLy8VcoZI2n8cELg,5939
-hatch_cpp/utils.py,sha256=qeIjS0rul_Kz8Nzji6IWPGQ4Y7jBmIW51hsXczs0j1w,4181
-hatch_cpp/tests/test_all.py,sha256=zxMSmbNDdS_pIhjBR9IQfnJLtehCmbHqJXWC40Y8TXg,28
-hatch_cpp/tests/test_project_basic.py,sha256=jswtsv_FtMKLLAWqZGQiZX3VgW0UoxUicqQ5O0yzI04,800
-hatch_cpp/tests/test_project_basic/pyproject.toml,sha256=QKKt4UPNvQqMwRfI7_GtksrDSfcEnDkWb-0pimi08Ck,1440
-hatch_cpp/tests/test_project_basic/basic_project/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-hatch_cpp/tests/test_project_basic/cpp/basic-project/basic.cpp,sha256=SzFhtdj02DiJXp2bTAfLpsuOwhRQHghPATaL3SWq3us,123
-hatch_cpp/tests/test_project_basic/cpp/basic-project/basic.hpp,sha256=SO5GhPj8k3RzWrfH37lFSDc8w1Vf3yqTUhxmr1hnoko,422
-hatch_cpp/toolchains/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-hatch_cpp/toolchains/cmake.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-hatch_cpp-0.1.0.dist-info/METADATA,sha256=IJ8GoRmY9b7HGAapdCeWARYmTpJeZf2WBM0G0naMoHI,2278
-hatch_cpp-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-hatch_cpp-0.1.0.dist-info/entry_points.txt,sha256=lP2xDFRH6dca9Ld3hE91Syr_q6-hkJhGmtQ5zukJr9E,80
-hatch_cpp-0.1.0.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-hatch_cpp-0.1.0.dist-info/RECORD,,

hatch_cpp-0.1.0.dist-info/entry_points.txt

@@ -1,5 +0,0 @@
-[console_scripts]
-hatch-cpp = hatch_cpp.cli:main
-
-[hatch]
-cpp = hatch_cpp.hooks