Add semi-automated Python binding generation tool

[jamiesnape]

Relates #7889, #14265, and autopybind11/autopybind11#140 (gitlab.kitware.com).

Needs CI update.

---

This change is 

[jamiesnape]

Error in fail: Header external/eigen/include/_usr_include_eigen3/Eigen/Cholesky lacks a plausible include path. Looks like #15069 has changed some behavior. FYI @jwnimmer-tri (though I am sure the issue is here, not in #15069).

[rpoyner-tri]

Reviewable status: 1 unresolved discussion, needs platform reviewer assigned, needs at least two assigned reviewers, labeled "do not merge" (waiting on @jamiesnape)

a discussion (no related file):
Should it worry me that just adding a header that includes generated lcm headers fails because it can't find those headers? Do I need to augment some build rule somewhere?

diff --git a/tools/autopybind/bindings_to_generate.yaml b/tools/autopybind/bindings_to_generate.yaml
index bbee6e93e1..ba174c0328 100644
--- a/tools/autopybind/bindings_to_generate.yaml
+++ b/tools/autopybind/bindings_to_generate.yaml
@@ -151,3 +151,23 @@ files:
                   DepthRange: {}
                   DepthRenderCamera: {}
                   RenderEngine: {}
+  # This stanza fails to build because generated headers for
+  # lcm structs are not found.
+  # "drake/manipulation/kuka_iiwa/iiwa_command_receiver.h":
+  #   namespaces:
+  #     drake:
+  #       namespaces:
+  #         manipulation:
+  #           namespaces:
+  #             kuka_iiwa:
+  #               classes:
+  #                 IiwaCommandReceiver: {}

For now, I'm doing experiments in a branch that contains this PR and a revert of #15069.

---

[jamiesnape]

Try adding //lcmtypes:lcmtypes_drake_cc here and see if it unblocks you:

drake/tools/autopybind/BUILD.bazel

Line 20 in bd47934

"//tools/install/libdrake:drake_headers",

[rpoyner-tri]

Reviewable status: needs platform reviewer assigned, needs at least two assigned reviewers, labeled "do not merge" (waiting on @jamiesnape)

a discussion (no related file):

Previously, rpoyner-tri (Rick Poyner (rico)) wrote…

Should it worry me that just adding a header that includes generated lcm headers fails because it can't find those headers? Do I need to augment some build rule somewhere?

diff --git a/tools/autopybind/bindings_to_generate.yaml b/tools/autopybind/bindings_to_generate.yaml
index bbee6e93e1..ba174c0328 100644
--- a/tools/autopybind/bindings_to_generate.yaml
+++ b/tools/autopybind/bindings_to_generate.yaml
@@ -151,3 +151,23 @@ files:
                   DepthRange: {}
                   DepthRenderCamera: {}
                   RenderEngine: {}
+  # This stanza fails to build because generated headers for
+  # lcm structs are not found.
+  # "drake/manipulation/kuka_iiwa/iiwa_command_receiver.h":
+  #   namespaces:
+  #     drake:
+  #       namespaces:
+  #         manipulation:
+  #           namespaces:
+  #             kuka_iiwa:
+  #               classes:
+  #                 IiwaCommandReceiver: {}

For now, I'm doing experiments in a branch that contains this PR and a revert of #15069.

The remedy recommended above (add a dependency) worked.

---

[jamiesnape]

Moved to #15205.