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.24.0.tbz
sha256=7766027c2ecd0f5b3b460e9212a70709c6744278113eb91f317c56c41e7a90c8
sha512=726e48899c43f8bee1935618827e68b2953753a62868e424a2dadf2e156cc60794abacea658686a8a160eccde0f75b95b98daacf2b9242b4f86a92798d47b597

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: 10 Dec 2021

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