package ppxlib

  1. Overview
  2. Docs
Standard infrastructure for ppx rewriters

Install

Dune Dependency

github.com Readme Changelog MIT License Edit opam file Versions (44)

Authors

  1. J
    Jane Street Group, LLC <opensource@janestreet.com>

Maintainers

  1. O
    opensource@janestreet.com

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. 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. melange >= "1.0.0"
  49. merlin >= "4.7-412"
  50. metapp >= "0.4.4"
  51. metaquot >= "0.5.0"
  52. mlt_parser = "v0.13.0" | >= "v0.14.1"
  53. neural_nets_lib
  54. noCanren >= "0.3.0~alpha1"
  55. node_of_ocaml
  56. nuscr >= "2.0.0"
  57. OCanren-ppx = "0.2.0" | >= "0.3.0"
  58. obus >= "1.2.5"
  59. ocaml-monadic >= "0.5"
  60. ocamlformat = "0.19.0~4.13preview"
  61. ocf_ppx
  62. ocsigen-i18n >= "4.0.0"
  63. ocsigen-ppx-rpc
  64. ojs_base_ppx
  65. ometrics = "0.2.0"
  66. ortac-core
  67. ortac-qcheck-stm
  68. override = "0.2.2"
  69. pacomb
  70. pancake
  71. pgocaml_ppx >= "4.3.0"
  72. pla >= "2.0"
  73. ppx-owl-opt
  74. ppx_accessor >= "v0.14.3"
  75. ppx_assert >= "v0.13.0"
  76. ppx_bap
  77. ppx_base >= "v0.13.0"
  78. ppx_bench >= "v0.15.1"
  79. ppx_bin_prot >= "v0.13.0"
  80. ppx_bitstring >= "4.1.0"
  81. ppx_blob >= "0.7.2"
  82. ppx_camlrack
  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"
  93. ppx_csv_conv >= "v0.13.0"
  94. ppx_custom_printf >= "v0.14.1"
  95. ppx_decimal
  96. ppx_default
  97. ppx_defer >= "0.5.0"
  98. ppx_demo
  99. ppx_derive_at_runtime
  100. ppx_deriving >= "5.2"
  101. ppx_deriving_cad
  102. ppx_deriving_encoding >= "0.2"
  103. ppx_deriving_hardcaml >= "v0.13.0"
  104. ppx_deriving_hash
  105. ppx_deriving_jsoo >= "0.2"
  106. ppx_deriving_madcast >= "0.2"
  107. ppx_deriving_popper
  108. ppx_deriving_protobuf >= "3.0.0"
  109. ppx_deriving_qcheck
  110. ppx_deriving_rpc >= "8.1.0"
  111. ppx_deriving_scad
  112. ppx_deriving_variant_string
  113. ppx_deriving_yaml
  114. ppx_deriving_yojson >= "3.7.0"
  115. ppx_disable_unused_warnings
  116. ppx_distr_guards >= "0.3"
  117. ppx_dream_eml
  118. ppx_enumerate >= "v0.13.0"
  119. ppx_expect >= "v0.13.0" & != "v0.14.0"
  120. ppx_factory = "0.1.0" | >= "0.2.0"
  121. ppx_fail >= "v0.13.0"
  122. ppx_fields_conv >= "v0.14.2"
  123. ppx_fixed_literal
  124. ppx_fun >= "0.0.9"
  125. ppx_gen_rec >= "2.0.0"
  126. ppx_getenv >= "2.1"
  127. ppx_globalize
  128. ppx_hash >= "v0.13.0"
  129. ppx_here >= "v0.13.0"
  130. ppx_ignore_instrumentation
  131. ppx_import >= "1.7.0" & < "1.8.0" | >= "1.11.0"
  132. ppx_inline_alcotest
  133. ppx_inline_test >= "v0.15.1"
  134. ppx_interact
  135. ppx_irmin >= "3.0.0"
  136. ppx_jane >= "v0.13.0"
  137. ppx_js_style >= "v0.13.0"
  138. ppx_jsobject_conv = "0.8.0" | >= "0.9.3"
  139. ppx_jsonaf_conv >= "v0.15.1"
  140. ppx_let >= "v0.13.0"
  141. ppx_log
  142. ppx_lun
  143. ppx_make
  144. ppx_map
  145. ppx_matches
  146. ppx_minidebug
  147. ppx_module_timer >= "v0.13.0"
  148. ppx_monad
  149. ppx_monoid >= "0.3.3"
  150. ppx_mysql >= "1.1.3"
  151. ppx_open
  152. ppx_optcomp >= "v0.14.2"
  153. ppx_optint
  154. ppx_optional >= "v0.13.0"
  155. ppx_parser
  156. ppx_pattern_bind >= "v0.13.1"
  157. ppx_pipebang >= "v0.13.0"
  158. ppx_protocol_conv >= "5.1.3"
  159. ppx_pyformat
  160. ppx_python >= "v0.15.0"
  161. ppx_rapper < "1.0.1"
  162. ppx_regexp >= "0.5.0"
  163. ppx_repr >= "0.6.0"
  164. ppx_seq
  165. ppx_sexp_conv >= "v0.15.1"
  166. ppx_sexp_message >= "v0.14.1"
  167. ppx_sexp_value >= "v0.13.0"
  168. ppx_show >= "0.2.0"
  169. ppx_stable >= "v0.14.1"
  170. ppx_stable_witness
  171. ppx_string >= "v0.14.1"
  172. ppx_string_interpolation
  173. ppx_subliner
  174. ppx_system
  175. ppx_trace
  176. ppx_ts
  177. ppx_tydi
  178. ppx_type_directed_value
  179. ppx_typed_fields
  180. ppx_typerep_conv >= "v0.14.2"
  181. ppx_units
  182. ppx_update
  183. ppx_variants_conv >= "v0.14.2"
  184. ppx_viewpattern
  185. ppx_xml_conv >= "v0.13.0"
  186. ppx_yojson >= "1.3.0"
  187. ppx_yojson_conv >= "v0.15.1"
  188. ppxx >= "2.5.0"
  189. qcow >= "0.11.0"
  190. rdf_ppx
  191. reactjs-jsx-ppx
  192. reason >= "3.9.0"
  193. reason-react-ppx
  194. refl >= "0.4.1"
  195. repr-fuzz >= "0.2.1"
  196. res_tailwindcss
  197. rescript-syntax
  198. scaml != "1.2.0"
  199. sedlex >= "2.6"
  200. serde_derive
  201. server-reason-react
  202. spin >= "0.8.0"
  203. spoc_ppx
  204. stdint-literals
  205. streamable
  206. styled-ppx
  207. togglelog
  208. toplevel_expect_test >= "v0.14.1"
  209. tyxml-jsx >= "4.5.0"
  210. tyxml-ppx >= "4.5.0"
  211. tyxml-syntax >= "4.5.0"
  212. visitors >= "20210608"
  213. vlt
  214. wtr < "3.0.0"
  215. wtr-ppx
  216. 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"