let3 2.4.2__tar.gz → 2.4.3__tar.gz

{let3-2.4.2 → let3-2.4.3}/CHANGES.rst

@@ -1,13 +1,13 @@
 Changelog
 =========
 
-2.4.2 (2026-05-17)
+2.4.3 (2026-06-01)
 ------------------
 - Added support for GraalPy 3.12
 - Full support for Python 3.15
 - Dropped support for Python 3.10 (due to compatibility issues).
 - Fix for nox 'lint' session.
-- Setup update, fixes and improvement.
+- Setup updates, fixes and improvements.
 
 2.3.0 (2026-03-30)
 ------------------

{let3-2.4.2/src/let3.egg-info → let3-2.4.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: let3
-Version: 2.4.2
+Version: 2.4.3
 Summary: Assign variables wherever, whenever you want.
 Author-email: Adam Karpierz <adam@karpierz.net>, Taylor Marks <taylor@marksfam.com>
 Maintainer-email: Adam Karpierz <adam@karpierz.net>
@@ -60,12 +60,12 @@ Quick Start
 -----------
 Once you've installed, you can really quickly verified that it works with just this:
 
-.. code-block:: python
+.. code:: python
 
-    >>> from let import let
-    >>> if let(count = len("Hello World!")):
-    ...     print(count)
-    12
+  >>> from let import let
+  >>> if let(count = len("Hello World!")):
+  ...     print(count)
+  12
 
 Documentation
 -------------
@@ -76,17 +76,17 @@ both assign the value, and check whether a condition is met.
 This ability doesn't exist in Python, because of the thought that when people
 write something like:
 
-.. code-block:: python
+.. code:: python
 
-    if row = db.fetch_results():
-        ...
+  if row = db.fetch_results():
+      ...
 
 They may have actually meant:
 
-.. code-block:: python
+.. code:: python
 
-    if row == db.fetch_results():
-        ...
+  if row == db.fetch_results():
+      ...
 
 Personally, I have never made this mistake. It seems far more like a theoretical
 mistake that could plausibly happen than one that actually happens and warrants
@@ -95,17 +95,17 @@ removing features, as was chosen in Python.
 Anyways, the let function in this module gives you something very close to that
 ability in other languages. A few examples:
 
-.. code-block:: python
+.. code:: python
 
-    if let(name = longInstanceName.longAttributeName):
-        ...
+  if let(name = longInstanceName.longAttributeName):
+      ...
 
-    # Yes, db.fetch_results() should just return a generator. No, it doesn't.
-    while let(results = db.fetch_results()):
-        ...
+  # Yes, db.fetch_results() should just return a generator. No, it doesn't.
+  while let(results = db.fetch_results()):
+      ...
 
-    if let(count = len(nameValuePair)) != 1:
-        raise Exception(f"Bad amount: {count}")
+  if let(count = len(nameValuePair)) != 1:
+      raise Exception(f"Bad amount: {count}")
 
 Installation
 ============

{let3-2.4.2 → let3-2.4.3}/README.rst

@@ -21,12 +21,12 @@ Quick Start
 -----------
 Once you've installed, you can really quickly verified that it works with just this:
 
-.. code-block:: python
+.. code:: python
 
-    >>> from let import let
-    >>> if let(count = len("Hello World!")):
-    ...     print(count)
-    12
+  >>> from let import let
+  >>> if let(count = len("Hello World!")):
+  ...     print(count)
+  12
 
 Documentation
 -------------
@@ -37,17 +37,17 @@ both assign the value, and check whether a condition is met.
 This ability doesn't exist in Python, because of the thought that when people
 write something like:
 
-.. code-block:: python
+.. code:: python
 
-    if row = db.fetch_results():
-        ...
+  if row = db.fetch_results():
+      ...
 
 They may have actually meant:
 
-.. code-block:: python
+.. code:: python
 
-    if row == db.fetch_results():
-        ...
+  if row == db.fetch_results():
+      ...
 
 Personally, I have never made this mistake. It seems far more like a theoretical
 mistake that could plausibly happen than one that actually happens and warrants
@@ -56,17 +56,17 @@ removing features, as was chosen in Python.
 Anyways, the let function in this module gives you something very close to that
 ability in other languages. A few examples:
 
-.. code-block:: python
+.. code:: python
 
-    if let(name = longInstanceName.longAttributeName):
-        ...
+  if let(name = longInstanceName.longAttributeName):
+      ...
 
-    # Yes, db.fetch_results() should just return a generator. No, it doesn't.
-    while let(results = db.fetch_results()):
-        ...
+  # Yes, db.fetch_results() should just return a generator. No, it doesn't.
+  while let(results = db.fetch_results()):
+      ...
 
-    if let(count = len(nameValuePair)) != 1:
-        raise Exception(f"Bad amount: {count}")
+  if let(count = len(nameValuePair)) != 1:
+      raise Exception(f"Bad amount: {count}")
 
 Installation
 ============

{let3-2.4.2 → let3-2.4.3}/docs/conf.py

@@ -44,22 +44,29 @@ needs_sphinx = '8.1.3'
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
+    'myst_parser',
     'sphinx.ext.autodoc',
     'sphinx.ext.autosummary',
     'sphinx.ext.doctest',
     'sphinx.ext.intersphinx',
    #'sphinx.ext.todo',
    #'sphinx.ext.coverage',
+    'sphinx.ext.viewcode',
     'sphinx.ext.ifconfig',
     'sphinx.ext.napoleon',
     'sphinx_autodoc_typehints',
-   #'sphinx_toolbox',
     'sphinx_tabs.tabs',
+    'sphinx-prompt',
     'sphinx_copybutton',
     'sphinxcontrib.spelling',
     'nbsphinx',
 ]
 
