Plasma is a new programming language for safe and efficient general purpose use. It is a statically typed, side-effect free single assignment language and will have functional programming and concurrent programming features. It will support deterministic parallel execution. For a general overview, please visit https://plasmalang.org/ It is in early development.
It is free software, Copyright (C) 2015-2023 The Plasma Team, distributed mostly under the MIT license, see LICENSE for details.
This README.md contains some quick info for getting started. For more complete info please see our getting started guide.
Plasma has been tested on Linux, Windows subsystem for Linux 1 and 2 on x86_64.
You will need:
Optionally to build the documentation you will also need:
Optionally to run the test suite you will also need:
On Debian (also Ubuntu, Mint etc) Linux
$ apt install build-essential ninja-build lua5.3 lua-filesystem lua-posix diffutils asciidoc source-highlight ncurses-bin
Will get you started, then proceed to installing Mercury below.
The easiest way to install Mercury is to install the .deb packages (on Debian, Ubuntu, etc).
Otherwise download Mercury's source package and follow the installation instructions in the INSTALL file. We've made some notes about grades that may help with choosing which grades you may need. There is also a README.bootstrap file with Mercury bootstrapping information if you wish to do that, it may also provide some additional explaination.
Copy template.mk
to build.mk
and edit it to make any build configuration
changes you need.
Use make
in the root directory to build the project.
Then make install`` to install the tools into
$PREFIX/bin```.
This compiles and installs the following programs. Make sure they're in
your PATH
.
.p
) files to
plasma modules (.pzo
).pzo
)
into a plasma program (.pz
).pz
)..pzt
) to bytecode (.pzo
). It is useful for testing the
runtime.There are example plasma programs in examples/
. Running plzbuild
in examples/
will build them.
Each program's bytecode is copied to a file in examples/
eg
hello.pz
, run them with plzrun <bytecode>
.
Please see CONTRIBUTING.md and CODE_OF_CONDUCT.md. For detailed information including what to work on please see Contributing to Plasma in our documentation.
If you're stuck and the Documentation doesn't contain the answer or clue you need or you're struggling to find it. Please ask for help. The Contact page of the website lists all the ways you can get in touch. In particular the Plasma Help mailing list and Discord server are the best resources for help.
For bugs or missing information please file a bug.