unpythonic 0.15.2__tar.gz → 0.15.5__tar.gz

{unpythonic-0.15.2/unpythonic.egg-info → unpythonic-0.15.5}/PKG-INFO

@@ -1,13 +1,10 @@
 Metadata-Version: 2.1
 Name: unpythonic
-Version: 0.15.2
+Version: 0.15.5
 Summary: Supercharge your Python with parts of Lisp and Haskell.
-Home-page: https://github.com/Technologicat/unpythonic
-Author: Juha Jeronen
-Author-email: juha.m.jeronen@gmail.com
-License: BSD
 Keywords: functional-programming,language-extension,syntactic-macros,tail-call-optimization,tco,continuations,currying,lazy-evaluation,dynamic-variable,macros,lisp,scheme,racket,haskell
-Platform: Linux
+Author-Email: Juha Jeronen <juha.m.jeronen@gmail.com>
+License: BSD
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -15,26 +12,26 @@ Classifier: License :: OSI Approved :: BSD License
 Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
 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 :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Provides: unpythonic
-Requires-Python: >=3.6,<3.11
+Project-URL: Repository, https://github.com/Technologicat/unpythonic
+Requires-Python: <3.13,>=3.8
+Requires-Dist: mcpyrate>=3.6.4
+Requires-Dist: sympy>=1.13
 Description-Content-Type: text/markdown
