package ppxlib

  1. Overview
  2. Docs
Standard library for ppx rewriters

Install

Dune Dependency

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

Authors

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

Maintainers

  1. O
    opensource@janestreet.com

Sources

ppxlib-0.29.1.tbz
sha256=c8ea8c8770414fdba6612e7f2d814b21a493daa974ea862a90c8e6c766e5dd79
sha512=edc468e9111cc26e31825e475fd72f55123a22fe86548e07e7d111796fecb8d60359b1b53c7eac383e5e2114cbae74dfd9c166f330e84cbeab4ddfd5797e322f

Description

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 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: 14 Feb 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 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.

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 historied 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 as 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.1.0"
  6. dune >= "2.7"

Dev Dependencies (7)

  1. odoc with-doc
  2. stdio with-test
  3. base with-test & < "v0.16.0"
  4. cinaps with-test & >= "v0.12.1"
  5. re with-test & >= "1.9.0"
  6. ocamlfind with-test
  7. 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. 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_gen_rec >= "2.0.0"
  120. ppx_getenv >= "2.1"
  121. ppx_globalize
  122. ppx_hash >= "v0.13.0"
  123. ppx_here >= "v0.13.0"
  124. ppx_ignore_instrumentation
  125. ppx_import >= "1.7.0" & < "1.8.0" | >= "1.10.0"
  126. ppx_inline_alcotest
  127. ppx_inline_test >= "v0.15.1"
  128. ppx_interact
  129. ppx_irmin >= "3.0.0"
  130. ppx_jane >= "v0.13.0"
  131. ppx_js_style >= "v0.13.0"
  132. ppx_jsobject_conv = "0.8.0" | >= "0.9.3"
  133. ppx_jsonaf_conv >= "v0.15.1"
  134. ppx_let >= "v0.13.0"
  135. ppx_log
  136. ppx_lun
  137. ppx_make
  138. ppx_map
  139. ppx_matches
  140. ppx_minidebug
  141. ppx_module_timer >= "v0.13.0"
  142. ppx_monad
  143. ppx_monoid >= "0.3.3"
  144. ppx_mysql >= "1.1.3"
  145. ppx_open
  146. ppx_optcomp >= "v0.14.2"
  147. ppx_optint
  148. ppx_optional >= "v0.13.0"
  149. ppx_parser
  150. ppx_pattern_bind >= "v0.13.1"
  151. ppx_pipebang >= "v0.13.0"
  152. ppx_protocol_conv >= "5.1.3"
  153. ppx_pyformat
  154. ppx_python >= "v0.15.0"
  155. ppx_rapper
  156. ppx_regexp >= "0.5.0"
  157. ppx_repr >= "0.6.0"
  158. ppx_seq
  159. ppx_sexp_conv >= "v0.15.1"
  160. ppx_sexp_message >= "v0.14.1"
  161. ppx_sexp_value >= "v0.13.0"
  162. ppx_show >= "0.2.0"
  163. ppx_stable >= "v0.14.1"
  164. ppx_stable_witness
  165. ppx_string >= "v0.14.1"
  166. ppx_string_interpolation
  167. ppx_subliner
  168. ppx_system
  169. ppx_trace
  170. ppx_ts
  171. ppx_tydi
  172. ppx_type_directed_value
  173. ppx_typed_fields
  174. ppx_typerep_conv >= "v0.14.2"
  175. ppx_units
  176. ppx_variants_conv >= "v0.14.2"
  177. ppx_viewpattern
  178. ppx_xml_conv >= "v0.13.0"
  179. ppx_yojson >= "1.3.0"
  180. ppx_yojson_conv >= "v0.15.1"
  181. ppxx >= "2.5.0"
  182. qcow >= "0.11.0"
  183. rdf_ppx < "1.0.0"
  184. reactjs-jsx-ppx
  185. reason >= "3.9.0"
  186. reason-react-ppx
  187. refl >= "0.4.1"
  188. repr-fuzz >= "0.2.1"
  189. res_tailwindcss
  190. rescript-syntax
  191. scaml != "1.2.0"
  192. sedlex >= "2.6"
  193. serde_derive
  194. server-reason-react
  195. spin >= "0.8.0"
  196. spoc_ppx
  197. stdint-literals
  198. streamable
  199. styled-ppx
  200. togglelog
  201. toplevel_expect_test >= "v0.14.1"
  202. tyxml-jsx >= "4.5.0"
  203. tyxml-ppx >= "4.5.0"
  204. tyxml-syntax >= "4.5.0"
  205. visitors >= "20210608"
  206. vlt
  207. wtr < "3.0.0"
  208. wtr-ppx
  209. xtmpl_ppx