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

a6fadbd212f3cd7d5d8dcfefc46c884f710fedc0.tar.gz
sha256=25e81f2085ad19688f7056c6df49ca48b3df4cea8304ba3be2550e172d59bfec
sha512=cfdaa06fd32d206f72de05a5289d33ec85fa6bdf7c5be7c85874a16d9e154cdc080465453b60fe7f6c01589eb92e4296b18067413ac2d8dec47b9539f55e301e

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: 09 Mar 2026

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.6.0"
  6. dune >= "3.8"

Dev Dependencies (6)

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