1
1
mirror of https://github.com/anoma/juvix.git synced 2024-11-30 14:13:27 +03:00
Juvix empowers developers to write code in a high-level, functional language, compile it to gas-efficient output VM instructions, and formally verify the safety of their contracts prior to deployment and execution.
Go to file
Jan Mas Rovira 36b390fcb0
Improve formatting of single-constructor types and records (#2342)
- Closes #2331.

The rules implemented in this pr are as follows.
1. If a type definition has only one constructor, no pipe is added. The
constructor is printed in the same line if it fits.
2. If a constructor is a record with a single field, the field is
printed in the same line if it fits. If the constructor has multiple
fields, they are printed aligned and indented after a line break.

Examples:
```
type T := constructT : T;

type T-wrapper := mkWrapper {unwrap : T};

type EnumRecord :=
  | --- doc for C1
    C1 {
      c1a : T;
      c1b : T
    }
  | C2 {
      c2a : T;
      c2b : T
    };
```
2023-09-07 16:20:14 +02:00
.devcontainer Update stackage resolver to LTS 21.6 (#2275) 2023-08-11 11:49:33 +02:00
.github External package dependencies (#2272) 2023-09-01 12:37:06 +01:00
app Global offline flag (#2335) 2023-09-05 17:11:17 +02:00
assets Add macchiato html theme (#2323) 2023-09-04 21:07:53 +02:00
bench Fix benchmark wasmer command (#2268) 2023-08-03 13:44:36 +01:00
examples Improve formatting of single-constructor types and records (#2342) 2023-09-07 16:20:14 +02:00
gnuplot Automatized benchmarks (#1673) 2023-01-05 17:48:26 +01:00
juvix-stdlib@b7edcc335f Remove old function syntax (#2305) 2023-08-24 16:24:47 +02:00
licenses Add Haddock and Agda licenses (#1506) 2022-09-06 09:30:01 +01:00
runtime Check for incomparable precedences (#2289) 2023-08-16 16:33:29 +02:00
src/Juvix Improve formatting of single-constructor types and records (#2342) 2023-09-07 16:20:14 +02:00
test Improve formatting of single-constructor types and records (#2342) 2023-09-07 16:20:14 +02:00
tests Improve formatting of single-constructor types and records (#2342) 2023-09-07 16:20:14 +02:00
theme Add syntax highlighting for juvix code blocks in docs (#1971) 2023-04-05 11:24:19 +02:00
.clang-format Juvix C runtime (#1580) 2022-11-03 09:38:09 +01:00
.github_changelog_generator Update Changelog v0.2.3 🎉 2022-08-15 12:24:42 +02:00
.gitignore Fix: broken links of Example programs (#2003) 2023-04-14 11:16:05 +02:00
.gitmodules Rename MiniJuvix to Juvix (#259) 2022-07-08 13:59:45 +02:00
.hlint.yaml Named arguments (#2250) 2023-07-18 10:32:34 +01:00
.pre-commit-config.yaml Bump version to v0.3.5 🎉 2023-06-02 17:28:07 +02:00
book.toml Add syntax highlighting for juvix code blocks in docs (#1971) 2023-04-05 11:24:19 +02:00
cabal.hie.yaml Automatized benchmarks (#1673) 2023-01-05 17:48:26 +01:00
cabal.project Update stackage resolver to LTS 21.6 (#2275) 2023-08-11 11:49:33 +02:00
cabal.project.freeze Update stackage resolver to LTS 21.6 (#2275) 2023-08-11 11:49:33 +02:00
CHANGELOG.md Bump version to v0.4.3 2023-08-24 16:24:40 +02:00
cntlines.sh Minor refactor and script update (#2261) 2023-07-27 17:57:20 +02:00
CONTRIBUTING.md Fix baseUrl for juvix docs in Doctor command (#2122) 2023-05-24 12:14:30 +02:00
LICENSE.md Add new README and md files (#1904) 2023-03-21 20:01:48 +01:00
Makefile Remove old function syntax (#2305) 2023-08-24 16:24:47 +02:00
package.yaml External package dependencies (#2272) 2023-09-01 12:37:06 +01:00
README.md Minor change in README.md 2023-04-19 15:59:47 +02:00
stack.hie.yaml Refactor hie.yaml and add entry in the readme (#1672) 2022-12-20 16:45:48 +01:00
stack.yaml Update stackage resolver to LTS 21.6 (#2275) 2023-08-11 11:49:33 +02:00

Juvix

Tara the Juvix mascot

CI Status

The Juvix compiler CI

Nightly build, release and benchmark

Codebase
Open the Juvix Standard Lib in Github Codespace

Juvix is an open-source, constantly evolving functional programming language designed for writing privacy-preserving decentralized applications. Using Juvix, developers can write high-level programs which can be compiled to WASM directly, or through VampIR to circuits for private execution with Taiga on Anoma or Ethereum.

Getting Started

To get started with Juvix, head over to the documentation website to learn more about the language and its features. You can also find installation instructions and tutorials to help you get started with writing Juvix programs. You can download the latest release from the Juvix GitHub repository or use the web-based development environment, Juvix Github Codespace, which provides a pre-configured workspace ready to use with Juvix and the Haskell toolchain installed.

Language features

Juvix is designed with a focus on safety. The Juvix compiler runs several static analyses which guarantee the absence of runtime errors. Analyses performed include termination and type checking. As a result, functional programs, especially validity predicates, can be written with greater confidence in their correctness.

Some language features in Juvix include:

  • Haskell/Agda-like syntax with support for Unicode
  • Type inference
  • Parametric polymorphism
  • User defined inductive data types
  • Higher-order functions
  • Referential transparency

The Juvix module system allows developers to break down their programs into smaller, reusable modules that can be compiled separately and combined to create larger programs. These modules can be used to build libraries, which can then be documented using Juvix's built-in documentation generation tool, see for example, the Juvix standard library's website. For further details, please refer to the Juvix book which includes our latest updates.

If you're interested in Juvix, you may also want to explore the following related projects:

Project Description
GEB Intermediate language for writing compilers and one of the Juvix backends.
VampIR Proof-system-agnostic language for writing arithmetic circuits and one of the GEB backends.
Taiga A framework for generalized shielded state transitions.

Resources

Here is a summary of resources to help you learn more about Juvix:

Documentation

Resource Description
Official website The official website of Juvix, where you can find documentation, changelog, tutorials, and community resources.
GitHub repository The official GitHub repository of Juvix, where you can find the source code and contribute to the project.

Community

Resource Description
Discord community The Juvix community on Discord is a space where you can connect with the developers behind Juvix and other members of the community who are passionate about privacy-preserving decentralized applications. It's a place where you can ask for help with using Juvix, discuss the latest features and updates, and get involved in the project.
Twitter The official Twitter account of Juvix, where you can stay up-to-date with the latest news and announcements.

Libraries

Resource Description
Standard library The Juvix standard library is a collection of pre-written functions and modules that come bundled with the Juvix programming language. It provides developers with a set of common and useful tools that they can use to build their Juvix programs without having to write everything from scratch.

IDE support

Resource Description
VSCode extension Support for the Juvix programming language with features such as syntax highlighting, error checking and many more directly in the VSCode editor.
Emacs Juvix mode A major mode for Emacs that provides support for writing Juvix programs.

Development environments

Resource Description
Juvix Standard Lib Codespace A web-based development environment for the Juvix standard library on GitHub. It provides a pre-configured workspace with the Juvix standard library installed and ready to use, so you can start using the library in your projects. Some examples of Juvix programs are also loaded in this environment.
Juvix Github Codespace This codespace provides a pre-configured workspace with Juvix and the Haskell toolchain installed. Everything is ready to use, so you can start developing/inspecting the Juvix compiler right away.

Installation

Resource Description
Homebrew Juvix formula A formula for Homebrew, a package manager for macOS and Linux, that allows you to easily install Juvix on your system.
Juvix Nightly builds Users can download and use these nightly builds to experiment with the latest changes to the Juvix Compiler. Nightly builds may contain new features, bug fixes, and other improvements to Juvix that are still in development and have not yet been released in an official version.

Contributing

If you're interested in contributing to Juvix, please see the contributing guidelines for more information. We welcome contributions of all kinds, from bug reports and feature requests to code contributions and documentation improvements.

License

Juvix is open-source software released under the GNU General Public License v3.0. See the LICENSE file for more information.