package ppxlib

  1. Overview
  2. Docs
Standard infrastructure for ppx rewriters

Install

Dune Dependency

Authors

Maintainers

Sources

ppxlib-0.35.0.tbz
sha256=d9d959fc9f84260487e45684dc741898a92fc5506b61a7f5cac65d21832db925
sha512=e428b1e3b89261c7efdaa18016264d1afbf067cb9b0d41124b04796c2487ac7ca8ee9a24a60d56f20d1774cb44aaa9ecf1512f17455812ba8d62d4ef93616ee7

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: 04 Feb 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
  2. awsm-codegen
  3. bam-ppx
  4. base_quickcheck = "v0.13.0" | >= "v0.14.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. diff
  16. dream-html >= "3.9.5"
  17. dune >= "3.17.0"
  18. dunolint
  19. dunolint-lib
  20. ego
  21. eliom >= "8.9.0"
  22. elpi >= "1.11.0" & < "1.11.3" | >= "1.13.2"
  23. embedded_ocaml_templates < "0.3.1" | >= "0.7"
  24. extunix >= "0.3.1" & < "0.4.4"
  25. flow_parser >= "0.229.1"
  26. fsml
  27. fstar >= "2025.02.17"
  28. GT = "0.5.1"
  29. gen_js_api < "1.0.8" | >= "1.1.1"
  30. genprint = "0.3"
  31. goblint >= "2.5.0"
  32. gospel >= "0.2.0"
  33. graphql_ppx >= "1.2.2"
  34. hack_parallel >= "1.0.1"
  35. hardcaml >= "v0.14.1"
  36. html_of_jsx >= "0.0.2"
  37. http_async
  38. js_of_ocaml >= "3.8.0"
  39. js_of_ocaml-compiler >= "3.8.0"
  40. js_of_ocaml-lwt >= "3.10.0"
  41. js_of_ocaml-ocamlbuild >= "3.10.0" & < "5.0"
  42. js_of_ocaml-ppx >= "3.8.0"
  43. js_of_ocaml-ppx_deriving_json >= "3.7.1"
  44. js_of_ocaml-toplevel >= "3.10.0"
  45. js_of_ocaml-tyxml >= "3.10.0"
  46. jsoo-react
  47. lablqml >= "0.7"
  48. landmarks-ppx
  49. lascar >= "0.7.0"
  50. learn-ocaml
  51. learn-ocaml-client
  52. lens >= "1.2.5"
  53. logs-ppx
  54. lwt_ppx >= "2.0.2"
  55. MlFront_Cli >= "2.1.4~prerel2" & < "2.3.1"
  56. MlFront_Config
  57. MlFront_Manip
  58. melange >= "1.0.0"
  59. melange-json >= "1.2.0"
  60. melange-json-native
  61. merlin >= "4.7-412"
  62. metapp >= "0.4.4"
  63. metaquot >= "0.5.0"
  64. mlt_parser = "v0.13.0" | >= "v0.14.1"
  65. mlx
  66. mutaml >= "0.2"
  67. neural_nets_lib
  68. noCanren >= "0.3.0~alpha1"
  69. node_of_ocaml
  70. nuscr >= "2.0.0"
  71. OCanren-ppx = "0.2.0" | >= "0.3.0"
  72. obus >= "1.2.5"
  73. ocaml-monadic >= "0.5"
  74. ocamlmerlin-mlx
  75. ocf_ppx
  76. ocsigen-i18n >= "4.0.0"
  77. ocsigen-ppx-rpc
  78. octez-internal-libs
  79. ojs_base_ppx
  80. ometrics = "0.2.0"
  81. ortac-core
  82. ortac-qcheck-stm
  83. override = "0.2.2"
  84. pacomb
  85. pancake
  86. pgocaml_ppx >= "4.3.0"
  87. pla >= "2.0"
  88. ppx-owl-opt
  89. ppx_accessor >= "v0.14.3"
  90. ppx_assert >= "v0.13.0"
  91. ppx_bap
  92. ppx_base >= "v0.13.0"
  93. ppx_bench >= "v0.15.1"
  94. ppx_bin_prot >= "v0.13.0"
  95. ppx_bitstring >= "4.1.0"
  96. ppx_blob >= "0.7.2"
  97. ppx_camlrack
  98. ppx_catch
  99. ppx_cold
  100. ppx_compare >= "v0.13.0"
  101. ppx_compose >= "0.2.1"
  102. ppx_const >= "2.0.1"
  103. ppx_conv_func >= "v0.13.0"
  104. ppx_counters
  105. ppx_css
  106. ppx_cstruct >= "6.0.0"
  107. ppx_cstubs >= "0.6.1"
  108. ppx_csv_conv >= "v0.13.0"
  109. ppx_custom_printf >= "v0.14.1"
  110. ppx_decimal
  111. ppx_default
  112. ppx_defer >= "0.5.0"
  113. ppx_demo
  114. ppx_derive_at_runtime
  115. ppx_deriving >= "5.2" & < "6.1.0"
  116. ppx_deriving_cad
  117. ppx_deriving_decoders
  118. ppx_deriving_encoding >= "0.2"
  119. ppx_deriving_ezjsonm
  120. ppx_deriving_hardcaml >= "v0.13.0"
  121. ppx_deriving_hash < "0.1.3"
  122. ppx_deriving_json_schema
  123. ppx_deriving_jsonschema
  124. ppx_deriving_jsoo >= "0.2"
  125. ppx_deriving_madcast >= "0.2"
  126. ppx_deriving_popper
  127. ppx_deriving_protobuf >= "3.0.0"
  128. ppx_deriving_qcheck < "0.7"
  129. ppx_deriving_rpc >= "8.1.0"
  130. ppx_deriving_scad
  131. ppx_deriving_variant_string
  132. ppx_deriving_yaml
  133. ppx_deriving_yojson >= "3.7.0" & < "3.10.0"
  134. ppx_diff
  135. ppx_disable_unused_warnings
  136. ppx_distr_guards >= "0.3"
  137. ppx_dream_eml
  138. ppx_embed_file
  139. ppx_enumerate >= "v0.13.0"
  140. ppx_expect >= "v0.13.0" & != "v0.14.0"
  141. ppx_expect_nobase
  142. ppx_factory = "0.1.0" | >= "0.2.0"
  143. ppx_fail >= "v0.13.0"
  144. ppx_fields_conv >= "v0.14.2"
  145. ppx_fixed_literal
  146. ppx_fun
  147. ppx_gen_rec >= "2.0.0"
  148. ppx_getenv >= "2.1"
  149. ppx_globalize
  150. ppx_hardcaml
  151. ppx_hash >= "v0.13.0"
  152. ppx_here >= "v0.13.0"
  153. ppx_ignore_instrumentation
  154. ppx_import < "1.8.0" | >= "1.11.0"
  155. ppx_inline_alcotest
  156. ppx_inline_test >= "v0.15.1"
  157. ppx_inline_test_nobase
  158. ppx_interact
  159. ppx_irmin >= "3.0.0"
  160. ppx_jane >= "v0.13.0"
  161. ppx_js_style >= "v0.13.0"
  162. ppx_jsobject_conv = "0.8.0" | >= "0.9.3"
  163. ppx_jsonaf_conv >= "v0.15.1"
  164. ppx_let >= "v0.13.0"
  165. ppx_log
  166. ppx_lun
  167. ppx_make
  168. ppx_map
  169. ppx_matches
  170. ppx_mica
  171. ppx_minidebug
  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"
  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"
  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"
  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
  206. ppx_type_directed_value
  207. ppx_typed_fields
  208. ppx_typerep_conv >= "v0.14.2"
  209. ppx_units
  210. ppx_update
  211. ppx_variants_conv >= "v0.14.2"
  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-tools = "0.35.0"
  217. ppxlib_jane
  218. ppxx >= "2.5.0"
  219. qcow = "0.11.0"
  220. rdf_ppx
  221. reactjs-jsx-ppx
  222. reason >= "3.9.0" & < "3.16.0"
  223. reason-react-ppx
  224. refl >= "0.4.1"
  225. repr-fuzz >= "0.2.1"
  226. res_tailwindcss
  227. rescript-syntax
  228. sedlex >= "2.6"
  229. serde_derive
  230. server-reason-react
  231. speed
  232. spin >= "0.8.0"
  233. spoc_ppx
  234. stdint-literals
  235. stk_ppx
  236. streamable
  237. styled-ppx
  238. togglelog
  239. toplevel_expect_test >= "v0.14.1"
  240. tyxml-jsx >= "4.5.0"
  241. tyxml-ppx >= "4.5.0"
  242. tyxml-syntax >= "4.5.0"
  243. validate
  244. visitors >= "20210608"
  245. vlt
  246. wasm_of_ocaml-compiler
  247. wtr < "3.0.0"
  248. wtr-ppx
  249. 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.