+source_suffix = {
+    '.rst': 'restructuredtext',
+    '.md':  'markdown',
+}
+
 # Needed for e.g. linkcheck builder
 tls_verify = False
 
@@ -97,6 +104,16 @@ html_static_path = ['_static']
 
 # -- Extension configuration -------------------------------------------------
 
+# -- Options for MyST extension ----------------------------------------------
+
+myst_enable_extensions = [
+    'colon_fence',      # ```{note} ... ```
+    'deflist',          # definitions list
+    'fieldlist',        # fields as in reST
+    'html_admonition',  # :::note
+    'html_image',       # ![alt](img.png)
+]
+
 # -- Options for autodoc extension -------------------------------------------
 
 autoclass_content = 'both'

let3-2.4.3/noxfile.py

@@ -0,0 +1,94 @@
+# Copyright (c) 2026 Adam Karpierz
+# SPDX-License-Identifier: Zlib
+
+# /// script
+# dependencies = ["nox>=2026.4.10", "nox_ext", "nox_lib"]
+# ///
+
+from __future__ import annotations
+
+from typing import Any
+import sys
+import os
+import shutil
+import subprocess
+import warnings
+
+import nox
+import nox_ext
+import nox_lib
+from nox_ext import print, pprint
+from nox_lib.util import Path, copytree, rmtree
+
+env = os.environ
+
+# Configuration
+
+PKG = nox.get_package_data()
+
+PYPROJECT   = nox.project.load_toml("pyproject.toml")
+PY_VERSIONS = nox.project.python_versions(PYPROJECT)
+PY_DEFAULT  = "3.13"
+
+# Prevent Python from writing bytecode
+env["PYTHONDONTWRITEBYTECODE"] = "1"
+# env["PKG_INITIAL_BUILD"] = "1"
+
+# Sessions
+
+@nox.session(python=[PY_DEFAULT], default=False,
+    requires=["cleanup"])
+def prepare(session: nox.Session) -> None:
+    """Preparing the repository"""
+    nox_lib.prepare.prep_cmd(session)
+
+@nox.session(python=[PY_DEFAULT], default=False)
+def cleanup(session: nox.Session) -> None:
+    """Cleaning the repository"""
+    nox_lib.cleanup.clean_cmd(session)
+    nox_lib.cleanup.cleanup(session)
+
+@nox.session(python=[*PY_VERSIONS, "pypy3.11", "graalpy3.12"])
+def tests(session: nox.Session) -> None:
+    """Running tests"""
+    session.install(".", "--group=test")
+    nox_lib.tests.unittests(session)
+
+@nox.session(python=[PY_DEFAULT])
+def coverage(session: nox.Session) -> None:
+    """Running code coverage analysis"""
+    session.install(".", "--group=coverage")
+    nox_lib.coverage.coverage(session)
+
+@nox.session(python=[PY_DEFAULT])
+def docs(session: nox.Session) -> None:
+    """Building documentation and running doc tests"""
+    session.install(".", "--group=docs")
+    nox_lib.docs.sphinx(session)
+
+@nox.session(python=[PY_DEFAULT], default=False,
+    requires=["tests", "docs"])
+def build(session: nox.Session) -> None:
+    """Building the package"""
+    session.install("--group=build")
+    nox_lib.build.build(session)
+
+@nox.session(python=[PY_DEFAULT], default=False,
+    requires=["build"])
+def publish(session: nox.Session) -> None:
+    """Publishing the package and documentation"""
+    session.install("--group=publish")
+    nox_lib.publish.on_pypi(session)
+    nox_lib.publish.docs_on_gh_pages(session)
+
+@nox.session(python=[PY_DEFAULT])
+def typing(session: nox.Session) -> None:
+    """Static type checking"""
+    session.install(".", "--group=typing")
+    nox_lib.typing.mypy(session)
+
+@nox.session(python=[PY_DEFAULT])
+def lint(session: nox.Session) -> None:
+    """Checking code style and quality"""
+    session.install(".", "--group=lint")
+    nox_lib.lint.flake8(session)

