Skip to content
Branch: master
Go to file
Code

Latest commit

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
art
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Hackage version Stackage version Build Status Documentation Status

The BNF Converter

What is the BNF Converter?

The BNF Converter (bnfc) is a compiler construction tool generating a compiler front-end from a Labelled BNF grammar. It is currently able to generate C, C++, C#, Haskell, Java, and OCaml, as well as XML representations.

Given a Labelled BNF grammar the tool produces:

  • an abstract syntax implementation
  • a case skeleton for the abstract syntax in the same language
  • an Alex, Ocamllex, JLex, or Flex lexer generator file
  • a Happy, Ocamlyacc, Menhir, ANTLR, CUP, or Bison parser generator file
  • a pretty-printer as a Haskell/Ocaml/Java/C++/C module
  • a Latex file containing a readable specification of the language

More information: http://bnfc.digitalgrammars.com/

Requirements

Everything needed to build bnfc is available in the haskell platform.

On Debian, you can install the dependencies as follows

sudo apt-get install haskell-platform

On Fedora:

yum install haskell-platform

Then proceed with the installation.

Installation

Some binaries are available at https://github.com/BNFC/bnfc/releases .

To install bnfc from hackage.haskell.org:

cabal install BNFC

To install the development version of bnfc:

git clone https://github.com/BNFC/bnfc.git
cd bnfc/source
cabal install

Documentation

https://bnfc.readthedocs.org/en/latest/

Run tests

Here is how to build and run the different test suites for bnfc.

cabal sandbox init # Cabal >= 1.18 only
cabal install --only-dependencies --enable-tests
cabal configure --enable-tests
cabal build
cabal test

Contribute

Support

If you are having issues, please let us know. We have a mailing list located at: bnfc-dev@googlegroups.com

License

The project is licensed under the GNU GENERAL PUBLIC LICENSE Version 2.

You can’t perform that action at this time.