https://github.com/lantiga/ki

lisp + mori, sweet.js
https://github.com/lantiga/ki

Last synced: 1 day ago
JSON representation

lisp + mori, sweet.js

• Host: GitHub
• URL: https://github.com/lantiga/ki
• Owner: lantiga
• License: mit
• Created: 2014-01-12T21:51:03.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2018-05-28T20:39:20.000Z (over 6 years ago)
• Last Synced: 2024-11-06T03:43:43.402Z (8 days ago)
• Language: JavaScript
• Homepage: ki-lang.org
• Size: 585 KB
• Stars: 478
• Watchers: 23
• Forks: 29
• Open Issues: 14
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        

# ki

**lisp + mori, sweet.js**

![ki](http://ki-lang.org/images/ki-color.svg)

See [ki-lang.org](http://ki-lang.org) for more information or [try ki](http://ki-lang.org/editor/editor.html) straight in your browser.

ki is a lisp with Clojure data structures and semantics that can be intermixed with Javascript code at any level.

ki is a thin macro layer on top of [mori](https://github.com/swannodette/mori) plus a few constructs.

ki is in flux, feel free to test it out but expect glitches.

## Currently available functions / special forms

All of [mori](https://github.com/swannodette/mori).

The following list of functions / special forms

```

[] {} [$ ] {$ } add and apply atom bind catch chain cond def defmethod defmulti 

defn deref div do doto eq falsey finally fn fnth geq gt if ifNot js leq letc 

let lt loop mod mul neq nil not ns or prn recur reset str sub swap threadf 

threadl truthy try use when whenNot while 

```

Plus destructuring and source maps.

Take a look at the [tests](https://github.com/lantiga/ki/blob/master/test/core.js) to keep up with the latest additions.

## Examples

Require ki (this in turns expands into an appropriate require for mori)

```

ki require core

```

Mori's persistent data structures and Clojure(Script)-like api at your fingertips

```js

var foo = ki (vector 1 2 3)

ki (conj foo 4)

// => [1 2 3 4]

```

Plus lambdas

```js

ki (map (fn [a] (inc a)) (range 5))

// => (1 2 3 4 5)

```

Interoperability: write js in a ki form

```js

var fn1 = ki (js function (a,b) { return a + b + 2; })

```

at any level - e.g. you can use infix where it makes sense

```js

var fn2 = ki (fn [a b] (js a + b + 2))

```

and you can use ki wherever in js code

```js

function somefunc (a) {

  ki (toJs (filter (fn [el] (isEven el)) (range a))).forEach(function(el) {

      console.log(el);

      });

  return [0, 1, 2, 3, 4].filter(ki (fn [el] (isEven el)));

}

console.log(somefunc(5));

// => 0 

// => 2 

// => 4 

// [0 2 4]

```

Like a pro

```js

ki (take 6 (map (fn [x] (js x * 2)) (range 1000)))

// => (0 2 4 6 8 10)

```

## Get it

    $ npm install -g ki

All set. Now to compile a JavaScript file containing ki code into a plain JavaScript file do

    $ ki -o foo_build.js foo.js

To watch the file and have it automatically compiled whenever the file changes on disk

    $ ki -w -o foo_build.js foo.js

## License

MIT license http://www.opensource.org/licenses/mit-license.php/

Copyright (C) 2014-2015 Luca Antiga http://lantiga.github.io