added module::import statement

example/example9.cpp

 /*
-    example/example9.cpp -- nested modules and internal references
+    example/example9.cpp -- nested modules, importing modules, and
+                            internal references
 
     Copyright (c) 2015 Wenzel Jakob <wenzel@inf.ethz.ch>
 
@@ -49,4 +50,6 @@ void init_ex9(py::module &m) {
         .def("get_a2", &B::get_a2, "Return the internal A 2", py::return_value_policy::reference_internal)
         .def_readwrite("a1", &B::a1)  // def_readonly uses an internal reference return policy by default
         .def_readwrite("a2", &B::a2);
+
+    m.attr("OD") = py::module::import("collections").attr("OrderedDict");
 }

example/example9.py

@@ -9,6 +9,7 @@ print(example.__name__)
 print(example.submodule.__name__)
 
 from example.submodule import *
+from example import OD
 
 submodule_func()
 
@@ -26,3 +27,4 @@ print(b.a1)
 print(b.get_a2())
 print(b.a2)
 
+print(OD([(1, 'a'), (2, 'b')]))

example/example9.ref

@@ -16,6 +16,7 @@ A[42]
 A[42]
 A[43]
 A[43]
+OrderedDict([(1, 'a'), (2, 'b')])
 B destructor
 A destructor
 A destructor

include/pybind/pybind.h

@@ -466,6 +466,10 @@ public:
         attr(name) = result;
         return result;
     }
+
+    static module import(const char *name) {
+        return module(PyImport_ImportModule(name), false);
+    }
 };
 
 NAMESPACE_BEGIN(detail)