Awesome
<img src="https://github.com/jlangch/venice/blob/master/doc/logo/logo-readme.png" width="1024">Venice
Venice is a Clojure inspired sandboxed Lisp dialect with excellent Java interoperability.
Overview
Venice is a Lisp dialect born from the need for a safe, sandboxed, general-purpose language. It shares with Lisp the code-as-data philosophy and a powerful macro system.
Venice is mainly a functional programming language focusing on immutable, persistent data structures.
Venice supports macros, tail-recursion, dynamic code loading, multimethods, protocols and many more. It comes with excellent Java interoperability, and a configurable sandbox that can prevent all sorts of unwanted JVM and Venice interactions. Venice has been designed from the ground-up with a sandbox, making it a first class citizen.
Venice includes a comprehensive library of over 900 core functions. Its immutable persistent data structures, along with Clojure-style atoms, futures, promises, and agents, greatly simplify the process of writing concurrent code.
Venice seamlessly and transparently integrates with Java and any third-party libraries, giving you access to a vast array of libraries, frameworks, and tools.
Venice's strength is making complex scripting tasks easy. Have you ever felt limited by Bash or PowerShell scripts? With Venice, you can write concise and elegant platform independent scripts effortlessly.
Venice does not depend on any runtime libraries (other than the JVM). You can easily add it as a standalone JAR to your classpath.
Venice requires Java 8 or newer.
Would you like to try Venice in an interactive REPL environment? Test it on Gitpod
Cheat Sheet
Change Log
Documentation
- Getting started
- REPL
- On Functional Programming
- First Steps in Venice
- Example: Sudoku Solver
- Execute Venice scripts
- Embedding Venice in Java
- Datatypes
- Custom Datatypes
- Lazy Sequences
- Functions
- Control Flow
- Filter-Map-Reduce
- Transducers
- Recursion
- Mutable Refs
- Destructuring
- Advanced string features
- Concurrency
- Java interoperability
- Namespaces
- Exception handling
- Multimethods and Protocols
- Macros
- Sandbox
- Cryptography
- JSON
- JSON Lines
- CSV
- EXCEL
- ASCII Tables
- HTTP Client (Java 8+)
- Venice meets LLMs
- Database (JDBC)
- Shell Scripts
- Extension modules
- Source Code as PDF
- Tree walker
- Benchmarks
- Multi-File Apps
- Development Tools
- Build dependencies
- Performance comparison Venice - Clojure - Java
Getting the latest release
You can can pull it from the central Maven repositories:
<dependency>
<groupId>com.github.jlangch</groupId>
<artifactId>venice</artifactId>
<version>1.12.34</version>
</dependency>
Building
From a command shell, run ./gradlew shadowJar
in the project home dir, to invoke the Gradle task to build the Venice JAR.
On MacOS / Linux
Give gradlew
execute permission after cloning the Venice git repository ...
venice% chmod +x ./gradlew
... and build the project
venice% ./gradlew clean shadowJar
On Windows
C:\Users\foo\venice> gradlew.bat clean shadowJar
Contributing
I accept Pull Requests via GitHub. There are some guidelines which will make applying PRs easier for me:
- No tabs! Please use spaces for indentation.
- Respect the existing code style for each file.
- Create minimal diffs - disable on save actions like reformat source code or organize imports. If you feel the source code should be reformatted create a separate PR for this change.
- Provide JUnit tests for your changes and make sure your changes don't break any existing tests by running gradle.
License
This code is licensed under the Apache License v2.