lispython 0.2.1__tar.gz → 0.3.1__tar.gz

lispython-0.3.1/.claude/settings.local.json

@@ -0,0 +1,11 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(mike set-default:*)",
+      "Bash(uv run python:*)",
+      "Bash(uv run pytest:*)"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

lispython-0.3.1/.gitignore

@@ -0,0 +1,324 @@
+
+# Created by https://www.gitignore.io/api/vim,emacs,python,pycharm,visualstudiocode
+# Edit at https://www.gitignore.io/?templates=vim,emacs,python,pycharm,visualstudiocode
+
+### Emacs ###
+# -*- mode: gitignore; -*-
+*~
+\#*\#
+/.emacs.desktop
+/.emacs.desktop.lock
+*.elc
+auto-save-list
+tramp
+.\#*
+
+# Org-mode
+.org-id-locations
+*_archive
+
+# flymake-mode
+*_flymake.*
+
+# eshell files
+/eshell/history
+/eshell/lastdir
+
+# elpa packages
+/elpa/
+
+# reftex files
+*.rel
+
+# AUCTeX auto folder
+/auto/
+
+# cask packages
+.cask/
+dist/
+
+# Flycheck
+flycheck_*.el
+
+# server auth directory
+/server/
+
+# projectiles files
+.projectile
+
+# directory configuration
+.dir-locals.el
+
+# network security
+/network-security.data
+
+
+### PyCharm ###
+# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and WebStorm
+# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
+
+# User-specific stuff
+.idea
+.idea/**/workspace.xml
+.idea/**/tasks.xml
+.idea/**/usage.statistics.xml
+.idea/**/dictionaries
+.idea/**/shelf
+
+# Generated files
+.idea/**/contentModel.xml
+
+# Sensitive or high-churn files
+.idea/**/dataSources/
+.idea/**/dataSources.ids
+.idea/**/dataSources.local.xml
+.idea/**/sqlDataSources.xml
+.idea/**/dynamic.xml
+.idea/**/uiDesigner.xml
+.idea/**/dbnavigator.xml
+
+# Gradle
+.idea/**/gradle.xml
+.idea/**/libraries
+
+# Gradle and Maven with auto-import
+# When using Gradle or Maven with auto-import, you should exclude module files,
+# since they will be recreated, and may cause churn.  Uncomment if using
+# auto-import.
+# .idea/modules.xml
+# .idea/*.iml
+# .idea/modules
+
+# CMake
+cmake-build-*/
+
+# Mongo Explorer plugin
+.idea/**/mongoSettings.xml
+
+# File-based project format
+*.iws
+
+# IntelliJ
+out/
+
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Cursive Clojure plugin
+.idea/replstate.xml
+
+# Crashlytics plugin (for Android Studio and IntelliJ)
+com_crashlytics_export_strings.xml
+crashlytics.properties
+crashlytics-build.properties
+fabric.properties
+
+# Editor-based Rest Client
+.idea/httpRequests
+
+# Android studio 3.1+ serialized cache file
+.idea/caches/build_file_checksums.ser
+
+### PyCharm Patch ###
+# Comment Reason: https://github.com/joeblau/gitignore.io/issues/186#issuecomment-215987721
+
+# *.iml
+# modules.xml
+# .idea/misc.xml
+# *.ipr
+
+# Sonarlint plugin
+.idea/sonarlint
+
+### Python ###
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+sandbox.ipynb # to update manually
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+### Python Patch ###
+.venv/
+
+### Vim ###
+# Swap
+[._]*.s[a-v][a-z]
+[._]*.sw[a-p]
+[._]s[a-rt-v][a-z]
+[._]ss[a-gi-z]
+[._]sw[a-p]
+
+# Session
+Session.vim
+
+# Temporary
+.netrwhist
+# Auto-generated tag files
+tags
+# Persistent undo
+[._]*.un~
+
+### VisualStudioCode ###
+.vscode
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+
+### VisualStudioCode Patch ###
+# Ignore all local history of files
+.history
+
+### C++ ###
+# Prerequisites
+*.d
+
+# Compiled Object files
+*.slo
+*.lo
+*.o
+*.obj
+
+# Precompiled Headers
+*.gch
+*.pch
+
+# Compiled Dynamic libraries
+*.so
+*.dylib
+*.dll
+
+# Fortran module files
+*.mod
+*.smod
+
+# Compiled Static libraries
+*.lai
+*.la
+*.a
+*.lib
+
+# Executables
+*.exe
+*.out
+*.app
+
+# End of https://www.gitignore.io/api/vim,emacs,python,pycharm,visualstudiocode
+
+poetry.lock
+**test.hy
+**temp*

