code.consxy.com Git - clnl/blob - README.md

   1 # clnl
   2
   3 This is an experiment at creating an alternate implementation of NetLogo mainly as an exercise for me so that I come to understand NetLogo better.  It is true for me that I only truly understand something when I can explain it to someone else without repetition.  In code, this manifests as expressing a program in another language.
   4
   5 See the [wiki](https://github.com/frankduncan/clnl/wiki) for more information at this time.
   6
   7 # Building
   8
   9 If you'd like to build it, you're going to need a few things:
  10
  11 * An implementation of sbcl with threads enabled
  12 * The following common lisp libraries (included in deps/tarpit folder)
  13   * cl-opengl
  14   * alexandria
  15   * babel
  16   * cffi
  17   * ironclad
  18   * mt19937
  19   * nibbles
  20   * trivial-features
  21   * style-checker
  22   * docgen
  23 * rlwrap
  24
  25 # Running
  26
  27 bin/nl has been added for convenience to run the netlogo instance.  Currently it bombs if you try to do anything to expressive with it.  A good test is
  28
  29 ```
  30 crt 10
  31 ask turtles [ fd 1 ]
  32 show random 5
  33 ```
  34
  35 If you'd like to run using your own sbcl instance, you can attach the clnl.asd file wherever you link asd files, and then use:
  36
  37 ```lisp
  38 (asdf:load-system :clnl)
  39 (sb-thread:make-thread #'clnl-interface:run)
  40 (clnl:run)
  41 ```
  42
  43 # Testing
  44
  45 If you'd like to see the tests go on your system, there's a number of utilities to look at:
  46
  47 * bin/test.lisp
  48 * bin/diagnose-test
  49 * bin/diagnose-view-test
  50 * bin/test-mode