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. dune >= "3.17.2"
  15. dunolint
  16. dunolint-lib
  17. ego
  18. eliom >= "8.9.0"
  19. embedded_ocaml_templates < "0.3.1" | >= "0.7"
  20. extunix >= "0.4.4"
  21. fsml
  22. fstar >= "2025.06.20"
  23. GT = "0.5.1"
  24. gen_js_api < "1.0.8" | >= "1.1.1"
  25. genprint = "0.3"
  26. goblint >= "2.5.0"
  27. hack_parallel >= "1.0.1"
  28. hardcaml >= "v0.14.1" & < "v0.17.0"
  29. html_of_jsx >= "0.0.2"
  30. http_async
  31. js_of_ocaml >= "3.8.0"
  32. js_of_ocaml-compiler >= "6.1.0"
  33. js_of_ocaml-lwt >= "3.10.0" & < "6.1.0"
  34. js_of_ocaml-ocamlbuild >= "3.10.0" & < "5.0"
  35. js_of_ocaml-ppx >= "6.1.0"
  36. js_of_ocaml-ppx_deriving_json >= "3.7.1"
  37. js_of_ocaml-toplevel >= "3.10.0"
  38. js_of_ocaml-tyxml >= "3.10.0" & < "6.1.0"
  39. lablqml >= "0.7"
  40. lascar >= "0.7.0"
  41. learn-ocaml
  42. learn-ocaml-client
  43. lens >= "1.2.5"
  44. logs-ppx
  45. MlFront_Cli >= "2.1.4~prerel2" & < "2.3.1"
  46. MlFront_Config
  47. MlFront_Manip
  48. melange-json >= "1.2.0"
  49. melange-json-native
  50. merlin >= "4.7-412"
  51. metaquot >= "0.5.0"
  52. mlt_parser = "v0.13.0" | >= "v0.14.1"
  53. mlx
  54. neural_nets_lib != "0.5.2"
  55. noCanren >= "0.3.0~alpha1"
  56. node_of_ocaml
  57. nuscr >= "2.0.0"
  58. OCanren-ppx >= "0.3.0"
  59. obus >= "1.2.5"
  60. ocaml-monadic >= "0.5"
  61. ocamlmerlin-mlx
  62. ocf_ppx
  63. ocsigen-i18n >= "4.0.0"
  64. octez-internal-libs
  65. ojs_base_ppx
  66. ometrics = "0.2.0"
  67. ortac-core
  68. ortac-qcheck-stm
  69. ortac-wrapper
  70. pancake
  71. pgocaml_ppx >= "4.3.0"
  72. pla >= "2.0"
  73. ppx-owl-opt
  74. ppx_accessor >= "v0.14.3"
  75. ppx_assert >= "v0.13.0"
  76. ppx_bap
  77. ppx_base >= "v0.13.0"
  78. ppx_bench >= "v0.17.1"
  79. ppx_bin_prot >= "v0.17.1"
  80. ppx_bitstring >= "5.0.0"
  81. ppx_blob >= "0.7.2"
  82. ppx_catch
  83. ppx_cold
  84. ppx_compare >= "v0.13.0"
  85. ppx_compose >= "0.2.1"
  86. ppx_const >= "2.0.1"
  87. ppx_conv_func >= "v0.13.0"
  88. ppx_counters
  89. ppx_css
  90. ppx_cstruct >= "6.0.0"
  91. ppx_cstubs >= "0.6.1" & < "0.7.0"
  92. ppx_csv_conv >= "v0.13.0"
  93. ppx_custom_printf >= "v0.14.1"
  94. ppx_decimal
  95. ppx_defer >= "0.5.0"
  96. ppx_demo
  97. ppx_derive_at_runtime < "v0.17.0"
  98. ppx_deriving >= "6.1.0"
  99. ppx_deriving_cad
  100. ppx_deriving_decoders < "0.2"
  101. ppx_deriving_encoding >= "0.4.2"
  102. ppx_deriving_ezjsonm >= "0.4.1"
  103. ppx_deriving_hardcaml >= "v0.13.0"
  104. ppx_deriving_hash >= "0.1.3"
  105. ppx_deriving_json_schema
  106. ppx_deriving_jsonschema
  107. ppx_deriving_madcast >= "0.2"
  108. ppx_deriving_popper
  109. ppx_deriving_protobuf >= "3.0.0"
  110. ppx_deriving_qcheck
  111. ppx_deriving_scad
  112. ppx_deriving_variant_string
  113. ppx_deriving_yaml >= "0.4.1"
  114. ppx_deriving_yojson >= "3.10.0"
  115. ppx_diff >= "v0.17.1"
  116. ppx_disable_unused_warnings
  117. ppx_dream_eml
  118. ppx_embed_file
  119. ppx_enumerate >= "v0.13.0"
  120. ppx_expect >= "v0.17.3"
  121. ppx_expect_nobase
  122. ppx_factory = "0.1.0" | >= "0.2.0"
  123. ppx_fail >= "v0.13.0"
  124. ppx_fields_conv >= "v0.14.2"
  125. ppx_fixed_literal
  126. ppx_fun
  127. ppx_gen_rec >= "2.0.0"
  128. ppx_getenv >= "2.1"
  129. ppx_globalize >= "v0.17.2"
  130. ppx_hardcaml
  131. ppx_hash >= "v0.13.0"
  132. ppx_here >= "v0.13.0"
  133. ppx_ignore_instrumentation
  134. ppx_import < "1.8.0" | >= "1.11.0"
  135. ppx_inline_test >= "v0.17.1"
  136. ppx_interact >= "0.2.0"
  137. ppx_irmin >= "3.0.0"
  138. ppx_jane >= "v0.13.0"
  139. ppx_jsobject_conv = "0.8.0" | >= "0.21.1"
  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. sedlex >= "3.4"
  192. serde_derive
  193. server-reason-react
  194. speed
  195. spin >= "0.8.0"
  196. stdint-literals
  197. stk_ppx
  198. streamable < "v0.17.0"
  199. styled-ppx
  200. togglelog
  201. toplevel_expect_test >= "v0.14.1"
  202. tyxml-jsx >= "4.5.0"
  203. tyxml-syntax >= "4.5.0"
  204. visitors >= "20210608"
  205. vlt >= "0.2.5"
  206. volgo
  207. volgo-base
  208. volgo-git-backend
  209. volgo-git-eio
  210. volgo-git-unix
  211. volgo-hg-backend
  212. volgo-hg-eio
  213. volgo-hg-unix
  214. volgo-vcs
  215. wasm_of_ocaml-compiler
  216. wtr < "3.0.0"
  217. wtr-ppx
  218. 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.