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.25.1.tbz
sha256=a51b3868029e62ff14a0f2bd8d278dacfc0c3fc5b22d484a296be90c53e4ffd7
sha512=6a6d9af49344e901cc9e6da7bcf38c2973705c8cee4cff1c64c0393e9ccc55a6abec1f58d5b56d0807939a3741bec722ee7bfc244f94619167a30438f182488a

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: 17 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. 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. commons
  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. fsml
  14. fstar >= "2021.06.06"
  15. GT >= "0.5.1"
  16. gen_js_api >= "1.0.6" & < "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.0"
  45. metaquot >= "0.5.0"
  46. mlt_parser = "v0.13.0" | >= "v0.14.1" & < "v0.16.0"
  47. neural_nets_lib
  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.3"
  53. ocaml-in-python
  54. ocaml-monadic >= "0.5"
  55. ocamlformat = "0.19.0~4.13preview"
  56. ocf_ppx
  57. ocsigen-i18n >= "4.0.0"
  58. ocsigen-ppx-rpc
  59. ojs_base_ppx
  60. ometrics >= "0.2.1"
  61. override = "0.2.2" | >= "0.4.0"
  62. pacomb
  63. pgocaml_ppx >= "4.3.0"
  64. pla >= "2.0"
  65. ppx-owl-opt
  66. ppx_accessor >= "v0.14.3" & < "v0.16.0"
  67. ppx_assert >= "v0.13.0" & < "v0.16.0"
  68. ppx_bap
  69. ppx_base >= "v0.13.0" & < "v0.16.0"
  70. ppx_bench >= "v0.14.1" & < "v0.16.0"
  71. ppx_bin_prot >= "v0.13.0" & < "v0.16.0"
  72. ppx_bitstring >= "4.1.0"
  73. ppx_blob >= "0.7.2"
  74. ppx_camlrack
  75. ppx_cold < "v0.16.0"
  76. ppx_compare >= "v0.13.0" & < "v0.16.0"
  77. ppx_compose >= "0.2.1"
  78. ppx_const >= "2.0.1"
  79. ppx_conv_func >= "v0.13.0" & < "v0.16.0"
  80. ppx_counters
  81. ppx_css < "v0.16.0"
  82. ppx_cstruct >= "6.0.0"
  83. ppx_cstubs >= "0.6.1"
  84. ppx_csv_conv >= "v0.13.0" & < "v0.16.0"
  85. ppx_custom_printf >= "v0.14.1" & < "v0.16.0"
  86. ppx_default
  87. ppx_defer >= "0.5.0"
  88. ppx_deriving >= "5.2"
  89. ppx_deriving_cad
  90. ppx_deriving_cmdliner >= "0.6.0"
  91. ppx_deriving_encoding >= "0.2"
  92. ppx_deriving_hardcaml >= "v0.13.0" & < "v0.16.0"
  93. ppx_deriving_hash
  94. ppx_deriving_jsoo >= "0.2"
  95. ppx_deriving_madcast >= "0.2"
  96. ppx_deriving_popper
  97. ppx_deriving_protobuf >= "3.0.0"
  98. ppx_deriving_qcheck
  99. ppx_deriving_rpc >= "8.1.0"
  100. ppx_deriving_scad
  101. ppx_deriving_yaml
  102. ppx_deriving_yojson = "3.6.1"
  103. ppx_disable_unused_warnings < "v0.16.0"
  104. ppx_distr_guards >= "0.3"
  105. ppx_dream_eml
  106. ppx_enumerate >= "v0.13.0" & < "v0.16.0"
  107. ppx_expect >= "v0.13.0" & != "v0.14.0" & < "v0.16.0"
  108. ppx_factory = "0.1.0" | >= "0.2.0"
  109. ppx_fail >= "v0.13.0"
  110. ppx_fields_conv >= "v0.14.2" & < "v0.16.0"
  111. ppx_fixed_literal < "v0.16.0"
  112. ppx_gen_rec >= "2.0.0"
  113. ppx_getenv >= "2.1"
  114. ppx_hash >= "v0.13.0" & < "v0.16.0"
  115. ppx_here >= "v0.13.0" & < "v0.16.0"
  116. ppx_ignore_instrumentation < "v0.16.0"
  117. ppx_import >= "1.7.0" & != "1.8.0" & < "1.10.0"
  118. ppx_inline_alcotest
  119. ppx_inline_test >= "v0.14.1" & < "v0.16.0"
  120. ppx_irmin >= "3.0.0"
  121. ppx_jane >= "v0.13.0" & < "v0.16.0"
  122. ppx_js_style >= "v0.13.0" & < "v0.16.0"
  123. ppx_jsobject_conv >= "0.8.0" & < "0.9.3"
  124. ppx_jsonaf_conv < "v0.16.0"
  125. ppx_let >= "v0.13.0" & < "v0.16.0"
  126. ppx_log < "v0.16.0"
  127. ppx_lun
  128. ppx_make
  129. ppx_matches
  130. ppx_minidebug < "1.0.0"
  131. ppx_module_timer >= "v0.13.0" & < "v0.16.0"
  132. ppx_monad
  133. ppx_mysql >= "1.1.3"
  134. ppx_open
  135. ppx_optcomp >= "v0.14.2" & < "v0.16.0"
  136. ppx_optint
  137. ppx_optional >= "v0.13.0" & < "v0.16.0"
  138. ppx_pattern_bind >= "v0.13.1" & < "v0.16.0"
  139. ppx_pipebang >= "v0.13.0" & < "v0.16.0"
  140. ppx_protocol_conv >= "5.1.3"
  141. ppx_pyformat
  142. ppx_python = "v0.15.0"
  143. ppx_rapper
  144. ppx_regexp >= "0.5.0"
  145. ppx_repr >= "0.6.0"
  146. ppx_seq
  147. ppx_sexp_conv >= "v0.14.3" & < "v0.15.1"
  148. ppx_sexp_message >= "v0.14.1" & < "v0.16.0"
  149. ppx_sexp_value >= "v0.13.0" & < "v0.16.0"
  150. ppx_show >= "0.2.0"
  151. ppx_stable >= "v0.14.1" & < "v0.16.0"
  152. ppx_string >= "v0.14.1" & < "v0.16.0"
  153. ppx_string_interpolation
  154. ppx_subliner
  155. ppx_system
  156. ppx_ts
  157. ppx_type_directed_value
  158. ppx_typed_fields < "v0.16.0"
  159. ppx_typerep_conv >= "v0.14.2" & < "v0.16.0"
  160. ppx_units
  161. ppx_variants_conv >= "v0.14.2" & < "v0.16.0"
  162. ppx_viewpattern
  163. ppx_xml_conv >= "v0.13.0" & < "v0.16.0"
  164. ppx_yojson >= "1.1.0" & < "1.3.0"
  165. ppx_yojson_conv >= "v0.13.0" & < "v0.16.0"
  166. ppxx >= "2.5.0"
  167. qcow >= "0.11.0"
  168. rdf_ppx < "1.0.0"
  169. refl >= "0.4.0"
  170. repr-fuzz >= "0.2.1"
  171. res_tailwindcss
  172. scaml < "1.2.0"
  173. sedlex >= "2.3" & < "2.6"
  174. server-reason-react
  175. spin >= "0.8.0"
  176. spoc_ppx
  177. stdint-literals
  178. togglelog
  179. toplevel_expect_test >= "v0.14.1" & < "v0.16.0"
  180. tyxml-jsx >= "4.5.0"
  181. tyxml-ppx >= "4.5.0"
  182. tyxml-syntax >= "4.5.0"
  183. visitors >= "20210608"
  184. wtr < "3.0.0"
  185. wtr-ppx
  186. xtmpl_ppx