package ppxlib

  1. Overview
  2. Docs
Standard infrastructure for ppx rewriters

Install

Dune 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. base_quickcheck >= "v0.17.1"
  4. bistro >= "0.6.0"
  5. bonsai >= "v0.16.0"
  6. bytestring
  7. clangml >= "4.7.0"
  8. cmdlang-to-base
  9. comby < "1.3.0"
  10. commons
  11. crs
  12. diff
  13. dream-html >= "3.9.5"
  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. mutaml
  55. neural_nets_lib < "0.5.2"
  56. noCanren >= "0.3.0~alpha1"
  57. node_of_ocaml
  58. nuscr >= "2.0.0"
  59. OCanren-ppx >= "0.3.0"
  60. obus >= "1.2.5"
  61. ocaml-monadic >= "0.5"
  62. ocamlmerlin-mlx
  63. ocf_ppx
  64. ocsigen-i18n >= "4.0.0"
  65. octez-internal-libs
  66. ojs_base_ppx
  67. ometrics = "0.2.0"
  68. ortac-core
  69. ortac-qcheck-stm
  70. ortac-wrapper
  71. pancake
  72. pgocaml_ppx >= "4.3.0"
  73. pla >= "2.0"
  74. ppx-owl-opt
  75. ppx_accessor >= "v0.14.3"
  76. ppx_assert >= "v0.13.0"
  77. ppx_bap
  78. ppx_base >= "v0.13.0"
  79. ppx_bench >= "v0.17.1"
  80. ppx_bin_prot >= "v0.17.1"
  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_ezjsonm >= "0.4.1"
  102. ppx_deriving_hardcaml >= "v0.13.0"
  103. ppx_deriving_hash >= "0.1.3"
  104. ppx_deriving_json_schema
  105. ppx_deriving_jsonschema
  106. ppx_deriving_madcast >= "0.2"
  107. ppx_deriving_popper
  108. ppx_deriving_protobuf >= "3.0.0"
  109. ppx_deriving_qcheck
  110. ppx_deriving_scad
  111. ppx_deriving_variant_string
  112. ppx_deriving_yaml >= "0.4.1"
  113. ppx_deriving_yojson >= "3.10.0"
  114. ppx_diff >= "v0.17.1"
  115. ppx_disable_unused_warnings
  116. ppx_dream_eml
  117. ppx_embed_file
  118. ppx_enumerate >= "v0.13.0"
  119. ppx_expect >= "v0.17.3"
  120. ppx_expect_nobase
  121. ppx_factory = "0.1.0" | >= "0.2.0"
  122. ppx_fail >= "v0.13.0"
  123. ppx_fields_conv >= "v0.14.2"
  124. ppx_fixed_literal
  125. ppx_fun
  126. ppx_gen_rec >= "2.0.0"
  127. ppx_getenv >= "2.1"
  128. ppx_globalize >= "v0.17.2"
  129. ppx_hardcaml
  130. ppx_hash >= "v0.13.0"
  131. ppx_here >= "v0.13.0"
  132. ppx_ignore_instrumentation
  133. ppx_import < "1.8.0" | >= "1.11.0"
  134. ppx_inline_test >= "v0.17.1"
  135. ppx_irmin >= "3.0.0"
  136. ppx_jane >= "v0.13.0"
  137. ppx_jsobject_conv = "0.8.0"
  138. ppx_jsonaf_conv >= "v0.15.1" & < "v0.17.0"
  139. ppx_let >= "v0.17.1"
  140. ppx_log
  141. ppx_map
  142. ppx_mica
  143. ppx_minidebug != "2.2.0"
  144. ppx_module_timer >= "v0.13.0"
  145. ppx_monad
  146. ppx_monoid >= "0.3.3"
  147. ppx_mysql >= "1.1.3"
  148. ppx_open
  149. ppx_optcomp >= "v0.17.1"
  150. ppx_optint
  151. ppx_optional >= "v0.13.0"
  152. ppx_partial
  153. ppx_pattern_bind >= "v0.13.1" & < "v0.17.0"
  154. ppx_pipebang >= "v0.13.0"
  155. ppx_pyformat
  156. ppx_python >= "v0.15.0"
  157. ppx_seq
  158. ppx_sexp_conv >= "v0.17.1"
  159. ppx_sexp_message >= "v0.14.1"
  160. ppx_sexp_value >= "v0.13.0"
  161. ppx_show >= "0.2.0"
  162. ppx_stable >= "v0.17.1"
  163. ppx_stable_witness
  164. ppx_string >= "v0.14.1"
  165. ppx_string_conv
  166. ppx_string_interpolation
  167. ppx_subliner
  168. ppx_system
  169. ppx_ts
  170. ppx_tydi >= "v0.17.1"
  171. ppx_type_directed_value
  172. ppx_typed_fields < "v0.17.0"
  173. ppx_typerep_conv >= "v0.17.1"
  174. ppx_units
  175. ppx_unreachable
  176. ppx_update
  177. ppx_variants_conv >= "v0.17.1"
  178. ppx_viewpattern >= "0.1.1"
  179. ppx_xml_conv >= "v0.13.0"
  180. ppx_yojson >= "1.3.0"
  181. ppx_yojson_conv >= "v0.15.1"
  182. ppxlib_jane >= "v0.17.3"
  183. qcow = "0.11.0"
  184. rdf_ppx
  185. reason >= "3.16.0"
  186. reason-react-ppx >= "0.13.0" & < "0.14.1"
  187. refl >= "0.4.1"
  188. res_tailwindcss
  189. rescript-syntax
  190. sedlex >= "3.4"
  191. serde_derive
  192. server-reason-react
  193. speed
  194. spin >= "0.8.0"
  195. stdint-literals
  196. stk_ppx
  197. streamable < "v0.17.0"
  198. styled-ppx
  199. togglelog
  200. toplevel_expect_test >= "v0.14.1"
  201. tyxml-jsx >= "4.5.0"
  202. tyxml-syntax >= "4.5.0"
  203. visitors >= "20210608"
  204. vlt >= "0.2.5"
  205. volgo
  206. volgo-base
  207. volgo-git-backend
  208. volgo-git-eio
  209. volgo-git-unix
  210. volgo-hg-backend
  211. volgo-hg-eio
  212. volgo-hg-unix
  213. volgo-vcs
  214. wasm_of_ocaml-compiler
  215. wtr < "3.0.0"
  216. wtr-ppx
  217. 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.