python-graphblas 2025.2.0a1__tar.gz → 2026.11.0a0__tar.gz

{python_graphblas-2025.2.0a1/python_graphblas.egg-info → python_graphblas-2026.11.0a0}/PKG-INFO

@@ -1,228 +1,27 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: python-graphblas
-Version: 2025.2.0a1
+Version: 2026.11.0a0
 Summary: Python library for GraphBLAS: high-performance sparse linear algebra for scalable graph analytics
 Author: Jim Kitchen, Python-graphblas contributors
 Author-email: Erik Welch <erik.n.welch@gmail.com>
 Maintainer-email: Erik Welch <erik.n.welch@gmail.com>, Jim Kitchen <jim22k@gmail.com>, Sultan Orazbayev <contact@econpoint.com>
-License:                                  Apache License
-                                   Version 2.0, January 2004
-                                https://www.apache.org/licenses/
-        
-           TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
-        
-           1. Definitions.
-        
-              "License" shall mean the terms and conditions for use, reproduction,
-              and distribution as defined by Sections 1 through 9 of this document.
-        
-              "Licensor" shall mean the copyright owner or entity authorized by
-              the copyright owner that is granting the License.
-        
-              "Legal Entity" shall mean the union of the acting entity and all
-              other entities that control, are controlled by, or are under common
-              control with that entity. For the purposes of this definition,
-              "control" means (i) the power, direct or indirect, to cause the
-              direction or management of such entity, whether by contract or
-              otherwise, or (ii) ownership of fifty percent (50%) or more of the
-              outstanding shares, or (iii) beneficial ownership of such entity.
-        
-              "You" (or "Your") shall mean an individual or Legal Entity
-              exercising permissions granted by this License.
-        
-              "Source" form shall mean the preferred form for making modifications,
-              including but not limited to software source code, documentation
-              source, and configuration files.
-        
-              "Object" form shall mean any form resulting from mechanical
-              transformation or translation of a Source form, including but
-              not limited to compiled object code, generated documentation,
-              and conversions to other media types.
-        
-              "Work" shall mean the work of authorship, whether in Source or
-              Object form, made available under the License, as indicated by a
-              copyright notice that is included in or attached to the work
-              (an example is provided in the Appendix below).
-        
-              "Derivative Works" shall mean any work, whether in Source or Object
-              form, that is based on (or derived from) the Work and for which the
-              editorial revisions, annotations, elaborations, or other modifications
-              represent, as a whole, an original work of authorship. For the purposes
-              of this License, Derivative Works shall not include works that remain
-              separable from, or merely link (or bind by name) to the interfaces of,
-              the Work and Derivative Works thereof.
-        
-              "Contribution" shall mean any work of authorship, including
-              the original version of the Work and any modifications or additions
-              to that Work or Derivative Works thereof, that is intentionally
-              submitted to Licensor for inclusion in the Work by the copyright owner
-              or by an individual or Legal Entity authorized to submit on behalf of
-              the copyright owner. For the purposes of this definition, "submitted"
-              means any form of electronic, verbal, or written communication sent
-              to the Licensor or its representatives, including but not limited to
-              communication on electronic mailing lists, source code control systems,
-              and issue tracking systems that are managed by, or on behalf of, the
-              Licensor for the purpose of discussing and improving the Work, but
-              excluding communication that is conspicuously marked or otherwise
-              designated in writing by the copyright owner as "Not a Contribution."
-        
-              "Contributor" shall mean Licensor and any individual or Legal Entity
-              on behalf of whom a Contribution has been received by Licensor and
-              subsequently incorporated within the Work.
-        
-           2. Grant of Copyright License. Subject to the terms and conditions of
-              this License, each Contributor hereby grants to You a perpetual,
-              worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-              copyright license to reproduce, prepare Derivative Works of,
-              publicly display, publicly perform, sublicense, and distribute the
-              Work and such Derivative Works in Source or Object form.
-        
-           3. Grant of Patent License. Subject to the terms and conditions of
-              this License, each Contributor hereby grants to You a perpetual,
-              worldwide, non-exclusive, no-charge, royalty-free, irrevocable
-              (except as stated in this section) patent license to make, have made,
-              use, offer to sell, sell, import, and otherwise transfer the Work,
-              where such license applies only to those patent claims licensable
-              by such Contributor that are necessarily infringed by their
-              Contribution(s) alone or by combination of their Contribution(s)
-              with the Work to which such Contribution(s) was submitted. If You
-              institute patent litigation against any entity (including a
-              cross-claim or counterclaim in a lawsuit) alleging that the Work
-              or a Contribution incorporated within the Work constitutes direct
-              or contributory patent infringement, then any patent licenses
-              granted to You under this License for that Work shall terminate
-              as of the date such litigation is filed.
-        
-           4. Redistribution. You may reproduce and distribute copies of the
-              Work or Derivative Works thereof in any medium, with or without
-              modifications, and in Source or Object form, provided that You
-              meet the following conditions:
-        
-              (a) You must give any other recipients of the Work or
-                  Derivative Works a copy of this License; and
-        
-              (b) You must cause any modified files to carry prominent notices
-                  stating that You changed the files; and
-        
-              (c) You must retain, in the Source form of any Derivative Works
-                  that You distribute, all copyright, patent, trademark, and
-                  attribution notices from the Source form of the Work,
-                  excluding those notices that do not pertain to any part of
-                  the Derivative Works; and
-        
-              (d) If the Work includes a "NOTICE" text file as part of its
-                  distribution, then any Derivative Works that You distribute must
-                  include a readable copy of the attribution notices contained
-                  within such NOTICE file, excluding those notices that do not
-                  pertain to any part of the Derivative Works, in at least one
-                  of the following places: within a NOTICE text file distributed
-                  as part of the Derivative Works; within the Source form or
-                  documentation, if provided along with the Derivative Works; or,
-                  within a display generated by the Derivative Works, if and
-                  wherever such third-party notices normally appear. The contents
-                  of the NOTICE file are for informational purposes only and
-                  do not modify the License. You may add Your own attribution
-                  notices within Derivative Works that You distribute, alongside
-                  or as an addendum to the NOTICE text from the Work, provided
-                  that such additional attribution notices cannot be construed
-                  as modifying the License.
-        
-              You may add Your own copyright statement to Your modifications and
-              may provide additional or different license terms and conditions
-              for use, reproduction, or distribution of Your modifications, or
-              for any such Derivative Works as a whole, provided Your use,
-              reproduction, and distribution of the Work otherwise complies with
-              the conditions stated in this License.
-        
-           5. Submission of Contributions. Unless You explicitly state otherwise,
-              any Contribution intentionally submitted for inclusion in the Work
-              by You to the Licensor shall be under the terms and conditions of
-              this License, without any additional terms or conditions.
-              Notwithstanding the above, nothing herein shall supersede or modify
-              the terms of any separate license agreement you may have executed
-              with Licensor regarding such Contributions.
-        
-           6. Trademarks. This License does not grant permission to use the trade
-              names, trademarks, service marks, or product names of the Licensor,
-              except as required for reasonable and customary use in describing the
-              origin of the Work and reproducing the content of the NOTICE file.
-        
-           7. Disclaimer of Warranty. Unless required by applicable law or
-              agreed to in writing, Licensor provides the Work (and each
-              Contributor provides its Contributions) on an "AS IS" BASIS,
-              WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
-              implied, including, without limitation, any warranties or conditions
-              of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
-              PARTICULAR PURPOSE. You are solely responsible for determining the
-              appropriateness of using or redistributing the Work and assume any
-              risks associated with Your exercise of permissions under this License.
-        
-           8. Limitation of Liability. In no event and under no legal theory,
-              whether in tort (including negligence), contract, or otherwise,
-              unless required by applicable law (such as deliberate and grossly
-              negligent acts) or agreed to in writing, shall any Contributor be
-              liable to You for damages, including any direct, indirect, special,
-              incidental, or consequential damages of any character arising as a
-              result of this License or out of the use or inability to use the
-              Work (including but not limited to damages for loss of goodwill,
-              work stoppage, computer failure or malfunction, or any and all
-              other commercial damages or losses), even if such Contributor
-              has been advised of the possibility of such damages.
-        
-           9. Accepting Warranty or Additional Liability. While redistributing
-              the Work or Derivative Works thereof, You may choose to offer,
-              and charge a fee for, acceptance of support, warranty, indemnity,
-              or other liability obligations and/or rights consistent with this
-              License. However, in accepting such obligations, You may act only
-              on Your own behalf and on Your sole responsibility, not on behalf
-              of any other Contributor, and only if You agree to indemnify,
-              defend, and hold each Contributor harmless for any liability
-              incurred by, or claims asserted against, such Contributor by reason
-              of your accepting any such warranty or additional liability.
-        
-           END OF TERMS AND CONDITIONS
-        
-           APPENDIX: How to apply the Apache License to your work.
-        
-              To apply the Apache License to your work, attach the following
-              boilerplate notice, with the fields enclosed by brackets "[]"
-              replaced with your own identifying information. (Don't include
-              the brackets!)  The text should be enclosed in the appropriate
-              comment syntax for the file format. We also recommend that a
-              file or class name and description of purpose be included on the
-              same "printed page" as the copyright notice for easier
-              identification within third-party archives.
-        
-           Copyright 2020-2023 Anaconda, Inc. and contributors
-        
-           Licensed under the Apache License, Version 2.0 (the "License");
-           you may not use this file except in compliance with the License.
-           You may obtain a copy of the License at
-        
-               https://www.apache.org/licenses/LICENSE-2.0
-        
-           Unless required by applicable law or agreed to in writing, software
-           distributed under the License is distributed on an "AS IS" BASIS,
-           WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-           See the License for the specific language governing permissions and
-           limitations under the License.
-        
+License-Expression: Apache-2.0
 Project-URL: homepage, https://github.com/python-graphblas/python-graphblas
 Project-URL: documentation, https://python-graphblas.readthedocs.io
 Project-URL: repository, https://github.com/python-graphblas/python-graphblas
 Project-URL: changelog, https://github.com/python-graphblas/python-graphblas/releases
 Keywords: graphblas,graph,sparse,matrix,lagraph,suitesparse,Networks,Graph Theory,Mathematics,network,discrete mathematics,math
 Classifier: Development Status :: 5 - Production/Stable
-Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: MacOS :: MacOS X
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Operating System :: Microsoft :: Windows
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Other Audience
@@ -231,20 +30,20 @@ Classifier: Topic :: Scientific/Engineering
 Classifier: Topic :: Scientific/Engineering :: Information Analysis
 Classifier: Topic :: Scientific/Engineering :: Mathematics
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: numpy>=1.23
+Requires-Dist: numpy>=1.24
 Requires-Dist: donfig>=0.6
 Requires-Dist: pyyaml>=5.4
-Requires-Dist: suitesparse-graphblas<10,>=7.4.0.0
-Requires-Dist: numba>=0.55; python_version < "3.14"
+Requires-Dist: suitesparse-graphblas>=7.4.0.0
+Requires-Dist: numba>=0.57; python_version < "3.16"
 Provides-Extra: suitesparse
-Requires-Dist: suitesparse-graphblas<10,>=7.4.0.0; extra == "suitesparse"
+Requires-Dist: suitesparse-graphblas>=7.4.0.0; extra == "suitesparse"
 Provides-Extra: networkx
 Requires-Dist: networkx>=2.8; extra == "networkx"
 Provides-Extra: numba
-Requires-Dist: numba>=0.55; extra == "numba"
+Requires-Dist: numba>=0.57; extra == "numba"
 Provides-Extra: pandas
 Requires-Dist: pandas>=1.5; extra == "pandas"
 Provides-Extra: scipy
