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.26.0.tbz
sha256=63117b67ea5863935455fe921f88fe333c0530f0483f730313303a93af817efd
sha512=9cfc9587657d17cdee5483e2a03292f872c42886e512bcc7442652e6418ce74c0135c731d8a68288c7fecae7f1b2defd93fe5acf8edb41e25144a8cec2806227

Description

Ppxlib is the standard library for ppx rewriters and other programs that manipulate the in-memory reprensation 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 Mar 2022

README

Ppxlib - Meta-programming for OCaml

User manual API 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 user manual.

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" & < "4.15"
  6. dune >= "2.7"

Dev Dependencies (7)

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