Bruce/nomsu
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
The Nomsu programming language. https://nomsu.org
428 Commits 1 Branch 0 Tags 2.1 MiB
Lua 53.1%
MoonScript 44.6%
Makefile 2.1%
Shell 0.2%
563e415e07
Go to file
Bruce Hill 563e415e07 Switched from Node(Tuple(values...), source) to Node(source, values...), 
thanks to support from immutable-tables for mixed tables.
2018-06-04 17:57:07 -07:00
core Switched from Node(Tuple(values...), source) to Node(source, values...), 2018-06-04 17:57:07 -07:00
examples Some tweaks/cleanup on the nomsu code as well as adding variable 2018-05-27 18:29:23 -07:00
lib Cleanups to try/catch logic and object logic. 2018-06-04 17:23:13 -07:00
tests Cleanups to try/catch logic and object logic. 2018-06-04 17:23:13 -07:00
.gitignore Updated gitignore. 2018-02-02 15:59:05 -08:00
code_obj.lua Simplified and correctified lib/object (though the codegen still need 2018-05-30 17:21:19 -07:00
code_obj.moon Simplified and correctified lib/object (though the codegen still need 2018-05-30 17:21:19 -07:00
compile_lib.sh Removed the Word tree type and replaced it with raw strings, since 2018-05-24 21:17:15 -07:00
consolecolors.lua Improved documentation and compile script. 2017-12-18 16:45:46 -08:00
LICENSE Added license. 2017-10-09 04:09:06 -07:00
nomsu_tree.lua Switched from Node(Tuple(values...), source) to Node(source, values...), 2018-06-04 17:57:07 -07:00
nomsu_tree.moon Switched from Node(Tuple(values...), source) to Node(source, values...), 2018-06-04 17:57:07 -07:00
nomsu.lua Switched from Node(Tuple(values...), source) to Node(source, values...), 2018-06-04 17:57:07 -07:00
nomsu.moon Switched from Node(Tuple(values...), source) to Node(source, values...), 2018-06-04 17:57:07 -07:00
nomsu.peg Deleted shebang rule. Comments handle it just fine. 2018-05-30 13:11:05 -07:00
README.md Updated 'use %' to support directories, and cleaned up action_metadata a 2018-02-02 14:01:06 -08:00
utils.lua Consolidating code obj code and expunging all [[..]]-style lua strings. 2018-05-24 16:13:46 -07:00
uuid.lua Added tentative support for luajit (depends on pure-lua LPEG 2018-05-09 13:35:04 -07:00

README.md

Nomsu

Nomsu (named after Nomic, and its creator, Peter Suber) is a programming language designed to be used for playing games of Nomic, or engaging in other similar activities revolving around natural language rule-making and self modification.

Dependencies

Nomsu's only dependencies are Lua 5.2 or later (tested with version 5.2.4) (or Luajit (tested with version 2.1.0)), LPEG (luarocks install lpeg), and LuaFileSystem (luarocks install luafilesystem). Nomsu's compiler was written in Moonscript, but all of the .moon files have been compiled into lua for convenience, so Moonscript is not a dependency.

Usage

  • To get a nomsu REPL, simply run lua nomsu.lua.
  • To run a .nom file with nomsu code, run lua nomsu.lua your_file.nom. Or lua nomsu.lua - if reading from stdin.
  • (Advanced/optional) To precompile a .nom file into lua, run lua nomsu.lua -c <your_file>.nom to precompile your file into lua (by default, saved at <your_file>.lua). If you run the compiler with the "-O" (for Optimized) flag, the compiler will run the precompiled lua files directly, instead of parsing and compiling the .nom files before running them. This is not necessary, but it can speed things up if you precompile a bunch of code that involves macros or compile-time activity.
  • More usage options are avilable via lua nomsu.lua --help.

Layout

  • nomsu.moon/nomsu.lua - The nomsu compiler. The compiler is written in Moonscript, but a lua version of the file is provided in this repository for convenience.
  • utils.lua - A set of utility functions used by nomsu.moon.
  • consolecolors.lua - Lua module that defines ANSI color codes for colored console output (used internally in nomsu.moon).
  • examples/how_do_i.nom - A simple walkthrough of some of the features of nomsu, written in nomsu. This is a good place to start.
  • lib/object.nom - An optional library for doing object-oriented programming.
  • lib/collections.nom - Core library definitions related to collections, like lists and dictionaries.
  • lib/control_flow.nom - Core library definitions related to control flow, like if statements and for loops.
  • lib/core.nom - Core library file that loads other core library files. Files are loaded in dependency order.
  • lib/math.nom - Core library definitions of math functions, like sum of % and sqrt %.
  • lib/metaprogramming.nom - Core library essential functionality for metaprogramming, including macros to define macros, rules to define rules, and so on. This is where the language pulls itself up by its hair out the swamps of nothingness.
  • lib/operators.nom - Core library definitions for operators like = and +.
  • lib/text.nom - Core library definitions of text functions for stuff like concatenating strings.
  • lib/training_wheels.nom - An optional library to define some syntactic sugar that makes Nomsu resemble other programming languages more closely.
  • tests/*.nom - A somewhat exhaustive set of minimalist tests for almost every language feature defined in lib/*.nom
  • compile_lib.sh - script to precompile lib/*.nom so they can be loaded faster. This is optional.

Extra

There is a vim plugin for the language available in the Vim Nomsu repository. It is usually kept relatively up-to-date with Nomsu, but occasionally lags behind.