uarray 0.6.0__tar.gz → 0.9.2__tar.gz

uarray-0.9.2/.clang-format

@@ -0,0 +1,18 @@
+---
+BasedOnStyle: LLVM
+SpaceBeforeCtorInitializerColon: false
+DerivePointerAlignment: false
+PointerAlignment: Middle
+ColumnLimit: 80
+AlwaysBreakTemplateDeclarations: true
+AlignAfterOpenBracket: AlwaysBreak
+AlwaysBreakAfterReturnType: None
+AllowAllParametersOfDeclarationOnNextLine: true
+BinPackParameters: true
+PenaltyReturnTypeOnItsOwnLine: 1000
+IndentPPDirectives: AfterHash
+MaxEmptyLinesToKeep: 2
+
+# Macros that aren't followed by a semi-colon
+StatementMacros:
+    - PyObject_HEAD

uarray-0.9.2/.gitattributes

@@ -0,0 +1,3 @@
+uarray/_version.py export-subst
+# GitHub syntax highlighting
+pixi.lock linguist-language=YAML linguist-generated=true

uarray-0.9.2/.github/dependabot.yml

@@ -0,0 +1,13 @@
+# Set update schedule for GitHub Actions
+# This opens a PR when actions in workflows need an update
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      # Check for updates to GitHub Actions every week
+      interval: "weekly"
+    commit-message:
+      prefix: "skip changelog" # So this PR will not be added to release-drafter
+      include: "scope" # List of the updated dependencies in the commit will be added

uarray-0.9.2/.github/workflows/build.yaml

