Python pattern matching like functional languages.
OTHER License
Python, I love you. But I'd like you to change. It's not you, it's me. Really.
See, you don't have pattern matching. But, that's not the root of it. Macros
are the root of it. You don't have macros but that's OK. Right now, I want
pattern matching. I know you offer me if
/elif
/else
statements but I
need more. I'm going to abuse your functions. Guido, et al, I hope you can
forgive me. This will only hurt a little.
Python Pattern Matching
_ is an Apache2 licensed Python module for pattern matching
_ like that found in functional programming languages. Most projects
that address Python pattern matching focus on syntax and simple cases. Operator
overloading is often used to change the semantics of operators to support
pattern matching. In other cases, function decorators are used to implement
multiple dispatch, sometimes known as function overloading. Each of these
syntaxes, operators, and decorators, is really more of a detail in the
application of pattern matching.
A lot of people have tried to make this work before. Somehow it didn't take. I should probably call this yet-another-python-pattern-matching-module but "yappmm" doesn't roll off the tongue. Other people have tried overloading operators and changing codecs. This module started as a codec hack but those are hard because they need an ecosystem of emacs-modes, vim-modes and the like to really be convenient.
Python Pattern Matching focuses instead on the semantics of pattern matching in Python. The dynamic duck-typing behavior in Python is distinct from the tagged unions found in functional programming languages. Rather than trying to emulate the behavior of functional pattern matching, this project attempts to implement pattern matching that looks and feels native to Python. In doing so the traditional function call is used as syntax. There are no import hooks, no codecs, no AST transforms.
.. todo::
Python match
function example.
Finally, pythonic pattern matching! If you've experienced the feature before in "functional" languages like Erlang, Haskell, Clojure, F#, OCaml, etc. then you can guess at the semantics.
.. todo::
Show the same code without patternmatching
.
.. todo::
Installing Python Pattern Matching
_ is simple with pip <http://www.pip-installer.org/>
_::
$ pip install patternmatching
You can access documentation in the interpreter with Python's built-in help
function. The help
works on modules, classes, and functions in pattern matching
_.
.. code-block:: python
>>> from patternmatching import match, bind, bound, like
>>> help(match) # doctest: +SKIP
Python Pattern Matching Tutorial
_Python Pattern Matching Reference
_Python Pattern Matching Search
_Python Pattern Matching Index
_.. _Python Pattern Matching Tutorial
: http://www.grantjenks.com/docs/patternmatching/tutorial.html
.. _Python Pattern Matching Reference
: http://www.grantjenks.com/docs/patternmatching/reference.html
.. _Python Pattern Matching Search
: http://www.grantjenks.com/docs/patternmatching/search.html
.. _Python Pattern Matching Index
: http://www.grantjenks.com/docs/patternmatching/genindex.html
Python Pattern Matching
_Python Pattern Matching at PyPI
_Python Pattern Matching at GitHub
_Python Pattern Matching Issue Tracker
_.. _Python Pattern Matching
: http://www.grantjenks.com/docs/patternmatching/
.. _Python Pattern Matching at PyPI
: https://pypi.python.org/pypi/patternmatching/
.. _Python Pattern Matching at GitHub
: https://github.com/grantjenks/python-pattern-matching
.. _Python Pattern Matching Issue Tracker
: https://github.com/grantjenks/python-pattern-matching/issues
Copyright 2015-2021, Grant Jenks
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
.. _pattern matching
: http://www.grantjenks.com/docs/patternmatching/