How to hack on lem itself

How to Hack on lem Itself

There are two ways to hack/develop lem.(主に二つの方法があります。)

• Directly modify lem process behavior (エディタに直接変更を反映する)
• Start Swank on lem and connect from Swank client (other lem process or Emacs Slime) (lem上でサーバを起動し、別のlemやemacsのslimeから接続する)

In the first case, just open a file and edit. Any evaluated expressions would apply immediately. The disadvantage of this choice is the editing process and the editor process are the same process so if you break the process, the editor would be in an unstable state, and you may lose work because of this.

一つ目の方法はただlemを起動後、ファイルを開き,編集し,式を評価するだけで出来ます。 今編集に使っているエディタプロセスと反映されるプロセスが同じなので、壊れた場合に影響するプロセスが編集に使っているエディタである点に注意が必要です。

The second case, would start by following way:

二つ目の方法は次のやり方で始められます。 プロセスが二つにわかれているのでlemを壊した場合も安全に編集できます。

start Swank Server from lem (lem上でswankサーバを起動)

M-x start-lisp-repl
CL-USER> (swank:create-server :dont-close t)

Connect From Emacs or Other lem (emacsや別に起動したlemから接続する)

M-x slime-connect

Using this method, it is safe to break lem because the editing process is separate from the main lem process.

Notes

I (@svetlyak40wt) found, that when you do M-x start-lisp-repl, then you can just browse lem's sources, and hit C-c C-c on any definition, to change your lem's behaviour. No need to start a Swank server and to connect it from the separate Emacs.

Loading lem (into your Lisp image)

The project's instructions show how to load and run Lem with Roswell. Here's how we can do without, with a regular SBCL REPL and Quicklisp.

This was tested on LinuxMint 20, with SBCL 2.14 from Roswell and a recent enough Roswell Quicklisp dist (ros update quicklisp).

Clone the repository with git submodules:

git clone --recursive <url to lem>

lem uses an asd file for each of its submodules, so you can't compile the main lem.asd and quickload it. You need to set CL_SOURCE_REGISTRY=/path/to/lem// before starting the repl. Two slashes at the end tell ASDF to search asd files in subdirectories.

$ cd lem/
$ CL_SOURCE_REGISTRY=$(pwd)// rlwrap sbcl
* (asdf:load-asd "/path/to/lem.asd")
* (ql:quickload "lem")
[…]
* (lem:lem)
[… builds and runs the ncurses frontend …]

Load the SDL2 frontend:

* (ql:quickload "lem-sdl2")

To build a binary, see the following section.

Building lem

    ./bootstrap
    ./configure

and optionally

    make install

This creates a binary in the bin/ directory.

Running the tests

Compile and load "lem-tests.asd", then from the editor:

(rove:run :lem-tests)

and from the terminal:

ros install cxxxr/sblint fukamachi/rove
rove lem-tests.asd