@@ -0,0 +1,146 @@
+name: Build
+
+on:
+  # Trigger the workflow on push or pull request,
+  # but only for the main branch
+  push:
+    branches:
+      - main
+      - master
+    tags:
+      - '*'
+  pull_request:
+    branches:
+      - main
+      - master
+
+jobs:
+  build_wheels:
+    name: Build wheels on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v2.22.0
+      - uses: actions/upload-artifact@v4
+        with:
+          name: cibw-wheels-${{ matrix.os }}-${{ strategy.job-index }}
+          path: ./wheelhouse/*.whl
+
+  make_sdist:
+    name: Make SDist
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+
+    - name: Build SDist
+      run: pipx run build --sdist
+
+    - uses: actions/upload-artifact@v4
+      with:
+        name: cibw-sdist
+        path: dist/*.tar.gz
+  
+  upload_all:
+    needs: [build_wheels, make_sdist]
+    permissions:
+      id-token: write
+    runs-on: ubuntu-latest
+    if: github.ref_type == 'tag'
+    steps:
+    - uses: actions/download-artifact@v4
+      with:
+        pattern: cibw-*
+        path: dist
+        merge-multiple: true
+
+    - uses: pypa/gh-action-pypi-publish@release/v1
+
+  doc_lint_cov:
+    name: Documentation, Linting and Coverage
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          # Update according to NEP-29
+          python-version: '3.10'
+          cache: 'pip'
+      - name: Install package
+        run: |
+          pip install -v .[all]
+      - name: Build documentation
+        run: |
+          sphinx-build -W -b html docs/ _build/html
+      - name: Upload documentation
+        uses: actions/upload-artifact@v4
+        with:
+          name: Documentation
+          path: _build/html
+      - name: Code style and tests
+        run: |
+          pytest --pyargs uarray
+      - name: mypy
+        run: |
+          mypy src/uarray
+      - name: Run clang-format style check for C/C++ code.
+        uses: jidicula/clang-format-action@v4.13.0
+        with:
+          clang-format-version: '19'
+          check-path: 'src'
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v4
+        with:
+          directory: 'coverage/coverage*.xml'
+          env_vars: OS,PYTHON
+          fail_ci_if_error: false
+          verbose: true
+
+  pypy3:
+    name: Tests for PyPy3
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 'pypy-3.10'
+          cache: 'pip'
+      - name: Install package
+        run: |
+          pip install -v .[tests]
+      - name: Run tests
+        run: |
+          pytest --pyargs uarray
+
+  scipy_fft:
+    name: Run SciPy FFT tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          # Update according to NEP-29
+          python-version: '3.10'
+          cache: 'pip'
+      - name: Install package
+        run: |
+          pip install -v .[tests] pytest"<7"
+          pip install scipy==1.7.2
+      - name: SciPy tests
+        run: |
+          import scipy.fft
+          assert scipy.fft.test()
+        shell: python

uarray-0.9.2/.gitignore

@@ -0,0 +1,30 @@
+.vscode
+*.code-workspace
+.pytest_cache
+.mypy_cache
+.hypothesis
+__pycache__
+Digraph*
+.ipynb_checkpoints
+junit
+test_readme.py
+junit
+coverage.xml
+**/.coverage
+dist
+**/*.pyc
+_build/
+docs/_build
+.idea/
+pytype_output
+htmlcov/
+*.egg-info/
+sandbox.py
+*.so
+build/
+default.profraw
+src/uarray/_version.py
+*.pyd
+# pixi environments
+.pixi
+*.egg-info

uarray-0.9.2/CODE_OF_CONDUCT.md

@@ -0,0 +1,3 @@
+This repository is governed by the Quansight Repository Code of Conduct. It
+can be found here:
+https://github.com/Quansight/.github/blob/master/CODE_OF_CONDUCT.md.

uarray-0.9.2/CONTRIBUTING.md

@@ -0,0 +1,42 @@
+# Contributing
+
+Contribution to `uarray` are welcome and appreciated. Contributions can take the form of bug reports, documentation, code, and more.
+
+## Getting the code
+
+Make a fork of the main [uarray repository](https://github.com/Quansight-Labs/uarray) and clone the fork:
+
+```
+git clone https://github.com/<your-github-username>/uarray
+```
+
+## Install
+
+`uarray` and all development dependencies can be installed via:
+
+```
+pip install -e ".[all]"
+```
+
+Note that uarray supports Python versions >= 3.5. If you're running `conda` and would prefer to have dependencies
+pulled from there, use
+
+```
+conda env create -f .conda/environment.yml
+```
+
+This will create an environment named `uarray` which you can use for development.
+
+## Testing
+
+Tests can be run from the main uarray directory as follows:
+
+```
+pytest --pyargs uarray
+```
+
+To run a subset of tests:
+
+```
+pytest uarray.tests.test_backend
+```

uarray-0.9.2/PKG-INFO

@@ -0,0 +1,88 @@
+Metadata-Version: 2.2
+Name: uarray
+Version: 0.9.2
+Summary: Array interface object for Python with pluggable backends and a multiple-dispatch mechanism for defining down-stream functions
+Maintainer-email: Hameer Abbasi <habbasi@quansight.com>
+License: BSD 3-Clause License
+        
+        Copyright (c) 2018, Quansight-Labs
+        All rights reserved.
+        
+        Redistribution and use in source and binary forms, with or without
+        modification, are permitted provided that the following conditions are met:
+        
+        * Redistributions of source code must retain the above copyright notice, this
+          list of conditions and the following disclaimer.
+        
+        * Redistributions in binary form must reproduce the above copyright notice,
+          this list of conditions and the following disclaimer in the documentation
+          and/or other materials provided with the distribution.
+        
+        * Neither the name of the copyright holder nor the names of its
+          contributors may be used to endorse or promote products derived from
+          this software without specific prior written permission.
+        
+        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+        
+Project-URL: Documentation, https://uarray.org/
+Project-URL: Source, https://github.com/Quansight-Labs/uarray/
+Project-URL: Repository, https://github.com/Quansight-Labs/uarray.git
+Project-URL: Issue Tracker, https://github.com/Quansight-Labs/uarray/issues
+Keywords: uarray,scipy,multiple-dispatch
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Operating System :: OS Independent
+Classifier: License :: OSI Approved :: BSD License
+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 :: Only
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: docs
+Requires-Dist: sphinx; extra == "docs"
+Requires-Dist: sphinx_rtd_theme; extra == "docs"
+Provides-Extra: tests
+Requires-Dist: pytest>=3.5; extra == "tests"
+Requires-Dist: pytest-flake8; extra == "tests"
+Requires-Dist: pytest-cov; extra == "tests"
+Requires-Dist: mypy>=0.930; extra == "tests"
+Provides-Extra: optional
+Provides-Extra: all
+Requires-Dist: uarray[docs]; extra == "all"
+Requires-Dist: uarray[tests]; extra == "all"
+Requires-Dist: uarray[optional]; extra == "all"
+
+# `uarray` - A back-end mechanism geared towards array computing
+
+[![Join the chat at https://gitter.im/Plures/uarray](https://badges.gitter.im/Plures/uarray.svg)](https://gitter.im/Plures/uarray?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![Build Status](https://github.com/Quansight-Labs/uarray/actions/workflows/build.yaml/badge.svg)](https://github.com/Quansight-Labs/uarray/actions)
+[![PyPI](https://img.shields.io/pypi/v/uarray.svg?style=flat-square)](https://pypi.org/project/uarray/)
+
+<img src="docs/logo.png" style="width: 20em; text-align: center;" alt="uarray logo">
+
+- [Documentation](https://uarray.org)
+- [Road Map](https://github.com/orgs/Quansight-Labs/projects/1)
+- [Future Meetings](https://calendar.google.com/calendar/embed?src=quansight.com_cg7sf4usbcn18gdhdb3l2c6v1g%40group.calendar.google.com&ctz=America%2FNew_York)
+- [Meeting Notes](https://github.com/Quansight-Labs/uarray/wiki/Meeting-Notes)
+- [References](https://github.com/Quansight-Labs/uarray/wiki/References)
+- [Papers](https://paperpile.com/shared/fHftX5)
+
+## Contributing
+
+See [`CONTRIBUTING.md`](CONTRIBUTING.md) for more information on how to contribute to `uarray`.

{uarray-0.6.0 → uarray-0.9.2}/README.md

@@ -1,6 +1,8 @@
 # `uarray` - A back-end mechanism geared towards array computing
 
-[![Join the chat at https://gitter.im/Plures/uarray](https://badges.gitter.im/Plures/uarray.svg)](https://gitter.im/Plures/uarray?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/Quansight-Labs/uarray/master) [![Build Status](https://dev.azure.com/Quansight-Labs/uarray/_apis/build/status/Quansight-Labs.uarray?branchName=master)](https://dev.azure.com/Quansight-Labs/uarray/_build/latest?definitionId=1&branchName=master) [![PyPI](https://img.shields.io/pypi/v/uarray.svg?style=flat-square)](https://pypi.org/project/uarray/)
+[![Join the chat at https://gitter.im/Plures/uarray](https://badges.gitter.im/Plures/uarray.svg)](https://gitter.im/Plures/uarray?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![Build Status](https://github.com/Quansight-Labs/uarray/actions/workflows/build.yaml/badge.svg)](https://github.com/Quansight-Labs/uarray/actions)
+[![PyPI](https://img.shields.io/pypi/v/uarray.svg?style=flat-square)](https://pypi.org/project/uarray/)
 
 <img src="docs/logo.png" style="width: 20em; text-align: center;" alt="uarray logo">
 

uarray-0.9.2/docs/_templates/autosummary/base.rst

@@ -0,0 +1,5 @@
+{{ objname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. auto{{ objtype }}:: {{ objname }}

uarray-0.9.2/docs/_templates/autosummary/class.rst

@@ -0,0 +1,27 @@
+{{ objname | escape | underline}}
+
+.. currentmodule:: {{ module }}
+
+.. autoclass:: {{ objname }}
+
+   {% block attributes %}
+   {% if attributes %}
+   .. rubric:: Attributes
+   .. autosummary::
+      :toctree:
+   {% for item in attributes %}
+      {{ name }}.{{ item }}
+   {% endfor %}
+   {% endif %}
+   {% endblock %}
+
+   {% block methods %}
+   {% if methods %}
+   .. rubric:: Methods
+   .. autosummary::
+      :toctree:
+   {% for item in methods %}
+      {{ name }}.{{ item }}
+   {% endfor %}
+   {% endif %}
+   {% endblock %}

uarray-0.9.2/docs/_templates/autosummary/module.rst

@@ -0,0 +1,29 @@
+{{ fullname | escape | underline }}
+
+.. rubric:: Description
+.. automodule:: {{ fullname }}
+.. currentmodule:: {{ fullname }}
+
+{% if classes %}
+.. rubric:: Classes
+
+.. autosummary::
+    :toctree:
+
+    {% for class in classes %}
+    {{ class }}
+    {% endfor %}
+
+{% endif %}
+
+{% if functions %}
+.. rubric:: Functions
+
+.. autosummary::
+    :toctree:
+
+    {% for function in functions %}
+    {{ function }}
+    {% endfor %}
+
+{% endif %}

uarray-0.9.2/docs/conf.py

@@ -0,0 +1,210 @@
+# -*- coding: utf-8 -*-
+#
+# Configuration file for the Sphinx documentation builder.
+#
+# This file does only contain a selection of the most common options. For a
+# full list see the documentation:
+# http://www.sphinx-doc.org/en/master/config
+
+# -- Path setup --------------------------------------------------------------
+
+# If extensions (or modules to document with autodoc) are in another directory,
+# add these directories to sys.path here. If the directory is relative to the
+# documentation root, use os.path.abspath to make it absolute, like shown here.
+#
+import os
+import sys
+from importlib.metadata import version
+
+
+# Mock Extension modules
+try:
+    import uarray._uarray
+except ImportError:
+    from unittest.mock import MagicMock
+
+    class Mock(MagicMock):
+        @classmethod
+        def __getattr__(cls, name):
+            return MagicMock()
+
+    MOCK_MODULES = ["uarray._uarray"]
+    sys.modules.update((mod, Mock()) for mod in MOCK_MODULES)
+
+
+# sys.path.insert(0, os.path.abspath('.'))
+from typing import List, Dict
+
+
+# -- Project information -----------------------------------------------------
+
+project = "uarray"
+copyright = "2019, Quansight-Labs"
+author = "Quansight-Labs"
+
+# The full version, including alpha/beta/rc tags
+release = version("uarray")
+# The short X.Y version
+version = ".".join(release.split(".")[:2])
+
+# -- General configuration ---------------------------------------------------
+
+# If your documentation needs a minimal Sphinx version, state it here.
+#
+# needs_sphinx = '1.0'
+
+# Add any Sphinx extension module names here, as strings. They can be
+# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
+# ones.
+extensions: List[str] = [
+    "sphinx.ext.autodoc",
+    "sphinx.ext.viewcode",
+    "sphinx.ext.napoleon",
+    "sphinx.ext.intersphinx",
+    "sphinx.ext.autosummary",
+    "sphinx.ext.doctest",
+]
+
+# Add any paths that contain templates here, relative to this directory.
+templates_path = ["_templates"]
+
+# The suffix(es) of source filenames.
+# You can specify multiple suffix as a list of string:
+#
+# source_suffix = ['.rst', '.md']
+source_suffix = ".rst"
+
+# The master toctree document.
+master_doc = "index"
+
+# The language for content autogenerated by Sphinx. Refer to documentation
+# for a list of supported languages.
+#
+# This is also used if you do content translation via gettext catalogs.
+# Usually you set "language" from the command line for these cases.
+language = 'en'
+
+# List of patterns, relative to source directory, that match files and
+# directories to ignore when looking for source files.
+# This pattern also affects html_static_path and html_extra_path.
+exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
+
+# The name of the Pygments (syntax highlighting) style to use.
+pygments_style = None
+
+
+# -- Options for HTML output -------------------------------------------------
+
+# The theme to use for HTML and HTML Help pages.  See the documentation for
+# a list of builtin themes.
+#
+html_theme = "sphinx_rtd_theme"
+html_logo = "logo.png"
+html_favicon = "logo.png"
+
+# Theme options are theme-specific and customize the look and feel of a theme
+# further.  For a list of options available for each theme, see the
+# documentation.
+#
+# html_theme_options = {}
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
+html_static_path = []  # type: List[str]
+
+# Custom sidebar templates, must be a dictionary that maps document names
+# to template names.
+#
+# The default sidebars (for documents that don't match any pattern) are
+# defined by theme itself.  Builtin themes are using these templates by
+# default: ``['localtoc.html', 'relations.html', 'sourcelink.html',
+# 'searchbox.html']``.
+#
+# html_sidebars = {}
+
+
+# -- Options for HTMLHelp output ---------------------------------------------
+
+# Output file base name for HTML help builder.
+htmlhelp_basename = "uarraydoc"
+
+
+# -- Options for LaTeX output ------------------------------------------------
+
+latex_elements = {
+    # The paper size ('letterpaper' or 'a4paper').
+    #
+    # 'papersize': 'letterpaper',
+    # The font size ('10pt', '11pt' or '12pt').
+    #
+    # 'pointsize': '10pt',
+    # Additional stuff for the LaTeX preamble.
+    #
+    # 'preamble': '',
+    # Latex figure (float) alignment
+    #
+    # 'figure_align': 'htbp',
+}  # type: Dict[str, str]
+
+# Grouping the document tree into LaTeX files. List of tuples
+# (source start file, target name, title,
+#  author, documentclass [howto, manual, or own class]).
+latex_documents = [
+    (master_doc, "uarray.tex", "uarray Documentation", "Quansight-Labs", "manual")
+]
+
+
+# -- Options for manual page output ------------------------------------------
+
+# One entry per manual page. List of tuples
+# (source start file, name, description, authors, manual section).
+man_pages = [(master_doc, "uarray", "uarray Documentation", [author], 1)]
+
+
+# -- Options for Texinfo output ----------------------------------------------
+
+# Grouping the document tree into Texinfo files. List of tuples
+# (source start file, target name, title, author,
+#  dir menu entry, description, category)
+texinfo_documents = [
+    (
+        master_doc,
+        "uarray",
+        "uarray Documentation",
+        author,
+        "uarray",
+        "One line description of project.",
+        "Miscellaneous",
+    )
+]
+
+
+# -- Options for Epub output -------------------------------------------------
+
+# Bibliographic Dublin Core info.
+epub_title = project
+
+# The unique identifier of the text. This can be a ISBN number
+# or the project homepage.
+#
+# epub_identifier = ''
+
+# A unique identification for the text.
+#
+# epub_uid = ''
+
+# A list of files that should not be packed into the epub file.
+epub_exclude_files = ["search.html"]
+
+autosummary_generate = True
+autoclass_content = "both"
+
+intersphinx_mapping = {
+    "python": ("https://docs.python.org/3/", None),
+    "unumpy": ("https://unumpy.uarray.org/en/latest/", None),
+}
+
+doctest_global_setup = """
+import uarray as ua
+"""

uarray-0.9.2/docs/enduser_docs.rst

@@ -0,0 +1,52 @@
+.. currentmodule:: uarray
+
+.. _userdocs:
+
+End-user quickstart
+===================
+
+Ideally, the only thing an end-user should have to do is set the backend
+and its options. Given a backend, you (as the end-user) can decide to
+do one of two things:
+
+* Set the backend permanently (use the :obj:`set_global_backend` function).
+* Set the backend temporarily (use the :obj:`set_backend` context manager).
+
+.. note::
+    API authors may want to wrap these methods and provide their own methods.
+
+Also of a note may be the :obj:`BackendNotImplementedError`, which is raised
+when none of the selected backends have an implementation for a multimethod.
+
+Setting the backend temporarily
+-------------------------------
+
+To set the backend temporarily, use the :obj:`set_backend` context manager.
+
+.. code:: python3
+
+    import uarray as ua
+
+    with ua.set_backend(mybackend):
+        # Use multimethods (or code dependent on them) here.
+
+Setting the backend permanently
+-------------------------------
+
+To set the backend permanently, use the :obj:`set_global_backend`
+method. It is a recommendation that the global backend should not
+depend on any other backend, as it is not guaranteed that another
+backend will be available.
+
+You can also register backends other than the global backend for permanent
+use, but the global backend will be tried first outside of a :obj:`set_backend`
+context. This can be done via :obj:`register_backend`.
+
+
+.. code:: python3
+
+    import uarray as ua
+
+    ua.set_global_backend(mybackend)
+
+    # Use relevant multimethods here.