Skip to content

boo-lang/boo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

bc0aa51 · Jul 6, 2022
Apr 7, 2010
Oct 29, 2013
Jun 19, 2017
Sep 25, 2015
Oct 4, 2010
Nov 19, 2012
Oct 25, 2012
Nov 2, 2013
Apr 20, 2011
Jan 22, 2018
Jul 26, 2020
Mar 6, 2018
Mar 25, 2013
Oct 30, 2018
Jan 17, 2009
Jan 22, 2018
Jul 24, 2008
Apr 29, 2005
Jul 6, 2022
Jun 19, 2017
May 16, 2017
Feb 16, 2007
Feb 16, 2007
Mar 25, 2013
Jun 13, 2017
Jun 19, 2017
Aug 3, 2009
Dec 17, 2017
Oct 25, 2012
Oct 25, 2012
Feb 16, 2007
Sep 10, 2004
Oct 20, 2009
Jan 19, 2011
Jun 13, 2017
Jun 19, 2017
Oct 20, 2009
Jun 13, 2017
Jun 19, 2017
Dec 3, 2012
May 17, 2010
Mar 25, 2013

Repository files navigation

Build Status

The Boo Programming Language (c) 2009 Rodrigo B. de Oliveira (rbo@acm.org)

Prerequisites

Windows

* Boo is built with NAnt, which must be built from sources, which requires NMake, which comes with the Visual C++ Build Tools.

Mac/Linux

  • Mono 4.2.x (4.2.4 is the latest and recommended)
  • Bash

Build Tools

You can install compatible versions of the required tools into the build-tools directory, where the build scripts will execute them from, by running the bootstrap script.

Windows

The bootstrap script is a PowerShell script; however, it must be run from a x86 Native Tools Command Prompt:

# FROM A x86 NATIVE TOOLS COMMAND PROMPT
powershell .\build-tools\bootstrap

Mac/Linux

./build-tools/bootstrap

Mac

Building Boo requires Mono 4.2.x, which is not likely to be your "Current" version of Mono. To avoid having to switch your current version every time you want to work on Boo, you can specify the version to use when you run the bootstrap script. The build scripts will then use that version of Mono, regardless of your current version.

./build-tools/bootstrap [<mono version>]

Building

To build the repository, run the nant script:

# Windows (PowerShell)
.\nant [<target>]
# Mac/Linux
./nant [<target>]

With no target specified, this will build the repository (code and tests) incrementally. To clean and build the repository from scratch, run the "rebuild" target. This will also cause the ast classes and parser to be regenerated (needs a java vm)

To run the unit tests that have already been built with nant, run the nunit script:

# Windows (PowerShell)
.\nunit
# Mac/Linux
./nunit

To build and test the entire repository, the same way the CI build does, run the ci script:

# Windows (PowerShell)
.\ci
# Mac/Linux
./ci

How to Start

For a brief description of the project and its goals take a look at docs/BooManifesto.sxw.

extras/boox contains a sweet little tool you can use to get yourself acquainted with the language.

src/ contains all the source code for the runtime and compiler components.

tests/ contains all the unit tests.

testcases/integration is a good source of information on the language features.

lib/ contains project dependencies such as antlr.

bin/ contains the latest version that passed all the tests and could be successfully used to rebuild the system.

Running and compiling code

To execute a boo script run:

booi <script> [args]

For instance:

booi examples/hw.boo	

You can also have booi to read from stdin by typing:

booi -

You can generate .net assemblies by using booc (either the booc.exe utility or the booc nant task):

booc -output:build/hello.exe examples/hw.boo	

If you want to simply see the transformations applied to your code by the compiler use the boo pipeline, run:

booc -p:boo examples/replace.boo	

More Information

Boo development Google group: https://groups.google.com/forum/#!forum/boolang

Boo community Discord: https://discord.gg/J4Guxadwma

Contributors

See: https://github.com/boo-lang/boo/graphs/contributors