package ppxlib

  1. Overview
  2. Docs
module Located : sig ... end
include sig ... end
val loc : Location.t
val pcl_constr : Ppxlib_ast__.Import.Longident.t Location.loc -> Migrate_parsetree.Ast_407.Parsetree.core_type list -> Migrate_parsetree.Ast_407.Parsetree.class_expr
val pcty_constr : Ppxlib_ast__.Import.Longident.t Location.loc -> Migrate_parsetree.Ast_407.Parsetree.core_type list -> Migrate_parsetree.Ast_407.Parsetree.class_type
val ptyp_constr : Ppxlib_ast__.Import.Longident.t Location.loc -> Migrate_parsetree.Ast_407.Parsetree.core_type list -> Migrate_parsetree.Ast_407.Parsetree.core_type
val ptyp_class : Ppxlib_ast__.Import.Longident.t Location.loc -> Migrate_parsetree.Ast_407.Parsetree.core_type list -> Migrate_parsetree.Ast_407.Parsetree.core_type
val ptyp_package : (Ppxlib_ast__.Import.Longident.t Location.loc * (Ppxlib_ast__.Import.Longident.t Location.loc * Migrate_parsetree.Ast_407.Parsetree.core_type) list) -> Migrate_parsetree.Ast_407.Parsetree.core_type
val pexp_ident : Ppxlib_ast__.Import.Longident.t Location.loc -> Migrate_parsetree.Ast_407.Parsetree.expression
val pexp_construct : Ppxlib_ast__.Import.Longident.t Location.loc -> Migrate_parsetree.Ast_407.Parsetree.expression option -> Migrate_parsetree.Ast_407.Parsetree.expression
val pexp_field : Migrate_parsetree.Ast_407.Parsetree.expression -> Ppxlib_ast__.Import.Longident.t Location.loc -> Migrate_parsetree.Ast_407.Parsetree.expression
val pexp_new : Ppxlib_ast__.Import.Longident.t Location.loc -> Migrate_parsetree.Ast_407.Parsetree.expression
val location : start:Stdlib.Lexing.position -> end_:Stdlib.Lexing.position -> ghost:bool -> Warnings.loc
val pmod_ident : Ppxlib_ast__.Import.Longident.t Location.loc -> Migrate_parsetree.Ast_407.Parsetree.module_expr
val pmty_ident : Ppxlib_ast__.Import.Longident.t Location.loc -> Migrate_parsetree.Ast_407.Parsetree.module_type
val pmty_alias : Ppxlib_ast__.Import.Longident.t Location.loc -> Migrate_parsetree.Ast_407.Parsetree.module_type
val module_type_declaration : name:string Location.loc -> type_:Migrate_parsetree.Ast_407.Parsetree.module_type option -> Migrate_parsetree.Ast_407.Parsetree.module_type_declaration
val open_description : lid:Ppxlib_ast__.Import.Longident.t Location.loc -> override:Migrate_parsetree.Ast_407.Asttypes.override_flag -> Migrate_parsetree.Ast_407.Parsetree.open_description
val ppat_var : string Location.loc -> Migrate_parsetree.Ast_407.Parsetree.pattern
val ppat_construct : Ppxlib_ast__.Import.Longident.t Location.loc -> Migrate_parsetree.Ast_407.Parsetree.pattern option -> Migrate_parsetree.Ast_407.Parsetree.pattern
val ppat_type : Ppxlib_ast__.Import.Longident.t Location.loc -> Migrate_parsetree.Ast_407.Parsetree.pattern
val ppat_unpack : string Location.loc -> Migrate_parsetree.Ast_407.Parsetree.pattern
val ppat_open : Ppxlib_ast__.Import.Longident.t Location.loc -> Migrate_parsetree.Ast_407.Parsetree.pattern -> Migrate_parsetree.Ast_407.Parsetree.pattern
val position : fname:string -> lnum:int -> bol:int -> cnum:int -> Stdlib.Lexing.position
val value_description : name:string Location.loc -> type_:Migrate_parsetree.Ast_407.Parsetree.core_type -> prim:string list -> Migrate_parsetree.Ast_407.Parsetree.value_description
val eint : Ppxlib__.Import.Int.t -> Migrate_parsetree.Ast_407.Parsetree.expression
val echar : Ppxlib__.Import.Char.t -> Migrate_parsetree.Ast_407.Parsetree.expression
val estring : Ppxlib__.Import.String.t -> Migrate_parsetree.Ast_407.Parsetree.expression
val efloat : Ppxlib__.Import.String.t -> Migrate_parsetree.Ast_407.Parsetree.expression
val eint32 : Ppxlib__.Import.Int32.t -> Migrate_parsetree.Ast_407.Parsetree.expression
val eint64 : Ppxlib__.Import.Int64.t -> Migrate_parsetree.Ast_407.Parsetree.expression
val enativeint : Ppxlib__.Import.Nativeint.t -> Migrate_parsetree.Ast_407.Parsetree.expression
val ebool : Ppxlib__.Import.Bool.t -> Migrate_parsetree.Ast_407.Parsetree.expression
val pint : Ppxlib__.Import.Int.t -> Migrate_parsetree.Ast_407.Parsetree.pattern
val pchar : Ppxlib__.Import.Char.t -> Migrate_parsetree.Ast_407.Parsetree.pattern
val pstring : Ppxlib__.Import.String.t -> Migrate_parsetree.Ast_407.Parsetree.pattern
val pfloat : Ppxlib__.Import.String.t -> Migrate_parsetree.Ast_407.Parsetree.pattern
val pint32 : Ppxlib__.Import.Int32.t -> Migrate_parsetree.Ast_407.Parsetree.pattern
val pint64 : Ppxlib__.Import.Int64.t -> Migrate_parsetree.Ast_407.Parsetree.pattern
val pnativeint : Ppxlib__.Import.Nativeint.t -> Migrate_parsetree.Ast_407.Parsetree.pattern
val pbool : Ppxlib__.Import.Bool.t -> Migrate_parsetree.Ast_407.Parsetree.pattern
val evar : Ppxlib__.Import.String.t -> Migrate_parsetree.Ast_407.Parsetree.expression

