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.22.2.tbz
sha256=d0e8a1ebdc6220b1574d7a926f008460c5118ccef79bf9a0ce0242f34cff225a
sha512=6010a59be6af873eaf193670f9cc8c9a7f091cfd89ec6c5b68d1f0c72d7c6015eec6371c009fc473cf2cb37d24f0934d04d0eacefa567a4945234197c3b31741

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: 24 Jun 2021

README

Ppxlib - Meta-programming for OCaml

User manual

Overview

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.

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 (7)

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

Conflicts

None