https://github.com/joaotavora/sly-macrostep

Expand CL macros inside source files
https://github.com/joaotavora/sly-macrostep

Last synced: about 2 months ago
JSON representation

Expand CL macros inside source files

• Host: GitHub
• URL: https://github.com/joaotavora/sly-macrostep
• Owner: joaotavora
• Created: 2016-01-18T12:26:51.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2019-12-11T17:18:27.000Z (almost 5 years ago)
• Last Synced: 2024-06-15T15:33:46.478Z (3 months ago)
• Language: Emacs Lisp
• Homepage:
• Size: 324 KB
• Stars: 28
• Watchers: 4
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
[![MELPA](http://melpa.org/packages/sly-macrostep-badge.svg)](http://melpa.org/#/sly-macrostep)

[![Build Status](https://travis-ci.org/capitaomorte/sly-macrostep.svg?branch=master)](https://travis-ci.org/capitaomorte/sly-macrostep)

# [`macrostep`][1] support for SLY

`sly-macrostep` is a [SLY][sly] contrib for expanding CL macros right

inside the source file, like so:

![animation](animation.gif)

This extension is the work of [Jon Oddie](github.com/joddie), the

original author of the excellent [`macrostep.el`][1] library, and

[Luís Oliveira](github.com/luismbo).

I just ported it to SLY with some minimal renaming and tweaks.

## Install from MELPA

Perform the [usual MELPA setup](http://melpa.org) and then select

`sly-macrostep` for installation from the package menu or from `M-x

package-install`.

Once it's done, `M-x sly` should now bring up a macrostep-enabled

SLY.

In `.lisp` files you can now use `C-c M-e` or `M-x macrostep-expand`

to expand a macro.

## Melpa-less install

Since this is an external contrib with both Elisp and Lisp parts,

merely loading the Elisp will have little effect. The contrib has to

be registered in SLY's `sly-contribs` variable for SLY to take care of

loading the Lisp side on demand.

For convenience, the `sly-macrostep-autoloads` file takes care

of this automatically. So the following setup in your `~/.emacs` or

`~/.emacs.d/init/el` init file should be enough:

```elisp

;;; regular SLY setup

(setq inferior-lisp-program "/path/to/your/preferred/lisp")

(add-to-list 'load-path "/path/to/sly")

(require 'sly-autoloads)

(add-to-list 'load-path "/path/to/john-oddies-macrostep-library")

(add-to-list 'load-path "/path/to/sly-macrostep")

(require 'sly-macrostep-autoloads)

```

In case you already have SLY loaded and running, you might have to

`M-x sly-setup` and `M-x sly-enable-contrib` to enable it.

[1]: https://github.com/joddie/macrostep

[sly]: https://github.com/capitaomorte/sly