Deploying to gh-pages from @ 2d56d32 🚀

Author: ev-br

_sources/changelog.md.txt

@@ -1,5 +1,73 @@
 # Changelog
 
+## 2.3 (2025-XX-XX)
+
+### Major Changes
+
+- The default version of the array API standard is now 2024.12. Previous versions can
+  still be enabled via the [flags API](array-api-strict-flags).
+
+  Note that this support is still relatively untested. Please [report any
+  issues](https://github.com/data-apis/array-api-strict/issues) you find.
+
+- Binary elementwise functions now accept python scalars: the only requirement is that
+  at least one of the arguments must be an array; the other argument may be either
+  a python scalar or an array. Python scalars are handled in accordance with the
+  type promotion rules, as specified by the standard.
+  This change unifies the behavior of binary functions and their matching operators,
+  (where available), such as `multiply(x1, x2)` and `__mul__(self, other)`.
+  
+  `where` accepts arrays or scalars as its 2nd and 3rd arguments, `x1` and `x2`.
+  The first argument, `condition`, must be an array.
+
+  `result_type` accepts arrays and scalars and computes the result dtype according
+  to the promotion rules.
+
+- Ergonomics of working with complex values has been improved:
+
+  - binary operators accept complex scalars and real arrays and preserve the floating point
+    precision: `1j*f32_array` returns a `complex64` array
+  - `mean` accepts complex floating-point arrays.
+  - `real` and `conj` accept numeric arguments, including real floating point data.
+    Note that `imag` still requires its input to be a complex array.
+
+- The following functions, new in the 2024.12 standard revision, are implemented:
+
+  - `count_nonzero`
+  - `cumulative_prod`
+
+- `fftfreq` and `rfftfreq` functions accept a new `dtype` argument to control the
+  the data type of their output.
+
+
+### Minor Changes
+
+- `vecdot` now conjugates the first argument, in accordance with the standard.
+
+- `astype` now raises a `TypeError` instead of casting a complex floating-point
+  array to a real-valued or an integral data type.
+
+- `where` requires that its first argument, `condition` has a boolean data dtype,
+  and raises a `TypeError` otherwise.
+
+- `isdtype` raises a `TypeError` is its argument is not a dtype object.
+
+- arrays created with `from_dlpack` now correctly set their `device` attribute.
+
+- the build system now uses `pyproject.toml`, not `setup.py`.
+
+### Contributors
+
+The following users contributed to this release:
+
+Aaron Meurer
+Clément Robert
+Guido Imperiale
+Evgeni Burovski
+Lucas Colley
+Tim Head
+
+
 ## 2.2 (2024-11-11)
 
 ### Major Changes

_static/basic.css

@@ -741,14 +741,6 @@ abbr, acronym {
     cursor: help;
 }
 
-.translated {
-    background-color: rgba(207, 255, 207, 0.2)
-}
-
-.untranslated {
-    background-color: rgba(255, 207, 207, 0.2)
-}
-
 /* -- code displays --------------------------------------------------------- */
 
 pre {

_static/searchtools.js

@@ -513,9 +513,11 @@ const Search = {
     // perform the search on the required terms
     searchTerms.forEach((word) => {
       const files = [];
+      // find documents, if any, containing the query word in their text/title term indices
+      // use Object.hasOwnProperty to avoid mismatching against prototype properties
       const arr = [
-        { files: terms[word], score: Scorer.term },
-        { files: titleTerms[word], score: Scorer.title },
+        { files: terms.hasOwnProperty(word) ? terms[word] : undefined, score: Scorer.term },
+        { files: titleTerms.hasOwnProperty(word) ? titleTerms[word] : undefined, score: Scorer.title },
       ];
       // add support for partial matches
       if (word.length > 2) {
@@ -547,8 +549,9 @@ const Search = {
 
         // set score for the word in each file
         recordFiles.forEach((file) => {
-          if (!scoreMap.has(file)) scoreMap.set(file, {});
-          scoreMap.get(file)[word] = record.score;
+          if (!scoreMap.has(file)) scoreMap.set(file, new Map());
+          const fileScores = scoreMap.get(file);
+          fileScores.set(word, record.score);
         });
       });
 
@@ -587,7 +590,7 @@ const Search = {
         break;
 
       // select one (max) score for the file.
-      const score = Math.max(...wordList.map((w) => scoreMap.get(file)[w]));
+      const score = Math.max(...wordList.map((w) => scoreMap.get(file).get(w)));
       // add result to the result list
       results.push([
         docNames[file],

api.html

@@ -5,7 +5,7 @@
     <meta name="color-scheme" content="light dark"><meta name="viewport" content="width=device-width, initial-scale=1" />
 <link rel="index" title="Index" href="genindex.html" /><link rel="search" title="Search" href="search.html" /><link rel="next" title="Changelog" href="changelog.html" /><link rel="prev" title="array-api-strict" href="index.html" />
 
-    <link rel="shortcut icon" href="_static/favicon.png"/><!-- Generated with Sphinx 8.1.3 and Furo 2024.08.06 -->
+    <link rel="shortcut icon" href="_static/favicon.png"/><!-- Generated with Sphinx 8.2.1 and Furo 2024.08.06 -->
         <title>API Reference - array-api-strict documentation</title>
       <link rel="stylesheet" type="text/css" href="_static/pygments.css?v=a746c00c" />
     <link rel="stylesheet" type="text/css" href="_static/styles/furo.css?v=354aac6f" />
@@ -317,7 +317,7 @@
 
 <dl class="py function">
 <dt class="sig sig-object py" id="array_api_strict.set_array_api_strict_flags">
-<span class="sig-prename descclassname"><span class="pre">array_api_strict.</span></span><span class="sig-name descname"><span class="pre">set_array_api_strict_flags</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">api_version</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">boolean_indexing</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">data_dependent_shapes</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">enabled_extensions</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#array_api_strict.set_array_api_strict_flags" title="Link to this definition">¶</a></dt>
+<span class="sig-prename descclassname"><span class="pre">array_api_strict.</span></span><span class="sig-name descname"><span class="pre">set_array_api_strict_flags</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="keyword-only-separator o"><abbr title="Keyword-only parameters separator (PEP 3102)"><span class="pre">*</span></abbr></span></em>, <em class="sig-param"><span class="n"><span class="pre">api_version</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">boolean_indexing</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">data_dependent_shapes</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">enabled_extensions</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#array_api_strict.set_array_api_strict_flags" title="Link to this definition">¶</a></dt>
 <dd><p>Set the array-api-strict flags to the specified values.</p>
 <p>Flags are global variables that enable or disable array-api-strict
 behaviors.</p>
@@ -331,8 +331,8 @@
 <dt class="field-odd">Parameters<span class="colon">:</span></dt>
 <dd class="field-odd"><ul>
 <li><p><strong>api_version</strong> (<em>str, optional</em>) – The version of the standard to use. Supported versions are:
-<code class="docutils literal notranslate"><span class="pre">('2021.12',</span> <span class="pre">'2022.12',</span> <span class="pre">'2023.12')</span></code>, plus the draft version <code class="docutils literal notranslate"><span class="pre">2024.12</span></code>.
-The default version number is <code class="docutils literal notranslate"><span class="pre">'2023.12'</span></code>.</p>
+<code class="docutils literal notranslate"><span class="pre">('2021.12',</span> <span class="pre">'2022.12',</span> <span class="pre">'2023.12',</span> <span class="pre">'2024.12')</span></code>, plus the draft version <code class="docutils literal notranslate"><span class="pre">2025.12</span></code>.
+The default version number is <code class="docutils literal notranslate"><span class="pre">'2024.12'</span></code>.</p>
 <p>Note that 2021.12 is supported, but currently gives the same thing as
 2022.12 (except that the fft extension will be disabled).</p>
 </li>
@@ -426,7 +426,7 @@
 
 <dl class="py class">
 <dt class="sig sig-object py" id="array_api_strict.ArrayAPIStrictFlags">
-<em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">array_api_strict.</span></span><span class="sig-name descname"><span class="pre">ArrayAPIStrictFlags</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">api_version</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">boolean_indexing</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">data_dependent_shapes</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">enabled_extensions</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#array_api_strict.ArrayAPIStrictFlags" title="Link to this definition">¶</a></dt>
+<em class="property"><span class="k"><span class="pre">class</span></span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">array_api_strict.</span></span><span class="sig-name descname"><span class="pre">ArrayAPIStrictFlags</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="keyword-only-separator o"><abbr title="Keyword-only parameters separator (PEP 3102)"><span class="pre">*</span></abbr></span></em>, <em class="sig-param"><span class="n"><span class="pre">api_version</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">boolean_indexing</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">data_dependent_shapes</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">enabled_extensions</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#array_api_strict.ArrayAPIStrictFlags" title="Link to this definition">¶</a></dt>
 <dd><p>A context manager to temporarily set the array-api-strict flags.</p>
 <div class="admonition note">
 <p class="admonition-title">Note</p>