Blueberry

Blueberry is a script language with clean syntax, inspired from CoffeeScript, Python and Ruby.

Blueberry compiles to PHP so everything you do with Blueberry can run wherever PHP can run, this is awesome for shared web servers where you can only run default PHP.

Right now Blueberry is still in very early development, it's usage is encouraged mostly for testing purposes.

Building

All the compiler dependencies can be installed with npm install.

Building the grammar, which you don't need to do unless you modify it, can be done with pegjs --cache src/grammar.g src/grammar.js. You'll need to install pegjs first, version 0.7 or later, e.g. npm install -g pegjs.

Command Line Usage

The easiest way to compile Blueberry code into PHP code is using the bb file, inside the bin directory.

bin/bb compile file.bb

If using unix you can just symlink the executable to your /bin folder, if windows, add the path to bb.bat to your PATH env variable.

See the wiki for extensive documentation on the CLI (Command Line Interface)

Syntax At A Glance

<?bb
/* 
 I'm a multiline comment
*/

# variable definition
foo = 1 
bar = "baz"

# You can use JSON syntax to define associative arrays
arr = { "name": "Mike", "age": 18, "meta": { "items": [1, 2, 3] } }

# Compiles to strict comparison `$a === 1`
if a == 1
  echo("Hello, World!")
end

for i in (0..10)
  echo(i)
end

# List comprehensions
myList = [2 * i for i in (1..10) where i % 2 == 0]
# It also works in JSON constructs
myArr  = { "first_names": [name.first_name for name in names] }

# Closures can be used as follows
foo = (arg1, arg2) -> arg1 + arg2
bar = () -> do
  name = "Tolouse"
  return name
end
# Execute function
bar()

class MyClass < MyParentClass
  @name

  def greet
    echo("Hello! My name is " & @name)
  end
end
?>

For more information, see the wiki.

Versioning

Format: <major>.<minor>.<patch>

Breaking backwards compatibility bumps the major

New additions without breaking backwards compatibility bumps the minor

Bug fixes and misc changes bump the patch