package ppx_compose

  1. Overview
  2. Docs
Inlined Function Composition

Install

Dune Dependency

Authors

Maintainers

Sources

ppx_compose-0.0.4.tbz
sha256=22e46520a7ff8a846e32e64324b3d65a3f7ea29d27d1260ae7423e9b45f609e2
md5=d597c0b1cf29402bbd29d821792c867e

Description

ppx_compose is a simple syntax extension which rewrites code containing function compositions into composition-free code, effectively inlining the composition operators. The following two operators are supported

let (%) g f x = g (f x)
let (%>) f g x = g (f x)

Corresponding definitions are not provided, so partial applications of (%) and (%>) will be undefined unless you provide the definitions.

The following rewrites are done:

  • A composition occurring to the left of an application is reduced by applying each term of the composition from right to left to the argument, ignoring associative variations.

  • A composition which is not the left side of an application is first turned into one by η-expansion, then the above rule applies.

  • Any partially applied composition operators are passed though unchanged.

E.g.

h % g % f ==> (fun x -> h (f (g x)))
h % (g % f) ==> (fun x -> h (f (g x)))
(g % f) (h % h) ==> g (f (fun x -> h (h x)))

Published: 18 Dec 2017

README

README.md

ppx_compose - Inlined Function Composition

ppx_compose is a simple syntax extension which rewrites code containing function compositions into composition-free code, effectively inlining the composition operators. The following two operators are supported

let (%) g f x = g (f x)
let (%>) f g x = g (f x)

Corresponding definitions are not provided, so partial applications of (%) and (%>) will be undefined unless you provide the definitions.

The following rewrites are done:

  • A composition occurring to the left of an application is reduced by applying each term of the composition from right to left to the argument, ignoring associative variations.

  • A composition which is not the left side of an application is first turned into one by η-expansion, then the above rule applies.

  • Any partially applied composition operators are passed though unchanged.

E.g.

h % g % f ==> (fun x -> h (f (g x)))
h % (g % f) ==> (fun x -> h (f (g x)))
(g % f) (h % h) ==> g (f (fun x -> h (h x)))

Is It Needed?

Recent flambda-enabled compilers can inline the following alternative definitions of the composition operators [1]:

let (%) g f = (); fun x -> g (f x)
let (%>) f g = (); fun x -> g (f x)

so this syntax extension will likely be retired at some point.

Dependencies (3)

  1. ocaml-migrate-parsetree < "2.0.0"
  2. jbuilder >= "1.0+beta7"
  3. ocaml >= "4.02.3"

Dev Dependencies

None

Used by

None

Conflicts

None

OCaml

Innovation. Community. Security.