lispython 0.3.3__tar.gz → 0.4.1__tar.gz

{lispython-0.3.3 → lispython-0.4.1}/.gitignore

@@ -321,4 +321,15 @@ tags
 
 poetry.lock
 **test.hy
-**temp*
+**temp*
+
+# AI agent instructions (per-user, not committed)
+AGENTS.md
+CLAUDE.md
+GEMINI.md
+
+# Git worktrees
+.worktrees/
+
+# Agent-generated docs (not mkdocs content)
+docs/superpowers/

lispython-0.4.1/.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "lispython.lsp.pythonPath": "/home/user/workspace/lispython/.venv/bin/python"
+}

lispython-0.4.1/PKG-INFO

@@ -0,0 +1,111 @@
+Metadata-Version: 2.4
+Name: lispython
+Version: 0.4.1
+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
+Author-email: Jetack <jetack23@gmail.com>
+License: MIT
+License-File: LICENSE.md
+Requires-Python: >=3.11
+Requires-Dist: pygls>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pre-commit>=3.6.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Requires-Dist: toml>=0.10.2; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: mike>=2.1.3; extra == 'docs'
+Requires-Dist: mkdocs-macros-plugin>=1.3.7; extra == 'docs'
+Requires-Dist: mkdocs-material>=9.6.14; extra == 'docs'
+Description-Content-Type: text/markdown
+
+# LisPython
+[![PyPI version](https://badge.fury.io/py/lispython.svg)](https://badge.fury.io/py/lispython)
+
+LisPython is a Lisp-flavored syntax for Python with Lisp-style macros. Source files (`.lpy`) are transpiled to Python and executed on the standard CPython runtime.
+
+## Documentation
+Full documentation lives at [https://jetack.github.io/lispython/](https://jetack.github.io/lispython/).
+
+## Quick Start
+```lisp
+(import math)
+
+(def area [r]
+  (return (* math.pi (** r 2))))
+
+(print (area 3))
+```
+```bash
+lpy example.lpy
+```
+
+## Installation
+### Using pip
+```bash
+pip install lispython
+```
+
+### Manual Installation (for development)
+```bash
+uv sync # install dependencies
+uv pip install -e . # for development
+```
+
+## How to Run LisPython code
+### Run from source
+```bash
+lpy {filename}.lpy
+```
+
+### Run REPL
+```bash
+lpy
+# or
+lpy -t # if you want to print python translation.
+```
+
+### Show translation
+```bash
+l2py {filename}.lpy
+```
+Prints the translated Python to stdout. It does not execute the code.
+
+### Run Tests
+```bash
+# in project root directory
+pytest
+# or
+lpy -m pytest
+```
+
+## LSP Server
+LisPython ships with a language server (`lpy-lsp`) that speaks LSP over stdio. It provides:
+
+- Diagnostics (parse / compile errors)
+- Hover documentation for special forms
+- Document symbols
+- Go-to-definition, including across `.lpy` files in the workspace
+
+### 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.
+
+#### 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).
+
+## Todo
+### Environment
+- [ ] Test on more python versions
+- [ ] REPL should track history and arrow key navigation
+- [ ] REPL multi-line input support
+- [ ] Better compilation error messages
+### Macro System
+- [ ] `as->` macro for syntactic sugar
+- [ ] `gensym` for avoiding name collision
+### Python AST
+- [ ] `type_comment` never considered. Later, it should be covered
+- [ ] Any missing AST nodes in the version 3.12+

lispython-0.4.1/README.md

@@ -0,0 +1,89 @@
+# LisPython
+[![PyPI version](https://badge.fury.io/py/lispython.svg)](https://badge.fury.io/py/lispython)
+
+LisPython is a Lisp-flavored syntax for Python with Lisp-style macros. Source files (`.lpy`) are transpiled to Python and executed on the standard CPython runtime.
+
+## Documentation
+Full documentation lives at [https://jetack.github.io/lispython/](https://jetack.github.io/lispython/).
+
+## Quick Start
+```lisp
+(import math)
+
+(def area [r]
+  (return (* math.pi (** r 2))))
+
+(print (area 3))
+```
+```bash
+lpy example.lpy
+```
+
+## Installation
+### Using pip
+```bash
+pip install lispython
+```
+
+### Manual Installation (for development)
+```bash
+uv sync # install dependencies
+uv pip install -e . # for development
+```
+
+## How to Run LisPython code
+### Run from source
+```bash
+lpy {filename}.lpy
+```
+
+### Run REPL
+```bash
+lpy
+# or
+lpy -t # if you want to print python translation.
+```
+
+### Show translation
+```bash
+l2py {filename}.lpy
+```
+Prints the translated Python to stdout. It does not execute the code.
+
+### Run Tests
+```bash
+# in project root directory
+pytest
+# or
+lpy -m pytest
+```
+
+## LSP Server
+LisPython ships with a language server (`lpy-lsp`) that speaks LSP over stdio. It provides:
+
+- Diagnostics (parse / compile errors)
+- Hover documentation for special forms
+- Document symbols
+- Go-to-definition, including across `.lpy` files in the workspace
+
+### 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.
+
+#### 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).
+
+## Todo
+### Environment
+- [ ] Test on more python versions
+- [ ] REPL should track history and arrow key navigation
+- [ ] REPL multi-line input support
+- [ ] Better compilation error messages
+### Macro System
+- [ ] `as->` macro for syntactic sugar
+- [ ] `gensym` for avoiding name collision
+### Python AST
+- [ ] `type_comment` never considered. Later, it should be covered
+- [ ] Any missing AST nodes in the version 3.12+

{lispython-0.3.3 → lispython-0.4.1}/docs/macros.md

@@ -54,4 +54,42 @@ Just change `def` in function definition to `defmacro`. And macros usually retur
           (return `(-> ~f ~@rest)))
       (return `(-> (~f ~x) ~@rest))))
 ```
-You can find more in `src/lispython/macros/sugar.lpy`.
+You can find more in `src/lispython/macros/sugar.lpy`.
+
+## gensym
+`gensym` generates unique symbols to avoid variable name collisions in macros. It is automatically available inside `defmacro` bodies.
+
+```python
+(gensym)          ;; => Symbol("__gensym_0")
+(gensym "tmp")    ;; => Symbol("__tmp_1")
+(gensym 'tmp)     ;; => Symbol("__tmp_2")  (also accepts a quoted Symbol)
+```
+
+The prefix can be a string or a symbol. Each call increments a global counter, so every generated symbol is unique.
+
+### Why gensym?
+Without `gensym`, a macro that introduces a local variable can accidentally shadow a variable in the caller's scope:
+```python
+;; BAD: if the caller has a variable named `tmp`, this breaks
+(defmacro broken-swap [a b]
+  (return `(do (= tmp ~a)
+               (= ~a ~b)
+               (= ~b tmp))))
+```
+
+Using `gensym` prevents this:
+```python
+(defmacro swap [a b]
+  (= tmp (gensym "tmp"))
+  (return `(do (= ~tmp ~a)
+               (= ~a ~b)
+               (= ~b ~tmp))))
+```
+
+Now `(swap x y)` expands to something like:
+```python
+__tmp_0 = x
+x = y
+y = __tmp_0
+```
+The generated name `__tmp_0` won't collide with user variables.

lispython-0.4.1/docs/usage/getting-started.md

@@ -0,0 +1,20 @@
+# Getting Started
+## Simple Web REPL
+You can try LisPy without installing at
+[https://jetack.github.io/lispy-web/](https://jetack.github.io/lispy-web/).
+## Installation
+### Using pip
+```bash
+pip install lispython
+```
+### Manual Installation (for development)
+```bash
+uv sync # install dependencies
+uv pip install -e . # for development
+```
+#### uv
+I recommend using [uv](https://docs.astral.sh/uv/) for development.
+It manages the virtual environment and dependencies from `pyproject.toml` / `uv.lock` automatically.
+```bash
+uv run lpy # run commands inside the project environment
+```

{lispython-0.3.3 → lispython-0.4.1}/pyproject.toml

@@ -1,12 +1,12 @@
 [project]
 name = "lispython"
-version = "0.3.3"
+version = "0.4.1"
 description = "Lisp-like Syntax for Python with Lisp-like Macros"
 authors = [{ name = "Jetack", email = "jetack23@gmail.com" }]
 license = { text = "MIT" }
 readme = "README.md"
 requires-python = ">=3.11"
-dependencies = []
+dependencies = ["pygls>=1.0.0"]
 
 [project.urls]
 Homepage = "https://jetack.github.io/lispython"
@@ -15,6 +15,7 @@ Repository = "https://github.com/jetack/lispython"
 [project.scripts]
 lpy = "lispy:run"
 l2py = "lispy:l2py"
+lpy-lsp = "lispy.lsp:main"
 test = "pytest:main"
 
 [project.optional-dependencies]

lispython-0.4.1/src/lispy/core/builtins.py

@@ -0,0 +1,19 @@
+from lispy.core.nodes import Symbol
+
+_gensym_counter = 0
+
+
+def gensym(prefix="gensym"):
+    global _gensym_counter
+    if isinstance(prefix, Symbol):
+        prefix = prefix.name
+    elif not isinstance(prefix, str):
+        raise TypeError(f"gensym prefix must be a Symbol or string, got {type(prefix).__name__}")
+    sym = Symbol("__" + prefix + "_" + str(_gensym_counter))
+    _gensym_counter += 1
+    return sym
+
+
+def reset_gensym_counter():
+    global _gensym_counter
+    _gensym_counter = 0

{lispython-0.3.3 → lispython-0.4.1}/src/lispy/core/meta_functions.py

@@ -9,6 +9,7 @@ def defmacro_transform(sexp):
     return Paren(
         Symbol("do"),
         Paren(Symbol("from"), Symbol("lispy.core.nodes"), Symbol("*")),
+        Paren(Symbol("from"), Symbol("lispy.core.builtins"), Symbol("*")),
         Paren(Symbol("def"), newname, *body),
         Paren(
             Symbol("="),

{lispython-0.3.3 → lispython-0.4.1}/src/lispy/core_meta_functions.lpy

@@ -6,10 +6,11 @@
 (from lispy.core.nodes *)
 
 (def defmacro-transform [sexp]
-  (= [op macroname *body] sexp.list) 
+  (= [op macroname *body] sexp.list)
   (= macroname (str macroname))
   (= newname (Symbol (+ "___defmacro_temp___" macroname)))
   (return `(do (from lispy.core.nodes *)
+               (from lispy.core.builtins *)
                (def ~newname ~@body)
                (= (sub (.setdefault (globals) "__macro_namespace" {})
                        ~macroname)

lispython-0.4.1/src/lispy/lsp/__init__.py

@@ -0,0 +1,6 @@
+import lispy  # register .lpy import hook
+from lispy.lsp.server import server
+
+
+def main():
+    server.start_io()

lispython-0.4.1/src/lispy/lsp/__main__.py

@@ -0,0 +1,3 @@
+from lispy.lsp import main
+
+main()