Skip to content

Releases: Technologicat/unpythonic

Version 0.15.1

28 Jan 11:27
Compare
Choose a tag to compare

0.15.1 (28 January 2022) - New Year's edition:

New:

  • Python 3.10 support. Running on Python 3.10 requires mcpyrate 3.6.0.
  • New module unpythonic.timeutil, with utilities for converting a number of seconds into human-understood formats (seconds_to_human, format_human_time), and a simple running-average ETAEstimator that takes advantage of these. As usual, these are available at the top level of unpythonic.
  • Add function unpythonic.syntax.get_cc, the less antisocial little sister of call_cc from an alternate timeline, to make programming with continuations slightly more convenient. (Alternate timelines happen a lot when one uses multi-shot continuations.) The two work together. See docstring.
  • Tag continuation closures (generated by the with continuations macro), for introspection.
    • To detect at run time whether a given object is a continuation function, use the function unpythonic.syntax.iscontinuation.
    • This is purely an introspection feature; unpythonic itself does not use this information. For why you might want to query this, see get_cc, particularly the examples in unit tests.
    • The information is stored as an attribute on the function object; keep this in mind if you intend to wrap the continuation function with another function. (Strictly, this is the correct behavior, since a custom wrapper is not a continuation function generated by the with continuations macro.)

Fixed:

  • The test framework unpythonic.test.fixtures is now correctly installed when installing unpythonic. See #81.
  • The subpackage for live REPL functionality, unpythonic.net, is now correctly installed when installing unpythonic.
  • Fix a broken import that prevented the REPL server unpythonic.net.server from starting. This was broken by the move of async_raise into unpythonic.excutil in 0.15.0.
  • unpythonic.syntax.prefix: Fix wrong macro name in error message of unpythonic.syntax.prefix.u. Document in the docstring that the magic operators q, u, and kw (of the prefix macro) cannot be renamed by as-importing.
  • Preserve the source location info of the dialect-import statement in the example dialects in unpythonic.dialects. In the output, the lines of expanded source code that originate in a particular dialect template are marked as coming from the unexpanded source line that contains the corresponding dialect-import.
    • If you want to see the line numbers before and after dialect expansion, use the StepExpansion dialect from mcpyrate.debug.
    • This fix requires mcpyrate 3.6.0 or later. The code will run also on earlier versions of mcpyrate; then, just like before, it will look as if all lines that originate in any dialect template came from the beginning of the user source code.

Version 0.15.0

22 Jun 08:18
Compare
Choose a tag to compare

0.15.0 (22 June 2021) - "We say 'howdy' around these parts" edition:

Beside introducing dialects (a.k.a. whole-module code transforms), this edition concentrates on upgrading our dependencies, namely the macro expander, and the Python language itself, to ensure unpythonic keeps working for the next few years. This introduces some breaking changes, so we have also taken the opportunity to apply any such that were previously scheduled.

We have sneaked in some upgrades for other subsystems, too. Particularly curry, the multiple dispatch system (@generic), and the integration between these two have been improved significantly.

IMPORTANT:

If you still need unpythonic for Python 3.4 or 3.5, use version 0.14.3, which is the final version of unpythonic that supports those language versions.

The same applies if you need the macro parts of unpythonic (i.e. import anything from unpythonic.syntax) in your own project that uses MacroPy. Version 0.14.3 of unpythonic works up to Python 3.7.

