Practice Clojure using Interactive Programming in your editor.
Welcome to the Rich Comment Form (RCF) port of 4Clojure! ❤️
- A repository that lets you learn and practice Clojure, directly from the comfort of a Clojure REPL enhanced editor. (From your web browser, With zero installs, if you like.)
- A ”copy” of the now closed 4clojure.com site. It served us so wonderfully well!
Anyway, if you have come here to practice Clojure, you are at the right place!
You solve programming problems using Clojure and your editor of choice. The problems are designed in increasing difficulty levels. You can use it to take your first baby steps in the language and also to hone your Clojure skills.
To get to where you can start solving problems there are basically two alternatives:
- Using Calva in your browser (Gitpod).
- Use your machine.
- With Calva
- With some other editor with Clojure abilities
This repository is prepared for Gitpod such that both the Clojure tools and Calva are installed.
That means you can start training Clojure like so by opening https://gitpod.io/#https://github.com/PEZ/rich4clojure in your web browser.
It sometimes takes quite a while (even 5+ minutes) for the environment to be prepared. Grab some coffee. 😄
Then you will see VS Code in your browser! And the instructions for how to use Rich 4Clojure will be opened for you. The instructions also contains information for what to do if you are new to Clojure and/or Calva.
Gitpod is a development environment that runs in your web browser. It uses VS Code. You can open any GitHub/GitLab/Bitbucket repository in the Gitpod development environment by prepending the repository URL with https://gitpod.io/#. That's how this repository's Gitpod URL is constructed:
https://gitpod.io/#https://github.com/pez/rich4clojure
See https://gitpod.io for the full story.
This option can be easy, if you have Java and the Clojure tools installed and you know how to work with Clojure projects in your editor. It can also be a bit cumbersome if you don't. (In this case, I suggest you use Gitpod first and have some fun with the 4Clojure problems before you invest the time to figure out how to install the things.)
Once you have Java and the Clojure tools installed:
- Clone this repo to your machine.
If you are using VS Code, install Calva and follow the same instructions as for the Gitpod option above, from step 2 and on.
If you are using some other editor:
- Open the project in your Clojure-enabled editor.
- Start the project REPL and connect it to your editor session.
- Load the file
dev/repl.cljc.- This will enable the test runner to run the problem tests that you find in each problem file.
- If you are using Calva Jack-in as per above, this will be done automatically for you.
- Open doc/INSTRUCTIONS.md to find out how to use Rich 4Clojure to practice Clojure.
The name, Rich 4Clojure, comes from the fact that it relies on Rich Comments and also uses a test utility called RCF which is building on the same philosophy. Also, reading it like ”rich forclosure”, haha (or something)!
This is an early version from a quite automated translation of the original problems. There'll be dragons. Please consider filing issues, starting discussions, or chat me up on the Clojurian's Slack (I'm @pez, there).
PR:s are also welcome. If it is the content of a particular problem you want to suggest changes for, edit the etc/problems.edn file.
I'll collect known/discovered quirks here if they are show stoppers.
The Gitpod option can fail installing (I know, the irony) the Calva extension if you have adblockers/etcetera active on the Gitpod site. See Issue #9 for clues and workarounds.
Consider starring ⭐ this repository, pretty please. 🙏
Please also consider contributing. Issues and pull requests are welcome. Right now the ”other editor” instructions can improve greatly, especially with Editor X configuration added to this repository. Please consider sending PRs with instructions and settings for your favorite editor.
The Discussions tab is also there for us to discuss both the project and solutions.
If you want to contrubute with problems, that is also super welcome. I suggest you start that with adding it as a suggestion in Discussions. Then, if we agree the problem should be added, add it as a PR to the etc/problems.edn file, and I will generate the files and gists from it. (Until I've set up a CI/CD pipeline.)
If you want to encourage my work with this project you are welcome to sponsor me:
- 4ever-clojure – A web based ”always up” copy of the original 4Clojure. It has listings of all working solutions that that were submitted to the original site.