Slyblime

by s-clerc ALL

Interactive Lisp IDE with REPL, Inspector, Debugger and more for Sublime Text 4.

Labels lisp, auto-complete, REPL, references

Details

Version 0.4.2
Homepage github.com
Issues github.com
Modified 4 years ago
Last Seen 1 hour ago
First Seen 4 years ago

Installs

Total 614
Win 201
Mac 193
Linux 220

	Dec 22	Dec 21	Dec 20	Dec 19	Dec 18	Dec 17	Dec 16	Dec 15	Dec 14	Dec 13	Dec 12	Dec 11	Dec 10	Dec 9	Dec 8	Dec 7	Dec 6	Dec 5	Dec 4	Dec 3	Dec 2	Dec 1	Nov 30	Nov 29	Nov 28	Nov 27	Nov 26	Nov 25	Nov 24	Nov 23	Nov 22	Nov 21	Nov 20	Nov 19	Nov 18	Nov 17	Nov 16	Nov 15	Nov 14	Nov 13	Nov 12	Nov 11	Nov 10	Nov 9	Nov 8
Windows	0	0	0	1	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	1	0	0	0	0	0	0	0	0	0	0	0	0	0
Mac	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0
Linux	0	0	1	0	0	0	0	0	1	0	0	0	1	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	0	1	3	0	0	0	0	0	0	0	0	0

Readme

Source: raw.githubusercontent.com

___           ___       ___           ___           ___                   ___           ___     
     /\  \         /\__\     |\__\         /\  \         /\__\      ___        /\__\         /\  \    
    /::\  \       /:/  /     |:|  |       /::\  \       /:/  /     /\  \      /::|  |       /::\  \   
   /:/\ \  \     /:/  /      |:|  |      /:/\:\  \     /:/  /      \:\  \    /:|:|  |      /:/\:\  \  
  _\:\~\ \  \   /:/  /       |:|__|__   /::\~\:\__\   /:/  /       /::\__\  /:/|:|__|__   /::\~\:\  \ 
 /\ \:\ \ \__\ /:/__/        /::::\__\ /:/\:\ \:|__| /:/__/     __/:/\/__/ /:/ |::::\__\ /:/\:\ \:\__\
 \:\ \:\ \/__/ \:\  \       /:/~~/~    \:\~\:\/:/  / \:\  \    /\/:/  /    \/__/~~/:/  / \:\~\:\ \/__/
  \:\ \:\__\    \:\  \     /:/  /       \:\ \::/  /   \:\  \   \::/__/           /:/  /   \:\ \:\__\  
   \:\/:/  /     \:\  \    \/__/         \:\/:/  /     \:\  \   \:\__\          /:/  /     \:\ \/__/  
    \::/  /       \:\__\                  \::/__/       \:\__\   \/__/         /:/  /       \:\__\    
     \/__/         \/__/                   ~~            \/__/                 \/__/         \/__/

Slyblime is Sylvester the Cat's Common Lisp IDE for Sublime Text 4:

Slyblime is an implementation of SLY and uses the same backend (SLYNK).

Currently it includes:

REPL integration including backtracking
Autocomplete and documentation
References, disassembly, macroexpansion etc.
Inspection support
Tracing support
Compilation support with notes
Multiple connexions
Debugger including stack frame inspection
NEW! Ability to open an inferior Lisp directly from the editor!

The primary missing feature is the ability to use stickers from Sly.

Installation

First install SublimeREPL and this plugin. Use Package Control to install them, or download and unzip the plugins in your packages folder. Then type Sly: Upgrade SublimeREPL to work with Sly into the command palette. Finally, to get started just run Sly: Start and connect to an inferior Lisp instance in the command palette (you may need to change the default lisp program in the settings).

Obligatory animated GIFs section

Flex Completion

Backreferences

Usage

Make sure to install SublimeREPL (via Package Control) and then running Sly: Upgrade SublimeREPL to work with Sly into the command palette before attempting to use Slyblime!

Using an inferior Lisp

Go to the settings and set the inferior lisp command to what you want (by default it's lisp). After that run Sly: Start and connect to an inferior Lisp instance to start a inferior lisp and REPL.

External connexion

To connect to a Slynk instance run Sly: Connect to slynk using the command palette. Make sure to use the included Lisp+ syntax for all the features to work correctly.

Pathname translation

To use pathname translation, create file Sublime Text/Packages/User/slyblime/filename_translators.py. Then at the top add from slyblime.filename_translation import *. A pathname translator is any class definition which extends the (slyblime.filename_translation.)PathnameTranslator abstract class as follows:

class PathnameTranslator():
    # Tells Slyblime if the translator should be offered for the current connexion
    def is_active(self, session: SlynkSession) -> bool
    def local_to_remote(self, pathname: str) -> str
    def remote_to_local(self, pathname: str) -> str
    # A two line description of the translator for the selection menu
    description: Tuple[str, str]
``` For most cases, it is preferable to use extend the (`slyblime.filename_translation.`)`SimpleTranslator` abstract class:

```python
class SimpleTranslator(PathnameTranslator):
    local_stem:str
    remote_stem:str
    def is_active(self, session: SlynkSession) -> bool
``` where a bijection is created such that path "`local_stem`/*A*" ≃ "`remote_stem`/*A*".

## Developping

The recommended way to develop is to clone this repo somewhere, then symlink the `src` folder to the Sublime packages folder and symlink the `sly` submodule folder into the `src` folder. While this may seem convolouted, this allows almost all files to remain toplevel in the package folder which means that Sublime Text will reload them upon modification, speeding up editing speed.

## Copying

See [COPYING.md](COPYING.md), but tl;dr GPL.

## Contributing

Open an issue or a pull request.