LDPL is a powerful transpiled programming language designed from the ground up to be excessively expressive, readable, fast and easy to learn. It mimics plain English, in the likeness of the good parts of older programming languages like COBOL, with the desire that it can be understood by anybody. It's very portable and runs on a plethora of different architectures and operating systems including AMD-64 Windows, Linux, macOS, ARMv8 Linux, Android and both Intel and PowerPC OS X (tested from Tiger 10.4 onwards). It even supports UTF-8 out of the box.
This repository contains the source code and releases of the LDPL compiler (and other goodies!).
data:
name is text # Your name goes here!
procedure:
# Simple Hello World
display "Hello World" crlf "What's your name? "
accept name
display "δ½ ε₯½, " name "! Welcome to LDPL!" crlfGreet the user, ask them for their name and then print δ½ ε₯½, <name>! followed by a line-break. Easy as pie and super legible. Check the official website and the examples subfolder for more examples, including a Brainf*ck interpreter and Bellman-Ford's Algorithm!
You can get yourself a precompiled LDPL binary or compile LDPL from source. Check the following table if you are not sure of what to do.
| If you want to download a compiled binary | If you want to build LDPL yourself |
|---|---|
| Compiled binaries contain the latest stable release. Might not be up to date with the newest, bleeding edge features, but will work fine on most systems and are already compiled for you. | Building LDPL yourself gives you access to the latest features of the language. Development LDPL code tends to be stable, compile and work fine, but hidden bugs may still lurk in there! |
| How to: download the latest stable release available. You should then move the binary to a folder on your PATH. | How to: first, clone this repository. Then make (or mingw32-make on Windows) and make install (or mingw32-make install on Windows) LDPL in the src folder. This will install LDPL and the LDPL documentation (man ldpl, not available on Windows) on your system. LDPL requires only C++11 to compile. |
Once you have LDPL installed on your system, check the LDPL reference to learn how to use the language. Information on how to compile LDPL scripts and a list of LDPL compatible editors is provided in the sections below.
Please note that in order to compile LDPL on Windows you must have Mingw-w64 installed on your system. We only support Win32 threads so when installing Mingw-w64 be sure to choose that option.
We have highlighting and code formatting extensions available for vim (thanks to Araml), Visual Studio Code (thanks to ΚΚΚp), Atom (thanks to DamiΓ‘n Garro) and nano (by Lartu).
You can use any other editor (without syntax highlighting) if you like. If know how to write syntax packages for other editors and would like to contribute to the LDPL project, a highlighting extension would be a very welcome contribution.
The LDPL documentation is available here. Check that to learn yourself some LDPL (for the greater good!). The documentation is also uploaded to the ldpl-docs GitHub repository and can be read and forked from there.
The LDPL documentation can also be found on your system using man ldpl when you install LDPL by using make install. The man page is also
available in the man folder of this repository.
To use the compiler, you must have a C++ compiler already installed on your system and have mapped it to c++, found on your PATH. The LDPL Compiler compiles LDPL code to C++ code and thus this is a requirement for it to work.
Once the compiler is set up, go write some LDPL source code, say source.lsc.
Then compile the source code using ldpl source.lsc. The compiled, executable binary file will be saved as source-bin.
Done! For more info on the compiler run ldpl -h.
- The
-fflag can be used to pass extra options to the compiler when building extensions. For example,-f=-lSDLcould be used to link against SDL. - By using
-ryou can just compile the project and print the C++ representation for that code. - You can set the output file for the compiled binary with the
-oflag. For example, if you want to name your program "dog", you could compile it withldpl -o=dog main.ldpl. - On Windows and Linux platforms, LDPL builds static binaries by default. If you want to build non-static ones use the
-nsflag. - The
-cflag tells LDPL to accept source code from the standard input. - You can import extensions to your LDPL compilation by using the
-i=flag. Extensions can be imported by passing.o,.a, or.cppfiles to this flag; see the Extensions section below. -vand--versionprint out version info and release details.-hand--helpprint this list of options.
LDPL supports extensions written in C++. Extensions are .cpp, .o, or .a files that can be imported into your program using the -i= compiler flag. For example ldpl -i=lib.cpp source.ldpl.
For a guide to writing and building extensions, see LDPL's official documentation. For a simple example, see the examples/cpp-extension directory.
A number of useful statements and subroutines are available in the LDPL Standard Library. Just INCLUDE the desired files in your sourcecode and you are ready to go. For more information check the LDPL Standard Library repository.
- The LDPL Network Server Library: the LDPL Network Server Library is an library for creating socket based servers in LDPL. It aims to make it very easy to develop, test and deploy network servers, with as little work as possible.
- The LDPL Telegram Bot Library: this simple LDPL library lets you create a Telegram bot that can receive and send text messages.
- The LDPL IRC Bot Library: the LDPL IRC Bot Library lets you write LDPL programs that connect to IRC servers, join channels, send messages and more in the simplest way possible.
- LDPLNOISE: LDPL extension with linenoise support. Linenoise is a minimal, zero-config, BSD licensed, readline replacement used in Redis, MongoDB, and Android.
If you want to contribute to LDPL you can add statements to the language (that's in fact really easy!), fix bugs, add issues, write examples, write some software in LDPL, add statements to the Standard Library, etc. Check out the contribution guide for more information. Anything is very welcome! Even telling your friends about LDPL is a very easy and very useful contribution!
Contributors are expected to behave by the LDPL Code of Conduct. Tl;dr: be nice to everyone.
If you want to talk to the rest of us, you can find the LDPL community at r/LDPL and via IRC on irc.freenode.net, channel #ldpl. Also on Telegram via the ldpllang group. The IRC and Telegram channels are bridged. You are welcome to open new LDPL channels anywhere else if you like.
You are welcome to submit an issue to this repository, check the LDPL website or join the community channels stated in the previous section. There are a few extra ways to get in touch with us stated on the website.
This LDPL Compiler is distributed under the GNU General Public License 3.0. All LDPL Dinosaur logos where created by Lartu and are released under a Creative Commons Attribution 4.0 International (CC BY 4.0) license.