semiwrap 0.1.1__tar.gz

semiwrap-0.1.1/.gitignore

@@ -0,0 +1,10 @@
+*.egg-info
+*.pyc
+__pycache__
+
+.vscode
+
+/dist
+/build
+
+/src/semiwrap/version.py

semiwrap-0.1.1/LICENSE-pybind11.txt

@@ -0,0 +1,29 @@
+Copyright (c) 2016 Wenzel Jakob <wenzel.jakob@epfl.ch>, All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+   may be used to endorse or promote products derived from this software
+   without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+Please also refer to the file .github/CONTRIBUTING.md, which clarifies licensing of
+external contributions to this project including patches, pull requests, etc.

semiwrap-0.1.1/LICENSE.txt

@@ -0,0 +1,26 @@
+Copyright (c) 2020-2025 Dustin Spicuzza <dustin@virtualroadside.com>, All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+   may be used to endorse or promote products derived from this software
+   without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

semiwrap-0.1.1/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.4
+Name: semiwrap
+Version: 0.1.1
+Summary: Semi-automated tool to wrap C++ code for use by python
+Project-URL: Source code, https://github.com/robotpy/semiwrap
+Author-email: Dustin Spicuzza <robotpy@googlegroups.com>
+License-Expression: BSD-3-Clause
+License-File: LICENSE.txt
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development
+Requires-Python: >=3.8
+Requires-Dist: cxxheaderparser[pcpp]~=1.5
+Requires-Dist: packaging
+Requires-Dist: pkgconf
+Requires-Dist: pybind11-stubgen~=2.5.1
+Requires-Dist: pyyaml>=5.1
+Requires-Dist: sphinxify>=0.7.3
+Requires-Dist: tomli
+Requires-Dist: tomli-w
+Requires-Dist: toposort
+Requires-Dist: typing-extensions
+Requires-Dist: validobj~=1.2
+Description-Content-Type: text/markdown
+
+semiwrap
+========
+
+semiwrap is a build tool that makes it simpler to wrap C/C++ libraries with
+pybind11 by automating large portions of the wrapping process and handling some
+of the more complex aspects of creating pybind11 based wrappers (especially with
+trampolines to allow inheriting from C++ classes from Python).
+
+semiwrap includes a hatchling plugin that autogenerates `meson.build` files that
+can be built using meson, and those build files parse your wrapped headers and
+generate/compile pybind11 based wrappers into python extension modules. 
+
+Requires Python 3.8+
+
+Documentation
+-------------
+
+Documentation can be found at https://semiwrap.readthedocs.io/
+
+Author
+------
+
+Dustin Spicuzza is the primary author of semiwrap.
+
+Semiwrap is a direct decendant of the robotpy-build project, and is culmination
+of many years of experimentation with automated wrapper generation by members of
+the RobotPy community.
+
+semiwrap is available under the BSD 3-clause license.

semiwrap-0.1.1/README.md

@@ -0,0 +1,29 @@
+semiwrap
+========
+
+semiwrap is a build tool that makes it simpler to wrap C/C++ libraries with
+pybind11 by automating large portions of the wrapping process and handling some
+of the more complex aspects of creating pybind11 based wrappers (especially with
+trampolines to allow inheriting from C++ classes from Python).
+
+semiwrap includes a hatchling plugin that autogenerates `meson.build` files that
+can be built using meson, and those build files parse your wrapped headers and
+generate/compile pybind11 based wrappers into python extension modules. 
+
+Requires Python 3.8+
+
+Documentation
+-------------
+
+Documentation can be found at https://semiwrap.readthedocs.io/
+
+Author
+------
+
+Dustin Spicuzza is the primary author of semiwrap.
+
+Semiwrap is a direct decendant of the robotpy-build project, and is culmination
+of many years of experimentation with automated wrapper generation by members of
+the RobotPy community.
+
+semiwrap is available under the BSD 3-clause license.

semiwrap-0.1.1/pyproject.toml

@@ -0,0 +1,68 @@
+[build-system]
+requires = ["hatchling>=1.26.2", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[project]
+name = "semiwrap"
+dynamic = ["version"]
+description = "Semi-automated tool to wrap C++ code for use by python"
+readme = "README.md"
+requires-python = ">=3.8"
+license = "BSD-3-Clause"
+license-files = ["LICENSE.txt", "LICENSE-pybind11.txt"]
+authors = [
+    {name = "Dustin Spicuzza", email = "robotpy@googlegroups.com"},
+]
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: BSD License",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Software Development",
+]
+dependencies = [
+    "pkgconf",
+    "sphinxify >= 0.7.3",
+    "validobj ~= 1.2",
+    "cxxheaderparser[pcpp] ~= 1.5",
+    "packaging",
+    "tomli",
+    "tomli_w",
+    "toposort",
+    "typing-extensions",
+    "pyyaml >= 5.1",
+    "pybind11-stubgen ~= 2.5.1",
+]
+
+[project.entry-points.hatch]
+semiwrap = "semiwrap.hooks"
+
+[project.entry-points.pkg_config]
+semiwrap = "semiwrap"
+
+[project.scripts]
+semiwrap = "semiwrap.tool.__main__:main"
+
+[project.urls]
+"Source code" = "https://github.com/robotpy/semiwrap"
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.targets.sdist.hooks.vcs]
+version-file = "src/semiwrap/version.py"
+
+[tool.hatch.build.targets.sdist]
+packages = ["src/semiwrap"]
+exclude = [
+    "/src/semiwrap/pybind11"
+]
+[tool.hatch.build.targets.sdist.force-include]
+"./src/semiwrap/pybind11/include" = "./semiwrap/pybind11/include"
+"./src/semiwrap/pybind11/LICENSE" = "./LICENSE-pybind11.txt"
+
+[tool.black]
+target-version = ["py38"]
+extend-exclude = '''
+^/src/semiwrap/pybind11
+'''

semiwrap-0.1.1/semiwrap/__main__.py

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

semiwrap-0.1.1/semiwrap/autowrap/buffer.py

@@ -0,0 +1,45 @@
+import io
+import contextlib
+import inspect
+
+
+class RenderBuffer:
+    def __init__(self) -> None:
+        self._buffer = io.StringIO()
+
+        self._indent = ""
+        self._indentlen = 0
+
+    def getvalue(self) -> str:
+        return self._buffer.getvalue()
+
+    def rel_indent(self, spaces: int):
+        self._indentlen += spaces
+        self._indent = " " * self._indentlen
+
+    @contextlib.contextmanager
+    def indent(self, spaces: int = 2):
+        self._indentlen += spaces
+        self._indent = " " * self._indentlen
+        try:
+            yield
+        finally:
+            self._indentlen -= spaces
+            self._indent = " " * self._indentlen
+
+    def writeln(self, s: str = ""):
+        if not s:
+            self._buffer.write("\n")
+        else:
+            for line in s.splitlines(False):
+                if line:
+                    self._buffer.write(f"{self._indent}{line}\n")
+                else:
+                    self._buffer.write("\n")
+
+    def write_trim(self, s: str):
+        for line in inspect.cleandoc(s).splitlines(False):
+            if line:
+                self._buffer.write(f"{self._indent}{line}\n")
+            else:
+                self._buffer.write("\n")