Skip to content

Convert rst double-backtick docstring markup to markdown#4193

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
d-v-b merged 2 commits into from
Aug 3, 2026
Merged

Convert rst double-backtick docstring markup to markdown #4193

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b148726
Convert rst double-backtick docstring markup to markdown
jhamman Jul 28, 2026
d02a6e1
Merge branch 'main' into feature/markdown-docstrings
d-v-b Aug 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions changes/4193.doc.md
View file
Open in desktop
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
Converted remaining reStructuredText-style double-backtick markup to Markdown
single backticks in the docstrings of `zarr.api.asynchronous`,
`zarr.api.synchronous`, `zarr.core.array`, `zarr.registry`, and
`zarr.storage._common`. No functional changes.
72 changes: 36 additions & 36 deletions src/zarr/api/asynchronous.py
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -103,7 +103,7 @@

def _infer_overwrite(mode: AccessModeLiteral) -> bool:
"""
Check that an ``AccessModeLiteral`` is compatible with overwriting an existing Zarr node.
Check that an `AccessModeLiteral` is compatible with overwriting an existing Zarr node.
"""
return mode in _OVERWRITE_MODES

Expand All@@ -112,9 +112,9 @@ def _warn_unimplemented_kwargs(kwargs: dict[str, Any]) -> None:
"""
Emit a "not yet implemented" warning for each provided keyword argument that is not None.

``kwargs`` maps a keyword argument name to its supplied value. The ``stacklevel`` is chosen
`kwargs` maps a keyword argument name to its supplied value. The `stacklevel` is chosen
so the warning points at the caller of the public API function (the same location as an
inline ``warnings.warn(..., stacklevel=2)`` would).
inline `warnings.warn(..., stacklevel=2)` would).
"""
for name, value in kwargs.items():
if value is not None:
Expand DownExpand Up@@ -194,7 +194,7 @@ async def consolidate_metadata(

Upon completion, the metadata of the root node in the Zarr hierarchy will be
updated to include all the metadata of child nodes. For Stores that do
not support consolidated metadata, this operation raises a ``TypeError``.
not support consolidated metadata, this operation raises a `TypeError`.

Parameters
----------
Expand All@@ -215,10 +215,10 @@ async def consolidate_metadata(
Returns
-------
group: AsyncGroup
The group, with the ``consolidated_metadata`` field set to include
The group, with the `consolidated_metadata` field set to include
the metadata of each child node. If the Store doesn't support
consolidated metadata, this function raises a `TypeError`.
See ``Store.supports_consolidated_metadata``.
See `Store.supports_consolidated_metadata`.
"""
store_path = await make_store_path(store, path=path)

Expand DownExpand Up@@ -420,7 +420,7 @@ async def open_consolidated(
*args: Any, use_consolidated: Literal[True] = True, **kwargs: Any
) -> AsyncGroup:
"""
Alias for [`open_group`][zarr.api.asynchronous.open_group] with ``use_consolidated=True``.
Alias for [`open_group`][zarr.api.asynchronous.open_group] with `use_consolidated=True`.
"""
if use_consolidated is not True:
raise TypeError(
Expand DownExpand Up@@ -484,7 +484,7 @@ async def save_array(
arr : ndarray
NumPy array with data to save.
zarr_format : {2, 3, None}, optional
The zarr format to use when saving. The default is ``None``, which will
The zarr format to use when saving. The default is `None`, which will
use the default Zarr format defined in the global configuration object.
path : str or None, optional
The path within the store where the array will be saved.
Expand DownExpand Up@@ -745,12 +745,12 @@ async def create_group(
path : str, optional
Group path within store.
overwrite : bool, optional
If True, pre-existing data at ``path`` will be deleted before
If True, pre-existing data at `path` will be deleted before
creating the group.
zarr_format : {2, 3, None}, optional
The zarr format to use when saving.
If no ``zarr_format`` is provided, the default format will be used.
This default can be changed by modifying the value of ``default_zarr_format``
If no `zarr_format` is provided, the default format will be used.
This default can be changed by modifying the value of `default_zarr_format`
in [`zarr.config`][zarr.config].
storage_options : dict
If using an fsspec URL to create the store, these will be passed to
Expand DownExpand Up@@ -828,17 +828,17 @@ async def open_group(
Whether to use consolidated metadata.

By default, consolidated metadata is used if it's present in the
store (in the ``zarr.json`` for Zarr format 3 and in the ``.zmetadata`` file
store (in the `zarr.json` for Zarr format 3 and in the `.zmetadata` file
for Zarr format 2).

To explicitly require consolidated metadata, set ``use_consolidated=True``,
To explicitly require consolidated metadata, set `use_consolidated=True`,
which will raise an exception if consolidated metadata is not found.

To explicitly *not* use consolidated metadata, set ``use_consolidated=False``,
To explicitly *not* use consolidated metadata, set `use_consolidated=False`,
which will fall back to using the regular, non consolidated metadata.

Zarr format 2 allowed configuring the key storing the consolidated metadata
(``.zmetadata`` by default). Specify the custom key as ``use_consolidated``
(`.zmetadata` by default). Specify the custom key as `use_consolidated`
to load consolidated metadata from a non-default key.

Returns
Expand DownExpand Up@@ -924,40 +924,40 @@ async def create(
shape : int or tuple of ints
Array shape.
chunks : int or tuple of ints, optional
Chunk shape. If True, will be guessed from ``shape`` and ``dtype``. If
False, will be set to ``shape``, i.e., single chunk for the whole array.
Chunk shape. If True, will be guessed from `shape` and `dtype`. If
False, will be set to `shape`, i.e., single chunk for the whole array.
If an int, the chunk size in each dimension will be given by the value
of ``chunks``. Default is True.
of `chunks`. Default is True.
dtype : str or dtype, optional
NumPy dtype.
compressor : Codec, optional
Primary compressor to compress chunk data.
Zarr format 2 only. Zarr format 3 arrays should use ``codecs`` instead.
Zarr format 2 only. Zarr format 3 arrays should use `codecs` instead.

If neither ``compressor`` nor ``filters`` are provided, the default compressor
If neither `compressor` nor `filters` are provided, the default compressor
[`zarr.codecs.ZstdCodec`][] is used.

If ``compressor`` is set to ``None``, no compression is used.
If `compressor` is set to `None`, no compression is used.
fill_value : Any, optional
Fill value for the array.
order : {'C', 'F'}, optional
Deprecated in favor of the ``config`` keyword argument.
Pass ``{'order': <value>}`` to ``create`` instead of using this parameter.
Deprecated in favor of the `config` keyword argument.
Pass `{'order': <value>}` to `create` instead of using this parameter.
Memory layout to be used within each chunk.
If not specified, the ``array.order`` parameter in the global config will be used.
If not specified, the `array.order` parameter in the global config will be used.
store : StoreLike or None, default=None
StoreLike object to open. See the
[storage documentation in the user guide][user-guide-store-like]
for a description of all valid StoreLike values.
synchronizer : object, optional
Array synchronizer.
overwrite : bool, optional
If True, delete all pre-existing data in ``store`` at ``path`` before
If True, delete all pre-existing data in `store` at `path` before
creating the array.
path : str, optional
Path under which array is stored.
chunk_store : StoreLike or None, default=None
Separate storage for chunks. If not provided, ``store`` will be used
Separate storage for chunks. If not provided, `store` will be used
for storage of both chunks and metadata.
filters : Iterable[Codec] | Literal["auto"], optional
Iterable of filters to apply to each chunk of the array, in order, before serializing that
Expand All@@ -970,14 +970,14 @@ async def create(
For Zarr format 2, a "filter" can be any numcodecs codec; you should ensure that the
order of your filters is consistent with the behavior of each filter.

The default value of ``"auto"`` instructs Zarr to use a default based on the data
The default value of `"auto"` instructs Zarr to use a default based on the data
type of the array and the Zarr format specified. For all data types in Zarr V3, and most
data types in Zarr V2, the default filters are empty. The only cases where default filters
are not empty is when the Zarr format is 2, and the data type is a variable-length data type like
[`zarr.dtype.VariableLengthUTF8`][] or [`zarr.dtype.VariableLengthUTF8`][]. In these cases,
the default filters contains a single element which is a codec specific to that particular data type.

To create an array with no filters, provide an empty iterable or the value ``None``.
To create an array with no filters, provide an empty iterable or the value `None`.
cache_metadata : bool, optional
If True, array configuration metadata will be cached for the
lifetime of the object. If False, array metadata will be reloaded
Expand All@@ -993,17 +993,17 @@ async def create(
A codec to encode object arrays, only needed if dtype=object.
dimension_separator : {'.', '/'}, optional
Separator placed between the dimensions of a chunk.
Zarr format 2 only. Zarr format 3 arrays should use ``chunk_key_encoding`` instead.
Zarr format 2 only. Zarr format 3 arrays should use `chunk_key_encoding` instead.
write_empty_chunks : bool, optional
Deprecated in favor of the ``config`` keyword argument.
Pass ``{'write_empty_chunks': <value>}`` to ``create`` instead of using this parameter.
Deprecated in favor of the `config` keyword argument.
Pass `{'write_empty_chunks': <value>}` to `create` instead of using this parameter.
If True, all chunks will be stored regardless of their
contents. If False, each chunk is compared to the array's fill value
prior to storing. If a chunk is uniformly equal to the fill value, then
that chunk is not be stored, and the store entry for that chunk's key
is deleted.
zarr_format : {2, 3, None}, optional
The Zarr format to use when creating an array. The default is ``None``,
The Zarr format to use when creating an array. The default is `None`,
which instructs Zarr to choose the default Zarr format value defined in the
runtime configuration.
meta_array : array-like, optional
Expand All@@ -1016,15 +1016,15 @@ async def create(
chunk_key_encoding : ChunkKeyEncoding, optional
A specification of how the chunk keys are represented in storage.
Zarr format 3 only. Zarr format 2 arrays should use `dimension_separator` instead.
Default is ``("default", "/")``.
Default is `("default", "/")`.
codecs : Sequence of Codecs or dicts, optional
An iterable of Codec or dict serializations of Codecs. Zarr V3 only.

The elements of ``codecs`` specify the transformation from array values to stored bytes.
Zarr format 3 only. Zarr format 2 arrays should use ``filters`` and ``compressor`` instead.
The elements of `codecs` specify the transformation from array values to stored bytes.
Zarr format 3 only. Zarr format 2 arrays should use `filters` and `compressor` instead.

If no codecs are provided, default codecs will be used based on the data type of the array.
For most data types, the default codecs are the tuple ``(BytesCodec(), ZstdCodec())``;
For most data types, the default codecs are the tuple `(BytesCodec(), ZstdCodec())`;
data types that require a special [`zarr.abc.codec.ArrayBytesCodec`][], like variable-length strings or bytes,
will use the [`zarr.abc.codec.ArrayBytesCodec`][] required for the data type instead of [`zarr.codecs.BytesCodec`][].
dimension_names : Iterable[str | None] | None = None
Expand Down
Loading
Loading
, 'i'); if (__m === '*' || __re.test(location.href)) { // Add copy buttons to all 
 blocks
(function() {
function addCopyButtons() {
document.querySelectorAll('pre code').forEach(function(codeBlock) {
if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;
codeBlock.parentElement.setAttribute('data-copy-added', 'true');
var btn = document.createElement('button');
btn.textContent = 'Copy';
btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';
btn.onmouseover = function() { this.style.opacity = '1'; };
btn.onmouseout = function() { this.style.opacity = '0.7'; };
btn.onclick = function() {
navigator.clipboard.writeText(codeBlock.textContent).then(function() {
btn.textContent = 'Copied!';
setTimeout(function() { btn.textContent = 'Copy'; }, 1500);
});
};
codeBlock.parentElement.style.position = 'relative';
codeBlock.parentElement.appendChild(btn);
});
}
addCopyButtons();
// Re-run on dynamic content
var observer = new MutationObserver(addCopyButtons);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Convert rst double-backtick docstring markup to markdown by jhamman · Pull Request #4193 · zarr-developers/zarr-python · GitHub
Skip to content
Convert rst double-backtick docstring markup to markdown#4193

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

d-v-b
merged 2 commits into

from

Aug 3, 2026
 Merged


Convert rst double-backtick docstring markup to markdown
#4193
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
b148726

Convert rst double-backtick docstring markup to markdown


jhamman Jul 28, 2026
d02a6e1

Merge branch 'main' into feature/markdown-docstrings


d-v-b Aug 3, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


4 changes: 4 additions & 0 deletions
changes/4193.doc.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
Converted remaining reStructuredText-style double-backtick markup to Markdown
single backticks in the docstrings of `zarr.api.asynchronous`,
`zarr.api.synchronous`, `zarr.core.array`, `zarr.registry`, and
`zarr.storage._common`. No functional changes.

72 changes: 36 additions & 36 deletions
src/zarr/api/asynchronous.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -103,7 +103,7 @@

def _infer_overwrite(mode: AccessModeLiteral) -> bool:
 """
 Check that an ``AccessModeLiteral`` is compatible with overwriting an existing Zarr node.
 Check that an `AccessModeLiteral` is compatible with overwriting an existing Zarr node.
 """
 return mode in _OVERWRITE_MODES

Expand All@@ -112,9 +112,9 @@ def _warn_unimplemented_kwargs(kwargs: dict[str, Any]) -> None:
 """
 Emit a "not yet implemented" warning for each provided keyword argument that is not None.

 ``kwargs`` maps a keyword argument name to its supplied value. The ``stacklevel`` is chosen
 `kwargs` maps a keyword argument name to its supplied value. The `stacklevel` is chosen
 so the warning points at the caller of the public API function (the same location as an
 inline ``warnings.warn(..., stacklevel=2)`` would).
 inline `warnings.warn(..., stacklevel=2)` would).
 """
 for name, value in kwargs.items():
 if value is not None:
Expand DownExpand Up@@ -194,7 +194,7 @@ async def consolidate_metadata(

 Upon completion, the metadata of the root node in the Zarr hierarchy will be
 updated to include all the metadata of child nodes. For Stores that do
 not support consolidated metadata, this operation raises a ``TypeError``.
 not support consolidated metadata, this operation raises a `TypeError`.

 Parameters
 ----------
Expand All@@ -215,10 +215,10 @@ async def consolidate_metadata(
 Returns
 -------
 group: AsyncGroup
 The group, with the ``consolidated_metadata`` field set to include
 The group, with the `consolidated_metadata` field set to include
 the metadata of each child node. If the Store doesn't support
 consolidated metadata, this function raises a `TypeError`.
 See ``Store.supports_consolidated_metadata``.
 See `Store.supports_consolidated_metadata`.
 """
 store_path = await make_store_path(store, path=path)

Expand DownExpand Up@@ -420,7 +420,7 @@ async def open_consolidated(
 *args: Any, use_consolidated: Literal[True] = True, **kwargs: Any
) -> AsyncGroup:
 """
 Alias for [`open_group`][zarr.api.asynchronous.open_group] with ``use_consolidated=True``.
 Alias for [`open_group`][zarr.api.asynchronous.open_group] with `use_consolidated=True`.
 """
 if use_consolidated is not True:
 raise TypeError(
Expand DownExpand Up@@ -484,7 +484,7 @@ async def save_array(
 arr : ndarray
 NumPy array with data to save.
 zarr_format : {2, 3, None}, optional
 The zarr format to use when saving. The default is ``None``, which will
 The zarr format to use when saving. The default is `None`, which will
 use the default Zarr format defined in the global configuration object.
 path : str or None, optional
 The path within the store where the array will be saved.
Expand DownExpand Up@@ -745,12 +745,12 @@ async def create_group(
 path : str, optional
 Group path within store.
 overwrite : bool, optional
 If True, pre-existing data at ``path`` will be deleted before
 If True, pre-existing data at `path` will be deleted before
 creating the group.
 zarr_format : {2, 3, None}, optional
 The zarr format to use when saving.
 If no ``zarr_format`` is provided, the default format will be used.
 This default can be changed by modifying the value of ``default_zarr_format``
 If no `zarr_format` is provided, the default format will be used.
 This default can be changed by modifying the value of `default_zarr_format`
 in [`zarr.config`][zarr.config].
 storage_options : dict
 If using an fsspec URL to create the store, these will be passed to
Expand DownExpand Up@@ -828,17 +828,17 @@ async def open_group(
 Whether to use consolidated metadata.

 By default, consolidated metadata is used if it's present in the
 store (in the ``zarr.json`` for Zarr format 3 and in the ``.zmetadata`` file
 store (in the `zarr.json` for Zarr format 3 and in the `.zmetadata` file
 for Zarr format 2).

 To explicitly require consolidated metadata, set ``use_consolidated=True``,
 To explicitly require consolidated metadata, set `use_consolidated=True`,
 which will raise an exception if consolidated metadata is not found.

 To explicitly *not* use consolidated metadata, set ``use_consolidated=False``,
 To explicitly *not* use consolidated metadata, set `use_consolidated=False`,
 which will fall back to using the regular, non consolidated metadata.

 Zarr format 2 allowed configuring the key storing the consolidated metadata
 (``.zmetadata`` by default). Specify the custom key as ``use_consolidated``
 (`.zmetadata` by default). Specify the custom key as `use_consolidated`
 to load consolidated metadata from a non-default key.

 Returns
Expand DownExpand Up@@ -924,40 +924,40 @@ async def create(
 shape : int or tuple of ints
 Array shape.
 chunks : int or tuple of ints, optional
 Chunk shape. If True, will be guessed from ``shape`` and ``dtype``. If
 False, will be set to ``shape``, i.e., single chunk for the whole array.
 Chunk shape. If True, will be guessed from `shape` and `dtype`. If
 False, will be set to `shape`, i.e., single chunk for the whole array.
 If an int, the chunk size in each dimension will be given by the value
 of ``chunks``. Default is True.
 of `chunks`. Default is True.
 dtype : str or dtype, optional
 NumPy dtype.
 compressor : Codec, optional
 Primary compressor to compress chunk data.
 Zarr format 2 only. Zarr format 3 arrays should use ``codecs`` instead.
 Zarr format 2 only. Zarr format 3 arrays should use `codecs` instead.

 If neither ``compressor`` nor ``filters`` are provided, the default compressor
 If neither `compressor` nor `filters` are provided, the default compressor
 [`zarr.codecs.ZstdCodec`][] is used.

 If ``compressor`` is set to ``None``, no compression is used.
 If `compressor` is set to `None`, no compression is used.
 fill_value : Any, optional
 Fill value for the array.
 order : {'C', 'F'}, optional
 Deprecated in favor of the ``config`` keyword argument.
 Pass ``{'order': <value>}`` to ``create`` instead of using this parameter.
 Deprecated in favor of the `config` keyword argument.
 Pass `{'order': <value>}` to `create` instead of using this parameter.
 Memory layout to be used within each chunk.
 If not specified, the ``array.order`` parameter in the global config will be used.
 If not specified, the `array.order` parameter in the global config will be used.
 store : StoreLike or None, default=None
 StoreLike object to open. See the
 [storage documentation in the user guide][user-guide-store-like]
 for a description of all valid StoreLike values.
 synchronizer : object, optional
 Array synchronizer.
 overwrite : bool, optional
 If True, delete all pre-existing data in ``store`` at ``path`` before
 If True, delete all pre-existing data in `store` at `path` before
 creating the array.
 path : str, optional
 Path under which array is stored.
 chunk_store : StoreLike or None, default=None
 Separate storage for chunks. If not provided, ``store`` will be used
 Separate storage for chunks. If not provided, `store` will be used
 for storage of both chunks and metadata.
 filters : Iterable[Codec] | Literal["auto"], optional
 Iterable of filters to apply to each chunk of the array, in order, before serializing that
Expand All@@ -970,14 +970,14 @@ async def create(
 For Zarr format 2, a "filter" can be any numcodecs codec; you should ensure that the
 order of your filters is consistent with the behavior of each filter.

 The default value of ``"auto"`` instructs Zarr to use a default based on the data
 The default value of `"auto"` instructs Zarr to use a default based on the data
 type of the array and the Zarr format specified. For all data types in Zarr V3, and most
 data types in Zarr V2, the default filters are empty. The only cases where default filters
 are not empty is when the Zarr format is 2, and the data type is a variable-length data type like
 [`zarr.dtype.VariableLengthUTF8`][] or [`zarr.dtype.VariableLengthUTF8`][]. In these cases,
 the default filters contains a single element which is a codec specific to that particular data type.

 To create an array with no filters, provide an empty iterable or the value ``None``.
 To create an array with no filters, provide an empty iterable or the value `None`.
 cache_metadata : bool, optional
 If True, array configuration metadata will be cached for the
 lifetime of the object. If False, array metadata will be reloaded
Expand All@@ -993,17 +993,17 @@ async def create(
 A codec to encode object arrays, only needed if dtype=object.
 dimension_separator : {'.', '/'}, optional
 Separator placed between the dimensions of a chunk.
 Zarr format 2 only. Zarr format 3 arrays should use ``chunk_key_encoding`` instead.
 Zarr format 2 only. Zarr format 3 arrays should use `chunk_key_encoding` instead.
 write_empty_chunks : bool, optional
 Deprecated in favor of the ``config`` keyword argument.
 Pass ``{'write_empty_chunks': <value>}`` to ``create`` instead of using this parameter.
 Deprecated in favor of the `config` keyword argument.
 Pass `{'write_empty_chunks': <value>}` to `create` instead of using this parameter.
 If True, all chunks will be stored regardless of their
 contents. If False, each chunk is compared to the array's fill value
 prior to storing. If a chunk is uniformly equal to the fill value, then
 that chunk is not be stored, and the store entry for that chunk's key
 is deleted.
 zarr_format : {2, 3, None}, optional
 The Zarr format to use when creating an array. The default is ``None``,
 The Zarr format to use when creating an array. The default is `None`,
 which instructs Zarr to choose the default Zarr format value defined in the
 runtime configuration.
 meta_array : array-like, optional
Expand All@@ -1016,15 +1016,15 @@ async def create(
 chunk_key_encoding : ChunkKeyEncoding, optional
 A specification of how the chunk keys are represented in storage.
 Zarr format 3 only. Zarr format 2 arrays should use `dimension_separator` instead.
 Default is ``("default", "/")``.
 Default is `("default", "/")`.
 codecs : Sequence of Codecs or dicts, optional
 An iterable of Codec or dict serializations of Codecs. Zarr V3 only.

 The elements of ``codecs`` specify the transformation from array values to stored bytes.
 Zarr format 3 only. Zarr format 2 arrays should use ``filters`` and ``compressor`` instead.
 The elements of `codecs` specify the transformation from array values to stored bytes.
 Zarr format 3 only. Zarr format 2 arrays should use `filters` and `compressor` instead.

 If no codecs are provided, default codecs will be used based on the data type of the array.
 For most data types, the default codecs are the tuple ``(BytesCodec(), ZstdCodec())``;
 For most data types, the default codecs are the tuple `(BytesCodec(), ZstdCodec())`;
 data types that require a special [`zarr.abc.codec.ArrayBytesCodec`][], like variable-length strings or bytes,
 will use the [`zarr.abc.codec.ArrayBytesCodec`][] required for the data type instead of [`zarr.codecs.BytesCodec`][].
 dimension_names : Iterable[str | None] | None = None
Expand Down
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Force GitHub README to respect dark mode
(function() {
var style = document.createElement('style');
style.textContent = '
.markdown-body {
color-scheme: dark light;
}
.markdown-body pre { background: #161b22 !important; }
.markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }
.markdown-body table th, .markdown-body table td { border-color: #30363d !important; }
.markdown-body img { background: #0d1117; }
.markdown-body blockquote { border-left-color: #8b949e; }
.markdown-body hr { border-color: #30363d; }
';
document.head.appendChild(style);
})();
}
} catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
Convert rst double-backtick docstring markup to markdown by jhamman · Pull Request #4193 · zarr-developers/zarr-python · GitHub
Skip to content
Convert rst double-backtick docstring markup to markdown#4193

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

d-v-b
merged 2 commits into

from

Aug 3, 2026
 Merged


Convert rst double-backtick docstring markup to markdown
#4193
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
b148726

Convert rst double-backtick docstring markup to markdown


jhamman Jul 28, 2026
d02a6e1

Merge branch 'main' into feature/markdown-docstrings


d-v-b Aug 3, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


4 changes: 4 additions & 0 deletions
changes/4193.doc.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
Converted remaining reStructuredText-style double-backtick markup to Markdown
single backticks in the docstrings of `zarr.api.asynchronous`,
`zarr.api.synchronous`, `zarr.core.array`, `zarr.registry`, and
`zarr.storage._common`. No functional changes.

72 changes: 36 additions & 36 deletions
src/zarr/api/asynchronous.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -103,7 +103,7 @@

def _infer_overwrite(mode: AccessModeLiteral) -> bool:
 """
 Check that an ``AccessModeLiteral`` is compatible with overwriting an existing Zarr node.
 Check that an `AccessModeLiteral` is compatible with overwriting an existing Zarr node.
 """
 return mode in _OVERWRITE_MODES

Expand All@@ -112,9 +112,9 @@ def _warn_unimplemented_kwargs(kwargs: dict[str, Any]) -> None:
 """
 Emit a "not yet implemented" warning for each provided keyword argument that is not None.

 ``kwargs`` maps a keyword argument name to its supplied value. The ``stacklevel`` is chosen
 `kwargs` maps a keyword argument name to its supplied value. The `stacklevel` is chosen
 so the warning points at the caller of the public API function (the same location as an
 inline ``warnings.warn(..., stacklevel=2)`` would).
 inline `warnings.warn(..., stacklevel=2)` would).
 """
 for name, value in kwargs.items():
 if value is not None:
Expand DownExpand Up@@ -194,7 +194,7 @@ async def consolidate_metadata(

 Upon completion, the metadata of the root node in the Zarr hierarchy will be
 updated to include all the metadata of child nodes. For Stores that do
 not support consolidated metadata, this operation raises a ``TypeError``.
 not support consolidated metadata, this operation raises a `TypeError`.

 Parameters
 ----------
Expand All@@ -215,10 +215,10 @@ async def consolidate_metadata(
 Returns
 -------
 group: AsyncGroup
 The group, with the ``consolidated_metadata`` field set to include
 The group, with the `consolidated_metadata` field set to include
 the metadata of each child node. If the Store doesn't support
 consolidated metadata, this function raises a `TypeError`.
 See ``Store.supports_consolidated_metadata``.
 See `Store.supports_consolidated_metadata`.
 """
 store_path = await make_store_path(store, path=path)

Expand DownExpand Up@@ -420,7 +420,7 @@ async def open_consolidated(
 *args: Any, use_consolidated: Literal[True] = True, **kwargs: Any
) -> AsyncGroup:
 """
 Alias for [`open_group`][zarr.api.asynchronous.open_group] with ``use_consolidated=True``.
 Alias for [`open_group`][zarr.api.asynchronous.open_group] with `use_consolidated=True`.
 """
 if use_consolidated is not True:
 raise TypeError(
Expand DownExpand Up@@ -484,7 +484,7 @@ async def save_array(
 arr : ndarray
 NumPy array with data to save.
 zarr_format : {2, 3, None}, optional
 The zarr format to use when saving. The default is ``None``, which will
 The zarr format to use when saving. The default is `None`, which will
 use the default Zarr format defined in the global configuration object.
 path : str or None, optional
 The path within the store where the array will be saved.
Expand DownExpand Up@@ -745,12 +745,12 @@ async def create_group(
 path : str, optional
 Group path within store.
 overwrite : bool, optional
 If True, pre-existing data at ``path`` will be deleted before
 If True, pre-existing data at `path` will be deleted before
 creating the group.
 zarr_format : {2, 3, None}, optional
 The zarr format to use when saving.
 If no ``zarr_format`` is provided, the default format will be used.
 This default can be changed by modifying the value of ``default_zarr_format``
 If no `zarr_format` is provided, the default format will be used.
 This default can be changed by modifying the value of `default_zarr_format`
 in [`zarr.config`][zarr.config].
 storage_options : dict
 If using an fsspec URL to create the store, these will be passed to
Expand DownExpand Up@@ -828,17 +828,17 @@ async def open_group(
 Whether to use consolidated metadata.

 By default, consolidated metadata is used if it's present in the
 store (in the ``zarr.json`` for Zarr format 3 and in the ``.zmetadata`` file
 store (in the `zarr.json` for Zarr format 3 and in the `.zmetadata` file
 for Zarr format 2).

 To explicitly require consolidated metadata, set ``use_consolidated=True``,
 To explicitly require consolidated metadata, set `use_consolidated=True`,
 which will raise an exception if consolidated metadata is not found.

 To explicitly *not* use consolidated metadata, set ``use_consolidated=False``,
 To explicitly *not* use consolidated metadata, set `use_consolidated=False`,
 which will fall back to using the regular, non consolidated metadata.

 Zarr format 2 allowed configuring the key storing the consolidated metadata
 (``.zmetadata`` by default). Specify the custom key as ``use_consolidated``
 (`.zmetadata` by default). Specify the custom key as `use_consolidated`
 to load consolidated metadata from a non-default key.

 Returns
Expand DownExpand Up@@ -924,40 +924,40 @@ async def create(
 shape : int or tuple of ints
 Array shape.
 chunks : int or tuple of ints, optional
 Chunk shape. If True, will be guessed from ``shape`` and ``dtype``. If
 False, will be set to ``shape``, i.e., single chunk for the whole array.
 Chunk shape. If True, will be guessed from `shape` and `dtype`. If
 False, will be set to `shape`, i.e., single chunk for the whole array.
 If an int, the chunk size in each dimension will be given by the value
 of ``chunks``. Default is True.
 of `chunks`. Default is True.
 dtype : str or dtype, optional
 NumPy dtype.
 compressor : Codec, optional
 Primary compressor to compress chunk data.
 Zarr format 2 only. Zarr format 3 arrays should use ``codecs`` instead.
 Zarr format 2 only. Zarr format 3 arrays should use `codecs` instead.

 If neither ``compressor`` nor ``filters`` are provided, the default compressor
 If neither `compressor` nor `filters` are provided, the default compressor
 [`zarr.codecs.ZstdCodec`][] is used.

 If ``compressor`` is set to ``None``, no compression is used.
 If `compressor` is set to `None`, no compression is used.
 fill_value : Any, optional
 Fill value for the array.
 order : {'C', 'F'}, optional
 Deprecated in favor of the ``config`` keyword argument.
 Pass ``{'order': <value>}`` to ``create`` instead of using this parameter.
 Deprecated in favor of the `config` keyword argument.
 Pass `{'order': <value>}` to `create` instead of using this parameter.
 Memory layout to be used within each chunk.
 If not specified, the ``array.order`` parameter in the global config will be used.
 If not specified, the `array.order` parameter in the global config will be used.
 store : StoreLike or None, default=None
 StoreLike object to open. See the
 [storage documentation in the user guide][user-guide-store-like]
 for a description of all valid StoreLike values.
 synchronizer : object, optional
 Array synchronizer.
 overwrite : bool, optional
 If True, delete all pre-existing data in ``store`` at ``path`` before
 If True, delete all pre-existing data in `store` at `path` before
 creating the array.
 path : str, optional
 Path under which array is stored.
 chunk_store : StoreLike or None, default=None
 Separate storage for chunks. If not provided, ``store`` will be used
 Separate storage for chunks. If not provided, `store` will be used
 for storage of both chunks and metadata.
 filters : Iterable[Codec] | Literal["auto"], optional
 Iterable of filters to apply to each chunk of the array, in order, before serializing that
Expand All@@ -970,14 +970,14 @@ async def create(
 For Zarr format 2, a "filter" can be any numcodecs codec; you should ensure that the
 order of your filters is consistent with the behavior of each filter.

 The default value of ``"auto"`` instructs Zarr to use a default based on the data
 The default value of `"auto"` instructs Zarr to use a default based on the data
 type of the array and the Zarr format specified. For all data types in Zarr V3, and most
 data types in Zarr V2, the default filters are empty. The only cases where default filters
 are not empty is when the Zarr format is 2, and the data type is a variable-length data type like
 [`zarr.dtype.VariableLengthUTF8`][] or [`zarr.dtype.VariableLengthUTF8`][]. In these cases,
 the default filters contains a single element which is a codec specific to that particular data type.

 To create an array with no filters, provide an empty iterable or the value ``None``.
 To create an array with no filters, provide an empty iterable or the value `None`.
 cache_metadata : bool, optional
 If True, array configuration metadata will be cached for the
 lifetime of the object. If False, array metadata will be reloaded
Expand All@@ -993,17 +993,17 @@ async def create(
 A codec to encode object arrays, only needed if dtype=object.
 dimension_separator : {'.', '/'}, optional
 Separator placed between the dimensions of a chunk.
 Zarr format 2 only. Zarr format 3 arrays should use ``chunk_key_encoding`` instead.
 Zarr format 2 only. Zarr format 3 arrays should use `chunk_key_encoding` instead.
 write_empty_chunks : bool, optional
 Deprecated in favor of the ``config`` keyword argument.
 Pass ``{'write_empty_chunks': <value>}`` to ``create`` instead of using this parameter.
 Deprecated in favor of the `config` keyword argument.
 Pass `{'write_empty_chunks': <value>}` to `create` instead of using this parameter.
 If True, all chunks will be stored regardless of their
 contents. If False, each chunk is compared to the array's fill value
 prior to storing. If a chunk is uniformly equal to the fill value, then
 that chunk is not be stored, and the store entry for that chunk's key
 is deleted.
 zarr_format : {2, 3, None}, optional
 The Zarr format to use when creating an array. The default is ``None``,
 The Zarr format to use when creating an array. The default is `None`,
 which instructs Zarr to choose the default Zarr format value defined in the
 runtime configuration.
 meta_array : array-like, optional
Expand All@@ -1016,15 +1016,15 @@ async def create(
 chunk_key_encoding : ChunkKeyEncoding, optional
 A specification of how the chunk keys are represented in storage.
 Zarr format 3 only. Zarr format 2 arrays should use `dimension_separator` instead.
 Default is ``("default", "/")``.
 Default is `("default", "/")`.
 codecs : Sequence of Codecs or dicts, optional
 An iterable of Codec or dict serializations of Codecs. Zarr V3 only.

 The elements of ``codecs`` specify the transformation from array values to stored bytes.
 Zarr format 3 only. Zarr format 2 arrays should use ``filters`` and ``compressor`` instead.
 The elements of `codecs` specify the transformation from array values to stored bytes.
 Zarr format 3 only. Zarr format 2 arrays should use `filters` and `compressor` instead.

 If no codecs are provided, default codecs will be used based on the data type of the array.
 For most data types, the default codecs are the tuple ``(BytesCodec(), ZstdCodec())``;
 For most data types, the default codecs are the tuple `(BytesCodec(), ZstdCodec())`;
 data types that require a special [`zarr.abc.codec.ArrayBytesCodec`][], like variable-length strings or bytes,
 will use the [`zarr.abc.codec.ArrayBytesCodec`][] required for the data type instead of [`zarr.codecs.BytesCodec`][].
 dimension_names : Iterable[str | None] | None = None
Expand Down
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Highlight search terms from Google/DuckDuckGo/Bing referrer
(function() {
var ref = document.referrer;
var terms = [];
if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {
var url = new URL(ref);
var q = url.searchParams.get('q') || url.searchParams.get('p');
if (q) {
terms = q.split(/\s+/).filter(function(t) { return t.length > 2; });
}
}
if (terms.length === 0) return;
var style = document.createElement('style');
style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';
document.head.appendChild(style);
function highlight(node) {
if (node.nodeType === 3) { // text node
var text = node.textContent;
var found = false;
terms.forEach(function(term) {
var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\]\\]/g, '\\') + ')', 'gi');
if (regex.test(text)) {
found = true;
var frag = document.createDocumentFragment();
var parts = text.split(regex);
parts.forEach(function(part, i) {
if (i % 2 === 0) {
frag.appendChild(document.createTextNode(part));
} else {
var span = document.createElement('span');
span.className = 'userscript-highlight';
span.textContent = part;
frag.appendChild(span);
}
});
node.parentNode.replaceChild(frag, node);
}
});
} else if (node.nodeType === 1 && node.childNodes) { // element
var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];
if (!skipTags.includes(node.tagName)) {
Array.from(node.childNodes).forEach(highlight);
}
}
}
highlight(document.body);
// Re-highlight on dynamic content
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1 || node.nodeType === 3) highlight(node);
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
Convert rst double-backtick docstring markup to markdown by jhamman · Pull Request #4193 · zarr-developers/zarr-python · GitHub
Skip to content
Convert rst double-backtick docstring markup to markdown#4193

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

d-v-b
merged 2 commits into

from

Aug 3, 2026
 Merged


Convert rst double-backtick docstring markup to markdown
#4193
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
b148726

Convert rst double-backtick docstring markup to markdown


jhamman Jul 28, 2026
d02a6e1

Merge branch 'main' into feature/markdown-docstrings


d-v-b Aug 3, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


4 changes: 4 additions & 0 deletions
changes/4193.doc.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
Converted remaining reStructuredText-style double-backtick markup to Markdown
single backticks in the docstrings of `zarr.api.asynchronous`,
`zarr.api.synchronous`, `zarr.core.array`, `zarr.registry`, and
`zarr.storage._common`. No functional changes.

72 changes: 36 additions & 36 deletions
src/zarr/api/asynchronous.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -103,7 +103,7 @@

def _infer_overwrite(mode: AccessModeLiteral) -> bool:
 """
 Check that an ``AccessModeLiteral`` is compatible with overwriting an existing Zarr node.
 Check that an `AccessModeLiteral` is compatible with overwriting an existing Zarr node.
 """
 return mode in _OVERWRITE_MODES

Expand All@@ -112,9 +112,9 @@ def _warn_unimplemented_kwargs(kwargs: dict[str, Any]) -> None:
 """
 Emit a "not yet implemented" warning for each provided keyword argument that is not None.

 ``kwargs`` maps a keyword argument name to its supplied value. The ``stacklevel`` is chosen
 `kwargs` maps a keyword argument name to its supplied value. The `stacklevel` is chosen
 so the warning points at the caller of the public API function (the same location as an
 inline ``warnings.warn(..., stacklevel=2)`` would).
 inline `warnings.warn(..., stacklevel=2)` would).
 """
 for name, value in kwargs.items():
 if value is not None:
Expand DownExpand Up@@ -194,7 +194,7 @@ async def consolidate_metadata(

 Upon completion, the metadata of the root node in the Zarr hierarchy will be
 updated to include all the metadata of child nodes. For Stores that do
 not support consolidated metadata, this operation raises a ``TypeError``.
 not support consolidated metadata, this operation raises a `TypeError`.

 Parameters
 ----------
Expand All@@ -215,10 +215,10 @@ async def consolidate_metadata(
 Returns
 -------
 group: AsyncGroup
 The group, with the ``consolidated_metadata`` field set to include
 The group, with the `consolidated_metadata` field set to include
 the metadata of each child node. If the Store doesn't support
 consolidated metadata, this function raises a `TypeError`.
 See ``Store.supports_consolidated_metadata``.
 See `Store.supports_consolidated_metadata`.
 """
 store_path = await make_store_path(store, path=path)

Expand DownExpand Up@@ -420,7 +420,7 @@ async def open_consolidated(
 *args: Any, use_consolidated: Literal[True] = True, **kwargs: Any
) -> AsyncGroup:
 """
 Alias for [`open_group`][zarr.api.asynchronous.open_group] with ``use_consolidated=True``.
 Alias for [`open_group`][zarr.api.asynchronous.open_group] with `use_consolidated=True`.
 """
 if use_consolidated is not True:
 raise TypeError(
Expand DownExpand Up@@ -484,7 +484,7 @@ async def save_array(
 arr : ndarray
 NumPy array with data to save.
 zarr_format : {2, 3, None}, optional
 The zarr format to use when saving. The default is ``None``, which will
 The zarr format to use when saving. The default is `None`, which will
 use the default Zarr format defined in the global configuration object.
 path : str or None, optional
 The path within the store where the array will be saved.
Expand DownExpand Up@@ -745,12 +745,12 @@ async def create_group(
 path : str, optional
 Group path within store.
 overwrite : bool, optional
 If True, pre-existing data at ``path`` will be deleted before
 If True, pre-existing data at `path` will be deleted before
 creating the group.
 zarr_format : {2, 3, None}, optional
 The zarr format to use when saving.
 If no ``zarr_format`` is provided, the default format will be used.
 This default can be changed by modifying the value of ``default_zarr_format``
 If no `zarr_format` is provided, the default format will be used.
 This default can be changed by modifying the value of `default_zarr_format`
 in [`zarr.config`][zarr.config].
 storage_options : dict
 If using an fsspec URL to create the store, these will be passed to
Expand DownExpand Up@@ -828,17 +828,17 @@ async def open_group(
 Whether to use consolidated metadata.

 By default, consolidated metadata is used if it's present in the
 store (in the ``zarr.json`` for Zarr format 3 and in the ``.zmetadata`` file
 store (in the `zarr.json` for Zarr format 3 and in the `.zmetadata` file
 for Zarr format 2).

 To explicitly require consolidated metadata, set ``use_consolidated=True``,
 To explicitly require consolidated metadata, set `use_consolidated=True`,
 which will raise an exception if consolidated metadata is not found.

 To explicitly *not* use consolidated metadata, set ``use_consolidated=False``,
 To explicitly *not* use consolidated metadata, set `use_consolidated=False`,
 which will fall back to using the regular, non consolidated metadata.

 Zarr format 2 allowed configuring the key storing the consolidated metadata
 (``.zmetadata`` by default). Specify the custom key as ``use_consolidated``
 (`.zmetadata` by default). Specify the custom key as `use_consolidated`
 to load consolidated metadata from a non-default key.

 Returns
Expand DownExpand Up@@ -924,40 +924,40 @@ async def create(
 shape : int or tuple of ints
 Array shape.
 chunks : int or tuple of ints, optional
 Chunk shape. If True, will be guessed from ``shape`` and ``dtype``. If
 False, will be set to ``shape``, i.e., single chunk for the whole array.
 Chunk shape. If True, will be guessed from `shape` and `dtype`. If
 False, will be set to `shape`, i.e., single chunk for the whole array.
 If an int, the chunk size in each dimension will be given by the value
 of ``chunks``. Default is True.
 of `chunks`. Default is True.
 dtype : str or dtype, optional
 NumPy dtype.
 compressor : Codec, optional
 Primary compressor to compress chunk data.
 Zarr format 2 only. Zarr format 3 arrays should use ``codecs`` instead.
 Zarr format 2 only. Zarr format 3 arrays should use `codecs` instead.

 If neither ``compressor`` nor ``filters`` are provided, the default compressor
 If neither `compressor` nor `filters` are provided, the default compressor
 [`zarr.codecs.ZstdCodec`][] is used.

 If ``compressor`` is set to ``None``, no compression is used.
 If `compressor` is set to `None`, no compression is used.
 fill_value : Any, optional
 Fill value for the array.
 order : {'C', 'F'}, optional
 Deprecated in favor of the ``config`` keyword argument.
 Pass ``{'order': <value>}`` to ``create`` instead of using this parameter.
 Deprecated in favor of the `config` keyword argument.
 Pass `{'order': <value>}` to `create` instead of using this parameter.
 Memory layout to be used within each chunk.
 If not specified, the ``array.order`` parameter in the global config will be used.
 If not specified, the `array.order` parameter in the global config will be used.
 store : StoreLike or None, default=None
 StoreLike object to open. See the
 [storage documentation in the user guide][user-guide-store-like]
 for a description of all valid StoreLike values.
 synchronizer : object, optional
 Array synchronizer.
 overwrite : bool, optional
 If True, delete all pre-existing data in ``store`` at ``path`` before
 If True, delete all pre-existing data in `store` at `path` before
 creating the array.
 path : str, optional
 Path under which array is stored.
 chunk_store : StoreLike or None, default=None
 Separate storage for chunks. If not provided, ``store`` will be used
 Separate storage for chunks. If not provided, `store` will be used
 for storage of both chunks and metadata.
 filters : Iterable[Codec] | Literal["auto"], optional
 Iterable of filters to apply to each chunk of the array, in order, before serializing that
Expand All@@ -970,14 +970,14 @@ async def create(
 For Zarr format 2, a "filter" can be any numcodecs codec; you should ensure that the
 order of your filters is consistent with the behavior of each filter.

 The default value of ``"auto"`` instructs Zarr to use a default based on the data
 The default value of `"auto"` instructs Zarr to use a default based on the data
 type of the array and the Zarr format specified. For all data types in Zarr V3, and most
 data types in Zarr V2, the default filters are empty. The only cases where default filters
 are not empty is when the Zarr format is 2, and the data type is a variable-length data type like
 [`zarr.dtype.VariableLengthUTF8`][] or [`zarr.dtype.VariableLengthUTF8`][]. In these cases,
 the default filters contains a single element which is a codec specific to that particular data type.

 To create an array with no filters, provide an empty iterable or the value ``None``.
 To create an array with no filters, provide an empty iterable or the value `None`.
 cache_metadata : bool, optional
 If True, array configuration metadata will be cached for the
 lifetime of the object. If False, array metadata will be reloaded
Expand All@@ -993,17 +993,17 @@ async def create(
 A codec to encode object arrays, only needed if dtype=object.
 dimension_separator : {'.', '/'}, optional
 Separator placed between the dimensions of a chunk.
 Zarr format 2 only. Zarr format 3 arrays should use ``chunk_key_encoding`` instead.
 Zarr format 2 only. Zarr format 3 arrays should use `chunk_key_encoding` instead.
 write_empty_chunks : bool, optional
 Deprecated in favor of the ``config`` keyword argument.
 Pass ``{'write_empty_chunks': <value>}`` to ``create`` instead of using this parameter.
 Deprecated in favor of the `config` keyword argument.
 Pass `{'write_empty_chunks': <value>}` to `create` instead of using this parameter.
 If True, all chunks will be stored regardless of their
 contents. If False, each chunk is compared to the array's fill value
 prior to storing. If a chunk is uniformly equal to the fill value, then
 that chunk is not be stored, and the store entry for that chunk's key
 is deleted.
 zarr_format : {2, 3, None}, optional
 The Zarr format to use when creating an array. The default is ``None``,
 The Zarr format to use when creating an array. The default is `None`,
 which instructs Zarr to choose the default Zarr format value defined in the
 runtime configuration.
 meta_array : array-like, optional
Expand All@@ -1016,15 +1016,15 @@ async def create(
 chunk_key_encoding : ChunkKeyEncoding, optional
 A specification of how the chunk keys are represented in storage.
 Zarr format 3 only. Zarr format 2 arrays should use `dimension_separator` instead.
 Default is ``("default", "/")``.
 Default is `("default", "/")`.
 codecs : Sequence of Codecs or dicts, optional
 An iterable of Codec or dict serializations of Codecs. Zarr V3 only.

 The elements of ``codecs`` specify the transformation from array values to stored bytes.
 Zarr format 3 only. Zarr format 2 arrays should use ``filters`` and ``compressor`` instead.
 The elements of `codecs` specify the transformation from array values to stored bytes.
 Zarr format 3 only. Zarr format 2 arrays should use `filters` and `compressor` instead.

 If no codecs are provided, default codecs will be used based on the data type of the array.
 For most data types, the default codecs are the tuple ``(BytesCodec(), ZstdCodec())``;
 For most data types, the default codecs are the tuple `(BytesCodec(), ZstdCodec())`;
 data types that require a special [`zarr.abc.codec.ArrayBytesCodec`][], like variable-length strings or bytes,
 will use the [`zarr.abc.codec.ArrayBytesCodec`][] required for the data type instead of [`zarr.codecs.BytesCodec`][].
 dimension_names : Iterable[str | None] | None = None
Expand Down
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Strip utm_, fbclid, gclid, etc. from all links on page
(function() {
var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',
'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',
'ref', 'ref_src', 'source', 'medium', 'campaign'];
function cleanUrl(url) {
try {
var u = new URL(url, window.location.origin);
var changed = false;
trackingParams.forEach(function(p) {
if (u.searchParams.has(p)) {
u.searchParams.delete(p);
changed = true;
}
});
return changed ? u.toString() : url;
} catch (e) {
return url;
}
}
function cleanLinks() {
document.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
cleanLinks();
var observer = new MutationObserver(function(mutations) {
mutations.forEach(function(m) {
m.addedNodes.forEach(function(node) {
if (node.nodeType === 1) {
if (node.tagName === 'A') cleanLinks();
node.querySelectorAll('a[href]').forEach(function(a) {
var clean = cleanUrl(a.href);
if (clean !== a.href) a.href = clean;
});
}
});
});
});
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); }
})();
(function(){
try {
var __m = "youtube.com";
var __re = new RegExp('^' + "youtube\\.com" + '
Convert rst double-backtick docstring markup to markdown by jhamman · Pull Request #4193 · zarr-developers/zarr-python · GitHub
Skip to content
Convert rst double-backtick docstring markup to markdown#4193

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

d-v-b
merged 2 commits into

from

Aug 3, 2026
 Merged


Convert rst double-backtick docstring markup to markdown
#4193
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
b148726

Convert rst double-backtick docstring markup to markdown


jhamman Jul 28, 2026
d02a6e1

Merge branch 'main' into feature/markdown-docstrings


d-v-b Aug 3, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


4 changes: 4 additions & 0 deletions
changes/4193.doc.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
Converted remaining reStructuredText-style double-backtick markup to Markdown
single backticks in the docstrings of `zarr.api.asynchronous`,
`zarr.api.synchronous`, `zarr.core.array`, `zarr.registry`, and
`zarr.storage._common`. No functional changes.

72 changes: 36 additions & 36 deletions
src/zarr/api/asynchronous.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -103,7 +103,7 @@

def _infer_overwrite(mode: AccessModeLiteral) -> bool:
 """
 Check that an ``AccessModeLiteral`` is compatible with overwriting an existing Zarr node.
 Check that an `AccessModeLiteral` is compatible with overwriting an existing Zarr node.
 """
 return mode in _OVERWRITE_MODES

Expand All@@ -112,9 +112,9 @@ def _warn_unimplemented_kwargs(kwargs: dict[str, Any]) -> None:
 """
 Emit a "not yet implemented" warning for each provided keyword argument that is not None.

 ``kwargs`` maps a keyword argument name to its supplied value. The ``stacklevel`` is chosen
 `kwargs` maps a keyword argument name to its supplied value. The `stacklevel` is chosen
 so the warning points at the caller of the public API function (the same location as an
 inline ``warnings.warn(..., stacklevel=2)`` would).
 inline `warnings.warn(..., stacklevel=2)` would).
 """
 for name, value in kwargs.items():
 if value is not None:
Expand DownExpand Up@@ -194,7 +194,7 @@ async def consolidate_metadata(

 Upon completion, the metadata of the root node in the Zarr hierarchy will be
 updated to include all the metadata of child nodes. For Stores that do
 not support consolidated metadata, this operation raises a ``TypeError``.
 not support consolidated metadata, this operation raises a `TypeError`.

 Parameters
 ----------
Expand All@@ -215,10 +215,10 @@ async def consolidate_metadata(
 Returns
 -------
 group: AsyncGroup
 The group, with the ``consolidated_metadata`` field set to include
 The group, with the `consolidated_metadata` field set to include
 the metadata of each child node. If the Store doesn't support
 consolidated metadata, this function raises a `TypeError`.
 See ``Store.supports_consolidated_metadata``.
 See `Store.supports_consolidated_metadata`.
 """
 store_path = await make_store_path(store, path=path)

Expand DownExpand Up@@ -420,7 +420,7 @@ async def open_consolidated(
 *args: Any, use_consolidated: Literal[True] = True, **kwargs: Any
) -> AsyncGroup:
 """
 Alias for [`open_group`][zarr.api.asynchronous.open_group] with ``use_consolidated=True``.
 Alias for [`open_group`][zarr.api.asynchronous.open_group] with `use_consolidated=True`.
 """
 if use_consolidated is not True:
 raise TypeError(
Expand DownExpand Up@@ -484,7 +484,7 @@ async def save_array(
 arr : ndarray
 NumPy array with data to save.
 zarr_format : {2, 3, None}, optional
 The zarr format to use when saving. The default is ``None``, which will
 The zarr format to use when saving. The default is `None`, which will
 use the default Zarr format defined in the global configuration object.
 path : str or None, optional
 The path within the store where the array will be saved.
Expand DownExpand Up@@ -745,12 +745,12 @@ async def create_group(
 path : str, optional
 Group path within store.
 overwrite : bool, optional
 If True, pre-existing data at ``path`` will be deleted before
 If True, pre-existing data at `path` will be deleted before
 creating the group.
 zarr_format : {2, 3, None}, optional
 The zarr format to use when saving.
 If no ``zarr_format`` is provided, the default format will be used.
 This default can be changed by modifying the value of ``default_zarr_format``
 If no `zarr_format` is provided, the default format will be used.
 This default can be changed by modifying the value of `default_zarr_format`
 in [`zarr.config`][zarr.config].
 storage_options : dict
 If using an fsspec URL to create the store, these will be passed to
Expand DownExpand Up@@ -828,17 +828,17 @@ async def open_group(
 Whether to use consolidated metadata.

 By default, consolidated metadata is used if it's present in the
 store (in the ``zarr.json`` for Zarr format 3 and in the ``.zmetadata`` file
 store (in the `zarr.json` for Zarr format 3 and in the `.zmetadata` file
 for Zarr format 2).

 To explicitly require consolidated metadata, set ``use_consolidated=True``,
 To explicitly require consolidated metadata, set `use_consolidated=True`,
 which will raise an exception if consolidated metadata is not found.

 To explicitly *not* use consolidated metadata, set ``use_consolidated=False``,
 To explicitly *not* use consolidated metadata, set `use_consolidated=False`,
 which will fall back to using the regular, non consolidated metadata.

 Zarr format 2 allowed configuring the key storing the consolidated metadata
 (``.zmetadata`` by default). Specify the custom key as ``use_consolidated``
 (`.zmetadata` by default). Specify the custom key as `use_consolidated`
 to load consolidated metadata from a non-default key.

 Returns
Expand DownExpand Up@@ -924,40 +924,40 @@ async def create(
 shape : int or tuple of ints
 Array shape.
 chunks : int or tuple of ints, optional
 Chunk shape. If True, will be guessed from ``shape`` and ``dtype``. If
 False, will be set to ``shape``, i.e., single chunk for the whole array.
 Chunk shape. If True, will be guessed from `shape` and `dtype`. If
 False, will be set to `shape`, i.e., single chunk for the whole array.
 If an int, the chunk size in each dimension will be given by the value
 of ``chunks``. Default is True.
 of `chunks`. Default is True.
 dtype : str or dtype, optional
 NumPy dtype.
 compressor : Codec, optional
 Primary compressor to compress chunk data.
 Zarr format 2 only. Zarr format 3 arrays should use ``codecs`` instead.
 Zarr format 2 only. Zarr format 3 arrays should use `codecs` instead.

 If neither ``compressor`` nor ``filters`` are provided, the default compressor
 If neither `compressor` nor `filters` are provided, the default compressor
 [`zarr.codecs.ZstdCodec`][] is used.

 If ``compressor`` is set to ``None``, no compression is used.
 If `compressor` is set to `None`, no compression is used.
 fill_value : Any, optional
 Fill value for the array.
 order : {'C', 'F'}, optional
 Deprecated in favor of the ``config`` keyword argument.
 Pass ``{'order': <value>}`` to ``create`` instead of using this parameter.
 Deprecated in favor of the `config` keyword argument.
 Pass `{'order': <value>}` to `create` instead of using this parameter.
 Memory layout to be used within each chunk.
 If not specified, the ``array.order`` parameter in the global config will be used.
 If not specified, the `array.order` parameter in the global config will be used.
 store : StoreLike or None, default=None
 StoreLike object to open. See the
 [storage documentation in the user guide][user-guide-store-like]
 for a description of all valid StoreLike values.
 synchronizer : object, optional
 Array synchronizer.
 overwrite : bool, optional
 If True, delete all pre-existing data in ``store`` at ``path`` before
 If True, delete all pre-existing data in `store` at `path` before
 creating the array.
 path : str, optional
 Path under which array is stored.
 chunk_store : StoreLike or None, default=None
 Separate storage for chunks. If not provided, ``store`` will be used
 Separate storage for chunks. If not provided, `store` will be used
 for storage of both chunks and metadata.
 filters : Iterable[Codec] | Literal["auto"], optional
 Iterable of filters to apply to each chunk of the array, in order, before serializing that
Expand All@@ -970,14 +970,14 @@ async def create(
 For Zarr format 2, a "filter" can be any numcodecs codec; you should ensure that the
 order of your filters is consistent with the behavior of each filter.

 The default value of ``"auto"`` instructs Zarr to use a default based on the data
 The default value of `"auto"` instructs Zarr to use a default based on the data
 type of the array and the Zarr format specified. For all data types in Zarr V3, and most
 data types in Zarr V2, the default filters are empty. The only cases where default filters
 are not empty is when the Zarr format is 2, and the data type is a variable-length data type like
 [`zarr.dtype.VariableLengthUTF8`][] or [`zarr.dtype.VariableLengthUTF8`][]. In these cases,
 the default filters contains a single element which is a codec specific to that particular data type.

 To create an array with no filters, provide an empty iterable or the value ``None``.
 To create an array with no filters, provide an empty iterable or the value `None`.
 cache_metadata : bool, optional
 If True, array configuration metadata will be cached for the
 lifetime of the object. If False, array metadata will be reloaded
Expand All@@ -993,17 +993,17 @@ async def create(
 A codec to encode object arrays, only needed if dtype=object.
 dimension_separator : {'.', '/'}, optional
 Separator placed between the dimensions of a chunk.
 Zarr format 2 only. Zarr format 3 arrays should use ``chunk_key_encoding`` instead.
 Zarr format 2 only. Zarr format 3 arrays should use `chunk_key_encoding` instead.
 write_empty_chunks : bool, optional
 Deprecated in favor of the ``config`` keyword argument.
 Pass ``{'write_empty_chunks': <value>}`` to ``create`` instead of using this parameter.
 Deprecated in favor of the `config` keyword argument.
 Pass `{'write_empty_chunks': <value>}` to `create` instead of using this parameter.
 If True, all chunks will be stored regardless of their
 contents. If False, each chunk is compared to the array's fill value
 prior to storing. If a chunk is uniformly equal to the fill value, then
 that chunk is not be stored, and the store entry for that chunk's key
 is deleted.
 zarr_format : {2, 3, None}, optional
 The Zarr format to use when creating an array. The default is ``None``,
 The Zarr format to use when creating an array. The default is `None`,
 which instructs Zarr to choose the default Zarr format value defined in the
 runtime configuration.
 meta_array : array-like, optional
Expand All@@ -1016,15 +1016,15 @@ async def create(
 chunk_key_encoding : ChunkKeyEncoding, optional
 A specification of how the chunk keys are represented in storage.
 Zarr format 3 only. Zarr format 2 arrays should use `dimension_separator` instead.
 Default is ``("default", "/")``.
 Default is `("default", "/")`.
 codecs : Sequence of Codecs or dicts, optional
 An iterable of Codec or dict serializations of Codecs. Zarr V3 only.

 The elements of ``codecs`` specify the transformation from array values to stored bytes.
 Zarr format 3 only. Zarr format 2 arrays should use ``filters`` and ``compressor`` instead.
 The elements of `codecs` specify the transformation from array values to stored bytes.
 Zarr format 3 only. Zarr format 2 arrays should use `filters` and `compressor` instead.

 If no codecs are provided, default codecs will be used based on the data type of the array.
 For most data types, the default codecs are the tuple ``(BytesCodec(), ZstdCodec())``;
 For most data types, the default codecs are the tuple `(BytesCodec(), ZstdCodec())`;
 data types that require a special [`zarr.abc.codec.ArrayBytesCodec`][], like variable-length strings or bytes,
 will use the [`zarr.abc.codec.ArrayBytesCodec`][] required for the data type instead of [`zarr.codecs.BytesCodec`][].
 dimension_names : Iterable[str | None] | None = None
Expand Down
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Auto-enable theater mode on YouTube
(function() {
function tryTheater() {
var btn = document.querySelector('button[aria-label="Theater mode"], ytd-player #player button[title="Theater mode"]');
if (btn && !btn.classList.contains('activated')) {
btn.click();
}
}
// Try immediately
tryTheater();
// Try after navigation (SPA)
var lastUrl = location.href;
setInterval(function() {
if (location.href !== lastUrl) {
lastUrl = location.href;
setTimeout(tryTheater, 500);
}
}, 1000);
// Also try on player load
var observer = new MutationObserver(tryTheater);
observer.observe(document.body, { childList: true, subtree: true });
})();
}
} catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
Convert rst double-backtick docstring markup to markdown by jhamman · Pull Request #4193 · zarr-developers/zarr-python · GitHub
Skip to content
Convert rst double-backtick docstring markup to markdown#4193

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

d-v-b
merged 2 commits into

from

Aug 3, 2026
 Merged


Convert rst double-backtick docstring markup to markdown
#4193
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
b148726

Convert rst double-backtick docstring markup to markdown


jhamman Jul 28, 2026
d02a6e1

Merge branch 'main' into feature/markdown-docstrings


d-v-b Aug 3, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


4 changes: 4 additions & 0 deletions
changes/4193.doc.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
Converted remaining reStructuredText-style double-backtick markup to Markdown
single backticks in the docstrings of `zarr.api.asynchronous`,
`zarr.api.synchronous`, `zarr.core.array`, `zarr.registry`, and
`zarr.storage._common`. No functional changes.

72 changes: 36 additions & 36 deletions
src/zarr/api/asynchronous.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -103,7 +103,7 @@

def _infer_overwrite(mode: AccessModeLiteral) -> bool:
 """
 Check that an ``AccessModeLiteral`` is compatible with overwriting an existing Zarr node.
 Check that an `AccessModeLiteral` is compatible with overwriting an existing Zarr node.
 """
 return mode in _OVERWRITE_MODES

Expand All@@ -112,9 +112,9 @@ def _warn_unimplemented_kwargs(kwargs: dict[str, Any]) -> None:
 """
 Emit a "not yet implemented" warning for each provided keyword argument that is not None.

 ``kwargs`` maps a keyword argument name to its supplied value. The ``stacklevel`` is chosen
 `kwargs` maps a keyword argument name to its supplied value. The `stacklevel` is chosen
 so the warning points at the caller of the public API function (the same location as an
 inline ``warnings.warn(..., stacklevel=2)`` would).
 inline `warnings.warn(..., stacklevel=2)` would).
 """
 for name, value in kwargs.items():
 if value is not None:
Expand DownExpand Up@@ -194,7 +194,7 @@ async def consolidate_metadata(

 Upon completion, the metadata of the root node in the Zarr hierarchy will be
 updated to include all the metadata of child nodes. For Stores that do
 not support consolidated metadata, this operation raises a ``TypeError``.
 not support consolidated metadata, this operation raises a `TypeError`.

 Parameters
 ----------
Expand All@@ -215,10 +215,10 @@ async def consolidate_metadata(
 Returns
 -------
 group: AsyncGroup
 The group, with the ``consolidated_metadata`` field set to include
 The group, with the `consolidated_metadata` field set to include
 the metadata of each child node. If the Store doesn't support
 consolidated metadata, this function raises a `TypeError`.
 See ``Store.supports_consolidated_metadata``.
 See `Store.supports_consolidated_metadata`.
 """
 store_path = await make_store_path(store, path=path)

Expand DownExpand Up@@ -420,7 +420,7 @@ async def open_consolidated(
 *args: Any, use_consolidated: Literal[True] = True, **kwargs: Any
) -> AsyncGroup:
 """
 Alias for [`open_group`][zarr.api.asynchronous.open_group] with ``use_consolidated=True``.
 Alias for [`open_group`][zarr.api.asynchronous.open_group] with `use_consolidated=True`.
 """
 if use_consolidated is not True:
 raise TypeError(
Expand DownExpand Up@@ -484,7 +484,7 @@ async def save_array(
 arr : ndarray
 NumPy array with data to save.
 zarr_format : {2, 3, None}, optional
 The zarr format to use when saving. The default is ``None``, which will
 The zarr format to use when saving. The default is `None`, which will
 use the default Zarr format defined in the global configuration object.
 path : str or None, optional
 The path within the store where the array will be saved.
Expand DownExpand Up@@ -745,12 +745,12 @@ async def create_group(
 path : str, optional
 Group path within store.
 overwrite : bool, optional
 If True, pre-existing data at ``path`` will be deleted before
 If True, pre-existing data at `path` will be deleted before
 creating the group.
 zarr_format : {2, 3, None}, optional
 The zarr format to use when saving.
 If no ``zarr_format`` is provided, the default format will be used.
 This default can be changed by modifying the value of ``default_zarr_format``
 If no `zarr_format` is provided, the default format will be used.
 This default can be changed by modifying the value of `default_zarr_format`
 in [`zarr.config`][zarr.config].
 storage_options : dict
 If using an fsspec URL to create the store, these will be passed to
Expand DownExpand Up@@ -828,17 +828,17 @@ async def open_group(
 Whether to use consolidated metadata.

 By default, consolidated metadata is used if it's present in the
 store (in the ``zarr.json`` for Zarr format 3 and in the ``.zmetadata`` file
 store (in the `zarr.json` for Zarr format 3 and in the `.zmetadata` file
 for Zarr format 2).

 To explicitly require consolidated metadata, set ``use_consolidated=True``,
 To explicitly require consolidated metadata, set `use_consolidated=True`,
 which will raise an exception if consolidated metadata is not found.

 To explicitly *not* use consolidated metadata, set ``use_consolidated=False``,
 To explicitly *not* use consolidated metadata, set `use_consolidated=False`,
 which will fall back to using the regular, non consolidated metadata.

 Zarr format 2 allowed configuring the key storing the consolidated metadata
 (``.zmetadata`` by default). Specify the custom key as ``use_consolidated``
 (`.zmetadata` by default). Specify the custom key as `use_consolidated`
 to load consolidated metadata from a non-default key.

 Returns
Expand DownExpand Up@@ -924,40 +924,40 @@ async def create(
 shape : int or tuple of ints
 Array shape.
 chunks : int or tuple of ints, optional
 Chunk shape. If True, will be guessed from ``shape`` and ``dtype``. If
 False, will be set to ``shape``, i.e., single chunk for the whole array.
 Chunk shape. If True, will be guessed from `shape` and `dtype`. If
 False, will be set to `shape`, i.e., single chunk for the whole array.
 If an int, the chunk size in each dimension will be given by the value
 of ``chunks``. Default is True.
 of `chunks`. Default is True.
 dtype : str or dtype, optional
 NumPy dtype.
 compressor : Codec, optional
 Primary compressor to compress chunk data.
 Zarr format 2 only. Zarr format 3 arrays should use ``codecs`` instead.
 Zarr format 2 only. Zarr format 3 arrays should use `codecs` instead.

 If neither ``compressor`` nor ``filters`` are provided, the default compressor
 If neither `compressor` nor `filters` are provided, the default compressor
 [`zarr.codecs.ZstdCodec`][] is used.

 If ``compressor`` is set to ``None``, no compression is used.
 If `compressor` is set to `None`, no compression is used.
 fill_value : Any, optional
 Fill value for the array.
 order : {'C', 'F'}, optional
 Deprecated in favor of the ``config`` keyword argument.
 Pass ``{'order': <value>}`` to ``create`` instead of using this parameter.
 Deprecated in favor of the `config` keyword argument.
 Pass `{'order': <value>}` to `create` instead of using this parameter.
 Memory layout to be used within each chunk.
 If not specified, the ``array.order`` parameter in the global config will be used.
 If not specified, the `array.order` parameter in the global config will be used.
 store : StoreLike or None, default=None
 StoreLike object to open. See the
 [storage documentation in the user guide][user-guide-store-like]
 for a description of all valid StoreLike values.
 synchronizer : object, optional
 Array synchronizer.
 overwrite : bool, optional
 If True, delete all pre-existing data in ``store`` at ``path`` before
 If True, delete all pre-existing data in `store` at `path` before
 creating the array.
 path : str, optional
 Path under which array is stored.
 chunk_store : StoreLike or None, default=None
 Separate storage for chunks. If not provided, ``store`` will be used
 Separate storage for chunks. If not provided, `store` will be used
 for storage of both chunks and metadata.
 filters : Iterable[Codec] | Literal["auto"], optional
 Iterable of filters to apply to each chunk of the array, in order, before serializing that
Expand All@@ -970,14 +970,14 @@ async def create(
 For Zarr format 2, a "filter" can be any numcodecs codec; you should ensure that the
 order of your filters is consistent with the behavior of each filter.

 The default value of ``"auto"`` instructs Zarr to use a default based on the data
 The default value of `"auto"` instructs Zarr to use a default based on the data
 type of the array and the Zarr format specified. For all data types in Zarr V3, and most
 data types in Zarr V2, the default filters are empty. The only cases where default filters
 are not empty is when the Zarr format is 2, and the data type is a variable-length data type like
 [`zarr.dtype.VariableLengthUTF8`][] or [`zarr.dtype.VariableLengthUTF8`][]. In these cases,
 the default filters contains a single element which is a codec specific to that particular data type.

 To create an array with no filters, provide an empty iterable or the value ``None``.
 To create an array with no filters, provide an empty iterable or the value `None`.
 cache_metadata : bool, optional
 If True, array configuration metadata will be cached for the
 lifetime of the object. If False, array metadata will be reloaded
Expand All@@ -993,17 +993,17 @@ async def create(
 A codec to encode object arrays, only needed if dtype=object.
 dimension_separator : {'.', '/'}, optional
 Separator placed between the dimensions of a chunk.
 Zarr format 2 only. Zarr format 3 arrays should use ``chunk_key_encoding`` instead.
 Zarr format 2 only. Zarr format 3 arrays should use `chunk_key_encoding` instead.
 write_empty_chunks : bool, optional
 Deprecated in favor of the ``config`` keyword argument.
 Pass ``{'write_empty_chunks': <value>}`` to ``create`` instead of using this parameter.
 Deprecated in favor of the `config` keyword argument.
 Pass `{'write_empty_chunks': <value>}` to `create` instead of using this parameter.
 If True, all chunks will be stored regardless of their
 contents. If False, each chunk is compared to the array's fill value
 prior to storing. If a chunk is uniformly equal to the fill value, then
 that chunk is not be stored, and the store entry for that chunk's key
 is deleted.
 zarr_format : {2, 3, None}, optional
 The Zarr format to use when creating an array. The default is ``None``,
 The Zarr format to use when creating an array. The default is `None`,
 which instructs Zarr to choose the default Zarr format value defined in the
 runtime configuration.
 meta_array : array-like, optional
Expand All@@ -1016,15 +1016,15 @@ async def create(
 chunk_key_encoding : ChunkKeyEncoding, optional
 A specification of how the chunk keys are represented in storage.
 Zarr format 3 only. Zarr format 2 arrays should use `dimension_separator` instead.
 Default is ``("default", "/")``.
 Default is `("default", "/")`.
 codecs : Sequence of Codecs or dicts, optional
 An iterable of Codec or dict serializations of Codecs. Zarr V3 only.

 The elements of ``codecs`` specify the transformation from array values to stored bytes.
 Zarr format 3 only. Zarr format 2 arrays should use ``filters`` and ``compressor`` instead.
 The elements of `codecs` specify the transformation from array values to stored bytes.
 Zarr format 3 only. Zarr format 2 arrays should use `filters` and `compressor` instead.

 If no codecs are provided, default codecs will be used based on the data type of the array.
 For most data types, the default codecs are the tuple ``(BytesCodec(), ZstdCodec())``;
 For most data types, the default codecs are the tuple `(BytesCodec(), ZstdCodec())`;
 data types that require a special [`zarr.abc.codec.ArrayBytesCodec`][], like variable-length strings or bytes,
 will use the [`zarr.abc.codec.ArrayBytesCodec`][] required for the data type instead of [`zarr.codecs.BytesCodec`][].
 dimension_names : Iterable[str | None] | None = None
Expand Down
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Remove or un-stick sticky/fixed headers that block content
(function() {
function unstick() {
document.querySelectorAll('header, nav, [role="banner"], .header, .navbar, .sticky, .fixed-top, [style*="position: fixed"], [style*="position:sticky"]').forEach(function(el) {
if (el.style.position === 'fixed' || el.style.position === 'sticky' || getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {
el.style.position = 'static';
el.style.top = 'auto';
el.style.zIndex = 'auto';
}
});
}
unstick();
var observer = new MutationObserver(unstick);
observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });
})();
}
} catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); }
})();
(function(){
try {
var __m = "*";
var __re = new RegExp('^' + ".*" + '
Convert rst double-backtick docstring markup to markdown by jhamman · Pull Request #4193 · zarr-developers/zarr-python · GitHub
Skip to content
Convert rst double-backtick docstring markup to markdown#4193

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

d-v-b
merged 2 commits into

from

Aug 3, 2026
 Merged


Convert rst double-backtick docstring markup to markdown
#4193
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
b148726

Convert rst double-backtick docstring markup to markdown


jhamman Jul 28, 2026
d02a6e1

Merge branch 'main' into feature/markdown-docstrings


d-v-b Aug 3, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


4 changes: 4 additions & 0 deletions
changes/4193.doc.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
Converted remaining reStructuredText-style double-backtick markup to Markdown
single backticks in the docstrings of `zarr.api.asynchronous`,
`zarr.api.synchronous`, `zarr.core.array`, `zarr.registry`, and
`zarr.storage._common`. No functional changes.

72 changes: 36 additions & 36 deletions
src/zarr/api/asynchronous.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -103,7 +103,7 @@

def _infer_overwrite(mode: AccessModeLiteral) -> bool:
 """
 Check that an ``AccessModeLiteral`` is compatible with overwriting an existing Zarr node.
 Check that an `AccessModeLiteral` is compatible with overwriting an existing Zarr node.
 """
 return mode in _OVERWRITE_MODES

Expand All@@ -112,9 +112,9 @@ def _warn_unimplemented_kwargs(kwargs: dict[str, Any]) -> None:
 """
 Emit a "not yet implemented" warning for each provided keyword argument that is not None.

 ``kwargs`` maps a keyword argument name to its supplied value. The ``stacklevel`` is chosen
 `kwargs` maps a keyword argument name to its supplied value. The `stacklevel` is chosen
 so the warning points at the caller of the public API function (the same location as an
 inline ``warnings.warn(..., stacklevel=2)`` would).
 inline `warnings.warn(..., stacklevel=2)` would).
 """
 for name, value in kwargs.items():
 if value is not None:
Expand DownExpand Up@@ -194,7 +194,7 @@ async def consolidate_metadata(

 Upon completion, the metadata of the root node in the Zarr hierarchy will be
 updated to include all the metadata of child nodes. For Stores that do
 not support consolidated metadata, this operation raises a ``TypeError``.
 not support consolidated metadata, this operation raises a `TypeError`.

 Parameters
 ----------
Expand All@@ -215,10 +215,10 @@ async def consolidate_metadata(
 Returns
 -------
 group: AsyncGroup
 The group, with the ``consolidated_metadata`` field set to include
 The group, with the `consolidated_metadata` field set to include
 the metadata of each child node. If the Store doesn't support
 consolidated metadata, this function raises a `TypeError`.
 See ``Store.supports_consolidated_metadata``.
 See `Store.supports_consolidated_metadata`.
 """
 store_path = await make_store_path(store, path=path)

Expand DownExpand Up@@ -420,7 +420,7 @@ async def open_consolidated(
 *args: Any, use_consolidated: Literal[True] = True, **kwargs: Any
) -> AsyncGroup:
 """
 Alias for [`open_group`][zarr.api.asynchronous.open_group] with ``use_consolidated=True``.
 Alias for [`open_group`][zarr.api.asynchronous.open_group] with `use_consolidated=True`.
 """
 if use_consolidated is not True:
 raise TypeError(
Expand DownExpand Up@@ -484,7 +484,7 @@ async def save_array(
 arr : ndarray
 NumPy array with data to save.
 zarr_format : {2, 3, None}, optional
 The zarr format to use when saving. The default is ``None``, which will
 The zarr format to use when saving. The default is `None`, which will
 use the default Zarr format defined in the global configuration object.
 path : str or None, optional
 The path within the store where the array will be saved.
Expand DownExpand Up@@ -745,12 +745,12 @@ async def create_group(
 path : str, optional
 Group path within store.
 overwrite : bool, optional
 If True, pre-existing data at ``path`` will be deleted before
 If True, pre-existing data at `path` will be deleted before
 creating the group.
 zarr_format : {2, 3, None}, optional
 The zarr format to use when saving.
 If no ``zarr_format`` is provided, the default format will be used.
 This default can be changed by modifying the value of ``default_zarr_format``
 If no `zarr_format` is provided, the default format will be used.
 This default can be changed by modifying the value of `default_zarr_format`
 in [`zarr.config`][zarr.config].
 storage_options : dict
 If using an fsspec URL to create the store, these will be passed to
Expand DownExpand Up@@ -828,17 +828,17 @@ async def open_group(
 Whether to use consolidated metadata.

 By default, consolidated metadata is used if it's present in the
 store (in the ``zarr.json`` for Zarr format 3 and in the ``.zmetadata`` file
 store (in the `zarr.json` for Zarr format 3 and in the `.zmetadata` file
 for Zarr format 2).

 To explicitly require consolidated metadata, set ``use_consolidated=True``,
 To explicitly require consolidated metadata, set `use_consolidated=True`,
 which will raise an exception if consolidated metadata is not found.

 To explicitly *not* use consolidated metadata, set ``use_consolidated=False``,
 To explicitly *not* use consolidated metadata, set `use_consolidated=False`,
 which will fall back to using the regular, non consolidated metadata.

 Zarr format 2 allowed configuring the key storing the consolidated metadata
 (``.zmetadata`` by default). Specify the custom key as ``use_consolidated``
 (`.zmetadata` by default). Specify the custom key as `use_consolidated`
 to load consolidated metadata from a non-default key.

 Returns
Expand DownExpand Up@@ -924,40 +924,40 @@ async def create(
 shape : int or tuple of ints
 Array shape.
 chunks : int or tuple of ints, optional
 Chunk shape. If True, will be guessed from ``shape`` and ``dtype``. If
 False, will be set to ``shape``, i.e., single chunk for the whole array.
 Chunk shape. If True, will be guessed from `shape` and `dtype`. If
 False, will be set to `shape`, i.e., single chunk for the whole array.
 If an int, the chunk size in each dimension will be given by the value
 of ``chunks``. Default is True.
 of `chunks`. Default is True.
 dtype : str or dtype, optional
 NumPy dtype.
 compressor : Codec, optional
 Primary compressor to compress chunk data.
 Zarr format 2 only. Zarr format 3 arrays should use ``codecs`` instead.
 Zarr format 2 only. Zarr format 3 arrays should use `codecs` instead.

 If neither ``compressor`` nor ``filters`` are provided, the default compressor
 If neither `compressor` nor `filters` are provided, the default compressor
 [`zarr.codecs.ZstdCodec`][] is used.

 If ``compressor`` is set to ``None``, no compression is used.
 If `compressor` is set to `None`, no compression is used.
 fill_value : Any, optional
 Fill value for the array.
 order : {'C', 'F'}, optional
 Deprecated in favor of the ``config`` keyword argument.
 Pass ``{'order': <value>}`` to ``create`` instead of using this parameter.
 Deprecated in favor of the `config` keyword argument.
 Pass `{'order': <value>}` to `create` instead of using this parameter.
 Memory layout to be used within each chunk.
 If not specified, the ``array.order`` parameter in the global config will be used.
 If not specified, the `array.order` parameter in the global config will be used.
 store : StoreLike or None, default=None
 StoreLike object to open. See the
 [storage documentation in the user guide][user-guide-store-like]
 for a description of all valid StoreLike values.
 synchronizer : object, optional
 Array synchronizer.
 overwrite : bool, optional
 If True, delete all pre-existing data in ``store`` at ``path`` before
 If True, delete all pre-existing data in `store` at `path` before
 creating the array.
 path : str, optional
 Path under which array is stored.
 chunk_store : StoreLike or None, default=None
 Separate storage for chunks. If not provided, ``store`` will be used
 Separate storage for chunks. If not provided, `store` will be used
 for storage of both chunks and metadata.
 filters : Iterable[Codec] | Literal["auto"], optional
 Iterable of filters to apply to each chunk of the array, in order, before serializing that
Expand All@@ -970,14 +970,14 @@ async def create(
 For Zarr format 2, a "filter" can be any numcodecs codec; you should ensure that the
 order of your filters is consistent with the behavior of each filter.

 The default value of ``"auto"`` instructs Zarr to use a default based on the data
 The default value of `"auto"` instructs Zarr to use a default based on the data
 type of the array and the Zarr format specified. For all data types in Zarr V3, and most
 data types in Zarr V2, the default filters are empty. The only cases where default filters
 are not empty is when the Zarr format is 2, and the data type is a variable-length data type like
 [`zarr.dtype.VariableLengthUTF8`][] or [`zarr.dtype.VariableLengthUTF8`][]. In these cases,
 the default filters contains a single element which is a codec specific to that particular data type.

 To create an array with no filters, provide an empty iterable or the value ``None``.
 To create an array with no filters, provide an empty iterable or the value `None`.
 cache_metadata : bool, optional
 If True, array configuration metadata will be cached for the
 lifetime of the object. If False, array metadata will be reloaded
Expand All@@ -993,17 +993,17 @@ async def create(
 A codec to encode object arrays, only needed if dtype=object.
 dimension_separator : {'.', '/'}, optional
 Separator placed between the dimensions of a chunk.
 Zarr format 2 only. Zarr format 3 arrays should use ``chunk_key_encoding`` instead.
 Zarr format 2 only. Zarr format 3 arrays should use `chunk_key_encoding` instead.
 write_empty_chunks : bool, optional
 Deprecated in favor of the ``config`` keyword argument.
 Pass ``{'write_empty_chunks': <value>}`` to ``create`` instead of using this parameter.
 Deprecated in favor of the `config` keyword argument.
 Pass `{'write_empty_chunks': <value>}` to `create` instead of using this parameter.
 If True, all chunks will be stored regardless of their
 contents. If False, each chunk is compared to the array's fill value
 prior to storing. If a chunk is uniformly equal to the fill value, then
 that chunk is not be stored, and the store entry for that chunk's key
 is deleted.
 zarr_format : {2, 3, None}, optional
 The Zarr format to use when creating an array. The default is ``None``,
 The Zarr format to use when creating an array. The default is `None`,
 which instructs Zarr to choose the default Zarr format value defined in the
 runtime configuration.
 meta_array : array-like, optional
Expand All@@ -1016,15 +1016,15 @@ async def create(
 chunk_key_encoding : ChunkKeyEncoding, optional
 A specification of how the chunk keys are represented in storage.
 Zarr format 3 only. Zarr format 2 arrays should use `dimension_separator` instead.
 Default is ``("default", "/")``.
 Default is `("default", "/")`.
 codecs : Sequence of Codecs or dicts, optional
 An iterable of Codec or dict serializations of Codecs. Zarr V3 only.

 The elements of ``codecs`` specify the transformation from array values to stored bytes.
 Zarr format 3 only. Zarr format 2 arrays should use ``filters`` and ``compressor`` instead.
 The elements of `codecs` specify the transformation from array values to stored bytes.
 Zarr format 3 only. Zarr format 2 arrays should use `filters` and `compressor` instead.

 If no codecs are provided, default codecs will be used based on the data type of the array.
 For most data types, the default codecs are the tuple ``(BytesCodec(), ZstdCodec())``;
 For most data types, the default codecs are the tuple `(BytesCodec(), ZstdCodec())`;
 data types that require a special [`zarr.abc.codec.ArrayBytesCodec`][], like variable-length strings or bytes,
 will use the [`zarr.abc.codec.ArrayBytesCodec`][] required for the data type instead of [`zarr.codecs.BytesCodec`][].
 dimension_names : Iterable[str | None] | None = None
Expand Down
Loading
Loading

, 'i');
if (__m === '*' || __re.test(location.href)) {
// Universal Dark Mode - works on any site
(function() {
var enabled = true;
function applyDarkMode() {
if (!enabled) return;
// Create style element if it doesn't exist
var style = document.getElementById('universal-dark-mode-style');
if (!style) {
style = document.createElement('style');
style.id = 'universal-dark-mode-style';
document.head.appendChild(style);
}
// Dark mode CSS - inverts colors but preserves images/video
style.textContent = '
/* Invert everything except media */
html {
filter: invert(1) hue-rotate(180deg) !important;
background: #1a1a2e !important;
}
/* Restore images, videos, iframes, canvas */
img, video, iframe, canvas, svg, picture, [style*="background-image"] {
filter: invert(1) hue-rotate(180deg) !important;
}
/* Preserve specific elements that should not be inverted */
.no-dark-mode, .no-dark-mode *,
[data-theme="light"], [data-theme="light"],
.ace_editor, .ace_editor *,
.CodeMirror, .CodeMirror *,
.monaco-editor, .monaco-editor *,
.markdown-body pre, .markdown-body pre *,
.highlight, .highlight *,
pre code, pre code * {
filter: none !important;
}
/* Fix common UI elements */
.modal, .popup, .dropdown-menu, .tooltip, .popover {
filter: invert(1) hue-rotate(180deg) !important;
background: #2d2d44 !important;
border-color: #444 !important;
}
/* Scrollbars */
::-webkit-scrollbar { background: #1a1a2e !important; }
::-webkit-scrollbar-thumb { background: #444 !important; }
::-webkit-scrollbar-thumb:hover { background: #555 !important; }
/* Selection */
::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }
';
}
function removeDarkMode() {
var style = document.getElementById('universal-dark-mode-style');
if (style) style.remove();
}
// Toggle with Alt+Shift+D
document.addEventListener('keydown', function(e) {
if (e.altKey && e.shiftKey && e.key === 'D') {
e.preventDefault();
enabled = !enabled;
if (enabled) {
applyDarkMode();
console.log('[Universal Dark Mode] Enabled');
} else {
removeDarkMode();
console.log('[Universal Dark Mode] Disabled');
}
}
});
// Apply on load
applyDarkMode();
// Re-apply on dynamic content
var observer = new MutationObserver(function(mutations) {
if (enabled && !document.getElementById('universal-dark-mode-style')) {
applyDarkMode();
}
});
observer.observe(document.head, { childList: true });
console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');
})();
}
} catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); }
})();
})();
Convert rst double-backtick docstring markup to markdown by jhamman · Pull Request #4193 · zarr-developers/zarr-python · GitHub
Skip to content
Convert rst double-backtick docstring markup to markdown#4193

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Merged

d-v-b
merged 2 commits into

from

Aug 3, 2026
 Merged


Convert rst double-backtick docstring markup to markdown
#4193
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


2 commits


Select commit
Hold shift + click to select a range
b148726

Convert rst double-backtick docstring markup to markdown


jhamman Jul 28, 2026
d02a6e1

Merge branch 'main' into feature/markdown-docstrings


d-v-b Aug 3, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


4 changes: 4 additions & 0 deletions
changes/4193.doc.md

View file


Open in desktop

Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
Converted remaining reStructuredText-style double-backtick markup to Markdown
single backticks in the docstrings of `zarr.api.asynchronous`,
`zarr.api.synchronous`, `zarr.core.array`, `zarr.registry`, and
`zarr.storage._common`. No functional changes.

72 changes: 36 additions & 36 deletions
src/zarr/api/asynchronous.py

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -103,7 +103,7 @@

def _infer_overwrite(mode: AccessModeLiteral) -> bool:
 """
 Check that an ``AccessModeLiteral`` is compatible with overwriting an existing Zarr node.
 Check that an `AccessModeLiteral` is compatible with overwriting an existing Zarr node.
 """
 return mode in _OVERWRITE_MODES

Expand All@@ -112,9 +112,9 @@ def _warn_unimplemented_kwargs(kwargs: dict[str, Any]) -> None:
 """
 Emit a "not yet implemented" warning for each provided keyword argument that is not None.

 ``kwargs`` maps a keyword argument name to its supplied value. The ``stacklevel`` is chosen
 `kwargs` maps a keyword argument name to its supplied value. The `stacklevel` is chosen
 so the warning points at the caller of the public API function (the same location as an
 inline ``warnings.warn(..., stacklevel=2)`` would).
 inline `warnings.warn(..., stacklevel=2)` would).
 """
 for name, value in kwargs.items():
 if value is not None:
Expand DownExpand Up@@ -194,7 +194,7 @@ async def consolidate_metadata(

 Upon completion, the metadata of the root node in the Zarr hierarchy will be
 updated to include all the metadata of child nodes. For Stores that do
 not support consolidated metadata, this operation raises a ``TypeError``.
 not support consolidated metadata, this operation raises a `TypeError`.

 Parameters
 ----------
Expand All@@ -215,10 +215,10 @@ async def consolidate_metadata(
 Returns
 -------
 group: AsyncGroup
 The group, with the ``consolidated_metadata`` field set to include
 The group, with the `consolidated_metadata` field set to include
 the metadata of each child node. If the Store doesn't support
 consolidated metadata, this function raises a `TypeError`.
 See ``Store.supports_consolidated_metadata``.
 See `Store.supports_consolidated_metadata`.
 """
 store_path = await make_store_path(store, path=path)

Expand DownExpand Up@@ -420,7 +420,7 @@ async def open_consolidated(
 *args: Any, use_consolidated: Literal[True] = True, **kwargs: Any
) -> AsyncGroup:
 """
 Alias for [`open_group`][zarr.api.asynchronous.open_group] with ``use_consolidated=True``.
 Alias for [`open_group`][zarr.api.asynchronous.open_group] with `use_consolidated=True`.
 """
 if use_consolidated is not True:
 raise TypeError(
Expand DownExpand Up@@ -484,7 +484,7 @@ async def save_array(
 arr : ndarray
 NumPy array with data to save.
 zarr_format : {2, 3, None}, optional
 The zarr format to use when saving. The default is ``None``, which will
 The zarr format to use when saving. The default is `None`, which will
 use the default Zarr format defined in the global configuration object.
 path : str or None, optional
 The path within the store where the array will be saved.
Expand DownExpand Up@@ -745,12 +745,12 @@ async def create_group(
 path : str, optional
 Group path within store.
 overwrite : bool, optional
 If True, pre-existing data at ``path`` will be deleted before
 If True, pre-existing data at `path` will be deleted before
 creating the group.
 zarr_format : {2, 3, None}, optional
 The zarr format to use when saving.
 If no ``zarr_format`` is provided, the default format will be used.
 This default can be changed by modifying the value of ``default_zarr_format``
 If no `zarr_format` is provided, the default format will be used.
 This default can be changed by modifying the value of `default_zarr_format`
 in [`zarr.config`][zarr.config].
 storage_options : dict
 If using an fsspec URL to create the store, these will be passed to
Expand DownExpand Up@@ -828,17 +828,17 @@ async def open_group(
 Whether to use consolidated metadata.

 By default, consolidated metadata is used if it's present in the
 store (in the ``zarr.json`` for Zarr format 3 and in the ``.zmetadata`` file
 store (in the `zarr.json` for Zarr format 3 and in the `.zmetadata` file
 for Zarr format 2).

 To explicitly require consolidated metadata, set ``use_consolidated=True``,
 To explicitly require consolidated metadata, set `use_consolidated=True`,
 which will raise an exception if consolidated metadata is not found.

 To explicitly *not* use consolidated metadata, set ``use_consolidated=False``,
 To explicitly *not* use consolidated metadata, set `use_consolidated=False`,
 which will fall back to using the regular, non consolidated metadata.

 Zarr format 2 allowed configuring the key storing the consolidated metadata
 (``.zmetadata`` by default). Specify the custom key as ``use_consolidated``
 (`.zmetadata` by default). Specify the custom key as `use_consolidated`
 to load consolidated metadata from a non-default key.

 Returns
Expand DownExpand Up@@ -924,40 +924,40 @@ async def create(
 shape : int or tuple of ints
 Array shape.
 chunks : int or tuple of ints, optional
 Chunk shape. If True, will be guessed from ``shape`` and ``dtype``. If
 False, will be set to ``shape``, i.e., single chunk for the whole array.
 Chunk shape. If True, will be guessed from `shape` and `dtype`. If
 False, will be set to `shape`, i.e., single chunk for the whole array.
 If an int, the chunk size in each dimension will be given by the value
 of ``chunks``. Default is True.
 of `chunks`. Default is True.
 dtype : str or dtype, optional
 NumPy dtype.
 compressor : Codec, optional
 Primary compressor to compress chunk data.
 Zarr format 2 only. Zarr format 3 arrays should use ``codecs`` instead.
 Zarr format 2 only. Zarr format 3 arrays should use `codecs` instead.

 If neither ``compressor`` nor ``filters`` are provided, the default compressor
 If neither `compressor` nor `filters` are provided, the default compressor
 [`zarr.codecs.ZstdCodec`][] is used.

 If ``compressor`` is set to ``None``, no compression is used.
 If `compressor` is set to `None`, no compression is used.
 fill_value : Any, optional
 Fill value for the array.
 order : {'C', 'F'}, optional
 Deprecated in favor of the ``config`` keyword argument.
 Pass ``{'order': <value>}`` to ``create`` instead of using this parameter.
 Deprecated in favor of the `config` keyword argument.
 Pass `{'order': <value>}` to `create` instead of using this parameter.
 Memory layout to be used within each chunk.
 If not specified, the ``array.order`` parameter in the global config will be used.
 If not specified, the `array.order` parameter in the global config will be used.
 store : StoreLike or None, default=None
 StoreLike object to open. See the
 [storage documentation in the user guide][user-guide-store-like]
 for a description of all valid StoreLike values.
 synchronizer : object, optional
 Array synchronizer.
 overwrite : bool, optional
 If True, delete all pre-existing data in ``store`` at ``path`` before
 If True, delete all pre-existing data in `store` at `path` before
 creating the array.
 path : str, optional
 Path under which array is stored.
 chunk_store : StoreLike or None, default=None
 Separate storage for chunks. If not provided, ``store`` will be used
 Separate storage for chunks. If not provided, `store` will be used
 for storage of both chunks and metadata.
 filters : Iterable[Codec] | Literal["auto"], optional
 Iterable of filters to apply to each chunk of the array, in order, before serializing that
Expand All@@ -970,14 +970,14 @@ async def create(
 For Zarr format 2, a "filter" can be any numcodecs codec; you should ensure that the
 order of your filters is consistent with the behavior of each filter.

 The default value of ``"auto"`` instructs Zarr to use a default based on the data
 The default value of `"auto"` instructs Zarr to use a default based on the data
 type of the array and the Zarr format specified. For all data types in Zarr V3, and most
 data types in Zarr V2, the default filters are empty. The only cases where default filters
 are not empty is when the Zarr format is 2, and the data type is a variable-length data type like
 [`zarr.dtype.VariableLengthUTF8`][] or [`zarr.dtype.VariableLengthUTF8`][]. In these cases,
 the default filters contains a single element which is a codec specific to that particular data type.

 To create an array with no filters, provide an empty iterable or the value ``None``.
 To create an array with no filters, provide an empty iterable or the value `None`.
 cache_metadata : bool, optional
 If True, array configuration metadata will be cached for the
 lifetime of the object. If False, array metadata will be reloaded
Expand All@@ -993,17 +993,17 @@ async def create(
 A codec to encode object arrays, only needed if dtype=object.
 dimension_separator : {'.', '/'}, optional
 Separator placed between the dimensions of a chunk.
 Zarr format 2 only. Zarr format 3 arrays should use ``chunk_key_encoding`` instead.
 Zarr format 2 only. Zarr format 3 arrays should use `chunk_key_encoding` instead.
 write_empty_chunks : bool, optional
 Deprecated in favor of the ``config`` keyword argument.
 Pass ``{'write_empty_chunks': <value>}`` to ``create`` instead of using this parameter.
 Deprecated in favor of the `config` keyword argument.
 Pass `{'write_empty_chunks': <value>}` to `create` instead of using this parameter.
 If True, all chunks will be stored regardless of their
 contents. If False, each chunk is compared to the array's fill value
 prior to storing. If a chunk is uniformly equal to the fill value, then
 that chunk is not be stored, and the store entry for that chunk's key
 is deleted.
 zarr_format : {2, 3, None}, optional
 The Zarr format to use when creating an array. The default is ``None``,
 The Zarr format to use when creating an array. The default is `None`,
 which instructs Zarr to choose the default Zarr format value defined in the
 runtime configuration.
 meta_array : array-like, optional
Expand All@@ -1016,15 +1016,15 @@ async def create(
 chunk_key_encoding : ChunkKeyEncoding, optional
 A specification of how the chunk keys are represented in storage.
 Zarr format 3 only. Zarr format 2 arrays should use `dimension_separator` instead.
 Default is ``("default", "/")``.
 Default is `("default", "/")`.
 codecs : Sequence of Codecs or dicts, optional
 An iterable of Codec or dict serializations of Codecs. Zarr V3 only.

 The elements of ``codecs`` specify the transformation from array values to stored bytes.
 Zarr format 3 only. Zarr format 2 arrays should use ``filters`` and ``compressor`` instead.
 The elements of `codecs` specify the transformation from array values to stored bytes.
 Zarr format 3 only. Zarr format 2 arrays should use `filters` and `compressor` instead.

 If no codecs are provided, default codecs will be used based on the data type of the array.
 For most data types, the default codecs are the tuple ``(BytesCodec(), ZstdCodec())``;
 For most data types, the default codecs are the tuple `(BytesCodec(), ZstdCodec())`;
 data types that require a special [`zarr.abc.codec.ArrayBytesCodec`][], like variable-length strings or bytes,
 will use the [`zarr.abc.codec.ArrayBytesCodec`][] required for the data type instead of [`zarr.codecs.BytesCodec`][].
 dimension_names : Iterable[str | None] | None = None
Expand Down
Loading
Loading