package ppxlib

  1. Overview
  2. Docs
Standard infrastructure for ppx rewriters

Install

Dune Dependency

Authors

Maintainers

Sources

ppxlib-0.34.0.tbz
sha256=d77d97165a158d7ae56b7c0387cd04e9927d7e7e797ca1039ffb5bb17a6661a7
sha512=84954f375b0c3ed063c874c47cc2597cceea338de0f567f64f340bd4e3569ef88421369b92bd5830701216bcdb88d78f50f3896c8edeb13250f0e7337c106b7d

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: 08 Jan 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.04.1" & < "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
  2. awsm-codegen
  3. bam-ppx
  4. base_quickcheck = "v0.13.0" | >= "v0.14.1" & < "v0.17.1"
  5. bisect_ppx >= "2.8.3"
  6. bistro >= "0.6.0"
  7. bonsai >= "v0.16.0"
  8. brisk-reconciler
  9. bytestring
  10. clangml >= "4.7.0"
  11. cmdlang-to-base
  12. comby < "1.3.0"
  13. commons
  14. config
  15. crs
  16. diff
  17. dream-html >= "3.9.5"
  18. dune = "3.17.2"
  19. ego
  20. eliom >= "8.9.0"
  21. elpi
  22. embedded_ocaml_templates < "0.3.1" | >= "0.7"
  23. extunix >= "0.3.1" & < "0.4.4"
  24. flow_parser >= "0.229.1"
  25. fsml
  26. fstar >= "2025.02.17" & < "2025.06.20"
  27. GT = "0.5.1" | >= "0.5.4"
  28. gen_js_api < "1.0.8" | >= "1.1.1"
  29. genprint = "0.3"
  30. goblint >= "2.5.0"
  31. gospel >= "0.2.0"
  32. graphql_ppx >= "1.2.2"
  33. hack_parallel >= "1.0.1"
  34. hardcaml >= "v0.14.1"
  35. html_of_jsx >= "0.0.2"
  36. http_async
  37. js_of_ocaml >= "3.8.0" & < "6.1.0"
  38. js_of_ocaml-compiler >= "3.8.0" & < "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 >= "3.8.0" & < "6.1.0"
  42. js_of_ocaml-ppx_deriving_json >= "3.7.1" & < "6.1.0"
  43. js_of_ocaml-toplevel >= "3.10.0" & < "6.1.0"
  44. js_of_ocaml-tyxml >= "3.10.0" & < "6.1.0"
  45. jsoo-react
  46. lablqml >= "0.7"
  47. landmarks-ppx
  48. lascar >= "0.7.0"
  49. learn-ocaml
  50. learn-ocaml-client
  51. lens >= "1.2.5"
  52. logs-ppx
  53. lwt_ppx >= "2.0.2"
  54. MlFront_Cli >= "2.1.4~prerel2" & < "2.3.1"
  55. MlFront_Config
  56. MlFront_Manip
  57. melange >= "1.0.0"
  58. melange-json >= "1.2.0"
  59. melange-json-native
  60. merlin >= "4.7-412"
  61. metapp >= "0.4.4"
  62. metaquot >= "0.5.0"
  63. mlt_parser = "v0.13.0" | >= "v0.14.1"
  64. mlx
  65. mutaml
  66. neural_nets_lib
  67. noCanren >= "0.3.0~alpha1"
  68. node_of_ocaml
  69. nuscr >= "2.0.0"
  70. OCanren-ppx
  71. obus >= "1.2.5"
  72. ocaml-monadic >= "0.5"
  73. ocamlmerlin-mlx
  74. ocf_ppx
  75. ocsigen-i18n >= "4.0.0"
  76. ocsigen-ppx-rpc
  77. octez-internal-libs
  78. ojs_base_ppx
  79. ometrics = "0.2.0"
  80. ortac-core
  81. ortac-qcheck-stm
  82. ortac-wrapper
  83. pacomb
  84. pancake
  85. pgocaml_ppx >= "4.3.0"
  86. pla >= "2.0"
  87. ppx-owl-opt
  88. ppx_accessor >= "v0.14.3"
  89. ppx_assert >= "v0.13.0"
  90. ppx_bap
  91. ppx_base >= "v0.13.0"
  92. ppx_bench >= "v0.15.1" & < "v0.17.1"
  93. ppx_bin_prot >= "v0.13.0" & < "v0.17.1"
  94. ppx_bitstring >= "4.1.0"
  95. ppx_blob >= "0.7.2"
  96. ppx_camlrack
  97. ppx_catch
  98. ppx_cold
  99. ppx_compare >= "v0.13.0"
  100. ppx_compose >= "0.2.1"
  101. ppx_const >= "2.0.1"
  102. ppx_conv_func >= "v0.13.0"
  103. ppx_counters
  104. ppx_css
  105. ppx_cstruct >= "6.0.0"
  106. ppx_cstubs >= "0.6.1"
  107. ppx_csv_conv >= "v0.13.0"
  108. ppx_custom_printf >= "v0.14.1"
  109. ppx_decimal
  110. ppx_default
  111. ppx_defer >= "0.5.0"
  112. ppx_demo
  113. ppx_derive_at_runtime
  114. ppx_deriving >= "5.2" & < "6.1.0"
  115. ppx_deriving_cad
  116. ppx_deriving_decoders
  117. ppx_deriving_encoding >= "0.2"
  118. ppx_deriving_ezjsonm < "0.4.1"
  119. ppx_deriving_hardcaml >= "v0.13.0"
  120. ppx_deriving_hash < "0.1.3"
  121. ppx_deriving_json_schema
  122. ppx_deriving_jsonschema
  123. ppx_deriving_jsoo >= "0.2"
  124. ppx_deriving_madcast >= "0.2"
  125. ppx_deriving_popper
  126. ppx_deriving_protobuf >= "3.0.0"
  127. ppx_deriving_rpc
  128. ppx_deriving_scad
  129. ppx_deriving_variant_string
  130. ppx_deriving_yaml < "0.4.1"
  131. ppx_deriving_yojson >= "3.7.0" & < "3.10.0"
  132. ppx_diff < "v0.17.1"
  133. ppx_disable_unused_warnings
  134. ppx_distr_guards >= "0.3"
  135. ppx_dream_eml
  136. ppx_embed_file
  137. ppx_enumerate >= "v0.13.0"
  138. ppx_expect >= "v0.13.0" & != "v0.14.0" & < "v0.17.3"
  139. ppx_expect_nobase
  140. ppx_factory = "0.1.0" | >= "0.2.0"
  141. ppx_fail >= "v0.13.0"
  142. ppx_fields_conv >= "v0.14.2"
  143. ppx_fixed_literal
  144. ppx_fun
  145. ppx_gen_rec >= "2.0.0"
  146. ppx_getenv >= "2.1"
  147. ppx_globalize < "v0.17.2"
  148. ppx_hardcaml
  149. ppx_hash >= "v0.13.0"
  150. ppx_here >= "v0.13.0"
  151. ppx_ignore_instrumentation
  152. ppx_import < "1.8.0" | >= "1.11.0"
  153. ppx_inline_alcotest
  154. ppx_inline_test >= "v0.15.1" & < "v0.17.1"
  155. ppx_inline_test_nobase
  156. ppx_interact
  157. ppx_irmin >= "3.0.0"
  158. ppx_jane >= "v0.13.0"
  159. ppx_js_style >= "v0.13.0"
  160. ppx_jsobject_conv = "0.8.0" | >= "0.9.3"
  161. ppx_jsonaf_conv >= "v0.15.1"
  162. ppx_let >= "v0.13.0" & < "v0.17.1"
  163. ppx_log
  164. ppx_lun
  165. ppx_make
  166. ppx_map
  167. ppx_marshal
  168. ppx_marshal_ext
  169. ppx_matches
  170. ppx_mica
  171. ppx_minidebug < "2.3.0"
  172. ppx_module_timer >= "v0.13.0"
  173. ppx_monad
  174. ppx_monoid >= "0.3.3"
  175. ppx_mysql >= "1.1.3"
  176. ppx_open
  177. ppx_optcomp >= "v0.14.2" & < "v0.17.1"
  178. ppx_optint
  179. ppx_optional >= "v0.13.0"
  180. ppx_parser
  181. ppx_partial
  182. ppx_pattern_bind >= "v0.13.1"
  183. ppx_pipebang >= "v0.13.0"
  184. ppx_protocol_conv >= "5.1.3"
  185. ppx_pyformat
  186. ppx_python >= "v0.15.0"
  187. ppx_quick_test
  188. ppx_rapper < "1.0.1"
  189. ppx_regexp >= "0.5.1"
  190. ppx_repr >= "0.6.0"
  191. ppx_seq
  192. ppx_sexp_conv >= "v0.15.1" & < "v0.17.1"
  193. ppx_sexp_message >= "v0.14.1"
  194. ppx_sexp_value >= "v0.13.0"
  195. ppx_show >= "0.2.0"
  196. ppx_stable >= "v0.14.1" & < "v0.17.1"
  197. ppx_stable_witness
  198. ppx_string >= "v0.14.1"
  199. ppx_string_conv
  200. ppx_string_interpolation
  201. ppx_subliner
  202. ppx_system
  203. ppx_trace
  204. ppx_ts
  205. ppx_tydi < "v0.17.1"
  206. ppx_type_directed_value
  207. ppx_typed_fields
  208. ppx_typerep_conv >= "v0.14.2" & < "v0.17.1"
  209. ppx_units
  210. ppx_update
  211. ppx_variants_conv >= "v0.14.2" & < "v0.17.1"
  212. ppx_viewpattern < "0.1.1"
  213. ppx_xml_conv >= "v0.13.0"
  214. ppx_yojson >= "1.3.0"
  215. ppx_yojson_conv >= "v0.15.1"
  216. ppxlib_jane < "v0.17.3"
  217. ppxx >= "2.5.0"
  218. qcow = "0.11.0"
  219. rdf_ppx
  220. reactjs-jsx-ppx
  221. reason >= "3.9.0" & < "3.16.0"
  222. reason-react-ppx
  223. refl >= "0.4.1"
  224. repr-fuzz >= "0.2.1"
  225. res_tailwindcss
  226. rescript-syntax
  227. sedlex >= "2.6"
  228. serde_derive
  229. server-reason-react
  230. speed
  231. spin >= "0.8.0"
  232. spoc_ppx
  233. stdint-literals
  234. stk_ppx
  235. streamable
  236. styled-ppx
  237. togglelog
  238. toplevel_expect_test >= "v0.14.1"
  239. tyxml-jsx >= "4.5.0"
  240. tyxml-ppx >= "4.5.0"
  241. tyxml-syntax >= "4.5.0"
  242. validate
  243. visitors >= "20210608"
  244. vlt
  245. volgo
  246. volgo-base
  247. volgo-git-backend
  248. volgo-git-eio
  249. volgo-git-unix
  250. volgo-hg-backend
  251. volgo-hg-eio
  252. volgo-hg-unix
  253. volgo-vcs
  254. wasm_of_ocaml-compiler < "6.1.0"
  255. wtr < "3.0.0"
  256. wtr-ppx
  257. 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.