Make this look like a project
This commit is contained in:
parent
75ff8091aa
commit
a5f00256b0
GPG Key ID:
B715679E3A361BE6
|
|
@ -0,0 +1,9 @@
|
||||||
|
# Build files
|
||||||
|
/build
|
||||||
|
|
||||||
|
# Qt Creator files
|
||||||
|
/CMakeLists.txt.user*
|
||||||
|
/ell.config
|
||||||
|
/ell.files
|
||||||
|
/ell.creator*
|
||||||
|
/ell.includes
|
||||||
|
|
@ -0,0 +1,13 @@
|
||||||
|
Copyright (c) 2017, Přemysl Janouch <p.janouch@gmail.com>
|
||||||
|
|
||||||
|
Permission to use, copy, modify, and/or distribute this software for any
|
||||||
|
purpose with or without fee is hereby granted, provided that the above
|
||||||
|
copyright notice and this permission notice appear in all copies.
|
||||||
|
|
||||||
|
THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||||
|
WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||||
|
MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
||||||
|
SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||||
|
WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
|
||||||
|
OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
|
||||||
|
CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
|
|
@ -0,0 +1,95 @@
|
||||||
|
ell
|
||||||
|
===
|
||||||
|
:compact-option:
|
||||||
|
|
||||||
|
'ell' is a modified subset of Scheme with added syntax sugar, incorporating
|
||||||
|
ideas from Perl, Tcl and Bourne shell. The goal was to conceive a programming
|
||||||
|
language implementable with as little code as possible while still being
|
||||||
|
reasonably comfortable to use.
|
||||||
|
|
||||||
|
This package is an implementation of said language, meant to be self-contained,
|
||||||
|
portable and reusable. Performance is specifically not an intent.
|
||||||
|
|
||||||
|
Syntax
|
||||||
|
------
|
||||||
|
Owing to its Scheme heritage, 'ell' is homoiconic, that is a program can be
|
||||||
|
directly expressed using the language's data types. There are only two of
|
||||||
|
those: the list and the string. Any numerical conversions are made on an
|
||||||
|
as-needed basis. Similarly, strings act like atoms/symbols when executed.
|
||||||
|
|
||||||
|
The parser, however, does a bunch of transformations:
|
||||||
|
|
||||||
|
* `[a b c]` makes a call to `(list a b c)`;
|
||||||
|
* `@var` is a shorthand for `(set var)`;
|
||||||
|
* `{ code }` is the most complex one. Each line within the curly braces is
|
||||||
|
wrapped in parentheses, and the resulting list is quoted, so that it doesn't
|
||||||
|
execute immediately.
|
||||||
|
|
||||||
|
As an example, consider the following snippet:
|
||||||
|
|
||||||
|
print (if { = @var foo } {
|
||||||
|
quote 'Hello world\n'
|
||||||
|
} else {
|
||||||
|
quote 'Error\n'
|
||||||
|
})
|
||||||
|
|
||||||
|
which gets expanded to the following:
|
||||||
|
|
||||||
|
((print (if (quote ((= (set var) foo)))
|
||||||
|
(quote ((quote 'Hello world\n')))
|
||||||
|
else
|
||||||
|
(quote ((quote 'Error\n'))))))
|
||||||
|
|
||||||
|
Observe that the whole program is enclosed in an implicit pair of `{}` and that
|
||||||
|
`quote` is a very powerful special form which can replace many others if needed.
|
||||||
|
|
||||||
|
Runtime
|
||||||
|
-------
|
||||||
|
All variables are put in a single global namespace with no further scoping.
|
||||||
|
When calling a command (which is a list of lists), all arguments are
|
||||||
|
automatically stored in variables named 1, 2, 3, ... n. They are however
|
||||||
|
effectively inaccessible and you must rename them first using the `arg` special
|
||||||
|
form.
|
||||||
|
|
||||||
|
When evaluating a command, the first argument is typically a string with its
|
||||||
|
name and it is resolved as if `set` was called on it.
|
||||||
|
|
||||||
|
The last expression in a block is the return value.
|
||||||
|
|
||||||
|
Special forms
|
||||||
|
-------------
|
||||||
|
`quote <arg>`
|
||||||
|
|
||||||
|
Returns the first argument.
|
||||||
|
|
||||||
|
`arg <name>...`
|
||||||
|
|
||||||
|
Reassigns arguments to the current call in order to given names. This must be a
|
||||||
|
special form because of the lack of variable scoping. It needs to see arguments
|
||||||
|
from the other scope.
|
||||||
|
|
||||||
|
Standard library
|
||||||
|
----------------
|
||||||
|
`if <cond> <body> [elif <cond> <body>]... [else <body>]`
|
||||||
|
|
||||||
|
Conditional evaluation, strings evaluate to themselves.
|
||||||
|
|
||||||
|
`funargs`
|
||||||
|
|
||||||
|
Returns arguments to the current evaluation context as a list.
|
||||||
|
|
||||||
|
Contributing and Support
|
||||||
|
------------------------
|
||||||
|
Use this project's GitHub to report any bugs, request features, or submit pull
|
||||||
|
requests. If you want to discuss this project, or maybe just hang out with
|
||||||
|
the developer, feel free to join me at irc://irc.janouch.name, channel #dev.
|
||||||
|
|
||||||
|
License
|
||||||
|
-------
|
||||||
|
'ell' is written by Přemysl Janouch <p.janouch@gmail.com>.
|
||||||
|
|
||||||
|
You may use the software under the terms of the ISC license, the text of which
|
||||||
|
is included within the package, or, at your option, you may relicense the work
|
||||||
|
under the MIT or the Modified BSD License, as listed at the following site:
|
||||||
|
|
||||||
|
http://www.gnu.org/licenses/license-list.html
|
||||||
19
ell.c
19
ell.c
|
|
@ -1,3 +1,22 @@
|
||||||
|
/*
|
||||||
|
* ell.c: an experimental little language
|
||||||
|
*
|
||||||
|
* Copyright (c) 2017, Přemysl Janouch <p.janouch@gmail.com>
|
||||||
|
*
|
||||||
|
* Permission to use, copy, modify, and/or distribute this software for any
|
||||||
|
* purpose with or without fee is hereby granted, provided that the above
|
||||||
|
* copyright notice and this permission notice appear in all copies.
|
||||||
|
*
|
||||||
|
* THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
|
||||||
|
* WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
|
||||||
|
* MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
|
||||||
|
* SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
|
||||||
|
* WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION
|
||||||
|
* OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
|
||||||
|
* CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
|
||||||
|
*
|
||||||
|
*/
|
||||||
|
|
||||||
#define _XOPEN_SOURCE 500
|
#define _XOPEN_SOURCE 500
|
||||||
|
|
||||||
#include <stdio.h>
|
#include <stdio.h>
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue