package ppxlib

  1. Overview
  2. Docs
Standard infrastructure for ppx rewriters

Install

dune-project
 Dependency

Authors

Maintainers

Sources

ppxlib-0.36.0.tbz
sha256=5aba1bce14c53108614130110c843d004bf93bd2cf3a0778fd7086b85390a434
sha512=1e3e8fee42fe74bffc178dbcbb2db8ec38dd23e71f6fed3c4c92618cf93892f5847787e6e9abb322f5c85d29a76afde28ce840b42e10fedc14cd82ba578ad06a

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: 05 Mar 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.4.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_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_irmin >= "3.0.0"
  137. ppx_jane >= "v0.13.0"
  138. ppx_jsobject_conv = "0.8.0"
  139. ppx_jsonaf_conv >= "v0.15.1" & < "v0.17.0"
  140. ppx_let >= "v0.17.1"
  141. ppx_log
  142. ppx_map
  143. ppx_mica
  144. ppx_minidebug != "2.2.0"
  145. ppx_module_timer >= "v0.13.0"
  146. ppx_monad
  147. ppx_monoid >= "0.3.3"
  148. ppx_mysql >= "1.1.3"
  149. ppx_open
  150. ppx_optcomp >= "v0.17.1"
  151. ppx_optint
  152. ppx_optional >= "v0.13.0"
  153. ppx_partial
  154. ppx_pattern_bind >= "v0.13.1" & < "v0.17.0"
  155. ppx_pipebang >= "v0.13.0"
  156. ppx_pyformat
  157. ppx_python >= "v0.15.0"
  158. ppx_seq
  159. ppx_sexp_conv >= "v0.17.1"
  160. ppx_sexp_message >= "v0.14.1"
  161. ppx_sexp_value >= "v0.13.0"
  162. ppx_show >= "0.2.0"
  163. ppx_stable >= "v0.17.1"
  164. ppx_stable_witness
  165. ppx_string >= "v0.14.1"
  166. ppx_string_conv
  167. ppx_string_interpolation
  168. ppx_subliner
  169. ppx_system
  170. ppx_ts
  171. ppx_tydi >= "v0.17.1"
  172. ppx_type_directed_value
  173. ppx_typed_fields < "v0.17.0"
  174. ppx_typerep_conv >= "v0.17.1"
  175. ppx_units
  176. ppx_unreachable
  177. ppx_update
  178. ppx_variants_conv >= "v0.17.1"
  179. ppx_viewpattern >= "0.1.1"
  180. ppx_xml_conv >= "v0.13.0"
  181. ppx_yojson >= "1.3.0"
  182. ppx_yojson_conv >= "v0.15.1"
  183. ppxlib-tools
  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.