https://github.com/sritchie/core.logic-koans

Learn core.logic with koans!
https://github.com/sritchie/core.logic-koans

Last synced: about 2 months ago
JSON representation

Learn core.logic with koans!

• Host: GitHub
• URL: https://github.com/sritchie/core.logic-koans
• Owner: sritchie
• Created: 2011-11-29T19:46:12.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2011-12-07T05:00:20.000Z (about 13 years ago)
• Last Synced: 2024-10-13T10:05:28.771Z (2 months ago)
• Language: Clojure
• Homepage: https://github.com/clojure/core.logic
• Size: 97.7 KB
• Stars: 58
• Watchers: 5
• Forks: 19
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• awesome-by-example - Core.logic Koans: Learn core.logic with koans!

README

        
# core.logic-koans

**CUSTOMIZE ME with some project specific details!**

Koans are a fun and easy way to learn a clojure project - no experience assumed or required.  Just follow the instructions below to start making tests 

### Getting Started

run `lein deps` in the project directory. This will download all dependencies you need to run the koans.

### Running the Koans

To run the koans, simply run:

`script/run` on Mac/\*nix

`script\run` on Windows

As you save your files with the correct answers, core.logic-koans will automatically advance you to the next koan or file.

When you execute `run` you'll see something like this:

    Problem in  /home/paduan/code/core.logic-koans/src/koans/equalities.clj

    ---------------------

    Assertion failed!

    We shall contemplate truth by testing reality, via equality.

    (= __ true)

The output is telling you that you have a failing test in `src/koans/equalities.clj`. Open that file up and make it pass!  In general, you just fill in the blanks to make tests pass.  Sometimes there are several (or even an infinite number) of correct answers: any of them will work in these cases.

The koans differ from normal TDD in that the tests are already written for you, so you'll have to pay close attention to the failure messages, because up until the very end, making a test pass just means that the next failure message comes up.

While it might be easy (especially at first) to just fill in the blanks making things pass, you should work thoughtfully, making sure you understand why the answer is what it is.  Enjoy your path to enlightenment!

### Trying more things out

core.logic-koans comes with a REPL (Read-Evaluate-Print Loop).

`script/repl` on Mac/\*nix

`script\repl` on Windows

Here are some interesting commands you might try once you've got the REPL running:

    (find-doc "vec")

    (find-doc #"vec$")

    (doc vec)

And if those still don't make sense:

    (doc doc)

    (doc find-doc)

will show you what those commands mean.

You can exit the REPL with `CTRL-d` on any OS.

### License

Copyright (C) 2011 FIXME

Distributed under the Eclipse Public License, the same as Clojure.