package ppxlib

Build not checked
  1. Overview
  2. Docs
Standard infrastructure for ppx rewriters

Install

dune-project
 Dependency

Authors

Maintainers

Sources

ppxlib-0.33.0.tbz
sha256=ffa44ef551f23b75e21dbd698a30310431381aaf140b9fe4b81c2e70a2d2c63a
sha512=cd865efc78e85d662fab3d05de7675a46252a241db44cbf13a930017c6890da5f161fbf8511b97abd9d61bffca0cb84b3adf580b55a3820afdb4a2337e9a4a63

Description

Ppxlib is the standard infrastructure 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.

Added to opam-repository:

README

Ppxlib - Meta-programming for OCaml

ocaml-ci status trunk-build-status AppVeyor status

Ppxlib 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 constructing 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 documentation.

What is the relation between ppxlib and other ppx libraries?

The ppx world has a long and storied 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 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.3.0"
  6. dune >= "2.7"

Dev Dependencies (5)

  1. odoc with-doc
  2. cinaps with-test & >= "v0.12.1"
  3. re with-test & >= "1.9.0"
  4. ocamlfind with-test
  5. sexplib0 with-test & >= "v0.15"

Optional Dependencies

None

  1. arrayjit < "0.6.0"
  2. awsm-codegen
  3. bam-ppx < "0.4"
  4. base_quickcheck != "v0.14.0" & < "v0.17.1"
  5. bisect_ppx >= "2.8.3"
  6. bistro
  7. bonsai >= "v0.16.0"
  8. brisk-reconciler
  9. bytestring
  10. chatoyant
  11. clangml >= "4.7.0"
  12. cmdlang-to-base < "0.0.11"
  13. comby < "1.3.0"
  14. commons
  15. config
  16. crs < "0.0.20260307"
  17. diff
  18. dream-html >= "3.9.5" & < "3.11.2"
  19. dune = "3.17.2"
  20. ego
  21. eliom >= "8.9.0" & < "12.0.0"
  22. elpi
  23. embedded_ocaml_templates < "0.3.1" | >= "0.7"
  24. extunix >= "0.3.1" & < "0.4.4"
  25. flow_parser >= "0.229.1"
  26. frama-c >= "32.0~beta"
  27. fsml
  28. fstar >= "2025.02.17" & < "2025.06.20"
  29. GT = "0.5.1" | >= "0.5.3" & < "0.5.5"
  30. gen_js_api < "1.0.8" | >= "1.1.1" & < "1.1.6"
  31. gendarme >= "0.4.1"
  32. goblint >= "2.5.0"
  33. gospel >= "0.2.0" & < "0.3.1"
  34. graphql_ppx >= "1.2.2"
  35. hack_parallel
  36. hardcaml >= "v0.14.1" & < "v0.17.1"
  37. hegel >= "0.24.1"
  38. html_of_jsx >= "0.0.2" & < "0.1.1"
  39. http_async
  40. js_of_ocaml >= "3.8.0" & < "6.1.0" | >= "6.4.0"
  41. js_of_ocaml-compiler >= "3.8.0" & < "6.1.0" | >= "6.4.0"
  42. js_of_ocaml-lwt >= "3.10.0" & < "6.1.0"
  43. js_of_ocaml-ocamlbuild >= "3.10.0" & < "5.0"
  44. js_of_ocaml-ppx >= "3.8.0" & < "6.1.0" | >= "6.4.0"
  45. js_of_ocaml-ppx_deriving_json < "6.1.0" | >= "6.4.0"
  46. js_of_ocaml-toplevel >= "3.10.0" & < "6.1.0" | >= "6.4.0"
  47. js_of_ocaml-tyxml >= "3.10.0" & < "6.1.0"
  48. jsoo-react
  49. lablqml
  50. landmarks-ppx < "1.6"
  51. lascar >= "0.7.0"
  52. learn-ocaml
  53. learn-ocaml-client
  54. lens >= "1.2.5"
  55. logs-ppx
  56. lwt_ppx >= "2.0.2" & < "5.9.2"
  57. MlFront_Cli >= "2.1.4~prerel2" & < "2.3.1"
  58. MlFront_Config
  59. MlFront_Manip
  60. melange >= "1.0.0" & < "6.0.1-51"
  61. melange-json >= "1.2.0"
  62. melange-json-native
  63. merlin >= "4.7-412"
  64. metapp >= "0.4.4"
  65. metaquot >= "0.5.0"
  66. mlt_parser != "v0.14.0"
  67. mlx < "0.11"
  68. mutaml < "0.4"
  69. neural_nets_lib < "0.6.0"
  70. noCanren
  71. node_of_ocaml
  72. nuscr >= "2.0.0"
  73. OCanren-ppx
  74. obus >= "1.2.5"
  75. ocaml-monadic >= "0.5"
  76. ocamlmerlin-mlx < "0.11"
  77. ocf_ppx < "1.0.0"
  78. ocgtk < "0.1~preview2"
  79. ocsigen-i18n >= "4.0.0"
  80. ocsigen-ppx-rpc < "1.1"
  81. ojs_base_ppx < "0.9.0"
  82. ometrics = "0.2.0"
  83. ortac-core < "0.8.0"
  84. ortac-qcheck-stm < "0.8.0"
  85. ortac-wrapper < "0.8.0"
  86. pacomb < "1.4.3"
  87. pancake
  88. pgocaml_ppx >= "4.3.0"
  89. pla >= "2.0"
  90. polymarket >= "0.2.0"
  91. ppx-owl-opt
  92. ppx_accessor >= "v0.14.3"
  93. ppx_assert
  94. ppx_bap
  95. ppx_base
  96. ppx_bench >= "v0.15.1" & < "v0.17.1"
  97. ppx_bin_prot < "v0.17.1"
  98. ppx_bin_there
  99. ppx_bitstring = "4.1.0"
  100. ppx_blob >= "0.7.2"
  101. ppx_camlrack
  102. ppx_catch
  103. ppx_cold
  104. ppx_compare
  105. ppx_compose >= "0.2.1"
  106. ppx_const >= "2.0.1"
  107. ppx_conv_func
  108. ppx_counters
  109. ppx_css
  110. ppx_cstruct >= "6.0.0"
  111. ppx_cstubs >= "0.6.1"
  112. ppx_csv_conv
  113. ppx_custom_printf >= "v0.14.1"
  114. ppx_decimal
  115. ppx_default
  116. ppx_defer >= "0.5.0"
  117. ppx_demo
  118. ppx_derive_at_runtime < "v0.17.1"
  119. ppx_deriving >= "5.2" & < "6.1.0"
  120. ppx_deriving_cad
  121. ppx_deriving_decoders
  122. ppx_deriving_encoding >= "0.2"
  123. ppx_deriving_ezjsonm < "0.4.1"
  124. ppx_deriving_hardcaml
  125. ppx_deriving_hash < "0.1.3"
  126. ppx_deriving_json_schema
  127. ppx_deriving_jsonschema < "0.0.7"
  128. ppx_deriving_jsoo >= "0.2"
  129. ppx_deriving_madcast >= "0.2"
  130. ppx_deriving_popper
  131. ppx_deriving_protobuf
  132. ppx_deriving_rpc < "10.0.0"
  133. ppx_deriving_scad
  134. ppx_deriving_variant_string
  135. ppx_deriving_yaml < "0.4.1"
  136. ppx_deriving_yojson >= "3.7.0" & < "3.10.0"
  137. ppx_devtools-expect
  138. ppx_devtools-optcomp
  139. ppx_diff < "v0.17.1"
  140. ppx_disable_unused_warnings
  141. ppx_distr_guards >= "0.3"
  142. ppx_dream_eml
  143. ppx_embed_file
  144. ppx_enforce
  145. ppx_enumerate
  146. ppx_expect != "v0.14.0" & < "v0.17.3"
  147. ppx_expect_nobase = "v0.17.2.2"
  148. ppx_factory >= "0.2.0"
  149. ppx_fail
  150. ppx_fields_conv >= "v0.14.2"
  151. ppx_fixed_literal
  152. ppx_forbid
  153. ppx_format
  154. ppx_fun
  155. ppx_gen_rec >= "2.0.0"
  156. ppx_getenv >= "2.1"
  157. ppx_globalize < "v0.17.2"
  158. ppx_hardcaml < "v0.17.1"
  159. ppx_hash
  160. ppx_hegel_compat
  161. ppx_hegel_generator
  162. ppx_hegel_test
  163. ppx_here
  164. ppx_ignore_instrumentation
  165. ppx_import < "1.8.0" | = "1.11.0"
  166. ppx_inline_alcotest
  167. ppx_inline_test >= "v0.15.1" & < "v0.17.1"
  168. ppx_inline_test_nobase < "v0.17.0.3"
  169. ppx_interact < "0.2.0"
  170. ppx_irmin >= "3.0.0"
  171. ppx_jane
  172. ppx_js_style < "v0.17.1"
  173. ppx_jsobject_conv != "0.9.0" & < "0.21.1"
  174. ppx_jsonaf_conv >= "v0.15.1" & < "v0.17.1"
  175. ppx_let < "v0.17.1"
  176. ppx_log
  177. ppx_lun < "0.0.2"
  178. ppx_make
  179. ppx_map
  180. ppx_marshal
  181. ppx_marshal_ext
  182. ppx_matches
  183. ppx_mica
  184. ppx_minidebug < "2.3.0"
  185. ppx_mixins
  186. ppx_module_timer
  187. ppx_monad
  188. ppx_monoid >= "0.3.3"
  189. ppx_mysql >= "1.1.3"
  190. ppx_open
  191. ppx_optcomp >= "v0.14.2" & < "v0.17.1"
  192. ppx_optint
  193. ppx_optional
  194. ppx_parser < "0.2.1"
  195. ppx_partial
  196. ppx_pattern_bind < "v0.17.1"
  197. ppx_pipebang
  198. ppx_protocol_conv >= "5.1.3" & < "5.2.3"
  199. ppx_pyformat
  200. ppx_python >= "v0.15.0"
  201. ppx_quick_test < "v0.17.1"
  202. ppx_rapper < "1.0.1"
  203. ppx_regexp = "0.5.1"
  204. ppx_repr >= "0.6.0" & < "0.8.0"
  205. ppx_seq
  206. ppx_sexp_conv >= "v0.15.1" & < "v0.17.1"
  207. ppx_sexp_message >= "v0.14.1"
  208. ppx_sexp_value
  209. ppx_show
  210. ppx_stable >= "v0.14.1" & < "v0.17.1"
  211. ppx_stable_witness
  212. ppx_string >= "v0.14.1"
  213. ppx_string_conv
  214. ppx_string_interpolation
  215. ppx_subliner
  216. ppx_system
  217. ppx_trace < "0.11"
  218. ppx_ts
  219. ppx_tydi < "v0.17.1"
  220. ppx_type_directed_value
  221. ppx_typed_fields < "v0.17.1"
  222. ppx_typerep_conv >= "v0.14.2" & < "v0.17.1"
  223. ppx_units
  224. ppx_update
  225. ppx_variants_conv >= "v0.14.2" & < "v0.17.1"
  226. ppx_viewpattern < "0.1.1"
  227. ppx_xml_conv
  228. ppx_yojson >= "1.3.0"
  229. ppx_yojson_conv >= "v0.15.1" & < "v0.17.1"
  230. ppxlib_jane < "v0.17.3"
  231. ppxx >= "2.5.0"
  232. pyro-caml-ppx
  233. qcow < "0.12.1"
  234. quint-connect
  235. rdf_ppx
  236. reactjs-jsx-ppx
  237. reason >= "3.9.0" & < "3.16.0"
  238. reason-react-day-picker
  239. reason-react-ppx < "0.17.0"
  240. refl >= "0.4.1"
  241. repr-fuzz >= "0.2.1" & < "0.8.0"
  242. res_tailwindcss
  243. rescript-syntax
  244. sedlex >= "2.6"
  245. serde_derive
  246. server-reason-react >= "0.2.0" & < "0.4.1"
  247. spectrum_palette_ppx
  248. speed
  249. spin >= "0.8.0"
  250. spoc_ppx
  251. stdint-literals
  252. stk_ppx
  253. streamable < "v0.17.1"
  254. styled-ppx < "0.61.0"
  255. togglelog
  256. toplevel_expect_test >= "v0.14.1"
  257. tyxml-jsx >= "4.5.0" & < "5.0.0"
  258. tyxml-ppx >= "4.5.0" & < "5.0.0"
  259. tyxml-syntax >= "4.5.0" & < "5.0.0"
  260. validate
  261. visitors >= "20210608" & < "20251010"
  262. vlt
  263. volgo < "0.0.21"
  264. volgo-base
  265. volgo-git-backend < "0.0.21"
  266. volgo-git-eio < "0.0.21"
  267. volgo-git-unix < "0.0.21"
  268. volgo-hg-backend < "0.0.21"
  269. volgo-hg-eio < "0.0.21"
  270. volgo-hg-unix < "0.0.21"
  271. volgo-vcs < "0.0.21"
  272. wasm_of_ocaml-compiler < "6.1.0" | >= "6.4.0"
  273. wtr < "3.0.0"
  274. wtr-ppx
  275. xtmpl_ppx < "1.2.0"

Conflicts (4)

  1. base-effects
  2. ocaml-variants = "5.1.0~alpha1+options"
  3. ocaml-base-compiler = "5.1.0~alpha1"
  4. ocaml-migrate-parsetree < "2.0.0"

Build status

Results of building ppxlib with each compiler on check.ci.ocaml.org, run of against opam-repository 8d8d144. All results for this package.

Each result links to its build log. To keep crawlers from overloading the site, build logs require a GitHub sign-in (see ocurrent/opam-health-check). On your first log, GitHub asks you to “Authorize opam-health-check”, the OCurrent app that runs these checks; it sees only your public profile, not your repositories. The sign-in lasts 30 days.

This version is not in the latest run; the versions below are.

Version OCaml 4.11 OCaml 4.14 OCaml 5.2 OCaml 5.4 OCaml 5.5
0.39.0 good good good good good
  • good Package successfully built
  • partial One of the dependencies failed to build
  • bad Package failed to build
  • n/a Package is not available in this environment
  • internal Internal failure