@@ -255,10 +54,9 @@ Provides-Extra: repr
 Requires-Dist: python-graphblas[pandas]; extra == "repr"
 Provides-Extra: io
 Requires-Dist: python-graphblas[networkx,scipy]; extra == "io"
-Requires-Dist: python-graphblas[numba]; python_version < "3.14" and extra == "io"
+Requires-Dist: python-graphblas[numba]; python_version < "3.16" and extra == "io"
 Requires-Dist: awkward>=2.0; extra == "io"
-Requires-Dist: sparse>=0.14; python_version < "3.13" and extra == "io"
-Requires-Dist: fast-matrix-market>=1.4.5; python_version < "3.13" and extra == "io"
+Requires-Dist: sparse>=0.14; python_version < "3.16" and extra == "io"
 Provides-Extra: viz
 Requires-Dist: python-graphblas[networkx,scipy]; extra == "viz"
 Requires-Dist: matplotlib>=3.6; extra == "viz"
@@ -273,10 +71,11 @@ Requires-Dist: pytest>=6.2; extra == "test"
 Requires-Dist: tomli>=1; extra == "test"
 Provides-Extra: default
 Requires-Dist: python-graphblas[pandas,scipy,suitesparse]; extra == "default"
-Requires-Dist: python-graphblas[numba]; python_version < "3.14" and extra == "default"
+Requires-Dist: python-graphblas[numba]; python_version < "3.16" and extra == "default"
 Provides-Extra: all
 Requires-Dist: python-graphblas[default,io,test,viz]; extra == "all"
