package ppx_compose

All checked builds pass
  1. Overview
  2. Docs
Inlined function composition

Install

dune-project
 Dependency

Authors

Maintainers

Sources

ppx_compose-v0.2.1.tbz
sha256=414f72a7659f2e85cf87ddcbf9981f793aa78ea3a607c35a8237e5ee305811b3
sha512=d69bfab88b4d4949bc5189724f954f33e1c2fa36d9fcf1dded351d379c241345533bf12bf493b26acbbcb6bd726674c22c934f037ec0b2820b6a5f99cfbc9ba3

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)))

Added to opam-repository:

README

Build Status

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. ppxlib
  2. dune >= "1.1"
  3. ocaml >= "4.04.2"

Dev Dependencies

None

Optional Dependencies

None

Used by

None

Conflicts

None

Build status

Results of building ppx_compose with each compiler on check.ci.ocaml.org, run of against opam-repository 7cdc698. All results for this package.

Each result links to its build log. To keep crawlers from overloading the site, build logs require a GitHub sign-in (see ocurrent/opam-health-check). On your first log, GitHub asks you to “Authorize opam-health-check”, the OCurrent app that runs these checks; it sees only your public profile, not your repositories. The sign-in lasts 30 days.

Version OCaml 4.11 OCaml 4.14 OCaml 5.2 OCaml 5.4 OCaml 5.5
0.2.1 (this version) good good good good good
  • good Package successfully built
  • partial One of the dependencies failed to build
  • bad Package failed to build
  • n/a Package is not available in this environment
  • internal Internal failure