doggo scripting language

welcome

doggo is an interpreted scripting language that you can use, but you really shouldn't. It was written using Thorsten Ball's book, in order to learn more about programming languages. It leverages Go's type system, garbage collector, and pretty much everything else. Did I mention that you shouldn't use this?

what's in the box

Not much, really.

keyword	explanation (sort of)
const	Declare a constant. What did you expect?
fn	Declare a function. Functions are first class citizens, they can be passed around and used pretty much everywhere. Higher order functions and closures are supported.
if/else	Basic logic gate
return	End a function's execution

data types

declaration	explanation (sort of)
const a = 1;	Integer
const b = "hello";	String
const c = true;	Boolean
const d = [1, 2, 3];	Array
const e = { "something": "some other thing" }	Map
const f = fn(x, y) { ... };	Function

syntax

• Each line must end with a semicolon ;
• Only function expressions are supported
• Variables are function-scoped
• You can use expressions anywhere you can use a value

For more examples on how the code looks, try one of the examples from the examples folder.

built-in functions

usage	explanation (sort of)
print(variable)	Print a value to the console
length(array)	Get the number of members in an array
lastIndex(array)	Get the index of the last array member
tail(array)	Return a new copy of an array, with the first member removed
push(array, item)	Add a new item at the tail of an array

operators

operator	explanation (sort of)
+	Add numbers or concatenate strings
-	Subtract a number from another
*	Multiply numbers
/	Divide a number by another
!someVariable	Bang expression, negate a boolean
someVariable[1]	Index expression, works for arrays and maps

now really, how do I run this?

First of all, you need Go installed (>= 1.11). You can download the latest version here.

Now, here come the commands:

cd doggo
go build

Now you'll see that a pretty executable file called doggo appeared. You can run one of the examples, to check that everything is working:

./doggo examples/simple.doggo

If you feel brave, you can also run the REPL:

./doggo

Now you can start typing in code, line by line, and execute it on the spot.