package ppxlib

  1. Overview
  2. Docs
Standard infrastructure for ppx rewriters

Install

Dune Dependency

Authors

Maintainers

Sources

ac7fcfc88d574609b62cc0a38e0de59d03cc96de.tar.gz
sha256=d679f110b92ed12156556ee1d3779d11cef605c36f0bc417943e7996f0d2bbaf
sha512=c34e704f19bcebbe5dbb764783f9e8b9bcb44e22388bbd4074f1f3e44faf9d1aa2d05040690512b3a8c120ecff54787107bd6912f4e5f2980a17e5357b1beeed

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: 25 Sep 2024

README

Ppxlib - Meta-programming for OCaml

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