immlib 1.0.0.dev2__tar.gz → 1.0.0rc2__tar.gz

{immlib-1.0.0.dev2/src/immlib.egg-info → immlib-1.0.0rc2}/PKG-INFO

@@ -1,23 +1,21 @@
 Metadata-Version: 2.4
 Name: immlib
-Version: 1.0.0.dev2
-Summary: A library of utilites for immutable scientific data.
+Version: 1.0.0rc2
+Summary: A library of utilities for immutable scientific data.
 Author-email: "Noah C. Benson" <nben@uw.edu>
-License: MIT
+License-Expression: MIT
 Project-URL: homepage, https://github.com/noahbenson/immlib
 Project-URL: documentation, https://github.com/noahbenson/immlib
 Project-URL: repository, https://github.com/noahbenson/immlib
 Keywords: persistent,immutable,functional,scientific,workflow
 Classifier: Intended Audience :: Science/Research
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 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: Topic :: Software Development
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
@@ -27,25 +25,30 @@ Classifier: Operating System :: Microsoft :: Windows
 Classifier: Operating System :: POSIX
 Classifier: Operating System :: Unix
 Classifier: Operating System :: MacOS
-Requires-Python: >=3.8
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: pcollections>=0.3.2
+Requires-Dist: pcollections>=1.0.0rc1
 Requires-Dist: numpy>=1.24.0
-Requires-Dist: scipy>=1.7.0
-Requires-Dist: pint>=0.20.0
-Requires-Dist: docrep>=0.3.2
+Requires-Dist: scipy>=1.8.0
+Requires-Dist: pint<0.27,>=0.24.0
+Requires-Dist: docshare>=0.2.0
 Requires-Dist: joblib>=1.3.0
-Requires-Dist: cloudpathlib[azure,gs,s3]>=0.18.0
+Requires-Dist: cloudpathlib[azure,gs,s3]<0.26,>=0.18.0
 Requires-Dist: pyyaml>=6.0
 Provides-Extra: dev
 Requires-Dist: torch>=2.2.0; extra == "dev"
+Requires-Dist: pandas>=1.5.0; extra == "dev"
+Requires-Dist: mypy>=1.8; extra == "dev"
 Provides-Extra: test
 Requires-Dist: torch>=2.2.0; extra == "test"
+Requires-Dist: pandas>=1.5.0; extra == "test"
+Provides-Extra: pandas
+Requires-Dist: pandas>=1.5.0; extra == "pandas"
 Provides-Extra: docs
 Requires-Dist: torch>=2.2.0; extra == "docs"
-Requires-Dist: jupyter-book>=1.0.0; extra == "docs"
 Requires-Dist: matplotlib>=3.4.0; extra == "docs"
