package ppxlib

  1. Overview
  2. Docs
Standard library 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.27.0.tbz
sha256=764b96121d6ffd6a73820e0ec5235176bfc42b94cf2ff97e32d068a5c4b28c62
sha512=2dcce0be6acdb3e185bfdad2785303a405c617f99949316abe6793f785d7227c10795ca49e79290bd385873da635191b44e8a5c211de114a168846d5d26f505c

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