package ppxlib

  1. Overview
  2. Docs
Standard infrastructure for ppx rewriters

Install 

dune-project
 Dependency

github.com Readme Changelog MIT License Edit opam file Versions (24)

Authors

  1. J
    Jane Street Group, LLC <opensource@janestreet.com>

Maintainers

  1. O
    opensource@janestreet.com

Sources

ppxlib-0.37.0.tbz
sha256=2e223837e7cecc3bc84a432432c0a72f4e1d5be9165c9c33772f156db85db0b3
sha512=78c62c6de7a641b950de9b4b744841c8823918c545046693e291077adfcd069a812094c11d8d51f792c0b5f340307d38f452ff0a92520df63ed17a3ca9922e2e

Description

Ppxlib is the standard infrastructure for ppx rewriters and other programs that manipulate the in-memory representation of OCaml programs, a.k.a the "Parsetree".

It also comes bundled with two ppx rewriters that are commonly used to write tools that manipulate and/or generate Parsetree values; ppxlib.metaquot which allows to construct Parsetree values using the OCaml syntax directly and ppxlib.traverse which provides various ways of automatically traversing values of a given type, in particular allowing to inject a complex structured value into generated code.

Published: 14 Oct 2025

README

Ppxlib - Meta-programming for OCaml

ocaml-ci status trunk-build-status AppVeyor status

Ppxlib documentation

Overview

Ppxlib is the standard library for ppx rewriters and other programs that manipulate the in-memory representation of OCaml programs, a.k.a. the "Parsetree".

It also comes bundled with two ppx rewriters that are commonly used to write tools that manipulate and/or generate Parsetree values: ppxlib.metaquot, which allows constructing Parsetree values using the OCaml syntax directly, and ppxlib.traverse, which provides various ways of automatically traversing values of a given type, in particular allowing to inject a complex structured value into generated code.

For more information about ppxlib and how to use it, please consult the documentation.

What is the relation between ppxlib and other ppx libraries?

The ppx world has a long and storied history, and if you look around, you may find other projects that offer functionalities similar to ppxlib. The following blog post gives a good overview of the various libraries that have been developed over time. At this point, ppxlib is considered the de facto library for writing ppx rewriters.

History of the project

This repository was created by merging several older smaller projects that were developed at Jane Street. See the history for more details.

Dependencies (6)

  1. stdlib-shims
  2. sexplib0 >= "v0.12"
  3. ppx_derivers >= "1.0"
  4. ocaml-compiler-libs >= "v0.11.0"
  5. ocaml >= "4.08.0" & < "5.5.0"
  6. dune >= "3.8"

