Add 'xo-pyreflect/' from commit '54d11b31a5'

git-subtree-dir: xo-pyreflect git-subtree-mainline: c7f5d9d810 git-subtree-split: 54d11b31a5
2025-05-10 21:04:13 -05:00 · 2025-05-10 21:04:13 -05:00 · c1e3014384
commit c1e3014384
parent c7f5d9d810 54d11b31a5
10 changed files with 417 additions and 0 deletions
--- a/xo-pyreflect/src/pyreflect/pyreflect.cpp
+++ b/xo-pyreflect/src/pyreflect/pyreflect.cpp
@ -0,0 +1,76 @@
+/* @file pyreflect.cpp */
+
+// note: need pyreflect/ here bc pyreflect.hpp is generated, located in build directory
+#include "pyreflect.hpp"
+#include "xo/reflect/TypeDescr.hpp"
+#include "xo/reflect/TaggedRcptr.hpp"
+#include "xo/reflect/SelfTagging.hpp"
+//#include "time/Time.hpp"
+//#include "xo/pyutil/pytime.hpp"
+#include "xo/pyutil/pyutil.hpp"
+//#include <pybind11/pybind11.h>
+//#include <pybind11/stl.h>
+//#include <pybind11/chrono.h>
+//#include <pybind11/operators.h>
+
+namespace xo {
+    using xo::time::utc_nanos;
+    using xo::ref::unowned_ptr;
+    using xo::rp;
+    namespace py = pybind11;
+
+    namespace reflect {
+        PYBIND11_MODULE(PYREFLECT_MODULE_NAME(), m) {
+
+            m.doc() = "pybind11 plugin for xo-reflect";
+
+            py::enum_<Metatype>(m, "Metatype")
+                .value("invalid", Metatype::mt_invalid)
+                .value("atomic", Metatype::mt_atomic)
+                .value("pointer", Metatype::mt_pointer)
+                .value("vector", Metatype::mt_vector)
+                .value("struct", Metatype::mt_struct)
+                .value("function", Metatype::mt_function)
+                ;
+
+            /* note: possibly move this to pytime/  if/when we provide it */
+            //py::class_<utc_nanos>(m, "utc_nanos");
+
+            //py::class_<TypeDescrImpl>(m, "TypeDescr");
+            /* TypeDescrBase instances are created automatically at library load time
+             * by static initializers.  The reflection library (xo-reflect) is responsible
+             * for lifetime of TypeDescrobjects.  Under no circumstances should python
+             * (or pybind11) directly destroy a TypeDescrImpl instance, hence use of
+             * unowned_ptr<TypeDescrBase> here.
+             */
+            py::class_<TypeDescrBase,
+                       unowned_ptr<TypeDescrBase>>(m, "TypeDescr")
+
+                .def_static("lookup_by_name", &TypeDescrBase::lookup_by_name)
+                .def_static("print_reflected_types",
+                            [](){ TypeDescrBase::print_reflected_types(std::cout); })
+
+                .def_property_readonly("canonical_name", &TypeDescrBase::canonical_name)
+                .def_property_readonly("short_name", &TypeDescrBase::short_name)
+                .def_property_readonly("metatype", &TypeDescrBase::metatype)
+                .def_property_readonly("complete_flag", &TypeDescrBase::complete_flag)
+                .def("__repr__", &TypeDescrBase::display_string);
+
+            /* note: this means python will use
+             *         std::unique_ptr<TaggedRcptr>
+             *       when it encounters a TaggedRcptr instance.
+             *       Maintains refcount at cost of 2nd level of indirection.
+             */
+            py::class_<TaggedRcptr>(m, "TaggedRcptr")
+                .def_property_readonly("td", &TaggedPtr::td)
+                .def("__repr__", &TaggedRcptr::display_string);
+
+            py::class_<SelfTagging,
+                       rp<SelfTagging>>(m, "SelfTagging")
+                .def("self_tp", &SelfTagging::self_tp);
+
+        } /*pyreflect*/
+    } /*namespace reflect*/
+} /*namespace xo*/
+
+/* end pyreflect.cpp */