One hurdle to getting started with developing a ppx rewriter for use in another project seems to be that there’s little guidance in terms of how to turn it into an installable package (I’ve seen materials refer to dune, essentially saying that you must know dune before writing a ppx rewriter). My i…

[image] sabine: My impression is that a ppx-rewriter “skeleton”/template/“hello world” repository would be very useful to quickly get started tinkering with ppx rewriters. The repository would contain an installable ppxlib-based ppx rewriter that does something trivial (like emitting “hello worl…

I created one for demo purposes that I have found people were happily using it: GitHub - ml-in-barcelona/ppxlib-simple-example: ppxlib simple example, minimal boilerplate to write a ppx. Using esy and alcotest for testing. It uses opam and it might be a little opinionated, but it’s small enough to …

Hi @sabine , if I understand you correctly, the examples folder on the ppxlib repo is what you’re looking for. It contains two different very very simple PPXs: one deriver and one extension point rewriter. So to see how the dune file for a very simple deriver looks like, you can go to the deriver’s d…

Btw, talking about troubles getting a PPX up and running: I’m interested in knowing what people mostly struggle with. @Gopiandcode , you’ve mentioned that hussle above. You’ve mentioned boilerplate. Were you referring to the PPX’s dune file? Or to registering the PPX (so e.g. in the case of a deriver…

Also, as both of you, @sabine and @Gopiandcode , have already indirectly mentioned: @panglesd has recently done and is currently doing an amazing job at improving the ppxlib documentation on different levels! :heart: For example, see the manual @sabine has linked to above. I recommend having a look a…

[image] pitag: Were you referring to the PPX’s dune file? The dune file configuration for ppxs is actually pretty straighforward - I just need to add an extra option to my stanzas and then I’m writing ppxs - this works really well. [image] pitag: Or were you referring to getting your hea…

Super stoked with all the great answers and I think they show how much has been happening behind the scenes and in places that my naive web and forum search didn’t properly reach! Thank you @davesnx for sharing your ppxlib example repo, this definitely gives me an idea how things should look like in…

A bit late to the party, but I also have a ppx-rewriter GitHub template: GitHub - johnyob/ppx-template: An opinionated GitHub template for OCaml PPX extensions 🐪 which I thought would be worth sharing. Like @davesnx mine is also a bit opinionated. It uses core (by default) and an automated version …

Is there a ppxlib template repository somewhere? Should there be?

Learning

hyphenrf January 13, 2023, 1:46pm 8

This doesn’t really answer you directly, but there was some help offered to me by ppxlib people here: Am I missing some comprehensive Ppxlib resource somewhere?

Topic		Replies	Views
Ppx by example - repo to help on ppx learning Learning announce , ppx	6	897	September 22, 2024
[ANN] ppxlib - Jane Street ppx infrastructure now on github Community announce , ppx	4	2653	April 18, 2018
The future of ppx Community ppx	19	15174	April 17, 2020
Problems compiling ppx package Learning opam , ppx , dune , ocaml-migrate-parset	8	1007	November 26, 2021
Am I missing some comprehensive Ppxlib resource somewhere? Ecosystem ppx , ppxlib	10	2343	July 2, 2025

Is there a ppxlib template repository somewhere? Should there be?

Related topics