unpythonic 0.15.3__tar.gz → 1.0.0__tar.gz

{unpythonic-0.15.3 → unpythonic-1.0.0}/PKG-INFO

@@ -1,13 +1,10 @@
 Metadata-Version: 2.1
 Name: unpythonic
-Version: 0.15.3
+Version: 1.0.0
 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
 
@@ -38,6 +35,8 @@ In the spirit of [toolz](https://github.com/pytoolz/toolz), we provide missing f
 ![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/)
 
+We use [semantic versioning](https://semver.org/).
+
 *Some hypertext features of this README, such as local links to detailed documentation, and expandable example highlights, are not supported when viewed on PyPI; [view on GitHub](https://github.com/Technologicat/unpythonic) to have those work properly.*
 
 
@@ -836,21 +835,85 @@ 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.
+
+### Development mode (for developing `unpythonic` itself)
+
+Starting with v0.15.5, `unpythonic` uses [PDM](https://pdm-project.org/en/latest/) to manage its dependencies. This allows easy installation of a development copy into an isolated venv (virtual environment), allowing you to break things without breaking anything else on your system (including apps and libraries that use an installed copy of `unpythonic`).
+
+#### Install PDM in your Python environment
+
+To develop `unpythonic`, if your Python environment does not have PDM, you will need to install it first:
+
+```bash
+python -m pip install pdm
+```
+
+Don't worry; it won't break `pip`, `poetry`, or other similar tools.
+
+We will also need a Python for PDM venvs. This Python is independent of the Python that PDM itself runs on. It is the version of Python you would like to use for developing `unpythonic`.
+
+For example, we can make Python 3.10 available with the command:
+
+```bash
+pdm python install 3.10
+```
+
+Specifying just a version number defaults to CPython (the usual Python implementation). If you want PyPy instead, you can use e.g. `pypy@3.10`.
+
+#### Install the isolated venv
+
+Now, we will auto-create the development venv, and install `unpythonic`'s dependencies into it. In a terminal that sees your Python environment, navigate to the `unpythonic` folder, and issue the command:
+
+```bash
+pdm install
+```
+
+This creates the development venv into the `.venv` hidden subfolder of the `unpythonic` folder.
+
+If you are a seasoned pythonista, note that there is no `requirements.txt`; the dependency list lives in `pyproject.toml`.
+
+#### Upgrade dependencies (later)
+
+To upgrade dependencies to latest available versions compatible with the specifications in `pyproject.toml`:
+
+```bash
+pdm update
+```
+
+#### Develop
+
+To activate the development venv, in a terminal that sees your Python environment, navigate to the `unpythonic` folder, and issue the command:
+
+```bash
+$(pdm venv activate)
+```
+
+Note the Bash exec syntax `$(...)`; the command `pdm venv activate` just prints the actual internal activation command.
+
+### Uninstall
 
 ```bash
 pip uninstall unpythonic

unpythonic-0.15.3/unpythonic.egg-info/PKG-INFO → unpythonic-1.0.0/README.md

@@ -1,35 +1,3 @@
-Metadata-Version: 2.1
-Name: unpythonic
-Version: 0.15.3
-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
-Classifier: Development Status :: 4 - Beta
-Classifier: Environment :: Console
-Classifier: Intended Audience :: Developers
-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.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.8,<3.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**.
@@ -38,6 +6,8 @@ In the spirit of [toolz](https://github.com/pytoolz/toolz), we provide missing f
 ![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/)
 
+We use [semantic versioning](https://semver.org/).
+
 *Some hypertext features of this README, such as local links to detailed documentation, and expandable example highlights, are not supported when viewed on PyPI; [view on GitHub](https://github.com/Technologicat/unpythonic) to have those work properly.*
 
 
@@ -836,21 +806,85 @@ 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
+```
+
+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.
+
+### Development mode (for developing `unpythonic` itself)
+
+Starting with v0.15.5, `unpythonic` uses [PDM](https://pdm-project.org/en/latest/) to manage its dependencies. This allows easy installation of a development copy into an isolated venv (virtual environment), allowing you to break things without breaking anything else on your system (including apps and libraries that use an installed copy of `unpythonic`).
+
+#### Install PDM in your Python environment
+
+To develop `unpythonic`, if your Python environment does not have PDM, you will need to install it first:
+
+```bash
+python -m pip install pdm
+```
+
+Don't worry; it won't break `pip`, `poetry`, or other similar tools.
+
+We will also need a Python for PDM venvs. This Python is independent of the Python that PDM itself runs on. It is the version of Python you would like to use for developing `unpythonic`.
+
+For example, we can make Python 3.10 available with the command:
+
+```bash
+pdm python install 3.10
+```
+
+Specifying just a version number defaults to CPython (the usual Python implementation). If you want PyPy instead, you can use e.g. `pypy@3.10`.
+
+#### Install the isolated venv
+
+Now, we will auto-create the development venv, and install `unpythonic`'s dependencies into it. In a terminal that sees your Python environment, navigate to the `unpythonic` folder, and issue the command:
+
+```bash
+pdm install
+```
+
+This creates the development venv into the `.venv` hidden subfolder of the `unpythonic` folder.
+
+If you are a seasoned pythonista, note that there is no `requirements.txt`; the dependency list lives in `pyproject.toml`.
+
+#### Upgrade dependencies (later)
+
+To upgrade dependencies to latest available versions compatible with the specifications in `pyproject.toml`:
+
+```bash
+pdm update
+```
+
+#### Develop
+
+To activate the development venv, in a terminal that sees your Python environment, navigate to the `unpythonic` folder, and issue the command:
+
+```bash
+$(pdm venv activate)
 ```
 
-To uninstall:
+Note the Bash exec syntax `$(...)`; the command `pdm venv activate` just prints the actual internal activation command.
+
+### Uninstall
 
 ```bash
 pip uninstall unpythonic

unpythonic-1.0.0/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 = "1.0.0"
+
+[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-1.0.0}/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__ = '1.0.0'
 
 from .amb import *  # noqa: F401, F403
 from .arity import *  # noqa: F401, F403

unpythonic-1.0.0/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-1.0.0/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-1.0.0/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-1.0.0/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