An implementation of the pretty printing algorithm described by Derek C. Oppen.
We also provide an API similar to
ruby/prettyprint, which we call
Wadler, in reference to Philip Wadler's paper, A prettier
printer,
the basis for prettyprint. This can be really helpful if you decide to
transition from ruby/prettyprint to this gem.
Wadler is implemented on top of Oppen, and it provides more options than
ruby/prettyprint, notably:
- Consistent and inconsistent breaking.
- Explicit breaking, which is achievable in
ruby/prettyprintwith some monkeypatching.
Caution
This is still under development.
Warning
Lands when the APIs are stable.
Wadler calls Oppen under the hood, so it's not a separate implementation,
and it's not calling ruby's prettyprint.
Both implementations have their use cases:
- Oppen gives more control over tokens sent to the printer.
- Wadler gives a more "functional" API, which is far nicer to work with.
That being said, both APIs in this gem can achieve the same results, especially on consistent and inconsistent breaking.
- We took liberty to rename functions to make the API more modern and closer to what we expect when writing Ruby code. All correspondences with the algorithm as described in Oppen's paper are noted in the comments of classes and methods.
- We do not raise exceptions when we overflow the margin. The only exceptions that we raise indicate a bug in the implementation. Please report them.
Oppen's algorithm and ruby/prettyprint do not have the same starting positions
for a group's indentation. That's why you need to pay particular attention to
calls for nest; you might want to decrease them by 1 if you care about keeping
the same behavior.
This is what we do in our test suite to verify the correspondence of the Wadler
API and the ruby/prettyprint. We decided to shift the burden to the user because
we think that the deicision taken by ruby/prettyprint does not suit us.