[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[nongnu] elpa/inf-clojure b87c5fb 215/313: update instructions to setup
From: |
ELPA Syncer |
Subject: |
[nongnu] elpa/inf-clojure b87c5fb 215/313: update instructions to setup lumo repl (#147) |
Date: |
Wed, 11 Aug 2021 10:00:20 -0400 (EDT) |
branch: elpa/inf-clojure
commit b87c5fb0d4b9ed7df607a4abc7bd4f9cd7d044bf
Author: Priyatam Mudivarti <priyatam@gmail.com>
Commit: Andrea Richiardi <a.richiardi.work@gmail.com>
update instructions to setup lumo repl (#147)
thanks @arichiardi!
---
README.md | 52 +++++++++++++++++++++++++++++++++++++++++-----------
1 file changed, 41 insertions(+), 11 deletions(-)
diff --git a/README.md b/README.md
index 9e5d448..018ffe5 100644
--- a/README.md
+++ b/README.md
@@ -28,7 +28,7 @@ Clojure(Script) development:
* Support for Lumo
* Support for Planck
-For a more powerful/full-featured solution see [CIDER][].
+For a more powerful/full-featured solution see
[CIDER](https://github.com/clojure-emacs/cider).
## Installation
@@ -62,22 +62,26 @@ Add the following to your Emacs config to enable
(add-hook 'clojure-mode-hook #'inf-clojure-minor-mode)
```
-**Don't enable `inf-clojure-minor-mode` and `cider-mode` at the same
-time. They have overlapping functionality and keybindings and the
-result will be nothing short of havoc.**
+**Don't enable `inf-clojure-minor-mode` and `cider-mode` at the same time. They
+have overlapping functionality and keybindings and the result will be nothing
+short of havoc.**
## Usage
Just invoke `M-x inf-clojure` or press `C-c C-z` within a Clojure source file.
This will start a REPL process for the current project and you can start
-interacting with it.
+interacting with it. By defaul this will look for `lein` command on the path.
+
+For configuring other repls, read below.
`inf-clojure` has several custom variables which control the command used to
-start a REPL for particular project type - `inf-clojure-lein-cmd`,
-`inf-clojure-boot-cmd`, `inf-clojure-tools-deps-cmd` and
-`inf-clojure-generic-cmd`. The `inf-clojure-project-type` can force a
-particular project type, skipping the project detection, which can be useful
-for projects that don't have standard layouts.
+start a REPL for particular project type - `inf-clojure-lein-cmd` (lein),
+`inf-clojure-boot-cmd` (boot), `inf-clojure-tools-deps-cmd` (clj cli) and
+`inf-clojure-generic-cmd` (lumo).
+
+The `inf-clojure-project-type` can force a particular project type, skipping
the
+project detection, which can be useful for projects that don't have standard
+layouts.
By default all those variables are set to strings (e.g. `lein repl`).
However, it is possible to use a cons pair like `("localhost" . 5555)`
@@ -167,6 +171,32 @@ or the following to your [Emacs init file][]:
The socket server REPL configuration options are described
[here](https://dev.clojure.org/display/design/Socket+Server+REPL).
+#### Lumo Socket REPL
+
+For lumo, setup a generic command in `init.el` to start the socket repl (say,
port 5555)
+
+```el
+(setq inf-clojure-repl-use-same-window nil)
+(setq inf-clojure-generic-cmd '("localhost" 5555))
+```
+
+Then start lumo repl, like so:
+
+```bash
+lumo -n 5555
+```
+
+If you want to use lumo with Clojure devtools
+[dependencies](https://clojure.org/guides/deps_and_cli) without lein or boot,
+add a `deps.edn` in the project root and run this command:
+
+```bash
+lumo -c `clj -Spath` -n 5555
+```
+
+You can use `M-x inf-clojure-connect` (`C-c M-c`) to connect to a running
+socket-repl. You will be prompted for host and port.
+
#### Caveats
Note that if you decide _NOT_ to use the socket repl, it is highly recommended
@@ -301,7 +331,7 @@ For example, you can use the following command (assuming
`cp` contains
the classpath) in your `.dir-locals.el`:
```el
-((nil . (eval . (setq inf-clojure-boot-cmd (concat "lumo -d -c "
+((nil . (eval . (setq inf-clojure-generic-cmd (concat "lumo -d -c "
(f-read (concat
(inf-clojure-project-root) "cp")))))))
```
- [nongnu] elpa/inf-clojure f4478ad 183/313: Fix and reword docstring, (continued)
- [nongnu] elpa/inf-clojure f4478ad 183/313: Fix and reword docstring, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure d4010db 190/313: Add @ (deref) and ^ to the expression breaking chars, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure 37b30be 157/313: Bind C-c M-c to inf-clojure-connect, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure 49b8c4b 159/313: Restyle inf-clojure-log-activity output, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure 21d3e97 171/313: Bump the development version to 2.1.0-snapshot, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure 39e794c 168/313: Protect against empty commands, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure ae43e2e 178/313: [Fix #113] Send REPL string always, even if empty, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure c4adc89 181/313: Introduce inf-clojure-completions-fn defcustom, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure 6c719c6 197/313: Avoid leaking buffers from inf-clojure--process-response, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure 5aa9c15 212/313: Add clojure socket REPL command and tweak, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure b87c5fb 215/313: update instructions to setup lumo repl (#147),
ELPA Syncer <=
- [nongnu] elpa/inf-clojure 16455ab 224/313: Fix typo in inf-clojure--joker-repl-form (#163), ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure 975e580 222/313: Fix CircleCI badge in README, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure 173d0e7 228/313: Bump the development version, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure 80cefbb 244/313: API to update repl-features, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure 3e7ca33 248/313: Add lein and boot to the startup-forms, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure 1c8429a 247/313: Bump the development version, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure 5abac0b 262/313: Tweak the REPL type documentation, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure 6f4e792 065/313: Add a note about mixing cider & inf-clojure, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure c797a5a 143/313: Release inf-clojure 2.0, ELPA Syncer, 2021/08/11
- [nongnu] elpa/inf-clojure 0bb2700 156/313: Introduce inf-clojure-log-activity, ELPA Syncer, 2021/08/11