This project is still in early development, feel free to contribute more tests! It’s usable in it’s current state but is pretty unforgiving, the tests need to be tweaked to make them a little more leniant on some things I think, I’ll see.
A test suite to check a given Clojure prepl server for compliance as I’ve defined in Clojure prepl for tool authors.
Tool authors are beginning to add prepl servers to their projects (shadow-cljs!) but it’s not a documented technology and it’s full of small nuances. I’ve been hacking on prepls for well over a year now so I’m trying to capture that knowledge in a program that others can use to catch inconsistencies before they become issues raised by your users.
My goal for this project is to provide an easy way for someone implementing a prepl server to check that they’re in line with all of the other implementations. That isn’t to say even the official prepl servers from Clojure and ClojureScript are 100% correct yet, there’s even inconsistencies there! This framework will hopefully give us a good starting point for talking about and improving prepls in the Clojure world.
These tests are the ideal scenario, it’ll take a while for us all to get there.
The easiest way to use this tool for now is to clone the repository and execute it from the source. You could refer to it as a git dependency in your deps.edn and execute prepl-compliance-test.main/-main but that seems kind of unnecessary to me.
Start the prepl server you wish to check, you could start one for Clojure or ClojureScript quite easily with Propel. Refer to REPLing into projects with prepl and Propel for more information of starting prepls of various kinds.
You can start a baseline example server by executing scripts/baseline.sh. This is a regular Clojure prepl server but it’ll serve as a decent example.
Once that’s up we can execute the test suite against it like so:
scripts/run.sh localhost 33945Where 33945 is the port the baseline server was started on. Change these arguments to whatever you’ve configured for your prepl server.
If you’d like to add more tests to this suite (please do!) you can start the development prepl with scripts/dev.sh, I then connect to this with my own Neovim tooling, Conjure.
You could also just run scripts/run.sh repeatedly until you have the desired result. If you wish to use nREPL to develop this project, feel free to add the configuration required. I haven’t added it because I don’t use nREPL based tooling but I have nothing against it being added.
Find the full unlicense in the UNLICENSE file, but here’s a snippet.
This is free and unencumbered software released into the public domain.
Anyone is free to copy, modify, publish, use, compile, sell, or distribute this software, either in source code form or as a compiled binary, for any purpose, commercial or non-commercial, and by any means.