You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

566 lines
26 KiB

8 years ago
  1. .. _changelog:
  2. Changelog
  3. #########
  4. Starting with version 1.8.0, pybind11 releases use a `semantic versioning
  5. <http://semver.org>`_ policy.
  6. v2.2.0 (Not yet released)
  7. -----------------------------------------------------
  8. * TBD
  9. v2.1.0 (March 22, 2017)
  10. -----------------------------------------------------
  11. * pybind11 now performs function overload resolution in two phases. The first
  12. phase only considers exact type matches, while the second allows for implicit
  13. conversions to take place. A special ``noconvert()`` syntax can be used to
  14. completely disable implicit conversions for specific arguments.
  15. `#643 <https://github.com/pybind/pybind11/pull/643>`_,
  16. `#634 <https://github.com/pybind/pybind11/pull/634>`_,
  17. `#650 <https://github.com/pybind/pybind11/pull/650>`_.
  18. * Fixed a regression where static properties no longer worked with classes
  19. using multiple inheritance. The ``py::metaclass`` attribute is no longer
  20. necessary (and deprecated as of this release) when binding classes with
  21. static properties.
  22. `#679 <https://github.com/pybind/pybind11/pull/679>`_,
  23. * Classes bound using ``pybind11`` can now use custom metaclasses.
  24. `#679 <https://github.com/pybind/pybind11/pull/679>`_,
  25. * ``py::args`` and ``py::kwargs`` can now be mixed with other positional
  26. arguments when binding functions using pybind11.
  27. `#611 <https://github.com/pybind/pybind11/pull/611>`_.
  28. * Improved support for C++11 unicode string and character types; added
  29. extensive documentation regarding pybind11's string conversion behavior.
  30. `#624 <https://github.com/pybind/pybind11/pull/624>`_,
  31. `#636 <https://github.com/pybind/pybind11/pull/636>`_,
  32. `#715 <https://github.com/pybind/pybind11/pull/715>`_.
  33. * pybind11 can now avoid expensive copies when converting Eigen arrays to NumPy
  34. arrays (and vice versa). `#610 <https://github.com/pybind/pybind11/pull/610>`_.
  35. * The "fast path" in ``py::vectorize`` now works for any full-size group of C or
  36. F-contiguous arrays. The non-fast path is also faster since it no longer performs
  37. copies of the input arguments (except when type conversions are necessary).
  38. `#610 <https://github.com/pybind/pybind11/pull/610>`_.
  39. * Added fast, unchecked access to NumPy arrays via a proxy object.
  40. `#746 <https://github.com/pybind/pybind11/pull/746>`_.
  41. * Transparent support for class-specific ``operator new`` and
  42. ``operator delete`` implementations.
  43. `#755 <https://github.com/pybind/pybind11/pull/755>`_.
  44. * Slimmer and more efficient STL-compatible iterator interface for sequence types.
  45. `#662 <https://github.com/pybind/pybind11/pull/662>`_.
  46. * Improved custom holder type support.
  47. `#607 <https://github.com/pybind/pybind11/pull/607>`_.
  48. * ``nullptr`` to ``None`` conversion fixed in various builtin type casters.
  49. `#732 <https://github.com/pybind/pybind11/pull/732>`_.
  50. * ``enum_`` now exposes its members via a special ``__members__`` attribute.
  51. `#666 <https://github.com/pybind/pybind11/pull/666>`_.
  52. * ``std::vector`` bindings created using ``stl_bind.h`` can now optionally
  53. implement the buffer protocol. `#488 <https://github.com/pybind/pybind11/pull/488>`_.
  54. * Automated C++ reference documentation using doxygen and breathe.
  55. `#598 <https://github.com/pybind/pybind11/pull/598>`_.
  56. * Added minimum compiler version assertions.
  57. `#727 <https://github.com/pybind/pybind11/pull/727>`_.
  58. * Improved compatibility with C++1z.
  59. `#677 <https://github.com/pybind/pybind11/pull/677>`_.
  60. * Improved ``py::capsule`` API. Can be used to implement cleanup
  61. callbacks that are involved at module destruction time.
  62. `#752 <https://github.com/pybind/pybind11/pull/752>`_.
  63. * Various minor improvements and fixes.
  64. `#595 <https://github.com/pybind/pybind11/pull/595>`_,
  65. `#588 <https://github.com/pybind/pybind11/pull/588>`_,
  66. `#589 <https://github.com/pybind/pybind11/pull/589>`_,
  67. `#603 <https://github.com/pybind/pybind11/pull/603>`_,
  68. `#619 <https://github.com/pybind/pybind11/pull/619>`_,
  69. `#648 <https://github.com/pybind/pybind11/pull/648>`_,
  70. `#695 <https://github.com/pybind/pybind11/pull/695>`_,
  71. `#720 <https://github.com/pybind/pybind11/pull/720>`_,
  72. `#723 <https://github.com/pybind/pybind11/pull/723>`_,
  73. `#729 <https://github.com/pybind/pybind11/pull/729>`_,
  74. `#724 <https://github.com/pybind/pybind11/pull/724>`_,
  75. `#742 <https://github.com/pybind/pybind11/pull/742>`_,
  76. `#753 <https://github.com/pybind/pybind11/pull/753>`_.
  77. v2.0.1 (Jan 4, 2017)
  78. -----------------------------------------------------
  79. * Fix pointer to reference error in type_caster on MSVC
  80. `#583 <https://github.com/pybind/pybind11/pull/583>`_.
  81. * Fixed a segmentation in the test suite due to a typo
  82. `cd7eac <https://github.com/pybind/pybind11/commit/cd7eac>`_.
  83. v2.0.0 (Jan 1, 2017)
  84. -----------------------------------------------------
  85. * Fixed a reference counting regression affecting types with custom metaclasses
  86. (introduced in v2.0.0-rc1).
  87. `#571 <https://github.com/pybind/pybind11/pull/571>`_.
  88. * Quenched a CMake policy warning.
  89. `#570 <https://github.com/pybind/pybind11/pull/570>`_.
  90. v2.0.0-rc1 (Dec 23, 2016)
  91. -----------------------------------------------------
  92. The pybind11 developers are excited to issue a release candidate of pybind11
  93. with a subsequent v2.0.0 release planned in early January next year.
  94. An incredible amount of effort by went into pybind11 over the last ~5 months,
  95. leading to a release that is jam-packed with exciting new features and numerous
  96. usability improvements. The following list links PRs or individual commits
  97. whenever applicable.
  98. Happy Christmas!
  99. * Support for binding C++ class hierarchies that make use of multiple
  100. inheritance. `#410 <https://github.com/pybind/pybind11/pull/410>`_.
  101. * PyPy support: pybind11 now supports nightly builds of PyPy and will
  102. interoperate with the future 5.7 release. No code changes are necessary,
  103. everything "just" works as usual. Note that we only target the Python 2.7
  104. branch for now; support for 3.x will be added once its ``cpyext`` extension
  105. support catches up. A few minor features remain unsupported for the time
  106. being (notably dynamic attributes in custom types).
  107. `#527 <https://github.com/pybind/pybind11/pull/527>`_.
  108. * Significant work on the documentation -- in particular, the monolitic
  109. ``advanced.rst`` file was restructured into a easier to read hierarchical
  110. organization. `#448 <https://github.com/pybind/pybind11/pull/448>`_.
  111. * Many NumPy-related improvements:
  112. 1. Object-oriented API to access and modify NumPy ``ndarray`` instances,
  113. replicating much of the corresponding NumPy C API functionality.
  114. `#402 <https://github.com/pybind/pybind11/pull/402>`_.
  115. 2. NumPy array ``dtype`` array descriptors are now first-class citizens and
  116. are exposed via a new class ``py::dtype``.
  117. 3. Structured dtypes can be registered using the ``PYBIND11_NUMPY_DTYPE()``
  118. macro. Special ``array`` constructors accepting dtype objects were also
  119. added.
  120. One potential caveat involving this change: format descriptor strings
  121. should now be accessed via ``format_descriptor::format()`` (however, for
  122. compatibility purposes, the old syntax ``format_descriptor::value`` will
  123. still work for non-structured data types). `#308
  124. <https://github.com/pybind/pybind11/pull/308>`_.
  125. 4. Further improvements to support structured dtypes throughout the system.
  126. `#472 <https://github.com/pybind/pybind11/pull/472>`_,
  127. `#474 <https://github.com/pybind/pybind11/pull/474>`_,
  128. `#459 <https://github.com/pybind/pybind11/pull/459>`_,
  129. `#453 <https://github.com/pybind/pybind11/pull/453>`_,
  130. `#452 <https://github.com/pybind/pybind11/pull/452>`_, and
  131. `#505 <https://github.com/pybind/pybind11/pull/505>`_.
  132. 5. Fast access operators. `#497 <https://github.com/pybind/pybind11/pull/497>`_.
  133. 6. Constructors for arrays whose storage is owned by another object.
  134. `#440 <https://github.com/pybind/pybind11/pull/440>`_.
  135. 7. Added constructors for ``array`` and ``array_t`` explicitly accepting shape
  136. and strides; if strides are not provided, they are deduced assuming
  137. C-contiguity. Also added simplified constructors for 1-dimensional case.
  138. 8. Added buffer/NumPy support for ``char[N]`` and ``std::array<char, N>`` types.
  139. 9. Added ``memoryview`` wrapper type which is constructible from ``buffer_info``.
  140. * Eigen: many additional conversions and support for non-contiguous
  141. arrays/slices.
  142. `#427 <https://github.com/pybind/pybind11/pull/427>`_,
  143. `#315 <https://github.com/pybind/pybind11/pull/315>`_,
  144. `#316 <https://github.com/pybind/pybind11/pull/316>`_,
  145. `#312 <https://github.com/pybind/pybind11/pull/312>`_, and
  146. `#267 <https://github.com/pybind/pybind11/pull/267>`_
  147. * Incompatible changes in ``class_<...>::class_()``:
  148. 1. Declarations of types that provide access via the buffer protocol must
  149. now include the ``py::buffer_protocol()`` annotation as an argument to
  150. the ``class_`` constructor.
  151. 2. Declarations of types that require a custom metaclass (i.e. all classes
  152. which include static properties via commands such as
  153. ``def_readwrite_static()``) must now include the ``py::metaclass()``
  154. annotation as an argument to the ``class_`` constructor.
  155. These two changes were necessary to make type definitions in pybind11
  156. future-proof, and to support PyPy via its cpyext mechanism. `#527
  157. <https://github.com/pybind/pybind11/pull/527>`_.
  158. 3. This version of pybind11 uses a redesigned mechnism for instantiating
  159. trempoline classes that are used to override virtual methods from within
  160. Python. This led to the following user-visible syntax change: instead of
  161. .. code-block:: cpp
  162. py::class_<TrampolineClass>("MyClass")
  163. .alias<MyClass>()
  164. ....
  165. write
  166. .. code-block:: cpp
  167. py::class_<MyClass, TrampolineClass>("MyClass")
  168. ....
  169. Importantly, both the original and the trampoline class are now
  170. specified as an arguments (in arbitrary order) to the ``py::class_``
  171. template, and the ``alias<..>()`` call is gone. The new scheme has zero
  172. overhead in cases when Python doesn't override any functions of the
  173. underlying C++ class. `rev. 86d825
  174. <https://github.com/pybind/pybind11/commit/86d825>`_.
  175. * Added ``eval`` and ``eval_file`` functions for evaluating expressions and
  176. statements from a string or file. `rev. 0d3fc3
  177. <https://github.com/pybind/pybind11/commit/0d3fc3>`_.
  178. * pybind11 can now create types with a modifiable dictionary.
  179. `#437 <https://github.com/pybind/pybind11/pull/437>`_ and
  180. `#444 <https://github.com/pybind/pybind11/pull/444>`_.
  181. * Support for translation of arbitrary C++ exceptions to Python counterparts.
  182. `#296 <https://github.com/pybind/pybind11/pull/296>`_ and
  183. `#273 <https://github.com/pybind/pybind11/pull/273>`_.
  184. * Report full backtraces through mixed C++/Python code, better reporting for
  185. import errors, fixed GIL management in exception processing.
  186. `#537 <https://github.com/pybind/pybind11/pull/537>`_,
  187. `#494 <https://github.com/pybind/pybind11/pull/494>`_,
  188. `rev. e72d95 <https://github.com/pybind/pybind11/commit/e72d95>`_, and
  189. `rev. 099d6e <https://github.com/pybind/pybind11/commit/099d6e>`_.
  190. * Support for bit-level operations, comparisons, and serialization of C++
  191. enumerations. `#503 <https://github.com/pybind/pybind11/pull/503>`_,
  192. `#508 <https://github.com/pybind/pybind11/pull/508>`_,
  193. `#380 <https://github.com/pybind/pybind11/pull/380>`_,
  194. `#309 <https://github.com/pybind/pybind11/pull/309>`_.
  195. `#311 <https://github.com/pybind/pybind11/pull/311>`_.
  196. * The ``class_`` constructor now accepts its template arguments in any order.
  197. `#385 <https://github.com/pybind/pybind11/pull/385>`_.
  198. * Attribute and item accessors now have a more complete interface which makes
  199. it possible to chain attributes as in
  200. ``obj.attr("a")[key].attr("b").attr("method")(1, 2, 3)``. `#425
  201. <https://github.com/pybind/pybind11/pull/425>`_.
  202. * Major redesign of the default and conversion constructors in ``pytypes.h``.
  203. `#464 <https://github.com/pybind/pybind11/pull/464>`_.
  204. * Added built-in support for ``std::shared_ptr`` holder type. It is no longer
  205. necessary to to include a declaration of the form
  206. ``PYBIND11_DECLARE_HOLDER_TYPE(T, std::shared_ptr<T>)`` (though continuing to
  207. do so won't cause an error).
  208. `#454 <https://github.com/pybind/pybind11/pull/454>`_.
  209. * New ``py::overload_cast`` casting operator to select among multiple possible
  210. overloads of a function. An example:
  211. .. code-block:: cpp
  212. py::class_<Pet>(m, "Pet")
  213. .def("set", py::overload_cast<int>(&Pet::set), "Set the pet's age")
  214. .def("set", py::overload_cast<const std::string &>(&Pet::set), "Set the pet's name");
  215. This feature only works on C++14-capable compilers.
  216. `#541 <https://github.com/pybind/pybind11/pull/541>`_.
  217. * C++ types are automatically cast to Python types, e.g. when assigning
  218. them as an attribute. For instance, the following is now legal:
  219. .. code-block:: cpp
  220. py::module m = /* ... */
  221. m.attr("constant") = 123;
  222. (Previously, a ``py::cast`` call was necessary to avoid a compilation error.)
  223. `#551 <https://github.com/pybind/pybind11/pull/551>`_.
  224. * Redesigned ``pytest``-based test suite. `#321 <https://github.com/pybind/pybind11/pull/321>`_.
  225. * Instance tracking to detect reference leaks in test suite. `#324 <https://github.com/pybind/pybind11/pull/324>`_
  226. * pybind11 can now distinguish between multiple different instances that are
  227. located at the same memory address, but which have different types.
  228. `#329 <https://github.com/pybind/pybind11/pull/329>`_.
  229. * Improved logic in ``move`` return value policy.
  230. `#510 <https://github.com/pybind/pybind11/pull/510>`_,
  231. `#297 <https://github.com/pybind/pybind11/pull/297>`_.
  232. * Generalized unpacking API to permit calling Python functions from C++ using
  233. notation such as ``foo(a1, a2, *args, "ka"_a=1, "kb"_a=2, **kwargs)``. `#372 <https://github.com/pybind/pybind11/pull/372>`_.
  234. * ``py::print()`` function whose behavior matches that of the native Python
  235. ``print()`` function. `#372 <https://github.com/pybind/pybind11/pull/372>`_.
  236. * Added ``py::dict`` keyword constructor:``auto d = dict("number"_a=42,
  237. "name"_a="World");``. `#372 <https://github.com/pybind/pybind11/pull/372>`_.
  238. * Added ``py::str::format()`` method and ``_s`` literal: ``py::str s = "1 + 2
  239. = {}"_s.format(3);``. `#372 <https://github.com/pybind/pybind11/pull/372>`_.
  240. * Added ``py::repr()`` function which is equivalent to Python's builtin
  241. ``repr()``. `#333 <https://github.com/pybind/pybind11/pull/333>`_.
  242. * Improved construction and destruction logic for holder types. It is now
  243. possible to reference instances with smart pointer holder types without
  244. constructing the holder if desired. The ``PYBIND11_DECLARE_HOLDER_TYPE``
  245. macro now accepts an optional second parameter to indicate whether the holder
  246. type uses intrusive reference counting.
  247. `#533 <https://github.com/pybind/pybind11/pull/533>`_ and
  248. `#561 <https://github.com/pybind/pybind11/pull/561>`_.
  249. * Mapping a stateless C++ function to Python and back is now "for free" (i.e.
  250. no extra indirections or argument conversion overheads). `rev. 954b79
  251. <https://github.com/pybind/pybind11/commit/954b79>`_.
  252. * Bindings for ``std::valarray<T>``.
  253. `#545 <https://github.com/pybind/pybind11/pull/545>`_.
  254. * Improved support for C++17 capable compilers.
  255. `#562 <https://github.com/pybind/pybind11/pull/562>`_.
  256. * Bindings for ``std::optional<t>``.
  257. `#475 <https://github.com/pybind/pybind11/pull/475>`_,
  258. `#476 <https://github.com/pybind/pybind11/pull/476>`_,
  259. `#479 <https://github.com/pybind/pybind11/pull/479>`_,
  260. `#499 <https://github.com/pybind/pybind11/pull/499>`_, and
  261. `#501 <https://github.com/pybind/pybind11/pull/501>`_.
  262. * ``stl_bind.h``: general improvements and support for ``std::map`` and
  263. ``std::unordered_map``.
  264. `#490 <https://github.com/pybind/pybind11/pull/490>`_,
  265. `#282 <https://github.com/pybind/pybind11/pull/282>`_,
  266. `#235 <https://github.com/pybind/pybind11/pull/235>`_.
  267. * The ``std::tuple``, ``std::pair``, ``std::list``, and ``std::vector`` type
  268. casters now accept any Python sequence type as input. `rev. 107285
  269. <https://github.com/pybind/pybind11/commit/107285>`_.
  270. * Improved CMake Python detection on multi-architecture Linux.
  271. `#532 <https://github.com/pybind/pybind11/pull/532>`_.
  272. * Infrastructure to selectively disable or enable parts of the automatically
  273. generated docstrings. `#486 <https://github.com/pybind/pybind11/pull/486>`_.
  274. * ``reference`` and ``reference_internal`` are now the default return value
  275. properties for static and non-static properties, respectively. `#473
  276. <https://github.com/pybind/pybind11/pull/473>`_. (the previous defaults
  277. were ``automatic``). `#473 <https://github.com/pybind/pybind11/pull/473>`_.
  278. * Support for ``std::unique_ptr`` with non-default deleters or no deleter at
  279. all (``py::nodelete``). `#384 <https://github.com/pybind/pybind11/pull/384>`_.
  280. * Deprecated ``handle::call()`` method. The new syntax to call Python
  281. functions is simply ``handle()``. It can also be invoked explicitly via
  282. ``handle::operator<X>()``, where ``X`` is an optional return value policy.
  283. * Print more informative error messages when ``make_tuple()`` or ``cast()``
  284. fail. `#262 <https://github.com/pybind/pybind11/pull/262>`_.
  285. * Creation of holder types for classes deriving from
  286. ``std::enable_shared_from_this<>`` now also works for ``const`` values.
  287. `#260 <https://github.com/pybind/pybind11/pull/260>`_.
  288. * ``make_iterator()`` improvements for better compatibility with various
  289. types (now uses prefix increment operator); it now also accepts iterators
  290. with different begin/end types as long as they are equality comparable.
  291. `#247 <https://github.com/pybind/pybind11/pull/247>`_.
  292. * ``arg()`` now accepts a wider range of argument types for default values.
  293. `#244 <https://github.com/pybind/pybind11/pull/244>`_.
  294. * Support ``keep_alive`` where the nurse object may be ``None``. `#341
  295. <https://github.com/pybind/pybind11/pull/341>`_.
  296. * Added constructors for ``str`` and ``bytes`` from zero-terminated char
  297. pointers, and from char pointers and length. Added constructors for ``str``
  298. from ``bytes`` and for ``bytes`` from ``str``, which will perform UTF-8
  299. decoding/encoding as required.
  300. * Many other improvements of library internals without user-visible changes
  301. 1.8.1 (July 12, 2016)
  302. ----------------------
  303. * Fixed a rare but potentially very severe issue when the garbage collector ran
  304. during pybind11 type creation.
  305. 1.8.0 (June 14, 2016)
  306. ----------------------
  307. * Redesigned CMake build system which exports a convenient
  308. ``pybind11_add_module`` function to parent projects.
  309. * ``std::vector<>`` type bindings analogous to Boost.Python's ``indexing_suite``
  310. * Transparent conversion of sparse and dense Eigen matrices and vectors (``eigen.h``)
  311. * Added an ``ExtraFlags`` template argument to the NumPy ``array_t<>`` wrapper
  312. to disable an enforced cast that may lose precision, e.g. to create overloads
  313. for different precisions and complex vs real-valued matrices.
  314. * Prevent implicit conversion of floating point values to integral types in
  315. function arguments
  316. * Fixed incorrect default return value policy for functions returning a shared
  317. pointer
  318. * Don't allow registering a type via ``class_`` twice
  319. * Don't allow casting a ``None`` value into a C++ lvalue reference
  320. * Fixed a crash in ``enum_::operator==`` that was triggered by the ``help()`` command
  321. * Improved detection of whether or not custom C++ types can be copy/move-constructed
  322. * Extended ``str`` type to also work with ``bytes`` instances
  323. * Added a ``"name"_a`` user defined string literal that is equivalent to ``py::arg("name")``.
  324. * When specifying function arguments via ``py::arg``, the test that verifies
  325. the number of arguments now runs at compile time.
  326. * Added ``[[noreturn]]`` attribute to ``pybind11_fail()`` to quench some
  327. compiler warnings
  328. * List function arguments in exception text when the dispatch code cannot find
  329. a matching overload
  330. * Added ``PYBIND11_OVERLOAD_NAME`` and ``PYBIND11_OVERLOAD_PURE_NAME`` macros which
  331. can be used to override virtual methods whose name differs in C++ and Python
  332. (e.g. ``__call__`` and ``operator()``)
  333. * Various minor ``iterator`` and ``make_iterator()`` improvements
  334. * Transparently support ``__bool__`` on Python 2.x and Python 3.x
  335. * Fixed issue with destructor of unpickled object not being called
  336. * Minor CMake build system improvements on Windows
  337. * New ``pybind11::args`` and ``pybind11::kwargs`` types to create functions which
  338. take an arbitrary number of arguments and keyword arguments
  339. * New syntax to call a Python function from C++ using ``*args`` and ``*kwargs``
  340. * The functions ``def_property_*`` now correctly process docstring arguments (these
  341. formerly caused a segmentation fault)
  342. * Many ``mkdoc.py`` improvements (enumerations, template arguments, ``DOC()``
  343. macro accepts more arguments)
  344. * Cygwin support
  345. * Documentation improvements (pickling support, ``keep_alive``, macro usage)
  346. 1.7 (April 30, 2016)
  347. ----------------------
  348. * Added a new ``move`` return value policy that triggers C++11 move semantics.
  349. The automatic return value policy falls back to this case whenever a rvalue
  350. reference is encountered
  351. * Significantly more general GIL state routines that are used instead of
  352. Python's troublesome ``PyGILState_Ensure`` and ``PyGILState_Release`` API
  353. * Redesign of opaque types that drastically simplifies their usage
  354. * Extended ability to pass values of type ``[const] void *``
  355. * ``keep_alive`` fix: don't fail when there is no patient
  356. * ``functional.h``: acquire the GIL before calling a Python function
  357. * Added Python RAII type wrappers ``none`` and ``iterable``
  358. * Added ``*args`` and ``*kwargs`` pass-through parameters to
  359. ``pybind11.get_include()`` function
  360. * Iterator improvements and fixes
  361. * Documentation on return value policies and opaque types improved
  362. 1.6 (April 30, 2016)
  363. ----------------------
  364. * Skipped due to upload to PyPI gone wrong and inability to recover
  365. (https://github.com/pypa/packaging-problems/issues/74)
  366. 1.5 (April 21, 2016)
  367. ----------------------
  368. * For polymorphic types, use RTTI to try to return the closest type registered with pybind11
  369. * Pickling support for serializing and unserializing C++ instances to a byte stream in Python
  370. * Added a convenience routine ``make_iterator()`` which turns a range indicated
  371. by a pair of C++ iterators into a iterable Python object
  372. * Added ``len()`` and a variadic ``make_tuple()`` function
  373. * Addressed a rare issue that could confuse the current virtual function
  374. dispatcher and another that could lead to crashes in multi-threaded
  375. applications
  376. * Added a ``get_include()`` function to the Python module that returns the path
  377. of the directory containing the installed pybind11 header files
  378. * Documentation improvements: import issues, symbol visibility, pickling, limitations
  379. * Added casting support for ``std::reference_wrapper<>``
  380. 1.4 (April 7, 2016)
  381. --------------------------
  382. * Transparent type conversion for ``std::wstring`` and ``wchar_t``
  383. * Allow passing ``nullptr``-valued strings
  384. * Transparent passing of ``void *`` pointers using capsules
  385. * Transparent support for returning values wrapped in ``std::unique_ptr<>``
  386. * Improved docstring generation for compatibility with Sphinx
  387. * Nicer debug error message when default parameter construction fails
  388. * Support for "opaque" types that bypass the transparent conversion layer for STL containers
  389. * Redesigned type casting interface to avoid ambiguities that could occasionally cause compiler errors
  390. * Redesigned property implementation; fixes crashes due to an unfortunate default return value policy
  391. * Anaconda package generation support
  392. 1.3 (March 8, 2016)
  393. --------------------------
  394. * Added support for the Intel C++ compiler (v15+)
  395. * Added support for the STL unordered set/map data structures
  396. * Added support for the STL linked list data structure
  397. * NumPy-style broadcasting support in ``pybind11::vectorize``
  398. * pybind11 now displays more verbose error messages when ``arg::operator=()`` fails
  399. * pybind11 internal data structures now live in a version-dependent namespace to avoid ABI issues
  400. * Many, many bugfixes involving corner cases and advanced usage
  401. 1.2 (February 7, 2016)
  402. --------------------------
  403. * Optional: efficient generation of function signatures at compile time using C++14
  404. * Switched to a simpler and more general way of dealing with function default
  405. arguments. Unused keyword arguments in function calls are now detected and
  406. cause errors as expected
  407. * New ``keep_alive`` call policy analogous to Boost.Python's ``with_custodian_and_ward``
  408. * New ``pybind11::base<>`` attribute to indicate a subclass relationship
  409. * Improved interface for RAII type wrappers in ``pytypes.h``
  410. * Use RAII type wrappers consistently within pybind11 itself. This
  411. fixes various potential refcount leaks when exceptions occur
  412. * Added new ``bytes`` RAII type wrapper (maps to ``string`` in Python 2.7)
  413. * Made handle and related RAII classes const correct, using them more
  414. consistently everywhere now
  415. * Got rid of the ugly ``__pybind11__`` attributes on the Python side---they are
  416. now stored in a C++ hash table that is not visible in Python
  417. * Fixed refcount leaks involving NumPy arrays and bound functions
  418. * Vastly improved handling of shared/smart pointers
  419. * Removed an unnecessary copy operation in ``pybind11::vectorize``
  420. * Fixed naming clashes when both pybind11 and NumPy headers are included
  421. * Added conversions for additional exception types
  422. * Documentation improvements (using multiple extension modules, smart pointers,
  423. other minor clarifications)
  424. * unified infrastructure for parsing variadic arguments in ``class_`` and cpp_function
  425. * Fixed license text (was: ZLIB, should have been: 3-clause BSD)
  426. * Python 3.2 compatibility
  427. * Fixed remaining issues when accessing types in another plugin module
  428. * Added enum comparison and casting methods
  429. * Improved SFINAE-based detection of whether types are copy-constructible
  430. * Eliminated many warnings about unused variables and the use of ``offsetof()``
  431. * Support for ``std::array<>`` conversions
  432. 1.1 (December 7, 2015)
  433. --------------------------
  434. * Documentation improvements (GIL, wrapping functions, casting, fixed many typos)
  435. * Generalized conversion of integer types
  436. * Improved support for casting function objects
  437. * Improved support for ``std::shared_ptr<>`` conversions
  438. * Initial support for ``std::set<>`` conversions
  439. * Fixed type resolution issue for types defined in a separate plugin module
  440. * Cmake build system improvements
  441. * Factored out generic functionality to non-templated code (smaller code size)
  442. * Added a code size / compile time benchmark vs Boost.Python
  443. * Added an appveyor CI script
  444. 1.0 (October 15, 2015)
  445. ------------------------
  446. * Initial release