unpythonic 0.15.3__tar.gz → 0.15.5__tar.gz

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

@@ -1,13 +1,10 @@
 Metadata-Version: 2.1
 Name: unpythonic
-Version: 0.15.3
+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
@@ -24,11 +21,11 @@ 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.8,<3.13
+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
 
@@ -836,21 +833,31 @@ assert (my_map, double, (q, 1, 2, 3)) == (ll, 2, 4, 6)
 ```
 </details>
 
-## Installation
+## Install & uninstall
 
-**PyPI**
+### From PyPI
 
-``pip install unpythonic``
+```bash
+pip install unpythonic
+```
 
-**GitHub**
+### From source
 
 Clone the repo from GitHub. Then, navigate to it in a terminal, and:
 
 ```bash
-pip install .
+pip install . --no-compile
 ```
 
-To uninstall:
+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.
+
+For most Python projects such precompilation is just fine - it's just macro-enabled projects that shouldn't be precompiled with standard tools.
+
+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.
+
+This is a common issue when using macro expanders in Python.
+
+### Uninstall
 
 ```bash
 pip uninstall unpythonic

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

@@ -804,21 +804,31 @@ assert (my_map, double, (q, 1, 2, 3)) == (ll, 2, 4, 6)
 ```
 </details>
 
-## Installation
+## Install & uninstall
 
-**PyPI**
+### From PyPI
 
-``pip install unpythonic``
+```bash
+pip install unpythonic
+```
 
-**GitHub**
+### From source
 
 Clone the repo from GitHub. Then, navigate to it in a terminal, and:
 
 ```bash
-pip install .
+pip install . --no-compile
 ```
 
-To uninstall:
+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.
+
+For most Python projects such precompilation is just fine - it's just macro-enabled projects that shouldn't be precompiled with standard tools.
+
+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.
+
+This is a common issue when using macro expanders in Python.
+
+### Uninstall
 
 ```bash
 pip uninstall unpythonic

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.3 → 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.3'
+__version__ = '0.15.5'
 
 from .amb import *  # noqa: F401, F403
 from .arity import *  # noqa: F401, F403

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

unpythonic-0.15.5/unpythonic/dialects/pytkell.py

@@ -0,0 +1,51 @@
+# -*- coding: utf-8 -*-
+"""Pytkell: Because it's good to have a kell.
+
+Powered by `mcpyrate` and `unpythonic`.
+"""
+
+__all__ = ["Pytkell"]
+
+__version__ = '2.0.0'
+
+from mcpyrate.quotes import macros, q  # noqa: F401
+
+from mcpyrate.dialects import Dialect
+from mcpyrate.splicing import splice_dialect
+
+class Pytkell(Dialect):
+    def transform_ast(self, tree):  # tree is an ast.Module
+        with q as template:
+            __lang__ = "Pytkell"  # noqa: F841, just provide it to user code.
+            from unpythonic.syntax import (macros, lazy, lazyrec, lazify, autocurry,  # noqa: F401, F811
+                                           where,
+                                           let, letseq, letrec,
+                                           dlet, dletseq, dletrec,
+                                           blet, bletseq, bletrec,
+                                           local, delete, do, do0,
+                                           cond, forall)
+            # Auxiliary syntax elements for the macros.
+            from unpythonic.syntax import insist, deny  # noqa: F401
+            # Functions that have a haskelly feel to them.
+            from unpythonic import (foldl, foldr, scanl, scanr,  # noqa: F401
+                                    s, imathify, gmathify, frozendict,
+                                    memoize, fupdate, fup,
+                                    gmemoize, imemoize, fimemoize,
+                                    islice, take, drop, split_at, first, second, nth, last,
+                                    flip, rotate)
+            from unpythonic import composerc as compose  # compose from Right, Currying (Haskell's . operator)  # noqa: F401
+            # This is a bit lispy, but we're not going out of our way to provide
+            # a haskelly surface syntax for these.
+            from unpythonic import cons, car, cdr, ll, llist, nil  # noqa: F401
+            with lazify, 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