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
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
# incomplete
A simple Clojure library providing code completion.
The library was extracted from nREPL's codebase and
aims to replace [clojure-complete](https://github.com/ninjudd/clojure-complete).
`incomplete`'s name refers to its basic nature and modest goals.
It doesn't aim to compete with the gold standard for completion [compliment](https://github.com/alexander-yakushev/compliment).
## Rationale
`clojure-complete` has several long-standing bugs and hasn't seen much love in recent years.
Still, the project is extremely popular due to its simplicity and the fact that it's
bundled with tools like Leiningen and REPLy.
`incomplete` started its life inside nREPL, as the provider of nREPL's built-in code
completion, but I decided it might be a useful standalone library as well.
It sits somewhere between `clojure-complete` and `compliment` in the sense that it has
more features (and less bugs) than the former, and it's much simpler and less capable than the
latter.
Here's a list of the `incomplete`'s advantages over `clojure-complete`:
* better completion of Java instance and static members
* keyword completion in Clojure
* candidate metadata (useful for tool authors)
* cleaner codebase (subjective, of course)
The long term goal for the project is to replace `clojure-complete` in REPLy and Leiningen.
## Usage
You need only one function from incomplete's API - `completions`.
``` clojure
(require 'incomplete.core)
;; var completion
(completions "map")
({:candidate "map", :type :function}
{:candidate "map-entry?", :type :function}
{:candidate "map-indexed", :type :function}
{:candidate "map?", :type :function}
{:candidate "mapcat", :type :function}
{:candidate "mapv", :type :function})
;; ns completion
(completions "incomplete.co")
({:candidate "incomplete.core", :type :namespace}
{:candidate "incomplete.core-test", :type :namespace})
;; keyword completion
(completions ":v")
({:candidate ":val", :type :keyword}
{:candidate ":valf", :type :keyword}
{:candidate ":valid", :type :keyword}
{:candidate ":validator", :type :keyword}
{:candidate ":value", :type :keyword}
{:candidate ":var", :type :keyword}
{:candidate ":var-form", :type :keyword}
{:candidate ":var-name", :type :keyword}
{:candidate ":var-params", :type :keyword}
{:candidate ":var-query", :type :keyword}
{:candidate ":varargs", :type :keyword}
{:candidate ":vector", :type :keyword}
{:candidate ":vector-long", :type :keyword}
{:candidate ":verbose", :type :keyword}
{:candidate ":verbose?", :type :keyword}
{:candidate ":version-string", :type :keyword}
{:candidate ":versions", :type :keyword}
{:candidate ":via", :type :keyword}
{:candidate ":volatile", :type :keyword}
{:candidate ":volatile-mutable", :type :keyword})
;; static method completion
(completions "Integer/re")
({:candidate "Integer/remainderUnsigned", :type :static-method}
{:candidate "Integer/reverse", :type :static-method}
{:candidate "Integer/reverseBytes", :type :static-method})
;; instance method completion
(completions ".to")
({:candidate ".toBinaryString", :type :method}
{:candidate ".toChars", :type :method}
{:candidate ".toCodePoint", :type :method}
{:candidate ".toDegrees", :type :method}
{:candidate ".toHexString", :type :method}
{:candidate ".toIntExact", :type :method}
{:candidate ".toLowerCase", :type :method}
{:candidate ".toOctalString", :type :method}
{:candidate ".toRadians", :type :method}
{:candidate ".toString", :type :method}
{:candidate ".toTitleCase", :type :method}
{:candidate ".toUnsignedInt", :type :method}
{:candidate ".toUnsignedLong", :type :method}
{:candidate ".toUnsignedString", :type :method}
{:candidate ".toUpperCase", :type :method})
```
By default the function operates on the current ns (`*ns*`), but you
can also specify an explicit namespace.
``` clojure
(completions "ma" 'clojure.core)
```
## License
Copyright © 2021 Bozhidar Batsov
This program and the accompanying materials are made available under the
terms of the Eclipse Public License 2.0 which is available at
http://www.eclipse.org/legal/epl-2.0.
This Source Code may also be made available under the following Secondary
Licenses when the conditions for such availability set forth in the Eclipse
Public License, v. 2.0 are satisfied: GNU General Public License as published by
the Free Software Foundation, either version 2 of the License, or (at your
option) any later version, with the GNU Classpath Exception which is available
at https://www.gnu.org/software/classpath/license.html.
|