+Requires-Dist: jupyter-book>=2; extra == "docs"
 Dynamic: license-file
 
 ![immlib](https://noahbenson.github.io/immlib/_static/logo.svg "immlib")
@@ -67,6 +70,38 @@ application programming interfaces (APIs) for scientific libraries. The name
 immlib comes from the library’s philosophy of using immutable data to simplify
 scientific workflows.
 
+## What's in it
+
+- **`immlib.workflow`** — immutable workflows built from `calc` units that are
+  assembled into `plan` DAGs. Inputs and outputs are tracked and wired up
+  automatically, results are computed lazily, and calculations can be cached in
+  memory or on disk.
+- **`immlib.pathlib` / `immlib.iolib`** — a single `path` function that resolves
+  local and remote paths (S3, Google Storage, Azure, and OSF), downloads remote
+  data into a local cache, and `save`/`load` functions that read and write a
+  range of file formats.
+- **quantities and units** — `immlib.Quantity` (a `pint.Quantity` that also
+  supports having no units at all) and `immlib.math`, a small common namespace
+  that operates on quantities, NumPy arrays, and PyTorch tensors alike, so the
+  two backends are interchangeable and units are tracked through the
+  arithmetic.
+
+Alongside these are a set of utilities for testing and coercing types, handling
+persistent and lazy collections, and working with numerical arguments.
+
+## Requirements
+
+`immlib` supports Python 3.10 through 3.14, including the free-threaded (no-GIL)
+builds, and depends on NumPy, SciPy, Pint, `pcollections`, `docshare`, `joblib`,
+`cloudpathlib`, and PyYAML.
+
+PyTorch and pandas are optional. `immlib` never imports PyTorch at import time,
+so it can be used without it (only operations that actually need a tensor
+raise); pandas is needed only by the `csv`/`tsv` save/load formats. See the
+"Stability and Compatibility" page of the
+[documentation](https://noahbenson.github.io/immlib) for the supported version
+ranges of each dependency and what the library promises across releases.
+
 `immlib` is heavily based on the library
 [`pimms`](https://github.com/noahbenson/pimms), which effectively served as a
 prototype for `immlib`. Both libraries were motivated by a number of observations

immlib-1.0.0rc2/README.md

@@ -0,0 +1,58 @@
+![immlib](https://noahbenson.github.io/immlib/_static/logo.svg "immlib")
+
+![Build Status](https://github.com/noahbenson/immlib/actions/workflows/tests.yml/badge.svg)
+[![codecov](https://codecov.io/gh/noahbenson/immlib/graph/badge.svg?token=8KO3K6DUX4)](https://codecov.io/gh/noahbenson/immlib)
+[![PyPI version](https://badge.fury.io/py/immlib.svg)](https://badge.fury.io/py/immlib)
+
+---
+
+**Author**: Noah C. Benson <[nben@uw.edu](mailto:nben@uw.edu)>  
+**License**: MIT  
+**[Documentation](https://noahbenson.github.io/immlib)**
+
+---
+
+`immlib` is a lightweight Python library that simplifies the design of
+application programming interfaces (APIs) for scientific libraries. The name
+immlib comes from the library’s philosophy of using immutable data to simplify
+scientific workflows.
+
+## What's in it
+
+- **`immlib.workflow`** — immutable workflows built from `calc` units that are
+  assembled into `plan` DAGs. Inputs and outputs are tracked and wired up
+  automatically, results are computed lazily, and calculations can be cached in
+  memory or on disk.
+- **`immlib.pathlib` / `immlib.iolib`** — a single `path` function that resolves
+  local and remote paths (S3, Google Storage, Azure, and OSF), downloads remote
+  data into a local cache, and `save`/`load` functions that read and write a
+  range of file formats.
+- **quantities and units** — `immlib.Quantity` (a `pint.Quantity` that also
+  supports having no units at all) and `immlib.math`, a small common namespace
+  that operates on quantities, NumPy arrays, and PyTorch tensors alike, so the
+  two backends are interchangeable and units are tracked through the
+  arithmetic.
+
+Alongside these are a set of utilities for testing and coercing types, handling
+persistent and lazy collections, and working with numerical arguments.
+
+## Requirements
+
+`immlib` supports Python 3.10 through 3.14, including the free-threaded (no-GIL)
+builds, and depends on NumPy, SciPy, Pint, `pcollections`, `docshare`, `joblib`,
+`cloudpathlib`, and PyYAML.
+
+PyTorch and pandas are optional. `immlib` never imports PyTorch at import time,
+so it can be used without it (only operations that actually need a tensor
+raise); pandas is needed only by the `csv`/`tsv` save/load formats. See the
+"Stability and Compatibility" page of the
+[documentation](https://noahbenson.github.io/immlib) for the supported version
+ranges of each dependency and what the library promises across releases.
+
+`immlib` is heavily based on the library
+[`pimms`](https://github.com/noahbenson/pimms), which effectively served as a
+prototype for `immlib`. Both libraries were motivated by a number of observations
+about the design of scientific software and are an attempt to make some of these
+problems easier to manage.
+
+For more information, see the [documentation](https://noahbenson.github.io/immlib).

immlib-1.0.0rc2/pyproject.toml

@@ -0,0 +1,95 @@
+[build-system]
+# PEP 639 (SPDX license expressions and license-files) requires setuptools 77;
+# immlib requires Python 3.10, so there is no need for the older-setuptools
+# fallback that a Python 3.8-compatible project would need.
+requires = ["setuptools >= 77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "immlib"
+version = "1.0.0rc2"
+description = """A library of utilities for immutable scientific data."""
+authors = [{name="Noah C. Benson", email="nben@uw.edu"}]
+license = "MIT"
+license-files = ["LICENSE"]
+readme = "README.md"
+requires-python = ">=3.10"
+keywords = ["persistent", "immutable", "functional", "scientific", "workflow"]
+classifiers = [
+    'Intended Audience :: Science/Research',
+    'Intended Audience :: Developers',
+    'Programming Language :: Python :: 3',
+    'Programming Language :: Python :: 3.10',
+    'Programming Language :: Python :: 3.11',
+    'Programming Language :: Python :: 3.12',
+    'Programming Language :: Python :: 3.13',
+    'Programming Language :: Python :: 3.14',
+    'Topic :: Software Development',
+    'Topic :: Software Development :: Libraries',
+    'Topic :: Software Development :: Libraries :: Python Modules',
+    'Topic :: Scientific/Engineering',
+    'Topic :: Scientific/Engineering :: Information Analysis',
+    'Operating System :: Microsoft :: Windows',
+    'Operating System :: POSIX',
+    'Operating System :: Unix',
+    'Operating System :: MacOS']
+dependencies = [
+     'pcollections >= 1.0.0rc1',
+     'numpy >= 1.24.0',
+     # The sparse *array* classes (scipy.sparse.csr_array, etc.) that
+     # immlib.util._numeric uses to describe sparse layouts were added in
+     # scipy 1.8.0.
+     'scipy >= 1.8.0',
+     # immlib.Quantity subclasses pint.Quantity and overrides some of Pint's
+     # private methods and attributes (see immlib.util._quantity), so an upper
+     # bound is kept to the minor series it has been tested against. The test
+     # suite passes against pint 0.24.4, 0.25.3, and 0.26.1 (see the "Pint
+     # contract" tests in immlib.test.util.test_pint); note that pint 0.25+
+     # requires Python 3.11 and pint 0.26+ requires Python 3.12, so a Python
+     # 3.10 install resolves to pint 0.24.x.
+     'pint >= 0.24.0, < 0.27',
+     'docshare >= 0.2.0',
+     'joblib >= 1.3.0',
+     # immlib reaches into a few cloudpathlib internals (notably the private
+     # Client._local_cache_dir, and the CloudPath._no_prefix helpers), so an
+     # upper bound is kept to the minor series it has been tested against
+     # (0.25.0).
+     'cloudpathlib[s3,gs,azure] >= 0.18.0, < 0.26',
+     'pyyaml >= 6.0']
+
+[project.optional-dependencies]
+dev = ["torch >= 2.2.0", "pandas >= 1.5.0", "mypy >= 1.8"]
+# pandas is needed only by the csv/tsv formats of immlib.save/immlib.load, so
+# it is an optional dependency of the library and a test dependency of the
+# suite (which exercises those formats when pandas is present).
+test = ["torch >= 2.2.0", "pandas >= 1.5.0"]
+pandas = ["pandas >= 1.5.0"]
+# Jupyter Book 2 builds with mystmd and uses its own myst.yml configuration
+# (the docs were migrated from Jupyter Book 1); the API-reference pages are
+# generated by docs/generate_api.py before the book is built.
+docs = ["torch >= 2.2.0", "matplotlib >= 3.4.0", "jupyter-book >= 2"]
+
+[tool.setuptools.package-data]
+# Distribute the PEP 561 marker alongside the package, so that type checkers
+# know immlib's inline annotations are usable.
+immlib = ["py.typed"]
+
+[tool.mypy]
+# immlib is annotated progressively, so the checker is kept lenient on bodies
+# that are not annotated yet; the point of running it in CI is to keep the
+# annotations that do exist honest, not to require every function to have them.
+#
+# The target Python version is deliberately not pinned: mypy then follows the
+# interpreter that runs it. Pinning it to an older version makes mypy parse
+# with that version's grammar, which fails on dependency stubs that use newer
+# syntax (numpy's stubs use PEP 695 `type` statements, which need 3.12+), and
+# the CI matrix checks the annotations under more than one interpreter.
+files = ["src/immlib"]
+ignore_missing_imports = true
+check_untyped_defs = false
+warn_unused_ignores = false
+
+[project.urls]
+homepage = "https://github.com/noahbenson/immlib"
+documentation = "https://github.com/noahbenson/immlib"
+repository = "https://github.com/noahbenson/immlib"

{immlib-1.0.0.dev2 → immlib-1.0.0rc2}/src/immlib/__init__.py

@@ -33,37 +33,16 @@ submodules : tuple of str
     A tuple of strings, each of which is the name of one of the submodules in
     ``immlib``. The modules are listed in load-order and all ``immlib``
     submodules, including private submodules, are included.
-docproc: docrep.DocstringProcessor object
-    This object is used to process all of the doc-strings in the ``immlib``
-    library; it should be used only with the ``immlib.docwrap`` decorator,
-    which can safely be applied anywhere in a sequence of decorators and which
-    correctly applies the ``wraps`` decorator to its argument. Function
-    documentation is always processed using the ``sections=('Parameters',
-    'Returns', 'Raises', 'Examples', 'Inputs', 'Outputs')`` parameter and the
-    ``with_indent(4)`` decorator. The base-name for the function ``f`` is
-    ``f.__module__ + '.' + f.__name__``.
 '''
 
 
 # Imports #####################################################################
 
-# We always load _init first.
-from ._init    import reclaim
-# Then the core library.
-from .doc      import *
 from .util     import *
 from .pathlib  import *
 from .iolib    import *
 from .workflow import *
-from .types    import *
-# Import the Global UnitRegistry object to the global immlib scope. This is the
-# value that gets updated when one runs `immlib.default_ureg()`, and this is
-# the UnitRegistry that is used as the default registry for all ``immlib``
-# functions.
-from .util._quantity import _initial_global_ureg as units
-# Do the same for the global DocstringProcessor (from the docrep library) from
-# the doc subpackage.
-from .doc._core import _initial_global_docproc as docproc
+from . import  math
 # We want the version object from the ._version namespace; this is always last.
 from ._version import (version, Version)
 
@@ -71,9 +50,6 @@ from ._version import (version, Version)
 # Modules/Reloading ###########################################################
 
 submodules = (
-    'immlib._init',
-    'immlib.doc._core',
-    'immlib.doc',
     'immlib.util._core',
     'immlib.util._numeric',
     'immlib.util._quantity',
@@ -87,8 +63,8 @@ submodules = (
     'immlib.workflow._core',
     'immlib.workflow._plantype',
     'immlib.workflow',
-    'immlib.types._core',
-    'immlib.types',
+    'immlib.math._core',
+    'immlib.math',
     'immlib._version')
 def reload_immlib():
     """Reload and return the entire ``immlib`` package.
@@ -126,6 +102,22 @@ __all__ = tuple(
      if k[0] != '_'
      if k != 'submodules'
      if k != 'version'
-     if ('immlib.' + k) not in submodules])
-# We want to mark our functions as being from the immlib module.
-reclaim(__name__, __all__, del_reclaim=True)
+     if ('immlib.' + k) not in submodules]
+    + ['units'])
+# immlib.units is a property of the module: it returns the unit registry set
+# by an enclosing immlib.default_ureg block in the current thread, if any, or
+# the global default registry otherwise; assigning to it sets the global
+# default registry.
+import sys as _sys
+import types as _types
+class _ImmlibModule(_types.ModuleType):
+    @property
+    def units(self):
+        from .util._core import _default_ureg
+        return _default_ureg()
+    @units.setter
+    def units(self, ureg):
+        from .util._core import _global_ureg
+        _global_ureg[0] = ureg
+_sys.modules[__name__].__class__ = _ImmlibModule
+del _sys, _types

{immlib-1.0.0.dev2 → immlib-1.0.0rc2}/src/immlib/_version.py

@@ -1,17 +1,21 @@
 # -*- coding: utf-8 -*-
-################################################################################
+###############################################################################
 # immlib/_version.py
 
 
-# Dependencies #################################################################
+# Dependencies ################################################################
+
+from __future__ import annotations
 
 from ast import literal_eval
+from typing import Iterator
 from collections import namedtuple
 from pathlib import Path
+from os import PathLike
 from warnings import warn
 
 
-# Version Type #################################################################
+# Version Type ################################################################
 
 VersionTuple = namedtuple(
     'VersionTuple',
@@ -20,50 +24,53 @@ class Version(VersionTuple):
     """A type that represents a Python package version.
 
     Python packages are represented simultaneously as version strings, version
-    tuples, and by the version components `major`, `minor`, `micro`, and
-    `stage`.
+    tuples, and by the version components ``major``, ``minor``, ``micro``, and
+    ``stage``.
 
     Parameters
     ----------
     string : str or None, optional
         The version string to be represented. If this argument is not provided,
-        then one or both of the `package_name` and `pyproject_path` options must
-        be provided so that the version string can be obtained via the package
-        version or the `pyproject.toml` file.
+        then one or both of the ``package_name`` and ``pyproject_path`` options
+        must be provided so that the version string can be obtained via the
+        package version or the ``pyproject.toml`` file.
     package_name : str or None, optional
-        If the first argument (`string`) is provided, then this argument is
+        If the first argument (``string``) is provided, then this argument is
         ignored; otherwise, the version string is first searched for by this
-        package name using the `importlib` or `importlib_metadata` packages. If
-        found, then this version string is represented in the `Version` object.
+        package name using the ``importlib.metadata`` package. If found, then
+        this version string is represented in the
+        ``Version`` object.
     pyproject_path : path-like or None, optional
-        If the first argument (`string`) is not given and the `package_name` is
-        not given, then the version is searched for in the `pyproject.toml` file
-        given by this path. In order for such a file to be valid, it must
-        contain a line that, when stripped of whitespace, begins with the string
-        `'version='` followed by a string representation (e.g.,
-        `'version="1.12.5"'`). If such a line is found in the `[project]`
-        section of the TOM: file pointed to by this argument, then it is
-        represented as the version string in the `Version` object.
+        If the first argument (``string``) is not given and the
+        ``package_name`` is not given, then the version is searched for in the
+        ``pyproject.toml`` file given by this path. In order for such a file to
+        be valid, it must contain a line that, when stripped of whitespace,
+        begins with the string ``'version='`` followed by a string
+        representation (e.g., ``'version="1.12.5"'``). If such a line is found
+        in the ``[project]`` section of the TOM: file pointed to by this
+        argument, then it is represented as the version string in the
+        ``Version`` object.
     on_error : {'warn' | 'ignore' | 'raise'}, optional
         How to handle failures to deduce or parse the version number. If
-        `'raise'` is given, then the errors are allowed to be raised. If
-        `'warn'`, then a warning is raised and a null version is returned. If
-        `'ignore'`, then errors are ignored and a null version is returned. The
-        default is `'raise'`.
+        ``'raise'`` is given, then the errors are allowed to be raised. If
+        ``'warn'``, then a warning is raised and a null version is returned. If
+        ``'ignore'``, then errors are ignored and a null version is
+        returned. The default is ``'raise'``.
+    
     tag_prefixes : tuple of str, optional
         An optional tuple of strings that can appear as the prefixes of stage
-        tagss at the end of the version string. By default, this is `('rc', 'a',
-        'b')`, so version strings like `'1.1.12a6'` and `'1.1.12rc6'` are valid
-        but `'1.1.12c6'` is not.
+        tagss at the end of the version string. By default, this is ``('rc',
+        'a', 'b')``, so version strings like ``'1.1.12a6'`` and ``'1.1.12rc6'``
+        are valid but ``'1.1.12c6'`` is not.
     
     Attributes
     ----------
     string : str
-        The string representing the package version. For example `"1.2.15"` or
-        `"0.2.2.dev1"`.
+        The string representing the package version. For example ``"1.2.15"``
+        or ``"0.2.2.dev1"``.
     tuple : tuple of int and str
-        The components of the version string, for example, `(1, 2, 15)` or
-        `(0, 2, 2, 'dev1')`. Any missing component is excluded.
+        The components of the version string, for example, ``(1, 2, 15)`` or
+        ``(0, 2, 2, 'dev1')``. Any missing component is excluded.
     major : int
         The major version number, typically indicates major API version.
     minor : int
@@ -71,32 +78,33 @@ class Version(VersionTuple):
     micro : int
         The micro version number, typically indicates patch increment number.
     stage : str
-        The development stage of the version. For example `'dev1'` or `'rc2'`.
+        The development stage of the version. For example ``'dev1'`` or
+        ``'rc2'``.
     """
 
-    # Static Methods -----------------------------------------------------------
-    def getstring(package_name=None, pyproject_path=None):
+    # Static Methods ----------------------------------------------------------
+    @staticmethod
+    def getstring(package_name: str | None = None,
+                  pyproject_path: str | PathLike[str] | None = None) -> str:
         """Returns the current version string for the given package name.
         
-        `Version.getstring(package_name)` returns the version string of the
+        ``Version.getstring(package_name)`` returns the version string of the
         package with the given package name.
         
-        `Version.getstring(pyproject_path=path)` returns the version string
-        found in the pyproject.toml file found at the given `path`.
+        ``Version.getstring(pyproject_path=path)`` returns the version string
+        found in the pyproject.toml file found at the given ``path``.
         
-        `Version.getstring(package_name, path)` returns
-        `Version.getstring(package_name)` if the given `package_name` is found,
-        otherwise returns `Version.getstring(pyproject_path=path)`.
+        ``Version.getstring(package_name, path)`` returns
+        ``Version.getstring(package_name)`` if the given ``package_name`` is
+        found, otherwise returns ``Version.getstring(pyproject_path=path)``.
         """
         if package_name is None and pyproject_path is None:
             raise ValueError("Version.getstring() requires 1 or 2 arguments")
         if package_name is not None:
-            try:
-                from importlib.metadata import version
-                from importlib.metadata import PackageNotFoundError
-            except ModuleNotFoundError:
-                from importlib_metadata import version
-                from importlib_metadata import PackageNotFoundError
+            # immlib requires Python 3.10 or later, so importlib.metadata is
+            # always available (the importlib_metadata backport is not needed).
+            from importlib.metadata import version
+            from importlib.metadata import PackageNotFoundError
             if pyproject_path is None:
                 return version(package_name)
             # Try to deduce the version string but don't raise if this fails.
@@ -106,13 +114,19 @@ class Version(VersionTuple):
                 pass
         # Either a package name wasn't given or the package wasn't found; check
         # the pyproject.toml if possible.
-        path = Path(pyproject_path)
+        path = Path(pyproject_path)  # type: ignore[arg-type]
         with path.open('rt') as fl:
             toml_lines = fl.read().split('\n')
         in_project_section = False
         for ln in toml_lines:
             ln = ln.strip()
-            if ln == '[project]':
+            if not ln or ln.startswith('#'):
+                # A blank line or a comment: neither starts a section nor
+                # declares anything. (The emptiness test must come first;
+                # ln[0] below would raise for a blank line, and every real
+                # pyproject.toml has blank lines in it.)
+                continue
+            elif ln == '[project]':
                 in_project_section = True
             elif ln[0] == '[' and ln[-1] == ']':
                 in_project_section = False
@@ -131,7 +145,7 @@ class Version(VersionTuple):
                 f"Version.getstring() found no 'version = ...' line in file"
                 f" {path}")
 
-    # Construction -------------------------------------------------------------
+    # Construction ------------------------------------------------------------
     __slots__ = ()
     null = None
     def __new__(cls, string=None, /, *,
@@ -172,7 +186,7 @@ class Version(VersionTuple):
                 micro = '0'
                 last = minor
             elif nss == 1:
-                major = ss
+                (major,) = ss
                 (minor, micro) = ('0', '0')
                 last = major
             else:
@@ -203,20 +217,20 @@ class Version(VersionTuple):
             minor=minor,
             micro=micro,
             stage=stage)
-    def __str__(self):
+    def __str__(self) -> str:
         return self.string
-    def __repr__(self):
+    def __repr__(self) -> str:
         return f"Version({repr(self.string)})"
-    def __iter__(self):
+    def __iter__(self) -> Iterator[object]:
         return iter(self.tuple)
-    def __reversed__(self):
+    def __reversed__(self) -> Iterator[object]:
         return reversed(self.tuple)
-    def __contains__(self, k):
+    def __contains__(self, k: object) -> bool:
         if isinstance(k, str):
             return k in self.string
         else:
             return k in self.tuple
-Version.null = VersionTuple.__new__(
+Version.null = VersionTuple.__new__(  # type: ignore[assignment]
     Version,
     string='',
     tuple=(),
@@ -226,7 +240,7 @@ Version.null = VersionTuple.__new__(
     stage=None)
 
 
-# Variables ####################################################################
+# Variables ###################################################################
 
 # The path of immlib's pyproject.toml file.
 pyproject_path = Path(__file__).parent.parent.parent / 'pyproject.toml'

{immlib-1.0.0.dev2 → immlib-1.0.0rc2}/src/immlib/iolib/__init__.py

@@ -1,10 +1,10 @@
 # -*- coding: utf-8 -*-
 ################################################################################
-# pimms/iolib/__init__.py
+# immlib/iolib/__init__.py
 
-"""Input/output tools managed by pimms; primarily the save and load functions.
+"""Input/output tools managed by immlib; primarily the save and load functions.
 
-The `pimms.iolib` module contains tools for saving and loading data to/from
+The `immlib.iolib` module contains tools for saving and loading data to/from
 paths or streams. This functionality is primarily supported via the `save` and
 `load` objects that behave as general (de)serializers to which formats can be
 registered.
@@ -21,9 +21,3 @@ __all__ = (
     'save',
     'Load',
     'load')
-
-# Mark these as native to this module.
-Save.__module__ = __name__
-save.__module__ = __name__
-Load.__module__ = __name__
-load.__module__ = __name__