{let3-2.4.2 → let3-2.4.3}/pyproject.toml

@@ -7,7 +7,7 @@ requires = [ "setuptools>=81.0.0", "packaging>=26.2.0" ]
 
 [project]
 name = "let3"
-version = "2.4.2"
+version = "2.4.3"
 description = "Assign variables wherever, whenever you want."
 keywords = [ "let", "let3", "assign", "assignment", "var", "variable",
              "conditional", "if", "while"]
@@ -59,7 +59,7 @@ dependencies = [
 
 [dependency-groups]
 base = [
-  "pip>=26.1.1; platform_python_implementation!='GraalVM'",
+  "pip>=26.1.2; platform_python_implementation!='GraalVM'",
   "pip>=24.3.1; platform_python_implementation=='GraalVM'",
   "setuptools>=81.0.0",
 ]
@@ -71,18 +71,19 @@ test = [
 ]
 coverage = [
   { include-group = "test" },
-  "coverage>=7.14.0",
+  "coverage>=7.14.1",
   "covdefaults>=2.3.0",
-  "diff-cover>=10.2.0",
+  "diff-cover>=10.3.0",
 ]
 docs = [
   { include-group = "base" },
   "sphinx>=9.0.4",
   "pygments_ansi_color>=0.3.0", # fix sphinx load error
   "roman_numerals>=4.1.0",      #         -||-
+  "myst-parser>=5.1.0",
   "sphinx-autodoc-typehints>=3.6.1",
-  "sphinx-toolbox>=4.1.2",
-  "sphinx-tabs>=3.4.5", # Do not change - sphinx-toolbox requires <3.4.7
+  "sphinx-tabs>=3.5.0",
+  "sphinx-prompt>=1.10.2",
   "sphinx-copybutton>=0.5.2",
   "sphinxcontrib-spelling>=8.0.2",
   "sphinx-lint>=1.0.2",

{let3-2.4.2 → let3-2.4.3/src/let3.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: let3
-Version: 2.4.2
+Version: 2.4.3
 Summary: Assign variables wherever, whenever you want.
 Author-email: Adam Karpierz <adam@karpierz.net>, Taylor Marks <taylor@marksfam.com>
 Maintainer-email: Adam Karpierz <adam@karpierz.net>
@@ -60,12 +60,12 @@ Quick Start
 -----------
 Once you've installed, you can really quickly verified that it works with just this:
 
-.. code-block:: python
+.. code:: python
 
-    >>> from let import let
-    >>> if let(count = len("Hello World!")):
-    ...     print(count)
-    12
+  >>> from let import let
+  >>> if let(count = len("Hello World!")):
+  ...     print(count)
+  12
 
 Documentation
 -------------
@@ -76,17 +76,17 @@ both assign the value, and check whether a condition is met.
 This ability doesn't exist in Python, because of the thought that when people
 write something like:
 
-.. code-block:: python
+.. code:: python
 
-    if row = db.fetch_results():
-        ...
+  if row = db.fetch_results():
+      ...
 
 They may have actually meant:
 
-.. code-block:: python
+.. code:: python
 
-    if row == db.fetch_results():
-        ...
+  if row == db.fetch_results():
+      ...
 
 Personally, I have never made this mistake. It seems far more like a theoretical
 mistake that could plausibly happen than one that actually happens and warrants
@@ -95,17 +95,17 @@ removing features, as was chosen in Python.
 Anyways, the let function in this module gives you something very close to that
 ability in other languages. A few examples:
 
-.. code-block:: python
+.. code:: python
 
-    if let(name = longInstanceName.longAttributeName):
-        ...
+  if let(name = longInstanceName.longAttributeName):
+      ...
 
-    # Yes, db.fetch_results() should just return a generator. No, it doesn't.
-    while let(results = db.fetch_results()):
-        ...
+  # Yes, db.fetch_results() should just return a generator. No, it doesn't.
+  while let(results = db.fetch_results()):
+      ...
 
-    if let(count = len(nameValuePair)) != 1:
-        raise Exception(f"Bad amount: {count}")
+  if let(count = len(nameValuePair)) != 1:
+      raise Exception(f"Bad amount: {count}")
 
 Installation
 ============

let3-2.4.2/noxfile.py

@@ -1,157 +0,0 @@
-# Copyright (c) 2026 Adam Karpierz
-# SPDX-License-Identifier: Zlib
-
-# /// script
-# dependencies = ["nox>=2026.4.10", "nox_ext", "nox_lib"]
-# ///
-
-from __future__ import annotations
-
-from typing import Any
-import sys
-import os
-from pathlib import Path
-from functools import partial
-import shutil
-import subprocess
-import warnings
-
-import nox
-import nox_ext
-from nox_ext import print, pprint
-
-here = Path(__file__).resolve().parent
-env  = os.environ
-
-# Configuration
-
-PKG = nox.get_package_data(here)
-
-PYPROJECT   = nox.project.load_toml("pyproject.toml")
-PY_VERSIONS = nox.project.python_versions(PYPROJECT)
-PY_DEFAULT  = "3.13"
-
-# Prevent Python from writing bytecode
-env["PYTHONDONTWRITEBYTECODE"] = "1"
-# env["PKG_INITIAL_BUILD"] = "1"
-
-# Helpers & Utils
-
-copytree = shutil.copytree
-rmtree   = partial(shutil.rmtree, ignore_errors=True)
-
-# Sessions
-
-@nox.session(python=[PY_DEFAULT], default=False,
-    requires=["cleanup"])
-def prepare(session: nox.Session) -> None:
-    """Preparing the repository"""
-    cmd = here/".aprep.cmd"
-    if cmd.is_file(): session.run(cmd, external=True)
-
-@nox.session(python=[PY_DEFAULT], default=False)
-def cleanup(session: nox.Session) -> None:
-    """Cleaning the repository"""
-    # no_package = true
-    cmd = here/".clean.cmd"
-    if cmd.is_file():
-        session.run(cmd, stderr=subprocess.DEVNULL, external=True)
-    rmtree(here/"build")
-    rmtree(here/"dist")
-    for item in here.glob("src/*.egg-info"): rmtree(item)
-    for item in here.glob("**/__pycache__"): rmtree(item)
-    for item in here.glob("**/.mypy_cache"): rmtree(item)
-    rmtree(here/".tox")
-    rmtree(here/".nox")
-
-@nox.session(python=[*PY_VERSIONS, "pypy3.11", "graalpy3.12"])
-def tests(session: nox.Session) -> None:
-    """Running tests"""
-    session.install(".", "--group=test")
-    session.py("--version")
-    session.py("-m", "tests", *session.posargs)
-
-@nox.session(python=[PY_DEFAULT])
-def coverage(session: nox.Session) -> None:
-    """Running code coverage analysis"""
-    session.install(".", "--group=coverage")
-    env_dir = Path(session.virtualenv.location)
-    data_file = env_dir/".coverage"
-    html_dir  = env_dir/".coverage_html"
-    session.py("-m", "coverage", "erase", f"--data-file={data_file}")
-    session.py("-m", "coverage", "run",   f"--data-file={data_file}", "-m", "tests",
-               *session.posargs, success_codes=range(0, 256))
-    session.py("-m", "coverage", "html",  f"--data-file={data_file}", f"--directory={html_dir}",
-               success_codes=range(0, 256))
-    session.py("-m", "coverage", "report", f"--data-file={data_file}")
-
-@nox.session(python=[PY_DEFAULT])
-def docs(session: nox.Session) -> None:
-    """Building documentation and running doc tests"""
-    session.install(".", "--group=docs")
-    html_dir = here/"build/docs/html"
-    session.py("-m", "sphinxlint", "-i", "#arch", "-i", ".nox", "-i", ".tox",
-                                   "-i", "build", "-i", "dist", "-i", ".mypy_cache")
-    # session.py("-m", "sphinx.apidoc", "-f", *[session.site_packages/f"{item}/"
-    #                                           for item in PKG.TOP_LEVELS])
-    session.py("-m", "sphinx.cmd.build", "-W", "-a", "-b", "html", "-E", here/"docs", html_dir)
-    session.py("-m", "sphinx.cmd.build", "-W", "-a", "-b", "doctest",    here/"docs", html_dir)
-    session.py("-m", "sphinx.cmd.build", "-W", "-a", "-b", "linkcheck",  here/"docs", html_dir)
-
-@nox.session(python=[PY_DEFAULT], default=False,
-    requires=["tests", "docs"])
-def build(session: nox.Session) -> None:
-    """Building the package"""
-    session.install("--group=build")
-    session.py("-m", "check_manifest", "-v")
-    session.py("-m", "build")
-    # Verify distribution files
-    session.py("-m", "twine", "check", "dist/*")
-
-@nox.session(python=[PY_DEFAULT], default=False,
-    requires=["build"])
-def publish(session: nox.Session) -> None:
-    """Publishing the package and documentation"""
-    session.install("--group=publish")
-    # Publish on PyPI
-    session.py("-m", "twine", "upload", "dist/*")
-    # Publish documentation on GitHub Pages
-    # checkout gh-pages worktree
-    env_dir = Path(session.virtualenv.location)
-    gh_pages_dir = env_dir/"gh-pages"
-    rmtree(gh_pages_dir)
-    session.git("worktree", "prune")
-    # session.git("worktree", "add", gh_pages_dir, "gh-pages")
-    session.git("worktree", "add", "-B", "gh-pages", gh_pages_dir)
-    # clean old docs
-    (gh_pages_dir/".nojekyll").touch()
-    for fpath in gh_pages_dir.iterdir():
-        if fpath.name not in (".git",".nojekyll"):
-            if fpath.is_dir():
-                rmtree(fpath)
-            else:
-                fpath.unlink(missing_ok=True)
-    # copy new docs
-    copytree(here/"build/docs/html", gh_pages_dir, dirs_exist_ok=True)
-    # commit + push
-    session.git("-C", gh_pages_dir, "add", ".")
-    session.git("-C", gh_pages_dir, "commit", "-m", "Update documentation")
-    session.git("-C", gh_pages_dir, "push", "--force", "origin", "gh-pages")
-    # remove worktree
-    session.git("worktree", "remove", "--force", gh_pages_dir)
-    rmtree(gh_pages_dir)
-    session.git("worktree", "prune")
-
-@nox.session(python=[PY_DEFAULT])
-def typing(session: nox.Session) -> None:
-    """Static type checking"""
-    session.install(".", "--group=typing")
-    session.py("-m", "mypy")
-
-@nox.session(python=[PY_DEFAULT])
-def lint(session: nox.Session) -> None:
-    """Checking code style and quality"""
-    session.install(".", "--group=lint")
-    env_dir = Path(session.virtualenv.location)
-    out_file = env_dir/"flake8out.txt"
-    session.py("-m", "flake8", "--output-file", out_file, here/"src/")