lispython 0.4.5__tar.gz → 0.4.7__tar.gz

{lispython-0.4.5 → lispython-0.4.7}/.gitignore

@@ -332,4 +332,6 @@ GEMINI.md
 .worktrees/
 
 # Agent-generated docs (not mkdocs content)
-docs/superpowers/
+docs/superpowers/.stacks
+.agents
+.claude

{lispython-0.4.5 → lispython-0.4.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: lispython
-Version: 0.4.5
+Version: 0.4.7
 Summary: Lisp-like Syntax for Python with Lisp-like Macros
 Project-URL: Homepage, https://jetack.github.io/lispython
 Project-URL: Repository, https://github.com/jetack/lispython
@@ -85,25 +85,36 @@ lpy -m pytest
 LisPython ships with a language server (`lpy-lsp`) that speaks LSP over stdio. It provides:
 
 - Diagnostics (parse / compile errors)
-- Hover documentation for special forms
+- Completions (special forms, builtins, file/workspace symbols)
+- Hover documentation for special forms and builtins
 - Document symbols
 - Go-to-definition, including across `.lpy` files in the workspace
 
+## nREPL Server
+LisPython includes an nREPL server for REPL-driven development:
+
+```bash
+lpy --nrepl         # start on a random port
+lpy --nrepl 7888    # start on a specific port
+```
+
+The server accepts newline-delimited JSON over TCP and supports:
+- `eval` — evaluate LisPython code, return value/stdout/error
+- `load-file` — load a `.lpy` file into the session
+- `macroexpand` — expand macros and return the result
+- `complete` — prefix and dot-completion from the live scope
+- `docs` — signature and docstring for a symbol
+- `annotate` — type tag (function/class/module/macro)
+
 ### Editor setup
-Point your editor's LSP client at the `lpy-lsp` command for files with the `.lpy` extension. The server speaks LSP over stdio.
 
-#### VSCode
-Install the [LisPython](https://marketplace.visualstudio.com/items?itemName=jetack.vscode-lispython) extension from the VSCode Marketplace.
+#### VS Code
+Install the [LisPython](https://marketplace.visualstudio.com/items?itemName=jetack.vscode-lispython) extension. It connects to both LSP and nREPL automatically.
 
 #### Emacs
-Use [`lpy-mode`](https://github.com/jetack/lpy-mode) for syntax highlighting and LSP integration. For completion, install [`lpy-autocomplete`](https://github.com/jetack/lpy-autocomplete).
+Use [`lpy-mode`](https://github.com/jetack/lpy-mode). It provides nREPL integration (eval, completion, eldoc, macroexpand) and LSP via eglot.
 
 ## Todo
-### Environment
-- [ ] Test on more python versions
-- [ ] REPL should track history and arrow key navigation
-- [ ] REPL multi-line input support
-- [ ] Better compilation error messages
 ### Python AST
 - [ ] `type_comment` never considered. Later, it should be covered
 - [ ] Any missing AST nodes in the version 3.12+

{lispython-0.4.5 → lispython-0.4.7}/README.md

@@ -62,25 +62,36 @@ lpy -m pytest
 LisPython ships with a language server (`lpy-lsp`) that speaks LSP over stdio. It provides:
 
 - Diagnostics (parse / compile errors)
-- Hover documentation for special forms
+- Completions (special forms, builtins, file/workspace symbols)
+- Hover documentation for special forms and builtins
 - Document symbols
 - Go-to-definition, including across `.lpy` files in the workspace
 
+## nREPL Server
+LisPython includes an nREPL server for REPL-driven development:
+
+```bash
+lpy --nrepl         # start on a random port
+lpy --nrepl 7888    # start on a specific port
+```
+
+The server accepts newline-delimited JSON over TCP and supports:
+- `eval` — evaluate LisPython code, return value/stdout/error
+- `load-file` — load a `.lpy` file into the session
+- `macroexpand` — expand macros and return the result
+- `complete` — prefix and dot-completion from the live scope
+- `docs` — signature and docstring for a symbol
+- `annotate` — type tag (function/class/module/macro)
+
 ### Editor setup
-Point your editor's LSP client at the `lpy-lsp` command for files with the `.lpy` extension. The server speaks LSP over stdio.
 
-#### VSCode
-Install the [LisPython](https://marketplace.visualstudio.com/items?itemName=jetack.vscode-lispython) extension from the VSCode Marketplace.
+#### VS Code
+Install the [LisPython](https://marketplace.visualstudio.com/items?itemName=jetack.vscode-lispython) extension. It connects to both LSP and nREPL automatically.
 
 #### Emacs
-Use [`lpy-mode`](https://github.com/jetack/lpy-mode) for syntax highlighting and LSP integration. For completion, install [`lpy-autocomplete`](https://github.com/jetack/lpy-autocomplete).
+Use [`lpy-mode`](https://github.com/jetack/lpy-mode). It provides nREPL integration (eval, completion, eldoc, macroexpand) and LSP via eglot.
 
 ## Todo
-### Environment
-- [ ] Test on more python versions
-- [ ] REPL should track history and arrow key navigation
-- [ ] REPL multi-line input support
-- [ ] Better compilation error messages
 ### Python AST
 - [ ] `type_comment` never considered. Later, it should be covered
 - [ ] Any missing AST nodes in the version 3.12+

{lispython-0.4.5 → lispython-0.4.7}/docs/syntax/expressions.md

@@ -38,11 +38,11 @@ Python version
 expr1 == expr2 == expr3 == ...
 ```
 #### `>`
-Python version
+LisPy version
 ```python
 (> expr1 expr2 expr3 ...)
 ```
-LisPy version
+Python version
 ```python
 expr1 > expr2 > expr3 > ...
 ```

lispython-0.4.7/docs/usage/cli.md

@@ -0,0 +1,41 @@
+## REPL
+```shell
+lpy
+#or
+lpy -t #if you want to print python translation.
+```
+
+The REPL features Emacs-style keybindings (C-a, C-e, C-b, C-f, M-b, M-f, etc.), arrow key navigation, and persistent command history saved to `~/.lpy_history`.
+
+### Auto-closing pairs
+
+The REPL automatically inserts closing brackets and quotes when you type an opening one:
+
+| You type | REPL inserts | Cursor position |
+|----------|-------------|-----------------|
+| `(`      | `()`        | between `(` and `)` |
+| `[`      | `[]`        | between `[` and `]` |
+| `{`      | `{}`        | between `{` and `}` |
+| `'`      | `''`        | between the quotes |
+| `"`      | `""`        | between the quotes |
+
+- Typing a closing character (`)`, `]`, `}`) when the cursor is already before one will skip over it instead of inserting a duplicate.
+- Typing a quote (`'`, `"`) when the cursor is before the same quote will skip over it.
+- Pressing backspace between an empty pair deletes both characters.
+
+## Run from source
+```shell
+lpy {filename}.lpy
+```
+## Run translation
+```shell
+l2py {filename}.lpy
+```
+It just displays translation. (don't run it)
+## Run Tests (for development)
+```shell
+# in project root directory
+pytest
+#or
+lpy -m pytest
+```

{lispython-0.4.5 → lispython-0.4.7}/mkdocs.yml

@@ -1,6 +1,6 @@
 site_name: LisPython
 
-copyright: Copytright © 2023-2025 Jetack
+copyright: Copyright © 2023-2026 Jetack
 
 plugins:
   - macros:

{lispython-0.4.5 → lispython-0.4.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "lispython"
-version = "0.4.5"
+version = "0.4.7"
 description = "Lisp-like Syntax for Python with Lisp-like Macros"
 authors = [{ name = "Jetack", email = "jetack23@gmail.com" }]
 license = { text = "MIT" }

{lispython-0.4.5 → lispython-0.4.7}/src/lispy/core/compiler/expr.py

@@ -107,7 +107,8 @@ def ifexp_p(sexp):
 
 
 def ifexp_compile(sexp):
-    [_, test, body, orelse] = sexp.list
+    [_, test, body, *rest] = sexp.list
+    orelse = rest[0] if rest else Constant("None", **sexp.position_info)
     return ast.IfExp(
         test=expr_compile(test),
         body=expr_compile(body),

{lispython-0.4.5 → lispython-0.4.7}/src/lispy/core/macro.py

@@ -40,14 +40,19 @@ def define_macro(sexp, scope, include_meta=True):
 
 def require_macro(sexp, scope, include_meta=True):
     transformed = require_transform(sexp)
-    eval(
-        compile(
-            ast.Interactive(body=macroexpand_then_compile([transformed], include_meta=include_meta)),
-            "macro-requiring",
-            "single",
-        ),
-        scope,
-    )
+    try:
+        eval(
+            compile(
+                ast.Interactive(body=macroexpand_then_compile([transformed], include_meta=include_meta)),
+                "macro-requiring",
+                "single",
+            ),
+            scope,
+        )
+    except (ModuleNotFoundError, ImportError):
+        import sys
+        module_name = str(sexp.list[1])
+        print(f"l2py: warning: could not load macros from '{module_name}' (module not found)", file=sys.stderr)
     return transformed if include_meta else None
 
 

{lispython-0.4.5 → lispython-0.4.7}/src/lispy/core/nodes.py

@@ -369,7 +369,7 @@ class Symbol(Literal):
 
     @property
     def name(self):
-        return self.value.replace("-", "_")
+        return self.value.replace("->", "_to_").replace("-", "_").replace("?", "_p")
 
     def __repr__(self):
         return "Sym(" + self.value + ")"

{lispython-0.4.5 → lispython-0.4.7}/src/lispy/lsp/server.lpy

@@ -751,6 +751,85 @@
                     :range (make-range lineno 0 lineno 0))])))))
   (return None)))
 
+;; ---------------------------------------------------------------------------
+;; Completion
+;; ---------------------------------------------------------------------------
+
+(= _LPY-KEYWORDS
+   ["defn" "cond" "conde" "ife" "when" "unless"
+    "do" "deco" "require" "fn" "match" "case"
+    "async-def" "async-for" "async-with"
+    "yield-from" "except*"
+    "->" "->>" "as->"
+    "gensym" "pprint"])
+
+(deco (server.feature
+        lsp.TEXT_DOCUMENT_COMPLETION
+        (lsp.CompletionOptions :trigger-characters ["." "-"]))
+(def completion [ls params]
+  (= doc (.get-text-document ls.workspace params.text_document.uri))
+  (= pos params.position)
+  (= items [])
+  (= seen (set))
+
+  ;; 1. Special forms
+  (for name in SPECIAL-FORM-DOCS
+    (if (not (in name seen))
+        (do (seen.add name)
+            (items.append
+              (lsp.CompletionItem
+                :label name
+                :kind lsp.CompletionItemKind.Keyword
+                :detail "special form")))))
+
+  ;; 2. LisPython-specific keywords
+  (for name in _LPY-KEYWORDS
+    (if (not (in name seen))
+        (do (seen.add name)
+            (items.append
+              (lsp.CompletionItem
+                :label name
+                :kind lsp.CompletionItemKind.Keyword
+                :detail "keyword")))))
+
+  ;; 3. Python builtins
+  (for [name info] in (BUILTIN-INFO.items)
+    (if (not (in name seen))
+        (do (seen.add name)
+            (= kind (ife (isinstance (getattr builtins name None) type)
+                         lsp.CompletionItemKind.Class
+                         lsp.CompletionItemKind.Function))
+            (items.append
+              (lsp.CompletionItem
+                :label name
+                :kind kind
+                :detail (or (.get info "signature") ""))))))
+
+  ;; 4. Symbols from current file
+  (try
+    (= tree (parse doc.source))
+    (= defs (collect-definitions tree doc.uri))
+    (for name in defs
+      (if (not (in name seen))
+          (do (seen.add name)
+              (items.append
+                (lsp.CompletionItem
+                  :label name
+                  :kind lsp.CompletionItemKind.Variable)))))
+    (except [Exception] (pass)))
+
+  ;; 5. Workspace symbols
+  (for name in WORKSPACE-INDEX
+    (if (not (in name seen))
+        (do (seen.add name)
+            (items.append
+              (lsp.CompletionItem
+                :label name
+                :kind lsp.CompletionItemKind.Variable
+                :detail "workspace")))))
+
+  (return (lsp.CompletionList :is-incomplete False :items items))))
+
 (deco (server.feature lsp.TEXT_DOCUMENT_REFERENCES)
 (def references [ls params]
   (= doc (.get-text-document ls.workspace params.text_document.uri))

{lispython-0.4.5 → lispython-0.4.7}/src/lispy/macros/sugar.lpy

@@ -5,8 +5,8 @@
           (return `(if ~test ~then (cond ~@orelse))))))
 
 (defmacro conde [*body]
-  (if (< (len body) 4)
-      (return `(ife ~@body))
+  (if (<= (len body) 2)
+      (return (sub body -1))
       (do (= [test then *orelse] body)
           (return `(ife ~test ~then (conde ~@orelse))))))