Dev Dependencies (6)

  1. odoc with-doc
  2. ocamlformat with-dev-setup & = "0.26.2"
  3. cinaps with-test & >= "v0.12.1"
  4. re with-test & >= "1.9.0"
  5. ocamlfind with-test
  6. sexplib0 with-test & >= "v0.15"

  1. arrayjit != "0.5.2"
  2. awsm-codegen
  3. bam-ppx >= "0.4"
  4. base_quickcheck >= "v0.17.1"
  5. bistro >= "0.6.0"
  6. bonsai >= "v0.16.0"
  7. bytestring
  8. clangml >= "4.7.0"
  9. cmdlang-to-base
  10. comby < "1.3.0"
  11. commons
  12. crs
  13. diff
  14. diffast-misc = "0.3.5.1"
  15. dream-html >= "3.11.2"
  16. dune >= "3.17.2"
  17. dunolint
  18. dunolint-lib < "0.0.20251006"
  19. dunolint-lib-base
  20. ego
  21. eliom >= "8.9.0"
  22. elpi >= "3.3.1"
  23. embedded_ocaml_templates < "0.3.1" | >= "0.7"
  24. extunix >= "0.4.4"
  25. frama-c >= "32.0~beta"
  26. fsml
  27. fstar >= "2025.06.20"
  28. GT = "0.5.1"
  29. gen_js_api < "1.0.8" | >= "1.1.1"
  30. genprint = "0.3"
  31. goblint >= "2.5.0"
  32. hack_parallel >= "1.0.1"
  33. hardcaml >= "v0.14.1" & != "v0.17.0"
  34. html_of_jsx >= "0.0.2"
  35. http_async
  36. js_of_ocaml >= "3.8.0"
  37. js_of_ocaml-compiler >= "6.1.0"
  38. js_of_ocaml-lwt >= "3.10.0" & < "6.1.0"
  39. js_of_ocaml-ocamlbuild >= "3.10.0" & < "5.0"
  40. js_of_ocaml-ppx >= "6.1.0"
  41. js_of_ocaml-ppx_deriving_json >= "3.7.1"
  42. js_of_ocaml-toplevel >= "3.10.0"
  43. js_of_ocaml-tyxml >= "3.10.0" & < "6.1.0"
  44. lablqml >= "0.7"
  45. lascar >= "0.7.0"
  46. learn-ocaml
  47. learn-ocaml-client
  48. lens >= "1.2.5"
  49. logs-ppx
  50. lwt_ppx >= "5.9.2"
  51. MlFront_Cli >= "2.1.4~prerel2" & < "2.3.1"
  52. MlFront_Config
  53. MlFront_Manip
  54. melange >= "6.0.1-51"
  55. melange-json >= "1.2.0"
  56. melange-json-native
  57. merlin >= "4.7-412"
  58. metaquot >= "0.5.0"
  59. mlt_parser = "v0.13.0" | >= "v0.14.1"
  60. mlx
  61. neural_nets_lib != "0.5.2"
  62. noCanren >= "0.3.0~alpha1"
  63. node_of_ocaml
  64. nuscr >= "2.0.0"
  65. OCanren-ppx >= "0.3.0"
  66. obus >= "1.2.5"
  67. ocaml-monadic >= "0.5"
  68. ocamlmerlin-mlx
  69. ocf_ppx >= "1.0.0"
  70. ocsigen-i18n >= "4.0.0"
  71. octez-internal-libs
  72. ojs_base_ppx
  73. ometrics = "0.2.0"
  74. ortac-core
  75. ortac-qcheck-stm
  76. ortac-wrapper
  77. pacomb >= "1.4.3"
  78. pancake
  79. pgocaml_ppx >= "4.3.0"
  80. pla >= "2.0"
  81. polymarket >= "0.2.0"
  82. ppx-owl-opt
  83. ppx_accessor >= "v0.14.3"
  84. ppx_assert >= "v0.13.0"
  85. ppx_bap
  86. ppx_base >= "v0.13.0"
  87. ppx_bench >= "v0.17.1"
  88. ppx_bin_prot >= "v0.17.1"
  89. ppx_bitstring >= "5.0.0"
  90. ppx_blob >= "0.7.2"
  91. ppx_catch
  92. ppx_cold
  93. ppx_compare >= "v0.13.0"
  94. ppx_compose >= "0.2.1"
  95. ppx_const >= "2.0.1"
  96. ppx_conv_func >= "v0.13.0"
  97. ppx_counters
  98. ppx_css
  99. ppx_cstruct >= "6.0.0"
  100. ppx_cstubs >= "0.6.1" & < "0.7.0"
  101. ppx_csv_conv >= "v0.13.0"
  102. ppx_custom_printf >= "v0.14.1"
  103. ppx_decimal
  104. ppx_defer >= "0.5.0"
  105. ppx_demo
  106. ppx_derive_at_runtime != "v0.17.0"
  107. ppx_deriving >= "6.1.0"
  108. ppx_deriving_cad
  109. ppx_deriving_decoders < "0.2"
  110. ppx_deriving_encoding >= "0.4.2"
  111. ppx_deriving_ezjsonm >= "0.4.1"
  112. ppx_deriving_hardcaml >= "v0.13.0"
  113. ppx_deriving_hash >= "0.1.3"
  114. ppx_deriving_jsonschema
  115. ppx_deriving_jsont
  116. ppx_deriving_madcast >= "0.2"
  117. ppx_deriving_popper
  118. ppx_deriving_protobuf >= "3.0.0"
  119. ppx_deriving_qcheck
  120. ppx_deriving_rpc >= "10.0.0"
  121. ppx_deriving_scad
  122. ppx_deriving_variant_string
  123. ppx_deriving_yaml >= "0.4.1"
  124. ppx_deriving_yojson >= "3.10.0"
  125. ppx_diff >= "v0.17.1"
  126. ppx_disable_unused_warnings
  127. ppx_dream_eml
  128. ppx_embed_file
  129. ppx_enumerate >= "v0.13.0"
  130. ppx_expect = "v0.16.2" | >= "v0.17.3"
  131. ppx_expect_nobase
  132. ppx_factory = "0.1.0" | >= "0.2.0"
  133. ppx_fail >= "v0.13.0"
  134. ppx_fields_conv >= "v0.14.2"
  135. ppx_fixed_literal
  136. ppx_format
  137. ppx_fun
  138. ppx_gen_rec >= "2.0.0"
  139. ppx_getenv >= "2.1"
  140. ppx_globalize >= "v0.17.2"
  141. ppx_hardcaml
  142. ppx_hash >= "v0.13.0"
  143. ppx_here >= "v0.13.0"
  144. ppx_ignore_instrumentation
  145. ppx_import < "1.8.0" | >= "1.11.0"
  146. ppx_inline_test >= "v0.17.1"
  147. ppx_interact >= "0.2.0"
  148. ppx_irmin >= "3.0.0"
  149. ppx_jane >= "v0.13.0"
  150. ppx_js_style >= "v0.17.1"
  151. ppx_jsobject_conv = "0.8.0" | >= "0.21.1"
  152. ppx_jsonaf_conv >= "v0.15.1" & != "v0.17.0"
  153. ppx_let >= "v0.17.1"
  154. ppx_log
  155. ppx_lun >= "0.0.2"
  156. ppx_map
  157. ppx_matches >= "0.1.0"
  158. ppx_mica
  159. ppx_minidebug != "2.2.0"
  160. ppx_module_timer >= "v0.13.0"
  161. ppx_monad
  162. ppx_monoid >= "0.3.3"
  163. ppx_mysql >= "1.1.3"
  164. ppx_open
  165. ppx_optcomp >= "v0.17.1"
  166. ppx_optint
  167. ppx_optional >= "v0.13.0"
  168. ppx_parser >= "0.2.1"
  169. ppx_partial
  170. ppx_pattern_bind >= "v0.13.1" & != "v0.17.0"
  171. ppx_pipebang >= "v0.13.0"
  172. ppx_protocol_conv >= "5.2.3"
  173. ppx_pyformat
  174. ppx_python >= "v0.15.0"
  175. ppx_quick_test >= "v0.17.1"
  176. ppx_repr >= "0.8.0"
  177. ppx_seq
  178. ppx_sexp_conv >= "v0.17.1"
  179. ppx_sexp_message >= "v0.14.1"
  180. ppx_sexp_value >= "v0.13.0"
  181. ppx_show >= "0.2.0"
  182. ppx_stable >= "v0.17.1"
  183. ppx_stable_witness
  184. ppx_string >= "v0.14.1"
  185. ppx_string_conv
  186. ppx_string_interpolation
  187. ppx_subliner
  188. ppx_system
  189. ppx_ts
  190. ppx_tydi >= "v0.17.1"
  191. ppx_type_directed_value
  192. ppx_typed_fields != "v0.17.0"
  193. ppx_typerep_conv >= "v0.17.1"
  194. ppx_units
  195. ppx_unreachable
  196. ppx_update
  197. ppx_variants_conv >= "v0.17.1"
  198. ppx_viewpattern >= "0.1.1"
  199. ppx_xml_conv >= "v0.13.0"
  200. ppx_yojson_conv >= "v0.15.1" & != "v0.17.0"
  201. ppxlib-tools >= "0.37.0"
  202. ppxlib_jane >= "v0.17.3"
  203. qcow = "0.11.0"
  204. rdf_ppx
  205. reason >= "3.16.0"
  206. reason-react-ppx >= "0.13.0" & < "0.14.1"
  207. refl >= "0.4.1"
  208. repr-fuzz >= "0.8.0"
  209. res_tailwindcss
  210. sedlex >= "3.4"
  211. serde_derive
  212. server-reason-react
  213. speed
  214. spin >= "0.8.0"
  215. stdint-literals
  216. stk_ppx
  217. streamable != "v0.17.0"
  218. styled-ppx
  219. togglelog
  220. toplevel_expect_test >= "v0.14.1"
  221. tyxml-jsx >= "4.5.0"
  222. tyxml-syntax >= "4.5.0"
  223. visitors = "20210608" | >= "20251010"
  224. vlt >= "0.2.5"
  225. volgo < "0.0.21"
  226. volgo-base
  227. volgo-git-backend < "0.0.21"
  228. volgo-git-eio < "0.0.21"
  229. volgo-git-unix < "0.0.21"
  230. volgo-hg-backend < "0.0.21"
  231. volgo-hg-eio < "0.0.21"
  232. volgo-hg-unix < "0.0.21"
  233. volgo-vcs < "0.0.21"
  234. wasm_of_ocaml-compiler
  235. wtr < "3.0.0"
  236. wtr-ppx
  237. xtmpl_ppx >= "1.1.0"

Conflicts (3)

  1. ocaml-variants = "5.1.0~alpha1+options"
  2. ocaml-base-compiler = "5.1.0~alpha1"
  3. ocaml-migrate-parsetree < "2.0.0"