New:

  • Dialects! New module unpythonic.dialects, providing some example dialects that demonstrate what can be done with a dialects system (i.e. full-module code transformer) together with a kitchen-sink language extension macro package such as unpythonic.

    • These dialects have been moved from the now-obsolete pydialect project and ported to use mcpyrate.
  • Improved robustness: several auxiliary syntactic constructs now detect at macro expansion time if they appear outside any valid lexical context, and raise SyntaxError (with a descriptive message) if so.

    • The full list is:
      • call_cc[], for with continuations
      • it, for aif[]
      • local[]/delete[], for do[]
      • q/u/kw, for with prefix
      • where, for let[body, where(k0=v0, ...)] (also for letseq, letrec, let_syntax, abbrev)
      • with expr/with block, for with let_syntax/with abbrev
    • Previously these constructs could only raise an error at run time, and not all of them could detect the error even then.
  • Syntactic consistency: allow env-assignment notation and brackets to declare bindings in the let family of macros. The preferred syntaxes for the let macro are now:

    let[x << 42, y << 9001][...]         # lispy expr
    let[[x << 42, y << 9001] in ...]     # haskelly let-in
    let[..., where[x << 42, y << 9001]]  # haskelly let-where

    If there is just one binding, these become:

    let[x << 42][...]
    let[[x << 42] in ...]
    let[..., where[x << 42]]

    Similarly for letseq, letrec, and the decorator versions; and for the expr forms of let_syntax, abbrev. The reason for preferring this notation is that it is consistent with both unpythonic's env-assignments (let bindings live in an env) and the use of brackets to denote macro invocations.

    To ease backwards compatibility, we still accept the syntax used up to v0.14.3, too.

    Also, from symmetry and usability viewpoints, if a mix of brackets and parentheses are used, it hardly makes sense to require some specific mix - so this has been extended so that the choice of delimiter doesn't matter. All the following are also accepted, with the meaning exactly the same as above:

    let[[x, 42], [y, 9001]][...]  # best visual consistency
    let[(x, 42), (y, 9001)][...]
    let([x, 42], [y, 9001])[...]
    let((x, 42), (y, 9001))[...]  # like up to v0.14.3
    let[[[x, 42], [y, 9001]] in ...]  # best visual consistency
    let[[(x, 42), (y, 9001)] in ...]
    let[([x, 42], [y, 9001]) in ...]
    let[((x, 42), (y, 9001)) in ...]  # like up to v0.14.3
    let[(x << 42, y << 9001) in ...]
    let[..., where[[x, 42], [y, 9001]]]  # best visual consistency
    let[..., where[(x, 42), (y, 9001)]]
    let[..., where([x, 42], [y, 9001])]
    let[..., where((x, 42), (y, 9001))]  # like up to v0.14.3
    let[..., where(x << 42, y << 9001)]

    For a single binding, these are also accepted:

    let[x, 42][...]
    let(x, 42)[...]  # like up to v0.14.3
    let[[x, 42] in ...]
    let[(x, 42) in ...]  # like up to v0.14.3
    let[(x << 42) in ...]
    let[..., where[x, 42]]
    let[..., where(x, 42)]  # like up to v0.14.3
    let[..., where(x << 42)]

    These alternate syntaxes will be supported at least as long as we accept parentheses to pass macro arguments; but in new code, please use the preferred syntaxes.

  • Miscellaneous.

    • with namedlambda now understands the walrus operator, too. In the construct f := lambda ...: ..., the lambda will get the name f. (Python 3.8 and later.)
    • with namedlambda now auto-names lambdas that don't have a name candidate using their source location info, if present. This makes it easy to see in a stack trace where some particular lambda was defined.
    • Multiple-dispatch system unpythonic.dispatch:
      • Use consistent terminology:
        • The function that supports multiple call signatures is a generic function.
        • Its individual implementations are multimethods.
      • Add decorator @augment: add a multimethod to a generic function defined elsewhere.
      • Add function isgeneric to detect whether a callable has been declared @generic.
      • Add function methods: display a list of multimethods of a generic function.
      • It is now possible to dispatch on a homogeneous type of contents collected by a **kwargs parameter.
      • curry now supports @generic functions. This feature is experimental. Semantics may still change.
      • The utilities arities, required_kwargs, and optional_kwargs now support @generic functions. This feature is experimental. Semantics may still change.
    • curry now errors out immediately on argument type mismatch.
    • Add partial, a type-checking wrapper for functools.partial, that errors out immediately on argument type mismatch.
    • Add unpythonic.excutil.reraise_in (expr form), unpythonic.excutil.reraise (block form): conveniently remap library exception types to application exception types. Idea from Alexis King (2016): Four months with Haskell.
    • Add variants of the above for the conditions-and-restarts system: unpythonic.conditions.resignal_in, unpythonic.conditions.resignal. The new signal is sent using the same error-handling protocol as the original signal, so that e.g. an error remains an error even if re-signaling changes its type.
    • Add resolve_bindings_partial, useful for analyzing partial application.
    • Add triangular, to generate the triangular numbers (1, 3, 6, 10, ...).
    • Add partition_int_triangular to answer a timeless question concerning stackable plushies.
    • Add partition_int_custom to answer unanticipated similar questions.
    • All documentation files now have a quick navigation section to skip to another part of the docs. (For all except the README, it's at the top.)
    • Python 3.8 and 3.9 support added.

Non-breaking changes:

  • Changes to how some macros expand.

    • Some macros, notably letseq, do0, and lazyrec, now expand into hygienic macro captures of other macros. The continuations macro also outputs a hygienically captured aif when transforming an or expression that occurs in tail position.

      • This allows mcpyrate.debug.step_expansion to show the intermediate result, as well as brings the implementation closer to the natural explanation of how these macros are defined. (Zen of Python: if the implementation is easy to explain, it might be a good idea.)
      • The implicit do (extra bracket syntax) also expands as a hygienically captured do, but e.g. in let[] it will then expand immediately (due to let's inside-out expansion order) before control returns to the macro stepper. If you want to see the implicit do[] invocation, use the "detailed" mode of the stepper, which shows individual macro invocations even when expanding inside-out: step_expansion["detailed"][...], with step_expansion["detailed"]:.
    • The do[] and do0[] macros now expand outside-in. The main differences from a user perspective are:

      • Any source code captures (such as those performed by test[]) show the expanded output of do and do0, because that's what they receive. (For tests, you may want to use the macro with expand_testing_macros_first, which see.)
      • mcpyrate.debug.step_expansion is able to show the intermediate result after the do or do0 has expanded, but before anything else has been done to the tree.
  • Miscellaneous.

    • Resolve issue #61: curry now supports kwargs properly.
      • We now analyze parameter bindings like Python itself does, so it should no longer matter whether arguments are passed by position or by name.
      • Positional passthrough works as before. Named passthrough added.
      • Any remaining arguments (that cannot be accepted by the initial call) are passed through to a callable intermediate result (if any), and then outward on the curry context stack as a Values. Since curry in this role is essentially a function-composition utility, the receiving curried function instance unpacks the Values into args and kwargs.
      • If any extra arguments (positional or named) remain w...
Read more

Version 0.14.3

13 Apr 15:07
Compare
Choose a tag to compare

0.14.3 (13 April 2021) - Testing and all that jazz edition:

New:

  • unpythonic.test.fixtures, a lightweight testing framework for macro-enabled Python code.
    • Context managers session, testset, and catch_signals. Various helper functions, such as returns_normally (for use in a test[]).
    • Testing macros, similar to the builtin assert, but with the magic of conditions and restarts: even if a test fails or errors out, further tests continue running.
      • test[expr], test[expr, message], test_raises[exctype, expr], test_raises[exctype, expr, message], test_signals[exctype, expr], test_signals[exctype, expr, message].
      • To help diagnose test failures with minimum fuss, the test[...] macro provides an optional marker the[expr] to capture the values of interesting subexpressions inside a test[...], for display in the test failure message (along with the corresponding source code).
        • Often even that is not needed; by default, if no the[] are present, test[] captures the value of the leftmost term when the test is a comparison (common use case).
      • Helper macros fail[message], error[message] and warn[message] for producing unconditional failures, errors or warnings.
  • callsite_filename: return the filename from which this function is being called. Useful as a building block for debug utilities and similar.
  • equip_with_traceback: take a manually created exception instance, equip it with a traceback. Requires Python 3.7 or later.
  • subset: test whether an iterable is a subset of another. Convenience function.
  • allsame: test whether all elements of an iterable are the same. Sometimes useful in writing testing code.
  • safeissubclass: like issubclass, but if cls is not a class, swallow the TypeError and return False. Sometimes useful when dealing with lots of code that needs to check types dynamically.

Non-breaking changes:

  • s now has a convenience mode for generating cyclic infinite sequences.
  • m is now imathify and mg is now gmathify, for descriptiveness, and for consistency with naming other abstractions in unpythonic. The old names will remain working in v0.14.x, and will be removed in v0.15.0.
  • @generic and @typed can now decorate instance methods, class methods and static methods. This makes those methods (OOP sense) have methods (generic function sense). Get it?
    • self and cls parameters do not participate in dispatching, and need no type annotation.
    • Beside appearing as the first positional-or-keyword parameter, the self-like parameter must be named one of self, this, cls, or klass to be detected by the ignore mechanism. This limitation is due to implementation reasons; while a class body is being evaluated, the context needed to distinguish a method (OOP sense) from a regular function is not yet present.
    • OOP inheritance support: when @generic is installed on an OOP method (instance method, or @classmethod), then at call time, classes are tried in MRO order. All generic-function methods of the OOP method defined in the class currently being looked up are tested for matches first, before moving on to the next class in the MRO. (This has subtle consequences, related to in which class in the hierarchy the various generic-function methods for a particular OOP method are defined.)
    • To work with OOP inheritance, @generic must be the outermost decorator (except @classmethod or @staticmethod, which are essentially compiler annotations).
    • However, when installed on a @staticmethod, the @generic decorator does not support MRO lookup, because that would make no sense. See discussions on interaction between @staticmethod and super in Python: [1] [2].
  • To ease installation, relax version requirement of the optional MacroPy dependency to the latest released on PyPI, 1.1.0b2.
    • Once MacroPy updates, we'll upgrade; 1.1.0b2 is missing some small features we would like to use (particularly the .transform attribute of macros, which allows calling the underlying syntax transformer function).
  • Conditions: when an unhandled error or cerror occurs, the original unhandled error is now available in the __cause__ attribute of the ControlError exception that is raised in this situation.
  • Conditions: on Python 3.7+, signal now equips the condition instance with a traceback, for consistency with raise.
  • Document named-arg bug in curry in the docstring. See #61. Fixing this needs a better partial, so for now it's a known issue.
  • All of unpythonic itself is now tested using the new testing framework for macro-enabled code, unpythonic.test.fixtures. Hence, developing unpythonic now requires MacroPy. For using unpythonic, MacroPy remains strictly optional, as it will at least for the foreseeable future.

Breaking changes:

  • Experimental: @generic no longer takes a master definition. Methods (in the generic function sense) are registered directly with @generic; the first method definition implicitly creates the generic function.

Fixed:

  • Compatibility with Pythons 3.4, 3.5 and 3.7, thanks to a newly set up CI workflow for automated multi-version testing. Also test coverage (statement coverage) is measured by the workflow.
  • Significantly improved test coverage, from 85% to 92%. See #68. Many small bugs fixed.
  • PyPy3 support: fixed crash in querying the arity of builtin functions. See #67.
  • Condition system:
    • with handlers catches also derived types, e.g. a handler for Exception now catches a signaled ValueError.
    • signal(SomeExceptionClass) now implicitly creates an instance with no arguments, just like raise does.
    • Conditions can now inherit from BaseException, not only from Exception.
  • mogrify now skips nil, actually making it useful for processing ll linked lists. Although this is technically a breaking change, the original behavior was broken, so it should not affect any existing code.

Version 0.14.2.1

07 Aug 13:42
Compare
Choose a tag to compare

0.14.2.1 just fixes that I forgot the include the final release date for 0.14.2 in CHANGELOG.md. Real release below.

0.14.2 7 August 2020 - "Greenspun" edition:

With the arrival of conditions and restarts, and a REPL server, I think it is now fair to say unpythonic contains an ad-hoc, informally-specified, slow implementation of half of Common Lisp. To avoid bug-ridden, we have tests - but it's not entirely impossible for some to have slipped through. If you find one, please file an issue in the tracker.

This release welcomes the first external contribution! Thanks to @aisha-w for the much improved organization and presentation of the documentation!

Language version:

We target Python 3.6. Now we test on both CPython and PyPy3.

Rumors of the demise of Python 3.4 support are exaggerated. While the testing of unpythonic has moved to 3.6, there neither is nor will there be any active effort to intentionally drop 3.4 support until unpythonic reaches 0.15.0.

That is, support for 3.4 will likely be dropped with the arrival of the next batch of breaking changes. The current plan is visible in the roadmap as the 0.15.0 milestone.

If you're still stuck on 3.4 and find something in the latest unpythonic 0.14.x doesn't work there, please file an issue. (Support for 0.14.x will end once 0.15 is released, but not before.)

New:

  • Improve organization and presentation of documentation (#28).
  • Macro README: Emacs syntax highlighting for unpythonic.syntax and MacroPy.
  • Resumable exceptions, a.k.a. conditions and restarts. One of the famous killer features of Common Lisp. Drawing inspiration from python-cl-conditions by Alexander Artemenko. See with restarts (Common Lisp equivalent: RESTART-CASE), with handlers (HANDLER-BIND), signal (SIGNAL), invoke (INVOKE-RESTART). Many convenience forms are also exported; see unpythonic.conditions for a full list. For an introduction to conditions, see Chapter 19 in Practical Common Lisp by Peter Seibel.
  • REPL server and client. Interactively hot-patch your running Python program! Another of the famous killer features of Common Lisp. The server is daemonic, listening for connections in a background thread. (Don't worry, it's strictly opt-in.) See unpythonic.net.server and unpythonic.net.client.
  • Batteries for network programming:
    • unpythonic.net.msg: A simplistic message protocol for sending message data over a stream-based transport (such as TCP).
    • unpythonic.net.ptyproxy: Proxy between a Linux PTY and a network socket. Useful for serving terminal utilities over the network. This doesn't use pty.spawn, so Python libraries that expect to run in a terminal are also welcome. See unpythonic.net.server for a usage example.
    • unpythonic.net.util: Miscellaneous small utilities.
  • fix: Break infinite recursion cycles (for pure functions). Drawing inspiration from original implementations by Matthew Might and Per Vognsen.
  • More batteries for itertools:
    • fixpoint: Arithmetic fixed-point finder (not to be confused with fix).
    • within: Yield items from iterable until successive iterates are close enough (useful with Cauchy sequences).
    • chunked: Split an iterable into constant-length chunks.
    • lastn: Yield the last n items from an iterable.
    • pad: Extend iterable to length n with a fillvalue.
    • interleave: For example, interleave(['a', 'b', 'c'], ['+', '*']) --> ['a', '+', 'b', '*', 'c']. Interleave items from several iterables, slightly differently from zip.
    • find: From an iterable, get the first item matching a given predicate. Convenience function.
    • powerset: Compute the power set (set of all subsets) of an iterable. Works also for infinite iterables.
    • CountingIterator: Count how many items have been yielded, as a side effect.
    • slurp: Extract all items from a queue.Queue (until it is empty) into a list, returning that list.
    • map: Curry-friendly thin wrapper for the builtin map, making it mandatory to specify at least one iterable.
    • running_minmax, minmax: Extract both min and max in one pass over an iterable. The running_ variant is a scan and returns a generator; the just-give-me-the-final-result variant is a fold.
  • ulp: Given a float x, return the value of the unit in the last place (the "least significant bit"). At x = 1.0, this is the machine epsilon, by definition of the machine epsilon.
  • partition_int: split a small positive integer, in all possible ways, into smaller integers that sum to it.
  • dyn now supports rebinding, using the assignment syntax dyn.x = 42. To mass-update atomically, see dyn.update.
  • box now supports .set(newvalue) to rebind (returns the new value as a convenience), and unbox(b) to extract contents. Syntactic sugar for rebinding is b << newvalue (where b is a box).
  • ThreadLocalBox: A box with thread-local contents. It also holds a default object, which is used when a particular thread has not placed any object into the box.
  • Some: An immutable box. Useful for optional fields; tell apart the presence of a None value (Some(None)) from the absence of a value (None).
  • Shim: A shim holds a box or a ThreadLocalBox, and redirects attribute accesses to whatever object is currently in the box. The point is that the object in the box can be replaced with a different one later, while keeping the attribute proxy in place. One use case is to redirect standard output only in particular threads.
  • islice now supports negative start and stop. (Caution: no negative step; and it must consume the whole iterable to determine where it ends, if at all.)
  • async_raise: Inject KeyboardInterrupt into an arbitrary thread. (CPython only.)
  • resolve_bindings: Get the parameter bindings a given callable would establish if it was called with the given args and kwargs. This is mainly of interest for implementing memoizers, since this allows them to see (e.g.) f(1) and f(a=1) as the same thing for def f(a): pass.
  • Singleton: a base class for singletons that interacts properly with pickle. The pattern is slightly pythonified; instead of silently returning the same instance, attempting to invoke the constructor while an instance already exists raises TypeError. This solution separates concerns better; see #22.
  • sym: a lispy symbol type; or in plain English: a lightweight, human-readable, process-wide unique marker, that can be quickly compared to another such marker by object identity (is). These named symbols are interned. Supplying the same name to the constructor results in receiving the same object instance. Symbols survive a pickle roundtrip.
  • gensym: a utility to create a new, unique uninterned symbol. Like the pythonic idiom nonce = object(), but with a human-readable label, and with pickle support. Object identity of gensyms is determined by an UUID, generated when the symbol is created. Gensyms also survive a pickle roundtrip.

Experimental features:

Each experimental feature is a provisional proof-of-concept, usually lacking battle-testing and polish. Details may still change in a backwards-incompatible way, or the whole feature may still be removed. Do not depend on it in production!

  • Multiple dispatch. The generic decorator makes a generic function with multiple dispatch. Arity and type annotations determine which method of the generic function a specific call of the function is dispatched to.
    • This essentially allows replacing the if/elif dynamic type checking boilerplate of polymorphic functions with type annotations on the function parameters, with support for features from the typing stdlib module.
    • Inspired by the multi-methods of CLOS (the Common Lisp Object System), and the generic functions of Julia.
  • typed: The little sister of the generic decorator. Restrict allowed argument types to one specific combination only.
  • isoftype: The big sister of isinstance. Type check a value against a type specification at run time, with support for many (but not all) features from the typing module. This is the machinery that powers @generic and @typed.
    • If you need a run-time type checker for serious general use, consider the typeguard library.

Non-breaking changes:

  • setescape/escape have been renamed catch/throw, to match the standard terminology in the Lisp family. The old nonstandard names are now deprecated, and will be removed in 0.15.0.
  • The parameters of raisef are now more pythonic, just the object exc and an optional keyword-only cause. Old-style parameters are now deprecated, and will be removed in 0.15.0. See #30.
  • runpipe and getvalue are now both replaced by a single unified name exitpipe. This is just a...
Read more

Version 0.14.1

09 Jun 08:50
Compare
Choose a tag to compare

Retrofuturistic edition:

Language version:

  • Support Python 3.6. First released in 2016, supported until 2021, most distros should have it by now.
  • This will be the final release that supports Python 3.4; upstream support for 3.4 ended in March 2019.

New:

  • Popper, a pop-while iterator.
  • window, a length-n sliding window iterator for general iterables.
  • autoref[] can now be nested.
  • dbg[] now supports also an expression variant, customizable by lexically assigning dbgprint_expr. See the README on macros for details.

Bugfixes:

  • Fix crash when SymPy or mpmath are not installed.
  • mogrify is now part of the public API, as it should have been all along.
  • Docs: Mention the mg function in the README.

Non-breaking changes:

  • Future-proof namelambda for Python 3.8.
  • Docs: dbg[] is now listed as a convenience feature in the README.

Version 0.14.0

18 Mar 08:29
Compare
Choose a tag to compare

"Dotting the t's and crossing the i's" edition:

Bugfixes:

  • setup.py: macros are not zip safe, because ZipImporter fails to return source code for the module and MacroPy needs that.
  • fix splicing in the do[] macro; ExpandedDoView should now work correctly
  • fix lambda handling in the lazify macro
  • fix dict_items handling in mogrify (fixes the use of the curry macro with code using frozendict)

New:

  • roview: a read-only view into a sequence. Behaves mostly the same as view, but has no __setitem__ or reverse.
  • mg: a decorator to mathify a gfunc, so that it will m() the generator instances it makes.
  • The do[] macro now supports delete[name] to delete a local variable previously created in the same do-expression using local[name << value].
  • envify block macro, to make formal parameters live in an unpythonic env.
  • autoref block macro, to implicitly reference attributes of an object (for reading only).

Breaking changes:

  • The macropy3 bootstrapper now takes the -m option; macropy3 -m somemod, like python3 -m somemod. The alternative is to specify a filename positionally; macropy3 somescript.py, like python3 somescript.py. In either case, the bootstrapper will import the module in a special mode that pretends its __name__ == '__main__', to allow using the pythonic conditional main idiom also in macro-enabled code.
  • The constructor of the writable view now checks that the input is not read-only (roview, or a Sequence that is not also a MutableSequence) before allowing creation of the writable view.
  • env now checks finalization status also when deleting attrs (a finalized env cannot add or delete bindings)

Non-breaking improvements:

  • env now provides also the collections.abc.MutableMapping API.
  • The tco macro now skips nested continuations blocks (to allow Lispython in Pydialect to support continuations).
  • setup.py now installs the macropy3 bootstrapper.

Version 0.13.1

01 Mar 08:49
Compare
Choose a tag to compare

"Maybe a slice?" edition

New:

  • view: writable, sliceable view into a sequence. Use like view(lst)[::2]. Can be nested (i.e. sliced again). Any access (read or write) goes through to the original underlying sequence. Can assign a scalar to a slice à la NumPy. Stores slices, not indices; works also if the length of the underlying sequence suddenly changes.
  • islice: slice syntax support for itertools.islice, use like islice(myiterable)[100:10:2] or islice(myiterable)[42]. (It's essentially a curried function, where the second step uses the subscript syntax instead of the function call syntax.)
  • prod: like sum, but computes the product. A missing battery.
  • iindex: like list.index, but for iterables. A missing battery. (Makes sense mostly for memoized input.)
  • inn(x, iterable): contains-check (x in iterable) for monotonic infinite iterables, with automatic termination.
  • getattrrec, setattrrec (recursive): access underlying data in an onion of wrappers.
  • primes and fibonacci generators, mainly intended for testing and usage examples.
  • SequenceView and MutableSequenceView abstract base classes; view is a MutableSequenceView.

Breaking changes:

  • The fup[] utility macro to functionally update a sequence is gone and has been replaced by the fup utility function, with slightly changed syntax to accommodate. New syntax is like fup(lst)[3:17:2] << values. (This is a two-step curry utilizing the subscript and lshift operators.)
  • ShadowedSequence, and hence also fupdate, now raise the semantically more appropriate IndexError (instead of the previous ValueError) if the replacement sequence is too short.
  • namelambda now returns a modified copy; the original function object is no longer mutated.

Non-breaking improvements:

  • ShadowedSequence now supports slicing (read-only), equality comparison, str and repr. Out-of-range access to a single item emits a meaningful error, like in list.
  • env and dyn now provide the collections.abc.Mapping API.
  • cons and friends: BinaryTreeIterator and JackOfAllTradesIterator now support arbitarily deep cons structures.

Version 0.13.0

25 Feb 10:45
Compare
Choose a tag to compare

"I'll evaluate this later" edition:

New:

  • lazify macro: call-by-need for Python (a.k.a. lazy functions, like in Haskell)
  • frozendict: an immutable dictionary
  • mogrify: in-place map for mutable containers
  • timer: a context manager for performance testing
  • s: create lazy mathematical sequences. For example, s(1, ...), s(1, 2, ...), s(1, 2, 4, ...) and s(1, 2, ...)**2 are now valid Python. Regular function, no macros.
  • m: endow any iterable with infix math support. (But be aware that after that, applying an operation meant for general iterables drops the math support; to restore it, m(result) again.)
  • The unpythonic.llist module now provides JackOfAllTradesIterator that understands both trees and linked lists (with some compromises).
  • nb macro: a silly ultralight math notebook.

Breaking changes:

  • dyn: the asdict and items methods now return a live view.
  • The mutable single-item container Box and its data attribute value have been renamed to box and x, respectively.
  • namedlambda macro: Env-assignments are now processed lexically, just like regular assignments. Added support for let-bindings.
  • curry macro: The special mode for uninspectables is now enabled lexically within the with curry block. Also, manual uses of the curry decorator (on both def and lambda) are now detected, and in such cases the macro now skips adding the curry decorator.

Non-breaking improvements:

  • namelambda now supports renaming any function object, and also multiple times.
  • The single-item special binding syntax is now supported also by the bindings block of the dlet, dletseq, dletrec, blet, bletseq and bletrec macros.

Version 0.12.0

09 Jan 14:40
Compare
Choose a tag to compare

"Metamagical engineering" edition:

What does "metamagical" mean? To me, it means "going one level beyond magic". There is an ambiguity here: on the one hand, the word might mean "ultramagical" - magic of a higher order - yet on the other hand, the magical thing about magic is that what lies behind it is always nonmagical. That's metamagic for you!
--Douglas R. Hofstadter, On Self-Referential Sentences (essay, 1981)

New:

  • Alternative, haskelly let syntax let[((x, 2), (y, 3)) in x + y] and let[x + y, where((x, 2), (y, 3))]
    • Supported by all let forms: let, letseq, letrec, let_syntax, abbrev
  • When making just one binding, can now omit outer parentheses in let: let(x, 1)[...], let[(x, 1) in ...], let[..., where(x, 1)]
  • unpythonic.misc.Box: the classic rackety single-item mutable container
  • Many small improvements to documentation

Breaking changes:

  • New, perhaps more natural call_cc[] syntax for continuations, replaces earlier with bind[...]
    • Conditional continuation capture with call_cc[f() if p else None]
    • cc parameter now added implicitly, no need to declare explicitly unless actually needed (reduces visual noise in client code)
  • Local variables in a do are now declared using macro-expr syntax local[x << 42], looks more macropythonic
  • Silly (lambda) suffix removed from names of named lambdas (to detect them in client code, it's enough that isinstance(f, types.LambdaType))

Version 0.11.1

22 Nov 15:02
Compare
Choose a tag to compare

"Cleaning up, vol. 2" edition:

Enhancements:

  • Create a proper decorator registry for the syntax machinery.
    • Can now register priorities for custom decorators to tell the syntax system about their correct ordering (for sort_lambda_decorators, suggest_decorator_index).
    • Register priorities for (some of) unpythonic's own decorators using this new system, replacing the old hardcoded decorator registry.
    • Now lives in unpythonic.regutil; used only by the syntax subsystem, but doesn't require MacroPy just to start up.
  • Try to determine correct insertion index for trampolined and curry decorators in macros that insert them to decorator_list of FunctionDef nodes (using any already applied known decorators as placement hints, like a programmer would).
  • namedlambda: recognize also decorated lambdas, and calls to curry where the last argument is a lambda (useful for looped_over et al.).

Breaking change:

  • Remove the special jump target SELF.
    • Was always a hack; no longer needed now that v0.11.0 introduced the general solution: the withself function that allows a lambda to refer to itself anywhere, not just in a jump.
    • Now the whole thing is easier to explain, so likely a better idea (ZoP §17, 18).