package ppxlib

  1. Overview
  2. Docs
Standard library for ppx rewriters

Install 

dune-project
 Dependency

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

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

ocaml-ci status AppVeyor status

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. arrayjit < "0.6.0"
  2. base_quickcheck = "v0.13.0" | >= "v0.14.1" & < "v0.16.0"
  3. bisect_ppx = "2.8.2"
  4. bistro >= "0.6.0"
  5. brisk-reconciler
  6. clangml >= "4.7.0"
  7. comby < "1.3.0"
  8. commons
  9. diff
  10. dune = "3.17.2"
  11. ego
  12. eliom >= "8.9.0"
  13. elpi
  14. embedded_ocaml_templates < "0.3.1" | >= "0.7"
  15. extunix >= "0.3.1" & < "0.4.4"
  16. flow_parser = "0.229.1"
  17. fsml
  18. GT >= "0.5.1"
  19. gen_js_api < "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" & < "v0.16.0"
  25. html_of_jsx
  26. http_async
  27. js_of_ocaml >= "3.8.0" & < "6.1.0"
  28. js_of_ocaml-compiler >= "3.8.0" & < "6.1.0"
  29. js_of_ocaml-lwt >= "3.10.0" & < "6.1.0"
  30. js_of_ocaml-ocamlbuild >= "3.10.0" & < "5.0"
  31. js_of_ocaml-ppx >= "3.8.0" & < "6.1.0"
  32. js_of_ocaml-ppx_deriving_json >= "3.7.1" & < "6.1.0"
  33. js_of_ocaml-toplevel >= "3.10.0" & < "6.1.0"
  34. js_of_ocaml-tyxml >= "3.10.0" & < "6.1.0"
  35. jsoo-react
  36. lablqml >= "0.7"
  37. landmarks-ppx
  38. lascar >= "0.7.0"
  39. learn-ocaml
  40. learn-ocaml-client
  41. lens >= "1.2.5"
  42. logs-ppx
  43. lwt_ppx >= "2.0.2" & < "5.9.2"
  44. melange = "1.0.0"
  45. melange-json >= "1.2.0" & < "2.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" & < "v0.16.0"
  50. neural_nets_lib < "0.6.0"
  51. noCanren >= "0.3.0~alpha1"
  52. node_of_ocaml
  53. nuscr >= "2.0.0"
  54. OCanren-ppx
  55. obus >= "1.2.5"
  56. ocaml-monadic >= "0.5"
  57. ocf_ppx
  58. ocsigen-i18n >= "4.0.0"
  59. ocsigen-ppx-rpc
  60. octez-internal-libs
  61. ojs_base_ppx
  62. ometrics = "0.2.0"
  63. ortac-core
  64. ortac-qcheck-stm
  65. ortac-wrapper
  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_cold < "v0.16.0"
  80. ppx_compare >= "v0.13.0" & < "v0.16.0"
  81. ppx_compose >= "0.2.1"
  82. ppx_const >= "2.0.1"
  83. ppx_conv_func >= "v0.13.0" & < "v0.16.0"
  84. ppx_counters
  85. ppx_css < "v0.16.0"
  86. ppx_cstruct >= "6.0.0"
  87. ppx_cstubs >= "0.6.1"
  88. ppx_csv_conv >= "v0.13.0" & < "v0.16.0"
  89. ppx_custom_printf >= "v0.14.1" & < "v0.16.0"
  90. ppx_decimal
  91. ppx_default
  92. ppx_defer >= "0.5.0"
  93. ppx_deriving >= "5.2" & < "6.0.2"
  94. ppx_deriving_cad
  95. ppx_deriving_decoders
  96. ppx_deriving_encoding >= "0.2"
  97. ppx_deriving_ezjsonm < "0.4.1"
  98. ppx_deriving_hardcaml >= "v0.13.0" & < "v0.16.0"
  99. ppx_deriving_hash < "0.1.3"
  100. ppx_deriving_jsonschema
  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_rpc
  106. ppx_deriving_scad
  107. ppx_deriving_variant_string
  108. ppx_deriving_yaml < "0.4.1"
  109. ppx_deriving_yojson = "3.7.0"
  110. ppx_disable_unused_warnings < "v0.16.0"
  111. ppx_distr_guards >= "0.3"
  112. ppx_dream_eml
  113. ppx_enumerate >= "v0.13.0" & < "v0.16.0"
  114. ppx_expect >= "v0.13.0" & != "v0.14.0" & < "v0.16.0"
  115. ppx_factory = "0.1.0" | >= "0.2.0"
  116. ppx_fail >= "v0.13.0"
  117. ppx_fields_conv >= "v0.14.2" & < "v0.16.0"
  118. ppx_fixed_literal < "v0.16.0"
  119. ppx_format
  120. ppx_fun
  121. ppx_gen_rec >= "2.0.0"
  122. ppx_getenv >= "2.1"
  123. ppx_hash >= "v0.13.0" & < "v0.16.0"
  124. ppx_here >= "v0.13.0" & < "v0.16.0"
  125. ppx_ignore_instrumentation < "v0.16.0"
  126. ppx_import < "1.8.0" | >= "1.10.0"
  127. ppx_inline_alcotest
  128. ppx_inline_test >= "v0.14.1" & < "v0.16.0"
  129. ppx_irmin >= "3.0.0"
  130. ppx_jane >= "v0.13.0" & < "v0.16.0"
  131. ppx_js_style >= "v0.13.0" & < "v0.16.0"
  132. ppx_jsobject_conv = "0.8.0" | >= "0.9.3" & < "0.21.1"
  133. ppx_jsonaf_conv < "v0.16.0"
  134. ppx_let >= "v0.13.0" & < "v0.16.0"
  135. ppx_log < "v0.16.0"
  136. ppx_lun
  137. ppx_make
  138. ppx_marshal
  139. ppx_marshal_ext
  140. ppx_matches
  141. ppx_minidebug < "2.3.0"
  142. ppx_module_timer >= "v0.13.0" & < "v0.16.0"
  143. ppx_monad
  144. ppx_mysql >= "1.1.3"
  145. ppx_open
  146. ppx_optcomp >= "v0.14.2" & < "v0.16.0"
  147. ppx_optint
  148. ppx_optional >= "v0.13.0" & < "v0.16.0"
  149. ppx_pattern_bind >= "v0.13.1" & < "v0.16.0"
  150. ppx_pipebang >= "v0.13.0" & < "v0.16.0"
  151. ppx_protocol_conv >= "5.1.3" & < "5.2.3"
  152. ppx_pyformat
  153. ppx_python = "v0.15.0"
  154. ppx_rapper
  155. ppx_rapper_async
  156. ppx_rapper_lwt
  157. ppx_regexp >= "0.5.1"
  158. ppx_repr >= "0.6.0"
  159. ppx_seq
  160. ppx_sexp_conv = "v0.15.1"
  161. ppx_sexp_message >= "v0.14.1" & < "v0.16.0"
  162. ppx_sexp_value >= "v0.13.0" & < "v0.16.0"
  163. ppx_show >= "0.2.0"
  164. ppx_stable >= "v0.14.1" & < "v0.16.0"
  165. ppx_string >= "v0.14.1" & < "v0.16.0"
  166. ppx_string_interpolation
  167. ppx_subliner
  168. ppx_system
  169. ppx_ts
  170. ppx_type_directed_value
  171. ppx_typed_fields < "v0.16.0"
  172. ppx_typerep_conv >= "v0.14.2" & < "v0.16.0"
  173. ppx_units
  174. ppx_variants_conv >= "v0.14.2" & < "v0.16.0"
  175. ppx_viewpattern < "0.1.1"
  176. ppx_xml_conv >= "v0.13.0" & < "v0.16.0"
  177. ppx_yojson >= "1.3.0"
  178. ppx_yojson_conv >= "v0.13.0" & < "v0.16.0"
  179. ppxx >= "2.5.0"
  180. qcow = "0.11.0"
  181. rdf_ppx < "1.0.0"
  182. refl >= "0.4.1"
  183. repr-fuzz >= "0.2.1"
  184. res_tailwindcss
  185. sedlex >= "2.6"
  186. server-reason-react
  187. speed
  188. spin >= "0.8.0"
  189. spoc_ppx
  190. stdint-literals
  191. stk_ppx
  192. togglelog
  193. toplevel_expect_test >= "v0.14.1" & < "v0.16.0"
  194. tyxml-jsx >= "4.5.0"
  195. tyxml-ppx >= "4.5.0"
  196. tyxml-syntax >= "4.5.0"
  197. validate
  198. visitors >= "20210608"
  199. wasm_of_ocaml-compiler < "6.1.0"
  200. wtr < "3.0.0"
  201. wtr-ppx
  202. xtmpl_ppx