pydrake: Expose pybind11 version information

bindings/pydrake/util/BUILD.bazel

@@ -19,6 +19,10 @@ load(
     "drake_py_library",
     "drake_py_test",
 )
+load(
+    "//tools/workspace/pybind11:repository.bzl",
+    "generate_pybind11_version_py_file",
+)
 
 package(default_visibility = [
     "//bindings/pydrake:__subpackages__",
@@ -132,6 +136,19 @@ drake_cc_library(
     hdrs = ["type_safe_index_pybind.h"],
 )
 
+generate_pybind11_version_py_file(
+    name = "pybind11_version.py",
+)
+
+drake_py_library(
+    name = "pybind11_version_py",
+    srcs = ["pybind11_version.py"],
+    tags = ["nolint"],  # Do not lint generated files.
+    deps = [
+        ":module_py",
+    ],
+)
+
 PY_LIBRARIES_WITH_INSTALL = [
     ":eigen_geometry_py",
 ]
@@ -142,6 +159,7 @@ PY_LIBRARIES = [
     ":cpp_template_py",
     ":module_py",
     ":module_shim_py",
+    ":pybind11_version_py",
 ]
 
 # Symbol roll-up (for user ease).
@@ -261,4 +279,11 @@ drake_pybind_cc_googletest(
     ],
 )
 
+drake_py_test(
+    name = "pybind11_version_test",
+    deps = [
+        ":pybind11_version_py",
+    ],
+)
+
 add_lint_tests()

bindings/pydrake/util/test/pybind11_version_test.py

@@ -0,0 +1,20 @@
+"""
+Tests `pybind11` version information available from Drake.
+"""
+
+from __future__ import print_function
+
+import pydrake.util.pybind11_version as mut
+
+import unittest
+
+
+class TestPybind11Version(unittest.TestCase):
+    def test_values(self):
+        self.assertTrue(isinstance(mut.repository, str))
+        self.assertTrue(isinstance(mut.commit, str))
+        self.assertTrue(isinstance(mut.sha256, str))
+
+
+if __name__ == '__main__':
+    unittest.main()

tools/workspace/pybind11/repository.bzl

@@ -1,12 +1,38 @@
 # -*- python -*-
 
+load("//tools/workspace:generate_file.bzl", "generate_file")
 load("@drake//tools/workspace:github.bzl", "github_archive")
 
+_REPOSITORY = "RobotLocomotion/pybind11"
+
+_COMMIT = "e19086472c664078b0ba77432001a89f97784c8d"
+
+_SHA256 = "62f1ae603f896e810339a23ed8695e6273d0936c6d77bd150cade67b76b06373"
+
 def pybind11_repository(name):
     github_archive(
         name = name,
-        repository = "RobotLocomotion/pybind11",
-        commit = "e19086472c664078b0ba77432001a89f97784c8d",
-        sha256 = "62f1ae603f896e810339a23ed8695e6273d0936c6d77bd150cade67b76b06373",  # noqa
+        repository = _REPOSITORY,
+        commit = _COMMIT,
+        sha256 = _SHA256,
         build_file = "@drake//tools/workspace/pybind11:package.BUILD.bazel",
     )
+
+def generate_pybind11_version_py_file(name):
+    vars = dict(
+        repository = repr(_REPOSITORY),
+        commit = repr(_COMMIT),
+        sha256 = repr(_SHA256),
+    )
+    generate_file(
+        name = name,
+        content = '''
+"""
+Provides information on the external fork of `pybind11` used by `pydrake`.
+"""
+
+repository = {repository}
+commit = {commit}
+sha256 = {sha256}
+'''.format(**vars)
+    )