Magic (ed) is a tiny editing facility for Common Lisp, where you can directly load, edit, manipulate and evaluate file or file content from REPL.
I find myself often running the REPL for various things but lazy enough to engage Emacs/SLIME when I need just a small edit: I'm a UNIX guy and I got used to start vi/vim/emacsclient for writing small throw-away programs.
This package also can be a starting point for people who are not accustomed to Emacs or SLIME and would like to continue using their default terminal/console editor with Common Lisp.
Quickinstall and start
Install via Quicklisp, which updates distro about once a month.
For simple editing from the REPL, launch your system configured EDitor
For the daily updates track, install via Ultralisp. You can also install manually. See instructions for other installation options and use below.
You start it with:
and it will start editor assigned to EDITOR environment variable. When you are done with editing, save it and quit: magic-ed will load that file and evaluate it. If file saving somehow failed, nothing will be evaluated.
In background, magic-ed will try to use (ed) standard function and will try to obey implementation specific features. For example, in SBCL, if sb-ext:*ed-functions* was set, magic-ed will not use environment value.
If you do not want edited file to be evaluated, you use :eval parameter like:
(magic-ed:magic-ed "/tmp/test.lisp" :eval nil)
and file will be only saved. Also, if you would like file content to be returned as escaped string, use :output parameter (accepts only :file and :string):
(setf content (magic-ed:magic-ed "/tmp/test.lisp" :output :string))
First setup EDITOR environment variable to point to your favorite editor (on *nix, often nano or vi, distribution dependent config and change) and download magic-ed code via Quicklisp, Ultralisp, or manually (clone it from this repository).
Ultralisp via Quicklisp
Magic-ed is available on Ultralisp. Ultralisp updates more often than Quicklisp, so this install is recommended.
Manual download or via Quicklisp
Do an update of the QL database and install:
(ql:update-dist "quicklisp") (ql:quickload "magic-ed")
Download or git clone magic-ed to Your quicklisp directory manually
( usually ~/quicklisp/local-projects/ )
For example, execute in terminal:
cd ~/quicklisp/local-projects/ git clone https://github.com/sanel/magic-ed
Then, launch Your Common Lisp of choice and in the REPL:
Automatic loading on REPL start with Quicklisp
Update Your Common Lisp configuration, adding the following line to the same file responcible for loading quicklisp on start.
In SBCL: edit Your ~/.sbclrc and add to the end, after ql lines:
The magic-ed code was tested on SBCL, ECL, Clozure CL and CMUCL.
Copyright (c) 2013-2020 Sanel Zukan. You can use this code however you like, in accordance with the MIT license.