Merge pull request h5py#2405 from takluyver/rever-3.11

takluyver · web-flow · commit 2c80981022e7 · 2024-04-10T10:53:15.000+01:00
Prepare to release 3.11.0
diff --git a/docs/conf.py b/docs/conf.py
@@ -62,7 +62,7 @@
 # built documents.
 #
 # The full version, including alpha/beta/rc tags.
-release = '3.10.0'
+release = '3.11.0'
 # The short X.Y version.
 version = '.'.join(release.split('.')[:2])
 
diff --git a/docs/high/group.rst b/docs/high/group.rst
@@ -277,6 +277,19 @@ Reference
         In this case `object` will be a :class:`Group` or :class:`Dataset`
         instance.
 
+    .. method:: visit_links(callable)
+                visititems_links(callable)
+
+       These methods are like :meth:`visit` and :meth:`visititems`, but work on
+       the links in groups, rather than the objects those links point to. So if
+       you have two links pointing to the same object, these will 'see' both.
+       They also see soft & external links, which :meth:`visit` and
+       :meth:`visititems` ignore.
+
+       The second argument to the callback for ``visititems_links`` is an
+       instance of one of the :ref:`link classes <group_link_classes>`.
+
+       .. versionadded:: 3.11
 
     .. method:: move(source, dest)
 
@@ -516,6 +529,7 @@ Reference
 
         :class:`Group` instance containing this group.
 
+.. _group_link_classes:
 
 Link classes
 ------------
diff --git a/docs/whatsnew/3.11.rst b/docs/whatsnew/3.11.rst
@@ -0,0 +1,38 @@
+What's new in h5py 3.11
+=======================
+
+New features
+------------
+
+* h5py is now compatible with Numpy 2.0 (:pr:`2329`, :pr:`2401`).
+* New methods :meth:`.Group.visit_links` and :meth:`.Group.visititems_links`
+  that include links when visiting groups (:pr:`2360`).
+
+Exposing HDF5 functions
+-----------------------
+
+* Exposes remaining information from `H5O_info_t` struct such as access, modification, change, and
+  birth time (:pr:`2358`). Also exposes field providing number of attributes attached to an object. Expands object
+  header metadata struct `H5O_hdr_info_t`, `hdr` field of `H5O_info_t`, to provide number of chunks and
+  flags set for object header. Lastly, adds `meta_size` field from `H5O_info_t` struct that provides
+  two fields, `attr` which is the storage overhead of any attached attributes, and `obj` which is
+  storage overhead required for chunk storage. The last two fields added can be useful for determining
+  the storage overhead incurred from various data layout/chunked strategies, and for obtaining information
+  such as that provided by `h5stat`.
+
+Bug fixes
+---------
+
+* h5py's tests pass with HDF5 1.14.4, which is due to be released shortly after
+  h5py 3.11 (:pr:`2406`).
+* :meth:`~.Dataset.iter_chunks()` now behaves correctly with a selection
+  (:pr:`2381`).
+* HDF5 allows external datasets (with the data stored in a separate file) to be
+  expandable along the first dimension. Such datasets can now be created
+  through h5py by passing a ``maxshape=`` parameter (:pr:`2398`).
+
+Building h5py
+-------------
+
+* h5py can now be built with Cython 3.x (:pr:`2345`).
+* Fixed some errors compiling with GCC 14 (:pr:`2380`, :pr:`2382`).
diff --git a/docs/whatsnew/index.rst b/docs/whatsnew/index.rst
@@ -8,6 +8,7 @@ These document the changes between minor (or major) versions of h5py.
 
 .. toctree::
 
+    3.11
     3.10
     3.9
     3.8
diff --git a/h5py/version.py b/h5py/version.py
@@ -23,7 +23,7 @@
 
 hdf5_built_version_tuple = _h5.HDF5_VERSION_COMPILED_AGAINST
 
-version_tuple = _H5PY_VERSION_CLS(3, 10, 0, None, None, None)
+version_tuple = _H5PY_VERSION_CLS(3, 11, 0, None, None, None)
 
 version = "{0.major:d}.{0.minor:d}.{0.bugfix:d}".format(version_tuple)
 if version_tuple.pre is not None:
diff --git a/news/metasize_info_struct.rst b/news/metasize_info_struct.rst
diff --git a/news/numpy-2.rst b/news/numpy-2.rst
diff --git a/news/visit-links.rst b/news/visit-links.rst
diff --git a/setup.py b/setup.py
@@ -20,7 +20,7 @@
 import setup_build, setup_configure
 
 
-VERSION = '3.10.0'
+VERSION = '3.11.0'
 
 
 # these are required to use h5py

Original file line number	Diff line number	Diff line change
`@@ -62,7 +62,7 @@`
`62`	`62`	`# built documents.`
`63`	`63`	`#`
`64`	`64`	`# The full version, including alpha/beta/rc tags.`
`65`		`-release = '3.10.0'`
	`65`	`+release = '3.11.0'`
`66`	`66`	`# The short X.Y version.`
`67`	`67`	`version = '.'.join(release.split('.')[:2])`
`68`	`68`
-Original file line number
+Diff line change
 .. toctree::
 +    3.11
 .10
 .9
 .8