lispython-0.3.1/.pre-commit-config.yaml

@@ -0,0 +1,22 @@
+# See https://pre-commit.com for more information
+# See https://pre-commit.com/hooks.html for more hooks
+repos:
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+    -   id: trailing-whitespace
+    -   id: end-of-file-fixer
+    -   id: check-yaml
+    -   id: check-added-large-files
+
+-   repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.0
+    hooks:
+      - id: ruff
+        args: ["--fix"]
+      - id: ruff-format
+
+-   repo: https://github.com/pre-commit/mirrors-mypy
+    rev: ''  # Use the sha / tag you want to point at
+    hooks:
+    -   id: mypy

{lispython-0.2.1 → lispython-0.3.1}/LICENSE.md

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Jethack
+Copyright (c) 2025 Jetack
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{lispython-0.2.1 → lispython-0.3.1}/PKG-INFO

@@ -1,16 +1,22 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: lispython
-Version: 0.2.1
+Version: 0.3.1
 Summary: Lisp-like Syntax for Python with Lisp-like Macros
-Home-page: https://jetack.github.io/lispython
-License: MIT
-Author: Jetack
-Author-email: jetack23@gmail.com
-Requires-Python: >=3.11,<3.12
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
+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
+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
@@ -61,9 +67,12 @@ lpy -m unittest
 # Todo
 ## Environment
 - [ ] Test on more python versions
-- [ ] Some IDE plugins like hy-mode and jedhy for better editing experience.
+- [ ] REPL should track history and arrow key navigation
+- [ ] REPL multi-line input support
+- [ ] Better compileation 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.2.1 → lispython-0.3.1}/README.md

@@ -46,9 +46,12 @@ lpy -m unittest
 # Todo
 ## Environment
 - [ ] Test on more python versions
-- [ ] Some IDE plugins like hy-mode and jedhy for better editing experience.
+- [ ] REPL should track history and arrow key navigation
+- [ ] REPL multi-line input support
+- [ ] Better compileation 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
+- [ ] `type_comment` never considered. Later, it should be covered
+- [ ] Any missing AST nodes in the version 3.12+

lispython-0.3.1/docs/index.md

@@ -0,0 +1,14 @@
+# LisPython
+This documentation stands for version **{{ version }}**   
+**Try LisPy without installing it! : [Web REPL](https://jetack.github.io/lispy-web)**
+
+## What is LisPython?
+Lisp + Python = LisPython.   
+I'll use the abbreviation **LisPy** throughout this documentation.
+LisPy provides a new lisp-like syntax for Python. (Thus, macro system too)
+   
+LisPy is highly inspired by [Clojure](https://clojure.org/) and [Hy](https://hylang.org/).
+I started this project because I want something slightly different from Hy.
+As a standalone language, Hy evolves fast.
+It can be good in general.
+But it's hard for me to keep track of the breaking changes in Hy.

lispython-0.3.1/docs/macros.md

@@ -0,0 +1,57 @@
+# Macros
+LisPy's macro system is highly inspired by Clojure's macro system.
+You can check out the [Chapter 7](https://www.braveclojure.com/read-and-eval/) and [Chapter 8](https://www.braveclojure.com/writing-macros/) of "Brave Clojure" for more information about Clojure's macro system.
+## Expression Nodes
+These nodes are defined in `src/lispython/core/nodes.py`.
+
+You can check out how to manipulate these nodes in
+
+- the definitions of nodes themselves
+- the definitions of built-in macros in `src/lispython/macros/sugar.lpy`.
+
+## quote
+```python
+'expr
+```
+## syntax-quote
+```python
+`expr
+```
+## unquote
+```python
+~expr
+```
+## unquote-splicing
+```python
+~@expr
+```
+## Macro Definition
+Just change `def` in function definition to `defmacro`. And macros usually return a quoted expression.
+```python
+(defmacro name [args*]
+  body*)
+```
+### Macro Example
+```python
+(defmacro when [pred *body]
+  (return `(if ~pred
+             (do ~@body))))
+
+(defmacro cond [*body]
+  (def recur [*body]
+    (if (< (len body) 4)
+        (return `(if ~@body))
+        (do (= [test then *orelse] body)
+            (return `(if ~test ~then ~(recur *orelse))))))
+  (return (recur *body)))
+
+(defmacro -> [x *fs]
+  (if (== 0 (len fs))
+      (return x))
+  (= [f *rest] fs)
+  (if (isinstance f Paren)
+      (do (f.list.insert 1 x)
+          (return `(-> ~f ~@rest)))
+      (return `(-> (~f ~x) ~@rest))))
+```
+You can find more in `src/lispython/macros/sugar.lpy`.