evar id produces a Pexp_ident _ expression, it parses its input so you can pass any dot-separated identifier, for instance: evar ~loc "Foo.bar".

val pvar : Ppxlib__.Import.String.t -> Migrate_parsetree.Ast_407.Parsetree.pattern
val ppat_tuple_opt : Migrate_parsetree.Ast_407.Parsetree.pattern Ppxlib__.Import.List.t -> Migrate_parsetree.Ast_407.Parsetree.pattern Ppxlib__.Import.Option.t
val pexp_tuple_opt : Migrate_parsetree.Ast_407.Parsetree.expression Ppxlib__.Import.List.t -> Migrate_parsetree.Ast_407.Parsetree.expression Ppxlib__.Import.Option.t

pstr_value_list ~loc rf vbs = pstr_value ~loc rf vbs if vbs <> [], [] otherwise.

  • deprecated [since 2016-10] use Nonrecursive on the P(str|sig)_type instead
val unapplied_type_constr_conv : Longident.t Loc.t -> f:(Ppxlib__.Import.String.t -> Ppxlib__.Import.String.t) -> Migrate_parsetree.Ast_407.Parsetree.expression

unapplied_type_constr_conv is the standard way to map identifiers to conversion fonctions, for preprocessor that creates values that follow the structure of types. More precisely, path_conv path (sprintf "sexp_of_%s") is:

  • sexp_of_t if path is "t"
  • A.B.sexp_of_foo if path is "A.B.foo"
  • A.B.sexp_of_f__foo (module A1) (module A2) if path is "A.B.F(A1)(A2).foo" type_constr_conv also applies it to a list of expression, which both prevents the compiler from allocating useless closures, and almost always what is needed, since type constructors are always applied.
val type_constr_conv : Longident.t Loc.t -> f:(Ppxlib__.Import.String.t -> Ppxlib__.Import.String.t) -> Migrate_parsetree.Ast_407.Parsetree.expression Ppxlib__.Import.List.t -> Migrate_parsetree.Ast_407.Parsetree.expression

Tries to simplify fun v1 v2 .. -> f v1 v2 .. into f. Only works when f is a path, not an arbitrary expression as that would change the meaning of the code. This can be used either for cleaning up the generated code, or to reduce allocation if f is a local variable (the compiler won't optimize the allocation of the closure).

Eta-reduction can change the types/behavior in some corner cases that are unlikely to show up in generated code:

  • if f has optional arguments, eta-expanding f can drop them
  • because labels commute, it can change the type of an expression: $ let f ~x y = x + y let f2 = fun x -> add x;; val f : x:int -> int -> int = <fun> val f2 : int -> x:int -> int = <fun> In fact, if f does side effects before receiving all its arguments, and if the eta-expansion is partially applied, eta-reducing could change behavior.

eta_reduce_if_possible_and_nonrec is meant for the case where the resulting expression is going to be bound in a potentially recursive let-binding, where we have to keep the eta-expansion when rec_flag is Recursive to avoid a compile error.

OCaml

Innovation. Community. Security.