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