-Requires-Dist: python-graphblas[datashade]; python_version < "3.14" and extra == "all"
+Requires-Dist: python-graphblas[datashade]; python_version < "3.16" and extra == "all"
+Dynamic: license-file
 
 ![Python-graphblas](https://raw.githubusercontent.com/python-graphblas/python-graphblas/main/docs/_static/img/logo-horizontal-medium-big.svg)
 
@@ -305,7 +104,7 @@ For algorithms, see
   - **SuiteSparse:GraphBLAS User Guide:** [https://github.com/DrTimothyAldenDavis/GraphBLAS/raw/stable/Doc/GraphBLAS_UserGuide.pdf](https://github.com/DrTimothyAldenDavis/GraphBLAS/raw/stable/Doc/GraphBLAS_UserGuide.pdf)
 - **Source:** [https://github.com/python-graphblas/python-graphblas](https://github.com/python-graphblas/python-graphblas)
 - **Bug reports:** [https://github.com/python-graphblas/python-graphblas/issues](https://github.com/python-graphblas/python-graphblas/issues)
-- **Github discussions:** [https://github.com/python-graphblas/python-graphblas/discussions](https://github.com/python-graphblas/python-graphblas/discussions)
+- **GitHub discussions:** [https://github.com/python-graphblas/python-graphblas/discussions](https://github.com/python-graphblas/python-graphblas/discussions)
 - **Weekly community call:** [python-graphblas#247](https://github.com/python-graphblas/python-graphblas/issues/247) or [https://scientific-python.org/calendars/](https://scientific-python.org/calendars/)
 - **Chat via Discord:** [https://discord.com/invite/vur45CbwMz](https://discord.com/invite/vur45CbwMz) in the [#graphblas channel](https://discord.com/channels/786703927705862175/1024732940233605190)
 
@@ -338,8 +137,7 @@ The following are not required by python-graphblas, but may be needed for certai
 - `pandas` – required for nicer `__repr__`;
 - `matplotlib` – required for basic plotting of graphs;
 - `scipy` – used in `io` module to read/write `scipy.sparse` format;
-- `networkx` – used in `io` module to interface with `networkx` graphs;
-- `fast-matrix-market` - for faster read/write of Matrix Market files with `gb.io.mmread` and `gb.io.mmwrite`.
+- `networkx` – used in `io` module to interface with `networkx` graphs.
 
 ## Description
 
@@ -459,7 +257,7 @@ s(accum) << v.reduce(op)
 ## Creating new Vectors / Matrices
 
 ```python
-A = Matrix.new(dtype, num_rows, num_cols)   # new_type
+A = Matrix(dtype, num_rows, num_cols)       # new_type
 B = A.dup()                                 # dup
 A = Matrix.from_coo([row_indices], [col_indices], [values])  # build
 ```
@@ -506,7 +304,7 @@ Python-graphblas requires `numba` which enables compiling user-defined Python fu
 Example customized UnaryOp:
 
 ```python
-from graphblas import unary
+from graphblas import unary, Vector
 
 def force_odd_func(x):
     if x % 2 == 0:
@@ -548,7 +346,7 @@ import graphblas as gb
 
 # scipy.sparse matrices
 A = gb.io.from_scipy_sparse(m)
-m = gb.io.to_scipy_sparse(m, format="csr")
+m = gb.io.to_scipy_sparse(A, format="csr")
 
 # networkx graphs
 A = gb.io.from_networkx(g)

{python_graphblas-2025.2.0a1 → python_graphblas-2026.11.0a0}/README.md

@@ -25,7 +25,7 @@ For algorithms, see
   - **SuiteSparse:GraphBLAS User Guide:** [https://github.com/DrTimothyAldenDavis/GraphBLAS/raw/stable/Doc/GraphBLAS_UserGuide.pdf](https://github.com/DrTimothyAldenDavis/GraphBLAS/raw/stable/Doc/GraphBLAS_UserGuide.pdf)
 - **Source:** [https://github.com/python-graphblas/python-graphblas](https://github.com/python-graphblas/python-graphblas)
 - **Bug reports:** [https://github.com/python-graphblas/python-graphblas/issues](https://github.com/python-graphblas/python-graphblas/issues)
-- **Github discussions:** [https://github.com/python-graphblas/python-graphblas/discussions](https://github.com/python-graphblas/python-graphblas/discussions)
+- **GitHub discussions:** [https://github.com/python-graphblas/python-graphblas/discussions](https://github.com/python-graphblas/python-graphblas/discussions)
 - **Weekly community call:** [python-graphblas#247](https://github.com/python-graphblas/python-graphblas/issues/247) or [https://scientific-python.org/calendars/](https://scientific-python.org/calendars/)
 - **Chat via Discord:** [https://discord.com/invite/vur45CbwMz](https://discord.com/invite/vur45CbwMz) in the [#graphblas channel](https://discord.com/channels/786703927705862175/1024732940233605190)
 
@@ -58,8 +58,7 @@ The following are not required by python-graphblas, but may be needed for certai
 - `pandas` – required for nicer `__repr__`;
 - `matplotlib` – required for basic plotting of graphs;
 - `scipy` – used in `io` module to read/write `scipy.sparse` format;
-- `networkx` – used in `io` module to interface with `networkx` graphs;
-- `fast-matrix-market` - for faster read/write of Matrix Market files with `gb.io.mmread` and `gb.io.mmwrite`.
+- `networkx` – used in `io` module to interface with `networkx` graphs.
 
 ## Description
 
@@ -179,7 +178,7 @@ s(accum) << v.reduce(op)
 ## Creating new Vectors / Matrices
 
 ```python
-A = Matrix.new(dtype, num_rows, num_cols)   # new_type
+A = Matrix(dtype, num_rows, num_cols)       # new_type
 B = A.dup()                                 # dup
 A = Matrix.from_coo([row_indices], [col_indices], [values])  # build
 ```
@@ -226,7 +225,7 @@ Python-graphblas requires `numba` which enables compiling user-defined Python fu
 Example customized UnaryOp:
 
 ```python
-from graphblas import unary
+from graphblas import unary, Vector
 
 def force_odd_func(x):
     if x % 2 == 0:
@@ -268,7 +267,7 @@ import graphblas as gb
 
 # scipy.sparse matrices
 A = gb.io.from_scipy_sparse(m)
-m = gb.io.to_scipy_sparse(m, format="csr")
+m = gb.io.to_scipy_sparse(A, format="csr")
 
 # networkx graphs
 A = gb.io.from_networkx(g)

{python_graphblas-2025.2.0a1 → python_graphblas-2026.11.0a0}/graphblas/__init__.py

@@ -25,7 +25,45 @@ def get_config():
     import donfig
     import yaml
 
-    config = donfig.Config("graphblas")
+    class Config(donfig.Config):
+        """donfig Config that rejects silent attribute writes.
+
+        Options are set with ``config.set(name=value)`` (optionally as a
+        ``with config.set(name=value):`` block) and read with ``config[name]``.
+        Plain attribute assignment (``config.name = value``) would otherwise
+        create a dead instance attribute and leave the real option unchanged,
+        so we raise instead.
+        """
+
+        def __init__(self, *args, **kwargs):
+            # Writes are unrestricted until donfig's own __init__ finishes, and
+            # the attributes it set there become the allowlist. Deriving that
+            # list beats hardcoding donfig's internals: a donfig release that
+            # adds or renames a field can't then break attribute access here.
+            object.__setattr__(self, "_initializing", True)
+            super().__init__(*args, **kwargs)
+            object.__setattr__(self, "_donfig_attrs", frozenset(self.__dict__) - {"_initializing"})
+            object.__setattr__(self, "_initializing", False)
+
+        def __setattr__(self, key, value):
+            # An instance built without running __init__ has no allowlist yet,
+            # so stay permissive rather than raising a confusing AttributeError
+            # from the guard.
+            if self.__dict__.get("_initializing", True) or key in self._donfig_attrs:
+                object.__setattr__(self, key, value)
+                return
+            if key in self.config:
+                raise AttributeError(
+                    f"Cannot set config option {key!r} by attribute assignment. "
+                    f"Use `graphblas.config.set({key}=...)` to change it (optionally "
+                    f"in a `with` block for a scoped change) and "
+                    f"`graphblas.config[{key!r}]` to read it."
+                )
+            raise AttributeError(
+                f"Unknown config option {key!r}; known options are {sorted(self.config)}."
+            )
+
+    config = Config("graphblas")
     path = Path(__file__).parent / "graphblas.yaml"
     with path.open() as f:
         defaults = yaml.safe_load(f)
@@ -36,6 +74,10 @@ def get_config():
 config = get_config()
 del get_config
 
+# None until a backend is initialized. Touching a special attribute such as
+# gb.Matrix auto-initializes, as does an explicit init(), and sets this to
+# "suitesparse" or "suitesparse-vanilla". Reading gb.backend is not itself a
+# special-attribute access, so it never triggers initialization.
 backend = None
 _init_params = None
 _SPECIAL_ATTRS = {
@@ -49,6 +91,7 @@ _SPECIAL_ATTRS = {
     "core",
     "dtypes",
     "exceptions",
+    "indexbinary",
     "indexunary",
     "io",
     "monoid",
@@ -136,6 +179,9 @@ def _init(backend_arg, blocking, automatic=False):
         # Already initialized with these parameters; nothing more to do
         return
 
+    if backend_arg == "suitesparse":
+        # Checked before anything is initialized, so a bad value changes nothing
+        jit_c_control = _jit_c_control_config()
     backend = backend_arg
     if backend in {"suitesparse", "suitesparse-vanilla"}:
         try:
@@ -196,6 +242,35 @@ def _init(backend_arg, blocking, automatic=False):
     core.ffi = ffi
     core.lib = lib
     core.NULL = ffi.NULL
+    if backend == "suitesparse":
+        from .core.ss.jit_config import _set_jit_c_control_at_init
+
+        _set_jit_c_control_at_init(jit_c_control)
+
+
+_JIT_C_CONTROLS = ("on", "load", "run", "pause", "off")
+
+
+def _jit_c_control_config():
+    """``config["jit_c_control"]``, the SuiteSparse JIT control set at init (see graphblas.yaml).
+
+    None when it is not set, which is the default: ``'run'``, raised by UDT work.
+    """
+    val = config.get("jit_c_control")
+    if val is None:
+        return None
+    # YAML 1.1 reads an unquoted on/off as a bool, so a config file saying
+    # ``jit_c_control: off`` arrives here as False.
+    if val is True or val is False:
+        return "on" if val else "off"
+    if isinstance(val, str) and val.lower() in _JIT_C_CONTROLS:
+        return val.lower()
+    raise ValueError(
+        "Bad value for graphblas.config['jit_c_control'] (or the GRAPHBLAS_JIT_C_CONTROL "
+        f"environment variable): {val!r}. Must be one of: "
+        + ", ".join(repr(x) for x in _JIT_C_CONTROLS)
+        + ", or unset"
+    )
 
 
 # Ideally this is in operator.py, but lives here to avoid circular references

{python_graphblas-2025.2.0a1 → python_graphblas-2026.11.0a0}/graphblas/agg/__init__.py

@@ -109,7 +109,9 @@ def __getattr__(key):
         ss = import_module(".ss", __name__)
         globals()["ss"] = ss
         return ss
-    raise AttributeError(f"module {__name__!r} has no attribute {key!r}")
+    from ..core.utils import _module_attr_error
+
+    raise _module_attr_error(__name__, key, __dir__())
 
 
 from ..core import operator  # noqa: E402 isort:skip

{python_graphblas-2025.2.0a1 → python_graphblas-2026.11.0a0}/graphblas/binary/__init__.py

@@ -66,7 +66,9 @@ def __getattr__(key):
             f"module {__name__!r} unable to compile UDF for {key!r}; "
             "install numba for UDF support"
         )
-    raise AttributeError(f"module {__name__!r} has no attribute {key!r}")
+    from ..core.utils import _module_attr_error
+
+    raise _module_attr_error(__name__, key, __dir__())
 
 
 from ..core import operator  # noqa: E402 isort:skip

python_graphblas-2026.11.0a0/graphblas/binary/ss.py

@@ -0,0 +1,20 @@
+from ..core import operator
+
+_delayed = {}
+
+del operator
+
+
+# core.ss.binary imports the operators, whose setup imports this module, so
+# register_new is imported on first use: that lets core.ss.binary be imported first.
+def __getattr__(name):
+    if name == "register_new":
+        from ..core.ss.binary import register_new
+
+        globals()[name] = register_new
+        return register_new
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+def __dir__():
+    return sorted({*globals(), "register_new"})

{python_graphblas-2025.2.0a1 → python_graphblas-2026.11.0a0}/graphblas/core/automethods.py

@@ -10,11 +10,46 @@ $ python -m graphblas.core.automethods
 
 from .. import config
 
+# Scalar read-only attributes whose value is a plain read of the underlying C
+# scalar. For an index-extract expression (v[i], A[i, j]) these resolve with a
+# single extractElement straight into a cscalar via ScalarIndexExpr._extract_fast,
+# skipping the extra GrB_Scalar round-trip that `.new()` + Scalar.value performs.
+# Only ScalarIndexExpr defines the hook, and no Vector/Matrix expression routes
+# these attrs through _get_value, so their resolution short-circuits on the
+# membership test.
+_fast_scalar_attrs = frozenset(
+    {
+        "value",
+        "__float__",
+        "__int__",
+        "__complex__",
+        "__index__",
+        "__bool__",
+        "__array__",
+        "is_empty",
+        "_is_empty",
+    }
+)
+
 
 def _get_value(self, attr=None, default=None):
     if config.get("autocompute"):
         if self._value is None:
-            self._value = self.new()
+            if (
+                attr in _fast_scalar_attrs
+                and (extract_fast := getattr(self, "_extract_fast", None)) is not None
+            ):
+                self._value = extract_fast()
+            else:
+                self._value = self.new()
+        elif (
+            attr not in _fast_scalar_attrs
+            and getattr(self, "_extract_fast", None) is not None
+            and self._value._is_cscalar != self._is_cscalar
+        ):
+            # A value read cached a C scalar (_extract_fast); give the other attributes
+            # the kind of Scalar this expression reports, holding the same value.
+            self._value = self._value.dup(is_cscalar=self._is_cscalar, name=self._value.name)
         if attr is None:
             return self._value
         return getattr(self._value, attr)