package ppxlib

  1. Overview
  2. Docs
Standard infrastructure for ppx rewriters

Install

dune-project
 Dependency

Authors

Maintainers

Sources

757f6c284b1fe748d5027eef3bbef924b6bbd7ce.tar.gz
sha256=89a98c95ddd0bfbac17b5a936f6811af7097be3258c482d5859b73e9de9b4552
sha512=b19306473d867252d382e58e9b697531c5edccdc9283b5eaf72f524803c2fca2a58a5e8f25bee198b00de82cf8ef805b43f7488791c3ac5beb0ffba938ded826

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

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"
OCaml

Innovation. Community. Security.