package ppxlib

  1. Overview
  2. Docs
Standard infrastructure for ppx rewriters

Install

Dune Dependency

Authors

Maintainers

Sources

ppxlib-0.32.1.tbz
sha256=9dbad8bcb1c8b4f3df3f58bca60a5ed23d86531f0da34b4196c86bd585c09d7f
sha512=7b93b622b119478dde03adcf4993e73ea937c91c280e453ccee631c682d8589ecb31841f11d6a14966239954e22e000da8afbe25a0f089532c7210b698c52553

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: 30 Apr 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.3.0"
  6. dune >= "2.7"

Dev Dependencies (5)

  1. odoc with-doc
  2. cinaps with-test & >= "v0.12.1"
  3. re with-test & >= "1.9.0"
  4. ocamlfind with-test
  5. sexplib0 with-test & >= "v0.15"

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

Conflicts (4)

  1. base-effects
  2. ocaml-variants = "5.1.0~alpha1+options"
  3. ocaml-base-compiler = "5.1.0~alpha1"
  4. ocaml-migrate-parsetree < "2.0.0"