~severeoverfl0w/wedge-mise

wedge-mise/README.adoc -rw-r--r-- 1.5 KiB
787415cd — Dominic Monroe Bump TDA version 7 months ago
                                                                                
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
= Mise

A development environment for beginners to Clojure.
Dynamically loads functionality on the fly using tools.deps.alpha, so keeps it's dependency list very light.
Suitable for loading during development for beginners and experienced alike.

== Rationale

Getting started with Clojure can be overwhelming.
Over time, developers tend to craft themselves a "mise" of utilities to aid their development in Clojure.
By providing a mise to beginners, they have a starting point for developing their own mise later.

Additionally Mise should not interrupt experienced Clojure developers, so they will bring Mise into their projects regardless creating a jumping-off point for beginners to join their projects.

== Starting

=== Already started a REPL

[source]
----
=> (load "mise")
----

Usage information will be printed for you!

=== Don't have a REPL

Start a REPL from your terminal by typing:

// [source,shell]
// ----
// # clojure -M:wedge rebel
// ----
// 
// Or if you aren't using wedge

[source,shell]
----
# clojure -M -m io.dominic.wedge.mise.rebel
OR
# clojure -M:dev -m io.dominic.wedge.mise.rebel
----

You may pass the `--nrepl` flag to the main to start an nREPL server on port 5600 with common middleware loaded.
Use this is your editor asks you to connect to an nREPL server.

[source,shell]
----
# clojure -M -m io.dominic.wedge.mise.rebel --nrepl
----

== SLF4J Warnings

This should only happen if you don't have SLF4J loaded.
You can just add `org.slf4j/slf4j-nop {:mvn/version "1.7.30"}` during dev if you aren't using SLF4J.