-License-File: LICENSE.md
-License-File: AUTHORS.md
 
 # Unpythonic: Python meets Lisp and Haskell
 
 In the spirit of [toolz](https://github.com/pytoolz/toolz), we provide missing features for Python, mainly from the list processing tradition, but with some Haskellisms mixed in. We extend the language with a set of [syntactic macros](https://en.wikipedia.org/wiki/Macro_(computer_science)#Syntactic_macros). We also provide an in-process, background [REPL](https://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop) server for live inspection and hot-patching. The emphasis is on **clear, pythonic syntax**, **making features work together**, and **obsessive correctness**.
 
-![100% Python](https://img.shields.io/github/languages/top/Technologicat/unpythonic) ![supported language versions](https://img.shields.io/pypi/pyversions/unpythonic) ![supported implementations](https://img.shields.io/pypi/implementation/unpythonic) ![CI status](https://img.shields.io/github/workflow/status/Technologicat/unpythonic/Python%20package) [![codecov](https://codecov.io/gh/Technologicat/unpythonic/branch/master/graph/badge.svg)](https://codecov.io/gh/Technologicat/unpythonic)  
+![100% Python](https://img.shields.io/github/languages/top/Technologicat/unpythonic) ![supported language versions](https://img.shields.io/pypi/pyversions/unpythonic) ![supported implementations](https://img.shields.io/pypi/implementation/unpythonic) ![CI status](https://img.shields.io/github/actions/workflow/status/Technologicat/unpythonic/python-package.yml?branch=master) [![codecov](https://codecov.io/gh/Technologicat/unpythonic/branch/master/graph/badge.svg)](https://codecov.io/gh/Technologicat/unpythonic)  
 ![version on PyPI](https://img.shields.io/pypi/v/unpythonic) ![PyPI package format](https://img.shields.io/pypi/format/unpythonic) ![dependency status](https://img.shields.io/librariesio/github/Technologicat/unpythonic)  
 ![license: BSD](https://img.shields.io/pypi/l/unpythonic) ![open issues](https://img.shields.io/github/issues/Technologicat/unpythonic) [![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen)](http://makeapullrequest.com/)
 
@@ -47,7 +44,7 @@ None required.
 
  - [`mcpyrate`](https://github.com/Technologicat/mcpyrate) optional, to enable the syntactic macro layer, an interactive macro REPL, and some example dialects.
 
-The 0.15.x series should run on CPython 3.6, 3.7, 3.8, 3.9 and 3.10, and PyPy3 (language versions 3.6, 3.7 and 3.8); the [CI](https://en.wikipedia.org/wiki/Continuous_integration) process verifies the tests pass on those platforms. [Long-term support roadmap](https://github.com/Technologicat/unpythonic/issues/1).
+As of v0.15.3, `unpythonic` runs on CPython 3.8, 3.9 and 3.10, 3.11, 3.12, and PyPy3 (language versions 3.8, 3.9, 3.10); the [CI](https://en.wikipedia.org/wiki/Continuous_integration) process verifies the tests pass on those platforms. New Python versions are added and old ones are removed following the [Long-term support roadmap](https://github.com/Technologicat/unpythonic/issues/1).
 
 
 ### Documentation
@@ -626,13 +623,13 @@ As usual in test frameworks, the testing constructs behave somewhat like `assert
 ```python
 from unpythonic.syntax import macros, let, letseq, letrec
 
-x = let[[a << 1, b << 2] in a + b]
-y = letseq[[c << 1,  # LET SEQuential, like Scheme's let*
-            c << 2 * c,
-            c << 2 * c] in
+x = let[[a := 1, b := 2] in a + b]
+y = letseq[[c := 1,  # LET SEQuential, like Scheme's let*
+            c := 2 * c,
+            c := 2 * c] in
            c]
-z = letrec[[evenp << (lambda x: (x == 0) or oddp(x - 1)),  # LET mutually RECursive, like in Scheme
-            oddp << (lambda x: (x != 0) and evenp(x - 1))]
+z = letrec[[evenp := (lambda x: (x == 0) or oddp(x - 1)),  # LET mutually RECursive, like in Scheme
+            oddp := (lambda x: (x != 0) and evenp(x - 1))]
            in evenp(42)]
 ```
 </details>  
@@ -643,10 +640,10 @@ z = letrec[[evenp << (lambda x: (x == 0) or oddp(x - 1)),  # LET mutually RECurs
 ```python
 from unpythonic.syntax import macros, dlet
 
-# Up to Python 3.8, use `@dlet(x << 0)` instead
-@dlet[x << 0]  # let-over-lambda for Python
+# In Python 3.8, use `@dlet(x << 0)` instead; in Python 3.9, use `@dlet(x := 0)`
+@dlet[x := 0]  # let-over-lambda for Python
 def count():
-    return x << x + 1  # `name << value` rebinds in the let env
+    return x := x + 1  # `name := value` rebinds in the let env
 assert count() == 1
 assert count() == 2
 ```
@@ -658,8 +655,8 @@ assert count() == 2
 ```python
 from unpythonic.syntax import macros, do, local, delete
 
-x = do[local[a << 21],
-       local[b << 2 * a],
+x = do[local[a := 21],
+       local[b := 2 * a],
        print(b),
        delete[b],  # do[] local variables can be deleted, too
        4 * a]
@@ -783,8 +780,8 @@ assert square.__name__ == "square"
 # - brackets denote a multiple-expression lambda body
 #   (if you want to have one expression that is a literal list,
 #    double the brackets: `lambda x: [[5 * x]]`)
-# - local[name << value] makes an expression-local variable
-g = lambda x: [local[y << 2 * x],
+# - local[name := value] makes an expression-local variable
+g = lambda x: [local[y := 2 * x],
                y + 1]
 assert g(10) == 21
 ```
@@ -836,35 +833,35 @@ assert (my_map, double, (q, 1, 2, 3)) == (ll, 2, 4, 6)
 ```
 </details>
 
-## Installation
-
-**PyPI**
+## Install & uninstall
 
-``pip3 install unpythonic --user``
+### From PyPI
 
-or
-
-``sudo pip3 install unpythonic``
-
-**GitHub**
+```bash
+pip install unpythonic
+```
 
-Clone (or pull) from GitHub. Then,
+### From source
 
-``python3 setup.py install --user``
+Clone the repo from GitHub. Then, navigate to it in a terminal, and:
 
-or
+```bash
+pip install . --no-compile
+```
 
-``sudo python3 setup.py install``
+If you intend to use the macro layer of `unpythonic`, the `--no-compile` flag is important. It prevents an **incorrect** precompilation, without macro support, that `pip install` would otherwise do at its `bdist_wheel` step.
 
-**Uninstall**
+For most Python projects such precompilation is just fine - it's just macro-enabled projects that shouldn't be precompiled with standard tools.
 
-Uninstallation must be invoked in a folder which has no subfolder called ``unpythonic``, so that ``pip`` recognizes it as a package name (instead of a filename). Then,
+If `--no-compile` is NOT used, the precompiled bytecode cache may cause errors such as `ImportError: cannot import name 'macros' from 'mcpyrate.quotes'`, when you try to e.g. `from unpythonic.syntax import macros, let`. In-tree, it might work, but against an installed copy, it will fail. It has happened that my CI setup did not detect this kind of failure.
 
-``pip3 uninstall unpythonic``
+This is a common issue when using macro expanders in Python.
 
-or
+### Uninstall
 
-``sudo pip3 uninstall unpythonic``
+```bash
+pip uninstall unpythonic
+```
 
 
 ## Support

{unpythonic-0.15.2 → unpythonic-0.15.5}/README.md

@@ -2,7 +2,7 @@
 
 In the spirit of [toolz](https://github.com/pytoolz/toolz), we provide missing features for Python, mainly from the list processing tradition, but with some Haskellisms mixed in. We extend the language with a set of [syntactic macros](https://en.wikipedia.org/wiki/Macro_(computer_science)#Syntactic_macros). We also provide an in-process, background [REPL](https://en.wikipedia.org/wiki/Read%E2%80%93eval%E2%80%93print_loop) server for live inspection and hot-patching. The emphasis is on **clear, pythonic syntax**, **making features work together**, and **obsessive correctness**.
 
-![100% Python](https://img.shields.io/github/languages/top/Technologicat/unpythonic) ![supported language versions](https://img.shields.io/pypi/pyversions/unpythonic) ![supported implementations](https://img.shields.io/pypi/implementation/unpythonic) ![CI status](https://img.shields.io/github/workflow/status/Technologicat/unpythonic/Python%20package) [![codecov](https://codecov.io/gh/Technologicat/unpythonic/branch/master/graph/badge.svg)](https://codecov.io/gh/Technologicat/unpythonic)  
+![100% Python](https://img.shields.io/github/languages/top/Technologicat/unpythonic) ![supported language versions](https://img.shields.io/pypi/pyversions/unpythonic) ![supported implementations](https://img.shields.io/pypi/implementation/unpythonic) ![CI status](https://img.shields.io/github/actions/workflow/status/Technologicat/unpythonic/python-package.yml?branch=master) [![codecov](https://codecov.io/gh/Technologicat/unpythonic/branch/master/graph/badge.svg)](https://codecov.io/gh/Technologicat/unpythonic)  
 ![version on PyPI](https://img.shields.io/pypi/v/unpythonic) ![PyPI package format](https://img.shields.io/pypi/format/unpythonic) ![dependency status](https://img.shields.io/librariesio/github/Technologicat/unpythonic)  
 ![license: BSD](https://img.shields.io/pypi/l/unpythonic) ![open issues](https://img.shields.io/github/issues/Technologicat/unpythonic) [![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen)](http://makeapullrequest.com/)
 
@@ -15,7 +15,7 @@ None required.
 
  - [`mcpyrate`](https://github.com/Technologicat/mcpyrate) optional, to enable the syntactic macro layer, an interactive macro REPL, and some example dialects.
 
-The 0.15.x series should run on CPython 3.6, 3.7, 3.8, 3.9 and 3.10, and PyPy3 (language versions 3.6, 3.7 and 3.8); the [CI](https://en.wikipedia.org/wiki/Continuous_integration) process verifies the tests pass on those platforms. [Long-term support roadmap](https://github.com/Technologicat/unpythonic/issues/1).
+As of v0.15.3, `unpythonic` runs on CPython 3.8, 3.9 and 3.10, 3.11, 3.12, and PyPy3 (language versions 3.8, 3.9, 3.10); the [CI](https://en.wikipedia.org/wiki/Continuous_integration) process verifies the tests pass on those platforms. New Python versions are added and old ones are removed following the [Long-term support roadmap](https://github.com/Technologicat/unpythonic/issues/1).
 
 
 ### Documentation
@@ -594,13 +594,13 @@ As usual in test frameworks, the testing constructs behave somewhat like `assert
 ```python
 from unpythonic.syntax import macros, let, letseq, letrec
 
-x = let[[a << 1, b << 2] in a + b]
-y = letseq[[c << 1,  # LET SEQuential, like Scheme's let*
-            c << 2 * c,
-            c << 2 * c] in
+x = let[[a := 1, b := 2] in a + b]
+y = letseq[[c := 1,  # LET SEQuential, like Scheme's let*
+            c := 2 * c,
+            c := 2 * c] in
            c]
-z = letrec[[evenp << (lambda x: (x == 0) or oddp(x - 1)),  # LET mutually RECursive, like in Scheme
-            oddp << (lambda x: (x != 0) and evenp(x - 1))]
+z = letrec[[evenp := (lambda x: (x == 0) or oddp(x - 1)),  # LET mutually RECursive, like in Scheme
+            oddp := (lambda x: (x != 0) and evenp(x - 1))]
            in evenp(42)]
 ```
 </details>  
@@ -611,10 +611,10 @@ z = letrec[[evenp << (lambda x: (x == 0) or oddp(x - 1)),  # LET mutually RECurs
 ```python
 from unpythonic.syntax import macros, dlet
 
-# Up to Python 3.8, use `@dlet(x << 0)` instead
-@dlet[x << 0]  # let-over-lambda for Python
+# In Python 3.8, use `@dlet(x << 0)` instead; in Python 3.9, use `@dlet(x := 0)`
+@dlet[x := 0]  # let-over-lambda for Python
 def count():
-    return x << x + 1  # `name << value` rebinds in the let env
+    return x := x + 1  # `name := value` rebinds in the let env
 assert count() == 1
 assert count() == 2
 ```
@@ -626,8 +626,8 @@ assert count() == 2
 ```python
 from unpythonic.syntax import macros, do, local, delete
 
-x = do[local[a << 21],
-       local[b << 2 * a],
+x = do[local[a := 21],
+       local[b := 2 * a],
        print(b),
        delete[b],  # do[] local variables can be deleted, too
        4 * a]
@@ -751,8 +751,8 @@ assert square.__name__ == "square"
 # - brackets denote a multiple-expression lambda body
 #   (if you want to have one expression that is a literal list,
 #    double the brackets: `lambda x: [[5 * x]]`)
-# - local[name << value] makes an expression-local variable
-g = lambda x: [local[y << 2 * x],
+# - local[name := value] makes an expression-local variable
+g = lambda x: [local[y := 2 * x],
                y + 1]
 assert g(10) == 21
 ```
@@ -804,35 +804,35 @@ assert (my_map, double, (q, 1, 2, 3)) == (ll, 2, 4, 6)
 ```
 </details>
 
-## Installation
+## Install & uninstall
 
-**PyPI**
+### From PyPI
 
-``pip3 install unpythonic --user``
-
-or
-
-``sudo pip3 install unpythonic``
-
-**GitHub**
+```bash
+pip install unpythonic
+```
 
-Clone (or pull) from GitHub. Then,
+### From source
 
-``python3 setup.py install --user``
+Clone the repo from GitHub. Then, navigate to it in a terminal, and:
 
-or
+```bash
+pip install . --no-compile
+```
 
-``sudo python3 setup.py install``
+If you intend to use the macro layer of `unpythonic`, the `--no-compile` flag is important. It prevents an **incorrect** precompilation, without macro support, that `pip install` would otherwise do at its `bdist_wheel` step.
 
-**Uninstall**
+For most Python projects such precompilation is just fine - it's just macro-enabled projects that shouldn't be precompiled with standard tools.
 
-Uninstallation must be invoked in a folder which has no subfolder called ``unpythonic``, so that ``pip`` recognizes it as a package name (instead of a filename). Then,
+If `--no-compile` is NOT used, the precompiled bytecode cache may cause errors such as `ImportError: cannot import name 'macros' from 'mcpyrate.quotes'`, when you try to e.g. `from unpythonic.syntax import macros, let`. In-tree, it might work, but against an installed copy, it will fail. It has happened that my CI setup did not detect this kind of failure.
 
-``pip3 uninstall unpythonic``
+This is a common issue when using macro expanders in Python.
 
-or
+### Uninstall
 
-``sudo pip3 uninstall unpythonic``
+```bash
+pip uninstall unpythonic
+```
 
 
 ## Support

unpythonic-0.15.5/pyproject.toml

@@ -0,0 +1,76 @@
+[project]
+name = "unpythonic"
+description = "Supercharge your Python with parts of Lisp and Haskell."
+authors = [
+    { name = "Juha Jeronen", email = "juha.m.jeronen@gmail.com" },
+]
+requires-python = ">=3.8,<3.13"
+readme = "README.md"
+dynamic = []
+dependencies = [
+    "mcpyrate>=3.6.4",
+    "sympy>=1.13",
+]
+keywords = [
+    "functional-programming",
+    "language-extension",
+    "syntactic-macros",
+    "tail-call-optimization",
+    "tco",
+    "continuations",
+    "currying",
+    "lazy-evaluation",
+    "dynamic-variable",
+    "macros",
+    "lisp",
+    "scheme",
+    "racket",
+    "haskell",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: BSD License",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+version = "0.15.5"
+
+[project.license]
+text = "BSD"
+
+[project.urls]
+Repository = "https://github.com/Technologicat/unpythonic"
+
+[build-system]
+requires = [
+    "pdm-backend",
+]
+build-backend = "pdm.backend"
+
+[tool.pdm.version]
+source = "file"
+path = "unpythonic/__init__.py"
+
+[tool.pdm.build]
+includes = [
+    "unpythonic",
+]
+excludes = [
+    "**/tests",
+    "**/__pycache__",
+]
+
+[tool.mypy]
+show_error_codes = true

{unpythonic-0.15.2 → unpythonic-0.15.5}/unpythonic/__init__.py

@@ -7,7 +7,7 @@ If you have ``mcpyrate`` installed, see also ``unpythonic.syntax``
 for a trip down the rabbit hole.
 """
 
-__version__ = '0.15.2'
+__version__ = '0.15.5'
 
 from .amb import *  # noqa: F401, F403
 from .arity import *  # noqa: F401, F403
@@ -26,7 +26,7 @@ from .fup import *  # noqa: F401, F403
 from .gmemo import *  # noqa: F401, F403
 from .gtco import *  # noqa: F401, F403
 from .it import *  # noqa: F401, F403
-from .let import *  # no guarantees on evaluation order (before Python 3.6), nice syntax # noqa: F401, F403
+from .let import *  # # noqa: F401, F403
 
 # As of 0.15.0, lispylet is nowadays primarily a code generation target API for macros.
 from .lispylet import (let as ordered_let, letrec as ordered_letrec,  # noqa: F401

{unpythonic-0.15.2 → unpythonic-0.15.5}/unpythonic/arity.py

@@ -21,7 +21,7 @@ class UnknownArity(ValueError):
     """Raised when the arity of a function cannot be inspected."""
 
 # HACK: some built-ins report incorrect arities (0, 0) at least in Python 3.4
-# TODO: re-test on 3.8 and on PyPy3 (3.7), just to be sure.
+# TODO: re-test on 3.8, 3.9, 3.10, 3.11, 3.12 and on PyPy3 (3.8 and later), just to be sure.
 #
 # Full list of built-ins:
 #   https://docs.python.org/3/library/functions.html
@@ -208,7 +208,7 @@ def arities(f):
     This uses inspect.signature; note that the signature of builtin functions
     cannot be inspected. This is worked around to some extent, but e.g.
     methods of built-in classes (such as ``list``) might not be inspectable
-    (at least on CPython < 3.7).
+    (at least on old CPython < 3.7).
 
     For bound methods, ``self`` or ``cls`` does not count toward the arity,
     because these are passed implicitly by Python. Note a `@classmethod` becomes
@@ -352,10 +352,10 @@ def resolve_bindings(f, *args, **kwargs):
     This is an inspection tool, which does not actually call `f`. This is useful for memoizers
     and other similar decorators that need a canonical representation of `f`'s parameter bindings.
 
-    **NOTE**: As of v0.15.0, this is a thin wrapper on top of `inspect.Signature.bind`,
-    which was added in Python 3.5. In `unpythonic` 0.14.2 and 0.14.3, we used to have
-    our own implementation of the parameter binding algorithm (that ran also on Python 3.4),
-    but it is no longer needed, since now we support only Python 3.6 and later.
+    **NOTE**: This is a thin wrapper on top of `inspect.Signature.bind`, which was added in Python 3.5.
+    In `unpythonic` 0.14.2 and 0.14.3, we used to have our own implementation of the parameter binding
+    algorithm (that ran also on Python 3.4), but it is no longer needed, since as of v0.15.3,
+    we support only Python 3.8 and later.
 
     The only thing we do beside call `inspect.Signature.bind` is that we apply default values
     (from the definition of `f`) automatically.

{unpythonic-0.15.2 → unpythonic-0.15.5}/unpythonic/conditions.py

@@ -123,10 +123,10 @@ def signal(condition, *, cause=None, protocol=None):
     The return value is the input `condition`, canonized to an instance
     (even if originally, an exception *type* was passed to `signal`),
     with its `__cause__` and `__protocol__` attributes filled in,
-    and with a traceback attached (on Python 3.7+). For example, the
-    `error` protocol uses the return value to chain the unhandled signal
-    properly into a `ControlError` exception; as a result, the error report
-    looks like a standard exception chain, with nice-looking tracebacks.
+    and with a traceback attached. For example, the `error` protocol
+    uses the return value to chain the unhandled signal properly into
+    a `ControlError` exception; as a result, the error report looks
+    like a standard exception chain, with nice-looking tracebacks.
 
     If you want to error out on unhandled conditions, see `error`, which is
     otherwise the same as `signal`, except it raises if `signal` would have
@@ -162,9 +162,8 @@ def signal(condition, *, cause=None, protocol=None):
     You can signal any exception or warning object, both builtins and any
     custom ones.
 
-    On Python 3.7 and later, the exception object representing the signaled
-    condition is equipped with a traceback, just like a raised exception.
-    On Python 3.6 this is not possible, so the traceback is `None`.
+    The exception object representing the signaled condition is equipped
+    with a traceback, just like a raised exception.
     """
     # Since the handler is called normally, we don't unwind the call stack,
     # remaining inside the `signal()` call in the low-level code.
@@ -225,12 +224,8 @@ def _prepare_signal_instance(condition, *, cause, protocol, stacklevel):
     condition.__cause__ = cause
     condition.__protocol__ = protocol
 
-    # Embed a stack trace in the signal, like Python does for raised exceptions.
-    # This only works on Python 3.7 and later, because we need to create a traceback object in pure Python code.
-    try:
-        condition = equip_with_traceback(condition, stacklevel=stacklevel)
-    except NotImplementedError:  # pragma: no cover
-        pass  # well, we tried!
+    # Embed a stack trace in the signal, like Python does for raised exceptions. This API was added in Python 3.7.
+    condition = equip_with_traceback(condition, stacklevel=stacklevel)
 
     return condition
 

unpythonic-0.15.5/unpythonic/dialects/__init__.py

@@ -0,0 +1,17 @@
+# -*- coding: utf-8 -*-
+"""Dialects: Python the way you want it.
+
+These dialects, i.e. whole-module syntax transformations, are powered by
+`mcpyrate`'s dialect subsystem. The user manual is at:
+    https://github.com/Technologicat/mcpyrate/blob/master/doc/dialects.md
+
+We provide these dialects mainly to demonstrate how to use that subsystem
+to customize Python beyond what a local macro expander can do.
+
+For examples of how to use these particular dialects, see the unit tests.
+"""
+
+# re-exports
+from .lispython import *  # noqa: F401, F403
+from .listhell import *  # noqa: F401, F403
+from .pytkell import *  # noqa: F401, F403

unpythonic-0.15.5/unpythonic/dialects/lispython.py

@@ -0,0 +1,88 @@
+# -*- coding: utf-8 -*-
+"""Lispython: The love child of Python and Scheme.
+
+Powered by `mcpyrate` and `unpythonic`.
+"""
+
+__all__ = ["Lispython", "Lispy"]
+
+__version__ = '2.0.0'
+
+from mcpyrate.quotes import macros, q  # noqa: F401
+
+from mcpyrate.dialects import Dialect
+from mcpyrate.splicing import splice_dialect
+
+class Lispython(Dialect):
+    """**Schemers rejoice!**
+
+    Multiple musings mix in a lambda,
+    Lament no longer the lack of let.
+    Languish no longer labelless, lambda,
+    Linked lists cons and fold.
+    Tail-call into recursion divine,
+    The final value always provide.
+    """
+
+    def transform_ast(self, tree):  # tree is an ast.Module
+        with q as template:
+            __lang__ = "Lispython"  # noqa: F841, just provide it to user code.
+            from unpythonic.syntax import (macros, tco, autoreturn,  # noqa: F401, F811
+                                           multilambda, quicklambda, namedlambda, fn,
+                                           where,
+                                           let, letseq, letrec,
+                                           dlet, dletseq, dletrec,
+                                           blet, bletseq, bletrec,
+                                           local, delete, do, do0,
+                                           let_syntax, abbrev, block, expr,
+                                           cond)
+            from unpythonic import cons, car, cdr, ll, llist, nil, prod, dyn, Values  # noqa: F401, F811
+            with autoreturn, quicklambda, multilambda, namedlambda, tco:
+                __paste_here__  # noqa: F821, just a splicing marker.
+
+        # Beginning with 3.6.0, `mcpyrate` makes available the source location info
+        # of the dialect-import that imported this dialect.
+        if hasattr(self, "lineno"):  # mcpyrate 3.6.0+
+            tree.body = splice_dialect(tree.body, template, "__paste_here__",
+                                       lineno=self.lineno, col_offset=self.col_offset)
+        else:
+            tree.body = splice_dialect(tree.body, template, "__paste_here__")
+
+        return tree
+
+
+class Lispy(Dialect):
+    """**Pythonistas rejoice!**
+
+    O language like Lisp, like Python!
+    Semantic changes sensibly carry,
+    Python's primary virtue vindicate.
+    Ire me not with implicit imports,
+    Let my IDE label mistakes.
+    """
+
+    def transform_ast(self, tree):  # tree is an ast.Module
+        with q as template:
+            __lang__ = "Lispy"  # noqa: F841, just provide it to user code.
+            from unpythonic.syntax import (macros, tco, autoreturn,  # noqa: F401, F811
+                                           multilambda, quicklambda, namedlambda)
+            # The important point is none of these expect the user code to look like
+            # anything but regular Python, so IDEs won't yell about undefined names;
+            # just the semantics are slightly different.
+            #
+            # Even if the user code uses `fn[]` (to make `quicklambda` actually do anything),
+            # that macro must be explicitly imported. It works, because `splice_dialect`
+            # hoists macro-imports from the top level of the user code into the top level
+            # of the template.
+            with autoreturn, quicklambda, multilambda, namedlambda, tco:
+                __paste_here__  # noqa: F821, just a splicing marker.
+
+        # Beginning with 3.6.0, `mcpyrate` makes available the source location info
+        # of the dialect-import that imported this dialect.
+        if hasattr(self, "lineno"):  # mcpyrate 3.6.0+
+            tree.body = splice_dialect(tree.body, template, "__paste_here__",
+                                       lineno=self.lineno, col_offset=self.col_offset)
+        else:
+            tree.body = splice_dialect(tree.body, template, "__paste_here__")
+
+        return tree

unpythonic-0.15.5/unpythonic/dialects/listhell.py

@@ -0,0 +1,35 @@
+# -*- coding: utf-8 -*-
+"""Listhell: It's not Lisp, it's not Python, it's not Haskell.
+
+Powered by `mcpyrate` and `unpythonic`.
+"""
+
+__all__ = ["Listhell"]
+
+__version__ = '2.0.0'
+
+from mcpyrate.quotes import macros, q  # noqa: F401
+
+from mcpyrate.dialects import Dialect
+from mcpyrate.splicing import splice_dialect
+
+class Listhell(Dialect):
+    def transform_ast(self, tree):  # tree is an ast.Module
+        with q as template:
+            __lang__ = "Listhell"  # noqa: F841, just provide it to user code.
+            from unpythonic.syntax import macros, prefix, q, u, kw, autocurry  # noqa: F401, F811
+            # Auxiliary syntax elements for the macros
+            from unpythonic import apply  # noqa: F401
+            from unpythonic import composerc as compose  # compose from Right, Currying  # noqa: F401
+            with prefix, autocurry:
+                __paste_here__  # noqa: F821, just a splicing marker.
+
+        # Beginning with 3.6.0, `mcpyrate` makes available the source location info
+        # of the dialect-import that imported this dialect.
+        if hasattr(self, "lineno"):  # mcpyrate 3.6.0+
+            tree.body = splice_dialect(tree.body, template, "__paste_here__",
+                                       lineno=self.lineno, col_offset=self.col_offset)
+        else:
+            tree.body = splice_dialect(tree.body, template, "__paste_here__")
+
+        return tree