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.30.0.tbz
sha256=dd4a63bde9d29b49810e04d7653937c932f177a941ca0e1982b6ad53ac442110
sha512=0a8c4fa894aaf445cb93213eaa32afb2772235da44aa28c917aba237731a44d5c2687bd960fca49bff62bbe0f9b3fdd9c15730313b429214ae281069f862ffdc

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: 21 Jun 2023

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.2.0" & != "5.1.0~alpha1"
  6. dune >= "2.7"

Dev Dependencies (6)

  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"
  6. ocaml with-test & < "5.1.0~alpha2"

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